https://github.com/azeth-protocol/provider
x402 service provider tooling for Azeth — gate Hono endpoints behind x402 payments
https://github.com/azeth-protocol/provider
account-abstraction ai-agents base blockchain erc-4337 ethereum hono http-402 machine-economy mcp middleware payments smart-accounts typescript usdc x402
Last synced: 4 days ago
JSON representation
x402 service provider tooling for Azeth — gate Hono endpoints behind x402 payments
- Host: GitHub
- URL: https://github.com/azeth-protocol/provider
- Owner: azeth-protocol
- License: mit
- Created: 2026-03-05T16:16:13.000Z (4 months ago)
- Default Branch: main
- Last Pushed: 2026-06-04T13:00:07.000Z (about 1 month ago)
- Last Synced: 2026-06-04T13:05:57.533Z (about 1 month ago)
- Topics: account-abstraction, ai-agents, base, blockchain, erc-4337, ethereum, hono, http-402, machine-economy, mcp, middleware, payments, smart-accounts, typescript, usdc, x402
- Language: TypeScript
- Homepage: https://azeth.ai
- Size: 84 KB
- Stars: 1
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
- awesome-x402 - Azeth Provider - Hono middleware for gating endpoints behind x402 payments with payment-agreement support for recurring agent-to-agent billing. ([npm](https://www.npmjs.com/package/@azeth/provider)) (🔧 Server Frameworks & Middleware / Node.js/TypeScript)
README
# @azeth/provider
x402 service provider tooling for [Azeth](https://azeth.ai). Gate your Hono endpoints behind x402 payments with built-in payment-agreement support, SIWx sessions, and automatic reputation feedback.
## Installation
```bash
npm install @azeth/provider
# or
pnpm add @azeth/provider
```
## Quick Start
```typescript
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 }));
```
## Features
- **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
## API
### Stack Setup
| 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 |
### Payment Agreements
| 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 |
### Middleware
| Export | Description |
|---|---|
| `preSettledPaymentMiddleware` | Accept pre-settled x402 payment proofs |
| `paymentMiddlewareFromHTTPServer` | Standard x402 HTTP resource server middleware |
## License
MIT