跳到主要内容

代币充提

此处以ERC-20为例，充值的流程是：

  1. Approve ERC20Predicate合约，允许它控制需要被存入的代币。
  2. 在RootChainManager上调用depositFor。

提取的流程是：

  1. 在BTTC上销毁代币。
  2. 在RootChainManager上调用exit方法，以提交销毁证明。需要在包含此销毁交易的checkpoint提交之后调用。

详细流程​

实例化合约​

const mainWeb3 = new Web3(mainProvider)
const bttcWeb3 = new Web3(bttcProvider)
const rootTokenContract = new mainWeb3.eth.Contract(rootTokenABI, rootTokenAddress)
const rootChainManagerContract = new mainWeb3.eth.Contract(rootChainManagerABI, rootChainManagerAddress)
const childTokenContract = new bttcWeb3(childTokenABI, childTokenAddress)

Approve​

批准合约ERC20Predicate消费代币。approve需要两个参数：地址和金额。

await rootTokenContract.methods
  .approve(erc20Predicate, amount)
  .send({ from: userAddress })

存款​

调用RootChainManager合约的depositFor方法。这个方法需要接收三个参数：BTTC上接收存款的用户地址，代币合约在根链上的地址以及金额（以ABI编码形式体现）。

请在存款之前，确保已经进行过正确的approve操作。

const depositData = mainWeb3.eth.abi.encodeParameter('uint256', amount)
await rootChainManagerContract.methods
  .depositFor(userAddress, rootToken, depositData)
  .send({ from: userAddress })

燃烧/销毁​

通过调用子代币合约的withdraw方法来销毁BTTC上的代币。这个方法接收一个参数：要销毁的代币数量。销毁代币的证明需要在下一步操作中提交，因此要储存销毁交易的哈希。

const burnTx = await childTokenContract.methods
  .withdraw(amount)
  .send({ from: userAddress })
const burnTxHash = burnTx.transactionHash

退出​

调用RootChainManager合约的exit方法来解锁并从ERC20Predicate合约接收代币。这个方法接收一个参数：代币的销毁证明。

调用这个方法之前必须要等待包含销毁交易的checkpoint提交成功。销毁证明由RLP编码生成如下字段：

  • headerNumber：包含销毁交易的checkpoint起始块
  • blockProof：确保区块头是提交的默克尔根所在树中叶子的证明
  • blockNumber：包含销毁交易的区块号
  • blockTime：包含销毁交易的区块时间
  • txRoot：区块的交易根
  • receiptRoot：区块的receipt root
  • receipt：销毁交易的receipt
  • receiptProof：销毁交易receipt的默克尔根
  • branchMask：表示receipt在Merkle Patricia Tree中位置的一个32位参数
  • receiptLogIndex：用于从receipt中读取的日志索引

手动生成证明很复杂，因此我们建议使用BTTC SDK。如果您想手动发送交易，请将encodeAbi置为true以获取原始调用数据。

const exitCalldata = await bttcPOSClient
  .exitERC20(burnTxHash, { from, encodeAbi: true })
await mainWeb3.eth.sendTransaction({
  from: userAddress,
  to: rootChainManagerAddress,
  data: exitCalldata.data
})