4P
Search
K
Links

Ethereum to BSC Bridge Manual

Bridging ERC-20 FOUR from Ethereum to BSC BEP-20 FOUR using OmniBridge & xDai Chain

When sending ERC-20 FOUR to Binance Smart Chain, the cross-blockchain bridge is needed. The Bridge enables the cross-chain token bridging in both directions. The smart contract locks the ERC-20 FOUR sent from Ethereum, while the equivalent amount of FOUR BEP-20 is minted on BSC. When the BEP-20 FOUR needs to be bridged back to ERC-20 FOUR, the smart contract puts in a BEP-20 FOUR burn request to the Bridge, and the ERC-20 FOUR are released from the reserves. This process ensures that the total and circulating token supply don’t change.
What do you need?
  • FOUR that you want to bridge
  • ETH for gas
  • BNB for swap
  • xDai for gas
  • MetaMask wallet
Note: approximately 1 Dai converted into 1 xDai
Bridges
The xDai Bridge can only be used to send Dai to xDai STAKE converting it to xDai STAKE’s native token xDai. Sending Dai via the xDai Bridge has a lower gas cost than sending other tokens via the OmniBridge.
OmniBridge is used for ERC-20 tokens. Do not send Dai over the OmniBridge as it will not convert into xDai, but rather a wrapped version of xDai that has no liquidity.
*Read more about xDai chain: https://www.xdaichain.com/
Do not bridge directly from Ethereum to BSC! Bridge ERC-20 FOUR from Ethereum to xDai and from xDai to BSC to land on a correct token smart contract!
Adding Networks to MetaMask
The first thing a user will need to do is add the ability for MetaMask to interact with xDai (i.e. USD stable blockchain) and Binance Smart Chain (i.e. BSC). To do this, add a Custom RPC for each additional chain as shown below.
Here is the information that needs to be entered to interact with Binance Smart Chain (i.e. BSC):
Here is the information that needs to be entered to interact with xDai STAKE (i.e. xDai):
The Bridging Proces
(1) Trade ETH for DAI on Ethereum; (2) Send ERC-20 FOUR to xDai STAKE using OmniBridge; (3) Taking DAI across the Ethereum bridge to xDai STAKE; (4) Sending FOUR over the OmniBridge to BSC STAKE; (5) Getting BEP-20 BNB into your wallet, and; (6) Send ERC-20 FOUR across the Bridge to Binance Smart Chain (i.e. BSC)
Note: It is not recommended to do transactions with small amounts on Ethereum. It’s too expensive.
Trade ETH for DAI on Ethereum:
  1. 1.
    Go to the Uniswap
  2. 2.
    Click the “Select a token” button
  3. 3.
    Type in DAI and select it when it appears at the top
Note: You will need 1 DAI to complete the bridge transformation.
Sending FOUR over the OmniBridge to xDai STAKE:
Open OmniBridge (https://omni.xdaichain.com/bridge) and take the following steps to send FOUR over the bridge:
  1. 1.
    Check the top right dropdown selection — it should be “ETH -> XDAI
  2. 2.
    Select the STAKE dropdown
  3. 3.
    Try to find a token FOUR otherwise click the + Add Custom Token link
  4. 4.
    The “Add Custom Token” window will appear. Copy this contract (0x4730fB1463A6F1F44AEB45F6c5c422427f37F4D0) in the “Token Contract Address” field and if “Token Symbol” is not automatically selected add (FOUR) in the field also check the field (Decimals Of Precision) it should be (18)
  5. 5.
    Confirm your inputs by clicking on “Add token
Once FOUR is added and selected, enter the number of tokens to “Unlock” or just select Max and select the Unlock button. This will bring up the MetaMask window and require a transaction to be completed. Once this transaction is completed, verify the number of tokens to send, select the “Transfer” button to bring up MetaMask, and complete the transfer.
Note: Unlocking and Transfering tokens can take a long time to complete. You can check progress by right-clicking on a “spinning” button and opening the page in a new tab.
When the transaction is completed, the sent FOUR tokens will be parked in an Ethereum contract and an xDAI STAKE version of your tokens will appear in your wallet. To see the transferred tokens, change the MetaMask network to the xDAI STAKE network added earlier.
Taking DAI across the Ethereum bridge to xDai STAKE
You need to send DAI over the xDai Bridge (https://bridge.xdaichain.com/), converting it into xDai. To do this I need to:
  1. 1.
    Switch back to Ethereum Network in Metamask.
  2. 2.
    Indicate a transfer amount
3. Complete transaction on MetaMask
Note: Once you have transferred FOUR and DAI to xDai you are ready for the next step.
Sending FOUR over the OmniBridge to BSC STAKE:
Note that you can start the process of sending FOUR to BSC using the BSC-xDAI OmniBridige, however, without BNB in your wallet, there will be no way to claim your bridged tokens. The BEP-20 (BSC) version of BNB is the native token of the Binance Smart Chain (BSC) and is what is used to pay transaction fees. Without BNB in your wallet, there is no way to claim any transferred tokens.
Getting BEP-20 BNB into your wallet:
  1. 1.
    Receive BNB from another wallet on BSC
  2. 2.
    Use Binance to purchase BNB and send BEP-20 BNB directly to the MetaMask wallet address
  3. 3.
    Add Binance Chain Wallet to the browser (similar to MetaMask), and use Binance US to purchase BNB and send BEP-2 to the Binance Chain Wallet Address. Once BNB is in a Binance Chain Wallet, a cross-chain transfer can be done internally by sending BNB to the wallet address and selecting Binance Smart Chain. The Binance Chain Wallet can be a new wallet, or the current MetaMask wallet can be imported into it.
Note: There are likely other options, and hopefully, something will be created to allow users to get BEP-20 BNB into their wallet directly from xDai STAKE.
Take ERC-20 FOUR across the Bridge to Binance Smart Chain (i.e. BSC)
Note: The xDai Bridge to BSC is a different OmniBridge. You can switch bridges by clicking on the top right button and select BSC -> xDAI
The xDai to BSC bridge has the exact same interface as the above-described Ethereum to xDai OmniBridge. Two differences to keep in mind with the xDai to BSC bridge versus the Ethereum to xDai bridge are:
  1. 1.
    The same token will have a different xDai address
  2. 2.
    All tokens, including xDai (DAI), use the xDai to BSC OmniBridge. This is in contrast to Ethereum to xDai, which has a bridge specific to xDai (DAI).
Note: Again, be sure to have some BNB in your wallet on Binance Smart Chain (BSC), otherwise, you will not be able to claim your transfer.
Take the following steps to send FOUR over the bridge:
  1. 1.
    Check the top right dropdown selection — it should be “BSC -> XDAI
  2. 2.
    Select the STAKE dropdown
  3. 3.
    Try to find a token FOUR otherwise click the + Add Custom Token link
  4. 4.
    The Add Custom Token window will appear. Copy this contract (0xd882739Fca9CBAE00F3821c4c65189E2D7e26147) in the “Token Contract Address” field and if “Token Symbol” is not automatically selected add (FOUR) in the field also check the field (Decimals Of Precision) it should be (18)
  5. 5.
    Confirm your inputs by clicking on Add token
Once FOUR is added and selected, enter the number of tokens to “Unlock” or just select Max and select the “Unlock” button. This will bring up the MetaMask window and require a transaction to be completed. Once this transaction is completed, verify the number of tokens to send, select the “Request” button to bring up MetaMask, and complete the transfer.
Note: Again, be sure to have some BNB in your wallet on Binance Smart Chain (BSC), otherwise you will not be able to claim your transfer.
Click on “Claim”. Bellow window show:
Switch the wallet to BSC on Metamask and click on “Claim” and confirm the transaction on Metamask.