node commands

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


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.

Use --long for extended build details including Go version, commit hash, and build tags:


status

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

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

Get a Configuration Value

Common configuration keys include chain-id, keyring-backend, output, and node.


keys

Manage local keyring for signing transactions.

Add a New Key

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

Show Key Details

Flag
Type
Description

--bech

string

Output format: acc, val, cons

--address

bool

Show address only

--pubkey

bool

Show public key only

Delete a Key

Export a Key (Armor-Encrypted)

Import a Key


genesis

Manage the genesis file.

Add a Genesis Account

Flag
Type
Description

--vesting-amount

string

Vesting amount

--vesting-end-time

int

Vesting end time (Unix timestamp)

Create a Genesis Transaction

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

Validate the Genesis File


Consensus Engine

These subcommands interact with the QoreChain Consensus Engine layer.

Show Validator Key

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

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.

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.

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.