@fatstack/x402 0.0.1 → 0.1.0

package/dist/provider.d.ts

@@ -0,0 +1,99 @@
+import { RouteConfig, FacilitatorClient } from '@x402/core/server';
+export { FacilitatorClient, RouteConfig } from '@x402/core/server';
+import { z } from 'zod';
+
+declare const optionsSchema: z.ZodObject<{
+    /** Price per call in USD, as a decimal string: "0.002". */
+    price: z.ZodString;
+    /** The provider's own wallet. Under FEE_MODE=direct this is the sole payee. */
+    wallet: z.ZodString;
+    toolId: z.ZodString;
+    network: z.ZodDefault<z.ZodEnum<["base", "base-sepolia"]>>;
+    description: z.ZodOptional<z.ZodString>;
+    docsUrl: z.ZodDefault<z.ZodString>;
+    mimeType: z.ZodDefault<z.ZodString>;
+    maxTimeoutSeconds: z.ZodDefault<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    network: "base" | "base-sepolia";
+    price: string;
+    wallet: string;
+    toolId: string;
+    docsUrl: string;
+    mimeType: string;
+    maxTimeoutSeconds: number;
+    description?: string | undefined;
+}, {
+    price: string;
+    wallet: string;
+    toolId: string;
+    network?: "base" | "base-sepolia" | undefined;
+    description?: string | undefined;
+    docsUrl?: string | undefined;
+    mimeType?: string | undefined;
+    maxTimeoutSeconds?: number | undefined;
+}>;
+interface PaywallOptions extends z.input<typeof optionsSchema> {
+    /** Defaults to process.env. */
+    env?: Record<string, string | undefined>;
+    /** Injects a facilitator instead of building an HTTP one. Used by tests. */
+    facilitator?: FacilitatorClient;
+}
+/** The 402 body an agent reads before deciding to pay. */
+interface UnpaidBody {
+    error: 'payment_required';
+    tool: string;
+    price: {
+        usdc: string;
+        amountAtomic: string;
+        asset: string;
+        network: string;
+    };
+    payTo: string;
+    terms: {
+        refundable: false;
+        notice: string;
+    };
+    docs: string;
+    message: string;
+}
+/** Structurally compatible with Hono's `MiddlewareHandler`, without importing hono. */
+interface HonoContextLike {
+    json: (body: unknown, status?: number) => Response;
+    res: Response;
+    req: {
+        raw: Request;
+    };
+}
+type HonoMiddleware = (c: HonoContextLike, next: () => Promise<void>) => Promise<Response | void>;
+/** Structurally compatible with an Express request handler. */
+interface ExpressResponseLike {
+    status: (code: number) => {
+        json: (body: unknown) => void;
+    };
+    setHeader: (name: string, value: string | number | readonly string[]) => unknown;
+}
+type ExpressMiddleware = (req: unknown, res: ExpressResponseLike, next: (err?: unknown) => void) => Promise<void>;
+interface Paywall {
+    /** Hono middleware. Requires @x402/hono. */
+    hono(): HonoMiddleware;
+    /** Express middleware. Requires @x402/express. */
+    express(): ExpressMiddleware;
+    /** Wraps a Next.js route handler. Requires @x402/next (which needs Next >= 16.2.6). */
+    next<T>(handler: (request: never) => Promise<T>): (request: never) => Promise<T>;
+    /** The x402 route config, for advanced use with the official adapters directly. */
+    routeConfig: RouteConfig;
+    /** Resolved payee. Always the provider wallet while FEE_MODE=direct. */
+    payTo: string;
+}
+/**
+ * Paywalls a route with x402: USDC on Base, paid directly to the provider's wallet.
+ *
+ * Verification and settlement are delegated to the official x402 packages against the
+ * hosted facilitator — this module does not sign or verify anything itself.
+ *
+ * Throws immediately when FEE_MODE=splitter: there is no splitter contract in this build,
+ * and silently falling back to `direct` would pay the wrong party.
+ */
+declare function paywall(options: PaywallOptions): Paywall;
+
+export { type ExpressMiddleware, type ExpressResponseLike, type HonoContextLike, type HonoMiddleware, type Paywall, type PaywallOptions, type UnpaidBody, paywall };

package/dist/provider.js

@@ -0,0 +1,8 @@
+import {
+  paywall
+} from "./chunk-7DVR574O.js";
+import "./chunk-6LSPHKJ7.js";
+export {
+  paywall
+};
+//# sourceMappingURL=provider.js.map

package/dist/provider.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/testing.cjs

@@ -0,0 +1,73 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/testing.ts
+var testing_exports = {};
+__export(testing_exports, {
+  createMockFacilitator: () => createMockFacilitator
+});
+module.exports = __toCommonJS(testing_exports);
+function createMockFacilitator(options = {}) {
+  let verifyCalls = 0;
+  let settleCalls = 0;
+  return {
+    async verify() {
+      verifyCalls += 1;
+      return options.invalidReason ? { isValid: false, invalidReason: options.invalidReason } : { isValid: true, payer: options.payer ?? "0x2222222222222222222222222222222222222222" };
+    },
+    async settle() {
+      settleCalls += 1;
+      if (options.settleErrorReason) {
+        return {
+          success: false,
+          errorReason: options.settleErrorReason,
+          transaction: "",
+          network: "eip155:8453"
+        };
+      }
+      return {
+        success: true,
+        transaction: options.transaction ?? `0x${"ab".repeat(32)}`,
+        network: "eip155:8453",
+        payer: options.payer ?? "0x2222222222222222222222222222222222222222"
+      };
+    },
+    async getSupported() {
+      return {
+        kinds: [
+          { x402Version: 2, scheme: "exact", network: "eip155:8453" },
+          { x402Version: 2, scheme: "exact", network: "eip155:84532" }
+        ],
+        extensions: [],
+        signers: {}
+      };
+    },
+    get verifyCalls() {
+      return verifyCalls;
+    },
+    get settleCalls() {
+      return settleCalls;
+    }
+  };
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  createMockFacilitator
+});
+//# sourceMappingURL=testing.cjs.map

package/dist/testing.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/testing.ts"],"sourcesContent":["import type { FacilitatorClient } from '@x402/core/server';\n\nexport interface MockFacilitatorOptions {\n  /** Reject verification with this reason instead of accepting. */\n  invalidReason?: string;\n  /** Fail settlement with this reason after a successful verify. */\n  settleErrorReason?: string;\n  transaction?: string;\n  payer?: string;\n}\n\nexport interface MockFacilitator extends FacilitatorClient {\n  readonly verifyCalls: number;\n  readonly settleCalls: number;\n}\n\n/**\n * A facilitator stand-in for tests. Nothing here talks to a chain or a network: the\n * official packages own signing and verification, so what we exercise is our own\n * behaviour around their results.\n */\nexport function createMockFacilitator(options: MockFacilitatorOptions = {}): MockFacilitator {\n  let verifyCalls = 0;\n  let settleCalls = 0;\n\n  return {\n    async verify() {\n      verifyCalls += 1;\n      return options.invalidReason\n        ? { isValid: false, invalidReason: options.invalidReason }\n        : { isValid: true, payer: options.payer ?? '0x2222222222222222222222222222222222222222' };\n    },\n    async settle() {\n      settleCalls += 1;\n      if (options.settleErrorReason) {\n        return {\n          success: false,\n          errorReason: options.settleErrorReason,\n          transaction: '',\n          network: 'eip155:8453',\n        };\n      }\n      return {\n        success: true,\n        transaction: options.transaction ?? `0x${'ab'.repeat(32)}`,\n        network: 'eip155:8453',\n        payer: options.payer ?? '0x2222222222222222222222222222222222222222',\n      };\n    },\n    async getSupported() {\n      return {\n        kinds: [\n          { x402Version: 2, scheme: 'exact', network: 'eip155:8453' },\n          { x402Version: 2, scheme: 'exact', network: 'eip155:84532' },\n        ],\n        extensions: [],\n        signers: {},\n      };\n    },\n    get verifyCalls() {\n      return verifyCalls;\n    },\n    get settleCalls() {\n      return settleCalls;\n    },\n  };\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAqBO,SAAS,sBAAsB,UAAkC,CAAC,GAAoB;AAC3F,MAAI,cAAc;AAClB,MAAI,cAAc;AAElB,SAAO;AAAA,IACL,MAAM,SAAS;AACb,qBAAe;AACf,aAAO,QAAQ,gBACX,EAAE,SAAS,OAAO,eAAe,QAAQ,cAAc,IACvD,EAAE,SAAS,MAAM,OAAO,QAAQ,SAAS,6CAA6C;AAAA,IAC5F;AAAA,IACA,MAAM,SAAS;AACb,qBAAe;AACf,UAAI,QAAQ,mBAAmB;AAC7B,eAAO;AAAA,UACL,SAAS;AAAA,UACT,aAAa,QAAQ;AAAA,UACrB,aAAa;AAAA,UACb,SAAS;AAAA,QACX;AAAA,MACF;AACA,aAAO;AAAA,QACL,SAAS;AAAA,QACT,aAAa,QAAQ,eAAe,KAAK,KAAK,OAAO,EAAE,CAAC;AAAA,QACxD,SAAS;AAAA,QACT,OAAO,QAAQ,SAAS;AAAA,MAC1B;AAAA,IACF;AAAA,IACA,MAAM,eAAe;AACnB,aAAO;AAAA,QACL,OAAO;AAAA,UACL,EAAE,aAAa,GAAG,QAAQ,SAAS,SAAS,cAAc;AAAA,UAC1D,EAAE,aAAa,GAAG,QAAQ,SAAS,SAAS,eAAe;AAAA,QAC7D;AAAA,QACA,YAAY,CAAC;AAAA,QACb,SAAS,CAAC;AAAA,MACZ;AAAA,IACF;AAAA,IACA,IAAI,cAAc;AAChB,aAAO;AAAA,IACT;AAAA,IACA,IAAI,cAAc;AAChB,aAAO;AAAA,IACT;AAAA,EACF;AACF;","names":[]}

package/dist/testing.d.cts

@@ -0,0 +1,22 @@
+import { FacilitatorClient } from '@x402/core/server';
+
+interface MockFacilitatorOptions {
+    /** Reject verification with this reason instead of accepting. */
+    invalidReason?: string;
+    /** Fail settlement with this reason after a successful verify. */
+    settleErrorReason?: string;
+    transaction?: string;
+    payer?: string;
+}
+interface MockFacilitator extends FacilitatorClient {
+    readonly verifyCalls: number;
+    readonly settleCalls: number;
+}
+/**
+ * A facilitator stand-in for tests. Nothing here talks to a chain or a network: the
+ * official packages own signing and verification, so what we exercise is our own
+ * behaviour around their results.
+ */
+declare function createMockFacilitator(options?: MockFacilitatorOptions): MockFacilitator;
+
+export { type MockFacilitator, type MockFacilitatorOptions, createMockFacilitator };

package/dist/testing.d.ts

@@ -0,0 +1,22 @@
+import { FacilitatorClient } from '@x402/core/server';
+
+interface MockFacilitatorOptions {
+    /** Reject verification with this reason instead of accepting. */
+    invalidReason?: string;
+    /** Fail settlement with this reason after a successful verify. */
+    settleErrorReason?: string;
+    transaction?: string;
+    payer?: string;
+}
+interface MockFacilitator extends FacilitatorClient {
+    readonly verifyCalls: number;
+    readonly settleCalls: number;
+}
+/**
+ * A facilitator stand-in for tests. Nothing here talks to a chain or a network: the
+ * official packages own signing and verification, so what we exercise is our own
+ * behaviour around their results.
+ */
+declare function createMockFacilitator(options?: MockFacilitatorOptions): MockFacilitator;
+
+export { type MockFacilitator, type MockFacilitatorOptions, createMockFacilitator };

package/dist/testing.js

@@ -0,0 +1,48 @@
+// src/testing.ts
+function createMockFacilitator(options = {}) {
+  let verifyCalls = 0;
+  let settleCalls = 0;
+  return {
+    async verify() {
+      verifyCalls += 1;
+      return options.invalidReason ? { isValid: false, invalidReason: options.invalidReason } : { isValid: true, payer: options.payer ?? "0x2222222222222222222222222222222222222222" };
+    },
+    async settle() {
+      settleCalls += 1;
+      if (options.settleErrorReason) {
+        return {
+          success: false,
+          errorReason: options.settleErrorReason,
+          transaction: "",
+          network: "eip155:8453"
+        };
+      }
+      return {
+        success: true,
+        transaction: options.transaction ?? `0x${"ab".repeat(32)}`,
+        network: "eip155:8453",
+        payer: options.payer ?? "0x2222222222222222222222222222222222222222"
+      };
+    },
+    async getSupported() {
+      return {
+        kinds: [
+          { x402Version: 2, scheme: "exact", network: "eip155:8453" },
+          { x402Version: 2, scheme: "exact", network: "eip155:84532" }
+        ],
+        extensions: [],
+        signers: {}
+      };
+    },
+    get verifyCalls() {
+      return verifyCalls;
+    },
+    get settleCalls() {
+      return settleCalls;
+    }
+  };
+}
+export {
+  createMockFacilitator
+};
+//# sourceMappingURL=testing.js.map

package/dist/testing.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/testing.ts"],"sourcesContent":["import type { FacilitatorClient } from '@x402/core/server';\n\nexport interface MockFacilitatorOptions {\n  /** Reject verification with this reason instead of accepting. */\n  invalidReason?: string;\n  /** Fail settlement with this reason after a successful verify. */\n  settleErrorReason?: string;\n  transaction?: string;\n  payer?: string;\n}\n\nexport interface MockFacilitator extends FacilitatorClient {\n  readonly verifyCalls: number;\n  readonly settleCalls: number;\n}\n\n/**\n * A facilitator stand-in for tests. Nothing here talks to a chain or a network: the\n * official packages own signing and verification, so what we exercise is our own\n * behaviour around their results.\n */\nexport function createMockFacilitator(options: MockFacilitatorOptions = {}): MockFacilitator {\n  let verifyCalls = 0;\n  let settleCalls = 0;\n\n  return {\n    async verify() {\n      verifyCalls += 1;\n      return options.invalidReason\n        ? { isValid: false, invalidReason: options.invalidReason }\n        : { isValid: true, payer: options.payer ?? '0x2222222222222222222222222222222222222222' };\n    },\n    async settle() {\n      settleCalls += 1;\n      if (options.settleErrorReason) {\n        return {\n          success: false,\n          errorReason: options.settleErrorReason,\n          transaction: '',\n          network: 'eip155:8453',\n        };\n      }\n      return {\n        success: true,\n        transaction: options.transaction ?? `0x${'ab'.repeat(32)}`,\n        network: 'eip155:8453',\n        payer: options.payer ?? '0x2222222222222222222222222222222222222222',\n      };\n    },\n    async getSupported() {\n      return {\n        kinds: [\n          { x402Version: 2, scheme: 'exact', network: 'eip155:8453' },\n          { x402Version: 2, scheme: 'exact', network: 'eip155:84532' },\n        ],\n        extensions: [],\n        signers: {},\n      };\n    },\n    get verifyCalls() {\n      return verifyCalls;\n    },\n    get settleCalls() {\n      return settleCalls;\n    },\n  };\n}\n"],"mappings":";AAqBO,SAAS,sBAAsB,UAAkC,CAAC,GAAoB;AAC3F,MAAI,cAAc;AAClB,MAAI,cAAc;AAElB,SAAO;AAAA,IACL,MAAM,SAAS;AACb,qBAAe;AACf,aAAO,QAAQ,gBACX,EAAE,SAAS,OAAO,eAAe,QAAQ,cAAc,IACvD,EAAE,SAAS,MAAM,OAAO,QAAQ,SAAS,6CAA6C;AAAA,IAC5F;AAAA,IACA,MAAM,SAAS;AACb,qBAAe;AACf,UAAI,QAAQ,mBAAmB;AAC7B,eAAO;AAAA,UACL,SAAS;AAAA,UACT,aAAa,QAAQ;AAAA,UACrB,aAAa;AAAA,UACb,SAAS;AAAA,QACX;AAAA,MACF;AACA,aAAO;AAAA,QACL,SAAS;AAAA,QACT,aAAa,QAAQ,eAAe,KAAK,KAAK,OAAO,EAAE,CAAC;AAAA,QACxD,SAAS;AAAA,QACT,OAAO,QAAQ,SAAS;AAAA,MAC1B;AAAA,IACF;AAAA,IACA,MAAM,eAAe;AACnB,aAAO;AAAA,QACL,OAAO;AAAA,UACL,EAAE,aAAa,GAAG,QAAQ,SAAS,SAAS,cAAc;AAAA,UAC1D,EAAE,aAAa,GAAG,QAAQ,SAAS,SAAS,eAAe;AAAA,QAC7D;AAAA,QACA,YAAY,CAAC;AAAA,QACb,SAAS,CAAC;AAAA,MACZ;AAAA,IACF;AAAA,IACA,IAAI,cAAc;AAChB,aAAO;AAAA,IACT;AAAA,IACA,IAAI,cAAc;AAChB,aAAO;AAAA,IACT;AAAA,EACF;AACF;","names":[]}

package/package.json

@@ -1,9 +1,89 @@
 {
   "name": "@fatstack/x402",
-  "version": "0.0.1",
-  "description": "Reserved for Fatstack — x402 provider middleware and paying agent client for USDC on Base. Launching soon.",
+  "version": "0.1.0",
+  "description": "x402 paywall middleware and a spend-guarded paying fetch for AI agents. USDC on Base.",
   "license": "UNLICENSED",
   "homepage": "https://fatstack.net",
-  "keywords": ["x402", "usdc", "base", "mcp", "ai-agents"],
-  "files": ["README.md"]
+  "keywords": [
+    "x402",
+    "usdc",
+    "base",
+    "mcp",
+    "ai-agents",
+    "micropayments"
+  ],
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs"
+    },
+    "./provider": {
+      "types": "./dist/provider.d.ts",
+      "import": "./dist/provider.js",
+      "require": "./dist/provider.cjs"
+    },
+    "./client": {
+      "types": "./dist/client.d.ts",
+      "import": "./dist/client.js",
+      "require": "./dist/client.cjs"
+    },
+    "./testing": {
+      "types": "./dist/testing.d.ts",
+      "import": "./dist/testing.js",
+      "require": "./dist/testing.cjs"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "sideEffects": false,
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "test": "vitest run",
+    "typecheck": "tsc -p tsconfig.json",
+    "lint": "eslint src --config ../eslint.config.mjs"
+  },
+  "dependencies": {
+    "@x402/core": "^2.24.0",
+    "@x402/evm": "^2.24.0",
+    "@x402/fetch": "^2.24.0",
+    "zod": "^3.24.1"
+  },
+  "peerDependencies": {
+    "@x402/express": "^2.24.0",
+    "@x402/hono": "^2.24.0",
+    "@x402/next": "^2.24.0"
+  },
+  "peerDependenciesMeta": {
+    "@x402/hono": {
+      "optional": true
+    },
+    "@x402/express": {
+      "optional": true
+    },
+    "@x402/next": {
+      "optional": true
+    }
+  },
+  "devDependencies": {
+    "@types/express": "^5.0.0",
+    "@types/node": "^22.10.2",
+    "@x402/express": "^2.24.0",
+    "@x402/hono": "^2.24.0",
+    "@x402/next": "^2.24.0",
+    "express": "^4.21.2",
+    "hono": "^4.6.14",
+    "next": "^16.2.6",
+    "react": "^19.0.0",
+    "tsup": "^8.3.5",
+    "typescript": "^5.7.2",
+    "viem": "^2.21.55",
+    "vitest": "^2.1.8"
+  }
 }