setup.md

動作環境の構築

このプロジェクトで使用しているバージョンは次のとおりです

• Node.js 10.15.3

• nem2-cli 0.13.0

• nem2-sdk 0.13.0

• catapult-service-bootstrap 0.6.0.1

• (ローカルネットワークを構築する場合)

  • Docker version 18.09.3, build 74b1e89
  • docker-compose version 1.24.1, build 4667896b

メジャーバージョンが大きく異なっていなければ、これらのバージョン以外でも動作すると思われますが、問題が発生する場合は上記に合わせてください。

特にnem2-cli,nem2-sdk,catapult-service-bootstrapの組み合わせについて、APIノードのレスポンススキーマの差異によって正常に動作しない場合があります。

macOS上で動作させた内容のため、WindowsやLinux環境で行う場合はコマンドライン操作が異なる場合があります。

適宜読み替えて操作してください。

Node.jsのインストール

Node.jsのインストールは公式のインストーラやnodenvなどのバージョンマネージャなどを用いてインストールしてください。

• Node.js
• nodenv/nodenv: Manage multiple NodeJS versions.

コマンドパスが通っており、バージョンが確認できる状態にしてください。

$ node -v
v10.15.3

$ npm -v
v6.9.0

nem2-cliのインストール

nem2-cliはnemネットワークからアカウントやトランザクションの情報を取得したり、トランザクションを発信するコマンドラインツールです。

• nem2-cli - npm

グローバルインストールをして、パスが通っていることを確認してください。

$ npm install nem2-cli@0.13.0 -g
$ nem2-cli
                        ____            _ _
   _ __   ___ _ __ ___ |___ \       ___| (_)
  | '_ \ / _ \ '_ ` _ \  __) |____ / __| | |
  | | | |  __/ | | | | |/ __/_____| (__| | |
  |_| |_|\___|_| |_| |_|_____|     \___|_|_|

                                     v0.13.0

nem2-sdkのインストール

nem2-sdkはAPIとの疎通をJavaScriptで行うことのできるラッパーライブラリです。

サンプルコードはnem2-sdkを使用しています。

scripts/に移動して、モジュールのインストールを行ってください。

$ cd scripts
$ npm install

• nem2-sdk - npm

Docker/docker-composeのセットアップ(ローカル環境を用意する場合)

前述のとおり、ローカル環境にネットワークを構築する場合はcatapult-service-bootstrapを動かすための環境が必要です。

すでに用意されたネットワークを使用する場合はセットアップをスキップできます。

• Get Started with Docker | Docker
• Install Docker Compose | Docker Documentation

Windows/Mac OSX/Linuxそれぞれの環境に応じたインストール方法でセットアップを行ってください。

インストールできたら、それぞれのコマンドが実行できることを確認してください。

$ docker -v
Docker version 19.03.1, build 74b1e89
$ docker-compose -v
docker-compose version 1.24.1, build 4667896b