Kaspa x402

Spec

Current binding and transport documents, in suggested reading order. Historical versions remain available in the immutable release snapshots.

Status: draft alpha targeting kaspa:testnet-10. Mainnet use remains blocked by the documented readiness gates.

DocumentPurpose
kaspa-x402-v1Core binding: common rules for x402 v2 payments on Kaspa — networks, asset, amounts, envelopes.
kaspa-exact-v2Active exact binding: default standard-native transfer and optional KIP-10 additive head payment.
kaspa-batch-settlement-v1batch-settlement profile: escrow funding, cumulative vouchers, claim and refund.
http-profileHTTP transport: PAYMENT-REQUIRED, PAYMENT-SIGNATURE, and PAYMENT-RESPONSE flow.
mcp-profileMCP transport: paid tools using the standard _meta payment fields.
facilitator-profileOptional self-hosted facilitator: /supported, /verify, /settle compatibility surface.
errorsError reasons: public x402 error codes and mapping rules for Kaspa-local diagnostics.