Glossary

Every term in one place. Linked from the rest of the docs.

Agent — an autonomous (usually AI) program that holds a wallet and uses Olbos to manage its treasury, via the SDK or MCP. Agents pay and drive; they cannot see break-glass.

Allocation — the distribution of capital across venues, governed by a strategy.

Break-even gate — a policy check: a move must recoup its execution cost from extra yield within maxBreakEvenDays, or it doesn't happen. Keeps gas from eating the yield. See Strategies.

Break-glass — an owner's emergency controls: the kill switch (fast, reversible) and the on-chain revoke (terminal, API-independent).

Buffer (liquidity buffer) — the share of capital kept liquid (un-deployed) for instant withdrawal, set by liquidityBufferPct.

Cap (per-venue cap) — the maximum share of capital allowed in any single venue, set by maxAllocPerVenuePct. Enforced by the risk gate.

Correlation ID — an identifier shared by all events from one logical action; the basis of tenant isolation in the audit log.

Custody — the on-chain authority model. Each strategy has its own Swig account where the owner is root and the engine holds a scoped, revocable, transfer-less role. See Custody.

Daily cap (custodyDailyCapUsdc) — the on-chain limit on how much USDC the engine's role can move per ~24h window. Enforced by Swig, not by Olbos code.

Engine — the Olbos runtime that scores venues, plans moves, and executes them. Holds a scoped role; cannot move funds to any address.

Event log — the append-only node:sqlite record that is simultaneously the audit trail, replay source, checkpoint, and dashboard feed. See Events.

Facilitator — the x402 service that verifies and settles payments (PayAI). It sponsors the fee payer, making payments gasless. See Payments.

Intent ID — a deterministic content hash of a move's inputs, giving at-most-once execution across restarts. See Architecture.

Kill switch — a wallet-signed halt of all activity for a strategy; reversible. The dashboard's hold-to-seal torc ring.

MCP — Model Context Protocol. Olbos ships an MCP server so any LLM agent can manage a treasury conversationally.

Net APY — headline − cost − risk haircut; how venues are ranked. See Strategies.

Owner — the wallet that holds root authority over a strategy's Swig. Watches via the dashboard, holds break-glass, signs withdrawals. By default the agent's funding wallet; can be a separate human wallet.

Payment-as-deposit — the property that a fund call's x402 settlement transfer is itself the deposit, with no reconciliation gap. See Payments.

Payout — the owner-signed transfer of withdrawn USDC out of the Swig to the owner's wallet. The engine builds and fee-pays; only the owner's signature moves value. See Custody.

Policy — the set of dials governing a strategy (caps, buffer, thresholds, horizons, daily cap). A template is a named policy. See Strategies.

Position — capital held in a venue, modeled as receipt shares.

Receipt shares — the universal position model: a quantity an adapter can value (→ USDC) and invert (← USDC). Physically an SPL token (Kamino cTokens) or shares in a protocol account (Marginfi). See Venues.

Revoke (on-chain) — the terminal break-glass: the owner removes the engine's role from the Swig on-chain. Works even if Olbos is down. See Custody.

Risk gate — a pure function enforcing caps, buffer, and the allowlist on every action. Cannot be bypassed. See Security.

Risk haircut — the penalty subtracted from a venue's APY for high utilization or thin TVL. See Strategies.

Rug test — the executable proof that a compromised engine cannot exfiltrate funds, run against the live Swig role. See Security.

Simulate-first — every transaction is simulated against live state before sending; failures are never broadcast.

Strategy — an instance of a policy plus its custody: how a specific treasury allocates capital.

Swig — the smart-wallet program Olbos uses for custody. Role-based; root (role 0) is immutable.

Template — a named policy: conservative, balanced, or aggressive.

Tenant isolation — in hosted mode, each owner sees and controls only their own strategies; the audit log never leaks across tenants. See Security.

Venue — a yield source: Kamino Lend, Marginfi (mainnet), or the delphi/olympia mocks (localnet). See Venues.

Venue adapter — the interface every venue implements, hiding protocol specifics from the engine. See Venues.

Watch loop — the autonomy process that re-scores and re-plans on an interval, running health checks and the fail-safe. See Strategies / Operations.

x402 — the payment protocol (HTTP 402, made real) Olbos is paid over. See Payments.