今回の目標
EthereumのDApp開発のための環境を構築し、TruffleのボイラープレートアプリケーションのひとつMetaCoinを動作させること。
エンジニアの人が集まっているようなので、まずコマンドライン（truffle console）で全て動かし、何をしているかコードレベルで確認します。今回の内容は、EthereumでDAppを作るための基本要素で、千本ノック的に体得するといいです。更の環境から7番まで、1時間かからないでいけるまで頑張りましょう（ニッコリ）
OSなどは各自の環境で違うと思いますが、ここではvagrant上のubuntu16.04でのコンソールの状態を転記しています。
実習
1. NodeJs をインストールしよう
ここに、apt-getなどパッケージマネージャーでのインストール方法が書いてあります。
https://nodejs.org/ja/download/package-manager/
ubuntuでのNode.js のインストール
|
1 2 |
vagrant@ubuntu-xenial:~$ curl -sL https://deb.nodesource.com/setup_8.x | sudo -E bash - vagrant@ubuntu-xenial:~$ sudo apt-get install -y nodejs |
確認
|
1 2 3 4 |
vagrant@ubuntu-xenial:~$ node --version v8.9.4 vagrant@ubuntu-xenial:~$ npm --version 5.6.0 |
2. Truffle をインストールしよう
|
1 |
vagrant@ubuntu-xenial:~$ npm install truffle |
確認
|
1 2 3 |
agrant@ubuntu-xenial:~/MetaCoin$ truffle version Truffle v4.0.6 (core: 4.0.6) Solidity v0.4.19 (solc-js) |
3. Ganache CLIをインストールしよう
Ganache CLIは、以前使っていたtestrpcがTruffle Suiteに取り込まれたものです。UI付きでトランザクションやアカウントの管理が出来るGanacheの、コマンドラインバージョンです。
Ganacheは見た目がとてもきれいで使いやすそうなんですが、今回は時間と環境の制約上CLIバージョンを使用します。
|
1 |
vagrant@ubuntu-xenial:~$ npm install ganache-cli |
4. MetaCoinプロジェクトを作ろう
|
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 |
vagrant@ubuntu-xenial:~$ mkdir MetaCoin vagrant@ubuntu-xenial:~$ cd MetaCoin vagrant@ubuntu-xenial:~/MetaCoin$ vagrant@ubuntu-xenial:~/MetaCoin$ truffle unbox MetaCoin // ボイラープレートのunbox Downloading... Unpacking... Setting up... Unbox successful. Sweet! Commands: Compile contracts: truffle compile Migrate contracts: truffle migrate Test contracts: truffle test vagrant@ubuntu-xenial:~/MetaCoin$ ls contracts migrations test truffle-config.js truffle.js // これらのファイルが出来上がる |
MetaCoinは、truffleのボイラープレート（テンプレのようなもの）として用意してありますので、unboxします。MetaCoin以外にもいろいろあります。http://truffleframework.com/boxes/
contracts/MetaCoin.sol というファイルがContract本体になります。下にコードを掲載します。もう皆さん見飽きていると思いますが、今回確実に動作させて次に参りましょう。
|
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 |
pragma solidity ^0.4.18; import "./ConvertLib.sol"; // This is just a simple example of a coin-like contract. // It is not standards compatible and cannot be expected to talk to other // coin/token contracts. If you want to create a standards-compliant // token, see: https://github.com/ConsenSys/Tokens. Cheers! contract MetaCoin { mapping (address => uint) balances; event Transfer(address indexed _from, address indexed _to, uint256 _value); function MetaCoin() public { balances[tx.origin] = 10000; } function sendCoin(address receiver, uint amount) public returns(bool sufficient) { if (balances[msg.sender] < amount) return false; balances[msg.sender] -= amount; balances[receiver] += amount; Transfer(msg.sender, receiver, amount); return true; } function getBalanceInEth(address addr) public view returns(uint){ return ConvertLib.convert(getBalance(addr),2); } function getBalance(address addr) public view returns(uint) { return balances[addr]; } } |
truffle.jsのコンフィグを書き加えます。
|
1 2 3 4 5 6 7 8 9 10 11 12 |
vagrant@ubuntu-xenial:~/MetaCoin$ vi truffle.js module.exports = { // See <http://truffleframework.com/docs/advanced/configuration> // to customize your Truffle configuration! networks: { development: { host: "127.0.0.1", port: 8545, network_id: "*" // Match any network id } } }; |
5. Ganeche CLIを起動しよう
|
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 |
vagrant@ubuntu-xenial:~$ ganache-cli --seed "hoge" Ganache CLI v6.0.3 (ganache-core: 2.0.2) Available Accounts // アカウントが10個作られます ================== (0) 0xa6d64ba32a163a0bdcd190efa2b504c168c84b92 (1) 0x0d60a77efa2c49dabce96f608d7dfb29d7283d5c (2) 0x19174c5047739126020f990f60fab736964c4092 (3) 0x431784befa2db574c9ce552a72fd501589da4980 (4) 0xbaf8b192c36ba330defcabaf394d6c7ea9d0bc0c (5) 0xf17d3f5f9d59de83012bd63df6288bab1e766b27 (6) 0x1336fa0800ebeadf70ae57142ab3f506e518cf01 (7) 0x0be15ee2e4a042ca2de9687482c8d0fc0db6f4b3 (8) 0xd915b3d49b5051315ea3c9453daf51482a2c8f1b (9) 0x7ec52791cceff62452a7b37db9b9021779423005 Private Keys // 各アカウントの秘密鍵 ================== (0) fc3a422ac4dfb2da6346545448fd3137604b526b705a4f24342e90b1b02fe83f (1) 4428f29d3458f9bc188571a5569b6e752cb46f5108cc3f50542b460df6b04beb (2) 3df2351c3559a5b903d084d940492dc817c6ae3bcc35eb99656ad8dafadd780a (3) 94c6d2d0dab7eafd574fe9e605b19ded376c24dc29d100e7de4030b69feed9f0 (4) 6f155b39e1af81d75d39c0d27427f61c7c6d18e46130b21161a3b48d6a951def (5) 46f366988cafbe70c19b70b7b55a1ac957dc66b2fed76967e0e0858d91025a3c (6) d79931e6be34b1bedf4bc761787382685a7d3df1f5eb282b9e7723e07d99bb07 (7) 028d9861df23f06196e756ddcc4334dc1683b9f6a87c5778ba3cc2b8f9d201a6 (8) 6a741e6c0c595dbd0395e4597bcf1c52b542c508ae82ab46336f1414f6528533 (9) 7a3fbb8c6274315e22aa56371fc514e78291a512a7575415104245eb4cfad54c HD Wallet ================== Mnemonic: fold work embody cross spoil organ push once sibling neutral notice ticket Base HD Path: m/44'/60'/0'/0/{account_index} Listening on localhost:8545 |
6. Contractをマイグレートしよう
|
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 |
vagrant@ubuntu-xenial:~/MetaCoin$ truffle migrate Compiling ./contracts/ConvertLib.sol... Compiling ./contracts/MetaCoin.sol... Compiling ./contracts/Migrations.sol... Writing artifacts to ./build/contracts Using network 'development'. Running migration: 1_initial_migration.js Deploying Migrations... ... 0x2a363773e43ba7bf59c74ab3e1ffff0af5179aaad277dd09585078c93cba77a2 Migrations: 0xee0b6b8d267573b056cf582a3d2c34b30b77f01b Saving successful migration to network... ... 0x71c714e20670249abfda90669de28673e624e352a2733aae446740f511222136 Saving artifacts... Running migration: 2_deploy_contracts.js Deploying ConvertLib... ... 0xf451e89eaf052210720edad9ea215eef4e8934df16901091509087326e23b361 ConvertLib: 0x59aa4028b4070d379e614f1bf9f490f4ebfd2b08 Linking ConvertLib to MetaCoin Deploying MetaCoin... ... 0xa865e4bb3c11516cdb928dd6bba8dd2250dcbe7d602370a58944d2750a4a1af0 MetaCoin: 0x6778b34c62b77ff66fd54ae3cb741239eff1edeb Saving successful migration to network... ... 0x963150ab31b4d266e0a5f36d8369b27721e0d1de6f5aa20f1d7e815a3a997d3f Saving artifacts... |
7. truffle console でMetaCoinを動かそう
truffle consoleを起動します。
|
1 |
vagrant@ubuntu-xenial:~/MetaCoin$ truffle console |
ganache-cliがアカウントを10個用意してくれています。そのうちの2つでMetaCoinをやり取りしてみます。
|
1 2 3 4 5 6 7 8 9 10 11 12 |
truffle(development)> var account1 = web3.eth.accounts[0] // アカウントひとつめ undefined truffle(development)> var account2 = web3.eth.accounts[1] // アカウントふたつめ undefined truffle(development)> account1 '0xa6d64ba32a163a0bdcd190efa2b504c168c84b92' truffle(development)> account2 '0x0d60a77efa2c49dabce96f608d7dfb29d7283d5c' truffle(development)> web3.eth.coinbase // coinbase(マイニングの報酬受け取りアドレス)はアカウント1 '0xa6d64ba32a163a0bdcd190efa2b504c168c84b92' truffle(development)> web3.eth.blockNumber // 現在のブロック高は5 5 |
現在のETH残高を確認。
|
1 2 3 4 |
truffle(development)> web3.eth.getBalance(account1).toNumber() 99922922500000000000 // coinbaseのアカウントは、マイグレートしたときの使用Gas分減少している truffle(development)> web3.eth.getBalance(account2).toNumber() 100000000000000000000 |
deployされたMetaCoinをインスタンス化。
|
1 2 3 4 5 6 |
truffle(development)> var meta; undefined truffle(development)> MetaCoin.deployed().then(function(instance) { meta = instance; }) undefined truffle(development)> meta.address '0x6778b34c62b77ff66fd54ae3cb741239eff1edeb' // migrate したとき表示されたContractアドレス |
ContractのgetBalanceメソッドを呼び出して、送金前のMetaCoin残高を確認。これは、Ethereumの“Call”になります。→ CallとTransactionの違い
|
1 2 3 4 5 6 7 8 9 10 |
truffle(development)> var balance1, balance2 undefined truffle(development)> meta.getBalance.call(account1).then(function(result) { balance1 = result.toNumber(); }) undefined truffle(development)> meta.getBalance.call(account2).then(function(result) { balance2 = result.toNumber(); }) undefined truffle(development)> balance1 10000 // アカウント1は10000metacoin truffle(development)> balance2 0 // アカウント2は0 |
contarctのsendCoinメソッドを呼び出してMetaCoinをアカウント1からアカウント2へ送金。これはEthereumの“Transaction”になります。→ CallとTransactionの違い
|
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 |
truffle(development)> meta.sendCoin(account2, 100, {from: account1}) { tx: '0x8bce3f1ff84e38c3cd867848cf83abd0f1519db6a9323eff66bd602b7220935f', receipt: { transactionHash: '0x8bce3f1ff84e38c3cd867848cf83abd0f1519db6a9323eff66bd602b7220935f', transactionIndex: 0, blockHash: '0xc67e425f8eef41de8d5701d0af81a26e93d54b3edacb3960179f977ccf2a646e', blockNumber: 6, gasUsed: 50960, cumulativeGasUsed: 50960, contractAddress: null, logs: [ [Object] ], // ここは、ブロックチェーンから返ってきたトランザクションレシートです status: 1 }, logs: [ { logIndex: 0, transactionIndex: 0, transactionHash: '0x8bce3f1ff84e38c3cd867848cf83abd0f1519db6a9323eff66bd602b7220935f', blockHash: '0xc67e425f8eef41de8d5701d0af81a26e93d54b3edacb3960179f977ccf2a646e', blockNumber: 6, address: '0x6778b34c62b77ff66fd54ae3cb741239eff1edeb', type: 'mined', event: 'Transfer', args: [Object] } ] } |
送金後のETH、MetaCoin残高を確認
|
1 2 3 4 5 6 7 8 9 10 11 12 13 14 |
truffle(development)> web3.eth.getBalance(account1).toNumber() 99917826500000000000 // coinbaseはトランザクション実行をしたためGas分を消費 truffle(development)> web3.eth.getBalance(account2).toNumber() 100000000000000000000 truffle(development)> meta.getBalance.call(account1).then(function(result) { balance1 = result.toNumber(); }) undefined truffle(development)> meta.getBalance.call(account2).then(function(result) { balance2 = result.toNumber(); }) undefined truffle(development)> balance1 9900 // 100metacoin送金したので、9900metacoinになった truffle(development)> balance2 100 // 100metacoinになっている truffle(development)> web3.eth.blockNumber 6 // Transactionを実行したので、ブロック高が増えている |
truffle console を終了。
|
1 |
truffle(development)> .exit |
8. CallとTransactionの違い
Ethreumブロックチェーンに対してクライアントから送る指示には、CallとTransactionがあります。違いは次のようになります。
Call
- Gasを使用しない
- ネットワークの状態を変えない
- すぐに処理される
- 値を返す
Transaction
- Gasを使用する
- ネットワークの状態を変化させる
- マイニングされるまで処理されない
- Transaction IDを返す
演習
Metacoin.solのメソッド getBalanceInEth を truffle console から実行して、結果を確認してみよう。