CLI Reference

TL;DR

The asentum binary is a single command with a handful of subcommands. Get it via curl | sh, then run asentum help for the canonical list.

Global flags

• --help, -h - print help for any subcommand
• --version - print CLI version
• --json - structured JSON output instead of pretty-printed text (pipeable)

asentum quickstart

Zero-to-funded account in one command. Creates a wallet, drips from the faucet, and prints the next-step commands.

asentum config

• config show - print the current config
• config set <key> <value> - set a config value (e.g. rpc)
• config reset - restore defaults

asentum use <account>

Switch the active wallet. Subsequent commands sign with the selected account until you switch again.

asentum chain

Inspect the live chain:

• chain status - head block, peers, chain id
• chain block <n> - fetch block by number or hash
• chain tx <hash> - transaction + receipt

asentum account

• account balance [addr] - balance of an address (defaults to active)
• account faucet - request testnet ASE
• account send <to> <amount> - transfer ASE (amount is in ASE, not wei)

deploy / call / view

• deploy <file.js> - deploy a JavaScript contract from a local file. Returns the deployed address.
• call <addr> <method> [args...] - send a signed transaction to a contract method.
• view <addr> <method> [args...] - read-only view call (no gas, no tx).

See Writing Contracts for the code side.

asentum validators

• validators list - active + pending set, with stake + status
• validators bond <amount> - bond stake and become a validator candidate
• validators unbond - start unbonding your stake

asentum consensus

Inspect live consensus state - current Aura committee, proposer, and the latest GRANDPA finality votes. For the full story see Consensus & Validators.

asentum slashing

List tombstoned validators and the evidence that triggered each slashing. Background: Slashing.

Environment variables

• ASENTUM_RPC - override the configured RPC URL
• ASENTUM_HOME - override the data directory (default ~/.asentum)
• ASENTUM_PEERS - comma-separated peer list (node mode)
• ASENTUM_PEER_RPC - peer RPC for background sync (node mode)