Get started

Give your AI agent a budget it can't break.

Cassio gives each AI agent its own wallet on Robinhood Chain and a spending policy that lives outside the agent. The agent asks to pay; Cassio checks the policy, signs with the agent's wallet and sends the payment onchain — or refuses.

Cassio is not an AI. It doesn't think, browse or decide what to buy. It is the payment layer for a program you run — a bot, a script, an LLM agent. Think of it as a company card you hand to an employee: they can spend, but only where, how much and how often you allow, and you can freeze it anytime.
Your program

Does the work and asks Cassio to pay when it needs to.

Cassio

Holds the agent wallet's key and enforces your rules.

You

Set the rules, fund the wallet, and keep the off switch.

How it works

  1. Your program asks to payIt sends Cassio its agent token, a recipient address and an amount.
  2. Cassio checks the policyIs the agent active? Is the recipient approved? Is the amount within the per-payment limit and today's budget? Does the wallet hold enough?
  3. Approved → signed and sentCassio signs a USDG transfer with the agent wallet, broadcasts it to Robinhood Chain and waits for confirmation.
  4. Refused → nothing movesThe request is recorded with the reason (e.g. Over per-payment limit). No transaction is created.

Your program never sees a private key, so a bug, a prompt injection or a leaked token can at worst spend what the policy allows — and only to addresses you approved.

Quick start

Five minutes from zero to your first agent payment. Use small amounts the first time.

1

Sign in

Open the dashboard in a browser with an EVM wallet (MetaMask, Rabby, Coinbase Wallet, Robinhood Wallet…) and click Connect wallet. You sign a message — it proves you own the address and never moves funds.

2

Create an agent

Click + New agent and fill in:

FieldMeaningFirst-time value
NameAny label for this agentmy-first-agent
Per-payment limitMost it may pay in one request0.10
Daily budgetMost it may pay per UTC day1
Approved recipientsThe only addresses it may pay, one per lineA second wallet of your own
Vendor labelsOptional names shown in the ledger—

After you click Create agent, copy the agent token (csk_live_…). It is shown once.

3

Fund the agent wallet

The dashboard shows the agent's own wallet address. From your wallet, on Robinhood Chain, send it a little ETH for gas and some USDG to spend. Click Refresh until the balances appear.

4

Try it from the dashboard

Click Test payment and send 0.01. You'll see Settled onchain with a link to the transaction. Try 0.5 too — it is refused with Over per-payment limit, and nothing moves. That's the policy working.

5

Let your program pay

Download cassio.js (no dependencies) next to your code:

import { Cassio } from './cassio.js';

const cassio = new Cassio({
  token: process.env.CASSIO_AGENT_TOKEN,
  baseUrl: 'https://cassiopay.fun',
});

const { payment } = await cassio.pay({ to: '0xRecipient…', amount: '0.01' });
console.log(payment.status, payment.explorer);

That's the whole integration. The payment appears in the dashboard's Payments page.

Concepts

Agents

An agent in Cassio is three things that belong together:

  • A wallet on Robinhood Chain, created by Cassio. It holds the funds the agent may spend. Its private key is encrypted on the Cassio server and never leaves it.
  • A spending policy you set and can change anytime.
  • An access token your program uses to ask for payments.

Create one agent per program or per job. Separate agents keep budgets, recipients and tokens independent, so one misbehaving bot can't touch another's funds.

Spending policy

Every request is checked in this order. The first rule that fails refuses the payment.

RuleRefusal reason
The agent is active (not paused)Agent paused
The agent has at least one approved recipientNo approved recipients
The recipient is on the approved listRecipient not approved
Amount ≤ the agent's per-payment limitOver per-payment limit
Amount ≤ the platform per-payment cap (5 USDG)Over platform per-payment cap
Spent today + amount ≤ daily budget (and ≤ platform cap of 50 USDG)Daily budget reached
The agent wallet holds enough USDGInsufficient USDG on agent wallet
The agent wallet holds ETH for gasNo ETH for gas on agent wallet
  • Daily budget resets at 00:00 UTC (07:00 WIB). Payments still signing or confirming count toward it.
  • Approved recipients are the real security boundary. Vendor labels are only names for your ledger — they are not enforced.
  • Payments from one agent are processed one at a time, so many parallel requests can't overspend the budget.
  • Policy changes and pausing take effect on the very next request.

Funding & withdrawing

Each agent wallet needs two assets on Robinhood Chain:

  • ETH — gas. Every payment is one transaction; Layer 2 fees are small, so a little goes a long way.
  • USDG — what the agent pays with.

Only send assets on Robinhood Chain (chain ID 4663). Tokens from other networks sent to this address may be lost.

Withdraw all to my wallet (in the agent's ••• menu) sends every USDG and the remaining ETH back to the wallet you're signed in with. An agent can only be deleted once its wallet is empty — Cassio refuses otherwise, so funds can't be stranded.

Agent tokens

The token (csk_live_…) is how your program proves which agent it is. Cassio stores only a hash of it, which is why it's shown once.

  • Keep it in an environment variable or secret store — never in code you publish or in a browser.
  • Anyone with the token can spend within the agent's policy. That's the worst case, by design.
  • Lost or leaked? Use Rotate token. The old token stops working immediately.

Build

JavaScript SDK

cassio.js is a single file with no dependencies. It works in Node.js 18+ and modern browsers (but keep tokens out of browsers).

new Cassio({ token, baseUrl })

token — the agent token. baseUrl — https://cassiopay.fun.

await cassio.me()

Returns the agent's name, wallet address, policy, today's spending and the payment token. Moves no money — use it to check the connection.

await cassio.pay({ to, amount, vendor?, requestId? })

Requests a payment. amount is a decimal string such as "0.05". Resolves with { payment } when settled or still confirming; throws a CassioError with error.payment.reason when refused or failed.

try {
  const { payment } = await cassio.pay({ to, amount: '0.05', vendor: 'api.vendor.com', requestId: 'order-1234' });
} catch (e) {
  if (e.payment) console.log('Refused:', e.payment.reason);   // e.g. "Daily budget reached"
}

Pass your own requestId (8–100 characters) when the payment belongs to something in your system, like an order. Retrying with the same ID never pays twice.

await cassio.payment(requestId) · await cassio.waitForPayment(requestId)

Look up a payment, or poll until it's settled or failed. Use these after a timeout before deciding to retry.

await cassio.fetch(url, init?)

A fetch() that pays HTTP 402 challenges through Cassio. See Paying HTTP 402 APIs.

HTTP API

Any language works. Authenticate with the agent token as a bearer token. Base URL: https://cassiopay.fun.

POST /api/v1/pay

curl -X POST https://cassiopay.fun/api/v1/pay \
  -H "Authorization: Bearer $CASSIO_AGENT_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"to":"0xRecipient…","amount":"0.05","vendor":"api.vendor.com","requestId":"order-1234"}'
FieldDescription
torequiredRecipient address. Must be approved for this agent.
amountrequiredDecimal string in USDG, up to 6 decimals.
requestIdrequiredUnique per payment, 8–100 chars of A–Z a–z 0–9 . _ : -.
vendoroptionalA label for the ledger, e.g. a domain.

Response:

{
  "payment": {
    "requestId": "order-1234",
    "recipient": "0xRecipient…",
    "amount": "0.05",
    "status": "settled",
    "reason": "Confirmed onchain",
    "txHash": "0x…",
    "explorer": "https://robinhoodchain.blockscout.com/tx/0x…"
  },
  "replay": false   // true when this requestId was already processed
}

GET /api/v1/payments/:requestId

Returns { payment } for a request this agent made — check this after a timeout.

GET /api/v1/me

Returns the agent's name, wallet address, limit, daily, spentToday, recipients, active and the payment token (symbol, address, decimals).

Payment statuses

StatusHTTPMeaning
settled200Confirmed onchain. Final.
submitted202Broadcast, still confirming. Poll /api/v1/payments/:requestId.
blocked403Refused by the policy or by wallet balance. Nothing was sent. See reason.
failed502Signed but rejected or reverted onchain. Funds didn't move (gas may be spent).

Errors & limits

HTTPWhen
400Invalid input — bad address, amount format or requestId. Body: { "error": "…" }.
401Missing, wrong or rotated agent token.
409The requestId was already used for a different recipient or amount.
429Rate limited — more than 60 payment requests per minute for one agent.

Retry safely: on a network error or timeout, call GET /api/v1/payments/:requestId first. If it's unknown, send the same request again with the same requestId.

Reference

Network & token

NetworkRobinhood Chain mainnet (Ethereum Layer 2 on Arbitrum)
Chain ID4663 (0x1237)
Gas tokenETH
Payment tokenUSDG (Global Dollar), 6 decimals
0x5fc5360D0400a0Fd4f2af552ADD042D716F1d168
Explorerrobinhoodchain.blockscout.com ↗
Platform caps5 USDG per payment · 50 USDG per agent per day

Security model

  • Custodial agent wallets. Cassio creates and holds each agent wallet's key (encrypted at rest) and signs approved payments. Your own wallet is never shared with Cassio.
  • The policy is server-side. Your program can ask; it can't change the rules or reach the key.
  • Worst case is bounded: a leaked token can spend at most the daily budget, only to approved recipients, until you pause or rotate it.
  • Sign-in is a one-time signed message with a single-use nonce; sessions use an HttpOnly cookie.
  • Not audited yet. Cassio has not had an independent security audit. Keep each agent's balance to what it actually needs, and withdraw what it doesn't.

FAQ

Does Cassio run my AI agent?

No. Cassio is the payment and budget layer. You run your program anywhere — your laptop, a server, a cloud function — and it calls Cassio when it needs to pay.

What's the difference between “Test payment” and an agent payment?

Nothing onchain — both are the same policy check and the same transfer from the agent wallet. Test payment is you pressing a button; an agent payment is your program asking with its token.

Can my agent pay any address?

No. Only addresses in its approved recipients list. Edit the policy to add more.

What if the token leaks?

Rotate it from the agent's ••• menu — the old token stops working at once. Until then, spending is bounded by the policy.

Why was a payment refused?

Open Payments in the dashboard: every refused request shows its reason. The policy table lists them all.

Can I get my money back from an agent?

Yes — Withdraw all to my wallet returns all USDG and the remaining ETH to your signed-in wallet.

Which wallets can I sign in with?

Any EVM browser wallet: MetaMask, Rabby, Coinbase Wallet, OKX, Trust, Phantom, Brave, Robinhood Wallet and others. On a phone, open the site inside your wallet app's browser.