Actors

In Runtimee, an Actor is a financial identity that can autonomously spend USDC within policy-defined constraints.

An Actor is not a wallet in the traditional sense — it is a programmable treasury identity designed for autonomous systems (AI agents, bots, workflows).

Actor Properties

Actor Lifecycle

1. Created: Via the SDK (rt.actors.create) or the hosted service API.
2. Active: Can spend USDC within budget and policy limits.
3. Frozen: Temporarily unable to spend (e.g., due to suspicious activity).
4. Depleted: Budget exhausted; cannot spend until budget is reset or increased.

Budget

Each Actor has an associated Budget that defines:

• amount: Total USDC available (in wei, 6 decimals for USDC)
• used: Amount already spent
• currency: Always "USDC"
• period: "monthly" or "total"
• resetAt: When the budget resets (for monthly budgets)

Example

import { Runtimee } from "@runtimee/sdk"

const rt = new Runtimee({ apiKey: "re_..." })

const actor = await rt.actors.create({
  name: "payment-agent",
  budget: { amount: "1000", currency: "USDC", period: "monthly" }, // 1000 USDC
  policies: [
    { type: "allowlist", config: { allowedTargets: ["payroll:service-a"] } }
  ]
})