Skip to main content

Validator Commands

This is a comprehensive reference for Helix validator-related commands.

Node Management

CommandDescription
nuklaid startStart the Helix node
nuklaid statusCheck node status
nuklaid tendermint show-node-idOutput the node's ID
nuklaid tendermint show-validatorShow your validator public key
nuklaid tendermint unsafe-reset-allReset node state (Be careful here)

Validator Operations

CommandDescription
nuklaid tx staking create-validatorCreate a new validator
nuklaid tx staking edit-validatorEdit your validator properties
nuklaid tx staking delegateDelegate tokens to a validator
nuklaid tx staking redelegateRedelegate tokens to another validator
nuklaid tx staking unbondUnbond tokens from a validator
nuklaid tx slashing unjailUnjail a jailed validator

Staking Queries

CommandDescription
nuklaid query staking validatorsList all validators
nuklaid query staking validator <addr>View validator details
nuklaid query staking delegationQuery a delegation
nuklaid query staking delegations-to <val-addr>List all delegations to a validator
nuklaid query staking paramsShow staking parameters

Distribution Commands

CommandDescription
nuklaid query distribution rewardsCheck your accumulated rewards
nuklaid query distribution commissionCheck a validator commission
nuklaid query distribution paramsShow distribution parameters
nuklaid tx distribution withdraw-rewardsWithdraw staking rewards
nuklaid tx distribution withdraw-all-rewardsWithdraw all rewards
nuklaid tx distribution withdraw-validator-commissionWithdraw validator commission

Slashing Commands

CommandDescription
nuklaid query slashing paramsShow slashing parameters
nuklaid query slashing signing-infoShow your validator signing info

Consensus Status

CommandDescription
nuklaid query tendermint-validator-setList validators in the active set
nuklaid query blockGet block details at height (or latest)
nuklaid query txQuery a transaction by hash

Configuration

Each Helix node has two primary configuration files:

config.toml

Contains CometBFT-specific settings:

cat ~/.nuklai/config/config.toml

Key settings:

  • moniker: Your node name
  • persistent_peers: Persistent P2P connections
  • timeout_commit: Block time target
  • priv_validator_key_file: Validator key location
  • external_address: Public endpoint for P2P discovery

app.toml

Contains app-specific settings:

cat ~/.nuklai/config/app.toml

Key settings:

  • minimum-gas-prices: Minimum acceptable gas price
  • pruning: State pruning configuration
  • API server settings (api section)
  • gRPC configuration (grpc section)

Common Command Flags

FlagDescription
--fromSigning key name
--keyring-backendKeyring backend (test, os, file)
--chain-idChain ID
--gasGas limit (auto for automatic)
--gas-pricesGas price (e.g. 0.025nai)
--gas-adjustmentAdjustment factor for auto gas (e.g. 1.5)
--broadcast-modesync, async, or block
--homeConfig/data directory