Quick Start
Install and configure the AURA CLI for treasury operations.
Pre-alpha — not production ready
@aura-protocol/cli targets Solana devnet only. APIs and commands may change without notice. Do not use for real funds until a stable release and audit are published.
@aura-protocol/cli is the terminal interface for AURA operators. It wraps the
TypeScript SDK, exposes every aura-core instruction, and routes each write
through a secure pipeline — transaction preview, preflight simulation, a mainnet
guard, and confirmations for sensitive actions. --json output makes it scriptable.
Install
npm install -g @aura-protocol/cliConfigure
aura config init
aura config set rpc-url https://devnet.helius-rpc.com/?api-key=YOUR_KEY
aura config set wallet-path ~/.config/solana/id.jsonThree ways to run an instruction
Every program instruction is reachable three ways — pick the level of ergonomics you want:
# 1. Ergonomic verbs for the common flows
aura treasury create --agent-id agent-1 --daily-limit 10000 --per-tx-limit 1000
# 2. Generated per-domain commands — full coverage, IDL-accurate
aura budget configure-budget-envelope --account treasury=<pda> --arg ...
# 3. The raw instruction surface (alias: ix) for anything
aura ix send transition_agent_state --account treasury=<pda> --arg newState=activeSee Generated Commands for how the per-domain surface is derived from the program IDL (so it never drifts).
Common Workflows
# Create a treasury and inspect it
aura treasury create --agent-id agent-1 --daily-limit 10000 --per-tx-limit 1000
aura treasury show --agent-id agent-1
# Propose, execute, and finalize
aura treasury propose --agent-id agent-1 --amount 250 --chain ethereum --recipient 0x...
aura execution execute --agent-id agent-1 --wait-signed
aura execution finalize --agent-id agent-1
# Confidential (FHE) proposal
aura confidential guardrails scalar --agent-id agent-1 --daily-limit 10000 --per-tx-limit 1000
aura confidential propose --agent-id agent-1 --amount 250 --chain ethereum --recipient 0x...
# Preview anything without sending
aura treasury propose --agent-id agent-1 --amount 250 --chain ethereum --recipient 0x... --dry-runGlobal Flags
These flags work on every command (before or after the subcommand):
| Flag | Description |
|---|---|
--rpc-url <url> | Override RPC endpoint |
--wallet <path> | Override wallet keypair path |
--program-id <id> | Override AURA program ID |
--cluster <name> | Cluster label for display |
--json | Print machine-readable JSON (implies --no-color) |
--quiet | Suppress non-error terminal output |
--dry-run | Build and preview the transaction without sending |
-y, --yes | Skip confirmation prompts (non-interactive / CI) |
--no-simulate | Skip the preflight simulation before sending |
--no-color | Disable colored output |
--compute-units <n> | Override the compute-unit limit |
Command Groups
| Group | Purpose |
|---|---|
config | Initialize and manage local CLI configuration |
treasury | Create, show, list, propose, pause, and cancel |
dwallet | Register and list dWallet references |
confidential | Encrypt deposits, guardrails, and confidential proposals |
execution | Execute, finalize, and watch pending proposals |
governance | Multisig, swarms, and override proposals |
policy · budget · operational · lifecycle · swarm · fees · address-lists · batch | Generated per-domain instruction commands |
ix (instruction) | Build, inspect, and send any IDL instruction directly |
pda | Derive any AURA, dWallet, or Encrypt PDA |
features | Inspect the program surface and maturity breakdown |
dashboard | Live terminal treasury dashboard |