x402 service provider tooling for Azeth. Gate your Hono endpoints behind x402 payments with built-in payment-agreement support, SIWx sessions, and automatic reputation feedback.
npm install @azeth/provider
# or
pnpm add @azeth/provider
import { Hono } from 'hono';
import { createX402StackFromEnv } from '@azeth/provider';
const app = new Hono();
const { middleware, facilitator } = await createX402StackFromEnv({
app,
routes: {
'/api/data': { price: '$0.01', resource: 'https://api.example.com/data' },
},
});
app.use('/api/*', middleware);
app.get('/api/data', (c) => c.json({ answer: 42 }));
- x402 Payment Middleware -- Returns 402 with payment requirements, validates on-chain USDC settlement
- Payment Agreements -- Recurring subscriptions via on-chain
PaymentAgreementModule
- SIWx Sessions -- Agreement-aware session storage for repeat customers
- Agreement Keeper -- Periodic execution of due payment agreements
- Pre-Settled Payments -- Middleware for endpoints accepting pre-settled x402 proofs
- Local Facilitator -- On-chain payment verification without external facilitator dependency
| Export |
Description |
createX402Stack(config) |
Create x402 middleware + facilitator from explicit config |
createX402StackFromEnv(routes, overrides?) |
Create from env vars. Auto-resolves payTo to your smart account if not set. |
LocalFacilitatorClient |
On-chain USDC settlement verification |
| Export |
Description |
createPaymentAgreementExtension() |
x402 extension for agreement-based payments |
AzethSIWxStorage |
Agreement-aware SIWx session storage |
AgreementKeeper |
Periodic execution of due agreements |
findActiveAgreementForPayee() |
LRU-cached agreement lookup |
| Export |
Description |
preSettledPaymentMiddleware |
Accept pre-settled x402 payment proofs |
paymentMiddlewareFromHTTPServer |
Standard x402 HTTP resource server middleware |
MIT