Wallet Address Labeler

WHAT IT DOES

The Wallet Address Labeler is a read-only tool that helps you identify and label Ethereum addresses. Enter any address and the app fetches its ENS name (if available), checks whether it's a contract or an externally owned account (EOA), displays its current ETH balance, and shows its transaction count. You can then assign your own custom label to that address — for example, "My vault," "Exchange hot wallet," "Team multisig," or "Suspicious airdrop sender." Labels are stored in browser memory and persist as long as the page is open, making it easy to keep track of addresses you interact with regularly. This is particularly useful for developers, auditors, and power users who want to annotate addresses without relying on third-party services.

HOW TO USE

1. Select your network from the dropdown or connect your wallet to use its RPC endpoint.

2. Enter an Ethereum address into the input field.

3. Click "Look up label" to fetch metadata: ENS name, contract status, balance, and transaction count.

4. Review the results in the card below.

5. To add your own label, type a name into the "Set your own label" input field and click "Save label."

6. The label will appear in the "Your label" row and will persist as long as the page is open.

7. To remove a label, clear the input and click "Save label."

8. Use the "Clear" button to reset all fields and start a new lookup.

ONE TECHNICAL SECTION

This tool combines on-chain RPC data with off-chain ENS resolution to provide a complete address profile. It uses ethers v5's provider.getCode() to determine if an address is a contract (non-empty bytecode) or an EOA. The balance is fetched via provider.getBalance(), and the transaction count via provider.getTransactionCount(). For ENS lookup, the app uses a separate mainnet provider with the lookupAddress method, which resolves reverse records. The tool then presents all this data alongside user-provided labels stored in a simple JavaScript Map object. Because the page runs in an opaque-origin sandboxed frame, browser storage is not available — labels exist only in memory for the current session. This design ensures no data is persisted across reloads, which is intentional for privacy and simplicity, and the tool explicitly states this limitation.

WHAT IT CANNOT SEE

This tool cannot verify the accuracy of user-provided labels — a label is just text you assign, not a verified identity. It cannot detect malicious addresses or scams; it only shows on-chain data and your own notes. It cannot guarantee that ENS names are up-to-date or correct, as ENS records can be changed by the owner. The tool cannot automatically label all addresses, especially newly created ones or those without ENS.

PLEASE NOTE

Sites and services change over time and this app may need updating to match.