From 402 to 200 in five minutes.

import { createGuard, fileLedger } from "@coinslot/guard"
import { privateKeyToAccount } from "viem/accounts"
import type { Hex } from "viem"

// The signer stays on this machine. Guard never sends keys anywhere.
const signer = privateKeyToAccount(process.env.AGENT_KEY as Hex)

const guard = createGuard({
  signer,
  perCall: "$0.01",
  daily: "$5",
  allow: { domains: ["api.example.com", "*.weather.dev"] },
  ledger: fileLedger(".coinslot/ledger.json"),
})

guard.on("blocked", (e) => console.warn("blocked:", e.rule, e.reason))
guard.on("paid", (e) => console.log("paid", e.amount, "left", e.budgetLeft))

const research = guard.task("research", { budget: "$0.50" })
const res = await research.fetch("https://api.example.com/v1/fact")
console.log(await res.json())

const research = guard.task("research", { budget: "$0.50" })

await research.fetch("https://api.example.com/v1/fact")
// the call that would cross $0.50 → blocked · budget

const guard = createGuard({
  signer,
  allow: { domains: ["api.example.com", "*.weather.dev"] },
  deny: { domains: ["ads.example.org"] },
})

const guard = createGuard({
  signer,
  allow: { payTo: ["0xSellerYouTrust"] },
  deny: { payTo: ["0xAddressYouDont"] },
})

const guard = createGuard({ signer, pinPayTo: true }) // the default

// approved once: api.example.com → 0x4b…7e
// later a 402 asks for 0x9a…c3 → blocked · payto_pinned

const guard = createGuard({
  signer,
  // first payment to a new seller waits for a human
  onNewSeller: async (seller) => askOnTelegram(seller), // true = pay
})

import { createGuard, fileLedger } from "@coinslot/guard"

const guard = createGuard({
  signer,
  ledger: fileLedger(".coinslot/ledger.json"),
})
// paid → timeout → retry: the same payment is re-sent, never a new one

const guard = createGuard({
  signer,
  killSwitch: { apiKey: process.env.COINSLOT_API_KEY },
})
// press Stop in the dashboard → next payment: blocked · kill_switch

paywall({
  payTo: process.env.WALLET!,
  network: "base",                    // "base" | "base-sepolia" | "solana" | "solana-devnet" | "eip155:8453"
  facilitator: "cdp",                 // "cdp" | "payai" | "thirdweb" | { url: "https://..." }
  routes: {
    "GET /v1/fact": "$0.001",
    "POST /v1/search": "$0.01",
  },
  rateLimit: { perPayer: 60, window: "1m" },
  idempotency: true,                  // default
  receipts: { apiKey: process.env.COINSLOT_API_KEY },
  bazaar: { description: "Random facts, one per call" },
})

// app/api/fact/route.ts
import { withPaywall } from "@coinslot/paywall/next"

export const GET = withPaywall(
  { price: "$0.001", payTo: process.env.WALLET! },
  async (req) => Response.json({ fact: "Bananas are berries. Strawberries aren't." }),
)

import { paidTool } from "@coinslot/paywall/mcp"
import { z } from "zod"

server.tool(
  "search",
  { query: z.string() },
  paidTool({ price: "$0.002", payTo: process.env.WALLET! }, async ({ query }) => ({
    content: [{ type: "text", text: await search(query) }],
  })),
)

paywall({ price: "$0.002", payTo, facilitator: "cdp" })       // default
paywall({ price: "$0.002", payTo, facilitator: "payai" })
paywall({ price: "$0.002", payTo, facilitator: "thirdweb" })
paywall({ price: "$0.002", payTo, facilitator: { url: "https://facilitator.example.com" } })

guard.on("payment_required", (e) => log(e.traceId, "402", e.amount, e.network, e.payTo))
guard.on("policy_check", (e) => log(e.traceId, e.rule, e.ok ? "ok" : "no", e.detail))
guard.on("paid", (e) => log(e.traceId, "paid", e.amount, "left", e.budgetLeft))
guard.on("settled", (e) => log(e.traceId, e.status, e.explorerUrl))
guard.on("replayed", (e) => log(e.traceId, "replayed from", e.originalTraceId))
guard.on("blocked", (e) => log(e.traceId, "blocked", e.rule, e.reason))

import { createGuard, otel } from "@coinslot/guard"

const guard = createGuard({ signer, telemetry: otel() })

guard.on("paid", (e) => console.log(e.traceId, e.amount, e.budgetLeft))