Allowance
A wallet your AI agent can spend from. Only as much as you allow, only where you allow.
of the daily limit, in fixed windows
Where it may go
Only where you said
The agent can send SOL (or one coin) from your vault to the addresses you list, up to the amount per window. Anything else is refused by Squads.
SOL per day
places it may pay
Turn the card over for where the money may go: a pay list of addresses, or the agent's own key as a top-up.
Demo · simulated in this browser
- Paid 4kTq...pay list0.12 SOL
- Paid 9fMe...pay list0.20 SOL
Top-up pays the agent's own key. What the agent does from there (swaps, any coin, any app) is out of Allowance's reach.
The stop
One switch, and the agent is out
Freeze removes the limit: one signature of your owner key. The agent's next spend is refused by Squads. Withdrawing still works.
Withdraw works frozen or not.
- Paid 4kTq...pay list0.09 SOL
- Topped up the agent keytop-up0.18 SOL
Plainly
What it does not limit
The limit is a Squads v4 spending limit. It is strong where it is narrow. Here is where it stops.
No cap per payment
One payment can use the whole window.
Fixed windows
Up to twice the amount within minutes around a window edge.
No swaps, coins or venues
In top-up mode the agent spends its own key as it likes. Give it only what you are ready to lose per window.
Your owner key is everything
Lose it and you lose the vault. Changing or unfreezing a limit starts the window full again.
Setup
Plug your agent in
Three steps. The owner keeps the wallet; the agent only ever holds its own key.
Create the wallet and set the limit
Amount per day, week or month, the coin, where it may go. One transaction.
Paste the agent's public key
The agent makes its own key. Only the public half comes to you; the secret never travels.
Give the agent the SDK or MCP
It calls pay (or top_up). Squads checks the limit on chain.
import { KeeperAllowance } from "./kit/allow/sdk-keeper.mjs"; const agent = new KeeperAllowance({ connection, agent: agentKeypair, multisig: WALLET }); await agent.pay(PAYEE, 0.2); // refused by Squads if over the window await agent.topUp(0.1); // top-up mode: to the agent's own key const s = await agent.status(); // s.limits[0].remaining, s.frozen
# stdio MCP server, tools: status, pay, top_up ALLOW_RPC=https://your-rpc \ ALLOW_AGENT_KEY=./agent.json \ ALLOW_MULTISIG=<wallet address> \ node kit/allow/mcp.mjs # a refused call comes back as: REFUSED by the Squads spending limit: SpendingLimitExceeded
Free to create. Squads charges no creation fee. You pay rent (about 0.004 SOL; a limit's share comes back when it is removed) and network fees.
Video
How it works
From the limit to freeze, in about a minute. Every screen is the demo card.
Through the limits · test chain