Native Token Symbol and Decimals Registry Lookup

WHAT IT DOES

This tool connects to your EVM wallet and looks up native token information including symbol, decimals, name, and optionally total supply. It retrieves data from built-in chain metadata for supported networks, and optionally from token registry contracts or direct token contract queries. The tool provides a quick reference for native token properties that are essential for formatting balances, calculating values, and interacting with dApps across different EVM chains.

HOW TO USE

Connect your Web3 wallet using the Connect button. Select the network from the dropdown—the tool will automatically display the native token information for that chain. Optionally, enter a token registry contract address to query custom token information. You can also enter a token address to look up an ERC-20 token's symbol and decimals directly. Click "Look Up Native Token" to fetch and display the information. Click "Load Sample" to populate fields with example addresses. Results appear in the Results card with chain ID, symbol, decimals, and the source of the information.

TECHNICAL MECHANISM: MULTI-SOURCE TOKEN DATA RETRIEVAL

The tool uses a tiered approach to retrieve token information. First, it uses a built-in registry of chain IDs mapped to native token symbols, names, and decimals for supported EVM chains (Ethereum, Optimism, BNB Chain, Polygon, Fantom, Arbitrum, Avalanche, Base). If a registry contract address is provided, the tool queries it using ethers.js to call symbol(), decimals(), and optionally name() functions. If a token address is provided, the tool queries that ERC-20 contract directly for the same information. The tool prioritizes registry or token contract data over built-in metadata when available, and displays the data source for transparency.

WHAT IT CANNOT SEE

This tool cannot detect native token information for chains without a standard registry or metadata endpoint—the built-in registry covers major chains but not all. It cannot verify that registry data is up-to-date or accurate—the tool trusts the data source. It relies on registry contract interfaces and may not support all token standards—the tool assumes standard ERC-20 functions. It cannot handle chains with non-standard native token representations—some chains may not expose the standard interface. It cannot discover tokens that are not registered in the lookup registry—the tool only queries provided addresses or built-in metadata.

PLEASE NOTE

This is a read-only tool—it never signs transactions. All data is fetched on-demand and stored only in memory; nothing is persisted across page reloads. The tool supports EVM chains only—Ethereum, Polygon, BSC, Arbitrum, Optimism, Avalanche, Base, and Fantom. The built-in registry includes common native tokens—custom tokens require a registry or direct contract address. Token decimals are essential for proper value formatting—always verify decimals before displaying token amounts.