v4.7.0
x402 payments that fail safely
This release makes agent-paid requests resilient, explicit, and recoverable.
- Balance checks now fall back across multiple Base RPC providers, preserving structured insufficient-funds and RPC-unavailable errors instead of leaking raw fetch failures.
- SDK callers can provide an explicit local allowance or opaque payment signer, and inspect the active payer with
paymentPayer()before authorizing spend. - Payment attempts are durably journaled with phase-aware errors. Safe pre-submission failures remain retryable; ambiguous post-submission failures carry an attempt ID and reconciliation guidance to prevent accidental double payment.
- CLI request headers are normalized consistently across wrapped request implementations.
- Added regression coverage and typed SDK documentation for payer selection, provider fallback, attempt recovery, and reconciliation.
Closes #499, #500, and #501 via #504.
Full changelog: v4.6.0...v4.7.0