Migration of PancakeSwap liquidity from v1 to v2
Our decentralized services support migration of your liquidity. Audited by Certik.
The liquidity locked using UNCX under PancakeSwap v1 can be migrated to v2.
Warnings
FOR ALL THE TOKENS WITH FEES ON TRANSFER, IT IS STRONGLY RECOMMENDED (e.g. SafeMoon) to whitelist the migration contract to get as many tokens as possible in the new liquidity pool (the PancakeSwap v2 one).
The migration tool will undo the LP and recreate it, hence you may be taxed twice by your own token's logic if you skip this step.
The migration contract is available here.
"Whitelist" above may include, but is not limited to: "ExcludeFromRewards" and "ExcludeFromFee".
Ensure as well that you whitelist our contract if you have a "Max Transfer Amount" or any similar functionalities. Not doing so will simply force you to proceed with multiple "Migrate" operations, each creating a new lock in v1.
Prerequisites
Your wallet is connected to BSC
You are the owner of the v1 lock you wish to migrate
You have checked if you do have a pool or not in v2 with the same pair
If you don't, proceed to next section ("There is no v2 pool yet, or it's empty")
If you do, proceed to the section "There is a v2 pool already"
How to migrate my locked v1 LP?
There is no v2 pool yet, or it's empty
Go to our UI and select "PancakeSwapv1"
Connect the wallet which locked the liquidity on v1
Look for your locked pair and select it
Select "Migrate / Withdraw Liquidity"
Once the pair is found, click the the gear icon next to the pair and select "Migrate"
Connect your wallet and enter the contract address of your pair
Once the pair is found, click the the gear icon next to the pair and select "Migrate"
Check that there is no pair in PancakeSwap v2 and that the slippage/price difference is 0% Below is an example of how it looks when there is a PancakeSwap v2 pool, which should not be showing if there is no pool yet:
Ensure you have taken necessary actions as per warning at the top of this page
Click "Migrate" when you are ready
There is a v2 pool already
Prerequisites: In order to migrate your pool from v1 to v2, you need to ensure that the price difference between v1 and v2 pool is within a 5% range. This is to migrate as much as possible the totality (or at least 95%) of your LP tokens to the v2 pool, and it needs to have a similar BNB/YourToken ratio. In many cases, arbitrage brings an equilibrium in the price between pools.
You can connect to the UI, select your pair, and click the gear icon, then "Migrate" to see what is the current price difference between the pools. (check previous section)
If you are not within the 5% price difference, you will need to proceed with the required buying and selling, or arbitrage, until you are within the expected range.
If the ratio/price between v1 and v2 pools falls outside the 5% range during the migration, it will fail and revert.
Once you have a similar BNB/YourToken ratio in both pool (no more than 5% difference), you can proceed with the migration as per previous section (check our warning at the top of this page before proceeding further).
Once the migration is completed, you may have some tokens left in the v1 pool, which will be no more than 5% of the original LP amount and will be sent to your wallet.
Known issues
Issue | Workaround |
The migration fails |
|
The migration tool doesn't allow me to transfer all of the LP tokens | You may have a "max transfer amount" in your token's smart contract. Whitelist our contract or simply create multiple locks. See warning at the top of this page for more information. |
I want to split the v1 lock to few/several new locks on v2 | You can migrate a portion of your LP to v2 as many times as you wish, each time it will create a new lock on v2. The unlock date and ownership will remain unchanged; however if you are the owner, you can transfer the ownership to someone else on some of the new v2 locks you have created. |
Last updated
