@agentpay-sui/middleware

Provider-side x402 helpers for paid API routes.

The package exports:

• withX402(...): Express-compatible middleware
• withX402Route(handler, options): Web Request/Response wrapper for Next route handlers, Hono-compatible runtimes, Bun, and Workers-style handlers
• withX402Hono(options): Hono-style middleware adapter
• createX402Challenge(...), verifyX402Payment(...), and settleX402Payment(...) for custom frameworks

The middleware enforces the important payment order:

1. no PAYMENT-SIGNATURE / X-PAYMENT means return a 402 challenge with PAYMENT-REQUIRED
2. malformed PAYMENT-SIGNATURE / X-PAYMENT means 400
3. facilitator /verify must pass before provider code runs
4. provider failures are not settled
5. successful provider responses call /settle and expose PAYMENT-RESPONSE plus legacy X-PAYMENT-RESPONSE