Legacy Token Snapshot-and-Migrate Tool

WHAT IT DOES

This tool provides a complete on-chain solution for snapshotting legacy token balances and migrating them to a new token contract. It reads your connected wallet address, legacy token contract address, new token contract address, token balances at a specified snapshot block, token holders list, snapshot block number, current block timestamp, migration eligibility status, token decimals, and total supply. You can then sign and send transactions to take snapshots of holder balances, migrate token balances from legacy to new tokens, claim migrated tokens, and record migration status on-chain. All migration parameters are displayed in a clear review panel before you sign, so you know exactly what you are migrating. The tool also logs transaction hashes, confirmation status, and gas costs, providing a complete audit trail of all migration activities.

HOW TO USE

Connect your wallet using the built-in wallet bridge, choose the network that matches your token contracts, and paste the legacy token contract address and new token contract address. Optionally, provide a migration contract address if you're using a dedicated migration contract. Enter the token decimals, the snapshot block number at which balances should be captured, and a comma-separated list of holder addresses to include in the snapshot. The review panel shows all inputs and the current block timestamp before you sign. Use the numbered action buttons: take snapshot to capture current balances for all listed holders at the specified block, migrate balances to transfer token balances from legacy to new tokens, or claim migration if using a claim-based migration contract. You can also check status to view migration progress for all holders, or read balances to see current legacy and new token balances. Each transaction is signed sequentially, and the tool displays transaction details and confirmation status.

THE REAL MECHANISM

This tool uses ethers.js v5.7.2 to build and send transactions through the wallet's signer. It does not rely on any hardcoded contract addresses – you paste the contracts you are using, so you are in full control. When you take a snapshot, the tool reads the balance of each holder address at the specified block number using the legacy token's balanceOf function with an optional block override. The snapshot data is stored in memory and displayed in the log area for review. When you migrate balances, the tool constructs contract calls to either a migration contract's migrate function (which accepts arrays of holders and amounts) or mints new tokens directly to each holder using the new token's mint function. For claim-based migration, the tool calls the migration contract's claim function to let holders claim their allocated tokens. The tool also supports batch processing, sequentially calling the contract for each holder or sending one batch transaction to save gas. All transactions are sequential to prevent nonce conflicts, and gas costs are calculated using effectiveGasPrice for accurate post-EIP-1559 reporting.

WHAT IT CANNOT SEE

This tool cannot verify off-chain token utility, ensure correct token valuation, detect token contract vulnerabilities, or verify that the migration contract handles edge cases correctly. It cannot detect if the legacy token balances are accurate or if the new token contract behaves as expected. The tool also cannot verify that the migration contract correctly handles decimal places, token transfers, or edge cases like zero balances or duplicate holders. It cannot simulate the outcome of a transaction before you sign it, nor can it guarantee that the migration will be correctly processed if the contracts are not properly implemented.

PLEASE NOTE

This tool works only on EVM-compatible chains supported by your wallet and provider. Always double-check the contract addresses, snapshot block number, and holder list before signing. Use testnet first. The tool is a transaction-signing interface and migration management tool, not a token valuation or security audit system.