execution
Execute, finalize, and watch pending proposal lifecycle.
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 execution execute
Run execute_pending for the current proposal. If the proposal was approved,
submits the dWallet co-signing CPI. If denied, clears the pending state.
aura execution execute --agent-id agent-1
aura execution execute --agent-id agent-1 --wait # wait for message approval
aura execution execute --agent-id agent-1 --wait-signed # wait for dWallet signature$ aura execution execute
⠋ Submitting execute_pending for live dWallet signing...
⠙ Waiting for message approval signature...
✓ Execution request submitted: 3rGh…Lw5T| Flag | Description |
|---|---|
--agent-id <id> | Treasury agent ID |
--treasury <pda> | Treasury PDA |
--wait | Wait until message approval account exists, then drives the Ika dWallet gRPC presign and sign flow automatically |
--wait-signed | Wait until message approval reaches signed status (does not drive dWallet gRPC) |
aura execution finalize
Finalize an approved proposal after the dWallet signature is ready.
aura execution finalize --agent-id agent-1
aura execution finalize --agent-id agent-1 --message-approval <pubkey>$ aura execution finalize
⠋ Finalizing execution...
✓ Execution finalized: 6kMn…Qs8X (total tx 4)| Flag | Description |
|---|---|
--agent-id <id> | Treasury agent ID |
--treasury <pda> | Treasury PDA |
--message-approval <pubkey> | Override the message approval account |
aura execution watch
Continuously watch a treasury's execution state — shows pending proposal, policy output verification, decryption readiness, and message approval status.
aura execution watch --agent-id agent-1
aura execution watch --agent-id agent-1 --interval 10 # refresh every 10s
aura execution watch --agent-id agent-1 --json$ aura execution watch
AURA :: Execution Watch: agent-1
┌──────────────────────┬──────────────────────────────────────┐
│ Pending │ Value │
├──────────────────────┼──────────────────────────────────────┤
│ Proposal ID │ 3 │
│ Amount │ $250.00 │
│ Chain │ Ethereum │
│ Type │ Transfer │
│ Recipient │ 0xdead…beef │
│ Status │ Approved │
│ Approved │ Yes │
│ Policy output ct │ 8pQr…Nt6V │
└──────────────────────┴──────────────────────────────────────┘
┌──────────────────────┬───────┐
│ Live check │ Value │
├──────────────────────┼───────┤
│ Policy output verified│ Yes │
│ Decryption ready │ Yes │
│ Message approval │ signed│
└──────────────────────┴───────┘| Flag | Description |
|---|---|
--agent-id <id> | Treasury agent ID |
--treasury <pda> | Treasury PDA |
--interval <secs> | Refresh interval (default: 5s) |
Full Execution Flow
# 1. Propose (public)
aura treasury propose --agent-id agent-1 --amount 250 --chain ethereum --recipient 0x...
# 2. Execute and wait for dWallet signature
aura execution execute --agent-id agent-1 --wait-signed
# 3. Finalize
aura execution finalize --agent-id agent-1For confidential proposals, run aura confidential propose,
aura confidential request-decryption, and aura confidential confirm-decryption
before execution execute.