Introduction
SushiSwap’s V3 introduces concentrated liquidity, custom fee tiers, and more refined control for liquidity providers. :contentReference[oaicite:0]{index=0} If you currently hold positions in V2, migrating to V3 might bring better capital efficiency—but it also introduces new complexity. This guide will walk you through the migration process step by step, highlight security best practices, address troubleshooting, and answer common user questions.
Step 1: Review V3 Features & Differences
Before migrating, understand what changes in V3:
- Concentrated Liquidity: You must choose a price range where your capital will be active. :contentReference[oaicite:1]{index=1}
- Custom Fee Tiers: Multiple fee levels (e.g. 0.05%, 0.30%, 1.00%) allow more flexible risk/reward choices. :contentReference[oaicite:2]{index=2}
- NFT Positions: In V3, each liquidity position is represented as an NFT you can manage or transfer. :contentReference[oaicite:3]{index=3}
Step 2: Prepare Your V2 Liquidity for Removal
- Go to SushiSwap V2 UI and locate your LP position.
- Unstake or withdraw any rewards or incentives first.
- Remove your liquidity from the V2 pool (this returns your underlying tokens).
- Ensure your wallet has enough ETH (or the chain’s native token) for gas fees.
Step 3: Migrate to V3 Safely
- Visit the official SushiSwap V3 migration or “Migrate Liquidity” interface (check docs at Sushi V3 docs). :contentReference[oaicite:4]{index=4}
- Select the tokens you withdrew from V2 that correspond to the V3 pool you intend to join.
- Choose an appropriate price range and fee tier for your V3 liquidity. Be cautious—too narrow a range may lead to underutilization.
- Approve token transfers for the migration contract (only the amount you intend to migrate, avoid unlimited approvals).
- Confirm the migration transaction in your wallet. Once processed, your liquidity will be moved into a new V3 NFT‑based position.
Security Best Practices
- Only use official SushiSwap links and documentation to avoid phishing risks.
- Limit contract approvals—avoid granting unlimited allowance where possible.
- Use hardware wallets to ensure your private keys remain offline.
- Check that the migration contract is audited and known (cross-check contract addresses with official docs).
- Start migrating small amounts first to test the process before doing large migrations.
Troubleshooting Common Migration Issues
Migration transaction fails or reverts
Ensure you have sufficient native gas token (ETH or other chain token). Try increasing gas price or limit if the network is busy.
Approval issues
Make sure you approved the correct token contract and that the migration interface is the official one. Revoke and re-approve if necessary.
Liquidity doesn’t show in V3
Refresh the interface, reconnect wallet, and check that your position NFT is registered. Sometimes UI may lag behind blockchain state.
Slippage or price range selection problems
Be conservative in range selection initially; choose ranges that cover recent price volatility to avoid your liquidity being out of range.
Conclusion
Migrating from SushiSwap V2 to V3 can yield better capital efficiency and more flexible earning potential, but it’s essential to migrate carefully. By understanding V3 features, preparing your V2 position, selecting safe ranges, and following security best practices, you can minimize risks. Always test with small migrations first and stay informed by checking official SushiSwap documentation. :contentReference[oaicite:5]{index=5}
Frequently Asked Questions (FAQs)
1. Is migration from V2 to V3 mandatory?
No, you can continue using V2 pools, but many liquidity providers migrate to take advantage of V3’s improvements.
2. Do I lose liquidity rewards when migrating?
No, but you should claim all rewards first before removing V2 liquidity to avoid leaving rewards behind.
3. How do I choose the right price range in V3?
Use historical price data and volatility to choose a range that your tokens are likely to stay within. Start with moderately wide ranges.
4. Are migration contracts safe?
Only use the official, audited migration contracts listed in SushiSwap’s documentation. Always confirm contract addresses before interacting.
5. What if the migration fails or reverts?
If a migration fails, your V2 tokens remain. You can retry the migration after checking gas, approvals, and contract correctness.
6. Can I migrate partially (only part of my liquidity)?
Yes, you can migrate a portion of your V2 liquidity to V3 and leave some in V2 if desired.