CLI Reference

Conventions

The CLI binary is valdium-cli. Every command takes the form valdium-cli <group> <verb> [args] [flags]. Run with no args to see the top-level help; run with --help on any subcommand for that command's flags.

Flags that are common to most commands:

--rpc <url> — node to talk to. Defaults to https://testnet.valdium.xyz/rpc.
--from <name|address> — wallet to sign with. Defaults to default.
--json — output machine-readable JSON instead of human-readable text.
--verbose — log every RPC call to stderr.
--quiet — suppress non-essential output.

wallet

Command	What it does
`wallet create [name]`	Generate a new Dilithium3 keypair, save to keystore
`wallet import [name]`	Import from a 24-word recovery phrase
`wallet list`	List known wallets and their addresses
`wallet show <name>`	Print the address and metadata of a wallet
`wallet export <name>`	Print the recovery phrase (prompts for passphrase)
`wallet remove <name>`	Delete a wallet from the keystore
`wallet rename <old> <new>`	Rename a wallet in the keystore

balance

valdium-cli balance <address|wallet-name> [--at <block>]

Print the VLD balance of an address. Use --at with a block number or latest / pending.

send

valdium-cli send <to> <amount> [--data 0x...] [--from name]

Build, sign, and broadcast a VLD transfer. amount is in VLD (e.g. 1.5) — converted to wei internally.

tx

Command	What it does
`tx show <hash>`	Pretty-print a transaction and its receipt
`tx wait <hash>`	Block until the tx is mined; exit non-zero on revert
`tx replace <hash> --gas <n>`	Bump gas on a stuck pending tx
`tx cancel <hash>`	Submit a 0-value self-send at the same nonce to cancel a pending tx

contract

Command	What it does
`contract call <addr> <fn> [args]`	Read call — no signing, no gas
`contract send <addr> <fn> [args]`	Write call — signs and broadcasts
`contract show <addr>`	Print code, ABI (if verified), deployed block
`contract verify <addr>`	Submit source for verification — see Verifying Contracts

deploy

valdium-cli deploy <path> [--constructor-args ...] [--verify]

Compile, deploy, and optionally verify. Path is the entry file; the bundler walks imports. The deployed address prints to stdout.

stake

Command	What it does
`stake delegate --to <validator> --amount <vld>`	Delegate to a validator
`stake undelegate --from <validator> --amount <vld>`	Begin a 14-day unbond
`stake redelegate --from <a> --to <b> --amount <vld>`	Move stake without unbonding
`stake claim`	Pull accrued rewards to the spending balance
`stake status`	Show delegations, pending unbonds, claimable rewards

validator

Command	What it does
`validator key new`	Generate a fresh validator key
`validator key show`	Print public validator info — address, pubkey
`validator bond --amount <vld>`	Bond the validator (registers in the active-set queue)
`validator unbond`	Exit the active set (14-day cooldown)
`validator status`	Stake, missed slots, jail state, rewards earned
`validator unjail`	Re-enter the active set after a downtime jail

node

Command	What it does
`node status`	Height, peers, sync state, uptime
`node peers`	List connected peers with version + ping
`node start`	Start the local node (if not running under systemd)
`node stop`	Clean shutdown
`node reset --confirm`	Wipe chain data, keep keystore

chain

Command	What it does
`chain head`	Latest block, one line
`chain block <n\|hash>`	Full block
`chain total-supply [--at block]`	Current circulating supply
`chain emission [--epoch n]`	Validator pool emission for an epoch

config

Command	What it does
`config set rpc <url>`	Default RPC endpoint
`config set default-wallet <name>`	Default `--from` wallet
`config show`	Print effective config
`config path`	Print the config file location

test

valdium-cli test [path] [--coverage] [--watch]

Run the in-process VM test runner. See Testing Contracts for the full surface.

version

valdium-cli version prints the CLI version, node binary version, and protocol version separately. Useful when filing bug reports.

Reference · JSON-RPC API → Reference · Glossary →