diff --git a/README.md b/README.md index 2559557..9bee285 100644 --- a/README.md +++ b/README.md @@ -728,6 +728,7 @@ of it. - Blockscout API: endpoint URL input + "Save" button (validated against `/stats` before being saved) - Token Spam Protection: + - "Hide fake tokens impersonating a known symbol" checkbox - "Hide tokens with fewer than 1,000 holders" checkbox - "Hide transactions from detected fraud contracts" checkbox - "Hide dust transactions below N gwei" checkbox + threshold input @@ -1117,7 +1118,19 @@ indexes it as a real token transfer. a spoof and filtered from display. The fake "Ethereum" token in the attack above used symbol "ETH" from contract `0xD05339f9Ea5ab9d9F03B9d57F671d2abD1F55c82`, which does not match the known - WETH contract — so it would be caught by this check. + WETH contract — so it would be caught by this check. Detecting a spoof is also + what adds a contract to the fraud contract blocklist below; that is the only + thing that populates it. In the transaction history the check is the "Hide + fake tokens impersonating a known symbol" setting, on by default; with it off, + spoofed transfers are shown and no new blocklist entries are learned from + them. The send-screen token selector applies the same check unconditionally, + because it decides which tokens the user can act on rather than what the + history displays. The balance list applies it unconditionally too, but not + identically: it exempts symbols that `KNOWN_SYMBOLS` maps to `null`, and + `"ETH"` is the only one. So the fake "Ethereum" token above is filtered from + the transaction history and from the send selector, but a fake-`ETH` ERC-20 + that clears the balance list's own 1,000-holder floor — or that the user + tracked manually — is still shown in the balance list. - **Low-holder token filtering**: Token transfers from ERC-20 contracts with fewer than 1,000 holders are hidden from transaction history by default. @@ -1147,11 +1160,19 @@ indexes it as a real token transfer. about. The threshold is user-configurable in Settings; a threshold of `0` hides nothing, exactly as clearing the checkbox does. -- **User-configurable**: All of the above filters (known symbol verification, - low-holder threshold, fraud contract blocklist, dust threshold) are settings - that default to on but can be individually disabled by the user. AutistMask is - designed as a sharp tool — users who understand the risks can configure the - wallet to show everything unfiltered, unix-style. +- **User-configurable**: All four filters (known symbol verification, low-holder + threshold, fraud contract blocklist, dust threshold) are settings that default + to on but can be individually disabled by the user. AutistMask is designed as + a sharp tool — users who understand the risks can configure the wallet to show + everything unfiltered, unix-style. All four settings govern the transaction + history; what else each one reaches varies. The known-symbol check also runs + unconditionally on the send-screen token selector, and on the balance list + except for symbols mapped to `null` (`"ETH"` alone), which the balance list + does not filter. The fraud contract blocklist is applied unconditionally on + that selector and is not consulted by the balance list at all. The low-holder + setting also gates the send selector, while the balance list's own + 1,000-holder floor is unconditional (see Data Model). The dust threshold + applies to the transaction history alone. #### Phishing Domain Protection diff --git a/TODO.md b/TODO.md index 8b17986..41fd578 100644 --- a/TODO.md +++ b/TODO.md @@ -44,6 +44,10 @@ undefined identifiers, which is how # Completed Steps +- 2026-08-11: Known-symbol spoof verification became a Settings toggle + (`hideSpoofedSymbols`), on by default, governing the transaction-history + filter and the fraud-contract learning it feeds + ([#176](https://git.eeqj.de/sneak/AutistMask/issues/176)). - 2026-08-11: `script/verify-build` now walks `dist/` NUL-delimited and asserts `dist/` is a real directory, so a path with a trailing space or a newline can no longer carry a debug marker past the unlisted-bundle check diff --git a/docs/README.md b/docs/README.md index 7244b8e..9ef5272 100644 --- a/docs/README.md +++ b/docs/README.md @@ -323,7 +323,14 @@ by default: **Known token symbol verification.** AutistMask ships a list of roughly 500 legitimate ERC-20 tokens with their contract addresses. If a transaction or balance claims to involve a known symbol (like "ETH" or "USDT") but comes from -an unrecognized contract, it is identified as a spoof and hidden. +an unrecognized contract, it is identified as a spoof and hidden. In your +transaction history this is the "Hide fake tokens impersonating a known symbol" +setting, which you can switch off; doing so also stops new entries being added +to the fraud contract blocklist below, since detecting a spoof is what fills it. +The send token list always applies the check. Your balances apply it too, with +one exception: a token claiming the symbol "ETH" is not filtered there, so a +fake "ETH" token can still show up in your balance list even though it is hidden +from your transaction history and from the send token list. **Low-holder token filtering.** Tokens with fewer than 1,000 holders are hidden from transaction history and the send token list, and are left out of your diff --git a/src/popup/index.html b/src/popup/index.html index 361e864..474a661 100644 --- a/src/popup/index.html +++ b/src/popup/index.html @@ -948,6 +948,15 @@ transfers and prevent interaction with suspicious tokens.

+