r402-core 0.16.0

Core types, traits, and wire formats for the x402 payment protocol.
Documentation

r402-core

Core types, traits, and wire formats for the x402 payment protocol.

This crate is blockchain-agnostic. It defines the shared data model used by client, server, and facilitator implementations across every chain. Chain specific behavior lives in sibling crates (r402-evm, r402-solana, r402-tron, r402-casper).

Modules

  • [wire] — On-the-wire JSON types (offer, facilitator RPC, codecs) and settlement overrides
  • [facilitator] — Facilitator trait, DynFacilitator erasure, verify/settle hooks
  • [scheme] — Payment scheme registry and builder traits
  • [extensions] — Extension framework for x402 protocol extensions
  • [client] — PaymentClient orchestration
  • [resource_server] — Transport-agnostic verify → execute → settle
  • [chain] — CAIP-2 chain identifiers, address, provider abstractions
  • [amount] — Human-readable currency amount parsing ("$0.01" etc.)
  • [error] — Layered errors and machine-readable [ErrorReason] wire codes

Feature Flags

Flag Default Effect
telemetry Enable tracing instrumentation
cache Enable moka-backed TTL caches
ext-bazaar Enable the bazaar resource discovery ext.
ext-payment-id Enable the payment-identifier idempotency.
all-extensions Enable every built-in extension
full Enable every feature

License

Licensed under either of MIT or Apache-2.0, at your option.