dWallet Execution

Why dWallet

Giving an AI agent a raw private key means the key can be extracted from memory, a compromised agent can drain the wallet instantly, and there is no on-chain record of what was authorized. Ika dWallet records solve all three: the agent never sees the key, every co-sign request is gated by the AURA program, and the audit trail lives on Solana.

Supported Chains

Chain IDs are u8 values used in ProposeTransactionArgs.target_chain and RegisterDwalletArgs.chain:

These map to the Chain enum in aura-policy: Bitcoin, Ethereum, Solana, Polygon, Arbitrum, Optimism.

Registering a dWallet

Before any proposal can be approved for a chain, a DwalletRecord must be registered against the treasury. One record per chain.

// Register an Ethereum dWallet (owner signs)
await aura.dwallet.register({
  treasury,
  chain: 1,                          // Ethereum
  dwalletId: "dwallet-abc123",       // from Ika dWallet provisioning
  address: "0xYourEthAddress",
  balanceUsd: 5_000,                 // USD cents — balance hint
});

RegisterDwalletArgs also accepts optional fields used in the full CPI path:

Execution Flow

For legacy proposals with no chain binding, finalize_execution keeps the original behavior and closes the proposal once the signature is verified. For chain-bound proposals, settlement is explicit: the signed digest commits to replay-protection fields, mark_settlement_broadcast records the target-chain tx hash after relay, and confirm_settlement is the point where wallet reservations, scheduled intent counters, and policy counters are finally applied. Failed or reorged broadcasts can be resubmit_proposal with fresh replay fields or abandon_proposal to release the reservation.

Chain Binding and native_message_hash

Chain-bound proposals require native_message_hash in ProposeTransactionArgs. This is the 32-byte Keccak-256 digest of the exact bytes Ika will sign — not a digest of the AURA audit string.

native_message_hash = keccak256(exact bytes passed to Ika requestSign)

For Solana, this is keccak256(compiled_transaction_message_bytes). For EVM and Bitcoin, it is the digest of the native transaction/sighash payload the caller constructed. When native_message_hash is absent (legacy proposals), the program falls back to keccak256(canonical_audit_message_string).

The canonical chain message string also includes a bind_native_message=<hex> segment when the field is set, making the binding auditable on-chain.

Chain-bound proposal validation requires native_message_hash to be present. Solana proposals additionally require solana_recent_blockhash. The separate solana_message_hash field is a Solana-specific trace/audit field and is not required for validation.

For the TypeScript SDK helpers that drive the full approval and broadcast flow, see the dWallet Execution guide.

execute_pending Accounts

MessageApproval digest selection

build_message_approval_request uses native_message_hash from the proposal binding when present and falls back to keccak256(audit_message_string) for legacy unbound proposals:

This means the MessageApproval PDA address changes depending on which digest path is taken — the PDA is derived from whichever digest was passed to approve_message.

MessageApproval PDA Derivation

The MessageApproval PDA is derived on the Ika dWallet program, not on aura-core. The SDK exports deriveMessageApprovalAddress which mirrors aura-core::find_message_approval_pda:

import { deriveMessageApprovalAddress } from "@aura-protocol/sdk-ts";

const [messageApproval] = deriveMessageApprovalAddress(
  DWALLET_DEVNET_PROGRAM_ID,
  curveCode,              // 0=secp256k1, 1=secp256r1, 2=ed25519, 3=ristretto
  publicKeyBytes,         // raw dWallet public key bytes
  signatureSchemeCode,    // Ika signature scheme code
  messageDigest,          // 32-byte Keccak-256 digest
  messageMetadataDigest,  // optional 32-byte metadata digest
);

Seeds (in order):

1. b"dwallet"
2. u16_le(curveCode) ++ publicKey — chunked into 32-byte segments
3. b"message_approval"
4. u16_le(signatureSchemeCode)
5. messageDigest (32 bytes)
6. messageMetadataDigest (32 bytes, only if non-zero)

Bitcoin Manual Review

Bitcoin transactions above bitcoin_manual_review_threshold_usd (default: 5_000 USD cents = $50) are blocked by ViolationCode::BitcoinManualReview in evaluate_public_precheck. A guardian must approve via approve_pending_execution before execute_pending can proceed.

finalize_execution Accounts

confirm_settlement Accounts

ChainProfileAccount

Custom chain codes require a ChainProfileAccount at [b"chain_profile", chain_code]. The profile stores address format, replay scheme, finality model, curve/scheme, native gas asset, optional EVM chain id, and required confirmation depth. Built-in chains have defaults, but a profile may still be supplied to override settlement or replay policy.

Security Properties