🚚Migrate from Shell v1 (Retired)

How to migrate your liquidity from Shell v1

Quick Links

• Use the retired Shell v1 interface here: (Regular, Deactivated)

• Learn more about Shell v1

Contents

• Introduction

• Step 1: Connect to Shell v1

• Step 2: Bridge funds to Arbitrum

• Step 3: Connect to the Shell app

Introduction

After nearly two years of active life, Shell v1 has transitioned into a graceful retirement.

The Shell team has no immediate plans to disable access to Shell v1 or its app interface. After all, nothing ever really disappears on the blockchain. However, the time has definitely come for LPs in Shell v1 to withdraw their funds and transition to the next iteration of Shell Protocol. A simple guide below explains how to get this done.

Step 1: Connect to Shell v1

First, visit the Shell v1 app and connect either your MetaMask or WalletConnect wallet. (Tip: the second iteration of Shell Protocol currently only supports Metamask.) If you have funds stored in the deactivated version of the Shell v1 pools, you may need to visit the deactivated Shell v1 app to retrieve them. On either app, the withdrawal process is the same.

Once you connect your wallet, you will be able to see your balances for each active pool in the ‘Your Balance’ column marked orange in the screenshot above. If both of these pools show zero balance, you do not have any funds deposited in Shell v1 via your currently-connected wallet.

To withdraw funds from a pool, click that pool to go to the pool details screen. Here, you will see a gray ‘Withdraw’ button at the bottom. Click that.

On the next screen, you will have the option to either ‘Withdraw Everything’ proportionally or specify which tokens you would like to withdraw to. For the stablecoin pool, if you withdraw everything proportionally, you will receive roughly 30% DAI, 30% USDC, 30% USDT and 10% SUSD. Please note that the Shell team has no present plans to support SUSD in the updated Shell Protocol at any time, so funds withdrawn as SUSD will not be able to wrap into Shell v2.

If you do not want to receive part of your withdrawal in SUSD (or any other particular token), you can instead type values for each withdrawal token in the fields above. The app will warn you when the sum of the tokens you have typed exceeds your current balance.

Depending on which tokens you are withdrawing to, you may see a slight additional gain or loss of value in your pending withdrawal. This mechanic gives you additional funds if your withdrawal brings the pool closer to its balanced state, and subtracts some funds if your withdrawal brings the pool further from its balanced state. A ‘Withdraw Everything’ withdrawal will do neither.

Once you have found a balance of tokens that you are satisfied with, click ‘Withdraw.’ You will be charged a small amount of gas on mainnet for the transaction, and the stablecoins will be transferred to your wallet.

For the wrapped BTC pool, withdrawal works identically, save for the fact that you can withdraw to any combination of WBTC, renBTC, and sBTC (instead of stablecoins). Tip: WBTC can be wrapped into the updated Shell Protocol.

Step 2: Bridge funds to Arbitrum

Now that you have withdrawn your funds from Shell v1, we can move them over to Arbitrum One just like any other tokens. We do this by visiting the Arbitrum bridge.

Check out the Arbitrum bridge tutorial or jump straight to the Arbitrum bridge here. Make sure you select Arbitrum One as the network, not Arbitrum Nova.

In the Arbitrum bridge, select Mainnet as your source and Arbitrum One as your destination. Then select whichever token type you’d like to bridge first. You will need to pay a small gas fee (and potential authorization fee) for each token type you bridge. The actual bridging process will take roughly ten minutes from the time it is initiated.

You do not have to wait for one token type to finish bridging before you start the next one.

Once bridging is completed, success banners will appear for your bridged tokens on the Arbitrum bridge site. Now we can head over to the Shell app and deposit our funds.

Step 3: Connect to the Shell app

In the new Shell app, you can either wrap or LP to move your funds into Shell Protocol. Either way, during the guarded launch you will begin earning Shell Points (up to your quota limit).

The option to LP will appear in the trade screen just like any other token. In the Shell app, you LP into pools by ‘swapping’ from any supported token to the LP token of your choice.

First, select ‘shLP’ as the ‘Swap To’ token in the trade screen. Then click ‘Select LP token’ and choose your desired token from the list. Each LP token corresponds with a different pool. The names of the tokens indicate what component tokens they have exposure to.

Lastly, complete the swap for your desired LP token just like any other swap to transfer your liquidity into that pool.