Skip to content

V2.1 - x402 Mainnet, Agent Discovery, Idempotency

Choose a tag to compare

View all tags
@LW-ARTS LW-ARTS released this 04 Apr 04:14
· 11 commits to main since this release
v2.1.0
64133d7

ClaimScan V2.1

The update where ClaimScan moved to mainnet and became discoverable by AI agents.

What's New

Base Mainnet settlement
x402 payments now settle in real USDC on Base Mainnet. Testnet training wheels are off. Every query to /api/v2/* triggers a real on-chain payment verified by a production facilitator before data is returned.

Bazaar extension for agent discovery
Every paid endpoint now publishes its input/output schema through the x402 bazaar extension. An AI agent can find ClaimScan, read what data is available, understand the query format, pay, and consume the response. No docs required. No human in the loop.

Payment-identifier for idempotency
Clients can attach a unique payment ID to each request. If a retry hits the same endpoint with the same ID, the facilitator returns the cached response instead of charging again. Retries are free.

Payment observability
Structured logging on every payment event: verify, settle, failure. Each event includes payer address, transaction hash, network, and amount. Forwarded to Sentry for real-time monitoring. If a payment fails, we know before the user does.

CSV injection protection
Export endpoints now sanitize all values before writing to CSV. Token symbols starting with =, +, -, or @ are prefixed to prevent formula injection when opened in Excel or Google Sheets.

Protocol spec conformance
Route configurations updated to match the x402 v2 protocol specification. The accepts field now uses the canonical array format for forward compatibility with strict SDK versions.

x402 package pinning
All x402 dependencies pinned to exact versions. The protocol is young and moving fast. Pinning prevents surprise breaking changes from minor version bumps.

Breaking Changes

None. All changes are additive or internal. Existing integrations continue to work.

Migration Notes

  • Clients that were testing against Base Sepolia need to switch to Base Mainnet USDC
  • The facilitator URL has changed from the default testnet endpoint to a production facilitator
  • No code changes required on the client side if using @x402/axios or @x402/fetch (network auto-detected from the 402 response)
Assets 2
Loading