Skip to content

@openlibx402/nextjs

Next.js middleware and utilities for the X402 payment protocol. This package provides seamless integration of blockchain-based micropayments into your Next.js applications.

Installation

1
npm install @openlibx402/nextjs @openlibx402/core @solana/web3.js

Features

  • App Router Support - Built for Next.js 13+ App Router
  • Payment Verification - Automatic on-chain payment verification
  • TypeScript - Full type safety
  • Flexible Configuration - Global or per-route configuration
  • Easy Integration - Simple higher-order function API

Usage

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
import { X402Config, initX402, withPayment } from '@openlibx402/nextjs';

// Initialize configuration
const config = new X402Config({
  paymentAddress: process.env.PAYMENT_WALLET_ADDRESS!,
  tokenMint: process.env.USDC_MINT_ADDRESS!,
  network: 'solana-devnet',
});

initX402(config);

// Protect API routes
export const GET = withPayment(
  {
    amount: '0.10',
    description: 'Access to premium data',
  },
  async (req, context) => {
    return NextResponse.json({
      data: 'Premium content',
      payment_id: context.payment?.paymentId,
    });
  }
);

License

MIT