transaction commands

All transaction commands follow the pattern:

qorechaind tx <module> <command> [args] [flags]

Common flags apply to every tx subcommand:

Flag
Type
Description

--from

string

Name or address of the signing key

--chain-id

string

Chain identifier (default: from config)

--fees

string

Transaction fees (e.g., 500uqor)

--gas

string

Gas limit or auto for estimation

--gas-adjustment

float

Gas multiplier when using auto (default: 1.0)

--keyring-backend

string

Keyring backend: os, file, test

--node

string

RPC endpoint (default: tcp://localhost:26657)

--broadcast-mode

string

sync, async, or block

-y

bool

Skip confirmation prompt


bank

send

Transfer tokens from one account to another.

qorechaind tx bank send <from_address> <to_address> <amount> [flags]

staking

create-validator

Create a new validator on the network.

Flag
Type
Description

--amount

string

Self-delegation amount (e.g., 1000000uqor)

--pubkey

string

Validator consensus public key (JSON)

--moniker

string

Validator display name

--commission-rate

string

Initial commission rate (e.g., 0.10)

--commission-max-rate

string

Maximum commission rate

--commission-max-change-rate

string

Maximum daily commission change rate

--min-self-delegation

string

Minimum self-delegation required

edit-validator

Edit an existing validator's description or commission.

delegate

Delegate tokens to a validator.

redelegate

Move delegation from one validator to another.

unbond

Unbond tokens from a validator.


distribution

withdraw-all-rewards

Withdraw all pending staking rewards.

withdraw-rewards

Withdraw rewards from a specific validator.

Flag
Type
Description

--commission

bool

Also withdraw validator commission


gov

submit-proposal

Submit a governance proposal.

The proposal file is a JSON document specifying the proposal type, title, description, and any messages to execute.

vote

Vote on an active proposal.

Vote options: yes, no, abstain, no_with_veto.

deposit

Add a deposit to a proposal.


pqc

register-key

Register a post-quantum public key for an account.

register-key-v2

Register a PQC key with extended metadata and attestation.

Flag
Type
Description

--attestation

string

TEE attestation data (hex)

--metadata

string

Additional key metadata (JSON)

migrate-key

Migrate an existing classical key to a hybrid PQC key pair.


xqore

lock

Lock QOR tokens into an xQORE governance staking position.

Flag
Type
Description

--lock-duration

string

Lock duration (e.g., 30d, 90d, 180d)

unlock

Unlock xQORE back to QOR. Early unlock may incur penalties depending on the penalty tier.


bridge

deposit

Initiate a bridge deposit from an external chain.

Flag
Type
Description

--recipient

string

Recipient address on QoreChain

withdraw

Initiate a bridge withdrawal to an external chain.


crossvm

call

Send a cross-VM message between execution environments (EVM, CosmWasm, SVM).

Flag
Type
Description

--source-vm

string

Source VM: evm, cosmwasm, svm

--gas-limit

uint

Gas limit for the cross-VM execution

process-queue

Manually process pending cross-VM messages (operator command).


svm

deploy-program

Deploy a BPF program to the SVM runtime.

Flag
Type
Description

--program-id

string

Optional program ID (base58)

execute

Execute an instruction on a deployed SVM program.

Flag
Type
Description

--accounts

string

Comma-separated account pubkeys for the instruction

create-account

Create a new SVM account with allocated data space.

Flag
Type
Description

--owner

string

Owner program (base58, default: system program)


multilayer

register-sidechain

Register a new sidechain layer.

Flag
Type
Description

--anchor-interval

uint

Blocks between mandatory anchor submissions

--stake

string

Required stake amount

register-paychain

Register a new payment channel layer.

anchor-state

Submit a state anchor for a registered layer.

route-tx

Route a transaction to the optimal layer.

Flag
Type
Description

--target-layer

string

Force routing to a specific layer

update-layer-status

Update the operational status of a layer (operator only).

Status values: active, paused, draining.

challenge-anchor

Submit a fraud challenge against a state anchor.


rdk

create-rollup

Register a new rollup with the Rollup Development Kit.

Flag
Type
Description

--settlement-type

string

optimistic, zk, pessimistic, sovereign

--profile

string

Preset: defi, gaming, nft, social, general

--stake

string

Operator stake amount

--da-enabled

bool

Enable native data availability

submit-batch

Submit a settlement batch for a rollup.

challenge-batch

Submit a fraud challenge against a settlement batch (optimistic rollups).

finalize-batch

Manually finalize a batch that has passed the challenge window.

pause-rollup

Pause a rollup (operator only).

resume-rollup

Resume a paused rollup (operator only).

stop-rollup

Permanently stop a rollup and release its stake (operator only).


babylon

submit-btc-checkpoint

Submit a BTC checkpoint for an epoch.

btc-restake

Restake BTC via the Babylon integration.

Flag
Type
Description

--btc-tx-hash

string

Bitcoin transaction hash as proof


abstractaccount

create

Create an abstract account with programmable spending rules.

Flag
Type
Description

--spending-rules

string

JSON file defining spending rules

update-spending-rules

Update the spending rules for an existing abstract account.


rlconsensus

set-agent-mode

Set the RL agent operational mode (governance only).

Mode values: 0 (off), 1 (observe), 2 (suggest), 3 (auto).

resume-agent

Resume the RL agent after a circuit breaker trip.

update-policy

Update the RL agent policy configuration (governance only).

update-reward-weights

Update the reward weight configuration for the RL agent.

Flag
Type
Description

--throughput-weight

string

Weight for throughput reward

--latency-weight

string

Weight for latency reward

--security-weight

string

Weight for security reward