@nerochain/x402-server

Middleware servidor para o protocolo de pagamento x402 V2 na NERO Chain. Protege endpoints pagos conversando com um facilitator NERO 402. Drop-in para Express, Hono, Fastify ou Next.js App Router.

Instalação

pnpm add @nerochain/x402-server

Uso — Express

import express from "express";
import { x402Express } from "@nerochain/x402-server/express";

const app = express();

app.post(
  "/api/llm",
  x402Express({
    paymentRequirements: {
      scheme: "aa-native",
      network: "eip155:1689",
      amount: "1000",                              // 0.001 USDC (6 casas)
      asset: "0x97eec1c29f745dc7c267f90292aa663d997a601d",
      payTo: "0xSeuEndereçoMerchant",
      maxTimeoutSeconds: 60,
    },
    facilitator: { url: "https://facilitator.x402.nerochain.io" },
  }),
  (req, res) => res.json({ answer: "..." }),
);

O middleware emite HTTP 402 com PAYMENT-REQUIRED na primeira requisição, depois verifica e liquida a tentativa subsequente contra o facilitator. O handler só roda após a liquidação com sucesso, com req.x402Payer populado.

Adapters

• @nerochain/x402-server/express — Express
• @nerochain/x402-server/hono — Hono
• @nerochain/x402-server/fastify — Fastify
• @nerochain/x402-server/next — Next.js App Router
• @nerochain/x402-server/paywall — Adapter paywall HTML (para navegadores sem cliente x402)

Documentação

Referência completa: https://x402.nerochain.io/docs/sdk/x402-server.

Licença

MIT.