tollgate-sdk

create table if not exists public.payments (
  id             bigserial primary key,
  tx             text not null unique,
  wallet_address text,
  bot_name       text,
  path           text,
  lamports       bigint,
  timestamp      timestamptz not null default now()
);

create table if not exists public.verified_tx_cache (
  tx        text primary key,
  cached_at timestamptz not null default now()
);

# .env
SUPABASE_URL=https://your-project.supabase.co
SUPABASE_SERVICE_ROLE_KEY=your-service-role-key

import express from "express";
import { createPaywall } from "tollgate-sdk";
import { expressMiddleware } from "tollgate-sdk/express";

const paywall = createPaywall({
  walletAddress: process.env.SOLANA_WALLET_ADDRESS,
  network: "mainnet-beta",
  protect: ["/*"],              // gate all routes
  basePriceMicroUsdc: 1_000,   // $0.001 per crawl
});

const app = express();
app.use(expressMiddleware(paywall));

// req.paywallPayment is set when a bot paid successfully
app.get("/articles/:slug", (req, res) => {
  res.json({
    content: "Your article...",
    payment: req.paywallPayment ?? null,
  });
});

// middleware.ts
import { createPaywall } from "tollgate-sdk";
import { paywallMiddleware } from "tollgate-sdk/nextjs";

const paywall = createPaywall({
  walletAddress: process.env.SOLANA_WALLET_ADDRESS!,
  basePriceMicroUsdc: 1_000,
  protect: ["/articles/*", "/blog/*"],
});

export default paywallMiddleware(paywall);

export const config = { matcher: ["/articles/:path*", "/blog/:path*"] };

// app/articles/[slug]/route.ts
import { withRouteHandler } from "tollgate-sdk/nextjs";
import { paywall } from "@/lib/paywall"; // shared instance

export const GET = withRouteHandler(paywall, async (req) =>
  Response.json({ content: "Your article..." })
);

import Fastify from "fastify";
import { createPaywall } from "tollgate-sdk";
import { fastifyPlugin } from "tollgate-sdk/fastify";

const paywall = createPaywall({
  walletAddress: process.env.SOLANA_WALLET_ADDRESS,
  basePriceMicroUsdc: 1_000,
});

const app = Fastify();
await app.register(fastifyPlugin, { paywall });

app.get("/articles/:slug", async (req, reply) => {
  return { content: "Your article..." };
});

import { createPaywall } from "tollgate-sdk";
import { cloudflareHandler } from "tollgate-sdk/cloudflare";

export default {
  async fetch(request, env) {
    const paywall = createPaywall({
      walletAddress: env.SOLANA_WALLET_ADDRESS,
      basePriceMicroUsdc: 1_000,
    });

    return cloudflareHandler(paywall, request, async () =>
      new Response(JSON.stringify({ content: "Your article..." }), {
        headers: { "Content-Type": "application/json" },
      })
    );
  },
};

protect: ["/*"]                  // all routes
protect: ["/articles/*"]        // prefix match
protect: ["/blog/*", "/docs/*"] // multiple prefixes
protect: [/^/api//]           // RegExp

app.get("/article", (req, res) => {
  console.log(req.paywallPayment);
  // {
  //   signature: "3jK9xZ...",  // Solana tx signature
  //   payer:     "AgentWallet...",
  //   received:  1000           // micro-USDC received
  // }
});

const paywall = createPaywall({
  walletAddress: process.env.SOLANA_WALLET_ADDRESS,
  protect: ["/*"],
  onDetection: (d) => {
    console.log({
      isBot:    d.isBot,
      botName:  d.botName,     // "GPTBot", "ClaudeBot", etc.
      score:    d.score,       // composite score
      signals:  d.signals,     // ["ua:GPTBot(90)", "headers:suspicious(36)", ...]
      ip:       d.ip,
    });
  },
});

curl -X POST https://ai-paywall-production-f453.up.railway.app/v1/auth/nonce \
  -H "Content-Type: application/json" \
  -d '{"walletAddress": "YourSolanaWallet..."}'

# Response:
# {
#   "token": "<opaque-token>",
#   "message": "ai-paywall.dev wants you to sign in...",
#   "expiresAt": "2026-05-12T12:05:00.000Z"
# }

import nacl from "tweetnacl";
import bs58 from "bs58";

// message = the exact string from Step 1
const messageBytes = new TextEncoder().encode(message);
const signature = nacl.sign.detached(messageBytes, keypair.secretKey);
const signatureBase58 = bs58.encode(signature);

curl -X POST https://ai-paywall-production-f453.up.railway.app/v1/auth/verify \
  -H "Content-Type: application/json" \
  -d '{
    "walletAddress": "YourSolanaWallet...",
    "message": "<exact message from Step 1>",
    "signature": "<base58 signature>",
    "token": "<token from Step 1>"
  }'

# Response: { "session": "<token>", "expiresAt": "..." }

curl https://ai-paywall-production-f453.up.railway.app/v1/dashboard \
  -H "Authorization: Bearer <session-token>"

# Response:
# {
#   "wallet": { "address": "YourWallet..." },
#   "total": 42,
#   "total_lamports": 56000,
#   "payments": [
#     { "tx": "3jK9...", "botName": "GPTBot", "path": "/article", "lamports": 1000, "timestamp": "..." },
#     ...
#   ]
# }

# Verify where payments will land before going live
curl "https://ai-paywall-production-f453.up.railway.app/v1/wallet/treasury?walletAddress=YourWallet&network=mainnet-beta"

# Response:
# {
#   "walletAddress": "YourWallet...",
#   "network": "mainnet-beta",
#   "usdcMint": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
#   "treasuryAta": "7xKpT..."
# }