Chiliz Chain Node を実行する

ノードを起動、作成、接続し、デバッグして Chiliz Chain と同期する

独自の Chiliz Chain node を実行すると、制御性、プライバシー、信頼性が向上しますが、既存の RPC エンドポイントを使用する場合と比べて、より高度な技術的専門知識とリソースが必要になります。

これにより、Chiliz Chain 上の smart contract とのトランザクションや通信が可能になります。

Validator 専用のノード実行ドキュメントページもありますので、ご注意ください: running-a-validator-node.md

前提条件

Chiliz Chain node を実行するには、お使いのマシンまたはサーバーに Docker がインストールされている必要があります。そのため、続行する前に Docker のインストール を完了してください。

ビルド済み Docker イメージ

Docker hub 上の Chiliz Chain 2.0 公開リポジトリ にあるビルド済みの Docker イメージを使用できます。

ノードの起動と同期の開始

Chiliz Chain node を実行する際の推奨される出発点は、マウントされたデータボリュームを使用する方法です。この方法で Docker コンテナを再作成すると、データはディレクトリに保存され、簡単に再利用したり、別の node にクローンしたりできます。

ステップ 1: ディレクトリの作成

ディレクトリを作成し、次のコマンドの -v パラメータでそれを指定します:

docker run \
-v $(pwd)/my-datadir:/datadir \
--name ccv2-node \
-p 8545:8545 \
-p 8546:8546 \
chilizchain/ccv2-geth:latest \
--chiliz # for Chiliz Mainnet. Use --spicy for Spicy Testnet.
--datadir=/datadir \
--ipcdisable

ステップ 2: クライアントの接続

クライアントを node に接続するには、それぞれ --http および/または --ws のパラメータグループを指定して、RPC HTTP および/または WebSocket サーバーを有効にする必要があります。

例えば:

docker run \
-v $(pwd)/my-datadir:/datadir \
--name ccv2-node \
-p 8545:8545 \
-p 8546:8546 \
chilizchain/ccv2-geth:latest \
--chiliz \ # for Chiliz Mainnet. Use --spicy for Spicy Testnet.
--datadir=/datadir \
--ipcdisable \
--http \
--http.addr=0.0.0.0 \
--http.api=eth,net,web3,debug,txpool \
--http.port=8545 \
--http.corsdomain="*" \
--http.vhosts="*" \
--ws \
--ws.addr=0.0.0.0 \
--ws.api=eth,net,web3,debug,txpool \
--ws.port=8546 \
--ws.origins="*" \

注意

セキュリティ上の理由から、以下のパラメータに適切な値を設定してください:

--http.corsdomain

--http.vhosts

--ws.origins

ノードのメンテナンス情報

デバッグ時の verbosity の変更

場合によっては、node の verbosity を上げたいことがあります。つまり、node または接続するクライアント自体をデバッグする必要がある場合です。

そのためには、--verbosity パラメータを定義できます。以下のオプションを受け付けます（デフォルトは 3 です）:

• 0=silent

• 1=error

• 2=warn

• 3=info

• 4=debug

• 5=detail

ノードの停止とクリーンアップ

上記のいずれかのコマンドを使用して node を起動した場合、node プロセスはフォアグラウンドで実行され続けます。このプロセスを停止するには、CTRL+C を押してください。

次のコマンドを実行して Docker コンテナを削除します:

docker rm ccv2-node

ディレクトリの削除

次のコマンドを実行してディレクトリを削除します:

rm my-datadir

ノードの更新

Chiliz Chain チームは Chiliz Chain を安全かつ最新の状態に保つよう努めており、そのため Dragon8 hard fork のように、毎年時折 hard fork を実施します。

hard fork が発生すると、お使いの node はネットワークと同期しなくなります。そのため、私たちのアナウンスをフォローし、node を更新することが重要です。

node を最新の状態に保つには、以下の手順に従ってください。

Docker を使用している場合:

1. データベースを含むボリュームを保持したまま、既存の Docker コンテナを停止して削除してください。

2. 利用可能な最新のビルド済み Docker イメージ を使用して node を起動します。

独自のバイナリを使用している場合:

1. GitHub リポジトリから最新のリリースをダウンロードします。

2. そこからお使いのツールセットでビルドします。

archive node の実行

node を archive モードで実行するには、上記で示した ccv2-geth の呼び出しに次の 2 つのパラメータを追加する必要があります:

--syncmode=full \
--gcmode=archive \

スナップショットまたはバックアップからの Chiliz Chain ノードの実行

Chiliz Chain node の同期プロセスを高速化するために、スナップショット（ブロックチェーンデータディレクトリ（datadir）の最近のコピー（またはアーカイブ/バックアップ））を利用できます。この方法では、ゼロから同期する場合と比べて、node をより迅速に稼働させることができます。

新しい node のセットアップにはスナップショットを保持することをお勧めします。 既存の datadir をスナップショットで上書きすると、不整合が生じる可能性があります。

利用可能なスナップショット

各ネットワークには専用のスナップショットがあります:

• Spicy Testnet: chaindata_snapshot.tar.gz

• Chiliz Chain Mainnet: chaindata_snapshot.tar.gz

既存データのクリーニング

既存の node にスナップショットを適用する場合は、node を再起動する前に、datadir 内の以下のディレクトリとファイルを削除してください:

rm -rf blobpool transactions.rlp LOCK lightchaindata triecache

この手順により、残存データから生じる潜在的な競合を防ぐことができます。

スナップショットから node を実行する手順:

1. データディレクトリを作成します:

mkdir -p ~/chiliz-node/my-datadir

1. スナップショットをダウンロードします:

必要に応じて URL を Mainnet スナップショットの URL に置き換えてください。

cd ~/chiliz-node/my-datadir
nohup curl -L --retry 5 -o chaindata.tar.gz https://s3.eu-west-3.amazonaws.com/spicy-snapshots.chiliz.com/chaindata_snapshot.tar.gz > download.log 2>&1 &

ダウンロードの進捗を監視するには、次を使用します: tail -f download.log

1. スナップショットを展開します:

tar -xzf chaindata.tar.gz

1. Chiliz Chain node を実行します:

docker run \
  -v ~/chiliz-node/my-datadir:/datadir \
  --name ccv2-node \
  -p 8545:8545 \
  -p 8546:8546 \
  chilizchain/ccv2-geth:latest \
  --spicy \  # Use --chiliz for Mainnet
  --datadir=/datadir \
  --ipcdisable \
  --http \
  --http.addr=0.0.0.0 \
  --http.api=eth,net,web3,debug,txpool \
  --http.port=8545 \
  --http.corsdomain="*" \
  --http.vhosts="*" \
  --ws \
  --ws.addr=0.0.0.0 \
  --ws.api=eth,net,web3,debug,txpool \
  --ws.port=8546 \
  --ws.origins="*"

Geth に関する追加情報

利用可能な Geth パラメータの完全なリストを表示するには、Geth の command-line options をご覧ください。