Multi-Chain Treasury Reporting Aggregator

WHAT IT DOES

This tool connects to your EVM wallet and fetches native token balances (ETH, BNB, MATIC, etc.) and ERC-20 token balances for multiple wallet addresses across multiple EVM chains. You provide a list of wallet addresses and optional token contract addresses, and the tool returns a consolidated summary showing total native value, per-address breakdowns, and individual token balances. It also offers an optional history scan that fetches transaction activity over the last 1000 blocks, calculating total received, total sent, and net flow for the specified addresses.

HOW TO USE

Connect your Web3 wallet using the Connect button. Select the network you wish to query from the dropdown—this is a read-only query and does not require switching your wallet. Enter wallet addresses one per line in the Addresses field. Optionally, enter ERC-20 token contract addresses one per line in the Tokens field; leave this blank to query native balances only. Click "Fetch Balances" to retrieve current balances, or "Fetch History (last 1000 blocks)" to see recent transaction activity. Results appear in the Results card with a summary grid and detailed per-address breakdowns.

TECHNICAL MECHANISM: MULTI-ADDRESS AGGREGATION WITH ETHERS.JS

The tool uses ethers.js to create contract instances for each token address, dynamically fetching decimals and symbols via on-chain calls. It iterates through address lists and token lists, making batched balanceOf calls through the connected provider. Native balances are fetched using provider.getBalance() for each address. The tool aggregates totals using ethers.BigNumber to maintain precision, then formats results using ethers.utils.formatEther() and formatUnits(). For history, it queries provider.getHistory() within a configurable block range, filtering transactions by address and calculating net native token flow. All operations are sequential with proper error handling, and the tool displays progress feedback during execution.

WHAT IT CANNOT SEE

This tool cannot aggregate across non-EVM chains—Solana, Tron, Starknet, SUI, TON, Aptos, Bitcoin, Cosmos, and XRP are not supported. It cannot track off-chain treasury holdings, fiat-equivalent values, or pending transactions. It cannot simulate future balances or predict token prices. Token balances are limited to the contract addresses you explicitly provide; the tool does not auto-discover tokens in a wallet. History scans are limited to the last 1000 blocks and only include native token transfers, not ERC-20 events. The tool relies entirely on RPC node availability—if your provider is rate-limited or offline, queries will fail.

PLEASE NOTE

This is a read-only tool—it never signs transactions or requests write permissions. All data is fetched on-demand and stored only in memory; nothing is persisted across page reloads. The tool does not cache results, so repeated queries will re-fetch from the RPC. Always verify that your RPC provider supports the block range you are querying; some public endpoints cap historical data. For accurate treasury reporting, ensure you include all relevant token contract addresses for the wallets you are tracking.