Skip to main content

Node Commands

Reference for qorechaind commands used to initialize, configure, and operate a QoreChain node.

note

QoreChain runs two networks: the qorechain-vladi mainnet (live since 7 June 2026; node release v3.2.7, applied at height 4,164,600 on 12 November 2026 by governance proposal 16; v3.2.6 was applied at height 4,020,000 on 4 November 2026; v3.2.5 was applied at height 3,906,833 on 29 October 2026, v3.2.4 at height 3,742,566 on 23 October 2026 and v3.2.3 at height 3,662,051 on 20 October 2026) and the qorechain-diana testnet (node release v3.2.8, applied at height 9,929,500 on 12 November 2026, after v3.2.7 at height 9,594,600 on 6 November, v3.2.6 at height 8,970,638 on 27 October, v3.2.5 at height 8,890,800 on 26 October and v3.2.4 at height 8,337,253 on 19 October; mainnet has not applied v3.2.8). Pass the appropriate --chain-id for the network you intend to join — the examples below target the testnet; use --chain-id qorechain-vladi for mainnet. The current release for each network is listed in latest.json under download.qore.host.

The commands on this page were checked against the v3.2.3 release binary. The v3.2.4 binary adds commands that a v3.2.3 binary does not have (for example stakingtier); they run on both networks (testnet since 19 October 2026, mainnet since 23 October 2026), and where this manual mentions one it says so. The v3.2.6 binary (both networks) adds two more query commands, query rlconsensus applied-params and last-action (see Query Commands). Everything else on this page behaves the same on both releases.


init​

Initialize a new node with the given moniker.

qorechaind init <moniker> --chain-id qorechain-diana
FlagTypeDescription
--chain-idstringChain identifier (always pass it; a random one is created if left out)
--homestringNode home directory (default: ~/.qorechaind)
--overwriteboolOverwrite the existing genesis.json
--recoverboolProvide a seed phrase to recover an existing key instead of creating one

Creates the directory structure under --home with config/, data/, and an initial genesis.json. For a network node, replace that genesis.json with the network's genesis file before starting (see Connecting to Mainnet).

init also writes the network's EVM chain id (9801 for qorechain-vladi, 9800 for qorechain-diana) into the evm-chain-id setting of app.toml, so pass the right --chain-id.


start​

Start the node and begin syncing or producing blocks.

qorechaind start [flags]
FlagTypeDescription
--homestringNode home directory
--minimum-gas-pricesstringMinimum gas price this node accepts. The network floor is 0.1uqor; set at least that
--pruningstringPruning strategy: default, nothing, everything, custom (with --pruning-keep-recent and --pruning-interval)
--halt-heightuintStop the node at this block height
--halt-timeuintStop the node at this Unix timestamp
--log_levelstringLog verbosity: info, debug, warn, error
--traceboolEnable full stack trace on errors

A binary built from the public source tree (the community build) refuses to start on qorechain-vladi or qorechain-diana: it cannot verify post-quantum signatures and cannot replay the networks' blocks faithfully (node release v3.2.3 and later). Use the release binary from download.qore.host; see Building from Source.


version​

qorechaind version does not report the release number on the release binaries: it prints an empty line, and version --long adds no build details. Do not rely on it to tell releases apart. To confirm what you run:

  • Compare the SHA-256 of the downloaded archive with binary.sha256 in the network's manifest before you extract it (and keep that archive, or its checksum, as the record of what you installed).
  • Ask the chain which upgrades it has applied: GET /cosmos/upgrade/v1beta1/applied_plan/<upgrade_name> returns the height an upgrade was applied at, or 0 if it has not been applied.
# 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​

Query the running node for its current status, including sync state, latest block height, and consensus information.

qorechaind status
FlagTypeDescription
--nodestringRPC endpoint (default: tcp://localhost:26657)

Returns JSON with node_info, sync_info, and validator_info sections.


client configuration​

There is no config subcommand. Client defaults (chain-id, keyring-backend, output, node) are read from <home>/config/client.toml; edit that file, or pass the flag on each command (--chain-id, --keyring-backend, --output, --node).


keys​

Manage local keyring for signing transactions.

Add a New Key​

qorechaind keys add <name> [flags]
FlagTypeDescription
--keyring-backendstringBackend: os, file, kwallet, pass, test, memory
--key-typestringKey algorithm: secp256k1 (default) or eth_secp256k1
--coin-typeuint32HD coin type (default 118)
--recoverboolRecover key from mnemonic
--multisigstringComma-separated list of keys for multisig
--multisig-thresholduintMinimum signatures required

List All Keys​

qorechaind keys list --keyring-backend <backend>

Show Key Details​

qorechaind keys show <name> [flags]
FlagTypeDescription
--bechstringOutput format: acc, val, cons
--addressboolShow address only
--pubkeyboolShow public key only

Delete a Key​

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

Export a Key (Armor-Encrypted)​

qorechaind keys export <name>

Import a Key​

qorechaind keys import <name> <keyfile>

genesis​

Manage the genesis file.

Add a Genesis Account​

qorechaind genesis add-genesis-account <address> <coins> [flags]
FlagTypeDescription
--vesting-amountstringVesting amount
--vesting-start-timeintVesting start time (Unix timestamp)
--vesting-end-timeintVesting end time (Unix timestamp)

Create a Genesis Transaction​

qorechaind genesis gentx <key-name> <stake-amount> [flags]
FlagTypeDescription
--chain-idstringChain identifier
--monikerstringValidator moniker
--commission-ratestringInitial commission rate
--commission-max-ratestringMaximum commission rate

Collect Genesis Transactions​

qorechaind genesis collect-gentxs

Other genesis subcommands: bulk-add-genesis-account and migrate.

Validate the Genesis File​

qorechaind genesis validate

Consensus Engine​

These subcommands interact with the QoreChain Consensus Engine layer.

Show Validator Key​

qorechaind comet show-validator

Outputs the consensus public key in JSON format. Used to verify validator identity.

Show Node ID​

qorechaind comet show-node-id

Outputs the P2P node identifier (hex-encoded). Used for persistent peer configuration.


export​

Export the current chain state as a JSON genesis file. Useful for chain upgrades or snapshots.

qorechaind export [flags]
FlagTypeDescription
--for-zero-heightboolPrepare export for restarting at height 0
--heightintExport state at a specific block height
--homestringNode home directory
--output-documentstringWrite the export to this file instead of STDOUT
--modules-to-exportstringsComma-separated list of modules to export (default: all)
--jail-allowed-addrsstringsOperator addresses of jailed validators to unjail

rollback​

Roll back the chain state by one block. Useful for recovering from a consensus failure.

qorechaind rollback [flags]
FlagTypeDescription
--hardboolRemove the last block from the block store as well
--homestringNode home directory

This command rolls back both the application state and the consensus state. Use with caution, as it cannot be undone.