AURA

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, it requests dWallet co-signing through the message-approval account (the signature itself is produced by the backend / Ika dWallet network). If denied, it clears the pending state. Runs through the secure pipeline.

aura execution execute --agent-id agent-1
aura execution execute --agent-id agent-1 --wait         # wait for the message approval account
aura execution execute --agent-id agent-1 --wait-signed  # wait until it reaches signed status
Example output:
$ aura execution execute
✓ Execute pending (request dWallet signing) confirmed — 3rGh…Lw5T
ℹ https://explorer.solana.com/tx/3rGh…Lw5T?cluster=devnet
FlagDescription
--agent-id <id>Treasury agent ID
--treasury <pda>Treasury PDA
--waitAfter sending, wait until the message approval account exists
--wait-signedAfter sending, wait until the message approval reaches signed status

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>
Example output:
$ aura execution finalize
⠋ Finalizing execution...
✓ Execution finalized: 6kMn…Qs8X (total tx 4)
FlagDescription
--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
Example output:
$ 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│
└──────────────────────┴───────┘
FlagDescription
--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-1

For confidential proposals, run aura confidential propose, aura confidential request-decryption, and aura confidential confirm-decryption before execution execute.

On this page