Skip to content

v0.5.9 — Exact V2 Compatibility

Latest

Choose a tag to compare

@boboliu-1010 boboliu-1010 released this 14 Apr 13:09
· 40 commits to main since this release
eab291f

Exact V2 Compatibility

The exact payment scheme (EVM and TRON) now produces V2-compatible payloads conforming to the x402 Foundation wire format, enabling interoperability with the upstream facilitator and other V2-compliant implementations.

Added

  • Exact V2 compatibility with Coinbase x402 Foundation spec — exact scheme payload now conforms to the upstream V2 wire format for EVM and TRON
  • BSC Testnet (eip155:97) support with DHLU test token for exact EVM payments
  • BSC testnet smoke test examples (TypeScript and Python) under examples/bsc-testnet-smoke/
  • nativeExactEvm unit tests for EVM exact scheme
  • Server-side x-payment-signature verification tests (Python)

Changed

  • nativeExact / nativeExactEvm / nativeExactTron mechanisms updated to emit V2-compatible payloads (authorization structure with typed fields instead of flat hex blob)
  • PaymentPayload TypeScript type expanded to support both V1 and V2 payload shapes
  • Token registry (tokens.ts) updated with BSC testnet DHLU entry
  • GasFree utility refactored for cleaner error handling and status polling

Fixed

  • TypeScript SDK local build restored for exact v2 (package-lock.json regenerated)
  • Python tx_verification utility updated for V2 payload structure

Breaking

  • Minimum Node.js version raised from 18 to 20 (pnpm 10 requires Node >= 20)

Verification

  • TypeScript: 51/51 tests passed
  • Python: 217/217 tests passed
  • BSC Testnet end-to-end: settlement tx confirmed on eip155:97

Affected SDKs:

  • Python: bankofai-x402==0.5.9
  • TypeScript: @bankofai/x402@0.5.9

Full Changelog: v0.5.8...v0.5.9