AURA

Configuration

Config file, environment variables, and resolution order for the AURA CLI.

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.

The CLI resolves configuration from four sources in priority order (highest wins):

  1. CLI flags--rpc-url, --wallet, --program-id
  2. Environment variablesAURA_RPC_URL, AURA_WALLET_PATH, etc.
  3. Config file~/.aura/config.json
  4. Built-in defaults — devnet RPC, ~/.config/solana/id.json

Config File

Located at ~/.aura/config.json:

{
  "rpcUrl": "https://devnet.helius-rpc.com/?api-key=YOUR_KEY",
  "walletPath": "~/.config/solana/id.json",
  "programId": "EaRoLVwL8EErDUeEMPHJ5QJeLVQZWJMtZcgmFzT9bhHs",
  "defaultAgentId": "my-agent"
}

Environment Variables

AURA_RPC_URL="https://devnet.helius-rpc.com/?api-key=YOUR_KEY"
AURA_DEVNET_RPC_URL="https://devnet.helius-rpc.com/?api-key=YOUR_KEY"
SOLANA_RPC_URL="https://devnet.helius-rpc.com/?api-key=YOUR_KEY"
AURA_WALLET_PATH="/path/to/keypair.json"
PAYER_KEYPAIR="/path/to/keypair.json"
AURA_CLUSTER="devnet"
AURA_PROGRAM_ID="EaRoLVwL8EErDUeEMPHJ5QJeLVQZWJMtZcgmFzT9bhHs"
AURA_DEFAULT_AGENT_ID="my-agent"

Setup Commands

# Interactive setup wizard
aura config init

# Set individual values
aura config set rpc-url https://devnet.helius-rpc.com/?api-key=YOUR_KEY
aura config set wallet-path ~/.config/solana/id.json

# View current resolved config
aura config show

On this page