docs: the sentences the rewrite reviews left as follow-up notes (closes #723)
check / check (push) Waiting to run
e2e / e2e-chrome (push) Waiting to run
e2e / e2e-firefox (push) Waiting to run

Each sentence named on #723 now
matches the code on `next`:

- the Firefox load steps are numbered;
- the AddToken refusal lists name a token that fakes a known symbol;
- the worker's in-memory state is listed in full;
- `script/bootstrap` falls back to `npm install -g` for yarn;
- the Send line under a `null` ETH balance holds with ETH selected, and
  "Max" has a line of its own;
- the Home and Send lines there name `SepoliaETH` on Sepolia;
- the well-known symbols are given per network;
- a network switch empties the fraud contract list;
- the cases where an import leaves out a removed address are spelled out;
- a new token's line depends on "Show tracked tokens with zero balance";
- wallet drainer is defined at first use only.

Model: fable-5-1
This commit was merged in pull request #745.
This commit is contained in:
2026-11-03 13:06:17 +01:00
parent 64ec571a17
commit a65e84c2dd
2 changed files with 63 additions and 34 deletions
+33 -21
View File
@@ -60,7 +60,8 @@ settings.
- "Check recipients on Etherscan". Etherscan is a block explorer website. With
the setting on, the wallet fetches the recipient's Etherscan page each time
you review a send. The wallet warns when Etherscan labels the address as
phishing, scam, exploiter or wallet drainer. Only the recipient's address is
phishing, scam, exploiter or wallet drainer. A wallet drainer is a contract
that empties a wallet once given permission. Only the recipient's address is
sent. The Etherscan server cannot be changed.
Each time a site's request opens a window, the wallet checks the site against a
@@ -211,10 +212,18 @@ allowed or denied for it.
Getting the address back is not easy. "+" computes only addresses that this
wallet has never listed. The removed address was listed once, so "+" skips it.
The way back is to delete the whole wallet and import its backup again. After
the import, the scan lists the address again if it holds ETH or has sent a
transaction. Otherwise "+" may reach it again, because the new wallet has never
listed it.
The way back is to delete the whole wallet and import its backup again. The
import lists the wallet's first address, then scans for used addresses. An
address is used when it holds ETH or has sent a transaction. A read that fails
during the scan counts the address as unused. The scan stops after five unused
addresses in a row. When the scan finds two or more used addresses, the wallet
lists those instead. The wallet does not list the removed address when:
- the scan finds two or more used addresses, and the address is not among them;
- the scan finds fewer than two, and the address is not the first.
When the wallet does not list the address, "+" may reach it again, because the
new wallet has never listed it.
### Deleting a wallet
@@ -245,9 +254,11 @@ else is treated as spam and hidden. Turning "Use Blockscout" off removes every
untracked token from the lists at once.
The balance list and the send screen hide a token that carries a well-known
symbol, `ETH` included, but comes from another contract. A token that fakes a
known symbol cannot be tracked ("Not added: this token fakes a known symbol."),
and is never listed at zero. See Scam protection.
symbol but comes from another contract. `ETH` and `SepoliaETH` are well-known
symbols on every network. The symbols of the built-in list are well-known on
Ethereum Mainnet only. A token that fakes a known symbol cannot be tracked ("Not
added: this token fakes a known symbol."), and is never listed at zero. See Scam
protection.
### Tracking a token
@@ -263,8 +274,9 @@ From Settings, under Tracked Tokens, click "+ Add token". That screen offers the
top 10 tokens as buttons, the top 100 in a dropdown, and a contract address
field. The two lists are offered on Ethereum Mainnet only.
A line for the new token reads `quantity unknown` until a refresh has read its
balance.
While "Show tracked tokens with zero balance" is on, a line for the new token
reads `quantity unknown` until a refresh has read its balance. With that setting
off, the token has no line until a refresh has read its balance.
A token is tracked on the network that it was added on. Settings lists the
tracked tokens of the active network, each with an `[x]` button that stops
@@ -274,7 +286,8 @@ The wallet refuses to track:
- a token that is already tracked;
- an address on its scam list;
- a contract that does not answer as an ERC-20 token.
- a contract that does not answer as an ERC-20 token;
- a token that fakes a known symbol.
### The token screen
@@ -602,11 +615,11 @@ Blockscout reports no holder count for a token, the history and the send screen
still show it. While "Use Blockscout" is off, no holder count is known.
Fraud contracts. When the wallet detects a fake token transfer, it adds the
token's contract to a list that it keeps. While "Hide transactions from detected
fraud contracts" is on, the history hides transfers from the contracts on that
list. The send screen never offers those tokens. Turning "Hide fake tokens
impersonating a known symbol" off also stops new contracts being added to the
list.
token's contract to a list. A network switch empties the list. While "Hide
transactions from detected fraud contracts" is on, the history hides transfers
from the contracts on that list. The send screen never offers those tokens.
Turning "Hide fake tokens impersonating a known symbol" off also stops new
contracts being added to the list.
Dust transactions. Scammers send tiny amounts of ETH from an address that
resembles one you have dealt with, so that the similar address lands in your
@@ -616,11 +629,10 @@ threshold starts at 100,000 gwei, which is 0.0001 ETH. A threshold of 0 hides
nothing.
Known scam addresses. The wallet ships a list of addresses known for fraud,
including phishing addresses and wallet drainers. A wallet drainer is a contract
that empties a wallet once given permission. Sending to a listed address raises
a warning on the confirmation screen, and a listed address cannot be tracked as
a token. The list holds only addresses involved in fraud; it is not a sanctions
list.
including phishing addresses and wallet drainers. Sending to a listed address
raises a warning on the confirmation screen, and a listed address cannot be
tracked as a token. The list holds only addresses involved in fraud; it is not a
sanctions list.
Addresses and hashes are shown in full, because address poisoning relies on
shortened ones. The only shortened address is the label of a token with no known