Bridging between ERC20-BLZ and L1-BLZ

Disclaimer

Bluzelle is providing these instructions as a convenience for the public and is not responsible for inaccuracies, errors, omissions, etc. The user is solely responsible for the results of using this information.

Prerequisites

ETH Wallet

This is where the ERC20-BLZ tokens will live, for either converting to L1-BLZ, or where you will receive the ERC20-BLZ, when converting from L1-BLZ.

A typical example of this is Metamask, but there are others. You can have your ETH wallet attached to a hardware wallet like Ledger, if preferred. Install whichever extension you prefer for your wallet, to your browser, if applicable.

You will be expected, as part of these instructions, to use this wallet address to send tokens or to receive tokens into it.

Cosmos Wallet

This is where the L1-BLZ tokens will live, for either converting to ERC20-BLZ, or where you will receive the L1-BLZ, when converting from ERC20-BLZ.

A typical example of this is Keplr, but there are others. You can have your Cosmos wallet attached to a hardware wallet like Ledger, if preferred. Install whichever extension you prefer for your wallet, to your browser, if applicable.

You will be expected, as part of these instructions, to use this wallet address to send tokens or to receive tokens into it.

Ensure you have familiarity with your Cosmos wallet and that it has access to your Osmosis wallet address AND your Bluzelle wallet address. In Keplr, you can select the network, and see your Osmosis or Bluzelle address. With Keplr, if Bluzelle is not in your list of networks, select “Add Suggest Chains” in the network selector to goto https://chains.keplr.app/ where you can add Bluzelle.

Bridge Instructions

Going from ERC20-BLZ to L1-BLZ

  1. Using your ETH wallet, convert ERC20-BLZ to USDC via Uniswap (or any other exchange like Binance, etc). You can skip to the next step, if you already have USDC.

  2. Goto https://satellite.money/?source=ethereum&destination=osmosis&asset_denom=uusdc and do the following:

    1. Please be sure to look at the gas fees and other fees to ensure you are ok with these. It was about 80 USDC in fees when we wrote these instructions.

    2. Connect BOTH your ETH and Cosmos wallets. Click on the connect button and connect the ETH wallet, selecting Metamask (or whichever else). Do the same for Cosmos, clicking the connect button and connecting the Cosmos wallet, selecting Keplr (or whichever else).

    3. Accept any popups and permission requests from your wallet extensions. Typically, some wallets will popup a permission to allow a web app to use that wallet.

    4. Enter in the amount of USDC you converted from ERC20-BLZ into the first box for USDC. You can auto-fill the box with the MAX button if you want.

    5. In your Cosmos wallet, select the Osmosis network.

    6. Click the button to fill in your destination address from your Cosmos wallet, or alternatively, paste it in (be careful this is correct and matches your Cosmos wallet extension’s Osmosis address, or you lose all your funds!).

    7. Click the button to generate the deposit address.

    8. Wait a few moments and an ETH address will be given to you. Copy it if you want, but it will be available once you dismiss the popup.

    9. Send the amount of USDC you specified to that given ETH address. Alternatively and PREFERABLY, click the “Send from Metamask” (if you are using Metamask) button to automatically ask your ETH wallet to send the USDC to that address.

    10. In your ETH wallet extension, confirm the ETH address (the one generated by satellite.money) and amount being sent to are correct, and send the transfer.

    11. Wait and watch the satellite.money screen until the required number of blocks have elapsed. This can take upwards of 20 minutes. Note that this screen only typically updates if you clicked on the “Send from…” button to send the USDC. Otherwise, you just have to wait and look for the USDC on the Cosmos side (in your Cosmos wallet), after sufficient time.

    12. Once satellite.money confirms the transfer is complete, goto your Cosmos wallet, and verify you have the USDC in your Osmosis wallet (minus any fees).

  3. Goto https://frontier.osmosis.zone/?from=USDC&to=BLZ and convert your USDC to BLZ. This is your new L1-BLZ.

  4. Once you have your L1-BLZ, use the IBC transfer function in your Cosmos wallet to transfer your L1-BLZ to your Bluzelle address. Be certain you have used the correct Bluzelle address as the destination address, that you found in your Cosmos wallet, when the Bluzelle network is selected. Alternatively, follow this method on Frontier-Osmosis if you are not familiar with the IBC function on your Cosmos wallet:

    1. Go to the assets page on Osmosis Frontier (the left side menu)

    2. Look for "BLZ" on the list (you should have a balance)

    3. Click "withdraw"

    4. If you don't have the Bluzelle chain added to your wallet (Keplr or Cosmostation), a pop up will ask you if you want to approve adding the Bluzelle chain to your wallet. Click Approve

    5. It will show an animation of “Osmosis transferring to your Bluzelle address” (the transfer has not happened yet, of course). Be absolutely sure that it’s the same Bluzelle address as what is in your wallet (Keplr or Cosmostation or etc...)

    6. Enter the amount you want to transfer to your Bluzelle address

    7. Click withdraw BLZ

    8. Approve the transfer in your wallet

  5. Wait a few minutes and confirm that your L1-BLZ is in your Bluzelle wallet on your Cosmos wallet.

Going from L1-BLZ to ERC20-BLZ

  1. Using your Cosmos wallet, use the IBC transfer function to transfer your L1-BLZ to your Osmosis address. Be certain you have used the correct Osmosis address as the destination address, that you found in your Cosmos wallet, when the Osmosis network is selected. Alternatively, follow this method on Frontier-Osmosis if you are not familiar with the IBC function on your Cosmos wallet:

    1. Go to the assets page on Osmosis Frontier (the left side menu)

    2. Look for "BLZ" on the list

    3. Click "deposit"

    4. If you don't have the Bluzelle chain added to your wallet (Keplr or Cosmostation), a pop up will ask you if you want to approve adding the Bluzelle chain to your wallet. Click Approve

    5. It will show an animation of “Bluzelle transferring to your Osmosis address” (the transfer has not happened yet, of course). Be absolutely sure that it’s the same Osmosis address as what is in your wallet (Keplr or Cosmostation or etc...)

    6. Enter the amount you want to transfer to your Osmosis address

    7. Click withdraw BLZ

    8. Approve the transfer in your wallet

  2. Wait a few minutes and confirm that your L1-BLZ is in your Osmosis wallet on your Cosmos wallet.

  3. Goto https://frontier.osmosis.zone/?from=BLZ&to=USDC and convert your L1-BLZ to USDC.

  4. Goto https://satellite.money/?source=osmosis&destination=ethereum&asset_denom=uusdc&destination_address= and do the following:

    1. Please be sure to look at the gas fees and other fees to ensure you are ok with these. It was about 80 USDC in fees when we wrote these instructions.

    2. Connect BOTH your ETH and Cosmos wallets. Click on the connect button and connect the ETH wallet, selecting Metamask (or whichever else). Do the same for Cosmos, clicking the connect button and connecting the Cosmos wallet, selecting Keplr (or whichever else).

    3. Accept any popups and permission requests from your wallet extensions. Typically, some wallets will popup a permission to allow a web app to use that wallet.

    4. In your Cosmos wallet, ensure you have selected the Osmosis network.

    5. Enter in the amount of USDC you converted from L1-BLZ into the first box for USDC. You can auto-fill the box with the MAX button if you want.

    6. Click the button to fill in your destination address from your ETH wallet, or alternatively, paste it in (be careful this is correct and matches your ETH wallet extension’s address, or you lose all your funds!).

    7. Click the button to generate the deposit address.

    8. Wait a few moments and an Axelar address may be given to you. Copy it if you want, but it will be available once you dismiss the popup (which may only be a confirmation).

    9. Send the amount of USDC you specified to that given Axelar address as an IBC Transfer in your Cosmos wallet. Alternatively and PREFERABLY, click the “Send from Keplr” (if you are using Keplr) button to automatically ask your Cosmos wallet to send the USDC to that address. This will be an IBC transfer, as an FYI.

    10. In your Cosmos wallet extension, confirm the Axelar address (the one generated by satellite.money) and amount being sent to are correct, and send the transfer.

    11. Wait and watch the satellite.money screen until the required number of blocks have elapsed. Note that this screen only typically updates if you clicked on the “Send from…” button to send the USDC. Otherwise, you just have to wait and look for the USDC on the ETH side (in your ETH wallet), after sufficient time.

    12. Once satellite.money confirms the transfer is complete, goto your ETH wallet, and verify you have the USDC in your wallet (minus any fees).

  5. Using your ETH wallet, convert USDC to ERC20-BLZ via Uniswap (or any other exchange like Binance, etc)..

PreviousJavaNextCreate a Bluzelle Wallet

Last updated