How metamask/eth-phishing-detect works
eth-phishing-detect is a domain-list package for detecting phishing sites targeting Web3 users, with tools for maintaining its allow/block/fuzzy lists. The main runtime flow loads the bundled configuration into a detector and checks a supplied domain. Contribution tooling updates or cleans that configuration; a separate list-refresh tool maintains domain corpora used as false-positive safeguards. The graph reflects documented workflows and shown imports/calls; unsampled implementation details are omitted.
Main entry points: update-config.ts Config CLI · bin/clean-config.ts Clean CLI · index.ts Domain check API · src/clean-config.ts Config cleaning
Components 15
Domain detection
- Domain check API
src/index.ts - Bundled lists
src/config.json - Detector wrapper
src/detector.ts - Phishing controller
List maintenance
- Config CLI
bin/update-config.ts - List operations
src/update-config.ts - Clean CLI
bin/clean-config.ts - Config cleaning
src/clean-config.ts - Config serializer
src/utils.ts - List key mapping
src/constants.ts - Config validator
bin/validate-new-config.ts
False-positive safeguards
- Safeguard list refresh
bin/update-test-lists.ts - List source services
- Domain corpora
test/resources
Other components
- Package user
Connections 16
- Package user → Domain check API: checks domain
README.md - Domain check API → Bundled lists: loads lists
src/index.ts - Domain check API → Phishing controller: checks domain
src/index.ts - Detector wrapper → Phishing controller: wraps check
src/detector.ts - Config CLI → List operations: dispatches edits
bin/update-config.ts - Config CLI → Bundled lists: reads and writes
bin/update-config.ts - Config CLI → Config serializer: serializes config
bin/update-config.ts - Config CLI → List key mapping: validates list key
bin/update-config.ts - List operations → Config cleaning: cleans additions
src/update-config.ts - Config cleaning → Detector wrapper: checks fuzzy entries
src/clean-config.ts - Clean CLI → Config cleaning: cleans selected list
bin/clean-config.ts - Clean CLI → Bundled lists: reads and writes
bin/clean-config.ts - Clean CLI → Config serializer: serializes config
bin/clean-config.ts - Clean CLI → List key mapping: validates list key
bin/clean-config.ts - Safeguard list refresh → List source services: fetches domains
bin/update-test-lists.ts - Safeguard list refresh → Domain corpora: writes lists
README.md