Docs

Glossary

Every word Breaker uses, with the page that goes into it.

What you own

PanelThe root of one wallet’s budgets. One per wallet, at an address derived from it. The panel
OwnerThe wallet that opened the panel, or a Squads vault. It can sign every control, alone moves money and names members, and is where money returns.
BudgetAn account of the Breaker program holding one agent’s terms and totals. Budgets
Budget accountThe token account that holds a budget’s money. The budget owns it.
LabelThe name you give a budget, 1 to 64 bytes.

What the agent holds

Agent keyA keypair approved to pay out of one budget account. It holds no money. Agent keys
DelegateThe token program’s word for a key approved to move an amount out of an account it does not own. The agent key is the budget account’s delegate.
AllowanceThe amount the agent key is approved for right now. Every payment lowers it by the price.

The terms

LimitThe allowance granted for one period.
PeriodAn hour, a day or a week. The first starts when the budget opens.
ExpiryAn optional time after which the key pays nothing.
FundingWhat the owner moves into the budget account, at opening or later.
BalanceWhat the budget account holds now.
RemainingWhat is left of this period’s limit. Accounting

What happens to a budget

TripA price above what remains. The payment is refused and no money moves. Trip
RollThe turn of a period: the closed one is recorded and the full limit is granted again. Keeper and indexer
ResetThe full limit granted now, in the middle of a period.
SwitchOff revokes the agent key in one transaction. On approves what remained.
RotateReplace the agent key. The old one pays nothing from that transaction.
CloseReturn the whole balance and the rent to the owner and end the budget.

States

LiveThe key can pay up to what remains.
TrippedNothing remains of this period’s limit, or a price above it was just refused.
OffThe owner switched it off.
ExpiredPast its expiry.
ClosedThe money is back with the owner.

Paying

x402The protocol by which an API answers 402 Payment Required with a price, and is paid in the next request. x402
Exact schemeThe x402 payment in which the client signs a transfer of exactly the price.
ChannelA payment channel of Solana’s payment-channels program, with a budget as its payer. Its deposit counts against the period’s limit when it opens. Channels
DepositWhat a budget puts into a channel. What the service is not paid comes back to the budget account.
SessionA channel kept open to one service and paid call by call with vouchers: x402 batch-settlement.
Metered callA channel opened for one call’s ceiling, settled at what the call used: x402 upto.
VoucherA signed note of the running total a service may claim from a channel. In a session the agent key signs it.
GraceThe time between a request to close a channel and the moment anyone may seal it.
LineOne service a budget may pay, named by its payout address, with a cap per period. Lines
On linesA budget with any line set. Its agent key holds no delegation and pays only the services named, by session or metered call.
MemberA wallet the owner lets sign some of the panel’s instructions, with one or both roles. Team
Switch roleSwitch a budget off, Switch all off, and ask a budget’s channels to close.
Limits roleChange, reset, switch on and rotate a budget, open one with no money moved, turn draw on or off, and set or remove lines.
VaultA Squads v4 multisig’s vault. As a panel’s owner, every owner action is proposed, approved to the threshold and executed.
FacilitatorThe service an API uses to check a payment, send it to the chain and pay its network fee.
Fee payerThe key that pays a transaction’s network fee. For a payment it is the facilitator’s, so the agent needs no SOL.
MemoA short string carried on each payment: the service’s reference, or a random one.
Base unitsThe smallest unit of a token. Every amount is written in them. Amounts
MintThe token a budget holds.

What runs beside the program

ProgramThe Breaker program on Solana: nine kinds of account and twenty-eight instructions. Program
KeeperThe service that sends the roll for every budget at its period’s end, and closes the channels of a budget that is off or expired.
IndexerThe service that reads the chain into the ledger the panel and the API serve.
LedgerEvery payment and every closed period of a budget.
ReportA small message the SDK sends, signed by the agent key: the service a payment went to, or a price that was refused.
FeeThe share of funding the protocol keeps. Fees