Token Migration

WHAT IT DOES

Token Migration provides a secure, guided interface for swapping old ERC-20 tokens for new ones through a migration contract on EVM-compatible chains. Enter the old token address, new token address, migration contract address, and the amount you wish to migrate, then review the details before signing any transaction. The tool automatically checks your old token balance, verifies that you have sufficient funds, and examines the current allowance granted to the migration contract. If the allowance is insufficient, the tool handles the approval transaction first, then executes the migration in a single workflow. The migration contract's migrate() function is called with the specified amount, and the tool monitors the transaction until it is confirmed, displaying the transaction hash, gas used, and effective gas price. This eliminates the need to manually craft approvals or interact directly with smart contracts, reducing the risk of mistakes during token upgrades, protocol migrations, or token swaps.

HOW TO USE

Connect your EVM wallet using the Connect button in the header, then select the network that matches the token contracts from the dropdown menu. Fill in the four required fields: the old token address, the new token address, the migration contract address, and the amount of old tokens you want to migrate. Click "Review migration" to check your balance, allowance, and all contract details. The review panel displays your wallet address, token symbols, balance, amount to migrate, and whether an approval is needed. Carefully verify that all contract addresses are correct—this tool does not validate the safety or legitimacy of contracts. If everything looks correct, click "Approve & migrate." The tool will first submit an approval transaction if needed, then submit the migration transaction. Progress messages appear throughout the process, and the final result includes a link to the transaction on the block explorer for verification.

THE TECHNICAL MECHANISM

Token Migration uses the standard ERC-20 and migration contract interfaces to orchestrate a multi-step transaction flow. The tool first instantiates a contract object for the old token using the ERC-20 ABI, then calls balanceOf() to verify the user's balance and allowance() to check current spending approval for the migration contract. If the allowance is less than the requested migration amount, the tool constructs and sends an approve() transaction with the exact amount needed. After the approval is confirmed (or if it was already sufficient), the tool instantiates the migration contract and calls its migrate() function, passing the parsed amount in the correct decimal format. The tool uses ethers.js to parse and format amounts with the token's decimal precision (obtained via decimals()), ensuring compatibility with tokens of varying decimal places. Both transactions are sequenced correctly: approval must complete before migration, preventing nonce conflicts and gas estimation issues. The tool also uses receipt.effectiveGasPrice for accurate cost reporting, correctly handling EIP-1559 transactions.

WHAT IT CANNOT SEE

Token Migration cannot verify that the migration contract is non-malicious or that the new token is legitimate. It does not audit contract code, check for honeypot patterns, or validate that the migration contract was deployed by the token's official team. The tool cannot detect token migrations that require a Merkle proof, signature verification, or any other authentication mechanism beyond a standard approve() and migrate() call—if the migration requires additional parameters, this tool will not support it. It is limited to EVM-compatible chains only and cannot interact with non-EVM blockchains. The tool cannot identify scams or malicious migration contracts beyond the addresses provided by the user—you are solely responsible for verifying that the addresses are correct and belong to the legitimate token migration process.

PLEASE NOTE

This tool signs and sends transactions. Always verify contract addresses and amounts before approving or migrating. The tool will request approval to spend your old tokens—this is required for the migration contract to transfer your tokens. This approval grants the migration contract permission to spend the specified amount; only use migration contracts that you trust. The tool is free to use and is intended for informational and migration assistance purposes only. The developer assumes no liability for losses resulting from using incorrect addresses, malicious contracts, or user error. Always cross-reference contract addresses with official project announcements and block explorer verification.