Open Source · Developer Library

OAA Agent Kit

@kirkelabs/oaa-agent-kit is an open-source (MIT) npm library and CLI for building fundable Algorand agents: autonomous software that can hold and spend value within hard, cryptographic limits, pay x402-priced services, and carry an Open Agent Access passport.

$ npm i @kirkelabs/oaa-agent-kit
$ npx oaa-agent-kit init my-agent

What it gives you

  • Bounded mandate. A stateless LogicSig mandate bounds every payment: a per-transaction cap, a payee policy (owner-only by default, an allowlist, or open), an expiry, no-rekey, and genesis/network binding.
  • x402 payments. Agents pay x402-priced services through a hardened fetch: SSRF guard, timeout, response-size cap, and a confirmation hook.
  • OAA passport. Build, sign, and verify an Open Agent Access passport so the agent declares its identity, purpose, and mandate to governed endpoints.
  • Pera Wallet interop. Fund and operate agents with Pera Wallet, or a local signer for tests.
  • Stateful budgets (experimental). An optional on-chain AllowanceApp enforces cumulative and recurring budgets. Shipped EXPERIMENTAL and unaudited; the stateless mandate is the recommended default.

How it fits

This is the agent side of Open Agent Access: the kit builds the passport and the bounded wallet, while Open Agent Access is the merchant-side policy that returns allow / deny / charge. See both halves end to end in Agent City.

Before MainNet

The AllowanceApp is experimental and unaudited: default to the stateless mandate, test on Algorand TestNet, and commission an independent audit before putting material value on-chain. This is engineering documentation, not financial advice.

Open-source (read, run, contribute): npmjs.com/package/@kirkelabs/oaa-agent-kit · github.com/KirkeLabs/oaa-agent-kit