Ethereumのフレームワークtruffleの使い方を徹底紹介していきたいと思います。
Contents
truffleとは
truffleはEthereum Virtual Marchine(EVM)を使用した、Ethereum開発のための、開発、テストのフレームワークであり、開発ライフを簡単にすることを目標に作られています。
<スポンサードリンク>
なぜtruffleか
truffleを使うことで、Ethereum開発を円滑に進めることができます。
具体的には、下記のような機能が提供されています。
・単体テストフレームワーク
・コマンドでのデプロイ
・ERC190規格を使用した、EthPM&NPMによるパッケージ管理。
・コンソールでのtransactionの発行、デプロイ
・外部スクリプトランナー
※他にもいくつかありますが、主要なものをあげています。
truffleのインストール
下記のコマンドでインストールできます。
※NodeJSが入っている前提で、NodeJSのバージョンは5以上が推奨されています。
% npm install -g truffle
truffleでプロジェクトを作成
次のプロジェクトを作成したいと思います。
今回はテスト用のプロジェクトを作成します。
% mkdir testpj % cd testpj % truffle init Downloading... Unpacking... Setting up... Unbox successful. Sweet! Commands: Compile: truffle compile Migrate: truffle migrate Test contracts: truffle test
早速ですが、テスト用のプロジェクトを作成してみました。
initというコマンドでtruffle開発のテンプレートを作ってくれます。
具体的には、下記のようなディレクトリとファイルを作ってくれています。
% tree . ├── contracts │ └── Migrations.sol ├── migrations │ └── 1_initial_migration.js ├── test ├── truffle-config.js └── truffle.js 3 directories, 4 files
上からsolファイルを配置するcontractsディレクトリと、migrationファイルを配置するmigrationsディレクトリとtestファイルを配置するtestディレクトリです。
truffle-config.jsには、諸々の設定、truffle.jsには、デプロイするネットワークの設定などを書いていきます。
<スポンサードリンク>
デプロイ
まず、truffle.jsにデプロイ先の情報を記述します。
今回は、ローカルにデプロイするので、下記のような設定にしますが、クラウド環境等にデプロイする際も、基本は同じです。
module.exports = { networks: { development: { host: "127.0.0.1", port: 8545, network_id: "*" // Match any network id } } };
次にdevelopment環境のコンソールに入ります。
dev環境用のaccountやprivateKeyは用意してくれます。
% truffle development Truffle Develop started at http://127.0.0.1:9545/ Accounts: (0) 0x627306090abab3a6e1400e9345bc60c78a8bef57 (1) 0xf17f52151ebef6c7334fad080c5704d77216b732 (2) 0xc5fdf4076b8f3a5357c5e395ab970b5b54098fef (3) 0x821aea9a577a9b44299b9c15c88cf3087f3b5544 (4) 0x0d1d4e623d10f9fba5db95830f7d3839406c6af2 (5) 0x2932b7a2355d6fecc4b5c0b6bd44cc31df247a2e (6) 0x2191ef87e392377ec08e7c08eb105ef5448eced5 (7) 0x0f4f2ac550a1b4e2280d04c21cea7ebd822934b5 (8) 0x6330a553fc93768f612722bb8c2ec78ac90b3bbc (9) 0x5aeda56215b167893e80b4fe645ba6d5bab767de Private Keys: (0) c87509a1c067bbde78beb793e6fa76530b6382a4c0241e5e4a9ec0a0f44dc0d3 (1) ae6ae8e5ccbfb04590405997ee2d52d2b330726137b875053c36d94e974d162f (2) 0dbbe8e4ae425a6d2687f1a7e3ba17bc98c673636790f1b8ad91193c05875ef1 (3) c88b703fb08cbea894b6aeff5a544fb92e78a18e19814cd85da83b71f772aa6c (4) 388c684f0ba1ef5017716adb5d21a053ea8e90277d0868337519f97bede61418 (5) 659cbb0e2411a44db63778987b1e22153c086a95eb6b18bdf89de078917abc63 (6) 82d052c865f5763aad42add438569276c00d3d88a2d062d36b2bae914d58b8c8 (7) aa3680d5d48a8283413f7a108367c7299ca73f553735860a87b08f39395618b7 (8) 0f62d96d6675f32685bbdb8ac13cda7c23436f63efbb9d07700d8669ff12b7c4 (9) 8d5366123cb560bb606379f90a0bfd4769eecc0557f1b362dcae9012b548b1e5 Mnemonic: candy maple cake sugar pudding cream honey rich smooth crumble sweet treat ⚠️ Important ⚠️ : This mnemonic was created for you by Truffle. It is not secure. Ensure you do not use it on production blockchains, or else you risk losing funds.
コンソールに入った後、migrateコマンドを打つことで、migrationファイルに沿って、dev環境にコントラクトがデプロイされます。
truffle(develop)> migrate --reset Using network 'develop'. Running migration: 1_initial_migration.js Deploying Migrations... ... 0x2794404958d5efa110f78bd43d0469e4e542de0135259b44899d04238452b756 Migrations: 0x8cdaf0cd259887258bc13a92c0a6da92698644c0 Saving successful migration to network... ... 0xd7bc86d31bee32fa3988f1c1eabce403a1b5d570340a3a9cdba53a472ee8c956 Saving artifacts...
テスト
先ほどのコンソール内で、testコマンドを打つと、全テストを流してくれます。ファイルを指定してそのファイルのテストだけ流すこともできます。
truffle(develop)> test Using network 'develop'. 0 passing (1ms)
今はテストがないので、0件ですが、test/ 直下にあるファイルのテストを実行できます。
【参考】参考用プロジェクトのunbox
truffleを使ってみるにあたって、なにか参考にされたい方もいると思います。
truffleには、すでに参考になるようなプロジェクトがいくつか用意されており、
「unbox」というコマンドで、ローカルにプロジェクトをダウンロードすることができます。
今回は、「Metacoin」というプロジェクトをunboxしてみようと思います。
% mkdir metacoin % cd metacoin % truffle unbox metacoin Downloading... Unpacking... Setting up... Unbox successful. Sweet! Commands: Compile contracts: truffle compile Migrate contracts: truffle migrate Test contracts: truffle test
unboxすることで、ローカルに下記のようなディレクトリがダウンロードされています。
% ls contracts test truffle.js migrations truffle-config.js
すでに動くプログラムなので、かなり実装の参考になると思います。
他のサンプルが欲しい方も下記のurlにのっているので、ぜひどうぞ!
https://truffleframework.com/boxes
もちろんmigrateもtestも動きます!
% truffle development Truffle Develop started at http://127.0.0.1:9545/ Accounts: (0) 0x627306090abab3a6e1400e9345bc60c78a8bef57 (1) 0xf17f52151ebef6c7334fad080c5704d77216b732 (2) 0xc5fdf4076b8f3a5357c5e395ab970b5b54098fef (3) 0x821aea9a577a9b44299b9c15c88cf3087f3b5544 (4) 0x0d1d4e623d10f9fba5db95830f7d3839406c6af2 (5) 0x2932b7a2355d6fecc4b5c0b6bd44cc31df247a2e (6) 0x2191ef87e392377ec08e7c08eb105ef5448eced5 (7) 0x0f4f2ac550a1b4e2280d04c21cea7ebd822934b5 (8) 0x6330a553fc93768f612722bb8c2ec78ac90b3bbc (9) 0x5aeda56215b167893e80b4fe645ba6d5bab767de Private Keys: (0) c87509a1c067bbde78beb793e6fa76530b6382a4c0241e5e4a9ec0a0f44dc0d3 (1) ae6ae8e5ccbfb04590405997ee2d52d2b330726137b875053c36d94e974d162f (2) 0dbbe8e4ae425a6d2687f1a7e3ba17bc98c673636790f1b8ad91193c05875ef1 (3) c88b703fb08cbea894b6aeff5a544fb92e78a18e19814cd85da83b71f772aa6c (4) 388c684f0ba1ef5017716adb5d21a053ea8e90277d0868337519f97bede61418 (5) 659cbb0e2411a44db63778987b1e22153c086a95eb6b18bdf89de078917abc63 (6) 82d052c865f5763aad42add438569276c00d3d88a2d062d36b2bae914d58b8c8 (7) aa3680d5d48a8283413f7a108367c7299ca73f553735860a87b08f39395618b7 (8) 0f62d96d6675f32685bbdb8ac13cda7c23436f63efbb9d07700d8669ff12b7c4 (9) 8d5366123cb560bb606379f90a0bfd4769eecc0557f1b362dcae9012b548b1e5 Mnemonic: candy maple cake sugar pudding cream honey rich smooth crumble sweet treat ⚠️ Important ⚠️ : This mnemonic was created for you by Truffle. It is not secure. Ensure you do not use it on production blockchains, or else you risk losing funds. truffle(develop)> migrate --reset Compiling ./contracts/ConvertLib.sol... Compiling ./contracts/MetaCoin.sol... Compiling ./contracts/Migrations.sol... Writing artifacts to ./build/contracts Using network 'develop'. Running migration: 1_initial_migration.js Deploying Migrations... ... 0xfdea7d036b462e79fd9a99022a618bff388a036e203777d2b994069c09dc42b7 Migrations: 0x8cdaf0cd259887258bc13a92c0a6da92698644c0 Saving successful migration to network... ... 0xd7bc86d31bee32fa3988f1c1eabce403a1b5d570340a3a9cdba53a472ee8c956 Saving artifacts... Running migration: 2_deploy_contracts.js Deploying ConvertLib... ... 0x76c6d1c54913471cf59646735bf15223cc4aaa4093c923b40db408822d0d4dbd ConvertLib: 0x345ca3e014aaf5dca488057592ee47305d9b3e10 Linking ConvertLib to MetaCoin Deploying MetaCoin... ... 0x9e0ca8aa773223d485f337b858e18f429e6b565caef5aa99659c34444d641c3d MetaCoin: 0xf25186b5081ff5ce73482ad761db0eb0d25abfbf Saving successful migration to network... ... 0x059cf1bbc372b9348ce487de910358801bbbd1c89182853439bec0afaee6c7db Saving artifacts... truffle(develop)> test Using network 'develop'. Compiling ./contracts/ConvertLib.sol... Compiling ./contracts/MetaCoin.sol... Compiling ./test/TestMetacoin.sol... Compiling truffle/Assert.sol... Compiling truffle/DeployedAddresses.sol... TestMetacoin ✓ testInitialBalanceUsingDeployedContract (139ms) ✓ testInitialBalanceWithNewMetaCoin (304ms) Contract: MetaCoin ✓ should put 10000 MetaCoin in the first account ✓ should call a function that depends on a linked library (45ms) ✓ should send coin correctly (271ms) 5 passing (2s)
関連
Ethereum Solidityの最強の開発環境を構築 これだけ!
【solidity】業務ロジックとデータロジックを分断するコントラクト設計
【初心者向け】solidity基礎 modifierの使い方を徹底解説
【初心者向け】Solidity 外部コントラクトの呼び出し方法を徹底解説
Solidity(Remix)とgitを連携させ、Ethereumの開発をする
Ethereum プライベートネットワークでgeth起動時にnodeを自動接続する方法