Skip to main content

ShimmerBridge User Guide

Introduction​

ShimmerBridge is a web application provided by the Tangle DAO LLC, that allows you to transfer wrapped tokens between ShimmerEVM and several other blockchain networks by interacting with the decentralized smart contracts of LayerZero deployed on each of those networks. ShimmerBridge supports connections from ShimmerEVM to Ethereum, Avalanche C-Chain, Polygon, Arbitrum One, Optimism, Base, Fantom, and Binance Smart Chain. You can transfer several wrapped tokens, including ETH, USDT, USDC, WBTC, AVAX, MATIC, FTM, and BNB.

This guide explains how to bridge tokens with ShimmerBridge, including selecting the source chain, choosing the token to transfer, entering the number of tokens and transferring the tokens. It also covers troubleshooting issues that may arise during the transfer process.

The token addresses on each network are listed at the end of this guide for your reference.

Bridge Assets with ShimmerBridge​

1. Accept the Terms and Conditions​

Go to https://shimmerbridge.org/terms and read the terms and conditions carefully before using ShimmerBridge. Once you understand the terms and conditions, enter the ShimmerBridge User Interface and connect your Web3 Wallet.

Layer Zero UI1

2. Select the Source Chain​

You should select the source chain from which you want to bridge a token into Shimmer EVM. To send tokens out of Shimmer EVM, select Shimmer EVM as the source chain.

3. Select the Token to Transfer​

Click "Select Token" to choose a token to transfer from the source chain. The Interface will display all bridgeable tokens and your token balance in the selection dropdown. Also, all other bridgeable tokens you hold in one of the other available networks are displayed.

4. Enter the Number of Tokens You Want to Bridge From the Source Chain​

  • The app will display:
    • The amount of bridged tokens you will receive on the destination chain.
    • The necessary fees for the token transfer in the native gas token of the source chain. Ensure you have enough gas tokens on the source chain to pay the fees.
Gas on Destination

Using Shimmer EVM will require you to own Shimmer Tokens ($SMR) to pay for gas fees. You can arrange an airdrop of a maximum of 1 SMR token to your address as part of your Bridge transfer. This will be added to the total fees you pay for the transfer and enable you to have the necessary amount of gas in Shimmer EVM to start your journey and interact with the first dApps. Click the highlighted "add" next to "Gas on destination". A popup will open that lets you define how many SMR tokens you want to receive. Either use the "Max - setting", which gives you 1 SMR, or specify a custom amount of up to 1 SMR.

5. Transfer the Tokens​

  • Click "Transfer". Your wallet will ask you to approve the token spending and confirm the transaction
  • After your confirmation, a popup will occur; if you click on the link, you will be forwarded to LayerZero Scan to observe the detailed progress of your bridge interaction.
  • The ShimmerBridge app will also display the progress of your transaction, including an estimated period till the bridging is completed in the "transactions" box that appears after confirmation.
  • Once the status changes to "completed", your tokens have arrived in your wallet.
  • Please make sure you have imported the correct token into your wallet on the destination chain to see it.

Troubleshooting​

Conditions that will hinder your transfer will be indicated in the "Action button" as follows:

Insufficient Balance​

  • You entered a higher amount of tokens than you hold in your account.
    • Reduce the amount you want to transfer or add more tokens to your wallet.

Not Enough Native for Gas​

  • You must own more gas on the source chain to pay the required fees.
    • You need to send more of the source chain's native gas token to your wallet to resolve this.

Select Different Chain​

  • You have selected an incompatible selection of source and destination chain. It is only possible to bridge in and out of Shimmer EVM with ShimmerBridge; you cannot send from ETH to Avalanche, for example.
    • Send either tokens into Shimmer EVM or send them from Shimmer EVM out to another chain.

Limit Exceeded​

  • This can occur for bridgeable tokens that exist on several networks (ETH/WETH, USDT and USDC).
  • These tokens can enter Shimmer EVM from different source chains but are represented as one token on Shimmer EVM. If you aim to send these tokens out of Shimmer EVM, the LayerZero contracts on each chain can only payout the amount of these tokens that are currently locked in the contract, so you cannot send more assets back than currently are available to release. This would otherwise exceed the limits of that contract.

Example​

  • On Ethereum, 100 USDT are locked in the Bridge contract (from users that did send this USDT from ETH to Shimmer EVM)
  • On Avalanche, also 100 USDT are locked in the Bridge contract (from users that did send this USDT from Avalanche to Shimmer EVM)
  • You hold 150 USDT in your Wallet on Shimmer EVM
  • If you try to send this 150 USDT to Avalanche, it will exceed the amount currently locked in the Avalanche USDT Bridge contract; therefore, you can't execute such a transfer.
  • Reduce the amount you attempt to send until it is below the Limit.

For any further support, please visit the LayerZero Discord.

If you have general questions about Shimmernet or the Shimmer Token, we welcome you to join the IOTA/Shimmer Discord Community.

Tools:​

ShimmerBridge Token Addresses​

LayerZero ShimmerBridge Wrapped Tokens on Shimmer Evm​

Token Addresses
0xa4f8C7C1018b9dD3be5835bF00f335D9910aF6Bd
0xeCE555d37C37D55a6341b80cF35ef3BC57401d1A
0x4638C9fb4eFFe36C49d8931BB713126063BF38f9
  • WBTC - Wrapped Bitcoin
0xb0119035d08CB5f467F9ed8Eae4E5f9626Aa7402
0xE6373A7Bb9B5a3e71D1761a6Cb4992AD8537Bf28
0xEAf8553fD72417C994525178fC917882d5AEc725
0x8C96Dd1A8B1952Ce6F3a582170bb173eD591D40D
  • BNB - Binance Coin
0x2A6F394085B8E33fbD9dcFc776BCE4ed95F1900D

LayerZero ShimmerBridge Wrapped Tokens on Connected Networks​

Ethereum​

Token Addresses
  • USDC - USD Coin
0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48
  • USDT - Tether USD
0xdAC17F958D2ee523a2206206994597C13D831ec7
  • WBTC - Wrapped Bitcoin
0x2260FAC5E5542a773Aa44fBCfeDf7C193bc2C599

Arbitrum​

Token Addresses
  • USDC - USD Coin
0xaf88d065e77c8cC2239327C5EDb3A432268e5831
  • USDT - Tether USD
0xFd086bC7CD5C481DCC9C85ebE478A1C0b69FCbb9
  • WBTC - Wrapped Bitcoin
0x2f2a2543B76A4166549F7aaB2e75Bef0aefC5B0f
  • WETH - Wrapped Ether
0x82af49447d8a07e3bd95bd0d56f35241523fbab1

Polygon​

Token Addresses
  • USDC - USD Coin
0x3c499c542cEF5E3811e1192ce70d8cC03d5c3359
  • USDT - Tether USD
0xc2132D05D31c914a87C6611C10748AEb04B58e8F
  • WBTC - Wrapped Bitcoin
0x1BFD67037B42Cf73acF2047067bd4F2C47D9BfD6
  • WETH - Wrapped Ether
0x7ceB23fD6bC0adD59E62ac25578270cFf1b9f619

Optimism​

Token Addresses
  • USDC - USD Coin
0x0b2C639c533813f4Aa9D7837CAf62653d097Ff85
  • USDT - Tether USD
0x94b008aA00579c1307B0EF2c499aD98a8ce58e58
  • WBTC - Wrapped Bitcoin
0x68f180fcCe6836688e9084f035309E29Bf0A2095
  • WETH - Wrapped Ether
0x4200000000000000000000000000000000000006

Binance Smart Chain​

Token Addresses

  • BNB - Binance Coin Native Gas Token

  • USDC - USD Coin

0x8ac76a51cc950d9822d68b83fe1ad97b32cd580d
  • USDT - Tether USD
0x55d398326f99059fF775485246999027B3197955

Base​

Token Addresses
  • USDC - USD Coin
0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913
  • WETH - Wrapped Ether
0x4200000000000000000000000000000000000006

Fantom​

Token Addresses

  • FTM - Fantom Native Gas Token

  • USDC - LayerZero USD Coin

0x28a92dde19D9989F39A49905d7C9C2FAc7799bDf

Avalanche​

Token Addresses

  • AVAX - Avalanche Native Gas Token

  • USDC - USD Coin

0xB97EF9Ef8734C71904D8002F8b6Bc66Dd9c48a6E
  • USDT - Tether USD
0x9702230A8Ea53601f5cD2dc00fDBc13d4dF4A8c7

More Information about the LayerZero protocol is available in their official documentation

To review the Open Source code of the ShimmerBridge Web Application, visit the Zokyo Security Github

The Penetration Test Report of the ShimmerBridge Web Application is available at Zokyo Security Pentest Results

The Audit Reports of the LayerZero protocol are available in this LayerZero GitHub Repository