PROTOCOL v2.0.0 • TRANSPORT AGNOSTIC

XMR402

The Internet’s Sovereign Payment Primitive for Agents, APIs, & Relays.

XMR402 is an open, neutral standard for internet-native payments. In v2.0, it evolves into a decoupled, transport-agnostic primitive. Whether you’re gating REST APIs via HTTP 402 or streaming P2P JSON frames over WebSockets, XMR402 enables any client to buy network resources in milliseconds.

Protocol Pillars

  • Transport Agnostic: From IETF HTTP 402 Headers to persistent JSON WebSocket relays. Dumb pipes, smart cryptographic edges.
  • Payload Binding: Intent matters. Every payment is cryptographically HMAC-bound to the request payload to kill instruction-spoofing.
  • Zero Friction: No accounts, no email, no personal information needed. Just a Monero wallet and a challenge.
  • Absolute Speed: Money moves at internet speed. 0-conf verification ensures 200ms resource access.
  • Stateless Purity: No databases. No polling. No wallet tracking bloat. XMR402 architecture relies purely on math and node RPCs.
  • Zero Protocol Fees: XMR402 is free for customer and merchant—just pay nominal network transaction fees.

Tactical Implementation

Standard 402 Response (Server-side):

WWW-Authenticate: XMR402 address="8...", amount="1000", message="nonce_123", timestamp="1772937600"

Authorization Header (Client-side retry):

Authorization: XMR402 txid="<hash>", proof="<signature>"

Developer Sandbox

Live sandbox API: https://demo-api.xmr402.org/intel

WebSocket relay: wss://demo-api.xmr402.org/relay

TypeScript SDK: @kyc-rip/ripley-guard-ts