Harmony
Support ForumGithubTelegramDiscord
  • Welcome
  • 🎶General
    • Introduction
      • What is Harmony?‌
      • Roadmap
      • Strategy & Architecture
      • Study Materials
      • FAQ
    • Technology
      • Key Features
      • Randomness
      • Sharding
      • Consensus
      • Effective Proof-of-Stake
      • Tokenomics
      • Transactions
    • LayerZero Bridge
      • Important Notice
      • Bridge tutorial
      • FAQ
        • What token will I get after the bridge
        • How to find a bridged token address
    • Ecosystem
      • Wallets
        • 1Wallet
        • Gnosis Safe
        • Hardware Wallets
          • Trezor
          • Ledger Nano
            • Ledger with Metamask
            • Download & Setup
            • Ledger with HMY CLI
            • Ledger with Staking Dashboard
              • Sign In With Ledger
              • Sending transactions via Ledger
              • Staking Transactions via Ledger
          • Safepal
            • Download & setup
            • Create/import account
            • Send transaction
        • Browser Extension Wallets
          • Metamask
            • Installing MetaMask
            • Adding Harmony
            • Create a New Account
            • Sending & Receiving
            • Adding Custom Harmony Tokens
            • Import an Account
          • Math Wallet
            • Download & Setup
            • Create/Import/Export Wallet
            • Sending Transactions
            • Staking
            • Collecting Rewards
            • Undelegating
          • Harmony Chrome Extension Wallet
        • Desktop Wallets
          • Guarda Wallet
          • Staking4All Wallet
        • Mobile Wallets
          • Metamask Wallet
          • Blits Wallet
          • Cobo Wallet
          • Frontier Wallet
          • Guarda Wallet
          • Infinity Wallet
          • ONTO Wallet
          • Sef Wallet
          • Trust Wallet
          • Trustee Wallet
        • Web Wallets
          • Guarda Wallet
        • HMY CLI (Harmony Command Line Interface)
          • Download & Setup
          • Create or Import Wallet
          • Sending Transactions
          • Staking Transactions
          • Querying Balances
          • Querying the Blockchain
          • List of Transaction Error Messages
          • Cookbook
          • Other CLI References
      • DApps
        • User Guide
        • DeFi
          • Sushi
          • Onsen
        • CLI 1Wallet User Guide
        • Media
          • Timeless
        • FAQ
        • NFTs
      • Partners
        • Exchanges
        • Fiat Gateways
        • DeFi Protocols
      • Integrations
      • Cross-Border Finance
      • DAOs
        • Components & Tools
          • Snapshot
        • Community DAO
        • Validator DAO
        • Developer DAO
    • Community
  • 🏗️Developers
    • Getting Started
      • Network & Faucets
      • List of RPC Providers
      • Remix IDE
      • Dev Environment Setup
      • Ethereum Compatibility
    • Deploying on Harmony
      • Using Remix
        • Ethereum Remix
        • Harmony Remix
      • Using Truffle
      • Using Hardhat
      • Using Web3
      • Using Harmony-JS
        • Setup
        • Compile & Deploy
        • Demo: Deploying an Ethereum Smart Contract on Harmony
      • Deploy HRC20
      • Smart Contract Verification
    • SDK
      • Web3.js
        • Using Web3.js to Send Transactions on Harmony
        • Find the last transaction
      • JavaScript SDK
      • Go CLI
      • Java SDK
      • Python SDK
      • Harmony Ethers.js Wrapper
    • API
      • Methods
        • Account Methods
          • hmy_getBalanceByBlockNumber
          • hmy_getTransactionCount
          • hmy_getBalance
        • Filter Methods
          • hmy_getFilterLogs
          • hmy_newFilter
          • hmy_newPendingTransactionFilter
          • hmy_newBlockFilter
          • hmy_getFilterChanges
          • hmy_getLogs
        • Transaction Related Methods
          • hmy_getStakingTransactionByBlockHashAndIndex
          • hmy_getStakingTransactionByBlockNumberAndIndex
          • hmy_getStakingTransactionByHash
          • hmy_getCurrentTransactionErrorSink
          • hmy_getPendingCrossLinks
          • hmy_getPendingCXReceipts
          • hmy_getCXReceiptByHash
          • hmy_pendingTransactions
          • hmy_sendRawStakingTransaction
          • hmy_getTransactionsHistory
          • hmy_sendRawTransaction
          • hmy_getTransactionReceipt
          • hmy_getBlockTransactionCountByHash
          • hmy_getBlockTransactionCountByNumber
          • hmy_getTransactionByHash
          • hmy_getTransactionByBlockNumberAndIndex
          • hmy_getTransactionByBlockHashAndIndex
          • hmy_getBlockByNumber
          • hmy_getBlockByHash
          • hmy_getBlocks
        • Contract Related Methods
          • hmy_estimateGas
          • hmy_getStorageAt
          • hmy_call
          • hmy_getCode
        • Protocol Related Methods
          • hmy_isLastBlock
          • hmy_epochLastBlock
          • hmy_latestHeader
          • hmy_getShardingStructure
          • hmy_blockNumber
          • hmy_syncing
          • hmy_gasPrice
          • net_peerCount
          • hmy_getEpoch
          • hmy_getLeader
        • Staking Related Methods
          • hmy_getCirculatingSupply
          • hmy_getTotalSupply
          • hmy_getStakingNetworkInfo
          • hmy_getAllValidatorInformation
          • hmy_getAllValidatorInformationByBlockNumber
          • hmy_getCurrentUtilityMetrics
          • hmy_getDelegationsByValidator
          • hmy_getDelegationsByDelegatorAndValidator
          • hmy_getDelegationsByDelegator
          • hmy_getValidatorMetrics
          • hmy_getMedianRawStakeSnapshot
          • hmy_getElectedValidatorAddresses
          • hmy_getAllValidatorAddresses
          • hmy_getCurrentStakingErrorSink
          • hmy_getValidatorInformation
          • hmy_getValidators
          • hmy_getSignedBlocks
          • hmy_isBlockSigner
          • hmy_getBlockSigners
        • Tracing Methods
          • trace_block
          • trace_transaction
      • Sample Code
    • Tools
      • Harmony VRF
      • The Graph
      • Envio
      • Ganache
        • Harmony Ganache
      • Harmony-React
      • Oracles
        • Band Protocol
      • Smart Contract Verification
    • Tutorials
      • Deploying HRC20
      • Deploying HRC721/NFT
      • The Graph - Subgraphs
        • Building & Deploying Subgraph (local node)
      • Using Band Oracle
      • Using Crosschain API
        • Scripts
        • Testing
        • Webserver
      • Using Web3.py & Pyhmy
      • Using IPFS & Filecoin
        • Using IPFS
        • Using NFT.storage
      • Indexing HRC20 with Envio
      • Building a Simple Metaverse Contract
      • Building a Simple Bridge with Ethereum
      • Staking for Multisig
    • DApp Examples
      • DApp Samples
      • Games
        • Harmony Puzzle
      • Cross-Chain
      • DeFi
      • Hackathons
        • DevPost
        • Hack the Horizon
      • Others
    • Wallets
      • Metamask
        • Interacting With Metamask
        • Using Metamask with Harmony Smart Contracts
        • Add or Switch to Harmony chain on Metamask
      • Harmony Chrome Extension Wallet
      • Math Wallet
      • WalletConnect
    • Harmony Stack and Projects
  • 🌏Network
    • Governance
      • Network Governance
        • Voting via Governance App
        • Voting via HMY CLI
      • HRC-20 Governance
      • FAQ
    • Validators
      • Terms & Concepts
        • Validator, BLS key, Instance
          • Shard Assignment
        • Slots Bidding and Election
        • Effective Proof-of-Stake
        • Block Reward
        • Epoch Transition
        • Slashing
        • Undelegation
      • Server Setup
        • Requirements
        • Cloud Guides
          • Digital Ocean
          • Vultr
          • AWS
          • Google Cloud
        • Raspberry Pi Guide
      • Node Setup
        • 1. HMY CLI Download
        • 2. Setting up BLS Keys
        • 3. Syncing DB
        • 4. Installing & Updating
          • Installing A Node
            • Using Node Binary
            • (Deprecated) Using AutoNode
              • Install & Run
              • Update
              • Monitor
              • BLS Key Management
              • Collect Rewards
              • Maintenance
              • Troubleshoot
              • Extra
            • (deprecated) Using Node.sh
          • Upgrading A Node
            • Using Node Binary
            • Using AutoNode (deprecated)
            • Using Node.sh (deprecated)
          • Checking A Node
      • Creating A Validator
      • Managing A Validator
        • Checking Validator Information
        • Changing Validator Information
        • Delegating To A Validator
        • Undelegating From A Validator
        • Check Your Delegations
        • Collecting Rewards
        • Adding A Validator Logo
      • Staking Dashboard Basics
      • Validator Information Terms
      • Validator Security Tips
      • Slashing and Uptime
      • Monitoring
        • Node Sync
        • Prometheus & Grafana
        • Network Status
      • Troubleshooting
        • Why am i not Elected?
        • Frequently Asked Questions (FAQ)
      • Tools
        • Telegram Bots
        • Dashboards
        • Reward Calculators
        • Text User Interface (TUI)
        • HMY Bidder
        • Mobile Apps
          • One Validator Dashboard
          • Termux
    • Delegators
      • Introduction
      • Staking
        • Via Browser
          • Staking Dashboard
          • Staking Transactions
          • Sending Transactions
        • Via Mobile
        • FAQ
      • Redelegation
      • Informational Videos
Powered by GitBook
On this page
  • What is LayerZero bridge?
  • Is there a tutorial explaining how to use LayerZero?
  • What account can I use to receive bridged tokens?
  • Can I bridge tokens to the contract address?
  • What token will I get after bridging?
  • Bridge transfer completed but I can't see in metamask?
  • What kind of assets can be bridged using LayerZero?
  • How are assets mapped between blockchains?
  • Can I bridge as many tokens as I want, or is there a limit?
  • Can I send my bridged tokens back?
  • Can I send the Ethereum bridged tokens to Binance?
  • Can I send bridged tokens from Harmony blockchain to other blockchains or exchanges?
  • Are bridged tokens transferable?
  • What happens to my original tokens after I bridge them to Harmony?
  • Does the token supply increase when using LayerZero?
  • Which coins do I need to pay the transaction fees on the bridge?
  • What’s the cost of using the bridge?
  • How to find out what's with my bridge operation?
  • Transaction pending for too long
  • Operation in progress for too long
  • Operation status is success, but I can’t find my tokens
  • Bridge error, funds lost
  • I can’t bridge because of an error
  • By mistake sent tokens to an exchange wallet (e.g. Binance exchange)
  • I sent tokens to a wallet that doesn’t support the network I used
  • By mistake sent tokens to a wrong address or a token address
  • I have a question about the LayerZero bridge

Was this helpful?

Export as PDF
  1. General
  2. LayerZero Bridge

FAQ

PreviousBridge tutorialNextWhat token will I get after the bridge

Last updated 1 year ago

Was this helpful?

What is LayerZero bridge?

LayerZero is a cross-chain bridge that allows exchange of crypto assets (e.g., fungible/non-fungible tokens, stablecoins) between Ethereum or Binance Smart Chain and Harmony blockchains.

The Bridge is used to migrate assets from one chain to another. If you have assets on Ethereum or Binance Smart Chain, you can use the bridge to move them to Harmony blockchain and get corresponding assets on Harmony. LayerZero also allows redemption of the exchanged assets back at any time.

LayerZero Bridge is accessible

Is there a tutorial explaining how to use LayerZero?

There is bridge process

What account can I use to receive bridged tokens?

You need to be able to open your wallet in the network you sent your tokens to. Check that there are no network restrictions that prevents you from it. Also check if there is no limitations on a token type you can receive. Never send tokens to an exchange account!

Can I bridge tokens to the contract address?

No, bridging to contract address directly is not supported. It might result in permanent loss of your tokens.

What token will I get after bridging?

Please refer to to find out.

Bridge transfer completed but I can't see in metamask?

What kind of assets can be bridged using LayerZero?

Oracle 1LINK

Natives

  • 1ONE (Wrapped ONE on Ethereum) - no redeploy required

  • bscONE (Wrapped ONE on BSC) - no redeploy required

  • ETH

  • 1ETH

  • bscONE (Wrapped ONE on BSC) - no redeploy required

  • BNB

  • bscBNB (Wrapped BnB on Harmony)

  • 1WBTC

Stablecoins

  • 1USDC

  • 1USDT

  • 1DAI

  • 1BUSD

  • bscBUSD

Partners

  • 1AAG - no token redeploy

  • 1FRAX

  • 1FXS

  • 1SUSHI

  • xSUSHI

  • 1AAVE

How are assets mapped between blockchains?

Assets are mapped 1:1. For example, 10 BUSD on Ethereum after bridging will be available as 10 1BUSD on Harmony. Here, “1BUSD“ is the token symbol of the token on Harmony corresponding to “BUSD“ token symbol on Ethereum.

Same 1:1 mapping holds true for Binance Smart Chain. However, the assets from two different parent chains (Ethereum or Binance Smart Chain) after bridging will be represented using different bridged assets on Harmony. For instance, 5 Binance Smart Chain BUSD after bridging will be available as 5 bscBUSD on Harmony. Here, “bscBUSD” is the token symbol of the token issued on Harmony corresponding to “BUSD” token symbol on Binance Smart Chain.

And, the 1BUSD and bscBUSD on Harmony chain are not interchangeable, meaning one cannot bridge BUSD from Ethereum to Harmony and then withdraw it on Binance Smart Chain. Same for other tokens.

Can I bridge as many tokens as I want, or is there a limit?

There is no limit on the amount of tokens that can be bridged.

Can I send my bridged tokens back?

Yes: you can bridge tokens back and receive back the same amount of the original token there. For example, you bridged USDC from Ethereum to Harmony and got 1USDC token on Harmony. At any time you can bridge 1USDC back to Ethereum and receive USDC token.

Can I send the Ethereum bridged tokens to Binance?

No, Ethereum bridged tokens can only be sent back to Ethereum. Same applies for Binance bridged tokens.

Can I send bridged tokens from Harmony blockchain to other blockchains or exchanges?

No, do NOT send bridged tokens directly to other blockchains or exchanges. This will not work and might result in permanent loss of your tokens. Bridged tokens can only be used on Harmony network. The only way to send them out is bridging them back.

Are bridged tokens transferable?

Yes. You can transfer the bridged tokens to other users, and they can redeem them back to their Ethereum or Binance accounts. This is possible because when you lock your token, it gets pooled into a bridge smart contract from which any redeem request can be serviced without tying the locked tokens and redemption to a specific user account.

What happens to my original tokens after I bridge them to Harmony?

Once you use LayerZero to transfer your original tokens to Harmony, the original tokens get stored and locked in the LayerZero contracts: you do not own those tokens on Ethereum or Binance anymore. You receive the same amount of tokens on the Harmony blockchain.

Does the token supply increase when using LayerZero?

No: The supply of the original token never change as a result of using LayerZero: LayerZero bridge locks a certain amount of a token on Ethereum blockchain (essentially taking it out of circulation) and mints the exact same amount of tokens on the Harmony blockchain, that represents in all respects the original token (i.e. regenerating the locked supply). As a result, the circulating supply of the original token will stay the same: it's just split across two different blockchains instead of one.

Which coins do I need to pay the transaction fees on the bridge?

It depends on which blockchain you want transfer assets from. If it is from Harmony blockchain, you need ONE tokens, if it is from Ethereum you need ETH tokens, from Binance Smart Chain (BSC) BNB tokens and so on.

What’s the cost of using the bridge?

Cost of the bridge operation consists of the LayerZero bridge fee and costs of transactions. You'll see the page with the fee information that you need to confirm before the operation. Transaction fee depends on the chain gas prices and are confirmed in Metamask before the transaction. LayerZero fees are calculated dynamically based on Oracle and Relayer prices for the destination chain. They are transferred in the same transaction as the bridges amount. Fees are paid in native tokens of the first chain, so if you transfer any token from Ethereum, you pay fees by ETH token, ONE for Harmony and BNB for Binance.

How to find out what's with my bridge operation?

Transaction pending for too long

Operation in progress for too long

Operation status is success, but I can’t find my tokens

  • Note that:

  • Bridge is not a swap, and you won't receive ONE if you weren't bridging ONE token.

  • A token address is never the same in the different networks, even when a symbol is the same.

  • If you added a token and tokens aren’t shown, check that:

  • You added a token to the receiver wallet of your operation.

  • The receiver address of your operation is correct. If you found out that you made a mistake in the address, we can’t help you with that. You can reach your funds only if you have access to the wallet.

  • The receiver wallet is connected to the correct network. For example, if you bridged tokens to Harmony, you need to be connected to Harmony mainnet.

  • You’ve added a token that you really received. Check the transaction data.

  • Tokens haven’t been transferred after the bridge.

Bridge error, funds lost

I can’t bridge because of an error

There can be many possible causes. Sometimes the reason is clear from the error message (for example, low balance, not enough tokens to cover gas). Often there is a problem with the wallet connection. Try these steps to solve it:

  • Make sure your browser and the wallet extension are updated to the latest version

  • Make sure that your browser doesn’t block pop-up windows.

  • Try to clear the cache and relogin.

  • Try using another browser or/and wallet extension.

  • If you use a mobile version, try it on the desktop.

By mistake sent tokens to an exchange wallet (e.g. Binance exchange)

Unfortunately, your tokens are permanently lost and not recoverable.

I sent tokens to a wallet that doesn’t support the network I used

If you can’t open your wallet in the network where your tokens were sent, we can’t assist. You can try to reach a support of the service that gave you this account.

By mistake sent tokens to a wrong address or a token address

Unfortunately, we can't help in such case. We don't have access needed to transfer tokens between accounts.

I have a question about the LayerZero bridge

You will need identify the contract address of the asset your just bridged looking at and add it into metamask

You can find the list the bridged assets

You can find the operation details on your operation page. It's the page you see when you perform the operation on Every bridge operation is associated with a unique operation id, which is shown on the page. You can find links to transactions of the operation steps and the status of each step. Also, you can always find your operation in the Use "My transaction" option to see only operations for your connected Metamsk account.

If your transaction is pending for too long, you can manage it via your wallet. We can’t make it faster or cancel it. If the transaction is on Harmony side, make sure you use for Harmony network.

Normally it takes less than 20 minutes per each step of the bridge operation. Delays are also possible, but they won't affect your funds. If your operation is in progress for more than an hour, you can fill in the and include you problem description. Note that your request will be ignored if you send it earlier.

Bridge does not swap tokens, it only provides wrapped tokens. For the token that you bridged, you have received wrapped token to your account. To find out which one, you can refer to .

If you don't see that token in your account, and add it to your wallet to see the correct balance as shown If you have problems with finding or adding a token, please ask for help in community groups.

If a correct balance isn’t shown after you added a token, and you have double-checked everything, fill in the and include you problem description. It’s required to include a token address you added and a wallet you added it to.

Please fill in the and include you problem description.

Check if your wallet is set up correctly.

If you’ve checked your settings, but you still have errors, please share your problem in the #support or #bridge channel.

You can address your question to Harmony community in Discord or Telegram. Please beware of scammers. Remember, admins never DM you first. Please refer to our first.

🎶
here.
step-by-step explanation
this page
https://bridge.harmony.one/tokens
here
the LayerZero bridge site.
bridge operation explorer.
recommended settings
support form
this page
here.
support form
support form
here
Discord
FAQ