1.1　本ドキュメントのねらい

　網羅的に技術全般を扱う一般的な公式ドキュメントとは異なり、本ドキュメントは、すばやくSymbolブロックチェーンを活用する技術を身に着けていただくための解説書です。最初から読み進めていただければ、Symbolを活用したアプリ開発のための全体像を無理なく系統立てて学習できるように構成しています。なお、ノードの構築方法やコンセンサスアルゴリズム、インセンティブ報酬などの説明はありません。

1.2　本書の対象者

　・ブロックチェーンを試してみたいけど、何から勉強したらいいのかわからない方。

　・ブロックチェーンを覚えても、何に使えるのかピンと来ない方。

　・Symbolの教材を作ろうとしてるけど、どういう手順で教えたらいいのか悩んでいる方。

　・Symbolって簡単っていうけど、どういう感じで簡単なのかさくっと知りたい方。

1.3　現場で使えるとは？

　ブロックチェーンを構成するデータの最小単位はお金ではなく、タイムスタンプつき存在証明です。ここに注目すればブロックチェーンは認証やトレーサビリティなど、さらにその用途を広げることができます。世の中を見渡せば、あらゆることが 信頼の数珠繋ぎ で成り立っていることがわかります。その信頼を形にすることが困難なために、多くのことがお金に変換されて構築されてきました。

　今、ブロックチェーン技術によりその信頼をお金に変換することなく、改ざん不可能な形で記録することができるようになりました。本ドキュメントは、金融だけではなく、さらに多くのビジネスや文化の 「現場」 で活躍する人にブロックチェーンの力を活かすヒントを得てもらうために執筆しました。

1.4　「明日から」じゃなくて「今日から」使えるの意味

　昨今、IoTなどの開発現場では 「もはやPoCすら必要ない」 と表現されることがあります。ITを構成する部品化が進み、試しに作ってみた装置がそのまま実運用を始めてしまえるほどにモジュール化されつつあります。Symbolブロックチェーンもアプリケーションを構築するまでもなく、そして自分でノードを建てる必要もなく、設定したアカウントやトークンがコミュニティの提供するツール群でそのまま高セキュリティな情報基盤として活用できるプラットフォームとなっています。

　ぜひ、本ドキュメントでその可能性を感じていただければと思います。なお、各章の最後に載せた「現場で使えるヒント」は各機能の横断的な知識が必要になりますので、最初は読み飛ばしていただいても大丈夫です（いくつかの章の現場で使えるヒントは「現在執筆中」とさせていただいております）。

1.5　Symbolブロックチェーンでできないこと

　他のチェーンで開発されてきた方のために、少しだけ説明しておきます。

　Symbolブロックチェーンには、コントラクトアカウントが存在しません。したがって、スマートコントラクトをデプロイするという発想がなく、すべてのスマートコントラクトは1回だけ実行されて、その効力を失います。そのため、デプロイレス・ワンタイムスマートコントラクトと表現されることもあります。

　デプロイ不要なため、任意の言語でスマートコントラクトを記述することができ、また、1回限りの実行のため、不適切なループ制御などでネットワークのリソースを大量に消費したり、コントラクト内のロジックを再利用して悪用されるといった脆弱性を狙われることもありません。

2.1　使用言語

　JavaScriptを使用します。

2.2　SDK

　・symbol-sdk-typescript-javascript v2.0.4

　　─https://github.com/symbol/symbol-sdk-typescript-javascript

　上記SDKをbrowserify化したものを、ブラウザの開発者コンソールに読み込ませて使用します。

　・https://github.com/xembook/nem2-browserify

2.3　リファレンス

　・Symbol SDK for TypeScript and JavaScript

　　─https://symbol.github.io/symbol-sdk-typescript-javascript/1.0.3/

　・Catapult REST Endpoints (1.0.3)

　　─https://symbol.github.io/symbol-openapi/v1.0.3/

2.4　サンプルソースコード

2.4.1　改行

　本書で表示しているソースコードをコピー＆ペーストして使用する際には、手動で改行を修正する必要があるかもしれません。あらかじめご了承ください。

2.4.2　変数宣言

　console上で何度も書き直して動作検証をしてほしいため、あえてconst宣言を行いません。アプリケーション開発時はconst宣言するなどして、セキュリティを確保してください。

2.4.3　出力値確認

　console.log()で変数の内容を出力します。好みに応じた出力関数に読み替えてお試しください。また、出力内容は > 以下に記述しています。サンプルを実行する場合は、その部分を含まずに試してください。

2.4.4　同期・非同期

　他言語に慣れた開発者の方には非同期処理の書き方に抵抗がある人もいると思うので、特に問題がない限り非同期処理を使わずに解説します。

2.4.5　アカウント

2.4.5.1　Alice

　本書では主にAliceアカウントを中心として解説します。3章で作成したAliceをその後の章でも引き続き使いますので、十分なXYMを送信した状態でお読みください。

2.4.5.2　Bob

　Aliceとの送受信用のアカウントとして各章で必要に応じて作成します。その他、マルチシグの章などでCarolなどを使用します。

2.4.6　手数料

　本書で紹介するトランザクションの手数料乗数は、100でトランザクションを作成します。

2.5　事前準備

　ノード一覧より任意のノードのページをChromeブラウザなどで開きます。

　・テストネット

　　─https://symbolnodes.org/nodes_testnet/

　・メインネット

　　─https://symbolnodes.org/nodes/

　ノード一覧の以下画像の右端のリンクをクリックして、開いたブラウザの画面上で以降の操作はすべて行います。

　本書ではテストネットを前提として解説しています。

　F12キーを押して開発者コンソールを開き、Consoleにソースコードをコピー＆ペーストして実行できるようにするために、Consoleにallow pastingと入力してEnterキーで実行してください。

　続いて以下のスクリプトを入力します。

(script = document.createElement("script")).src =
"https://xembook.github.io/nem2-browserify/symbol-sdk-pack-2.0.4.js";
document.getElementsByTagName('head')[0].appendChild(script);

　続いて、ほぼすべての章で利用する共通ロジック部分を実行しておきます。

NODE = window.origin; //現在開いているページのURLがここに入ります
sym = require("/node_modules/symbol-sdk");
repo = new sym.RepositoryFactoryHttp(NODE);
txRepo = repo.createTransactionRepository();
(async() =>{
    networkType = await repo.getNetworkType().toPromise();
    generationHash = await repo.getGenerationHash().toPromise();
    epochAdjustment = await repo.getEpochAdjustment().toPromise();
})();

function clog(signedTx){
    console.log(NODE + "/transactionStatus/" + signedTx.hash);
    console.log(NODE + "/transactions/confirmed/" + signedTx.hash);
    console.log("https://symbol.fyi/transactions/" + signedTx.hash);
    console.log("https://testnet.symbol.fyi/transactions/" + signedTx.hash);
}

　これで準備完了です。

　なお、次章からはトランザクションを実行し、その結果を確認するという流れを繰り返すことになります。トランザクションの実行結果を確認する際には、以下のようにclogメソッドを使用して、表示されるブロックエクスプローラーのリンクからトランザクションの状態を確認するといいでしょう。

clog(signedTx)

　また、各章で使用するアカウントは、各章を順に進めていくことで各章に再定義せずに前の章のアカウントをそのまま使用できる箇所と、各章に使い捨てのアカウントを生成する必要がある箇所のいずれの場合もあります。中断の後、途中から再開するときには、新たにアカウントを作成したり事前に前章のトランザクションを送信したり必要がある場合も考えられます。事前に記録しておいた秘密鍵からアカウントを復元して使用するか、別途アカウントを新しく作り直してリトライする等して適宜対応してください。

　本ドキュメントの内容が少しわかりにくい場合は、Qiita等の記事もご参考ください。

　https://qiita.com/nem_takanobu/items/e2b1f0aafe7a2df0fe1b