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 committee, proposer, last pre-votes and pre-commits. 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)