Quick Start

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, supports --json output for automation and CI, and exposes the full program surface through domain-grouped commands.

Install

npm install -g @aura-protocol/cli

Configure

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.json

Common Workflows

# Create a treasury
aura treasury create --agent-id agent-1 --daily-limit 10000 --per-tx-limit 1000

# Show treasury state
aura treasury show --agent-id agent-1

# Propose a transaction
aura treasury propose --agent-id agent-1 --amount 250 --chain ethereum --recipient 0x...

# Execute and finalize
aura execution execute --agent-id agent-1 --wait-signed
aura execution finalize --agent-id agent-1

# Register a dWallet
aura dwallet register --agent-id agent-1 --chain ethereum --dwallet-id eth-main --address 0x...

# Submit a scalar confidential proposal
aura confidential propose --agent-id agent-1 --amount 250 --chain ethereum --recipient 0x...

# Configure multisig
aura governance multisig --agent-id agent-1 --required 2 --guardians pk1,pk2,pk3

Global Flags

These flags work on every command:

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 output
`--quiet`	Suppress non-error terminal output
`--dry-run`	Build instructions without sending

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
`instruction`	Build and send any IDL instruction directly
`pda`	Derive any AURA, dWallet, or Encrypt PDA
`features`	Inspect the SDK-backed program surface
`dashboard`	Live terminal treasury dashboard

Configuration

Config file, environment variables, and resolution order.

Commands

Full command reference for all groups.