UI to transfer tokens through AMB

This manual describes how to rapidly develop a web-application to transfer tokens using the Arbitrary Message Bridge between the Ethereum Mainnet and the xDai chain. It assumes that an erc-to-erc extension was deployed using these steps.
The application is based on the Burner Wallet 2 interface. Quick launch of a new application is possible with the TokenBridge plugin developed for the Arbitrary Message Bridge mediators.
The main page of the BW2-based application to transfer tokens through AMB
Prerequisites
Before developing the application developing, the following must be prepared:
the AMB mediator address responsible for working with the bridgeable tokens
the ERC20/ERC677/ERC827 token contract address in the Ethereum Mainnet
the ERC677 token contract address deployed together with the mediators
For demonstration purposes, data for the sUSD AMB extension will be used below.
Instructions
1. Clone the repo with the application template
1
git clone https://github.com/poanetwork/tokenbridge-burner-wallet-plugin.git
2
cd tokenbridge-burner-wallet-plugin bw-plugin
Copied!
2. Add the assets to bridge by creating two files:
my-plugin/src/assets/sUSD.ts is for the asset on the Ethereum Mainnet;
my-plugin/src/assets/xsUSD.ts is for the ERC677 token created by the erc-to-erc AMB extension deployment process.
my-plugin/src/assets/sUSD.ts
my-plugin/src/assets/xsUSD.ts
1
import { BridgeableERC20Asset } from '@poanet/tokenbridge-bw-exchange'
2
​
3
export default new BridgeableERC20Asset({
4
  id: 'susd',    //internal id of the asset
5
  name: 'sUSD',  //displayed name of the asset
6
  network: '1',  //chain id (ethereum mainnet)
7
  address: '0x57ab1e02fee23774580c119740129eac7081e9d3', //token contract address
8
  bridgeModes: ['erc-to-erc-amb']
9
})
Copied!
1
import { ERC677Asset } from '@poanet/tokenbridge-bw-exchange'
2
​
3
export default new ERC677Asset({
4
  id: 'xsusd',    //internal id of the asset
5
  name: 'xsUSD',  //displayed name of the asset
6
  network: '100', //chain id (xdai chain)
7
  address: '0x4C36d2919e407f0Cc2Ee3c993ccF8ac26d9CE64e' //token contract address
8
})
Copied!
3. Rename my-plugin/src/pairs/StakeBridge.ts to my-plugin/src/pairs/sUSDBridge.ts and replace its contents as follows:
my-plugin/src/pairs/sUSDBridge.ts
1
import { Mediator } from '@poanet/tokenbridge-bw-exchange'
2
import { sUSD, xsUSD } from '../index'
3
​
4
// Mediator contract address at the xDai chain
5
const homeMediatorAddress = '0xD9a3039cfC70aF84AC9E566A2526fD3b683B995B'
6
// Mediator contract at the Ethereum Mainnet
7
const foreignMediatorAddress = '0x71F12d03E1711cb96E11E1A5c12Da7466699Db8D'
8
​
9
export default class sUSDBridge extends Mediator {
10
  constructor() {
11
    super({
12
      assetA: sUSD.id,
13
      assetABridge: foreignMediatorAddress,
14
      assetB: xsUSD.id,
15
      assetBBridge: homeMediatorAddress
16
    })
17
  }
18
}
Copied!
4. Modify my-plugin/src/index.ts to export new assets and the bridgeable pair.
my-plugin/src/index.ts
1
export { default as sUSD } from './assets/sUSD'
2
export { default as xsUSD } from './assets/xsUSD'
3
export { default as sUSDBridge } from './pairs/sUSDBridge'
Copied!
5. Modify wallet/src/index.tsx to operate with new objects:
line 10 contains:
1
import { sUSD, xsUSD, sUSDBridge } from 'my-plugin'
Copied!
line 15 contains: 
1
assets: [sUSD, xsUSD]
Copied!
line 19 contains:
1
pairs: [new sUSDBridge()]
Copied!
6. Build the docker image with the wallet. 
1
docker-compose build wallet
Copied!
7. Run the container locally with the wallet application by specifying the port to listen to and an Infura Project ID which will be used by the application to connect to an Infura JSON RPC node:
1
docker run -ti -p 8080:8080 -e PORT=8080 \
2
  -e REACT_APP_INFURA_KEY=YOUR-PROJECT-ID --rm bw-plugin_wallet:latest
Copied!
8. Wait for the application server to start. The URL address to connect to the wallet application will display:
1
wallet:   Local:            http://localhost:8080/
Copied!
9. Run a browser and paste the URL in the terminal (http://localhost:8080/). The browser must have the MetaMask extension installed. The xDai RPC endpoint must be added to MetaMask. Press the "Exchange" button to test a transfer of bridgeable tokens through the AMB.
The exchange page allows to bridge tokens through AMB
10. After testing the application, it can either be deployed to a platform like Heroku or the developed pluging can be published as a NPM library and integrated into the Burner Factory: https://github.com/burner-factory/verified-plugins.

Deploy ERC20 to ERC677 AMB bridge extension

xMOON-MOON bridge extension

Last modified 1yr ago

Export as PDF

Copy link

Contents

Prerequisites

Instructions