@seedhape/x402-merchant-sdk 0.1.0

package/README.md

@@ -0,0 +1,115 @@
+# @seedhape/x402-merchant-sdk
+
+Add an x402 payment gate to an existing Express, Hono, or `node:http` service. The SDK returns a standard `402 Payment Required` challenge, verifies the buyer's payment through an x402 facilitator, settles USDC directly to the merchant wallet, and exposes a receipt for your application ledger.
+
+## Install
+
+```bash
+npm install @seedhape/x402-merchant-sdk
+```
+
+## Express
+
+```ts
+import express from "express";
+import { BASE_MAINNET, expressPaywall } from "@seedhape/x402-merchant-sdk";
+
+const app = express();
+
+app.use(expressPaywall({
+  ...BASE_MAINNET,
+  payTo: "0xYourBaseMerchantWallet",
+  paymentMethods: ["eip3009", "erc7710"],
+  price: ({ path }) => path === "/weather"
+    ? { amount: 50_000n, ...BASE_MAINNET }
+    : null,
+  free: ["/health", "/docs/*"],
+  facilitator: { url: process.env.FACILITATOR_URL! },
+  description: "Current weather data",
+  receipts: { record: async (receipt) => db.receipts.insert(receipt) },
+}));
+
+app.get("/weather", (req, res) => {
+  res.json({ temperature: 24, conditions: "clear", receipt: req.x402Receipt?.id });
+});
+```
+
+`price` may be a fixed `Money` object or a resolver based on the request path, method, and query. Return `null` for a free route. USDC amounts are integer base units: `50_000n` is `0.05 USDC`.
+
+## Network presets and payment methods
+
+Use `BASE_MAINNET` or `BASE_SEPOLIA` to preconfigure the CAIP-2 network, USDC contract, decimals, and default facilitator:
+
+```ts
+import { BASE_SEPOLIA, expressPaywall } from "@seedhape/x402-merchant-sdk";
+
+app.use(expressPaywall({
+  ...BASE_SEPOLIA,
+  payTo: "0xYourStagingWallet",
+  paymentMethods: ["eip3009"],
+  price: ({ path }) => path === "/weather"
+    ? { amount: 10_000n, ...BASE_SEPOLIA }
+    : null,
+}));
+```
+
+`paymentMethods` is optional and defaults to `['eip3009']` for backward compatibility. Set `['erc7710']` to advertise only delegated payments, or `['eip3009', 'erc7710']` to let the buyer/client choose. Override `facilitator` when using a compatible provider of your choice.
+
+## Hono and node:http
+
+Use `honoPaywall(config)` with Hono or `nodePaywall(config)` for a raw Node server. All adapters use the same `PaywallConfig` and facilitator contract.
+
+## Payment flow
+
+1. An unpaid request receives a `402` challenge containing the merchant wallet, USDC asset, Base network, amount, and resource URL.
+2. The buyer creates an x402 payment using EIP-3009 or another supported payment method.
+3. The facilitator verifies and settles the payment.
+4. USDC settles directly to `payTo`; Seedhape never holds merchant funds.
+5. The request continues and `req.x402Receipt` contains the settlement record.
+
+The SDK currently emits the exact x402 challenge shape. ERC-7710 selection is handled by a compatible client/facilitator path; the merchant's responsibility is to declare an accurate recipient, asset, network, amount, and resource.
+
+## Bazaar discovery
+
+Bazaar is an optional discovery layer. Add Bazaar discovery metadata to your x402 route when using an x402 resource server/facilitator that supports the Bazaar extension. Describe the input schema, route, method, and response so agents can find the service without a hardcoded URL. Bazaar does not change settlement or custody.
+
+## Sonar discovery
+
+[Sonar](https://sonar.seedhape.com/) is Seedhape's service discovery surface for merchants and agents. After deploying your x402 endpoint, list it in Sonar with its public URL, HTTP method, service description, input schema, price, token, network, receiving wallet, and supported payment methods. Sonar helps agents discover and evaluate the service; it does not custody funds or settle payments. The x402 paywall and facilitator still perform verification and settlement.
+
+Sonar listing does not replace Bazaar metadata. A merchant can publish Bazaar discovery metadata for the open x402 ecosystem and list the same endpoint in Sonar for Seedhape discovery.
+
+## Production checklist
+
+- Use a self-custodial merchant receiving address.
+- Use `eip155:8453` and Base USDC in production; use Base Sepolia only for testing.
+- Configure a production facilitator URL and keep it server-side.
+- Keep health, documentation, and discovery metadata routes free.
+- Record the receipt ID, resource, payer, amount, network, and transaction hash.
+- Treat `payTo`, asset, network, and resource as server-controlled values; never accept them from the buyer.
+
+## Publishing and full integration guide
+
+Authenticate and verify the package:
+
+```bash
+npm login
+npm whoami
+npm run typecheck
+npm run build:packages
+npm pack --dry-run --workspace=@seedhape/x402-merchant-sdk
+```
+
+Publish the public scoped package:
+
+```bash
+npm publish --workspace=@seedhape/x402-merchant-sdk --access public
+```
+
+For local tarball testing, versioning, Bazaar metadata, and the complete release checklist, see the repository guide:
+
+[`docs/SDK-PUBLISHING-GUIDE.md`](https://github.com/seedhape/seedhape/blob/main/docs/SDK-PUBLISHING-GUIDE.md)
+
+## License
+
+MIT

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+export * from "./middleware.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,iBAAiB,CAAC"}

package/dist/index.js

@@ -0,0 +1,2 @@
+export * from "./middleware.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,iBAAiB,CAAC"}

package/dist/middleware.d.ts

@@ -0,0 +1,154 @@
+/**
+ * Merchant SDK — the paywall.
+ *
+ * Be clear-eyed about what this part is worth: wrapping an endpoint in a 402 is
+ * commoditised. CloudFront does it as a config change, Stripe and Cloudflare
+ * both ship it. If all you need is "charge agents per call", use one of those.
+ *
+ * What this SDK adds is the merchant-side boundary after a payment lands:
+ * settlement receipts keyed to your own order IDs and a transport-neutral API
+ * for Express, Hono, and node:http services.
+ */
+import type { IncomingMessage, ServerResponse } from "node:http";
+export interface Money {
+    /** Base units of the asset. USDC has 6 decimals. */
+    amount: bigint;
+    asset: string;
+    network: string;
+    decimals: number;
+}
+export interface PriceResolver {
+    (req: {
+        path: string;
+        method: string;
+        query: URLSearchParams;
+    }): Money | null;
+}
+export interface Receipt {
+    id: string;
+    resource: string;
+    payer?: string;
+    payTo: string;
+    amount: bigint;
+    asset: string;
+    network: string;
+    txHash?: string;
+    /** INR paise at settlement time. */
+    inrPaise?: bigint;
+    fxRateScaled?: bigint;
+    settledAt: number;
+    /** Your own order/customer reference, if the caller supplied one. */
+    merchantRef?: string;
+}
+export interface ReceiptSink {
+    record(r: Receipt): Promise<void>;
+}
+export interface FacilitatorConfig {
+    /** e.g. https://x402.org/facilitator or your own. */
+    url: string;
+    apiKey?: string;
+}
+export type PaymentMethod = "eip3009" | "erc7710";
+export interface MerchantNetworkConfig {
+    network: string;
+    asset: string;
+    decimals: number;
+    facilitator: FacilitatorConfig;
+}
+/** Base mainnet + USDC defaults. Override any field for a custom facilitator. */
+export declare const BASE_MAINNET: MerchantNetworkConfig;
+/** Base Sepolia + USDC defaults for development and staging. */
+export declare const BASE_SEPOLIA: MerchantNetworkConfig;
+export interface PaywallConfig {
+    payTo: string;
+    network: string;
+    asset: string;
+    decimals?: number;
+    /** Payment authorization methods advertised in the 402 response. */
+    paymentMethods?: PaymentMethod[];
+    /** Fixed price, or a function of the request. Return null to leave a route free. */
+    price: Money | PriceResolver;
+    facilitator: FacilitatorConfig;
+    receipts?: ReceiptSink;
+    /** INR per USDC scaled 1e8, for receipt valuation. */
+    fxRateScaled?: () => Promise<bigint>;
+    description?: string;
+    maxTimeoutSeconds?: number;
+    /** Routes that never require payment, e.g. ["/health", "/.well-known/*"]. */
+    free?: string[];
+    /**
+     * Settle before serving (safer, slower) or after (faster, risks serving an
+     * unsettled request). Default "before". Only choose "after" for idempotent
+     * reads where a rare free response is cheaper than the added latency.
+     */
+    settlement?: "before" | "after";
+}
+export interface VerifyResult {
+    isValid: boolean;
+    invalidReason?: string;
+    payer?: string;
+}
+export interface SettleResult {
+    success: boolean;
+    transaction?: string;
+    network?: string;
+    payer?: string;
+    errorReason?: string;
+}
+export declare class Facilitator {
+    private readonly cfg;
+    private readonly fetchImpl;
+    constructor(cfg: FacilitatorConfig, fetchImpl?: typeof fetch);
+    verify(payload: unknown, requirements: unknown): Promise<VerifyResult>;
+    settle(payload: unknown, requirements: unknown): Promise<SettleResult>;
+    private call;
+}
+export interface PaywallOutcome {
+    /** "free" | "challenge" | "paid" | "rejected" */
+    kind: "free" | "challenge" | "paid" | "rejected";
+    status?: number;
+    challenge?: unknown;
+    settlementHeader?: string;
+    receipt?: Receipt;
+    reason?: string;
+}
+export declare class Paywall {
+    private readonly cfg;
+    private readonly facilitator;
+    private readonly decimals;
+    constructor(cfg: PaywallConfig);
+    priceFor(path: string, method: string, query: URLSearchParams): Money | null;
+    buildChallenge(price: Money, resource: string): {
+        x402Version: number;
+        accepts: {
+            scheme: string;
+            network: string;
+            maxAmountRequired: string;
+            resource: string;
+            description: string;
+            mimeType: string;
+            payTo: string;
+            maxTimeoutSeconds: number;
+            asset: string;
+            extra: {
+                name: string;
+                version: string;
+                decimals: number;
+                assetTransferMethod: PaymentMethod;
+            };
+        }[];
+    };
+    handle(args: {
+        path: string;
+        method: string;
+        query: URLSearchParams;
+        resource: string;
+        paymentHeader: string | null;
+        merchantRef?: string;
+    }): Promise<PaywallOutcome>;
+    private writeReceipt;
+}
+export declare function expressPaywall(cfg: PaywallConfig): (req: any, res: any, next: any) => Promise<any>;
+export declare function honoPaywall(cfg: PaywallConfig): (c: any, next: any) => Promise<any>;
+export declare function nodePaywall(cfg: PaywallConfig): (req: IncomingMessage, res: ServerResponse) => Promise<Receipt | "free" | null>;
+//# sourceMappingURL=middleware.d.ts.map

package/dist/middleware.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"middleware.d.ts","sourceRoot":"","sources":["../src/middleware.ts"],"names":[],"mappings":"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"}

package/dist/middleware.js

@@ -0,0 +1,286 @@
+/**
+ * Merchant SDK — the paywall.
+ *
+ * Be clear-eyed about what this part is worth: wrapping an endpoint in a 402 is
+ * commoditised. CloudFront does it as a config change, Stripe and Cloudflare
+ * both ship it. If all you need is "charge agents per call", use one of those.
+ *
+ * What this SDK adds is the merchant-side boundary after a payment lands:
+ * settlement receipts keyed to your own order IDs and a transport-neutral API
+ * for Express, Hono, and node:http services.
+ */
+import { randomUUID } from "node:crypto";
+/** Base mainnet + USDC defaults. Override any field for a custom facilitator. */
+export const BASE_MAINNET = {
+    network: "eip155:8453",
+    asset: "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
+    decimals: 6,
+    facilitator: { url: "https://api.cdp.coinbase.com/platform/v2/x402" },
+};
+/** Base Sepolia + USDC defaults for development and staging. */
+export const BASE_SEPOLIA = {
+    network: "eip155:84532",
+    asset: "0x036CbD53842c5426634e7929541eC2318f3dCF7e",
+    decimals: 6,
+    facilitator: { url: "https://api.cdp.coinbase.com/platform/v2/x402" },
+};
+// ---------------------------------------------------------------------------
+// Facilitator
+// ---------------------------------------------------------------------------
+export class Facilitator {
+    cfg;
+    fetchImpl;
+    constructor(cfg, fetchImpl = fetch) {
+        this.cfg = cfg;
+        this.fetchImpl = fetchImpl;
+    }
+    async verify(payload, requirements) {
+        return this.call("/verify", { paymentPayload: payload, paymentRequirements: requirements });
+    }
+    async settle(payload, requirements) {
+        return this.call("/settle", { paymentPayload: payload, paymentRequirements: requirements });
+    }
+    async call(path, body) {
+        const res = await this.fetchImpl(`${this.cfg.url}${path}`, {
+            method: "POST",
+            headers: {
+                "content-type": "application/json",
+                ...(this.cfg.apiKey ? { authorization: `Bearer ${this.cfg.apiKey}` } : {}),
+            },
+            body: JSON.stringify(body),
+        });
+        if (!res.ok) {
+            const t = await res.text();
+            throw new Error(`Facilitator ${path} returned ${res.status}: ${t}`);
+        }
+        return (await res.json());
+    }
+}
+export class Paywall {
+    cfg;
+    facilitator;
+    decimals;
+    constructor(cfg) {
+        this.cfg = cfg;
+        this.facilitator = new Facilitator(cfg.facilitator);
+        this.decimals = cfg.decimals ?? 6;
+    }
+    priceFor(path, method, query) {
+        if (this.cfg.free?.some((p) => matchRoute(path, p)))
+            return null;
+        const p = this.cfg.price;
+        return typeof p === "function" ? p({ path, method, query }) : p;
+    }
+    buildChallenge(price, resource) {
+        const paymentMethods = this.cfg.paymentMethods?.length
+            ? this.cfg.paymentMethods
+            : ["eip3009"];
+        return {
+            x402Version: 1,
+            accepts: paymentMethods.map((paymentMethod) => ({
+                scheme: "exact",
+                network: this.cfg.network,
+                maxAmountRequired: price.amount.toString(),
+                resource,
+                description: this.cfg.description ?? "",
+                mimeType: "application/json",
+                payTo: this.cfg.payTo,
+                maxTimeoutSeconds: this.cfg.maxTimeoutSeconds ?? 300,
+                asset: this.cfg.asset,
+                extra: { name: "USDC", version: "2", decimals: this.decimals, assetTransferMethod: paymentMethod },
+            })),
+        };
+    }
+    async handle(args) {
+        const price = this.priceFor(args.path, args.method, args.query);
+        if (!price || price.amount === 0n)
+            return { kind: "free" };
+        if (!args.paymentHeader) {
+            return {
+                kind: "challenge",
+                status: 402,
+                challenge: this.buildChallenge(price, args.resource),
+            };
+        }
+        let payload;
+        try {
+            payload = JSON.parse(Buffer.from(args.paymentHeader, "base64").toString("utf8"));
+        }
+        catch {
+            return { kind: "rejected", status: 400, reason: "X-PAYMENT header is not valid base64 JSON." };
+        }
+        const requirements = this.buildChallenge(price, args.resource).accepts[0];
+        const verified = await this.facilitator.verify(payload, requirements);
+        if (!verified.isValid) {
+            return {
+                kind: "rejected",
+                status: 402,
+                reason: verified.invalidReason ?? "Payment verification failed.",
+                challenge: this.buildChallenge(price, args.resource),
+            };
+        }
+        if (this.cfg.settlement === "after") {
+            // Caller serves first, then invokes settleLater(). Kept explicit rather
+            // than fire-and-forget so a failed settlement is not silently swallowed.
+            return { kind: "paid", receipt: undefined };
+        }
+        const settled = await this.facilitator.settle(payload, requirements);
+        if (!settled.success) {
+            return {
+                kind: "rejected",
+                status: 402,
+                reason: settled.errorReason ?? "Settlement failed.",
+            };
+        }
+        const receipt = await this.writeReceipt({
+            resource: args.resource,
+            price,
+            settled,
+            payer: verified.payer ?? settled.payer,
+            merchantRef: args.merchantRef,
+        });
+        return {
+            kind: "paid",
+            receipt,
+            settlementHeader: Buffer.from(JSON.stringify(settled), "utf8").toString("base64"),
+        };
+    }
+    async writeReceipt(args) {
+        let inrPaise;
+        let fxRateScaled;
+        if (this.cfg.fxRateScaled) {
+            try {
+                fxRateScaled = await this.cfg.fxRateScaled();
+                inrPaise =
+                    (args.price.amount * fxRateScaled * 100n) /
+                        (10n ** BigInt(this.decimals) * 100000000n);
+            }
+            catch {
+                // A missing FX rate must not fail a settled payment. Backfill later.
+            }
+        }
+        const receipt = {
+            id: randomUUID(),
+            resource: args.resource,
+            payer: args.payer,
+            payTo: this.cfg.payTo,
+            amount: args.price.amount,
+            asset: this.cfg.asset,
+            network: this.cfg.network,
+            txHash: args.settled.transaction,
+            inrPaise,
+            fxRateScaled,
+            settledAt: Math.floor(Date.now() / 1000),
+            merchantRef: args.merchantRef,
+        };
+        await this.cfg.receipts?.record(receipt);
+        return receipt;
+    }
+}
+// ---------------------------------------------------------------------------
+// Express adapter
+// ---------------------------------------------------------------------------
+/* eslint-disable @typescript-eslint/no-explicit-any */
+export function expressPaywall(cfg) {
+    const paywall = new Paywall(cfg);
+    return async function middleware(req, res, next) {
+        try {
+            const url = new URL(req.originalUrl ?? req.url, `http://${req.headers.host ?? "localhost"}`);
+            const outcome = await paywall.handle({
+                path: url.pathname,
+                method: req.method,
+                query: url.searchParams,
+                resource: url.toString(),
+                paymentHeader: req.headers["x-payment"] ?? null,
+                merchantRef: req.headers["x-merchant-ref"],
+            });
+            switch (outcome.kind) {
+                case "free":
+                    return next();
+                case "challenge":
+                    res.status(402).json(outcome.challenge);
+                    return;
+                case "rejected":
+                    res.status(outcome.status ?? 402).json({
+                        error: outcome.reason,
+                        ...(outcome.challenge ?? {}),
+                    });
+                    return;
+                case "paid":
+                    if (outcome.settlementHeader) {
+                        res.setHeader("X-PAYMENT-RESPONSE", outcome.settlementHeader);
+                        res.setHeader("Access-Control-Expose-Headers", "X-PAYMENT-RESPONSE");
+                    }
+                    req.x402Receipt = outcome.receipt;
+                    return next();
+            }
+        }
+        catch (e) {
+            next(e);
+        }
+    };
+}
+// ---------------------------------------------------------------------------
+// Hono / Fetch-API adapter
+// ---------------------------------------------------------------------------
+export function honoPaywall(cfg) {
+    const paywall = new Paywall(cfg);
+    return async function middleware(c, next) {
+        const url = new URL(c.req.url);
+        const outcome = await paywall.handle({
+            path: url.pathname,
+            method: c.req.method,
+            query: url.searchParams,
+            resource: url.toString(),
+            paymentHeader: c.req.header("x-payment") ?? null,
+            merchantRef: c.req.header("x-merchant-ref"),
+        });
+        if (outcome.kind === "free")
+            return next();
+        if (outcome.kind === "challenge")
+            return c.json(outcome.challenge, 402);
+        if (outcome.kind === "rejected") {
+            return c.json({ error: outcome.reason, ...(outcome.challenge ?? {}) }, (outcome.status ?? 402));
+        }
+        c.set("x402Receipt", outcome.receipt);
+        await next();
+        if (outcome.settlementHeader) {
+            c.res.headers.set("X-PAYMENT-RESPONSE", outcome.settlementHeader);
+            c.res.headers.set("Access-Control-Expose-Headers", "X-PAYMENT-RESPONSE");
+        }
+    };
+}
+// ---------------------------------------------------------------------------
+// Raw node:http adapter, for anything else
+// ---------------------------------------------------------------------------
+export function nodePaywall(cfg) {
+    const paywall = new Paywall(cfg);
+    return async function guard(req, res) {
+        const url = new URL(req.url ?? "/", `http://${req.headers.host ?? "localhost"}`);
+        const outcome = await paywall.handle({
+            path: url.pathname,
+            method: req.method ?? "GET",
+            query: url.searchParams,
+            resource: url.toString(),
+            paymentHeader: req.headers["x-payment"] ?? null,
+        });
+        if (outcome.kind === "free")
+            return "free";
+        if (outcome.kind === "paid") {
+            if (outcome.settlementHeader) {
+                res.setHeader("X-PAYMENT-RESPONSE", outcome.settlementHeader);
+            }
+            return outcome.receipt ?? null;
+        }
+        res.statusCode = outcome.status ?? 402;
+        res.setHeader("content-type", "application/json");
+        res.end(JSON.stringify(outcome.challenge ?? { error: outcome.reason }));
+        return null;
+    };
+}
+function matchRoute(path, pattern) {
+    if (pattern.endsWith("/*"))
+        return path.startsWith(pattern.slice(0, -1));
+    return path === pattern;
+}
+//# sourceMappingURL=middleware.js.map

package/dist/middleware.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"middleware.js","sourceRoot":"","sources":["../src/middleware.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -0,0 +1,16 @@
+{
+  "name": "@seedhape/x402-merchant-sdk",
+  "version": "0.1.0",
+  "description": "Add x402 payment-gated routes, settlement receipts, and merchant accounting to Node.js services.",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": { ".": { "types": "./dist/index.d.ts", "import": "./dist/index.js" } },
+  "files": ["dist", "README.md"],
+  "keywords": ["x402", "payments", "usdc", "base", "merchant", "paywall", "api", "agents"],
+  "license": "MIT",
+  "repository": { "type": "git", "url": "https://github.com/seedhape/seedhape.git", "directory": "packages/merchant-sdk" },
+  "bugs": { "url": "https://github.com/seedhape/seedhape/issues" },
+  "publishConfig": { "access": "public" },
+  "dependencies": {}
+}