Skip to content

Align SDK commons contract to v1.1.0#21

Merged
GsCommand merged 1 commit intomainfrom
codex/align-sdk-with-v1.1.0-standards
Mar 22, 2026
Merged

Align SDK commons contract to v1.1.0#21
GsCommand merged 1 commit intomainfrom
codex/align-sdk-with-v1.1.0-standards

Conversation

@GsCommand
Copy link
Copy Markdown
Contributor

Motivation

  • Consolidate the SDKs on a single Canonical Commons v1.1.0 story (receipt-first, non-payment-aware) and remove lingering 1.0-era / x402-first assumptions.
  • Ensure Commons surfaces do not emit or teach payment metadata and that Commercial/x402 remains explicitly separate/legacy.
  • Make verification and parse flows match current runtime expectations (canonicalization, signature checks, and schema usage).

Description

  • Removed automatic x402 request metadata from Commons client payloads and marked x402 in the TypeScript receipt type as legacy/commercial-only, so Commons calls emit only actor + body.
  • Updated parse helpers to prefer the current-line schema field and accept legacy targetSchema/target_schema as a compatibility alias.
  • Relaxed verification semantics so metadata.receipt_id is treated as optional/opaque instead of required to mirror the hash, while preserving cl-stable-json-v1 canonicalization, SHA-256 recompute, and Ed25519 signature verification.
  • Regenerated test vectors (public key, expected hash, receipts) and updated unit/integration tests and examples/docs/quickstart/README to consistently present the v1.1.0 Commons vs Commercial story.

Testing

  • Ran TypeScript package tests: cd typescript-sdk && npm test — all unit and CLI smoke checks passed (41 passed, 0 failed).
  • Ran Python package tests: cd python-sdk && pytest — test suite passed (24 passed, 1 warning).
  • Added tests asserting Commons payloads omit x402 and that parse uses schema; updated verification parity tests to validate new fixtures.

Breaking changes

  • Commons request payloads no longer include x402 (integrations that expected SDK-emitted x402 must move that behavior to an explicit commercial flow or add it themselves).
  • Canonical Commons examples/fixtures no longer include x402 or require metadata.receipt_id.
  • parse() helpers now prefer schema (legacy targetSchema/target_schema accepted as alias).

SDK now reflects the v1.1.0 current-line system


Codex Task

@GsCommand GsCommand merged commit aae5b95 into main Mar 22, 2026
2 of 10 checks passed
@GsCommand GsCommand deleted the codex/align-sdk-with-v1.1.0-standards branch April 23, 2026 22:57
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant