Paxiom Receipts MCP

Verify, issue, and explain Ed25519 proof-bound receipts (paxiom.receipt.v0) and preflight x402 APIs.

Máy chủ MCP được lưu trữ

npx add-mcp 'https://api.paxiom.org/mcp'

Cài vào Claude Code, Codex, Cursor và nhiều công cụ khác

Tài liệu

Paxiom — Proof-of-Delivery Receipts & Verifier (paxiom.receipt.v0)

npm PyPI License: MIT

x402 proves a payment. Paxiom proves what the payment bought.

Open MIT specification, x402 v2 delivery-receipt extension draft, zero-dependency TypeScript/Node & Python SDKs, MCP servers, free public reference verification runtime (https://api.paxiom.org), and specification site (https://paxiom.org) maintained by Driftbound Labs (https://driftboundlabs.com).

Shipped Packages & Free Public Reference Endpoints (v0.2.1)

SurfaceLocationInstall / Endpoint
TypeScript / Node & Workers SDKstandards/receipts/v0/npm install @paxiom/receipts (0.2.1, MIT, zero deps, @paxiom/receipts/web pure WebCrypto)
Python SDKstandards/receipts/v0/python/pip install paxiom-receipts (0.2.0, MIT, zero deps)
x402 v2 Extension Draftx402-delivery-receipt-extension.mdVendor-neutral Payment-Receipt header & /.well-known/x402-keys.json discovery
MCP Server (Official Registry)io.github.k-luecke/paxiom-receiptsnpx -y --package=@paxiom/receipts paxiom-receipt-mcp or https://api.paxiom.org/mcp
Offline Verifier Mirrorhttps://api.paxiom.org/v1/receipt/verifyFree public reference · schema, Ed25519 signature, signer pinning, & jcs-sha256 / raw-sha256 output binding
Live Base Settlement Verifierhttps://api.paxiom.org/v1/receipt/verify-liveFree public reference (60 req/min/IP) · verifies Base / Base Sepolia USDC Transfer logs + Ed25519 counter-attestation
x402 Seller Preflight Scannerhttps://api.paxiom.org/v1/x402/preflightFree public reference (30 req/min/IP) · SSRF-hardened pre-payment quote, asset, key-discovery, & receipt-readiness scan
Verifier Key Discoveryhttps://api.paxiom.org/.well-known/x402-keys.jsonPublished Ed25519 counter-signing public keys (also mirrored at /.well-known/paxiom-keys.json)
Documentation & Spec Sitehttps://paxiom.orgreceipts.html · api.html · llms.txt

Quick Verification

# Node SDK, Schema Validation & Cross-Language Test Vectors
cd standards/receipts/v0 && npm run validate && npm test

# Python SDK (zero-dependency stdlib + cross-language interop)
cd standards/receipts/v0 && python3 -m unittest discover -s python/tests -v

# Public Reference Verifier & x402 Preflight Runtime Suite
cd runtime/receipt-verifier && npm test

Explicit Boundaries (What v0.2.0 Checks vs. Does Not Claim)

  • Offline verification (verifyReceipt / POST /v1/receipt/verify) verifies schema conformance, deterministic canonical JSON (jcs-sha256) or raw byte (raw-sha256) payload digests, Ed25519 signatures, optional seller key / payTo authorization (unauthorized_issuer), and counter-attestation key pinning (trustedVerifierPublicKeys), reporting unverified on-chain hashes honestly as settlement_claimed_not_checked without touching RPC.
  • Live verification (POST /v1/receipt/verify-live) is operated as a free, rate-limited public reference utility (and is 100% MIT self-hostable via runtime/receipt-verifier/server.mjs). It verifies canonical Base (eip155:8453) and Base Sepolia (eip155:84532) USDC Transfer logs on-chain via multi-RPC failover and issues an Ed25519 counter-attestation, without inspecting internal facilitator databases or off-chain archives.
  • Earlier Ethereum sync-committee (k-luecke/bls-verifier) and Merkle-Patricia (k-luecke/paxiom) substrate prototypes remain documented in journal.html.

License

MIT — see LICENSE.