User Guide: Bridging Curve Ecosystem Tokens

Curve uses LayerZero to enable cross-chain transfers of CRV, crvUSD, and scrvUSD to other L1 blockchains such as BinanceSmartChain, Avalanche, and Fantom. This allows users to use any LayerZero-compatible bridge, such as Stargate, which many find simpler and more convenient. However, this guide focuses on bridging using only blockchain explorers, reducing reliance on third-party interfaces and avoiding any additional fees they may charge.

This guide explains how to bridge any of the three tokens from the Ethereum Mainnet to other L1 blockchains or vice versa. The only requirements include having a wallet with the token to be bridged and ETH or the gas token of the L1, depending on the bridging direction, to cover transaction fees.

Bridging tokens from Ethereum to an L1 blockchain¶

Step 1: Approve the Bridge Contract to Spend Your Tokens¶

1. Navigate to the contract of the token you want to bridge on Etherscan.

2. Connect your wallet by navigating to Contract > Write Contract and clicking the Connect to Web3 option.

   

3. Look for the approve method and approve the according bridge contract as a spender.

   

   • _spender: Enter 0x0A92Fd5271dB1C41564BD01ef6b1a75fC1db4d4f, the bridge contract address. This address is the same for all tokens.
   • _value: Specify the amount in 1e18 format (for example, for 100 crvUSD, enter 100000000000000000000).

   Again, to avoid manually entering the amount in 1e18 format, you can input the amount of tokens you wish to bridge and then append 18 zeros by using the + button.

   

4. Click Write. A transaction should pop up in your wallet which you need to sign to complete the approval.

Step 2: Read Contract and Quote ETH Amount¶

1. Visit the bridge contract on Etherscan. This contract address is different depending on the token to be bridged and where it is being bridged to. This time, there is no need to connect your wallet.

2. Use function 1. quote to determine the bridging cost.

   

   The quote amount represents the cost (in ETH) of calling the bridge method in the next step. This does not include gas costs, which need to be paid on top of the quoted amount.

Step 3: Bridge the token to the L1 blockchain¶

1. Access the bridge contract on Etherscan. This contract address is different depending on the token to be bridged and where it is being bridged to.

2. Connect your wallet by navigating to Contract > Write Contract and clicking the Connect to Web3 option.

   

3. Navigate to method 2. bridge and input your values. On this contract, there might be multiple methods with the same name. Make sure to select the one which looks like the one in the image down below (it should have three input parameters: bridge, _amount and _receiver).

   

   • bridge: Enter the ETH amount quoted in Step 2. Ensure you enter the amount denominated in Ether (quoted amount / 1e18).
   • _amount: Specify the amount of tokens to bridge in 1e18 format.
   • _receiver: Enter the wallet you wish to receive the tokens to.

   Alternatively, to avoid manually entering the amount in 1e18 format, you can input the amount of tokens you wish to bridge and then append 18 zeros by using the + button.

   

4. Click Write. A transaction should pop up in your wallet which you need to sign to complete the bridging process.

Bridging tokens from an L1 blockchain to Ethereum¶

Step 1: Approve the Bridge Contract to Spend Your Tokens¶

1. Navigate to the token contract on the block explorer for the L1 network you want to bridge from. For example, to bridge crvUSD from BSC to Ethereum, you would need to navigate to the crvUSD token contract on BSCScan. All token addresses are listed in the table at the top of the page.

2. Connect your wallet by navigating to Contract > Write Contract and clicking the Connect to Web3 option.

   

3. Look for the approve method and approve the according bridge contract as a spender.

   

   • _spender: Enter the contract address of the bridge on the L1 blockchain.
   • _value: Specify the amount in 1e18 format (for example, for 100 crvUSD, enter 100000000000000000000).

   Alternatively, to avoid manually entering the amount in 1e18 format, you can input the amount of tokens you wish to bridge and then append 18 zeros by using the + button.

   

4. Click Write. A transaction should pop up in your wallet which you need to sign to complete the approval.

Step 2: Read Contract and Quote the Fee Amount¶

1. Visit the bridge contract on the L1 blockchain you want to bridge from.

2. Use function 1. quote to determine the bridging cost.

   

   The quote amount represents the cost (in the gas token of the L1 blockchain) of calling the bridge method in Step 3. This does not include gas costs, which need to be paid additionally.

Step 3: Bridge Tokens to Ethereum¶

1. Access the bridge contract on the L1 blockchain you want to bridge from.

2. Connect your wallet by navigating to Contract > Write Contract and clicking the Connect to Web3 option.

   

3. Navigate to method 2. bridge and input your values. On this contract, there might be multiple methods with the same name. Make sure to select the one which looks like the one in the image down below (it should have three input parameters: bridge, _amount and _receiver).

   

   • bridge: Enter the ETH amount quoted in Step 2. Ensure you enter the amount denominated in Ether (quoted amount / 1e18).
   • _amount: Specify the amount of tokens in 1e18 format.
   • _receiver: Enter the wallet you wish to receive the tokens to.

   Alternatively, to avoid manually entering the amount in 1e18 format, you can input the amount of tokens you wish to bridge and then append 18 zeros by using the + button.

   

4. Click Write. A transaction should pop up in your wallet which you need to sign to complete the bridging process.