🌉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.
ZilBridge Incentives
Supported Tokens and Wallets
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.
Supported Tokens
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 |
|
|
Ethereum (ETH) / zETH | Native L1 token |
|
USDT / zUSDT |
|
|
Supported Wallets
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 :)
Using the ZilBridge (Mainnet)
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.
1 | Preparing Your Wallets
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.
2 | Bridging Your Assets
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.
2.1 | Ethereum -> Zilliqa
You may follow this video tutorial to learn how to bridge your assets from Ethereum to the Zilliqa chain.
2.2 | Bridging your assets from Zilliqa -> Ethereum
You may follow this video tutorial to learn how to bridge your assets from Zilliqa to the Ethereum chain.
3 | Acquiring ZIL for gas
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.
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.
4 | Pooling Your Assets
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.
5 | Video Tutorial
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!
FAQs
How much does it cost to bridge my assets over?
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:
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.
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.
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.
What happens if I set my Gas to “Low” and my transaction doesn’t go through?
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.
How long does it take to bridge my assets over and back? Is there a lock up period for bridging my assets?
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.
How do I tell if I have the bridged assets in my wallet?
One way to verify is by simply adding the tokens into your wallet.
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!
Last updated
