Token upgrade and migrationAn entire token community moved to an upgraded contract, with every line tested first.
How we moved a token community from its original contract to an upgraded version: migration contracts with 100% test coverage, protection against double claims, a claim website and full documentation.
- Client
- Confidential client
- Industry
- Digital assets
- Year
- 2025
- Our scope
- Smart contracts, testing, claim website and documentation

The impact
- test coverage on the migration contracts
- 100%
- per holder, enforced by the contract
- 1 claim
- migration completed for every holder
- V1 → V2
The challenge
The client needed to move every holder from its original token to an upgraded one. A migration like this handles real people’s money, and once the contract is live, a mistake can’t be reversed.
The biggest risk was a holder claiming new tokens twice, which would quietly drain the supply and damage the community’s trust.
What we built
Move every holder safely to the new token
Migration smart contracts
Old tokens are swapped for new ones automatically.
No double claims
Each holder can claim exactly once, enforced by the contract itself.
A simple claim website
Holders connect a wallet and claim in a few clicks.
Clear documentation
The community can see exactly how the migration works.
The results
- 100% test coverage on the migration contracts
- Built-in protection, so no holder can claim twice
- Migration completed for the whole holder community
- Claim website and full documentation delivered
Services
Built with
- Solidity
- ERC-20
- Ethers.js