メインコンテンツまでスキップ

ノードの運用

本ガイドでは、ノードのみのQoreChainデプロイ——チェーンを同期し、統合用のエンドポイントを公開するフル/RPCノード——について説明します。バリデーターの役割は含みません。対象は、ブロックの署名は行わないもののネットワークへの信頼できる読み書きアクセスを必要とする取引所(CEX)、ウォレットのバックエンド、インデクサー、インテグレーターです。

注記

ブロック生成、ステーキング、スラッシング、プール分類については、バリデーターの運用を参照してください。ノードのみのデプロイは、バリデーターのコンセンサス鍵を一切保持せず、アクティブセットに現れることもありません。

警告

バイナリ、ジェネシス、スナップショットはSHA-256チェックサム付きでdownload.qore.hostで公開されています。インストールや展開の前に必ずチェックサムを検証し、デポジットの検証は自分自身が同期したノードに対してのみ行ってください。

信頼できる情報源: ライブマニフェスト

現在のバイナリ、ジェネシス、ピア、シード、およびステートシンクの信頼点はライブで更新されるJSONマニフェストとして公開されています——インストールスクリプトにバイナリのバージョン、チェックサム、スナップショットのファイル名をハードコードしないでください。新しいリリースが出た瞬間に古くなってしまうためです。

  • メインネット: https://download.qore.host/mainnet/latest.json
  • テストネット: https://download.qore.host/testnet/latest.json

マニフェストのフィールドには、binary(URLとsha256)、genesis(URL、sha256、sizeBytes)、peers、seeds、p2pPort、stateSync(1時間ごとに更新される信頼点)、minCompatibleが含まれます。以下のインストールおよび参加手順では、このマニフェストを取得し、その時点の値を使用します。

マニフェストが指すリリースを使用してください: メインネットはv3.2.7、テストネットはv3.2.8

ジェネシスから同期する、またはスナップショットからリプレイするノードは、複数のガバナンスアップグレード(下記のアップグレードを参照)を通過します。そのため、必ずマニフェストが指すバイナリをインストールしてください。そのバイナリにはすべてのアップグレードハンドラーが含まれています。メインネットでは、マニフェストのminCompatibleとversionはどちらも3.2.7(2026年11月12日にブロック高4,164,600で適用、ガバナンス提案16)であるため、今から参加するノードにはv3.2.7が必要です。古いバイナリは、知らないアップグレード高で停止します。リリースはバンドルqorechaind-v3.2.7-b3-linux-amd64.tar.gz(99,472,930バイト、SHA-256 d4b2f166a75900d2354759b067b3e21c6fbd96003ac056163791cf4b7fb242b5、2026年11月12日にマニフェストから読み取った値。正となるのは稼働中のマニフェストです)です。マニフェストは、新しいノードはステートシンクで参加するよう案内しています。qorechaindと、libqorepqc.so、libqoresvm.so、libwasmvm.x86_64.soを含むlib/が入っています。まだv3.2.6のノードは、ブロック高4,164,600でUPGRADE "v3.2.7" NEEDEDと表示されて停止しました。バンドルをインストールして再起動すれば、ステートは保持されます。メインネットのこれ以降のアップグレードは予定されておらず(current_planはnull、2026年11月12日に確認)、マニフェストがより新しいリリースを示した場合は、それがインストールすべきバイナリです。テストネットでは、マニフェストのminCompatibleとversionはどちらも3.2.8であるため(v3.2.5は2026年10月26日にブロック高8,890,800で、v3.2.6は10月27日にブロック高8,970,638で、v3.2.7は11月6日にブロック高9,594,600で、v3.2.8は11月12日にブロック高9,929,500で適用)、テストネットに参加するノードにはv3.2.8のバイナリが必要です。バンドル名、サイズ、SHA-256は、稼働中のテストネットのマニフェストから取得してください。正となるのはそのマニフェストです(2026年11月7日、v3.2.7 の時点では、qorechaind-v3.2.7-b3-linux-amd64.tar.gz、99,472,930バイト、SHA-256 d4b2f166a75900d2354759b067b3e21c6fbd96003ac056163791cf4b7fb242b5でした)。まだv3.2.7のテストネットノードは、ブロック高9,929,500でUPGRADE "v3.2.8" NEEDEDと表示されて停止します。qorechaindを置き換え、バンドルのlib/フォルダ全体をコピーしてから再び起動してください。ステートは保持され、再同期は不要です。メインネットはv3.2.7のままで、テストネットより1リリース遅れています。v3.2.8は適用していないため、v3.2.8のノートの内容はメインネットのノードには何も変わりません。テストネットのバイナリをメインネットに対して実行したり、その逆を行ったりしないでください。各ディレクトリがそれぞれのリリースを提供しています(アップグレードを参照)。マニフェストはまずテストネットで、猶予期間を置いてからメインネットで意図的に昇格されるため、binary.urlを信頼する前に、マニフェストの"version"フィールドをminCompatibleと照らし合わせて確認してください。

公開ソースからビルドしたバイナリ(コミュニティ版ビルド)は、どちらの公開ネットワークでも起動を拒否します(v3.2.3以降)。ポスト量子署名を検証できず、ネットワークのブロックを忠実にリプレイすることもできないためです。リリースアーカイブのみを使用してください。

v3.2.1以降では2つの設定が重要です。システムクロックをNTPで同期させておくこと(ノードはクロックのずれが60秒を超えると停止します)、そしてapp.tomlでevm-chain-idを設定することです(ノードの制限を参照)。


ノード対バリデーター​

項目ノードのみ(本ガイド)バリデーター
コンセンサス鍵なしed25519コンセンサス鍵(要保護)
ブロック生成なしあり——ブロックを提案・署名する
ステーキング/スラッシング該当なしセルフデリゲーション、スラッシングリスク
主な目的インテグレーション向けにRPC/REST/gRPC/EVM(および読み取り専用のSVM)を提供するネットワークを保護する(ステーキング報酬が適用される)
公開範囲通常はRPC/EVMエンドポイントを公開サントリーノードの背後に隠されたバリデーター

対象ネットワーク​

ネットワークチェーンIDEVMチェーンID備考
メインネットqorechain-vladi9801(16進数 0x2649)主要——2026年6月7日より稼働中。ノードリリースv3.2.7(2026年11月12日から)
テストネットqorechain-diana9800まずここで統合をリハーサルすること。ノードリリースv3.2.8(2026年11月12日から)

本ガイド全体を通して、対象ネットワークに合わせて適切な--chain-idに置き換えてください。例ではデフォルトでメインネットを使用しています。


プロファイルCPURAMディスク(NVMe SSD)ネットワーク
プルーニング済みRPCノード4コア16 GB500 GB以上100 Mbps以上
フル/アーカイブノード8コア32 GB2 TB以上(時間とともに増加)1 Gbps
取引所統合8コア32 GB余裕を持たせた2 TB以上1 Gbps

NVMe SSDを強く推奨します。チェーンの状態およびEVM/SVMストアはI/O負荷が高いためです。上記のディスク容量の数値には十分な余裕があります。メインネットでの実測値(2026年10月27日): ステートシンクで参加し、pruning = "custom"(keep-recent 100000)とindexer = "null"を使用しているバリデーターは、2か月後で約10 GB、ジェネシスから稼働しデフォルトのプルーニングを使用しているノードは、4か月後で約100〜130 GBです。バリデーターのサイジングはバリデーターの運用: ハードウェアを参照してください。アーカイブノード(プルーニングなし、全トランザクションインデックス)は継続的に増大するため、余裕を持ったディスク容量を用意し、監視を行ってください。


デプロイ​

Docker Compose​

Docker Composeによるノードのみのデプロイです。公開されているqorechaindイメージをpullすることはできません(プロジェクトのDocker Hub組織には何も公開されていません)。公開リポジトリのDockerfileはコミュニティバイナリ(ポスト量子ライブラリなし、スタブkeeper)をビルドします。これはローカル開発には適していますが、メインネットやテストネットには追従できず、v3.2.3以降はそれらでの起動を拒否します。ネットワークノードの場合は、latest.jsonに記載されたリリースアーカイブから自分でイメージをビルドし、リリースバージョン(執筆時点で、メインネットでもテストネットでもv3.2.6)でタグ付けしたうえで、チェーンデータ用に永続ボリュームをマウントしてください。

# Fetch and verify the release archive (see "Joining the Network" below for the manifest steps)
curl -s https://download.qore.host/mainnet/latest.json -o latest.json
curl -fsSL "$(jq -r .binary.url latest.json)" -o qore.tgz
echo "$(jq -r .binary.sha256 latest.json) qore.tgz" | sha256sum -c -
mkdir release && tar xzf qore.tgz -C release

cat > release/Dockerfile <<'EOF'
FROM debian:bookworm-slim
RUN apt-get update && apt-get install -y ca-certificates curl jq && rm -rf /var/lib/apt/lists/*
COPY qorechaind /usr/local/bin/qorechaind
COPY lib/ /opt/qorechain/lib/
ENV LD_LIBRARY_PATH=/opt/qorechain/lib
ENTRYPOINT ["qorechaind"]
EOF
docker build -t qorechain-node:v3.2.7 release/

アーカイブにはqorechaindと、その共有ライブラリ(libqorepqc.so、libqoresvm.so、libwasmvm.x86_64.so、v3.2.8以降はlibwasmvmqore_v1.x86_64.so)を収めたlib/ディレクトリが含まれます。個別のファイルではなくlib/ディレクトリ全体をコピーしてください。上記のイメージはリリースアーカイブと同様にlinux/amd64専用です。

# docker-compose.yml
services:
qorechain-node:
image: qorechain-node:v3.2.7
container_name: qorechain-node
restart: unless-stopped
command: ["start", "--home", "/root/.qorechaind"]
volumes:
- qorechain-data:/root/.qorechaind
ports:
- "26657:26657" # RPC
- "26656:26656" # P2P
- "1317:1317" # REST
- "9090:9090" # gRPC
- "8545:8545" # EVM JSON-RPC
- "8546:8546" # EVM WebSocket
- "8899:8899" # SVM RPC (read-only: SVM transactions are disabled)
- "26660:26660" # Prometheus

volumes:
qorechain-data:

データディレクトリを一度初期化してから(たとえばdocker compose run --rm qorechain-node init my-node --chain-id qorechain-vladi --home /root/.qorechaind。ジェネシスとピア設定は以下で説明します)、起動します。

docker compose up -d
docker compose logs -f qorechain-node

systemd​

ベアメタルにインストールする場合は、qorechaindをsystemd配下で実行します。

# /etc/systemd/system/qorechaind.service
[Unit]
Description=QoreChain node
After=network-online.target
Wants=network-online.target

[Service]
User=qorechain
ExecStart=/usr/local/bin/qorechaind start --home /var/lib/qorechaind
Restart=on-failure
RestartSec=5
LimitNOFILE=65535

[Install]
WantedBy=multi-user.target
sudo systemctl daemon-reload
sudo systemctl enable --now qorechaind
sudo journalctl -u qorechaind -f

ネットワークへの参加​

1. 初期化​

qorechaind init my-node --chain-id qorechain-vladi

2. マニフェストの取得​

curl -s https://download.qore.host/mainnet/latest.json -o latest.json
# testnet: https://download.qore.host/testnet/latest.json

以下の手順では、このファイルをバイナリ、ジェネシス、ピアの値の情報源として使用してください——jq -r .minCompatible latest.jsonを確認し、少なくともそのリリースを実行してください(推奨リリースはjq -r .version latest.jsonです)。

3. ジェネシスのダウンロードと検証​

GENESIS_URL=$(jq -r .genesis.url latest.json)
GENESIS_SHA256=$(jq -r .genesis.sha256 latest.json)

curl -fsSL "$GENESIS_URL" -o ~/.qorechaind/config/genesis.json
echo "${GENESIS_SHA256} $HOME/.qorechaind/config/genesis.json" | sha256sum -c -

# Cross-verify against the genesis served live by the chain:
curl -s https://rpc.qore.host/genesis | jq '.result.genesis' > /tmp/genesis-live.json

4. ピアと手数料フロアの設定​

ノードIDやホストをハードコードするのではなく、マニフェストから現在のピアとシードを読み取ってください——これらは頻繁に入れ替わります。

PEERS=$(jq -r '.peers | join(",")' latest.json)
SEEDS=$(jq -r '.seeds | join(",")' latest.json)

~/.qorechaind/config/config.tomlを開き、persistent_peers(およびseeds)をこれらの値に設定します。

persistent_peers = "<value of $PEERS>"
seeds = "<value of $SEEDS>"

続いて、~/.qorechaind/config/app.tomlで最小ガス価格を設定します(ネットワークの手数料フロア: 0.1uqor)。

minimum-gas-prices = "0.1uqor"

qorechaind init <moniker> --chain-id qorechain-vladiは、ネットワークのEVMチェーンIDもapp.tomlに書き込みます(ノードの制限を参照)。ずっと前に初期化したhomeでは、この設定を確認してください。

5. 同期の開始​

qorechaind start --minimum-gas-prices=0.1uqor

高速ブートストラップ​

ジェネシスからの同期には長い時間がかかることがあります。参加方法としてはステートシンクを標準としてください。スナップショットはフォールバックに限ります(メインネットのスナップショットは2026年8月21日のもので、テストネットはスナップショットを公開していません)。

ステートシンク​

ステートシンクは、すべてのブロックをリプレイする代わりに、信頼できるRPCサーバーから最近のアプリケーション状態のスナップショットを取得します。config.tomlの[statesync]セクションを設定します。

[statesync]
enable = true
rpc_servers = "https://rpc.qore.host:443,https://<a second RPC you run or trust>:26657"
trust_height = <TRUSTED_BLOCK_HEIGHT>
trust_hash = "<TRUSTED_BLOCK_HASH>"
trust_period = "168h0m0s"

trust_height/trust_hashはマニフェストのstateSyncフィールドから取得してください。1時間ごとに更新されるため、こちらを優先的な情報源としてください。

TRUST_HEIGHT=$(jq -r .stateSync.trustHeight latest.json)
TRUST_HASH=$(jq -r .stateSync.trustHash latest.json)
2つの異なるRPCサーバー

ステートシンクは、信頼点を2つのRPCサーバーに対して照合します。マニフェストのstateSync.rpcServersは、メインネットではhttps://rpc.qore.hostを2回(テストネットではhttps://rpc-testnet.qore.hostを2回)列挙しています。同一のエントリが2つあっても個数の条件は満たされますが、照合の意味がなくなります。自分で運用している、または独立して信頼できる2つ目のRPCを追加し、信頼ハッシュを2つ目の情報源と比較してください。例えばcurl -s "https://<second-rpc>/block?height=$TRUST_HEIGHT" | jq -r .result.block_id.hashの結果は$TRUST_HASHと一致しなければなりません。

フォールバック/代替手段として、公開RPCから信頼するブロック高とハッシュを自分で導出することもできます。

curl -s https://rpc.qore.host/block | jq -r '.result.block.header.height, .result.block_id.hash'

スナップショットからの復元​

代わりに、公開されているチェーンデータのスナップショットをダウンロードし、チェックサムを検証してから、データディレクトリに展開する方法もあります。メインネットでは、マニフェストのsnapshotオブジェクトにURL、ブロック高(height)、サイズ、SHA-256が含まれます。テストネットのマニフェストのスナップショットURLは現在404を返します(テストネットのスナップショットは公開されていません)。そのため、そちらではステートシンクを使用してください。 使用する前にsnapshot.heightを確認してください。メインネットのスナップショットは約27 GBの単一アーカイブであり、古いものは追いつきに長い時間がかかります。現在公開されているメインネットのスナップショットは2026年8月21日(ブロック高1,966,629)のものです。v3.1.94、v3.2.0、v3.2.2、v3.2.3、v3.2.4のアップグレード高より前のものであるため、そこから復元したノードはマニフェストが示すリリースバイナリで約2か月分のブロックをリプレイします。ほとんどの場合、ステートシンクの方が適しています。

SNAP_URL=$(jq -r .snapshot.url latest.json)
SNAP_SHA256=$(jq -r .snapshot.sha256 latest.json)
curl -fsSL "$SNAP_URL" -o snapshot.tar.gz
echo "${SNAP_SHA256} snapshot.tar.gz" | sha256sum -c -

tar xzf snapshot.tar.gz -C ~/.qorechaind/
qorechaind start --minimum-gas-prices=0.1uqor
注記

マニフェストのsnapshot.heightとsnapshot.tsフィールドはアーカイブの新しさを示しており、通常はステートシンク(上記)の方が27 GBのダウンロードより高速です。展開前に必ずチェックサムを検証し、スナップショットからリプレイする際は、すべてのアップグレードハンドラーを含むノードリリースを使用してください(このページ冒頭の注意を参照)。


アップグレード​

コンセンサスの変更は、協調されたガバナンスアップグレードとして行われます。可決された提案がプラン名(たとえばv3.2.3)とブロック高を指定します。リリースバイナリにはアップグレードハンドラーが含まれており、プランの高さですべてのノードがそれを実行している必要があります。以前のバイナリのままのノードはその高さで停止します(これはアップグレードモジュールの意図された動作です)。マニフェストを見れば、リリースがどちらの種類かがわかります。upgradeTypeは、協調アップグレードの場合はheight(upgradeHeightが設定されます)、ノードごとに入れ替えられるノードローカルなリリースの場合はrollingです。新しいバイナリは、その高さの前にインストールしてください。先にノードが停止した場合は、バイナリを入れ替えて再起動してください(トラブルシューティングのロールバックに関する注記を参照)。

リリースメインネット qorechain-vladiテストネット qorechain-diana
v3.1.94ブロック高 2,122,074未適用
v3.2.0ブロック高 2,981,742ブロック高 5,920,000
v3.2.1ノードローカル、ブロック高なしノードローカル
v3.2.2ブロック高 3,556,788(2026年10月16日)ブロック高 6,905,034(2026年10月2日)
v3.2.3ブロック高 3,662,051(2026年10月20日、ガバナンス提案11)ブロック高 8,003,746(2026年10月15日)
v3.2.4ブロック高 3,742,566(2026年10月23日、ガバナンス提案13)ブロック高 8,337,253(2026年10月19日、ガバナンス提案13)
v3.2.5ブロック高 3,906,833(2026年10月29日、ガバナンス提案14)ブロック高 8,890,800(2026年10月26日)
v3.2.6ブロック高 4,020,000(2026年11月4日、ガバナンス提案15)ブロック高 8,970,638(2026年10月27日)
v3.2.7ブロック高 4,164,600(2026年11月12日、ガバナンス提案16)ブロック高 9,594,600(2026年11月6日、ガバナンス提案33)
v3.2.8未適用ブロック高 9,929,500(2026年11月12日)

ノード運用者がv3.2.4(メインネットのブロック高3,742,566)のために行ったこと。 ガバナンス提案13は、プラン名をv3.2.4、ブロック高を3,742,566と定め(2026年10月23日に適用)、ノードはそのブロック高までv3.2.3のままで、そこで停止し、v3.2.4で再起動しました。次の協調アップグレードでも手順は同じです。

  1. マニフェスト(https://download.qore.host/mainnet/latest.json)を確認してください。新しいリリースが掲載されるまで、インストールするものはありません。テストネットのディレクトリにあるバイナリは、メインネットのリリースではありません。
  2. マニフェストがそのリリースを示したら、そのbinary.urlからアーカイブをダウンロードし、sha256を検証し(提案の本文にもバイナリのsha256が公開されます)、ブロック高に先立って配置しておいてください。保留中のプラン(nameとheight)はGET /cosmos/upgrade/v1beta1/current_planで、現在のブロック高はRPCのGET /statusで確認できます。
  3. プランの高さで、まだ古いバイナリのノードは停止します(これはアップグレードモジュールの意図された動作であり、障害ではありません)。すでに新しいバイナリを実行しているノードはアップグレードハンドラーを適用して継続します。先に停止してしまった場合は、バイナリを入れ替えて再起動してください。アップグレード後は、GET /cosmos/upgrade/v1beta1/applied_plan/v3.2.4が0ではなくブロック高を返します(メインネットでは3742566、テストネットでは8337253)。
  4. 現在メインネットへ参加するノードは、マニフェストが示すリリース(執筆時点ではv3.2.7。versionをminCompatibleと照らし合わせて確認してください)をインストールします。

トランザクションの署名、アドレス、小数点桁数、メモ、手数料は、v3.2.4でも変更されません。

メインネットのv3.2.5(ブロック高3,906,833、2026年10月29日、ガバナンス提案14)。 同じ手順が適用されました。マニフェストはversionとminCompatibleの両方に3.2.5を示し、まだv3.2.4のノードはプランの高さでUPGRADE "v3.2.5" NEEDEDと表示されて停止しました。対処は、v3.2.5のバンドルをインストールして(qorechaindとlib/の共有ライブラリが一緒に入っています。並べて置いてください)再起動することで、ノードのステートは保持されます。

メインネットのv3.2.6(ブロック高4,020,000、2026年11月4日、ガバナンス提案15)。 同じ手順が適用されました。マニフェストはversionとminCompatibleの両方に3.2.6を示し、まだv3.2.5のノードはプランの高さでUPGRADE "v3.2.6" NEEDEDと表示されて停止します。v3.2.6のバンドルをインストールして再起動してください。署名(sign-bytes v2)、アドレス、小数桁数、メモ、手数料は変更されておらず、マニフェストはオペレーターにクロックをNTPで同期させておくよう求めています。メインネットではGET /cosmos/upgrade/v1beta1/applied_plan/v3.2.6が{"height":"4020000"}を返します。メインネットのこれ以降のアップグレードは予定されていません。

メインネットのv3.2.7(ブロック高4,164,600、2026年11月12日、ガバナンス提案16)。 同じ手順が適用されました。マニフェストはversionとminCompatibleの両方に3.2.7を示し、まだv3.2.6のノードはプランの高さでUPGRADE "v3.2.7" NEEDEDと表示されて停止します。v3.2.7のバンドルをインストールして再起動してください。メインネットではGET /cosmos/upgrade/v1beta1/applied_plan/v3.2.7が{"height":"4164600"}を返します。このアップグレードで11個のプロトコル機能(ハイブリッドのポスト量子マルチシグ、ポスト量子検証1回あたり固定2,000ガス、EVMウィンドウイベント、RDK検証鍵メッセージ、SVMのアドレスとクロスVMに関するいくつかの修正)が有効になり、合計は101個です。メインネットでは、SVMレーン、クロスVM呼び出し、CosmWasmのアップロードとインスタンス化はオフのままです。

ライブの記録はGET /cosmos/upgrade/v1beta1/applied_plan/<name>(0は未適用)で、保留中のプランはGET /cosmos/upgrade/v1beta1/current_planで確認できます。v3.2.2ではコンセンサスエンジン、Cosmos SDK(v0.53.8)、IBCの依存関係が引き上げられ、SDKのより厳格なトランザクションチェックにより、このリリースはノードごとの入れ替えではなく、アップグレード高で以前のバイナリを置き換える形になります。トランザクションの署名、アドレス、小数点桁数、メモ、手数料は、v3.2.2でもv3.2.3でも変更されていません。

ステートシンクとクロック。 ステートシンクは、マニフェストのstateSyncブロック(trustHeight、trustHash、1時間ごとに更新)から信頼点を取得します。そこに記載されているRPCサーバーはプロジェクト自身のものであるため、本番ノードでは信頼できるRPCサーバーを追加し、信頼ハッシュを別の情報源と照合してください。クロックはNTPで同期させておいてください。ネットワークとのずれが60秒を超えると、ノードは停止します。


プルーニングとインデックス​

統合の用途に合わせて、プルーニングとトランザクションインデックスを調整してください。完全なトランザクション履歴を必要とする取引所は、最小限のプルーニングとトランザクションインデクサーを有効にした状態で運用する必要があります。

プルーニング(app.toml)​

# 最近の状態のみ保持——ディスク使用量が最小
pruning = "default"

# すべて保持——アーカイブ/完全な履歴クエリに必要
# pruning = "nothing"
pruning挙動用途
default最近の状態を保持し、それ以外はプルーニングするRPCノード、残高/状態の照会
nothingすべての履歴状態を保持するアーカイブノード、完全な履歴
customオペレーターが定義する保持/間隔の値保持期間のチューニング

v3.2.8 のコントラクトランタイム​

リリース v3.2.8 のノード(後のメインネットアップグレードまではテストネットのみ)には、次が必要です。バンドルの lib/ ディレクトリ全体(libwasmvm、libqorepqc、libqoresvm と並んで libwasmvmqore を含みます)。256 MiB 以上の [wasm] memory_cache_size(これより小さい値は警告とともに 256 に引き上げられるため、メモリを見込んでください)。コントラクトコードのディレクトリは <home>/wasm(別の場所にある既存のコードディレクトリは、警告付きで引き続き動作します)。新しい app.toml では simulation_gas_limit = 50000000 も設定され、JSON-RPC の名前空間 eth,net,web3 が提供されます。

ノードの制限(app.toml)​

ノードリリースv3.2.1以降、initは3つのノードローカルな制限を持つ[qorechain]セクションを書き込みます。これらが変更するのは、このノードがメモリに保持するものと、提案するブロックに含めるものだけであり、ブロックが有効であるために含まなければならない内容を変えることはありません。

[qorechain]
# Maximum number of Cosmos transactions held in the app-side mempool (default 5000).
# When full, a new transaction that pays more per gas evicts the lowest-paying one; otherwise it is refused.
cosmos-mempool-max-txs = 5000

# Time the node may spend selecting transactions for a proposal before it proposes what it has ("0s" disables the budget).
prepare-proposal-budget = "1s"

# Stop after this many candidates in a row that do not fit in the remaining block space (0 disables the cap).
prepare-proposal-max-skips = 64

initは、ネットワークのEVMチェーンIDもapp.tomlの[evm]のevm-chain-id設定に書き込みます(--chain-id qorechain-vladiでは9801、qorechain-dianaでは9800)。app.tomlに異なる値が入っているノードも起動はしますが、起動時にエラーをログに記録し、そのノード自身のJSON-RPC(eth_chainId、そのノードに対する署名)は、ファイルを修正するまで誤ったチェーンIDで応答します。コンセンサスには影響しません。古いバイナリは--chain-idに関係なくテストネットの値(9800)を書き込んでいたため、ずっと前に初期化されたメインネットノードはこの設定を確認してください。QORE_EVM_CHAIN_IDにネットワークの値以外を設定しないでください。そのようなノードは起動を拒否します。

トランザクションインデックス(config.toml)​

[tx_index]
indexer = "kv"

indexer = "kv"(またはより高機能なインデクサー)を設定し、トランザクションをハッシュやイベントで照会できるようにしてください——これはデポジットと出金を照合する取引所にとって不可欠です。過去のトランザクション照会が不要な場合のみindexer = "null"を設定してください。


統合向けエンドポイントの公開​

app.tomlで、インテグレーターに必要なAPIサーバーを有効化・バインドします。

[api]
enable = true
address = "tcp://0.0.0.0:1317"

[grpc]
enable = true
address = "0.0.0.0:9090"

[json-rpc]
enable = true
address = "0.0.0.0:8545"
ws-address = "0.0.0.0:8546"
api = "eth,net,web3,txpool"

ノードリリースv3.2.4のJSON-RPC制限。 v3.2.4バイナリを実行するノード(テストネットでは2026年10月19日から、メインネットでは2026年10月23日から)は、自身のJSON-RPCサーバーに制限を設けます。これらはapp.tomlの[json-rpc]セクションにあるノードローカルの設定で、コンセンサスには影響しません。http-body-limit(デフォルトは262144バイト、256 KiB。これより大きいリクエストボディは、読み込まれる前にHTTP 413で拒否されます)、max-concurrent-requests(デフォルトは256。これを超えるリクエストは直ちにHTTP 503を受け取ります)、max-open-connections(値が未設定または0の場合は、無制限ではなく1000を意味するようになりました)です。加えて、eth_getLogsとeth_newFilterのフィルター引数は、トピック位置が4つを超える場合、1つの位置の候補が1000を超える場合、またはアドレスが1000を超える場合に拒否されます。非常に大きなバッチリクエストやコントラクトデプロイのリクエストを自分のノードに送るインテグレーターは、最大のリクエストがボディ制限に収まるかを確認し、必要であれば引き上げてください。

公開エンドポイントはeth_、net_、web3_、txpool_(ステータスのみ)の各名前空間を提供します。v3.2.3以降で初期化されたノードは、デフォルトでeth,net,web3となり、txpoolは含まれません(ノードの保留中トランザクションを公開してしまうため)。必要な場合にのみ追加してください。qor_名前空間はリリース済みのどのノードビルドでも提供されていないため、追加しないでください(qor_名前空間を参照)。

そしてconfig.tomlでRPCリスナーを設定します。

[rpc]
laddr = "tcp://0.0.0.0:26657"
エンドポイントポート用途
RPC26657トランザクションのブロードキャスト、ブロック/ステータスの照会
REST1317チェーン状態のHTTP照会
gRPC9090高スループットなプログラムからのアクセス
EVM JSON-RPC8545Ethereum互換の統合(チェーンID 9801)
EVM WS8546EVMイベントの購読
SVM RPC8899Solana互換の読み取り(SVMトランザクションは無効)
警告

リバースプロキシ、レート制限、認証、ファイアウォールなしに、RPC、EVM JSON-RPC、gRPCを直接インターネットに公開しないでください。0.0.0.0へのバインドは、制御された入口層の背後でのみ行ってください。


ヘルスと同期の監視​

同期ステータス​

curl -s localhost:26657/status | jq '.result.sync_info.catching_up'
  • true — 同期中。
  • false — 完全に同期済みで、現在の状態を提供中。
# Latest height and network
curl -s localhost:26657/status | jq '.result.sync_info.latest_block_height, .result.node_info.network'

networkフィールドには、qorechain-vladi(メインネット)またはqorechain-diana(テストネット)が表示されるはずです。

PrometheusとGrafana​

ノードはポート26660でPrometheusメトリクスを公開できます(config.tomlの[instrumentation]セクションでprometheus = trueを設定します)。

http://localhost:26660/metrics

Prometheus互換の任意のコレクターでこれをスクレイプしてください。Docker Composeの監視スタックを実行している場合、Grafanaはhttp://localhost:3001で利用でき——初回ログイン時に自分の認証情報を設定してください。ブロック高の遅延、ピア数、リソース使用状況を追跡し、catching_upがtrueのままになった場合やピア数がゼロになった場合はアラートを出してください。

EVMエンドポイントの確認​

curl -s -X POST http://localhost:8545 \
-H "Content-Type: application/json" \
-d '{"jsonrpc":"2.0","method":"eth_chainId","params":[],"id":1}'
# Expect "0x2649" (9801) on mainnet

運用上のベストプラクティス​

  1. チェーンバージョンを固定する。 マニフェストが推奨するリリース(執筆時点で、メインネットはv3.2.7、テストネットはv3.2.8)を実行し、協調アップグレードのため公式リリースを追跡し、システムクロックをNTPで同期させておいてください。

  2. 冗長なノードを運用する。 単一ノードの再起動や再同期が統合トラフィックを中断させないよう、ロードバランサーの背後に少なくとも2台のノードを配置してください。

  3. ジェネシスとスナップショットを検証する。 起動前に、必ずジェネシスのSHA-256と、あらゆるスナップショットのチェックサムを公式リリースと照合してください。

  4. 公開エンドポイントを保護する。 RPC/EVM/gRPCの前段にリバースプロキシ、レート制限、ファイアウォールを設置してください。認証のない書き込み用RPCを絶対にインターネットへ公開しないでください。

  5. プルーニングを用途に合わせる。 完全な入出金履歴を照合する取引所にはpruning = "nothing"とtx_index = "kv"を、軽量な照会にはdefaultを使用してください。

  6. 同期を継続的に監視する。 ブロック高の遅延、ピア数ゼロ、catching_upで行き詰まったノードについてアラートを設定してください。

ノードのみのデプロイは署名を一切行いません。統合がこのノード経由でブロードキャストするトランザクションは、あらかじめハイブリッドのポスト量子署名を備えている必要があります(またEVMレーンでは、送信者に登録済みの鍵と開いている認可ウィンドウが必要です)。取引所統合およびポスト量子署名を参照してください。

フルノードを実行せずにネットワークを観察するには、ライトノードのドキュメントを参照してください。


トラブルシューティング​

ノードがクロックエラーで停止する​

ノードリリースv3.2.1以降、システムクロックがネットワークと60秒を超えてずれると、コンセンサスエンジンが停止します。NTPクライアント(chronyまたはsystemd-timesyncd)を実行し、timedatectl statusでクロックが同期されていることを確認してから、ノードを再起動してください。

アップグレード前に停止していたノードがバイナリ差し替え後も再開しない​

ノードがバイナリをアップグレードする前に既に停止またはスタックしていた場合、単に新しいバイナリを配置して再起動するだけでは不十分です——ノードは古い実行時のABCI結果をキャッシュしたままであり、停止の原因となったブロックを再実行しません。再起動の前に明示的にロールバックしてください。

qorechaind rollback --home <HOME>
systemctl restart <unit>

コマンドはqorechaind rollback(トップレベルのサブコマンド)です——comet rollbackというサブコマンドは存在せず、これに--hardフラグもありません。

priv_validator_state.jsonが欠落してスナップショット復元がクラッシュループする​

公開されているアーカイブ/スナップショットにはdata/priv_validator_state.jsonが含まれておらず、ノードはこのファイルがないと起動を拒否します。スナップショット復元後にこのファイルが欠落している場合は作成してください——ただし存在しない場合に限ります。実在するファイルを絶対に上書きしないでください。バリデーターにおいて、このファイルは二重署名防止のガードであり、これを上書きすると二重署名のリスクが生じます。

echo '{"height":"0","round":0,"step":0}' > <HOME>/data/priv_validator_state.json

次のステップ​