Cross-Chain Token Supply Reconciliation Tool

WHAT IT DOES

Cross-Chain Token Supply Reconciliation Tool reads on-chain totalSupply() and balanceOf() for any ERC-20 token across multiple EVM chains simultaneously. It connects to public RPC endpoints for each chain you specify—Ethereum, Polygon, Arbitrum, Optimism, BNB Chain, Fantom, Avalanche, and others—and fetches the token's total supply, your wallet balance (if connected), and current gas prices. The results are displayed in a clean table showing each chain's supply, your balance, and gas costs, with aggregate totals and averages computed automatically.

This tool is designed for token teams, auditors, and DeFi users who need to verify that a token's supply is consistent across chains, or who want a single view of their holdings for a token deployed on multiple networks. It helps answer questions like: "Is the total supply on Polygon the same as on Ethereum?" or "How many of my tokens are spread across Arbitrum and Optimism?"

HOW TO USE

1. Connect your EVM wallet (optional—balance checks require connection, but totalSupply reads do not).

2. Select or switch to any network—this sets the context for RPC selection but does not limit the chains you can query.

3. Enter the chain IDs you want to query (one per line), such as 1 for Ethereum, 137 for Polygon, 42161 for Arbitrum.

4. Paste the token contract address (must be the same address on all chains, which is typical for deterministic deployments).

5. Optionally adjust the token decimals (default 18) if the token uses a different value.

6. Click "Reconcile Supply"—the tool sequentially queries each chain's RPC, fetches totalSupply, your balance (if connected), and gas price.

7. Review the results table showing per-chain data, plus aggregated totals and averages.

TECHNICAL MECHANISM

The tool uses a per-chain RPC provider instantiated from public endpoint URLs. For each chain, it creates a lightweight ethers.js Contract instance with the ABI for totalSupply(), decimals(), and balanceOf(address). Calls are made sequentially to avoid rate-limiting issues on public RPCs—concurrency is capped at one at a time, with visible progress. Each chain's response is independent, so a failure on one chain does not block others. The tool formats raw BigNumber values into human-readable decimals using ethers.utils.formatUnits(), and gas prices are displayed in Gwei for quick cost estimation. The aggregate summary computes average supply (to spot deviations) and total balance across chains (to show combined holdings).

WHAT IT CANNOT SEE

This tool cannot verify actual circulating supply. Total supply on a chain may include tokens locked in bridges, vesting contracts, or multisigs that are not actually circulating. It cannot detect burned tokens unless the burn address is explicitly checked (not included in this read). It cannot account for tokens held on non-EVM chains (Solana, Tron, Bitcoin, etc.) or off-chain (centralized exchanges, custody). Cross-chain messaging delays mean the tool sees only the current state of each chain independently—it does not reconcile bridge contract events or verify that wrapped versions are properly backed. RPC availability varies; public endpoints may rate-limit or fail, and the tool's results depend on the responsiveness of each chain's provider.

PLEASE NOTE

EVM chains only. The tool relies on public RPCs; for production use, consider bringing your own RPC URLs (future enhancement). Always verify that the token address is the canonical deployment on each chain—some chains may use different addresses for the same token. This tool is read-only and does not sign or send transactions.