@x402/sdk

Framework integrations for x402 protocol - Express, Next.js, Fastify, Hono.

Installation

npm install @x402/sdk @x402/core

Quick Start

Express.js

import { createX402Middleware } from '@x402/sdk/express';

const x402 = createX402Middleware({
  facilitatorUrl: 'http://localhost:3001',
  merchantAddress: 'YOUR_SOLANA_ADDRESS'
});

app.get('/premium', x402.requirePayment(0.01), handler);

Next.js App Router

import { withX402 } from '@x402/sdk/nextjs';

export const GET = withX402(handler, { amount: 0.01 });

Fastify

import x402Plugin from '@x402/sdk/fastify';

await fastify.register(x402Plugin, config);
fastify.get('/premium', { x402: { amount: 0.01 } }, handler);

Hono

import { x402 } from '@x402/sdk/hono';

app.get('/premium', x402({ amount: 0.01 }), handler);

Features

• ✅ Express.js middleware
• ✅ Next.js App Router & Pages Router
• ✅ Fastify plugin
• ✅ Hono middleware
• ✅ TypeScript support
• ✅ Auto-configuration

Framework Support

| Framework | Import | Usage | |-----------|--------|-------| | Express.js | @x402/sdk/express | x402.requirePayment(0.01) | | Next.js | @x402/sdk/nextjs | withX402(handler, {amount: 0.01}) | | Fastify | @x402/sdk/fastify | {x402: {amount: 0.01}} | | Hono | @x402/sdk/hono | x402({amount: 0.01}) |

Configuration

const config = {
  facilitatorUrl: 'http://localhost:3001',
  merchantAddress: 'YOUR_SOLANA_ADDRESS',
  maxPaymentAmount: 1000000000, // 1 SOL in lamports
  timeout: 10000 // 10 seconds
};

License

MIT © ENVXX Team