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.