ABTノード入門公式ガイド

ABTノード 1.0が2020年9月1日に正式リリースされました。開発者がABTノードを使い始める方法は、この記事をご覧ください。
ABTノードとは何ですか?
ABTノードは、ユーザーがブラウザを通じてBlocklet(基石プログラム)をインストール、アンインストール、アップグレード、ダウングレード、および実行(静的・動的)できる、WebベースのBlockletプラットフォームです。
ログインインターフェース
ABTノードのログインインターフェースは、登录二维码(ログインQRコード)とABT Walletのダウンロードボタンで構成されています。ユーザーは初期設定済みのABT Walletを使用して登录二维码をスキャンすることで、ログインを完了できます。

ダッシュボードページ
ABTノードのダッシュボードページには、ストレージの使用状況、更新時間、ノードDID、ノード所有者DIDなどの情報とともに、ノードの現在のステータスや属性が表示されます。

Blocklet
Blockletは、独立して実行できる、あるいは他のBlockletに依存して実行されるプログラムです。そのデータは個別に保存されます。ユーザーはBlockletを削除する際にデータを保持できるため、次回のインストール時に再設定を行う必要がありません。
Blockletマーケットプレイス
Blockletマーケットプレイスでは、Blockletのインストール、アンインストール、アップグレードなどの機能が提供されます。また、このマーケットプレイスのデータソースはカスタマイズ可能です。デフォルトでは、ArcBlockが提供するBlockletマーケットプレイスが使用されます。

インストール済みBlockletの管理
Blockletページはインストール済みのBlockletリストで構成されており、ここからインストール済みBlockletの開始、停止、再起動、削除などの操作を行えます。

サービスゲートウェイ
ABTノードは、エンジンを使用してBlockletにサブアクセスパスを割り当てる機能をサポートしています。現在サポートされている唯一のエンジンはNginxです。

ABTノードの取得方法
現在、インストールできるのは Linux および macOS のみです。Windowsなどの他のオペレーティングシステムを使用したい場合は仮想マシンを使用できますが、ABT Walletが仮想マシンのIPアドレスにアクセスできることを確認する必要があります。
ステップ1: nvm のインストール
以下のコマンドを実行して nvm をインストールします。
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/nvm-sh/nvm/master/install.sh)"出力例

注意:以下の2つのコマンドも使用できますが、これらは特定のオペレーティングシステムでのみ使用可能です(クリックして展開)。
このコマンドは macOS 用です:
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.35.3/install.sh | bashこのコマンドは Linux 用です:
wget -qO- https://raw.githubusercontent.com/nvm-sh/nvm/v0.35.3/install.sh | bashステップ2: Node.js と npm のインストール
Node.js の最新の長期サポート(LTS)バージョンを取得するには、このコマンドを使用します(nvm ls-remote で全バージョンを一覧表示することもできます):
nvm ls-remote | grep 'Latest LTS'出力例

この記事の執筆時点で、最新の長期サポートバージョンは v12.18.3 です。
その後、Node.js をインストールするだけで、npm も自動的にインストールされます。
nvm install v12.18.3出力例

注意:コマンド nvm install-latest-npm を実行することで、最新の npm をインストールすることもできます。
ステップ3: ABTノードのインストール
次に、npm を使用して以下のコマンドを実行し、ABTノードをインストールします。
npm install -g @abtnode/cli出力例

ステップ4: ABT Walletのインストールと初期化
ABT Wallet公式サイトからダウンロードリンクを見つけて、ABT Walletのインストールを完了してください。その後、ウォレットを開き、ガイドに従って初期化を完了させます。
ステップ5: IDEのインストール
独自のBlockletを作成する予定がある場合は、まずIDEをインストールすることをお勧めします。推奨される主要なIDEは VSCode です。
ABTノードの設定と起動
ABTノードを起動して実行するには、初期化を行う必要があります。ノードを初期化する前に、ノードを配置したいネットワークに接続されていることを確認してください。ノードをインターネットからアクセス可能にする場合は、インターネットに接続されていることを確認してください。仮想マシンを使用している場合は、ブリッジネットワークアダプタを使用するか(ポートフォワーディングが有効な場合はNATネットワークアダプタでも可)、外部ワイヤレスカードを仮想マシンに接続してください。
また、既にABTノードを初期化している場合は、abtnode start でノードを開始できます。あるいは、設定ファイルを削除(データディレクトリと設定ファイルにデフォルト値を使用している場合は rm /r /f ~/.abtnode*)して、ABTノードを再初期化することも可能です。
以下のコマンドを実行してABTノードを初期化します。
abtnode initその後、各フィールドを入力します(または空のままにして、カッコ内のデフォルト値を使用します)。IPアドレスを選択する際、ローカルネットワーク内でのみテストする場合はローカルIPアドレスを使用し、インターネットからアクセス可能にする場合はパブリックIPアドレスを選択してください。
出力例

次に、ノードを使用するために起動する必要があります。ノードを起動するには、以下のコマンドを実行します。
abtnode start出力例

その後、ブラウザで出力されたリンクを開きます。ブラウザは、ノードに接続できる状態であれば他のデバイス上のものでも構いません。次に、ABT WalletでログインQRコードをスキャンし、あなたがノードの所有者であることを確認してABTノードにログインしてください。
ノードを停止したい場合は、以下のコマンドを実行します。
abtnode stop出力例

ノード機能の概要
上記のステップに従って、ABTノードの取得、インストール、設定、実行が完了しました。次に、ABTノードにどのような機能があるか全体を見てみましょう。
ダッシュボード

ABTノードのステータスや属性を表示するダッシュボード。
マーケットプレイス

ABTノードのBlockletマーケットプレイス。ユーザーはこのページでインストール可能なBlockletを探すことができます。
Blocklet(基石プログラム)

ABTノードにインストールされているBlockletのリスト。
サービスゲートウェイ

ABTノードのサービスゲートウェイ設定。詳細な機能については サービスゲートウェイ管理 をご覧ください。
設定

ABTノードの設定機能。詳細な機能については その他の機能 をご覧ください。
プレイグラウンド

ABTノードが提供するGraphQLプレイグラウンド機能ページ。詳細については GraphQLプレイグラウンド をご覧ください。
こちらをクリックして、ABTノードのドキュメントを確認してください。
このページに関わるもの
製品
-
Blocklet Server
superseded
blocklet をサブプロセスとしてホストしていたサーバー。その作業は ARC で続いており、サブプロセスによるホスティングという方式は引き継がれません。
用語
-
Decentralized Identity
識別子とそれに関する主張を、単一の事業者のアカウント体系の中ではなく、主体自身が保持し検証者が確認する方式。DID と検証可能な資格情報がそれを成り立たせる部品です。