Node Commands
Reference for qorechaind commands used to initialize, configure, and operate a QoreChain node.
QoreChain runs two networks: the qorechain-vladi mainnet (live since 7 June 2026 on chain version v3.1.85) and the qorechain-diana testnet. 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.
init
Initialize a new node with the given moniker.
qorechaind init <moniker> --chain-id qorechain-diana
| Flag | Type | Description |
|---|---|---|
--chain-id | string | Chain identifier (required) |
--home | string | Node home directory (default: ~/.qorechaind) |
--overwrite | bool | Overwrite existing genesis and config files |
Creates the directory structure under --home with config/, data/, and an initial genesis.json.
start
Start the node and begin syncing or producing blocks.
qorechaind start [flags]
| Flag | Type | Description |
|---|---|---|
--home | string | Node home directory |
--minimum-gas-prices | string | Minimum gas prices to accept (e.g., 0.001uqor) |
--pruning | string | Pruning strategy: default, nothing, everything |
--halt-height | uint | Stop the node at this block height |
--halt-time | uint | Stop the node at this Unix timestamp |
--log_level | string | Log verbosity: info, debug, warn, error |
--trace | bool | Enable full stack trace on errors |
version
Print the qorechaind binary version and build information.
qorechaind version
Use --long for extended build details including Go version, commit hash, and build tags:
qorechaind version --long
status
Query the running node for its current status, including sync state, latest block height, and consensus information.
qorechaind status
| Flag | Type | Description |
|---|---|---|
--node | string | RPC endpoint (default: tcp://localhost:26657) |
Returns JSON with node_info, sync_info, and validator_info sections.
config
Read or write values in the node configuration.
Set a Configuration Value
qorechaind config set <key> <value>
Get a Configuration Value
qorechaind config get <key>
Common configuration keys include chain-id, keyring-backend, output, and node.
keys
Manage local keyring for signing transactions.
Add a New Key
qorechaind keys add <name> [flags]
| Flag | Type | Description |
|---|---|---|
--keyring-backend | string | Backend: os, file, test |
--algo | string | Key algorithm: secp256k1 (default), ed25519 |
--recover | bool | Recover key from mnemonic |
--multisig | string | Comma-separated list of keys for multisig |
--multisig-threshold | uint | Minimum signatures required |
List All Keys
qorechaind keys list --keyring-backend <backend>
Show Key Details
qorechaind keys show <name> [flags]
| Flag | Type | Description |
|---|---|---|
--bech | string | Output format: acc, val, cons |
--address | bool | Show address only |
--pubkey | bool | Show 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]
| Flag | Type | Description |
|---|---|---|
--vesting-amount | string | Vesting amount |
--vesting-end-time | int | Vesting end time (Unix timestamp) |
Create a Genesis Transaction
qorechaind genesis gentx <key-name> <stake-amount> [flags]
| Flag | Type | Description |
|---|---|---|
--chain-id | string | Chain identifier |
--moniker | string | Validator moniker |
--commission-rate | string | Initial commission rate |
--commission-max-rate | string | Maximum commission rate |
Collect Genesis Transactions
qorechaind genesis collect-gentxs
Validate the Genesis File
qorechaind genesis validate-genesis
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]
| Flag | Type | Description |
|---|---|---|
--for-zero-height | bool | Prepare export for restarting at height 0 |
--height | int | Export state at a specific block height |
--home | string | Node home directory |
rollback
Roll back the chain state by one block. Useful for recovering from a consensus failure.
qorechaind rollback [flags]
| Flag | Type | Description |
|---|---|---|
--hard | bool | Remove the last block from the block store as well |
--home | string | Node home directory |
This command rolls back both the application state and the consensus state. Use with caution, as it cannot be undone.