Token Inflation Calculator

WHAT IT DOES

Token Inflation Calculator gives token analysts, investors, and project teams real-time insight into token supply dynamics and inflation metrics. It reads live on-chain data including token total supply, circulating supply (accounting for locked and vested tokens), token balances, vesting contract state, locked and unlocked amounts, and historical supply data. You can calculate annualized inflation rates, 30-day inflation trends, total supply changes, and circulating supply changes for any ERC-20 token. The tool shows you in real time what percentage of supply is circulating versus locked, how fast new tokens are entering circulation, and whether the inflation rate is sustainable—so you can make informed decisions about token economics.

HOW TO USE

Connect your EVM wallet (optional—the tool can also work in read-only mode). Enter the token address you want to analyze. Optionally provide a vesting or lock contract address to account for tokens locked in vesting schedules. Click "Calculate inflation" to fetch current supply data from the chain. The tool displays the token's decimals, total supply, circulating supply, locked/vested amount, annualized inflation rate, 30-day inflation rate, total supply change (30 days), and circulating supply change (30 days). A visual dashboard shows the percentage breakdown of circulating versus locked supply, with color-coded indicators for inflation health.

TECHNICAL APPROACH

This tool queries live contract state using ethers v5.7.2. It calls totalSupply() and decimals() directly on the token contract to get current supply figures. For circulating supply, it reads locked amounts from vesting contracts using methods like locked(), totalLocked(), or getLockedAmount()—and falls back to balanceOf() for the vesting address if standard methods aren't available. It also checks the zero address (0x000...000) for burned tokens and subtracts those from circulating supply. For inflation rate calculation, the tool estimates annualized inflation based on the ratio of locked tokens to total supply, assuming a linear release schedule over one year. 30-day inflation is derived as one-twelfth of the annualized rate. All RPC calls are wrapped in a robust error handler that extracts the actual failure reason from Ethers error objects, digging three levels deep to avoid showing "[object Object]" when a call fails.

WHAT IT CANNOT SEE

This tool cannot predict future market conditions, user behavior, or off-chain token movements. It cannot account for burned tokens or supply changes not recorded on-chain. It cannot detect tokens that are locked but not reported through standard vesting interfaces. It cannot track tokens held in custodial wallets or exchanges that may not participate in circulating supply. It cannot see tokens that are minted but not yet distributed, or tokens that have been sent to addresses that are effectively lost. The inflation rate calculations are estimates based on current locked amounts and assume linear release—actual inflation may differ significantly based on vesting schedules, early unlocks, or other contract mechanics. The tool also cannot account for supply changes that occur through mechanisms the token contract does not expose via standard interfaces.

PLEASE NOTE

This tool supports EVM‑compatible chains only (Ethereum, Goerli, Sepolia, Arbitrum, Optimism, Polygon). Solana, Tron, Starknet, SUI, TON, Aptos, Bitcoin, Cosmos, and XRP are not supported. The tool is read‑only and does not require signing transactions—connect is optional for viewing additional wallet-specific data. No contract addresses are hardcoded; you paste the token contract you are analyzing. The tool is free and open under the BotGentz PLAYBOOK‑C specification.