Release notes - v2.2.0
MVP preview. Anyone can request access. Test mode only: Stripe test mode for card, public testnets for stablecoin (contract v2 alone). No real money. The gated commit is ab4695a5 (Full gate #131). Release files: ~/dynamo-release/v2.2.0-ab4695a5. Image index digest sha256:1877a88910b3ba827a0e50191444d5dd1d4d0ac28e8b5b7322c53a46e31df32c (dynamo-core:1.0.5).
See Preview for the feature list, limits and how to request access.
Versions in this release
| Piece | Version |
|---|---|
| Hosted core image | 1.0.5 |
| Owner API | 1.11.0 |
TypeScript SDK @dynamoprotocol/sdk | 4.2.0 (file dynamoprotocol-sdk-4.2.0.tgz) |
Internal SDK @dynamo/sdk | 1.11.0 |
Python SDK dynamoprotocol | 1.0.0 (file dynamoprotocol-1.0.0-py3-none-any.whl) |
| Console | 1.3.1 |
| x402 conformance | 1.4.0 |
| Conformance vectors | 1.7.0 |
The preview SDKs (TypeScript 4.2.0 and Python 1.0.0) are not on a public registry - install them from the files in your credentials blob. Do not republish them. Older August packages (@dynamoprotocol/sdk 2.x, @dynamoprotocol/guard, @dynamoprotocol/mcp, @dynamoprotocol/conformance-kit) remain on npm; they are not this preview.
What's new (entries 175-176)
- x402 paying: V1 Dynamo receipts, standard V1
exact, V2exact, V2
upto, from a capped stream (TypeScript SDK). Chains follow the testnet / mainnet refusal of entry 172.
- x402 getting paid:
X402Seller+ facilitator HTTP (x402.org, PayAI,
Coinbase CDP auth); Dynamo receipt seller via X402SellerRefs / verifyAndConsumeV1. Serve once, settle once (entries 177-178).
- Facilitator coverage table (entry 176): x402.org (Base Sepolia), PayAI
(Avalanche Fuji, Arbitrum Sepolia); CDP cells run at deploy with a recorded transaction hash.
- Durable x402 state across processes; failed writes kept and retried
(V213-D1-02, V213-D1-03).
- Release files (
make release-files): OCI archive, preview SDK tarball
and wheel, RELEASE-MANIFEST.txt tying them to one commit.
- Console: named testnet chains, top-up link carries the payee offer, revenue
view respects a non-switchable deployment.
What's fixed (entries 175-178)
| ID | Fix |
|---|---|
| V213-D1-01 | Unknown receipt is never treated as "not mined" |
| V213-D1-02 | x402 file stores are safe across processes |
| V213-D1-03 | A failed x402 state write is kept and retried |
| V213-D1-04 | Vault-guard cursors never skip a block on a lagging node |
| V213-D1-05 | Console names the testnet chain |
| V220-E1-01 | X402Seller resolved path serves once (atomic serving: claim) |
| V220-E1-05 | rail_x402.py removed from the preview Python wheel |
| V220-F-01 | serving: marker deleted when work throws after the claim |
| V220-F-03 | Mutation 506 deterministically asserts the claim race |
| V220-F-06 | Preview docs: x402.org permit2_allowance_required wording |
What's deferred (fix before real money or a wider launch)
See known limits and preview guide part 8. IDs: V220-E1-02, -03, -04, -06, -07, -08; V220-E2-01, -02; V220-F-01 crash window; V220-F-02; V220-F2-01 (entry 179).
Upgrade notes
- From a v2.1.x preview core: use image
1.0.5and the v2.2.0 SDK files. Pin
Dynamo-Version: 1.11.0 when you want 1.11.0-only response keys.
- Set
CORE_TRUSTED_PROXY_HOPSexplicitly behind an edge proxy (not baked into
the image).
- Before the first V2
uptopayment, approve Permit2 once for the budget's
USDC, never above the budget's cap (preview guide §10).
- Report any
settlement_pendingthat will not clear, with its transaction
hash, to the operator.
Off in this preview
Plugins and gateways, A2A, the MCP paywall, Dify and n8n, coding-agent hooks, framework plugins, adopted rails, ERC-7710 and wallet policies, ramps, KYA, card agent programs, organisations and roles, policy-as-code, SSO, tasks, recourse, terms and SLA settlement, the merchant API, x402 V2 batch-settlement, and a hosted stablecoin checkout page. Site pages for those features stay published and are marked Not in the preview yet.