User Guide

The bridge is available at iris-testnet.harmony.one, currently deployed on Ethereum Ropsten Testnet and on Harmony Testnet. Smart contract transactions on the Ethereum side is publicly available on Etherscan.

1. Install Math Wallet (Chrome Extension) and MetaMask Browser Plugin​

If you are using Math Wallet for the first time, please refer to the Download & Setup section.

• Note that HRC20 tokens are not shown on the wallet interface directly (balance can be queried via CLI).

• Any ERC20 can be added to the bridge since it is fully permissionless. IRIS token used in the example is minted for demo purpose (contract publicly available on Etherscan. )

2. Go to iris-testnet.harmony.one, connect your wallets on both Ethereum & Harmony side.

3. Select the right network environment & query test tokens.

• Please make sure to select the Ropsten network on Metamask, and Testnet on Harmony One Wallet.

• In order to swap IRIS-RBT tokens between Ethereum and Harmony, you need test tokens to pay gas fee on both Ropsten (the Ethereum testnet) and the Harmony testnet.

  • Ethereum Ropsten Faucet: https://faucet.metamask.io/​

  • Harmony Testnet Faucet: https://faucet.pops.one/​

4. Enter the amount of IRIS-RBT token you wish to swap as well as the recipient address. Then click on "SWAP ME!". Click on "Switch Direction" to change the direction of the swap.

• In our demo, we will swap 100 IRIS-RBT tokens from Ethereum to Harmony

5. Confirm transactions (4 times) & complete the SWAP!

5.1 Ethereum to Harmony

• Lock origin tokens on Ethereum:

  • Confirm the first Signature Request in the MetaMast Notification pop-up window to "approve locking for ETH wallet".

  • When the first transaction is completed, the second step to lock the tokens on Ethereum will commence automatically, confirm the transaction again.

• Mint new tokens on Harmony:

  • After the first two transactions completed on MataMask Wallet, Math Wallet will ask you to approve 2 transactions on the Harmony side.

• SWAP will be completed after 4 successful transactions.

5.2 Harmony to Ethereum

• Burn minted tokens on Harmony:

  • Confirm the first Signature Request in the MetaMast Notification pop-up window to "approve token burning for Math Wallet".

  • When the first transaction is completed, the second step to burn minted tokens on Harmony will commence automatically, confirm the transaction again.

• Unlock tokens on Ethereum:

  • After the first two transactions completed on Math Wallet, MetaMask Wallet will ask you to approve 2 transactions on the Ehtereum side.

• SWAP will be completed after 4 successful transactions.