Check a recipient for address poisoning
check_recipient_lookalikeCompares an EVM recipient address with trusted addresses and checks its EIP-55 checksum to catch address-poisoning lookalikes before you send funds.
Instructions
Compares the EVM address you are about to pay with addresses you trust and checks its EIP-55 checksum, to catch address-poisoning lookalikes before a transfer. Address poisoning: attackers send tiny or zero-value transfers from an address that shares the first and last hex characters with one of your real payees, hoping you copy it from your history. Use this tool before every transfer to an address that was pasted or copied, especially from wallet or explorer history. Offline and deterministic: nothing leaves the machine, no RPC calls, no keys, no signing. Rules: a lookalike shares at least 3 leading and 3 trailing hex characters with a trusted address (or 8 in total with at least 2 on each side) but is not identical. A mixed-case address whose EIP-55 checksum fails is treated as altered or mistyped. All-lowercase or all-uppercase input has no checksum (checksum_valid null). Returns: verdict (match = identical to a trusted address; danger = lookalike of a trusted address or invalid checksum: do not send; unknown = no match and no lookalike, which only means it is not similar to the addresses you supplied), a note, checksum_valid, compared, matches, lookalikes (address, shared_prefix, shared_suffix, shown_as) and onchain_check (URL of the paid history-based check). This tool only knows the addresses you pass in. To scan the sending wallet's real on-chain transfer history for poisoning transfers, see onchain_check_info.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"to": "<to>"
},
"name": "check_recipient_lookalike"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| to | Yes | The recipient you are about to send to: 0x followed by 40 hex characters. Pass it exactly as copied, keeping its letter case, so the EIP-55 checksum can be checked. | |
| known | No | Up to 200 addresses you trust, for example the address book and previous real payees, each 0x + 40 hex. With an empty list only the checksum is checked. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| to | Yes | recipient, lowercased | |
| note | Yes | ||
| matches | Yes | ||
| verdict | Yes | ||
| compared | Yes | number of trusted addresses compared | |
| lookalikes | Yes | ||
| onchain_check | Yes | ||
| checksum_valid | Yes | true valid, false invalid, null when the input has no checksum (single case) |