トランスファーゲートウェイテストネットのチュートリアル

概要

このドキュメントでは、extdevとRinkebyにデプロイしたトークンコントラクト間のトークンの転送に必要となるセットアップの解説をする。もしまだであれば、まず高レベルの概要 Transfer Gatewayを読むべきである。

1. トークンコントラクトを `extdev`にデプロイする

トークンを Rinkeby にデプロイされたトークンコントラクトからextdev にデプロイされたコントラクトに移転したい場合、extdev にデプロイしたトークンコントラクトはmintToGateway関数を確実に実装していなければならない。我々はそれらの対話を行うためのサンプルコントラクトと簡単なCLIを作成した。

MyToken ERC721 コントラクト

pragma solidity ^0.4.24;

import "openzeppelin-solidity/contracts/token/ERC721/ERC721Token.sol";

contract MyToken is ERC721Token {
    // Transfer Gateway コントラクトアドレス
    address public gateway;

    constructor(address _gateway) ERC721Token("MyToken", "MTC") public {
        gateway = _gateway;
    }

    // DAppChainゲートウェイによって使われトークンを生成しイーサリアムゲートウェイにデポジットされる
    function mintToGateway(uint256 _uid) public
    {
        require(msg.sender == gateway, "only the gateway is allowed to mint");
        _mint(gateway, _uid);
    }
}

MyCoin ERC20 コントラクト

pragma solidity ^0.4.24;

import "openzeppelin-solidity/contracts/token/ERC20/StandardToken.sol";

contract MyCoin is StandardToken {
    // Transfer Gateway コントラクトアドレス
    address public gateway;

    string public name = "MyCoin";
    string public symbol = "MCC";
    uint8 public decimals = 18;

    constructor(address _gateway) public {
        gateway = _gateway;
        totalSupply_ = 0;
    }

    // DAppChainゲートウェイによって使われトークンを生成しイーサリアムゲートウェイにデポジットされる
    function mintToGateway(uint256 _amount) public {
        require(msg.sender == gateway, "only the gateway is allowed to mint");
        totalSupply_ = totalSupply_.add(_amount);
        balances[gateway] = balances[gateway].add(_amount);
    }
}

全てのコントラクトのソースはここで見つかる Truffle DAppChain Example 。

このチュートリアルではあなた自身のDAppChainを実行することはしないが、loom バイナリをダウンロードしよう。 loomバイナリにビルドインされたCLIコマンドを使って、extdev Basechainとやりとりできる。

curl https://raw.githubusercontent.com/loomnetwork/loom-sdk-documentation/master/scripts/get_loom.sh | sh
# LOOM_BIN をダウンロードしたloomバイナリに参照する
# どこからでも簡単に実行できるようにする
export LOOM_BIN=`pwd`/loom

node (v8以降) とyarnがインストールされてるか確認する。

Truffle DAppChain Example レポジトリをクローンする。

# gateway-tutorialディレクトリにチュートリアルリポジトリをクローン
git clone https://github.com/loomnetwork/truffle-dappchain-example gateway-tutorial
cd gateway-tutorial
# dependenciesのインストール
yarn

extdevプラズマチェーンのコントラクトを呼びデプロイするために秘密鍵を生成する
```
$LOOM_BIN genkey -k extdev_private_key -a extdev_public_key
```
コンソールに何かこれに似た表示を見るはずである:
```
 local address: 0x3B334bEd1e7d3e7d9214495120160D9236aCbC31
 local address base64: OzNL7R59Pn2SFElRIBYNkjasvDE=
```
これはあなたの新しい秘密鍵と対応した公開アドレスである。 extdev_private_keyファイルのなかに秘密鍵が見つかり、そして対応した公開鍵はextdev_public_keyファイルの中に見つかる。
MyTokenコントラクトおよびMyCoinコントラクトをextdev Basechainへとデプロイする。
```
yarn deploy:extdev
```

2. `Rinkeby`にトークンコントラクトをデプロイする。

Ethereumネットワークにデプロイされるトークンコントラクトのための特別な要件はない。

MyRinkebyToken ERC721 コントラクト

pragma solidity ^0.4.24;

import "openzeppelin-solidity/contracts/token/ERC721/ERC721Token.sol";

contract MyRinkebyToken is ERC721Token {
    constructor() ERC721Token("MyRinkebyToken", "MRT") public {
    }

    function mint(uint256 _uid) public
    {
        _mint(msg.sender, _uid);
    }

    // Convenience function to get around crappy function overload limitations in Web3
    function depositToGateway(address _gateway, uint256 _uid) public {
        safeTransferFrom(msg.sender, _gateway, _uid);
    }
}

MyRinkebyCoin ERC20 コントラクト

pragma solidity ^0.4.24;

import "openzeppelin-solidity/contracts/token/ERC20/StandardToken.sol";

contract MyRinkebyCoin is StandardToken {
    string public name = "MyRinkebyCoin";
    string public symbol = "MRC";
    uint8 public decimals = 18;

    // one billion in initial supply
    uint256 public constant INITIAL_SUPPLY = 1000000000;

    constructor() public {
        totalSupply_ = INITIAL_SUPPLY * (10 ** uint256(decimals));
        balances[msg.sender] = totalSupply_;
    }
}

全てのコントラクトのソースは Truffle DAppChain Exampleリポジトリにある。

これらのコントラクトを Rinkebyにデプロイしよう。

イーサリアム秘密鍵を生成する。

# これはrinkeby_account, rinkeby_mnemonic, rinkeby_private_key ファイル群を生成する
yarn gen:rinkeby-key

新しいRinkebyアカウントのアドレスを rinkeby_accountファイルから取得する。
```
cat rinkeby_account
```
Rinkebyにコントラクトをデプロイできるよう、RinkebyアカウントにETHを与える。 https://faucet.rinkeby.io を使うか、もしくは他のアカウントからETHを送っても良い。
InfuraのAPIキーをセットする (以下で取得https://infura.io)
```
export INFURA_API_KEY=XXXXXXXXXXXXXXXX
```
サンプルコントラクトをデプロイする
```
 yarn deploy:rinkeby
```
以下のようなエラーで失敗する場合
```
 Error encountered, bailing. Network state unknown. Review successful transactions manually.
 insufficient funds for gas * price + value
```
さらにもう少しETHをrinkeby_accountで転送する必要がある

3. `extdev` コントラクトを `Rinkeby`コントラクトにマップする

一度コントラクトを両方のチェーンにデプロイしたらトランスファーゲートウェイにコントラクト間でトークンを転送したいと伝える必要がある。あなたはプログラムで loom-jsの中のTransferGatewayクラスを使うか loom CLIを使う事ができるこのチュートリアルでは我々は web3とloom-jsを使ってより合理的なJS CLIを作ってきたのでアドレス、トランザクション、ハッシュといけにえの山羊を探して移動する必要はありません。

extdevにデプロイされたMyTokenコントラクトをRinkebyにデプロイされたMyRinkebyTokenコントラクトにマップする:

node ./gateway-cli.js map-contracts token

extdevにデプロイされたMyCoinコントラクトをRinkebyにデプロイされたMyRinkebyCoinコントラクトにマップする:

node ./gateway-cli.js map-contracts coin

これらのコマンドを実行するとトランスファーゲートウェイはあなたがコントラクの作成者であるか検証しようとし、これは数分かかる。その間に次のステップへ進むことができる。

4. `extdev`アカウントを`Rinkeby`アカウントにマップする

今2つのトークンコントラクトはトランスファーゲートウェイ経由で接続されておりextdevからRinkebyへトークンの転送を開始できるしかし、もしRinkebyからextdevへトークンを転送したい場合extdevアカウントをあなたのRinkebyアカウントに接続する必要がでてくるだろう。

node ./gateway-cli.js map-accounts

グレート、extdevとRinkebyの間での完璧なトークンの転送の準備の全てはできているはず！

5. トークンの転送

`Rinkeby`から`extdev`へ

今、全てのマップしてきたコントラクトとアカウントはトークンとETHをRinkebyのゲートウェイコントラクトに転送できる。

それではERC721トークンのMyRinkebyTokenをいくつか生成する事から始めてみよう、そしてそのうち一つをBasechainに転送してみよう。

# Rinkebyでトークンを生成
node ./gateway-cli.js mint-token 1
node ./gateway-cli.js mint-token 2
node ./gateway-cli.js mint-token 3

# トークンをextdevのBasechainへ転送
node ./gateway-cli.js deposit-token 1

# あなたがRinkebyにトークンをいくつ持っているかをチェックする
node ./gateway-cli.js token-balance -c eth

# あなたがextdevにトークンをいくつ持っているかをチェックする
node ./gateway-cli.js token-balance

# Rinkebyのゲートウェイがトークンをいくつ持っているかをチェックする
node ./gateway-cli.js token-balance -a gateway -c eth

ではERC20トークンのMyRinkebyCoinのいくつかを転送してみよう、それらのうち10億はすでに生成されあなたのアカウントにあるのですぐに転送する事ができる。

# 120トークンをextdevのBasechainに転送する
node ./gateway-cli.js deposit-coin 120

# Rinkebyにいくつトークンを持っているかチェックする
node ./gateway-cli.js coin-balance -c eth

# extdevにいくつトークンを持っているかチェックする
node ./gateway-cli.js coin-balance

# Rinkebyのゲートウェイがいくつトークンを持っているかチェックする
node ./gateway-cli.js coin-balance -a gateway -c eth

`extdev`から`Rinkeby`へ

ERC721トークンはwithdraw-tokenコマンドを使ってRinkebyに送り返す事ができる。

# Rinkebyに転送する
node ./gateway-cli.js withdraw-token 1

# Rinkebyにいくつトークンを持つかチェックする。
node ./gateway-cli.js token-balance -c eth

# extdevにいくつトークンを持つかチェックする。
node ./gateway-cli.js token-balance

# Rinkebyのゲートウェイがいくつトークンを持つかチェックする
node ./gateway-cli.js token-balance -a gateway -c eth

ERC20トークンはwithdraw-coinコマンドを使ってRinkebyに送り返す事ができる。

# 60トークンをRinkebyに転送
node ./gateway-cli.js withdraw-coin 60

# Rinkebyにいくつトークンを持つかチェックする
node ./gateway-cli.js coin-balance -c eth

# extdevにいくつトークンを持つかチェクする
node ./gateway-cli.js coin-balance

# Rinkebyのゲートウェイがいくつトークンを持つかチェックする
node ./gateway-cli.js coin-balance -a gateway -c eth

トラブルシューティング

出金処理の際、ネットワーク問題のため、もしくはgasを使い果たした為にエラーが発生することがある。もしそれが発生した場合は、resume-withdrawalコマンドを使って中断された出金処理を完了してみよう。

node ./gateway-cli.js resume-withdrawal

注: ユーザーごとに保留中の引き出しは1 つだけ許可される。

要約

もしまだチェックしていなければ、Transfer Gateway Example のプロジェクト例を見てみよう。これは loom-js により提供されるトランスファーゲートウェイを使用して構築されている。

# 概要

# 1. トークンコントラクトを extdevにデプロイする

# MyToken ERC721 コントラクト

# MyCoin ERC20 コントラクト

# 2. Rinkebyにトークンコントラクトをデプロイする。

# MyRinkebyToken ERC721 コントラクト

# MyRinkebyCoin ERC20 コントラクト

# 3. extdev コントラクトを Rinkebyコントラクトにマップする

# 4. extdevアカウントをRinkebyアカウントにマップする

# 5. トークンの転送

# Rinkebyからextdevへ

# extdevからRinkebyへ

# トラブルシューティング

# 要約

概要