Search…
πŸŒ‰
ZilBridge
Connecting Ethereum and Zilliqa chains for all
Developed together by Zilliqa, Switcheo Labs, and PolyNetwork, and powered by Carbon Protocol, ZilBridge enables users to bridge their assets between the Zilliqa and Ethereum Mainnet networks, with more chains to be supported in the future.
In this article, the following topics will be covered:
  • ZilBridge roll-out plan and key milestones;
  • Types of assets supported by the ZilBridge;
  • Bridging incentives and how to earn them; and
  • Steps required to help users bridge their assets between the two chains.

Could not load image
An overview of pool incentives and estimated APRs as well as APYs users can stand to benefit from.

In the initial phase of this launch, a select pool of ERC-20 assets will be supported for users to bridge to Zilliqa Mainnet. More assets will be added to this pool in time to come.

Though more tokens are planned to be supported soon, the ZilBridge will initially support the following ERC-20 tokens:
Token Name
ERC-20 Token Address
ZRC-2 Token Address
Wrapped Bitcoin (WBTC) / zWBTC
0x2260fac5e5542a773aa44fbcfedf7c193bc2c599
zil1wha8mzaxhm22dpm5cav2tepuldnr8kwkvmqtjq
Ethereum (ETH) / zETH
Native L1 token
zil19j33tapjje2xzng7svslnsjjjgge930jx0w09v
USDT / zUSDT
0xdac17f958d2ee523a2206206994597c13d831ec7
zil1sxx29cshups269ahh5qjffyr58mxjv9ft78jqy

Please also ensure you have a Zilliqa wallet and an Ethereum wallet prepared before you begin bridging. These are the wallets we recommend you use for bridging:
Network
Recommended Wallet
Zilliqa
Ethereum
You're now all set to try out the ZilBridge on zilswap.io/bridge!
If you are new to ZilBridge, please take a few minutes to look through the step-by-step guide below before embarking on your bridging journey :)

Please ensure that you have both Zilliqa and Ethereum web3 wallets ready before beginning the bridging process. If you've not previously installed the extensions, please refer to the ​Supported Wallets section.

Ensure that both your wallets are connected to the Mainnet networks:
Your ZilPay wallet that is connected to ZilSwap will be your default receiving Zilliqa wallet shown on the ZilBridge UI.
Could not load image
Metamask for Ethereum chain (left) and ZilPay for Zilliqa chain (right).

During the start of a transfer, a private-transfer-recovery-key.txt file β€” containing a 12-word transfer key phrase β€” will automatically be downloaded to your device. You may use the transfer key to recover your transfer should it be disrupted or paused midway.
Please keep this text file secure and do not ever reveal your transfer key phrase to anyone. ZilSwap will not be held accountable and cannot help you retrieve those funds once they are lost.

You may follow this video tutorial to learn how to bridge your assets from Ethereum to the Zilliqa chain.

You may follow this video tutorial to learn how to bridge your assets from Zilliqa to the Ethereum chain.

Some ZIL will be required to transact on the Zilliqa network after you have bridged your ERC-20 assets. If you do not yet have ZIL, here are some options to acquire it:
Option 1: Transak on ZilSwap Transak allows for easy fiat on-ramp into crypto. On zilswap.io, click on the Buy ZIL button in the menu bar. The Transak purchase widget will appear and you can immediately follow the steps and use your credit card to purchase ZIL with fiat.
Could not load image
Option 2: Through Centralised Exchanges (CEXs)
A list of exchanges where you can purchase ZIL can be found here.
After purchasing ZIL on a centralised exchange, you can proceed to download your ZilPay wallet (refer to table above for the download link) and withdraw your ZIL to your ZilPay wallet. Make sure to ONLY transfer ZRC-2 ZIL.

In the event your transfer fails, you may go to the Transfer History tab or Demex to recover and resume your transfers.

It is important to note which Stage (Stage 1, 2, or 3) your transfer failed at as the recovery steps will vary slightly. Skip to the right section:
Could not load image

You may resume your transfer using the 12-word keyphrase contained within the private-transfer-recovery-key.txt file that was automatically downloaded to your device at the start of the transfer. Simply enter the key phrase under the Resume Transfer feature on the Transfer History tab to begin the recovery process.
Could not load image
Once you have pasted your transfer key, click Verify Transfer Key. Wait for it to be verified before proceeding to link your Destination wallet and resuming your transfer.
Could not load image

In the event your bridging is disrupted or paused midway in Stage 3, you will be able to recover and resume your transfer directly via the Transfer History tab. There you can also keep track of all your past transfers made between networks.
  1. 1.
    Begin by revealing and copying your transfer key (12-word phrase). Please ensure to not reveal your transfer key to anyone, else your transferred funds may be lost.
  2. 2.
    Next click Resume Transfer. A pop up will appear where you will be prompted to paste the transfer key you have previously copied.
  3. 3.
    Once you have pasted your transfer key, click Verify Transfer Key
  4. 4.
    Once your transfer key has been verified, proceed to link your Destination wallet, and resume your transfer.

If the steps in Option A do not work for you, you may head to Demex to retrieve your funds. You must first connect to Demex before withdrawing the funds to your destination wallet.
To connect to Demex:
  1. 1.
    Visit app.dem.exchange/​
  2. 2.
    Click "Connect Wallet"
  3. 3.
    Select the "Encrypted Key" option
  4. 4.
    Click on "Lost Key or Password"
  5. 5.
    Enter the mnemonic words and set a password
  6. 6.
    This will download an "Encrypted Key" file which is protected by the password and you can use to Connect. Do not reveal your password to anyone including admins.
Once you are connected, you can withdraw the funds from Demex to your destination wallet:
  1. 1.
    Click "Your Wallet" (found in top right section)
  2. 2.
    Identify the Asset you wish to withdraw
  3. 3.
    Click "Withdraw"(option found beside the Asset)
  4. 4.
    Select Network (eg. for a Zilliqa asset - Zilliqa via "Token Transfer")
  5. 5.
    Enter your Zil1 address and 100% to transfer.

After bridging over to the Zilliqa mainnet network, you can start to earn yield on your assets when the liquidity mining incentives kick in on 6 October! Remember, you will get bonus $ZIL incentives (on top of Liquidity Mining Incentives) for providing liquidity on ZilSwap. To learn how you can become a liquidity provider, click here.

If you are someone who is visual and would like to learn more about the bridge via a video tutorial, you may check out this handy guide prepared by our community member, Zilliqa Zebra!

The following table is a breakdown of fees to bridge assets back and forth between Ethereum Mainnet and Zilliqa Mainnet. For reference on what the gas is on Ethereum, please head over to ethgasstation.info.
There are two fees you will need to pay when bridging a given asset from a source chain to a destination chain:
  1. 1.
    Source chain fees: You will need to initiate a transaction on the source chain and for this you will be paying the network fees denominated in the native currency of the source chain.
  2. 2.
    Destination chain fees: Unlike on the source chain where you initiate the transaction, on the destination chain, a node called a relayer sends the bridged asset to your wallet. You need to cover the fees that the relayer has to pay on the destination chain for this transaction. This fee is subtracted from the asset being bridged over.
For example, if you are bridging USDT from Ethereum (source) to Zilliqa (destination), you will pay the transaction fee in ETH on the Ethereum chain. And the relayer will pay the fees on your behalf to send you zUSDT on the Zilliqa chain. To cover the cost of this transaction, the relayer will deduct the fees from the asset being transferred, i.e., USDT. So, if you are sending 100 USDT, you will receive (100 - the relayer fees) zUSDT.
Bridging Direction
Source Chain
Destination
Chain
Fee on Source Chain*
Fee on Destination Chain*
Total Fee*
Ethereum >> Zilliqa
Ethereum
Zilliqa
Approx. $16
~$0.30 charged by the relayer on the bridged asset
$16–17
Zilliqa >> Ethereum
Zilliqa
Ethereum
Approx. $0.80
~$44 charged by the relayer on the bridged asset
$44–$45
* Please note fees quoted in the table above are estimates. Actual costs will depend on (1) congestion on either or both source and destination chains, as well as the (2) price of the native currency where gas is being charged. At the point of writing this guide, the Ethereum price is assumed to be around $2,900 and gas price to be between 50 to 60 gwei.
For first-time ZilBridge users, you will have to allow the bridge contracts to spend tokens on your behalf. Users will be required to send a transaction to approve spending of tokens on the source chain. On Ethereum, this is approximately $12 (depending on the network congestion) and is approximately $0.07 on the Zilliqa chain.
Could not load image
When moving assets over from Zilliqa to Ethereum, do remember to check the estimated cost of transacting just in case of network congestion over at Ethereum mainnet.

When your transaction doesn’t go through due to a sudden spike in gas over on Ethereum mainnet, it is advisable that you either (i) wait for gas to lower or (ii) increase the gas limit on your Metamask. For a tutorial on how to change gas limits and gas fees, please refer to this article here.

Bridging from Ethereum mainnet to Zilliqa mainnet will take around 8 to 9 minutes (with average gas). Bridging the other direction β€” Zilliqa mainnet to Ethereum mainnet β€” will take around 3 to 4 minutes. There is no lock up period on your assets when bridging either way.

One way to verify is by simply adding the tokens into your wallet.
Could not load image
Click on the β€œTokens'' tab on your ZilPay wallet and click on the β€œ+” button. Paste in the token contract address (refer to the token addresses listed under the Supported Tokens section). The token will automatically be detected and ready for you to add!
Copy link
On this page
ZilBridge Incentives
Supported Tokens and Wallets
Supported Tokens
Supported Wallets
Using the ZilBridge (Mainnet)
1 | Preparing Your Wallets
2 | Bridging Your Assets
3 | Acquiring ZIL for gas
4 | Recovering Failed Transfers
5 | Pooling Your Assets
6 | Video Tutorial
FAQs
How much does it cost to bridge my assets over?
What happens if I set my Gas to β€œLow” and my transaction doesn’t go through?
How long does it take to bridge my assets over and back? Is there a lock up period for bridging my assets?
How do I tell if I have the bridged assets in my wallet?