チェーンコードの作成
チェーンコードは、Go、Node.jsまたはJavaで記述し、Oracle Blockchain PlatformネットワークにインストールされるZIPファイルにパッケージ化します。
チェーンコードは、レジャーのデータ・スキーマの定義、初期化、アプリケーションによってトリガーされたときの更新の実行、および問合せへの対応を行います。また、チェーンコードでは、アプリケーションの通知を可能にするイベントのポストや、ダウンストリーム操作の実行もできます。たとえば、チェーンコードで発注書、請求書および納品記録を照合した後にイベントをポストし、サブスクライブ・アプリケーションが関連する支払いを処理して内部ERPシステムを更新できるようにします。
チェーンコード開発のためのリソース
Oracle Blockchain Platformは、Hyperledger Fabricを基盤として使用します。Hyperledger Fabricドキュメントを使用すると、有効なチェーンコードの作成に役立ちます。
-
「Welcome to Hyperledger Fabric」。独自のチェーンコードを作成する前に、主な概念とチュートリアルの項を参照してください。
-
「Go Programming Language」。Goコンパイラ、ツールおよびライブラリには、チェーンコードの作成を簡略化する様々なリソースが用意されています。
-
「Package shim」。パッケージshimには、チェーンコードが状態変数やトランザクション・コンテキストにアクセスし、他のチェーンコードをコールするためのAPIが用意されています。ここでは、チェーンコードに必要な実際の構文について説明します。
Oracle Blockchain Platformには、チェーンコードおよびアプリケーションの作成方法を理解するために役立つダウンロード可能なサンプルが用意されています。「チェーンコード・サンプルとは」を参照してください。
チェーンコードにリッチ問合せ構文を追加して、状態データベースを問合せできます。「SQLリッチ問合せ構文」および「CouchDBリッチ問合せ構文」を参照してください。
Goチェーンコードのパッケージ化とZip
チェーンコードを作成したら、ZIPファイルに入れます。Goチェーンコードのパッケージを作成したり、署名する必要はありません。Oracle Blockchain Platformのインストールおよびデプロイメント・プロセスは、「チェーンコードをデプロイするための一般的なワークフロー」(Hyperledger Fabric v2.x)または「チェーンコードをデプロイするための一般的なワークフロー」(Hyperledger Fabric v1.4.7)の説明に従って実行します。
チェーンコードに外部依存関係がある場合は、ZIPファイルのベンダー・ディレクトリに配置します。
GoチェーンコードのShimのベンダー(Hyperledger Fabric v2.x)
以前のバージョンのHyperledger Fabricに含まれていたGoチェーンコードshim依存関係は、Hyperledger Fabric v2.xには含まれていません。Hyperledger Fabric v2.xを実行しているピアにインストールする前に、Goチェーンコードにshimをベンダー化(インポート)する必要があります。
Goモジュールまたはgovendorなどのサードパーティ・ツールを使用して、チェーンコードshimをベンダー化し、Hyperledger Fabric v2.xで動作するバージョンに更新できます。
詳細は、Hyperledger Fabricドキュメントのチェーンコード・シム変更(チェーンコードのみ実行)およびベンダー・シムによるチェーンコードのアップグレードを参照してください。Goモジュールの詳細は、Goモジュール・リファレンスを参照してください。
Node.jsチェーンコードのパッケージ化とZip
package.json
ファイルを作成する必要があります:
-
scripts
セクションでは、チェーンコードの起動方法を宣言します。 -
dependencies
セクションでは、依存関係を指定します。
次に、Node.jsチェーンコードのpackage.json
のサンプルを示します。
{
"name": "chaincode_example02",
"version": "1.0.0",
"description": "chaincode_example02 chaincode implemented in Node.js",
"engines": {
"node": ">=8.4.0",
"npm": ">=5.3.0"
},
"scripts": { "start" : "node chaincode_example02.js" },
"engine-strict": true,
"license": "Apache-2.0",
"dependencies": {
"fabric-shim": "~1.3.0"
}
}
package.json
はルート・ディレクトリに置く必要があります。- エントリJavaScriptファイルは、パッケージ内の任意の場所に配置できます。
"start" : "node <start>.js"
がpackage.json
で指定されていない場合、server.js
はルート・ディレクトリにある必要があります。
チェーンコードおよびパッケージ・ファイルをZIPファイルに入れてOracle Blockchain Platformにインストールします。
Javaチェーンコードのパッケージ化とZip
Javaチェーンコードを作成している場合は、GradleまたはMavenを選択してチェーンコードをビルドできます。
Archive: example_gradle.zip Length Date Time Name --------- ---------- ----- ---- 610 02-14-2019 01:36 build.gradle 54 02-14-2019 01:28 settings.gradle 0 02-14-2019 01:28 src/ 0 02-14-2019 01:28 src/main/ 0 02-14-2019 01:28 src/main/java/ 0 02-14-2019 01:28 src/main/java/org/ 0 02-14-2019 01:28 src/main/java/org/hyperledger/ 0 02-14-2019 01:28 src/main/java/org/hyperledger/fabric/ 0 02-14-2019 01:28 src/main/java/org/hyperledger/fabric/example/ 5357 02-14-2019 01:28 src/main/java/org/hyperledger/fabric/example/SimpleChaincode.java --------- ------- 6021 10 files
Archive: example_maven.zip Length Date Time Name --------- ---------- ----- ---- 3313 02-14-2019 01:52 pom.xml 0 02-14-2019 01:28 src/ 0 02-14-2019 01:28 src/chaincode/ 0 02-14-2019 01:28 src/chaincode/example/ 4281 02-14-2019 01:28 src/chaincode/example/SimpleChaincode.java --------- ------- 7594 5 files
チェーンコードのテスト
チェーンコードを作成したら、テストする必要があります。関連項目:
チェーンコードのインストールおよびデプロイ
チェーンコードをテストしたら、「チェーンコードをデプロイするための一般的なワークフロー」 (Hyperledger Fabric v2.x)または「チェーンコードをデプロイするための一般的なワークフロー」 (Hyperledger Fabric v1.4.7)の情報に従ってデプロイできます。
チェーンコードのアップグレード
デプロイされたチェーンコードは、「チェーンコードのアップグレード」(Hyperledger Fabric v2.x)または「チェーンコードのアップグレード」(Hyperledger Fabric v1.4.7)のステップに従ってアップグレードできます。