Features
Everything Dynamo can do today, grouped by area, with a status on each feature. npm already carries older August releases of @dynamoprotocol/guard, @dynamoprotocol/sdk, @dynamoprotocol/mcp and @dynamoprotocol/conformance-kit. Most other packages in this catalogue are built and tested from the repository; the v2.2.6 preview SDK files are sent privately with credentials and are not on npm.
Preview (v2.2.6): only the MVP subset runs on hosted preview cores (card TEST, stablecoin contract v2 on the Avalanche Fuji testnet, x402 pay and get paid, budgets, streams, console, human payments, end-user surfaces, Control Mode). Features marked Not in the preview yet on their pages are off there even when this catalogue says Live. See Preview.
| Status | What it means |
|---|---|
| Live | You can use it today in Control Mode (no money), on a local chain or testnet, or with the credit card rail in Stripe TEST mode. |
| Preview | Built, but behind a switch that is off unless the operator turns it on. |
| Release-gated | Moves real money, or needs live credit card keys or an operator-mode ramp. Not released. Real money is off by default: a deployment opens a money mode only when its operator allows it, and stablecoin also needs Safe multisigs (threshold 2 or more) as vault owner and fee collector. Live credit card keys and live ramp-provider keys are refused in code; operator-mode ramps run only against a sandbox account. |
Money modes stay off on a deployment until its operator lists them. A live API key on the hosted tier works in Control Mode only.
Budgets, streams and delegation
See budgets, streams and session keys.
- Budgets - Live. Open a funded ceiling, list your budgets, read one, close it. A budget whose rules are refused funds nothing.
- Streams - Live. A capped, rate-limited allowance from a budget to one service node.
- Caps and the rate envelope - Live. Every spend is checked against the stream's own cap, every ancestor's cap and the rate over elapsed time; the first check that fails names the refusal.
- Delegation - Live. A stream opens child streams; children together never exceed their parent's cap. Read the whole tree at any time.
- Own hops - Live. Every agent signs its own hop and every payee signs its own offer, so the record shows who authorised what. Required by default when money is involved, optional in Control Mode.
- Mandates - Live. The funder limits categories and depth; a child's mandate can only narrow. A funder who sets none gets a safe default.
- Mandates with limits - Live. Payee allow and deny lists, time windows, per-transaction and per-period limits, approval thresholds, and minimum identity levels.
- Approvals - Live. An open above
capAboveor deeper thandepthAbove, or a reservation abovereserveAbove, waits for a person to approve or reject it. A direct meter without a reservation abovereserveAboveis refused (reserve first). Each approval is used once and waives only the threshold it was raised for. - Freeze, resume, emergency stop and tighten - Live. Pause a branch and resume it, stop a whole budget, or lower a cap or narrow a mandate on a running stream. Work already proven stays payable.
- Main switch - Live. The operator pauses every new spend on the deployment at once and resumes it later.
- Reservations - Live. Hold units before the work, then confirm all or part of them, or release them. Old holds expire on their own.
- Metering - Live. Report delivered units under a request reference. You get a success answer only once a signed voucher covers the work, and a retry is billed once.
- Checkpoints and finality - Live. Signed vouchers are driven to settlement; each stream reports whether its work is accrued, checkpointed or final.
- Revoke - Live. Revoking a stream settles its proven work first, then stops it and everything under it.
- Signed authority chain - Live. Every budget, hop, revoke, freeze and change is a signed, linked record, with a signed head per budget that shows nothing was dropped.
- Allowance credentials - Live. Credentials for one stream, each with an expiry the caller sets, that gateways check offline.
- Always-on scheduler - Live. Every deployment runs its own money duties (signing, checkpoints, finality, expiries) without waiting for a client.
- Payment authorizations and receipts - Live. An agent or connector asks for a signed authorization; the payment rail reports its receipt back into a signed record.
Evidence
See evidence and disputes and verifying evidence.
- Evidence export - Live. Export a whole budget as one bundle: every signed record, voucher and settlement.
- Offline verification - Live. Check a bundle with no network in TypeScript, Python or the command line; one changed byte fails with a named reason.
- Reconciliation and logs - Live. Compare what the engine billed with what settled, and read a request log that holds no payloads.
Funding and settlement
See funding modes, the non-custodial posture and contract v2.
- Control Mode - Live. Every check runs and no money moves.
- Stablecoin escrow, contract version 1 - Still in the repository; Not in the preview yet on hosted money cores (v2.2.6 runs contract v2 alone). Live on a local chain from a clone that configures v1; Release-gated with real funds.
- Contract version 2 - Live on a local chain or testnet (preview money cores: v2 alone); Release-gated with real funds. Held value, a grace window, deeper delegation.
- Budgets funded from your own wallet - Live on a local chain. You fund a version 2 budget yourself and the core adopts it with your signed intent.
- Budget expiry - Live on a local chain. Nothing is signed after a version 2 budget's expiry; matured held value is released by the scheduler.
- Credit card rail - Live in Stripe TEST mode. One authorization is the funded ceiling; captures never exceed it; payees are paid through their connected accounts. See credit card authorization-backed budgets.
- Credit card live mode - Release-gated. The live configuration is checked, then stops before any live call. See card live readiness.
- Real-money stablecoin settlement - Release-gated.
- Holdback - Live in the engine and the in-process SDK; on a core it runs on the verified runtime (Preview:
CORE_VERIFIED=1, off by default). A stream's work becomes final only after a window, so refunds inside it come from held funds. See holdback and refunds. - Terms and breach refunds - Preview (a core needs
CORE_VERIFIED=1and a terms catalogue; both off by default). A payee offers objective terms; a signed breach report stops the stream and refunds the work after the breach, inside the holdback window. Refunds exist only where a developer offers such terms and the user accepts them before use; AI inference itself carries no refunds, and Dynamo enforces the agreed terms but never decides a refund. - Oracle breach reports - Preview. A separately running oracle can report a breach to the core.
- Service-level settlement on objective facts - Live in the engine and the in-process SDK only; on the API, objective terms and breach reports cover this. Signed facts such as latency or error rate throttle or stop a stream and drive refunds. See objective facts.
- Langfuse-interface oracle - Live. Turns self-hosted Langfuse observations into signed objective facts; no vendor account.
- Runaway-loop stop - Live in the engine and the in-process SDK; on a core it runs on the verified runtime (Preview:
CORE_VERIFIED=1, off by default). Declared burn ceilings stop a stream before the offending units are recorded. - Subscriptions - Live in the engine and the in-process SDK only; the API and the wire client have no subscription call. A budget re-funded each period; a declined renewal stops cleanly. See subscribe.
- Atomic batch - Live in the engine and the in-process SDK only; the API and the wire client have no batch call. Open or close many allowances at once, all or nothing. See batch.
- Price-feed settlement for other tokens - Live on a local chain; Release-gated with real funds. Stale or deviant prices stop settlement. See oracle-priced assets.
- Adopted payment rails - Live on local mocks; Release-gated with real funds. x402, MPP sessions, Circle Gateway and a Solana simulator, with every rail exit refused while signed work is unclaimed. See adopted rails.
- Rail verification - Live. A rail checks a signed authorization before it pays.
- Fee ledger - Live on a local chain. Every fee is its own ledger row from one fee source.
- Revenue switchboard and summary - Live. The operator sets the credit card platform fee; developers see revenue per end user and what they keep.
- Public fee schedule and calculator - Live. Published rates anyone can read, and a calculator page. See fees and developer fees.
- Ramps - Preview; operator-mode live payouts are Release-gated. Fund a stablecoin budget from your own Circle account, or pay a payee's onboarded bank destination. See ramps.
- Card agent programs - Preview. Network agent tokens fund credit card budgets; the token's controls only narrow the budget. See card agent programs.
Identity, credentials and payees
- Accounts and identity levels - Live. Accounts carry identity links with objective proofs; the level comes from the proof, never from a claim.
- Identity at each hop - Live. Payee proofs are recorded on each hop; a deployment can require a minimum funder identity.
- Scoped credentials - Live. Hand a hook, a parent agent or a payee a credential that reaches only its own budget, stream or payee routes.
- Agent verification (KYA) - Preview. A mandate can require a minimum attested agent level.
- Payee onboarding - Live. A payee registers its payout destinations with its own signature.
- Payee kit - Live on a local chain. A payee fetches its vouchers, checks them offline and settles with its own key.
Agent work
See Task Allowance, the agent network and human payments.
- Task Allowance - Live. Pay for delivered work once it is accepted, or by silence when the acceptance window ends.
- Agent network example - Live. Agents of different owners hire each other three levels deep, each on its own key, with evidence that verifies offline.
- Human payments - Live. A person pays a person or an agent from a budget, signing in their own wallet or with a confirmed click on a credit card budget.
- Hiring across owners over A2A - Live. One agent hires another over A2A; both sides' records verify offline.
- Wallet policies - Live on local mocks. Turn a mandate into a wallet delegation or policy that is never broader than the mandate.
- Protocol profiles - Live on mocks. Buyer sides for x402 V2, MPP and AP2, and test doubles for other payment gateways.
Enterprise
- Policies - Live. Versioned policy documents that only narrow a budget's mandate, with a dry run. See policies.
- Recourse - Live (a terms-breach case needs the terms catalogue, which is Preview). Disputes on objective facts only, resolved through the existing refund paths or escalated with a signed package. See recourse.
- Organisations, teams and roles - Live. Roles that only narrow what the owner can do. See organisations.
- Single sign-on - Preview. Members sign in through OIDC or SAML.
- Cost reports - Live. Spend by organisation, team, agent, vendor and rail, as JSON or CSV.
SDKs, command lines and the API
See the SDK, the generated reference and developers.
- TypeScript SDK - Live. Budgets, streams, reservations, approvals, evidence; tolerant of fields it does not know.
- In-process SDK - Live, from the repository only. Runs the engine inside your own process, with holdback, subscriptions and batch. See holdback.
- Python SDK and command line - Live.
- Developer CLI - Live. Log in, list keys (on multi-tenant (hosted) deployments), listen for webhooks, trigger test events, tail logs, watch a tree, use the main switch, verify evidence.
- Agents layers - Live. One budget split into capped slices for every agent and sub-agent, in TypeScript and Python.
- Version pinning and detailed errors - Live. On multi-tenant (hosted) deployments, pin the API version you built against; on every deployment, ask for detailed errors on older routes.
- Pagination - Live. List routes page only when you ask.
Integrator surfaces
See the merchant API, webhooks, x402 and acceptance.
- x402 paying and getting paid (TypeScript SDK) - Live in the the preview. Buyer: V1 Dynamo receipts, standard V1
exact, V2exact, V2upto. Seller:X402Seller/X402SellerRefsthrough facilitators (testnets only). V2 batch-settlement is refused in the preview SDK. - Merchant API - Live in the repository; Not in the preview yet on hosted preview cores. A service node verifies a credential aimed at it, checks a stream, its headroom and its finality, and manages webhook subscriptions.
- Webhooks - Live. Two signed schemes: merchant subscriptions, and owner endpoints with rotation, replay and an event catalogue.
- Plugin wire - Live. Gateways read stream state, meter and open child streams.
- Test payees - Live in Control Mode. Five reserved test payees: one approves, one refuses, one is slow, one disputes and one makes settlement fail. See testing.
- Starters - Live. Pay-per-use, capped agent, research crew and paid MCP tool.
End users and the browser
- Hosted top-up page - Live in Stripe TEST mode. An end user funds their own budget by credit card. See top-up.
- Widgets - Live. Balance, receipts, tree and approvals as embeddable elements with short-lived tokens. See widgets.
- Budget links - Live. A read-only link to one budget's spend.
- End-user portal - Live. An end user sees what their money funds and can freeze or revoke a stream.
- Human control console - Live. See every budget and stream, freeze, approve and stop; alerts by email and webhook.
- Local-first console - Live. Read-only screens over local session data.
- Hosted demo - Preview. A scripted demo stream for a throwaway instance.
Gateways and edges
See the guard, LiteLLM, Kong, APISIX, MCP and one-api.
- LiteLLM plugin - Live. Prices each request from a versioned table, reserves before forwarding, refuses an unpriced model.
- dynamo-guard - Live in Control Mode. One command for a capped base URL; resumes after a crash.
- MCP adapter - Live. Paid MCP tools: the price is reserved before the tool runs and billed before the answer.
- Kong and APISIX plugins - Live. Offline credential checks and metering, identical decisions on both.
- Envoy adapter - Live. Header-based metering for Envoy and agentgateway.
- Bifrost - Live in Control Mode. A native plugin, or Bifrost pointed at the guard.
- one-api path - Live in Control Mode. A capped base URL for one-api with no patch to one-api.
- x402 conformance suite - Live.
- Connector - Live. Assistant hosts read headroom and receipts and ask for payments; the connector never pays.
- Coding-agent hooks - Live in Control Mode. Caps for Cursor, Codex CLI and Gemini CLI.
Agent frameworks
See agent frameworks, n8n and Dify.
- Framework plugins - Live, tested in Control Mode: OpenAI Agents (Python and JavaScript), LangChain and LangGraph, LangGraph.js, CrewAI, Google ADK, the Claude Agent SDK (Python and TypeScript), the AI SDK, Mastra, Microsoft Agent Framework, Pydantic AI, Strands, NeMo and LlamaIndex. Each passes the shared scenarios for its kind: nine for a plugin that checks every call, six for one that scopes each spawned sub-agent (the Claude Agent SDK and NeMo).
- n8n nodes - Live in Control Mode. A refused step never runs the paid step.
- Dify tool plugin - Live in Control Mode, tested on Dify's plugin runtime.
Hosted tier and operations
See operators, service levels, platforms and known limits.
- Multi-tenant sign-up and dashboard - Live on multi-tenant (hosted) deployments. Sign up by email, get a test key and an example Control Mode budget.
- API keys and scopes - Live on multi-tenant (hosted) deployments. Test and live keys with owner, read-only, wire and merchant scopes.
- Quotas and rate limits - Live on multi-tenant (hosted) deployments.
- Tenant isolation - Live on multi-tenant (hosted) deployments. Another tenant's ids answer exactly like ids that do not exist.
- Hosted stablecoin adoption - Preview.
- Keys at rest - Live. Keys are encrypted on disk.
- Backup, restore and key rotation - Live.
- Metrics and alerts - Live. Prometheus metrics with no tenant label, and alert rules.
- Safe production defaults - Live. An unsafe configuration refuses to start, with the reason named.
- Platform smoke - Live. Run the first steps of a new machine on your own.
See the glossary for terms.