ConceptsWallets

Wallets

A GuardedWallet is a smart contract on Arc that holds the USDC for one agent. The agent never holds the money directly. It asks the wallet to pay, and the wallet checks the policy first.

Who controls a wallet

  • The owner is the address that set the wallet up, often a person or a Safe multisig. Only the owner can change the rules, add or remove agents, withdraw funds, freeze or unfreeze, and hand ownership to someone else (a two-step transfer).
  • Agent signers are the keys your agents use. They can request payments and nothing else.
  • Approvers sign off on payments the policy holds for review. See Escalations.

Arcanum has no admin role on the wallet. There is no upgrade path and no way for any Arcanum address to move its funds. The one thing Arcanum can do is freeze a wallet through the risk oracle, which the owner can switch off.

What a wallet stores

  • Its policy: the spending limits and rules.
  • Its agent signers and its approvers.
  • How much it has spent today and this month.
  • Whether it is frozen.
  • The modules it uses: policy engine, escalation manager, vendor registry and risk oracle. The owner can replace any module, or switch the risk oracle off.

Reading a wallet

const policy = await arc.getPolicy()
const spentToday = await arc.getDailySpent()
const spentThisMonth = await arc.getMonthlySpent()

Creating a wallet

Anyone can create a wallet through the WalletFactory, for themselves or for someone else. The Quickstart walks through it.