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

ノードコマンド

QoreChainノードの初期化・設定・運用に使用する qorechaind コマンドのリファレンスです。

注記

QoreChainは2つのネットワークを運用しています。qorechain-vladi メインネット(2026年6月7日から稼働中、ノードリリース v3.2.7、2026年11月12日にガバナンス提案 16 によりブロック高 4,164,600 で適用。v3.2.6 は2026年11月4日にブロック高 4,020,000 で、v3.2.5 は2026年10月29日にブロック高 3,906,833 で、v3.2.4 は2026年10月23日にブロック高 3,742,566 で、v3.2.3 は2026年10月20日にブロック高 3,662,051 で適用)と、qorechain-diana テストネット(ノードリリース v3.2.8、2026年11月12日にブロック高 9,929,500 で適用。その前に v3.2.7 が11月6日にブロック高 9,594,600 で、v3.2.6 が10月27日にブロック高 8,970,638 で、v3.2.5 が10月26日にブロック高 8,890,800 で、v3.2.4 が10月19日にブロック高 8,337,253 で適用。メインネットは v3.2.8 を適用していません)です。参加するネットワークに応じて適切な --chain-id を指定してください — 以下の例はテストネットを対象としています。メインネットの場合は --chain-id qorechain-vladi を使用してください。各ネットワークの現在のリリースは、download.qore.host の latest.json に記載されています。

このページのコマンドは、v3.2.3 のリリースバイナリで確認しています。v3.2.4 バイナリには、v3.2.3 バイナリにはないコマンド(例: stakingtier)が追加されています。これらは両ネットワークで動作します(テストネットでは2026年10月19日から、メインネットでは2026年10月23日から)。このマニュアルでそれに触れる箇所には、その旨を明記しています。v3.2.6 バイナリ(両ネットワーク)には、さらに2つのクエリコマンド query rlconsensus applied-params と last-action が追加されています(クエリコマンドを参照)。このページのそれ以外はすべて、両リリースで同じように動作します。


init​

指定したモニカーで新しいノードを初期化します。

qorechaind init <moniker> --chain-id qorechain-diana
フラグ型説明
--chain-idstringチェーン識別子(常に指定してください。省略するとランダムなものが作成されます)
--homestringノードのホームディレクトリ(デフォルト: ~/.qorechaind)
--overwritebool既存の genesis.json を上書きします
--recoverboolキーを新規作成する代わりに、シードフレーズを指定して既存のキーを復元します

--home の下に config/、data/、および初期の genesis.json を含むディレクトリ構造を作成します。ネットワークノードの場合は、起動前にこの genesis.json をそのネットワークのgenesisファイルに置き換えてください(メインネットへの接続を参照)。

init は、そのネットワークのEVMチェーンID(qorechain-vladi は 9801、qorechain-diana は 9800)も app.toml の evm-chain-id 設定に書き込むため、正しい --chain-id を指定してください。


start​

ノードを起動し、同期またはブロック生成を開始します。

qorechaind start [flags]
フラグ型説明
--homestringノードのホームディレクトリ
--minimum-gas-pricesstringこのノードが受け入れる最小ガス価格。ネットワークの下限は 0.1uqor です。少なくともこの値を設定してください
--pruningstringプルーニング戦略: default、nothing、everything、custom(--pruning-keep-recent および --pruning-interval と併用)
--halt-heightuintこのブロック高でノードを停止します
--halt-timeuintこのUnixタイムスタンプでノードを停止します
--log_levelstringログの詳細度: info、debug、warn、error
--traceboolエラー時に完全なスタックトレースを有効にします

公開ソースツリーからビルドしたバイナリ(コミュニティビルド)は、qorechain-vladi や qorechain-diana では起動を拒否します。このバイナリはポスト量子署名を検証できず、ネットワークのブロックを忠実にリプレイできないためです(ノードリリース v3.2.3 以降)。download.qore.host のリリースバイナリを使用してください。ソースからのビルドも参照してください。


version​

qorechaind version はリリースバイナリではリリース番号を表示しません。空行が出力されるだけで、version --long を付けてもビルド詳細は追加されません。リリースの区別にこれを使わないでください。実行中のものを確認するには次の方法を使います。

  • 展開する前に、ダウンロードしたアーカイブのSHA-256を、ネットワークのマニフェストにある binary.sha256 と比較します(インストールしたものの記録として、そのアーカイブまたはそのチェックサムを保管してください)。
  • チェーンに適用済みのアップグレードを問い合わせます。GET /cosmos/upgrade/v1beta1/applied_plan/<upgrade_name> は、アップグレードが適用されたブロック高を返し、未適用の場合は 0 を返します。
# archive checksum, as published
curl -s https://download.qore.host/mainnet/latest.json | jq -r '.version, .binary.sha256'
# has v3.2.3 / v3.2.4 / v3.2.5 / v3.2.6 / v3.2.7 been applied on mainnet, and at which height? (a name that was not applied returns {"height":"0"})
curl -s https://api.qore.host/cosmos/upgrade/v1beta1/applied_plan/v3.2.3 # {"height":"3662051"}
curl -s https://api.qore.host/cosmos/upgrade/v1beta1/applied_plan/v3.2.4 # {"height":"3742566"}
curl -s https://api.qore.host/cosmos/upgrade/v1beta1/applied_plan/v3.2.6 # {"height":"4020000"}
curl -s https://api.qore.host/cosmos/upgrade/v1beta1/applied_plan/v3.2.7 # {"height":"4164600"}

status​

実行中のノードに対して、同期状態、最新のブロック高、コンセンサス情報を含む現在のステータスを照会します。

qorechaind status
フラグ型説明
--nodestringRPCエンドポイント(デフォルト: tcp://localhost:26657)

node_info、sync_info、validator_info セクションを含むJSONを返します。


client configuration​

config サブコマンドはありません。クライアントのデフォルト値(chain-id、keyring-backend、output、node)は <home>/config/client.toml から読み込まれます。このファイルを編集するか、コマンドごとにフラグ(--chain-id、--keyring-backend、--output、--node)を指定してください。


keys​

トランザクション署名用のローカルキーリングを管理します。

新しいキーの追加​

qorechaind keys add <name> [flags]
フラグ型説明
--keyring-backendstringバックエンド: os、file、kwallet、pass、test、memory
--key-typestringキーアルゴリズム: secp256k1(デフォルト)または eth_secp256k1
--coin-typeuint32HDコインタイプ(デフォルト 118)
--recoverboolニーモニックからキーを復元します
--multisigstringマルチシグ用のキーのカンマ区切りリスト
--multisig-thresholduint必要な最小署名数

すべてのキーの一覧表示​

qorechaind keys list --keyring-backend <backend>

キー詳細の表示​

qorechaind keys show <name> [flags]
フラグ型説明
--bechstring出力形式: acc、val、cons
--addressboolアドレスのみを表示します
--pubkeybool公開鍵のみを表示します

キーの削除​

qorechaind keys delete <name> --keyring-backend <backend>

キーのエクスポート(アーマー暗号化)​

qorechaind keys export <name>

キーのインポート​

qorechaind keys import <name> <keyfile>

genesis​

genesisファイルを管理します。

genesisアカウントの追加​

qorechaind genesis add-genesis-account <address> <coins> [flags]
フラグ型説明
--vesting-amountstringベスティング額
--vesting-start-timeintベスティング開始時刻(Unixタイムスタンプ)
--vesting-end-timeintベスティング終了時刻(Unixタイムスタンプ)

genesisトランザクションの作成​

qorechaind genesis gentx <key-name> <stake-amount> [flags]
フラグ型説明
--chain-idstringチェーン識別子
--monikerstringバリデーターのモニカー
--commission-ratestring初期コミッション率
--commission-max-ratestring最大コミッション率

genesisトランザクションの収集​

qorechaind genesis collect-gentxs

genesis のその他のサブコマンド: bulk-add-genesis-account と migrate。

genesisファイルの検証​

qorechaind genesis validate

コンセンサスエンジン​

これらのサブコマンドは、QoreChainコンセンサスエンジン層と対話します。

バリデーターキーの表示​

qorechaind comet show-validator

コンセンサス公開鍵をJSON形式で出力します。バリデーターの識別情報の検証に使用します。

ノードIDの表示​

qorechaind comet show-node-id

P2Pノード識別子(16進エンコード)を出力します。永続ピア設定に使用します。


export​

現在のチェーン状態をJSON形式のgenesisファイルとしてエクスポートします。チェーンのアップグレードやスナップショットに便利です。

qorechaind export [flags]
フラグ型説明
--for-zero-heightbool高さ0での再起動用にエクスポートを準備します
--heightint特定のブロック高で状態をエクスポートします
--homestringノードのホームディレクトリ
--output-documentstringエクスポートをSTDOUTではなくこのファイルに書き込みます
--modules-to-exportstringsエクスポートするモジュールのカンマ区切りリスト(デフォルト: すべて)
--jail-allowed-addrsstringsジェイルされたバリデーターのうち、ジェイル解除するもののオペレーターアドレス

rollback​

チェーン状態を1ブロック分ロールバックします。コンセンサス障害からの復旧に便利です。

qorechaind rollback [flags]
フラグ型説明
--hardboolブロックストアからも最後のブロックを削除します
--homestringノードのホームディレクトリ

このコマンドはアプリケーション状態とコンセンサス状態の両方をロールバックします。元に戻すことはできないため、注意して使用してください。