Token migrations are one of the most confusing and risky events in crypto. When a Solana project announces a migration to a new token contract, holders face urgent questions: Is this legitimate? How do I swap? What happens if I miss the deadline?
This guide explains how token migrations work on Solana, why they happen, and — most importantly — how to protect yourself during one.
A token migration is when a project replaces its existing token with a new one. Holders of the old token swap them for the new token, usually at a 1:1 ratio. The old token is then deprecated and eventually becomes worthless.
After the migration:
- The new token has a different mint address (contract address)
- The old token stops being supported by the project
- DEX liquidity moves to the new token
- Wallets and explorers update to show the new token
Why Do Projects Migrate Tokens?
Technical Upgrades
The most common legitimate reason. Projects migrate to:
- Token-2022: Moving from the original SPL Token program to Token-2022 to access features like transfer fees, confidential transfers, or metadata extensions. See our Token-2022 guide for details.
- Fixed supply issues: If the original token was minted with incorrect parameters (wrong decimals, unfrozen mint authority that should have been frozen).
- Program upgrades: When a project's token is deeply integrated with their program and a major protocol change requires a new token.
Security Reasons
Sometimes a migration is forced by a security incident:
- Compromised mint authority: If the private key controlling token minting is compromised, the project must migrate to a new token to prevent unauthorized minting.
- Exploit remediation: After a DeFi exploit, projects sometimes migrate tokens to "snapshot" balances and exclude the attacker's stolen tokens.
- Vulnerability discovered: If a critical vulnerability is found in the token's program (for custom programs), migration may be the safest fix.
Business/Strategic Reasons
- Rebranding: The project is changing its name, ticker, or identity.
- Tokenomics redesign: Changing supply, implementing vesting, or restructuring the token economy.
- Merger/acquisition: Two projects combining their tokens into a unified one.
- Chain migration: Less common within Solana, but projects sometimes migrate between Solana and other chains.
How Token Migrations Work on Solana
The Basic Process
Most Solana token migrations follow this pattern:
- Announcement: The project publicly announces the migration with details on timing, ratios, and process.
- Snapshot (sometimes): The project takes a snapshot of all holders at a specific block height.
- Migration portal: A web application where holders connect their wallet and swap old tokens for new ones.
- Liquidity transition: DEX liquidity is moved from old to new token pools.
- Deadline: After a set period, the migration portal closes and old tokens become worthless.
Migration Methods
Portal-based swap: The most common method. You connect your wallet to a project's website and approve a transaction that sends your old tokens to a burn/treasury address and receives new tokens in return.
Airdrop-based: The project snapshots all holders and airdrops new tokens directly to their wallets. Holders don't need to take any action except to verify receipt. Old tokens are not automatically burned.
DEX-based: The project creates a swap pool (e.g., on Raydium) where you can trade old tokens for new ones. This is less common because it requires the project to provide liquidity.
Claim portal: Similar to the airdrop method, but holders must actively claim their new tokens from a smart contract. This reduces the project's cost (no airdrop gas fees) while still being straightforward for users.
How to Verify a Migration Is Legitimate
Token migrations are a prime vector for scams. Here's how to verify before you swap.
1. Check Official Channels
- Only use links from the project's verified Twitter/X account, official website, and official Discord/Telegram.
- Cross-reference the announcement across multiple official channels. A real migration will be announced everywhere, not just in a random DM.
- Check that the announcement comes from the actual verified account, not a lookalike with a slightly different username.
2. Verify the New Token
Before swapping, verify the new token's contract on Solscan:
- Mint authority: Is it controlled by the project's known addresses? Or is it an unknown wallet?
- Supply: Does the total supply match what the project announced?
- Metadata: Do the name, symbol, and image match the project's branding?
- Run RugCheck: Use RugCheck to analyze the new token's risk factors.
3. Never Trust DMs
No legitimate project will DM you about a migration. If you receive a message saying "urgent: migrate your tokens now" with a link, it's a scam. Always navigate to the project's official website manually.
4. Check Community Discussion
Look at the project's public Discord or Telegram. Are real community members discussing the migration? Is the team responding to questions? A legitimate migration generates real community discussion. A scam migration has only the scammer posting.
5. Wait and Verify
Unless there's an extremely short deadline, there's no rush. Legitimate migrations give holders weeks or months to swap. If you're told you have "24 hours or lose everything," be very skeptical.
6. Start Small
If you hold a large amount, swap a small portion first. Verify you receive the correct amount of new tokens, then swap the rest.
Common Migration Scams
Fake Migration Portal
A scam site that mimics the real project's website. When you "approve" the swap, it drains your wallet instead. Always verify the URL matches the project's official domain.
Impersonator Announcements
Fake Twitter accounts or Telegram groups announcing a "migration" for a real project. The link goes to a phishing site.
Premature "Migration" for New Tokens
Scammers launch a token, build some hype, then announce a "migration" to a new token. The migration is actually a way to steal the liquidity pool — the new token has no real value or liquidity.
Fake Airdrop Claims
You receive tokens in your wallet that you didn't buy. The tokens have a URL in their name ("claim-migration-at-website.com"). Visiting the site and connecting your wallet drains your real tokens.
For Project Teams: Running a Safe Migration
If you're running a token migration, here's a checklist:
Communication
- Announce the migration at least 2-4 weeks in advance
- Post the announcement on all official channels simultaneously
- Provide the new token's mint address prominently
- Explain the reason for migration clearly
- Set a generous deadline (minimum 30 days, ideally 90+)
Technical Setup
- Deploy the migration contract/portal on a well-audited codebase
- Have the migration contract audited by a reputable firm
- Test the migration process on devnet thoroughly
- Set up the new token with correct parameters (supply, decimals, authorities)
- Freeze mint authority on the new token (or explain why it's not frozen)
Liquidity
- Plan the liquidity transition in advance
- Consider providing liquidity on both old and new token pairs during the transition period
- Coordinate with DEXs and aggregators to list the new token
- Contact Jupiter and Birdeye for metadata updates
Support
- Staff support channels during the migration period
- Create a detailed FAQ document
- Prepare step-by-step guides with screenshots
- Monitor for scam sites and report them immediately
What Happens If You Miss a Migration
If you hold tokens and miss the migration deadline:
- Check if the portal is still open: Some projects keep migration portals open indefinitely or reopen them periodically.
- Contact the project team: Many projects will manually process late migrations for verified holders, especially for large amounts.
- Check for exchange support: If the token was listed on any centralized exchanges, the exchange may have automatically processed the migration.
- Accept the loss: In the worst case, if the project has fully deprecated the old token and won't process late swaps, the old tokens become worthless. This is why paying attention to migration announcements matters.
Notable Solana Token Migrations
Several major Solana projects have successfully migrated tokens:
- Projects migrating to Token-2022 for transfer fee functionality
- DeFi protocols upgrading token contracts after security audits
- Gaming tokens migrating after game economy redesigns
Each migration was handled differently, but the successful ones shared common traits: clear communication, generous timelines, and multiple verification channels.
Migration Checklist for Holders
When you hear about a token migration:
- Verify the announcement on the project's official website and Twitter
- Check the new token contract on Solscan
- Run the new token through RugCheck
- Read community discussion in official channels
- Never click links from DMs or unofficial sources
- Navigate to the migration portal manually (type the URL)
- Swap a small test amount first
- Verify receipt of new tokens
- Complete the full swap
- Confirm old tokens are no longer needed and the new ones appear correctly in your wallet
Final Thoughts
Token migrations are a normal part of the crypto ecosystem, but they require vigilance. The technical process is usually straightforward — connect wallet, approve swap, receive new tokens. The risk comes from scammers exploiting the confusion around migrations to steal funds.
The golden rule: always verify through official channels, never rush, and when in doubt, wait. Legitimate projects give you plenty of time and clear instructions. If it feels urgent or the information is hard to verify, that's a warning sign.
Stay informed about the projects you're invested in, follow their official communication channels, and you'll navigate token migrations safely.
FAQ
How long do token migrations usually take?
Most Solana token migrations run for 30-90 days. The swap itself takes seconds (one transaction), but the full migration window gives all holders time to participate. Some projects keep portals open indefinitely. Always check the specific deadline for each migration.
Do I need to pay fees for a token migration?
You'll pay a standard Solana transaction fee (a fraction of a cent) to execute the swap. Legitimate migrations don't charge additional fees. If a "migration" asks you to send SOL or pay a fee beyond the normal transaction cost, it's likely a scam.
What happens to the old token's liquidity after migration?
The project removes liquidity from the old token's DEX pools and redeploys it on the new token. During the transition period, both tokens may have active pools. After the migration deadline, old token pools are drained and the old token becomes effectively worthless.
Can a project force a migration without my consent?
On Solana, a project cannot automatically swap tokens in your wallet without your approval. However, if a project migrates and you don't swap, your old tokens lose value as the project, exchanges, and DEXs stop supporting them. So while it's not forced, the practical impact of not migrating is the same.
