Step-by-Step Tutorial: Bridging Crypto from BSC/ETH to Harmony
This article will cover bridging BNB from the Binance Smart Chain Network to create bscBNB on the Harmony One Network.
Any BSC token or ETH token works the same way using the official Harmony Bridge.
Use the instructions below as a guide to bridge tokens from either network in various directions.
ie. BSC => ONE || ONE => BSC || ETH => ONE || ONE => ETH
Visit the Harmony One Bridge here
Make sure you have ONE Wallet & a MetaMask Wallet.
If you are not familiar with ONE Wallet then you can find instructions on how to set up your ONE wallet here:
- To bridge from the Binance Smart Chain Mainnet to the Harmony Mainnet, click “Binance > ONE” and then click “Binance.”
- If you are bridging from Harmony to BSC you would click ONE > Binance.
Open Metamask and go to the current network dropdown menu on the top and select the network you want to bridge from, in this example, I am. bridging from Binance Smart Chain mainnet and will select that.
Click “Metamask” to connect your Binance Smart Chain MetaMask network so it pulls in your wallet information.
NOTE: Make sure you have BNB tokens for gas or you will not be able to bridge funds from this network over to Harmony
(network fees range between $0.50 and $5)
Connect your Harmony One Wallet so it pulls in your wallet information.
This may also be done using a different metamask account on the harmony mainnet network as well (use a different window if you do this to make it easier for you).
NOTE: Make sure your ONE wallet / Metamask Account has some ONE tokens for gas, otherwise you will be unable to send the funds sent to your ONE wallet back to your Metamask wallet on the Harmony Mainnet.
Select the token you would like to bridge over to Harmony. If you do not see your token or it isn’t a BEP20 then select the “use custom address” and paste in the contract address of the token you wish to import (you can find the token address by searching for it on https://bscscan.com/.)
[If the token is not already on Harmony, the bridge will create a new address for you.]
In this example, I will be bridging BNB from the Binance Smart Chain Mainnet to receive bscBNB on the Harmony mainnet.
Input the $amount you wish to bridge ^^
NOTE: If it says you have exceeded the amount because you input Max Available then just lower it a bit. You need to keep enough for gas if it’s a token that requires gas (ie. if I send ALL of my BNB then I will be spending all of it leaving none for gas).
If the Network fee costs more than the amount you have left the transaction will not be completed. If this occurs you will be notified in MetaMask — and you will have enough time to transfer more BNB (or ETH) at that point if you do it before the transaction “times-out” (approximately 5–10 minutes)
The network fee will show beforehand. You may use Coinmarketcap or the swap feature on a DEX to check token conversions against the amount in USD (ie. see below)
Copy your ONE address from your ONE wallet /Metamask and paste it into the ONE address input bar. You may also click “Use my address” to sync it automatically. You may also choose another address to send it to — make sure Harmony’s “ONE” address is in that format.
Metamask only accepts 0x (ETH/BSC etc.) addresses — if you need to find the Harmony ONE address for the wallet in your MetaMask — go to https://explorer.harmony.one/ enter the address you copy from Metamask (or another wallet) that can support Harmony One (i.e. Trust/Math) and find the one version by switching to Harmony after pasting it into the search field:
The Harmony One Wallet has a cool feature if you choose to use that:
Double-check the token amount and address you’re sending it to are correct and then click “Continue”
Read the notice (example directly below) & click “Yes I confirm”
Review transaction data, check network fee (gas), and press “confirm”
NOTE: If the network fee (gas) is very high then come back and try again later. Prices fluctuate throughout the day depending on “blockchain network demand”
So you don’t think it didn’t work and you can’t find your tokens after:
- If you are using ONE WALLET to receive the tokens:
Open ONE Wallet and import the contract address of the token you expect to receive if it’s not already there.
The mirror HRC20-ERC20(BSC uses ERC20) token addresses can be found here:
To import a token click the + sign at the bottom of the HRC20 tab and paste the contract address to import it.
Once you see your token and the expected amount (it should be the same as the amount you input before the bridge) , click “send” and paste in the address of the wallet you wish to send to (metamask address).
Your tokens should now be ready to use on the Harmony Mainnet!
- If you are using MetaMAsk to receive the tokens:
To import a token into Metamask click “Assets” and then scroll to the bottom and click “Import tokens.” Paste in token contract address. If the address is correct the information following it will autofill on its own.