EOS 学習メモ：トークンお試し編

EOS 学習メモ：コントラクト実行権限編 の続き。

今回は ココ に用意されている token contract を用いる。コードは触った後で読もうと思うけど、これが Ethereum で言うところの ERC20 みたいな標準規格に則った実装なのかな？後で調べよう。

まずは token contract を GitHub から落としてくる（前にまだ git をインストールしていなかったので、先にしておく）。

 $ apt install git -y
 $ cd /tmp/contracts
 $ git clone https://github.com/EOSIO/eosio.contracts --branch v1.4.0 --single-branch

token 用の account をつくる。

 $ cleos create account eosio eosio.token EOS6MRyAjQq8ud7hVNYcfnVPJqcVpscN5So8BhtHuGYqET5GDW5CV

token contract をコンパイルする。こないだは -I オプションをつけなかったが、今回はヘッダファイルが分割されて include ディレクトリ下に配置されており、これを src ディレクトリ下の contract が include しているため、つけてコンパイラに教えてあげる必要がある。

 $ cd eosio.contracts/eosio.token
 $ eosio-cpp -I include -o eosio.token.wasm src/eosio.token.cpp --abigen

デプロイする。

 $ cleos set contract eosio.token . --abi eosio.token.abi -p eosio.token@active
 Reading WASM from /tmp/contracts/eosio.contracts/eosio.token/eosio.token.wasm...
 Publishing contract...
 executed transaction: 88c44241a05c85cdc7d5ac416562f8352f2fc3f6055d3573126af93d0a966a7d  9304 bytes  68415 us
 #         eosio <= eosio::setcode               {"account":"eosio.token","vmtype":0,"vmversion":0,"code":"0061736d0100000001aa011c60037f7e7f0060047f...
 #         eosio <= eosio::setabi                {"account":"eosio.token","abi":"0e656f73696f3a3a6162692f312e310008076163636f756e7400010762616c616e63...

シンボルと総発行量を指定してトークンを生成する（まだ発行ではない）。issuer（トークンに関する管理系操作を行える特権 account 的な位置付けらしい）には eosio を指定。総発行量とシンボルに関しては、Bitcoin への愛を込めて 21000000.0000 LOVE とする。

 $ cleos push action eosio.token create '[ "eosio", "21000000.0000 LOVE"]' -p eosio.token@active
 executed transaction: bc4c72bc65dabb0c58d8e2b026b630f6046604ed1406b8e44342459906b5b99c  120 bytes  1479 us
 #   eosio.token <= eosio.token::create          {"issuer":"eosio","maximum_supply":"21000000.0000 LOVE"}

issuer である eosio から、こないだつくった alice に対して 1 LOVE 発行する。

 $ cleos push action eosio.token issue '[ "alice", "1.0000 LOVE", "congrats!" ]' -p eosio@active
 executed transaction: 1c27b782ec77a195f5063a2c897e42de5657766de34d4193c2b0a2824c0a3ca5  128 bytes  20257 us
 #   eosio.token <= eosio.token::issue           {"to":"alice","quantity":"1.0000 LOVE","memo":"congrats!"}
 #   eosio.token <= eosio.token::transfer        {"from":"eosio","to":"alice","quantity":"1.0000 LOVE","memo":"congrats!"}
 #         eosio <= eosio.token::transfer        {"from":"eosio","to":"alice","quantity":"1.0000 LOVE","memo":"congrats!"}
 #         alice <= eosio.token::transfer        {"from":"eosio","to":"alice","quantity":"1.0000 LOVE","memo":"congrats!"}

issue action の中で transfer action が実行されているので、transfer action 関連のログも出力されている。issue action は transfer action を実行しなければならないわけではないが、全ての account の残高は transfer action だけから算出できた方がよいよね、などの基本方針の下、実行するようにしているらしい。

なお、ブロードキャストせずにどんなトランザクションになるか確認したい場合は -d オプション（don't broadcast）と -j オプション（return transaction as json）をつければよいよとのこと。

 $ cleos push action eosio.token issue '[ "alice", "1.0000 LOVE", "congrats!" ]' -p eosio@active -d -j
 {
   "expiration": "2019-01-30T18:44:25",
   "ref_block_num": 63138,
   "ref_block_prefix": 183074369,
   "max_net_usage_words": 0,
   "max_cpu_usage_ms": 0,
   "delay_sec": 0,
   "context_free_actions": [],
   "actions": [{
       "account": "eosio.token",
       "name": "issue",
       "authorization": [{
           "actor": "eosio",
           "permission": "active"
         }
       ],
       "data": "0000000000855c341027000000000000044c4f564500000009636f6e677261747321"
     }
   ],
   "transaction_extensions": [],
   "signatures": [
     "SIG_K1_KkSnFjeVF8gwoAMYJUCPtRxQc7Xd5aBVdbzsFVPXyy8iMuojHiUmgShza3gra4HDwxg9CkxBsQp2kRtHNB4B47XyfVyEqF"
   ],
   "context_free_data": []
 }

さて。発行はできたようなので、試しに alice から bob に 0.1 LOVE を送ってみる。

 $ cleos push action eosio.token transfer '[ "alice", "bob", "0.1000 LOVE", "so cool" ]' -p alice@active
 executed transaction: 9738c14c36a7963b100d6e007ee88c6b57f2ef16e64897230d122d43acbb4f85  136 bytes  3621 us
 #   eosio.token <= eosio.token::transfer        {"from":"alice","to":"bob","quantity":"0.1000 LOVE","memo":"so cool"}
 #         alice <= eosio.token::transfer        {"from":"alice","to":"bob","quantity":"0.1000 LOVE","memo":"so cool"}
 #           bob <= eosio.token::transfer        {"from":"alice","to":"bob","quantity":"0.1000 LOVE","memo":"so cool"}

alice と bob の残高を確認する。

 $ root@55c05f196687:/tmp/contracts/eosio.contracts/eosio.token# cleos get currency balance eosio.token alice LOVE
 0.9000 LOVE
 $ root@55c05f196687:/tmp/contracts/eosio.contracts/eosio.token# cleos get currency balance eosio.token bob LOVE
 0.1000 LOVE

alice はもともと 1 LOVE 保有していて 0.1 LOVE を bob に送ったわけなので、想定通りである。めでたし。

今回はここまで。