evm-token-decimals

Silent decimal mismatches are one of the easiest ways to ship balances or USD values that are off by orders of magnitude without throwing an error. Never assume stablecoins use the same decimals everywhere. Query decimals() at runtime, cache by (chain_id, token_address) , and use decimal-safe math for value calculations. Do not hardcode 1_000_000 because a symbol usually has 6 decimals somewhere else. Log the fallback and keep it visible. Old or non-standard tokens still exist. - Reading ERC-20 balances in Python, TypeScript, or Solidity - Calculating fiat values from on-chain balances - Comparing token amounts across multiple EVM chains - Handling bridged assets - Building portfolio trackers, bots, or aggregators - Always query decimals() at runtime - Cache by chain plus token address, not symbol - Use Decimal , BigInt , or equivalent exact math, not float - Re-query decimals after bridging or wrapper changes - Normalize internal accounting consistently before comparison or pricing