Validator node の運営

Chiliz Chain Validator node のセットアップ

Validator node とは？

Chiliz Chain の validator になるには、自身のハードウェアを使うか、パートナーを通じて、Validator node を運用する必要があります。 node とは、Chiliz Chain 上にトランザクションをコミットする前にそれらを検証するために専用にセットアップされた Web サーバーです。

より一般的な node 運用のドキュメントページもあることに注意してください: run-a-chiliz-chain-node.md

TL;DR

Validator node を運用するには、以下のパラメータを設定する必要があります:

docker run \
-v $(pwd)/my-datadir:/datadir \
--name ccv2-node \
-p 30303:30303 \
chilizchain/ccv2-geth:latest \
--mine \
--chiliz \ # for Chiliz Mainnet. Use --spicy for Spicy Testnet.
--datadir=/datadir \
--password=/datadir/password.txt \
--allow-insecure-unlock \
--unlock=REPLACE_WITH_VALIDATOR_ADDRESS \
--syncmode=full \
--gcmode=archive \
--miner.etherbase=REPLACE_WITH_VALIDATOR_ADDRESS
--nodekeyhex=2668f377e69de_EXAMPLE_REPLACE_WITH_YOUR_VALUE_c88bea3e337446ed73 \
--nat=extip:140.250.140.250 \ # This is just an example.
--verbosity=4

これをそのまま使わないでください！

unlock、miner.etherbase、nodekeyhex のパラメータを必ず更新してください！

前提条件

Chiliz Chain validator node を運用するには、自身のマシンまたはサーバーに Docker Engine がインストールされている必要があります。 Amazon Web Services、Google Cloud Platform、Microsoft Azure などのクラウドプロバイダーを利用することも、自身でサーバーをセットアップすることもできます（後述）。

先に進む前に、 Docker のインストールを完了してください。

システム要件

validator node を運用するには専用サーバーが必要です:

• CPU: 少なくとも 2 CPU コア。

• メモリ: 少なくとも 4 GB の RAM。

• ディスク: 最適なパフォーマンスのためにソリッドステートドライブ（SSD）を使用してください。

  • chain と同期するために、少なくとも 300 GB の空きディスク容量を確保することを推奨します。

• ネットワーク帯域: 少なくとも 10 Gbps。

ビルド済み Docker イメージ

Docker Hub 上の Chiliz Chain 2.0 パブリックリポジトリ からビルド済みの Docker イメージを閲覧・利用できます。リポジトリにアクセスするには Docker Hub アカウントが必要であることに注意してください。

Validator node の起動と同期の開始

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

Ethereum のフォークとして、Chiliz Chain は node サーバーに Geth を利用しています。

Go-ethereum（別名 Geth）は Go で構築された Ethereum クライアントです。Geth を consensus クライアントと併せて実行することで、コンピュータが node になります。したがって、これは node の不可欠な部分です。

下記でご覧いただくように、私たちは Geth を ccv2-geth にフォークしました。

validator アドレスの作成

以下のコマンドで validator node を作成します:

docker run --rm -ti \
-v $(pwd)/keystore:/root/.ethereum/keystore/ \
chilizchain/ccv2-geth:latest \
--chiliz \  # for Chiliz Mainnet. Use --spicy for Spicy Testnet.
account new

秘密鍵ファイル用のパスワードを入力する必要があります。

• 鍵のパブリックアドレス: validator の実行中、このアドレスは --unlock パラメータの設定に使用されます。

docker run \
-v $(pwd)/my-datadir:/datadir \
--name ccv2-node \
-p 30303:30303 \
chilizchain/ccv2-geth:latest \
--chiliz \ # for Chiliz Mainnet. Use --spicy for Spicy Testnet.
...
--unlock=REPLACE_WITH_VALIDATOR_ADDRESS # This is just an example.

• 秘密鍵ファイルのパス: このファイルは、前の手順で作成した datadir $(pwd)/my-datadir 内の "keystore" ディレクトリに移動する必要があります。そのため、ファイルの最終的なパスは "$(pwd)/my-datadir/keystore/UTC–(TIMESTAMP)-(ADDRESS)" となります。 ファイル名を変更しないでください。

• パスワード: 前のコマンドの実行中に入力したパスワードは、ファイルに保存する必要があります: $(pwd)/my-datadir/password.txt このファイルは、validator node の実行中に --password を設定するために使用されます。 ホストパス $(pwd)/my-datadir 内のすべてのファイルは、コンテナ内では /datadir ディレクトリに配置されることを忘れないでください。このため、password パラメータは以下の例のように設定する必要があります:

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

以下の推奨事項を念頭に置いておくことが非常に重要です:

• パブリックアドレスは誰とでも共有できます。他者があなたとやり取りするために必要です。

• 秘密鍵は誰とも絶対に共有しないでください！鍵はあなたの資金へのアクセスを制御します！

• 鍵ファイルはバックアップしなければなりません！鍵がなければ、アカウントの資金にアクセスすることは不可能です！

• パスワードを覚えておかなければなりません！パスワードがなければ、鍵を復号することは不可能です！

validator node 鍵の生成

このセクションは任意です。

node 用にランダムな 16 進数文字列を生成することを推奨します。 これはログ上のトレーサビリティに役立ち、chain とのピアリングの問題を回避するのに役立ちます。

これを行うには、https://www.browserling.com/tools/random-hex を使用して、node ごとに 64 文字の 16 進数鍵を 1 つ生成できます。 validator node の実行中に、この値で --nodekeyhex を設定できます。これにより、node を再起動したときに同じ node アドレス（"enode address" と呼ばれます）を持つことが保証され、将来のデバッグや障害の特定が容易になります。

docker run \
-v $(pwd)/my-datadir:/datadir \
--name ccv2-node \
-p 30303:30303 \
chilizchain/ccv2-geth:latest \
--chiliz \ # for Chiliz Mainnet. Use --spicy for Spicy Testnet.
...
--nodekeyhex=2668f377e69de_EXAMPLE_REPLACE_WITH_YOUR_VALUE_c88bea3e337446ed73 # This is just an example.
...

Geth の NAT ポートマッピング機構の設定

Geth の --nat パラメータには以下のオプションがあります: any、none、upnp、pmp、pmp:<IP>、extip:<IP>。デフォルトは any です。詳細は Geth のドキュメントを参照してください。

extip:<IP> オプションの使用を推奨します。ここで <IP> は validator を起動するパブリック IPv4 アドレスです。

docker run \
-v $(pwd)/my-datadir:/datadir \
--name ccv2-node \
-p 30303:30303 \
chilizchain/ccv2-geth:latest \
--chiliz \ # for Chiliz Mainnet. Use --spicy for Spicy Testnet.
...
--nat=extip:140.250.140.250 # This is just an example.
...

verbosity の設定

より詳細なトラブルシューティングのために、Geth のログ出力レベルのパラメータ --verbosity は以下のように設定できます:

• 0=silent

• 1=error

• 2=warn

• 3=info

• 4=debug

• 5=detail

デフォルト値は 3 です。 4 の使用を推奨します。

docker run \
-v $(pwd)/my-datadir:/datadir \
--name ccv2-node \
-p 30303:30303 \
chilizchain/ccv2-geth:latest \
--chiliz \ # for Chiliz Mainnet. Use --spicy for Spicy Testnet.
...
--verbosity=4 # This is just an example.
...

node の所有者の変更

validator node の運用をやめたくなる時が来るかもしれません。そのとき、node を他の誰かに引き継ぎたい場合があります。

その場合、以下の手順に従うことができます:

1. ウォレットを Chiliz Staking dApp に接続します。

2. "Change owner" ボタンをクリックします。

1. モーダルウィンドウで、所有者を変更したい node の現在のアドレスと、その新しいアドレス（新しい所有者から提供されたもの）を指定します。

送信すると、変更は直接適用されます。