2019年1月26日(土) ブロックチェーン体験会のハンズオン資料です。

1. Hands-On Blockchain
2019-01-26 Shonan Campus | Tokai University
Hyperledger Fabric & Hyperledger Composer with IBM Cloud
2019/1/26 Kohei Nishikawa 1

2. 作るもの
• 講座別の成績管理ブロックチェーン
• モデル定義の設計
種別 名称 項目 データ項目名 メモ
asset yourCourse 講座名 name
講座別 学生識別ID your_courseId
日付 Date
ポイント point 出席なら1ポイント
participant Customer 学籍番号 customerId
姓 lastName
名 firstName
Transaction PointUpdate your_courseId from AssetのyourCourceから、
your_courseId を引っ張る
ポイント加算日 Date
加算ポイント point
2019/1/26 Kohei Nishikawa 2

3. 作るもの
• 講座別の成績管理ブロックチェーン
• ロジックの設計
• 講座別 学生識別ID に対して、ポイント加算と加算日をトランザクションとして処理
学生Aの講座名 Blockchain 成績
学生Bの講座名 IoT入門 成績
1月24日 1月31日
出席 1ポイント
現在 6ポイント
2019/1/26 Kohei Nishikawa 3

4. 演習端末
• 演習用端末
• インターネットに接続できること
• Webブラウザ：Google Chrome シークレットウィンドウを推奨
• 画面：10.1インチ以上のPC、Mac、タブレット
• Google Chrome シークレットウィンドウの出し方
• Google Chromeを起動し、画面右上からアクセス
シークレット
ウィンドウは
虫眼鏡が表示
2019/1/26 Kohei Nishikawa 4

5. 演習環境
(1) IBM公式版
https://composer-playground.mybluemix.net/
(2) 自作環境
http://localhost:8080
Hyperledger Composerのチュートリアル
を元に構築できます。
最初の画面はどちらも
一緒です。
Let’s Blockchain!
をクリック
2019/1/26 Kohei Nishikawa 5
https://hyperledger.github.io/com
poser/latest/installing/developme
nt-tools.html

6. 演習環境の違い
(1) IBM公式版
https://composer-playground.mybluemix.net/
(2) 自作環境
http://localhost:8080
Deploy a new
business network
をクリック
クリックして、ブロック
チェーン作成画面へ。
Deploy a new
business network
をクリック
画面を下に移動し、
「Connection:Web Browser」と
表示されている位置まで移動。
2019/1/26 Kohei Nishikawa 6

7. ビジネスネットワーク作成
② 英数字で名称を
入力
③ admin@の後に上記
で入力した名称を入力
例 1st-blockchain
例 admin@1st-blockchain
①テンプレートでは、empty-
business-networkを選択
④ Deployをクリック
2019/1/26 Kohei Nishikawa 7

8. ビジネスネットワークの確認
作成したビジネス
ネットワーク
この中でブロック
チェーンを作る
⑤ Connect Nowを
クリック
ここで、ブロック
チェーンを開発、
テストができる
⑥ Model Fileを
クリック
2019/1/26 Kohei Nishikawa 8

9. モデル定義ファイルの編集
ファイルが消える
ので触れない！
⑦これと同じ内
容に書き換える
2019/1/26 Kohei Nishikawa 9

10. モデル定義
namespace org.handson
//モノ
asset yourCourse identified by your_courseId {
o String your_courseId
--> Customer owner
o String name
o String Date
o Double point
}
//人
participant Customer identified by customerId {
o String customerId
o String firstName
o String lastName
}
//トランザクション
transaction PointUpdate {
--> yourCourse from
o String Date
o Double point
}
種別 名称 データ項目名
asset yourCourse name
your_courseId
Date
point
participant Customer customerId
lastName
firstName
Transaction PointUpdate from
Date
point
2019/1/26 Kohei Nishikawa 10
https://bitbucket.org/kolinzlabs/handson-
material/src/master/tokaiuniv/blockchain1/models/model.cto
このURLにアクセス
してコピーしてもOK

11. ロジック定義ファイルを追加
⑧ Add a file を
クリック
⑨ Script File(js)
を選択
⑩ Add をクリック
2019/1/26 Kohei Nishikawa 11

12. ロジック定義ファイルの編集
Script File が選
ばれている
⑪ これと同じ内容
に書き換える
2019/1/26 Kohei Nishikawa 12

13. ロジック定義
/**
* @param {org.handson.PointUpdate} pointupdate
* @transaction
*/
function pointupdate(pointupdate) {
pointupdate.from.Date = pointupdate.Date;
pointupdate.from.point += pointupdate.point;
return getAssetRegistry('org.handson.yourCourse')
.then (function (assetRegistry) {
return assetRegistry.update(pointupdate.from);
})
.then (function () {
return getAssetRegistry('org.handson.yourCourse');
});
}
2019/1/26 Kohei Nishikawa 13
https://bitbucket.org/kolinzlabs/handson-
material/src/master/tokaiuniv/blockchain
1/lib/script.js
このURLにアクセス
してコピーしてもOK

14. 動作確認 (1) : participantの新規登録
⑫ Deploy changes
をクリック
問題なければ、このような
メッセージが表示される
⑬ Test をクリック
⑭ Create New Participant
をクリック
2019/1/26 Kohei Nishikawa 14

15. 動作確認 (2)
⑮ 右の表をもとに自分の学籍
番号と姓、名を入力します。
⑯ Create New をクリック
項目名 入力内容 (原則 英数字)
customerId 学籍番号
firstName 名
lastName 姓
⑰ 登録情報を確認
編集
削除
追加登録
2019/1/26 Kohei Nishikawa 15

16. 動作確認 (3) : assetの新規登録
⑱ yourCourse を
クリック ⑲ Create New Asset
をクリック
2019/1/26 Kohei Nishikawa 16

17. 動作確認 (4)
⑳ 右の表をもとに受講中の
講座の識別情報を入力します。
項目名 入力値 (原則 英数字) 備考
your_courseId 講座におけるownerの識別ID
owner resource:org.handson.Custom
er#の後に、先ほど登録した学籍
番号に書き換え
name 講座名
Data 更新日 最初は空白
point 最初は、0 出席で1ポイ
ント加算
㉑ Create New をクリック
㉒ 登録情報を確認
2019/1/26 Kohei Nishikawa 17

18. 動作確認 (5) : トランザクション実行
㉓ Submit Transaction
をクリック
項目名 入力内容 (原則 英数字)
from resource:org.handson.
yourCourse#の後を、先
ほど登録した「your_
courseId」に書き換え
Date “YYYY-MM-DD”
例 “2019-01-24”
point 1
㉔ 右の表をもとにポイント
を加算するための値を入力
㉕ Submit をクリック
2019/1/26 Kohei Nishikawa 18

19. 動作確認 (6) : トランザクション結果
㉖ 日付が変更され、ポイントが
増えていることを確認
㉗ 日付とポイントを確認したら、
「All Transactions」をクリック
2019/1/26 Kohei Nishikawa 19

20. 動作確認 (7) : トランザクション履歴
㉘ トランザクション(取引 , データ処理)履歴
が表示されている
㉙ PointUpdateのトランザクションを確認
「view record」をクリック
㉚ fromの「your_courseId」
に対して、2019年1月24日に、
1ポイント加算したことが記録
されている
2019/1/26 Kohei Nishikawa 20

21. Export
2019/1/26 Kohei Nishikawa 21
作成したビジネスネットワーク
を保存するために、「Export」
をクリック
bna形式として保存
開発を途中で止めるときは、
Export機能を用いて、bna
ファイルとして出力します。

22. Import
2019/1/26 Kohei Nishikawa 22
ビジネスネットワーク
作成画面で、bnaファイ
ルをアップロード
Deployをクリック
「Export」で出力したbnaファイル
を、Importすることで、続きから
ブロックチェーンの開発を再開す
ることができます。

23. 参考資料
2019/1/26 Kohei Nishikawa 23
IBM Developer
https://developer.ibm.com/jp/technologies/blockchain/
Hyperledger Composer
https://hyperledger.github.io/composer/latest/
Hyperledger Fabric
https://hyperledger-fabric.readthedocs.io/en/release-1.4/whatis.html