Taraxa Project
WebsiteExplorerCommunity Site
  • 👋Welcome!
  • 💵Wallet
    • Metamask
    • Ledger
    • Taraxa's Network Connection Details
  • 🌱Become a Validator
    • ⚙️Set up validator node
    • 🖥️Consensus node hardware requirements
    • 🚩Register node via community site
    • ⛓️Register node directly on-chain
    • 📣Solicit delegation
    • 🛠️Node upgrade & reset
  • 💰Staking
    • 💧Liquid Staking
    • 🚩Staking via community site
    • ⛓️Staking directly on-chain
  • 🌉Ficus Root Bridge
    • ↔️Bridge usage guide
    • 📜On-chain contracts
    • 🔎Audit Report
  • 💥Taraxa Grant Program
  • Develop on Taraxa
    • 🚀Start building on Taraxa!
    • 🔗Connecting to Taraxa
    • 📓Smart Contracts
      • Remix
    • ⚒️Common frameworks & Examples
    • 💧Testnet faucet
    • 🔩Taraxa RPC Specs
  • Node Operations
    • ⚙️Deploy A Node
      • Digital Ocean
      • AWS
      • Alibaba Cloud
      • Scaleway
      • Vultr
      • Linode
      • Azure
      • Hetzner
      • GitHub is blocked
    • 🪶Lite Consensus Node (beta)
    • ⏺️Upgrade a Node
      • ⬆️Upgrade Node
      • 🔁Reset Node
    • 🔀Syncing From Snapshot
    • 📬Node's Public Address
    • 🗝️Node's VRF Key
    • 📒Node Proof of Ownership
    • ❓Node Operations FAQ
    • 🔢Node Release Notes
    • ⚙️Install A Local Node
      • Windows
      • Mac
      • Linux
      • Digital Ocean
      • AWS
      • Alibaba Cloud
      • Scaleway
      • Vultr
      • Linode
      • Azure
      • Hetzner
      • GitHub is blocked
  • FAQ
    • 1️Layer-1 Tech
    • 🪙TARA Token
    • 🌱Mainnet
    • 🔁Exchange Integration
  • Whitepaper
    • Abstract
    • Intro: Scaling the World
    • Taraxa Architecture
    • Economic Model
    • Governance
    • Further Reading
  • NATIVE TOKEN CONVERSION
    • 💡Introduction
    • 🗓️Conversion Status
    • ❓Conversion FAQ
    • ⚗️Mock Conversion
    • 📋Exchange Submission
  • Governance
    • ℹ️Introduction
    • ⚡Voting Guide
Powered by GitBook
On this page
  • 1. Select your source and destination
  • 2. Connect your wallet
  • 3. Start the bridging transfer
  • 4. Asset selection
  • 5. Enter amount to bridge
  • 6. Note the bridging fees
  • 7. Start bridging
  • 8. Bridging summary and transaction delay
  • 9. Confirm the transaction
  • 10. Confirming your transaction in explorers & wallet

Was this helpful?

  1. Ficus Root Bridge

Bridge usage guide

A step-by-step guide on how to use Taraxa's Ficus Root Bridge.

PreviousFicus Root BridgeNextOn-chain contracts

Last updated 7 months ago

Was this helpful?

The is live! Here's a guide on how to use it. In this step by step guide we use an example bridging from Taraxa to Ethereum. Bridging from Ethereum to Taraxa follow the exact same steps, just with the source and destination networks reversed.

1. Select your source and destination

Go the , pick your your source and destination networks. In the screenshot below, we're bridging from the Taraxa network into the Ethereum network.

2. Connect your wallet

2.1 Click on Connect Wallet

Once you selected your source & destination networks, you should connect your wallet. Click on the "Connect Wallet" button and the web3 plugin (e.g., Metamask) should pop-up.

Make sure that your wallet is connected to the source network. In this example, we're bridging from Taraxa to Ethereum, so the Metamask plugin should be connected to the Taraxa mainnet.

2.2 Pick the wallet address you want to connect

Once the wallet is open, select which address you want to connect to from the list of addresses.

2.3 Give permission to connect

2.4 Confirm that your wallet is connected

Once connected, you should see your wallet address show up on the upper-right corner. Please confirm that this is indeed the right wallet address you want to use.

3. Start the bridging transfer

Click on "Begin new transfer" to start bridging from the connected wallet.

4. Asset selection

4.1 Select the asset you want to bridge over

In the dropdown menu, select the asset you want to bridge over. Please make sure that you have the selected assets in your wallet.

4.2 Confirm asset balance

Once the asset is selected, you can see the asset's balance in your connected wallet at the bottom-right corner of the UI, make sure that number matches with what you think is in the wallet. You can also see there there's a bridging fee.

5. Enter amount to bridge

Having selected the assets you wish to bridge, now enter the amount you want to bridge over. Make sure you leave enough to cover the bridging fees.

In this example we've selected to bridge over 200 TARA from the Taraxa network to the Ethereum network.

6. Note the bridging fees

The bridging fee goes to cover the cost of transferring and verifying on-chain state proofs that make the bridge possible. Since gas costs on Ethereum are so high, these state proofs tend to cost quite a bit of gas. The Taraxa dev team will continue to work on optimizations to try to bring down this cost.

7. Start bridging

Click the Continue button to start bridging.

8. Bridging summary and transaction delay

Once you start bridging, a summary will appear with all the details of the bridging transaction. You can confirm,

  • Source & destination network

  • Asset

  • Amount

  • Bridging delay

As of this writing, it takes ~4 hours to bridge from Taraxa to Ethereum, and ~18 minutes to bridge from Ethereum to Taraxa.

The reason there's a delay is due to the fact that we need to give sufficient time for the respective networks to reach finality. In the case for Ethereum, the official finality timeframe is actually much longer than 18 minutes, but this is typically how long dApps wait. In the case of Taraxa, finality is actually just under 3.7 seconds.

Bridging from Taraxa to Ethereum takes far longer than bridging from Ethereum to Taraxa, this is driven again by the extremely high gas fees on Ethereum. Just transferring, storing, and verifying state changes is an extremely expensive operation, so when the Relayer transfers over Taraxa's state changes to Ethereum, we'd like to do it not so frequently to keep costs under control. But since gas costs on Taraxa are next to nothing, the Relayer can store Ethereum's state onto Taraxa much more frequently.

The bridging delays may be shorter than what's aforementioned, if your transaction falls into the same delay window as a previous transaction that was earlier than yours.

The dev team will continue to work on finding optimizations to reduce this delay, but ultimately there will always be an asymmetry simply because the gas costs on Ethereum are so astronomically high.

9. Confirm the transaction

9.1 Click on "Confirm" to proceed

9.2 Confirm transaction in wallet

9.3 Wallet submitting the transaction

9.4 Wallet successfully submitted transaction

9.5 Bridge UI confirming the transaction's success

10. Confirming your transaction in explorers & wallet

10.1 Confirming in explorers

Once your transaction is completed, the bridged assets will arrive into the target wallet automatically after the requisite delay has elapsed. As an example, we can check on the first bridging transaction from Taraxa to Ethereum. Here are the transactions,

You can see that there's an ~4 hour delay between the two transactions.

10.2 Add to your wallet

You should also add the bridged token to your wallet.

For example, if you have just bridged over TARA coins from the Taraxa network to the Ethereum network, you should add the TARA-on-ETH token address to your wallet.

Go to the section of the guide, find the target (i.e., where you're transferring to) contract address, and add it into your wallet (e.g., Metamask). In this example the address we're looking for is the TARA Token on ETH address, add that as a custom token and you will see the balance pop up.

As a reference, here is the .

That's it! You now know how to use the to bridge assets between Taraxa and Ethereum!

🌉
↔️
Transaction on Taraxa initiating the bridging transfer
Transaction on Ethereum that automatically credits the bridging transfer
On-chain contracts
official guide on how to add a custom token in Metamask
Ficus Root Bridge
Ficus Root Bridge
Ficus Root Bridge