ネットワークへの参加

メインネット、テストネット、またはローカル開発ネットワーク上でInjectiveノードをセットアップして同期します。

メインネット
テストネット
ローカルネットワーク

Injectiveメインネットのchain-idはinjective-1です。

同期オプション

スナップショット復元、state sync、block sync

ノードソフトウェア

injectivedのインストール、設定、実行

ハードウェア

最小および推奨仕様

同期オプション

ノードにチェーンデータをブートストラップする方法を選択します。ほとんどのオペレーターにとって、スナップショット復元がノードを稼働させる最速の方法です。オプション1. スナップショット復元（推奨）事前に構築されたスナップショットをダウンロードし、データディレクトリに展開します。これは新しいノードを同期する最も高速で信頼性の高い方法です。Injectiveは公式のプルーニング済みスナップショット（goleveldb、約2〜3 GB）を提供しており、コミュニティも追加の選択肢を管理しています。ダウンロードリンク、使用手順、コミュニティプロバイダーについては、Chain Portalのスナップショットページを参照してください。

バリデーター： スナップショット復旧の際には、priv_validator_state.jsonのバックアップと復元が必須です。完全な手順については、バリデーターのトラブルシューティングガイドを参照してください。

# Example: download and extract
sudo systemctl stop injectived
rm -rf ~/.injectived/data
wget -O snapshot.lz4 <SNAPSHOT_URL>
lz4 -d snapshot.lz4 | tar xf - -C ~/.injectived/
sudo systemctl start injectived

オプション2. State Sync（CometBFT P2P）State syncは、すべての過去のブロックをリプレイする代わりに、CometBFT P2Pレイヤーを介してピアからステートマシンのスナップショットをダウンロードすることでノードをブートストラップします。信頼できる2つのRPCサーバーが必要です。利用可能なエンドポイントについては、Chain PortalのRPCプロバイダーページを参照してください。config.tomlの[statesync]で設定します：

[statesync]
enable = true
rpc_servers = "<rpc_server_1>,<rpc_server_2>"
trust_height = <recent_height>
trust_hash = "<block_hash_at_trust_height>"
trust_period = "168h0m0s"

trust heightとhashを取得するには：

# Get a recent height and its hash from a trusted RPC
LATEST=$(curl -s https://sentry.tm.injective.network/block | jq -r '.result.block.header.height')
TRUST_HEIGHT=$((LATEST - 2000))
TRUST_HASH=$(curl -s "https://sentry.tm.injective.network/block?height=$TRUST_HEIGHT" | jq -r '.result.block_id.hash')
echo "trust_height = $TRUST_HEIGHT"
echo "trust_hash = \"$TRUST_HASH\""

State syncはwasm/ディレクトリを復元しません。 CometBFTのstate syncはIAVLのstateツリーを復元しますが、~/.injectived/data/wasm/に保存されているCosmWasmのコンパイル済みコントラクトバイトコードは復元しません。これらのファイルがないと、同期完了直後にノードはAppHashの不一致を引き起こします。これに遭遇した場合は、以下のいずれかを行ってください：

スナップショット復元（オプション1）に切り替える。Injectiveの公式スナップショットにはwasm/ディレクトリが含まれています
信頼できるソースからwasm/ディレクトリを入手し、ノードを起動する前に~/.injectived/data/wasm/に配置する

PebbleDBユーザー： Injectiveの公式スナップショットはgoleveldbのみを使用しています。PebbleDBのスナップショットは維持されていません。PebbleDBを実行していてスナップショット復元が使用できない場合、state syncを使用する際にはwasm/ディレクトリを別途入手する必要があります。

オプション3. Block Sync（完全リプレイ）デフォルトの動作です。ノードはピアからすべてのブロックをダウンロードしてリプレイします。最も時間がかかる方法ですが、外部スナップショットは不要です。最近のスナップショット高から同期する場合を除き、メインネットでは実用的ではありません。同期方法の比較：

方法	速度	wasmを含むか？	備考
スナップショット復元	高速（数分）	はい（公式スナップショット）	ほとんどのオペレーターに推奨
State Sync	高速（数分）	いいえ - wasmを手動で復元しないとAppHashの不一致が発生	`config.toml`の`[statesync]`で設定
Block Sync	低速（数日）	該当なし（実行により構築）	デフォルト、genesisからのメインネット同期には非実用的

ピアディスカバリー

ノードがネットワークと同期するにはピアが必要です。~/.injectived/config/config.tomlの[p2p]セクションにシードまたはpersistent peersを追加してください。コミュニティプロバイダーが最新のシードおよびピアリストを管理しています：

Polkachu Injective Seeds
Decentrio Injective Infrastructure（シード、ピア、アドレスブック）

より高速なピアディスカバリーのために、事前構築されたアドレスブックをダウンロードすることもできます：

# Decentrio address book
wget -O ~/.injectived/config/addrbook.json \
  https://backend.decentrio.ventures/snapshots/injective/addrbook.json

ノードソフトウェア

`injectived`のインストール

各Injective coreリリースには、injectived、peggo（Peggyブリッジオーケストレーター）、libwasmvmが1つのzipに含まれています。バリデーターはノードと並行してpeggoを実行する必要があります。非バリデーターノードオペレーターに必要なのはinjectivedのみです。

# Download the latest release
wget https://github.com/InjectiveFoundation/injective-core/releases/latest/download/linux-amd64.zip
unzip linux-amd64.zip
sudo mv injectived /usr/bin
sudo mv libwasmvm.x86_64.so /usr/lib

# Validators also need peggo
sudo mv peggo /usr/bin

新しいInjectiveノードの初期化

Injectiveノードを実行する前に、チェーンとgenesisファイルを初期化します：

# <moniker>引数はノードのカスタムユーザー名です。人間が読める形式にしてください。
export MONIKER=<moniker>
injectived init $MONIKER --chain-id injective-1

initコマンドを実行すると、~/.injectivedにinjectivedのデフォルト設定ファイルが作成されます。

メインネットに参加するための設定の準備

メインネットのgenesisファイルをダウンロードします。Injectiveは公式スナップショットと併せてこれを提供しています：

# メインネットのgenesisファイルをダウンロード
wget -O ~/.injectived/config/genesis.json \
  http://injective-mainnet-snapshots.s3-website.gra.io.cloud.ovh.net/genesis.json

チェックサムを検証します：

sha256sum ~/.injectived/config/genesis.json
# Expected: 573b89727e42b41d43156cd6605c0c8ad4a1ce16d9aad1e1604b02864015d528

ピアディスカバリー用のシードを設定し（同期オプションセクションのピアディスカバリーを参照）、~/.injectived/config/config.tomlでtimeout_commitを300msに設定してください。

`app.toml`と`config.toml`を使用したノードの設定

2つの設定ファイルが~/.injectived/config内に自動生成されます：

config.toml: コンセンサスレイヤー（CometBFT）を設定します。詳細はコンセンサスレイヤーのドキュメントを参照してください。
app.toml: stateプルーニング戦略、テレメトリ、gRPCおよびRESTサーバーの設定、state syncなど、ノードのアプリケーションおよび実行レイヤーを設定します。

`injectived`用の`systemd`サービスの設定（オプション）

/etc/systemd/system/injectived.serviceの設定を編集します：

[Unit]
  Description=injectived

[Service]
  WorkingDirectory=/usr/bin
  ExecStart=/bin/bash -c '/usr/bin/injectived --log-level=error start'
  Type=simple
  Restart=always
  RestartSec=5
  User=root

[Install]
  WantedBy=multi-user.target

systemdサービスの起動と再起動：

sudo systemctl daemon-reload
sudo systemctl restart injectived
sudo systemctl status injectived

# システム起動時の自動起動を有効にする
sudo systemctl enable injectived

# ログを確認する場合
journalctl -u injectived -f

スナップショットデータを正しいディレクトリにロードする前にサービスを停止し、ロード後に開始する必要があります。

# ノードを停止する
sudo systemctl stop injectived

# ノードを起動する
sudo systemctl start injectived

ハードウェア

ノードオペレーターは、最適なパフォーマンスを達成するためにベアメタルサーバーにデプロイすることを推奨します。バリデーターノードは、高いアップタイムを確保するために、推奨されるハードウェア仕様、特にCPU要件を満たす必要があります。

最小要件	推奨
RAMメモリ 128GB	RAMメモリ 128GB
CPU 12コア	CPU 16コア
CPUベースクロック 3.7GHz	CPUベースクロック 4.2GHz
ストレージ 2TB NVMe	ストレージ 2TB NVMe
ネットワーク 1Gbps+	ネットワーク 1Gbps+

サポートご質問がある場合は、Discord、Telegram、またはメールでInjectiveチームに連絡できます。

ハードウェア仕様

ノードオペレーターは、最適なパフォーマンスを達成するためにベアメタルサーバーにデプロイすることを推奨します。また、バリデーターノードは推奨されるハードウェア仕様、特にCPU要件を満たし、高いアップタイムを確保する必要があります。

最小要件	推奨
RAMメモリ 128GB	RAMメモリ 128GB
CPU 12コア	CPU 16コア
CPUベースクロック 3.7GHz	CPUベースクロック 4.2GHz
ストレージ 2TB NVMe	ストレージ 2TB NVMe
ネットワーク 1Gbps+	ネットワーク 1Gbps+

`injectived`と`peggo`のインストール

最新のリリースについてはInjective releases repoを参照してください。非バリデーターノードオペレーターはpeggoをインストールする必要はありません。

wget https://github.com/InjectiveLabs/testnet/releases/latest/download/linux-amd64.zip
unzip linux-amd64.zip
sudo mv peggo /usr/bin
sudo mv injectived /usr/bin
sudo mv libwasmvm.x86_64.so /usr/lib 

新しいInjectiveチェーンノードの初期化

Injectiveノードを実行する前に、チェーンとノードのgenesisファイルを初期化する必要があります：

# <moniker>引数はノードのカスタムユーザー名です。人間が読める形式にしてください。
export MONIKER=<moniker>
# Injectiveテストネットのchain-idは"injective-888"です
injectived init $MONIKER --chain-id injective-888

initコマンドを実行すると、~/.injectivedにinjectivedのデフォルト設定ファイルが作成されます。

テストネットに参加するための設定の準備

テストネットのgenesisファイルとアプリケーション設定ファイルでデフォルト設定を更新し、シードノードでpersistent peersを設定する必要があります。

git clone https://github.com/InjectiveLabs/testnet.git

# genesisファイルを設定ディレクトリにコピー
aws s3 cp --no-sign-request s3://injective-snapshots/testnet/genesis.json .
mv genesis.json ~/.injectived/config/

# 設定ファイルを設定ディレクトリにコピー
cp testnet/corfu/70001/app.toml  ~/.injectived/config/app.toml
cp testnet/corfu/70001/config.toml ~/.injectived/config/config.toml

genesisのチェックサムを検証することもできます - a4abe4e1f5511d4c2f821c1c05ecb44b493eec185c0eec13b1dcd03d36e1a779

sha256sum ~/.injectived/config/genesis.json

`injectived`用の`systemd`サービスの設定

/etc/systemd/system/injectived.serviceの設定を編集します：

[Unit]
  Description=injectived

[Service]
  WorkingDirectory=/usr/bin
  ExecStart=/bin/bash -c '/usr/bin/injectived --log-level=error start'
  Type=simple
  Restart=always
  RestartSec=5
  User=root

[Install]
  WantedBy=multi-user.target

systemdサービスの起動と再起動

sudo systemctl daemon-reload
sudo systemctl restart injectived
sudo systemctl status injectived

# システム起動時の自動起動を有効にする
sudo systemctl enable injectived

# ログを確認する場合
journalctl -u injectived -f

ネットワークとの同期

スナップショットをダウンロードしてネットワークと同期するには、Polkachu Injective Testnet Node Snapshotを参照してください。サポートご質問がある場合は、Discord、Telegram、またはメールでInjectiveチームに連絡できます。

ローカルノードを簡単にセットアップするには、injective-coreリポジトリからsetup.shスクリプトをダウンロードして実行します。インストール済みのinjectivedのバージョンに一致するバージョンのスクリプトを使用してください。

# バージョンタグは、お使いのinjectivedバイナリに一致するものに置き換えてください
# 例えば、v1.18.3用のスクリプトを使用する場合：
wget https://raw.githubusercontent.com/InjectiveFoundation/injective-core/v1.18.3/setup.sh
chmod +x ./setup.sh # スクリプトを実行可能にする
./setup.sh

レガシーのinjective-chain-releasesリポジトリにあるsetup.shスクリプトは古く、injectived v1.14.1以前とのみ互換性があります。常に、お使いのチェーンバージョンに対応するInjectiveFoundation/injective-coreリポジトリのスクリプトを使用してください。

以下のコマンドでノードを起動します：

injectived start # このコマンドの実行後、ブロックの生成が開始されます

スクリプトの動作の詳細説明やセットアッププロセスをより細かく制御したい場合は、以下を参照してください。

チェーンの初期化

Injectiveノードを実行する前に、チェーンとノードのgenesisファイルを初期化する必要があります：

# <moniker>引数はノードのカスタムユーザー名です。人間が読める形式にしてください。
injectived init <moniker> --chain-id=injective-1

上記のコマンドにより、ノードの実行に必要なすべての設定ファイルとデフォルトのgenesisファイルが作成されます。genesisファイルはネットワークの初期状態を定義します。すべての設定ファイルはデフォルトで~/.injectivedにありますが、--homeフラグを渡すことでこのフォルダの場所を上書きできます。~/.injectived以外のディレクトリを使用する場合は、injectivedコマンドを実行するたびに--homeフラグで場所を指定する必要があります。既存のgenesisファイルがある場合は、--overwriteまたは-oフラグで上書きできます。~/.injectivedフォルダは以下の構造を持ちます：

.                                   # ~/.injectived
  |- data                           # ノードが使用するデータベースを含みます。
  |- config/
      |- app.toml                   # アプリケーション関連の設定ファイル。
      |- config.toml                # Tendermint関連の設定ファイル。
      |- genesis.json               # genesisファイル。
      |- node_key.json              # p2pプロトコルでのノード認証に使用する秘密鍵。
      |- priv_validator_key.json    # コンセンサスプロトコルでバリデーターとして使用する秘密鍵。

`genesis.json`ファイルの修正

この時点で、genesis.jsonファイルの修正が必要です：

stakingのbond_denom、crisisのdenom、govのdenom、mintのdenomの値を"inj"に変更します。これはInjectiveのネイティブトークンです。

以下のコマンドを実行することで簡単に変更できます：

cat $HOME/.injectived/config/genesis.json | jq '.app_state["staking"]["params"]["bond_denom"]="inj"' > $HOME/.injectived/config/tmp_genesis.json && mv $HOME/.injectived/config/tmp_genesis.json $HOME/.injectived/config/genesis.json
cat $HOME/.injectived/config/genesis.json | jq '.app_state["crisis"]["constant_fee"]["denom"]="inj"' > $HOME/.injectived/config/tmp_genesis.json && mv $HOME/.injectived/config/tmp_genesis.json $HOME/.injectived/config/genesis.json
cat $HOME/.injectived/config/genesis.json | jq '.app_state["gov"]["deposit_params"]["min_deposit"][0]["denom"]="inj"' > $HOME/.injectived/config/tmp_genesis.json && mv $HOME/.injectived/config/tmp_genesis.json $HOME/.injectived/config/genesis.json
cat $HOME/.injectived/config/genesis.json | jq '.app_state["mint"]["params"]["mint_denom"]="inj"' > $HOME/.injectived/config/tmp_genesis.json && mv $HOME/.injectived/config/tmp_genesis.json $HOME/.injectived/config/genesis.json

上記のコマンドは、デフォルトの.injectivedディレクトリを使用している場合にのみ動作します。特定のディレクトリの場合は、上記のコマンドを修正するか、genesis.jsonファイルを手動で編集して変更を反映してください。

バリデーターアカウントのキーの作成

チェーンを開始する前に、少なくとも1つのアカウントでstateを初期化する必要があります。そのためには、まずtest keyringバックエンドでmy_validatorという名前の新しいアカウントをkeyringに作成します（別の名前や別のバックエンドを選択しても構いません）：

injectived keys add my_validator --keyring-backend=test

# 生成されたアドレスを後で使用するために変数に格納します。
MY_VALIDATOR_ADDRESS=$(injectived keys show my_validator -a --keyring-backend=test)

ローカルアカウントを作成したら、チェーンのgenesisファイルでそのアカウントにinjトークンを付与します。これにより、チェーンのgenesis時点からこのアカウントの存在がチェーンに認識されます：

injectived add-genesis-account $MY_VALIDATOR_ADDRESS 100000000000000000000000000inj --chain-id=injective-1

$MY_VALIDATOR_ADDRESSは、keyring内のmy_validatorキーのアドレスを保持する変数です。Injectiveのトークンは{amount}{denom}形式です：amountは18桁精度の10進数で、denomはdenomination key付きの一意のトークン識別子（例：inj）です。ここではinjトークンを付与しています。injはinjectivedでstakingに使用されるトークン識別子です。

チェーンへのバリデーターの追加

アカウントにトークンが付与されたら、チェーンにバリデーターを追加する必要があります。バリデーターは、チェーンに新しいブロックを追加するためにコンセンサスプロセスに参加する特別なフルノードです。任意のアカウントがバリデーターオペレーターになる意向を宣言できますが、十分なdelegationを持つアカウントのみがアクティブセットに入ることができます。このガイドでは、上記のinitコマンドで作成したローカルノードをチェーンのバリデーターとして追加します。バリデーターは、gentxと呼ばれるgenesisファイルに含まれる特別なトランザクションを通じて、チェーンの最初の起動前に宣言できます：

# gentxを作成します。
injectived genesis gentx my_validator 1000000000000000000000inj --chain-id=injective-1 --keyring-backend=test

# gentxをgenesisファイルに追加します。
injectived genesis collect-gentxs

gentxは以下の3つのことを行います：

作成したvalidatorアカウントをバリデーターオペレーターアカウント（バリデーターを制御するアカウント）として登録します。
指定されたamountのstakingトークンをセルフデリゲートします。
オペレーターアカウントを、ブロックの署名に使用されるTendermintノードのpubkeyにリンクします。--pubkeyフラグが指定されていない場合、上記のinjectived initコマンドで作成されたローカルノードのpubkeyがデフォルトで使用されます。

gentxの詳細については、以下のコマンドを使用してください：

injectived genesis gentx --help

`app.toml`と`config.toml`を使用したノードの設定

2つの設定ファイルが~/.injectived/config内に自動生成されます：

config.toml: Tendermintの設定に使用されます（詳細はTendermintのドキュメントを参照）。
app.toml: Cosmos SDK（Injectiveの基盤）によって生成され、stateプルーニング戦略、テレメトリ、gRPCおよびRESTサーバーの設定、state sync等の設定に使用されます。

両ファイルには詳細なコメントが記載されています。ノードの調整については直接ファイルを参照してください。調整する設定の一例として、app.toml内のminimum-gas-pricesフィールドがあります。これは、バリデーターノードがトランザクションの処理に受け入れる最低ガス価格を定義します。空の場合は、何らかの値（例：10inj）を設定してください。そうしないとノードは起動時に停止します。このチュートリアルでは、最低ガス価格を0に設定します：

 # バリデーターがトランザクションの処理に受け入れる最低ガス価格。
 # トランザクションの手数料は、この設定で指定された任意のdenominationの
 # 最低額を満たす必要があります（例：0.25token1;0.0001token2）。
 minimum-gas-prices = "0inj"

Localnetの実行

すべてのセットアップが完了したら、ノードを起動できます：

injectived start # このコマンドの実行後、ブロックの生成が開始されます

このコマンドでは単一のノードを実行できます。チェーンとの対話には十分ですが、複数のノードを同時に実行してコンセンサスの動作を確認することもできます。

同期オプション

ノードソフトウェア

ハードウェア

​同期オプション

​ピアディスカバリー

​ノードソフトウェア

​injectivedのインストール

​新しいInjectiveノードの初期化

​メインネットに参加するための設定の準備

​app.tomlとconfig.tomlを使用したノードの設定

​injectived用のsystemdサービスの設定（オプション）

​ハードウェア

​ハードウェア仕様

​injectivedとpeggoのインストール

​新しいInjectiveチェーンノードの初期化

​テストネットに参加するための設定の準備

​injectived用のsystemdサービスの設定

​ネットワークとの同期

​チェーンの初期化

​genesis.jsonファイルの修正

​バリデーターアカウントのキーの作成

​チェーンへのバリデーターの追加

​app.tomlとconfig.tomlを使用したノードの設定

​Localnetの実行

同期オプション

ピアディスカバリー

ノードソフトウェア

`injectived`のインストール

新しいInjectiveノードの初期化

メインネットに参加するための設定の準備

`app.toml`と`config.toml`を使用したノードの設定

`injectived`用の`systemd`サービスの設定（オプション）

ハードウェア

ハードウェア仕様

`injectived`と`peggo`のインストール

新しいInjectiveチェーンノードの初期化

テストネットに参加するための設定の準備

`injectived`用の`systemd`サービスの設定

ネットワークとの同期

チェーンの初期化

`genesis.json`ファイルの修正

バリデーターアカウントのキーの作成

チェーンへのバリデーターの追加

`app.toml`と`config.toml`を使用したノードの設定

Localnetの実行