Skip to content

Latest commit

 

History

History
89 lines (57 loc) · 1.94 KB

erc20-inbound.md

File metadata and controls

89 lines (57 loc) · 1.94 KB

ERC20 - Inbound (ERC20 ⇒ WRC20)

Basic Steps

  • Send approve tx on Ethereum
  • Send lock tx on Ethereum
  • Wait for storeman response on Wanchain
  • Send redeem tx on Wanchain
  • Wait for storeman response on Ethereum

Required and optional fields

Lock fields

  • to - the receiving Wanchain account
  • from - the sending Ethereum account
  • value - the value to be transferred (in wei)
  • storeman - the storeman (wan/eth) accounts to use
  • redeemKey - the tx redeem key, including x and xHash
  • token - the token addresses on Wanchain and Ethereum

Redeem fields

  • to - the receiving Wanchain account
  • redeemKey - the tx redeem key, including x and xHash
  • token - the token addresses on Wanchain and Ethereum

Revoke fields

  • from - the sending Ethereum account
  • redeemKey - the tx redeem key, including x and xHash
  • token - the token addresses on Wanchain and Ethereum

Using Wanx

Simple Usage: if the specified Wanchain and Ethereum accounts are open, then you can do the whole crosschain transaction all in one call. You will want to set up event handlers to watch for progress.

cctx.send(opts);

cctx.on('info', info => {
...

Alternatively, you can do the lock and redeem steps separately.

// do lock
cctx.lock(opts);

cctx.on('info', info => {
...

// later, and even maybe elsewhere, do redeem
cctx.redeem(opts);

Advanced Usage: if you need to handle each step separately, like if some steps need to happen on the client and others on the server, you can manually handle each step of the crosschain transaction.

// fine grain handling
Promise.resolve([]).then(() => {

  const approveTx = cctx.buildApproveTx(opts);
  return webeth.eth.sendTransaction(approveTx);

}).then(receipt => {

  const lockTx = cctx.buildLockTx(opts);
  return webeth.eth.sendTransaction(lockTx);

}).then(receipt => {

  return cctx.listenLock(opts);

}).then(log => {
...