nanocrawl-next 0.1.0

package/dist/index.d.ts

@@ -0,0 +1,29 @@
+/**
+ * nanocrawl-next — one-line x402 paywall for Next.js.
+ *
+ * Usage:
+ *   // middleware.ts
+ *   import { withNanocrawl } from 'nanocrawl-next'
+ *   export const middleware = withNanocrawl({
+ *     sellerWallet: process.env.NANOCRAWL_SELLER_WALLET,
+ *     priceUsdc: 0.001,
+ *   })
+ *   export const config = { matcher: ['/products/:path*'] }
+ */
+import { NextRequest, NextResponse } from "next/server";
+export interface NanocrawlConfig {
+    /** Your EVM wallet address to receive payments */
+    sellerWallet: string;
+    /** Price per page in USDC (default: 0.001) */
+    priceUsdc?: number;
+    /** Routes that are always free, even for crawlers */
+    freeRoutes?: string[];
+    /** Path to your verify handler (default: /api/nanocrawl-verify) */
+    verifyPath?: string;
+}
+/**
+ * Create a Next.js middleware that gates content for AI crawlers.
+ * Humans pass through with zero friction. Crawlers get a 402 or pay.
+ */
+export declare function withNanocrawl(userConfig: NanocrawlConfig): (request: NextRequest) => NextResponse;
+export type { NextRequest, NextResponse };

package/dist/index.js

@@ -0,0 +1,103 @@
+/**
+ * nanocrawl-next — one-line x402 paywall for Next.js.
+ *
+ * Usage:
+ *   // middleware.ts
+ *   import { withNanocrawl } from 'nanocrawl-next'
+ *   export const middleware = withNanocrawl({
+ *     sellerWallet: process.env.NANOCRAWL_SELLER_WALLET,
+ *     priceUsdc: 0.001,
+ *   })
+ *   export const config = { matcher: ['/products/:path*'] }
+ */
+import { NextResponse } from "next/server";
+// Arc Testnet constants
+const ARC = {
+    caip2: "eip155:5042002",
+    usdc: "0x3600000000000000000000000000000000000000",
+    gatewayWallet: "0x0077777d7EBA4688BDeF3E311b846F25870A19B9",
+};
+const BOT_PATTERN = /bot|crawl|spider|claude|gpt|anthropic|openai|perplexity|cohere|bytespider|ccbot|chatgpt|fetch|curl|wget|httpx|python-requests|python-urllib|node-fetch|axios|undici|go-http-client|scrapy|httpclient|java\/|libwww|mechanize|phantom|headless|puppeteer|playwright|selenium/i;
+function isCrawler(request) {
+    if (request.headers.get("payment-signature"))
+        return true;
+    if (request.headers.get("x-nanocrawl-capable"))
+        return true;
+    const ua = request.headers.get("user-agent") ?? "";
+    if (BOT_PATTERN.test(ua))
+        return true;
+    const hasAcceptLang = request.headers.get("accept-language");
+    const hasSecFetch = request.headers.get("sec-fetch-dest");
+    if (!hasAcceptLang && !hasSecFetch)
+        return true;
+    if (ua.length > 0 && ua.length < 20)
+        return true;
+    if (ua.length === 0)
+        return true;
+    return false;
+}
+function build402(request, config) {
+    const amount = Math.round(config.priceUsdc * 1_000_000).toString();
+    const paymentRequired = {
+        x402Version: 2,
+        resource: {
+            url: request.url,
+            mimeType: "application/json",
+            description: "NanoCrawl paid content",
+        },
+        accepts: [
+            {
+                scheme: "exact",
+                network: ARC.caip2,
+                asset: ARC.usdc,
+                amount,
+                payTo: config.sellerWallet,
+                maxTimeoutSeconds: 345600,
+                extra: {
+                    name: "GatewayWalletBatched",
+                    version: "1",
+                    verifyingContract: ARC.gatewayWallet,
+                },
+            },
+        ],
+    };
+    const encoded = Buffer.from(JSON.stringify(paymentRequired)).toString("base64");
+    return new NextResponse(JSON.stringify(paymentRequired, null, 2), {
+        status: 402,
+        headers: {
+            "Content-Type": "application/json",
+            "PAYMENT-REQUIRED": encoded,
+        },
+    });
+}
+/**
+ * Create a Next.js middleware that gates content for AI crawlers.
+ * Humans pass through with zero friction. Crawlers get a 402 or pay.
+ */
+export function withNanocrawl(userConfig) {
+    const config = {
+        priceUsdc: 0.001,
+        freeRoutes: [],
+        verifyPath: "/api/nanocrawl-verify",
+        ...userConfig,
+    };
+    return function middleware(request) {
+        const path = request.nextUrl.pathname;
+        // Free routes pass through
+        if (config.freeRoutes.some((r) => path === r || path.startsWith(r + "/"))) {
+            return NextResponse.next();
+        }
+        // Humans pass through
+        if (!isCrawler(request)) {
+            return NextResponse.next();
+        }
+        // Crawler with payment → route to verification
+        if (request.headers.get("payment-signature")) {
+            const verifyUrl = new URL(config.verifyPath, request.url);
+            verifyUrl.searchParams.set("resource", path);
+            return NextResponse.rewrite(verifyUrl);
+        }
+        // Crawler without payment → 402
+        return build402(request, config);
+    };
+}

package/dist/verify.d.ts

@@ -0,0 +1,32 @@
+/**
+ * nanocrawl-next/verify — payment verification handler.
+ *
+ * Usage:
+ *   // app/api/nanocrawl-verify/route.ts
+ *   import { createVerifyHandler } from 'nanocrawl-next/verify'
+ *   export const GET = createVerifyHandler({
+ *     sellerWallet: process.env.NANOCRAWL_SELLER_WALLET,
+ *     priceUsdc: 0.001,
+ *     getContent: async (path) => {
+ *       // Return the content for the given path as JSON
+ *       return { title: 'My Article', body: '...' }
+ *     },
+ *   })
+ */
+import { NextRequest, NextResponse } from "next/server";
+export interface VerifyConfig {
+    /** Your EVM wallet address */
+    sellerWallet: string;
+    /** Price per page in USDC (default: 0.001) */
+    priceUsdc?: number;
+    /**
+     * Return content for a given path. If not provided,
+     * the handler returns a generic success response.
+     */
+    getContent?: (path: string) => Promise<unknown>;
+}
+/**
+ * Create a Next.js route handler that verifies x402 payments
+ * via Circle Gateway and serves content.
+ */
+export declare function createVerifyHandler(userConfig: VerifyConfig): (request: NextRequest) => Promise<NextResponse<unknown>>;

package/dist/verify.js

@@ -0,0 +1,86 @@
+/**
+ * nanocrawl-next/verify — payment verification handler.
+ *
+ * Usage:
+ *   // app/api/nanocrawl-verify/route.ts
+ *   import { createVerifyHandler } from 'nanocrawl-next/verify'
+ *   export const GET = createVerifyHandler({
+ *     sellerWallet: process.env.NANOCRAWL_SELLER_WALLET,
+ *     priceUsdc: 0.001,
+ *     getContent: async (path) => {
+ *       // Return the content for the given path as JSON
+ *       return { title: 'My Article', body: '...' }
+ *     },
+ *   })
+ */
+import { NextResponse } from "next/server";
+// @ts-ignore
+import { BatchFacilitatorClient } from "@circle-fin/x402-batching/server";
+const ARC = {
+    caip2: "eip155:5042002",
+    usdc: "0x3600000000000000000000000000000000000000",
+    gatewayWallet: "0x0077777d7EBA4688BDeF3E311b846F25870A19B9",
+};
+const facilitator = new BatchFacilitatorClient({
+    url: "https://gateway-api-testnet.circle.com",
+});
+/**
+ * Create a Next.js route handler that verifies x402 payments
+ * via Circle Gateway and serves content.
+ */
+export function createVerifyHandler(userConfig) {
+    const config = { priceUsdc: 0.001, ...userConfig };
+    return async function GET(request) {
+        const paymentSigHeader = request.headers.get("payment-signature");
+        if (!paymentSigHeader) {
+            return NextResponse.json({ error: "Missing PAYMENT-SIGNATURE header" }, { status: 402 });
+        }
+        let paymentPayload;
+        try {
+            paymentPayload = JSON.parse(Buffer.from(paymentSigHeader, "base64").toString("utf-8"));
+        }
+        catch {
+            return NextResponse.json({ error: "Invalid PAYMENT-SIGNATURE encoding" }, { status: 400 });
+        }
+        const amount = Math.round(config.priceUsdc * 1_000_000).toString();
+        const requirements = {
+            scheme: "exact",
+            network: ARC.caip2,
+            asset: ARC.usdc,
+            amount,
+            payTo: config.sellerWallet,
+            maxTimeoutSeconds: 345600,
+            extra: {
+                name: "GatewayWalletBatched",
+                version: "1",
+                verifyingContract: ARC.gatewayWallet,
+            },
+        };
+        try {
+            const settlement = (await facilitator.settle(paymentPayload, requirements));
+            if (!settlement.success) {
+                return NextResponse.json({ error: "Payment settlement failed", reason: settlement.errorReason }, { status: 402 });
+            }
+            const auth = paymentPayload?.payload?.authorization;
+            const paymentResponse = {
+                success: true,
+                transaction: settlement.transaction,
+                network: ARC.caip2,
+                payer: auth?.from,
+            };
+            const encoded = Buffer.from(JSON.stringify(paymentResponse)).toString("base64");
+            // Serve content
+            const resourcePath = request.nextUrl.searchParams.get("resource") ?? "/";
+            const content = config.getContent
+                ? await config.getContent(resourcePath)
+                : { paid: true, path: resourcePath, transaction: settlement.transaction };
+            return NextResponse.json(content, {
+                headers: { "PAYMENT-RESPONSE": encoded },
+            });
+        }
+        catch (err) {
+            const msg = err instanceof Error ? err.message : String(err);
+            return NextResponse.json({ error: "Settlement error", message: msg }, { status: 500 });
+        }
+    };
+}

package/package.json

@@ -0,0 +1,34 @@
+{
+  "name": "nanocrawl-next",
+  "version": "0.1.0",
+  "description": "One-line x402 paywall for Next.js — AI crawlers pay per page, humans browse free",
+  "type": "module",
+  "exports": {
+    ".": "./dist/index.js",
+    "./verify": "./dist/verify.js"
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "prepublishOnly": "npm run build"
+  },
+  "dependencies": {
+    "@circle-fin/x402-batching": "^2.0.4",
+    "@x402/core": "^2.3.0",
+    "@x402/evm": "^2.9.0",
+    "viem": "^2.21.0"
+  },
+  "peerDependencies": {
+    "next": ">=14.0.0"
+  },
+  "devDependencies": {
+    "@types/node": "^22.0.0",
+    "@types/react": "^19.2.14",
+    "next": "^16.2.2",
+    "react": "^19.2.4",
+    "react-dom": "^19.2.4",
+    "typescript": "^5.7.0"
+  }
+}