Use cases

Use cases

A GuardedWallet does one thing: it sends USDC from the wallet to an address, if the policy allows it. It does not call other contracts. Each example below is one wallet with one policy, and the agent code is the same in every case: it calls executeUSDC, and the wallet decides. Amounts are USDC with 6 decimals, so 25_000_000n is 25 USDC.

Paying for APIs, compute and data

An agent buys model, search or data access, or pays a compute network, from a short list of approved providers.

  • Policy: requireAllowlist on, so the agent can only pay registered vendors. Each vendor gets a category (API, COMPUTE, DATA, SUBCONTRACTING or OTHER) and its own per-payment cap.
  • Effect: an unknown recipient is refused, even for a small amount.
await arc.executeUSDC({
  to: process.env.SEARCH_API_VENDOR as `0x${string}`,
  amount: 25_000_000n,
  reason: "Search API credits",
  metadata: { category: "API" },
})

Paying other agents or contractors

An agent hires other agents or people for tasks and pays them when the work is done.

  • Policy: the SUBCONTRACTING category allowed, a per-payment cap sized to one task, and an escalation threshold so larger jobs wait for a person to approve.
  • Effect: routine payouts go through; anything unusual waits for a human.

Team or DAO operating budget

A team gives an agent a monthly budget to pay its regular counterparties.

  • Policy: a monthly cap for the whole budget, a low escalation threshold, and approvers from the team or DAO council, for example 2 of 3.
  • Effect: the agent handles small payments alone, and the council signs off on the rest.

Topping up an execution wallet

A trading or operations bot needs gas money and working capital in a separate hot wallet. The GuardedWallet holds the reserve and tops the hot wallet up.

  • Policy: the hot wallet on the allowlist, a per-payment cap sized to one top-up, and a daily cap sized to a bad day. No escalation threshold, so the bot is never blocked waiting for a person.
  • Effect: if the bot’s key is stolen, the loss is limited to the daily cap.

Check before you pay

const decision = await arc.simulate({
  to: process.env.SEARCH_API_VENDOR as `0x${string}`,
  amount: 25_000_000n,
})
// decision.verdict is ALLOW, ESCALATE, DENY or FREEZE, checked without sending anything

See Policies for every rule and the order the contract checks them in.