@agirails/sdk 3.1.0 → 3.3.0

package/dist/server/buildX402Server.d.ts

@@ -0,0 +1,131 @@
+/**
+ * buildX402Server — factory that maps AGIRAILS agent config into
+ * a ready-to-use x402 v2 resource server + route definitions.
+ *
+ * Design: we never wrap or re-export framework middleware. The output
+ * plugs directly into @x402/express, @x402/hono, @x402/next, or raw
+ * @x402/core processHTTPRequest for any framework.
+ *
+ * @module server/buildX402Server
+ */
+/// <reference path="../../src/types/x402-modules.d.ts" />
+import { x402ResourceServer } from '@x402/core/server';
+import { x402HTTPResourceServer, type RoutesConfig } from '@x402/core/http';
+/**
+ * A single paid route definition.
+ */
+export interface X402RouteDefinition {
+    /** HTTP method + path pattern, e.g. "GET /api/premium" or "POST /api/generate" */
+    route: string;
+    /** Price in human-readable USD, e.g. "$0.10" or "0.50" */
+    price: string;
+    /** Short description shown in the payment prompt */
+    description?: string;
+    /**
+     * Override CAIP-2 network for this specific route.
+     * Default: top-level `config.network`.
+     */
+    network?: string;
+    /**
+     * Override payTo address for this specific route.
+     * Default: top-level `config.payTo`.
+     */
+    payTo?: string;
+    /** Max authorization validity in seconds. Default: 300 (5 min). */
+    maxTimeoutSeconds?: number;
+}
+/**
+ * Configuration for buildX402Server.
+ */
+export interface X402ServerConfig {
+    /**
+     * Address that receives payments. Typically the agent's wallet address
+     * from `client.getAddress()`.
+     */
+    payTo: string;
+    /**
+     * CAIP-2 network identifier, e.g. "eip155:8453" (Base) or "eip155:84532" (Base Sepolia).
+     * Applied to all routes unless overridden per-route.
+     */
+    network: string;
+    /** Paid route definitions. */
+    routes: X402RouteDefinition[];
+    /**
+     * Facilitator URL. Default: "https://x402.org/facilitator" (Coinbase public).
+     * Override for self-hosted or third-party facilitators.
+     */
+    facilitatorUrl?: string;
+    /**
+     * Advertise Permit2 support so Smart Wallet buyers work out of the box.
+     * Default: true.
+     */
+    preferPermit2?: boolean;
+}
+/**
+ * Result from buildX402Server.
+ */
+export interface X402ServerResult {
+    /**
+     * HTTP resource server instance. Pass this as the second argument to
+     * upstream middleware: `paymentMiddleware(routes, httpServer)`.
+     *
+     * For frameworks without a dedicated @x402 adapter, use
+     * `httpServer.processHTTPRequest(context)` directly.
+     */
+    httpServer: x402HTTPResourceServer;
+    /**
+     * Route config object matching the shape expected by @x402/express,
+     * @x402/hono, and @x402/next middleware.
+     */
+    routes: RoutesConfig;
+    /** The underlying x402ResourceServer (for advanced hook registration). */
+    resourceServer: x402ResourceServer;
+}
+/**
+ * Build a configured x402 v2 resource server from simple route definitions.
+ *
+ * Async because it calls `httpServer.initialize()` which fetches facilitator
+ * capabilities and validates that all route schemes are supported.
+ *
+ * @param config - Server configuration
+ * @returns Ready-to-use server + routes
+ * @throws {Error} If facilitator is unreachable or route schemes unsupported
+ *
+ * @example
+ * ```typescript
+ * // Express
+ * import { buildX402Server } from '@agirails/sdk/server';
+ * import { paymentMiddleware } from '@x402/express';
+ * import express from 'express';
+ *
+ * const { httpServer, routes } = await buildX402Server({
+ *   payTo: client.getAddress(),
+ *   network: 'eip155:84532',
+ *   routes: [{ route: 'GET /api/data', price: '$0.01' }],
+ * });
+ *
+ * const app = express();
+ * app.use(paymentMiddleware(routes, httpServer));
+ * app.get('/api/data', (req, res) => res.json({ data: 42 }));
+ * app.listen(3000);
+ * ```
+ *
+ * @example
+ * ```typescript
+ * // Hono
+ * import { buildX402Server } from '@agirails/sdk/server';
+ * import { paymentMiddleware } from '@x402/hono';
+ * import { Hono } from 'hono';
+ *
+ * const { httpServer, routes } = await buildX402Server({
+ *   payTo: '0xYourAddress',
+ *   network: 'eip155:8453',
+ *   routes: [{ route: 'GET /api/premium', price: '$0.10' }],
+ * });
+ *
+ * const app = new Hono();
+ * app.use('*', paymentMiddleware(routes, httpServer));
+ * ```
+ */
+export declare function buildX402Server(config: X402ServerConfig): Promise<X402ServerResult>;
+//# sourceMappingURL=buildX402Server.d.ts.map

package/dist/server/buildX402Server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"buildX402Server.d.ts","sourceRoot":"","sources":["../../src/server/buildX402Server.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;;AAEH,OAAO,EAAE,kBAAkB,EAAyB,MAAM,mBAAmB,CAAC;AAC9E,OAAO,EAAE,sBAAsB,EAAE,KAAK,YAAY,EAAsB,MAAM,iBAAiB,CAAC;AAOhG;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,kFAAkF;IAClF,KAAK,EAAE,MAAM,CAAC;IAEd,0DAA0D;IAC1D,KAAK,EAAE,MAAM,CAAC;IAEd,oDAAoD;IACpD,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB;;;OAGG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB;;;OAGG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf,mEAAmE;IACnE,iBAAiB,CAAC,EAAE,MAAM,CAAC;CAC5B;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B;;;OAGG;IACH,KAAK,EAAE,MAAM,CAAC;IAEd;;;OAGG;IACH,OAAO,EAAE,MAAM,CAAC;IAEhB,8BAA8B;IAC9B,MAAM,EAAE,mBAAmB,EAAE,CAAC;IAE9B;;;OAGG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC;IAExB;;;OAGG;IACH,aAAa,CAAC,EAAE,OAAO,CAAC;CACzB;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B;;;;;;OAMG;IACH,UAAU,EAAE,sBAAsB,CAAC;IAEnC;;;OAGG;IACH,MAAM,EAAE,YAAY,CAAC;IAErB,0EAA0E;IAC1E,cAAc,EAAE,kBAAkB,CAAC;CACpC;AAMD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6CG;AACH,wBAAsB,eAAe,CACnC,MAAM,EAAE,gBAAgB,GACvB,OAAO,CAAC,gBAAgB,CAAC,CAyH3B"}

package/dist/server/buildX402Server.js

@@ -0,0 +1,151 @@
+"use strict";
+/**
+ * buildX402Server — factory that maps AGIRAILS agent config into
+ * a ready-to-use x402 v2 resource server + route definitions.
+ *
+ * Design: we never wrap or re-export framework middleware. The output
+ * plugs directly into @x402/express, @x402/hono, @x402/next, or raw
+ * @x402/core processHTTPRequest for any framework.
+ *
+ * @module server/buildX402Server
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.buildX402Server = void 0;
+const server_1 = require("@x402/core/server");
+const http_1 = require("@x402/core/http");
+const server_2 = require("@x402/evm/exact/server");
+// ============================================================================
+// Factory
+// ============================================================================
+/**
+ * Build a configured x402 v2 resource server from simple route definitions.
+ *
+ * Async because it calls `httpServer.initialize()` which fetches facilitator
+ * capabilities and validates that all route schemes are supported.
+ *
+ * @param config - Server configuration
+ * @returns Ready-to-use server + routes
+ * @throws {Error} If facilitator is unreachable or route schemes unsupported
+ *
+ * @example
+ * ```typescript
+ * // Express
+ * import { buildX402Server } from '@agirails/sdk/server';
+ * import { paymentMiddleware } from '@x402/express';
+ * import express from 'express';
+ *
+ * const { httpServer, routes } = await buildX402Server({
+ *   payTo: client.getAddress(),
+ *   network: 'eip155:84532',
+ *   routes: [{ route: 'GET /api/data', price: '$0.01' }],
+ * });
+ *
+ * const app = express();
+ * app.use(paymentMiddleware(routes, httpServer));
+ * app.get('/api/data', (req, res) => res.json({ data: 42 }));
+ * app.listen(3000);
+ * ```
+ *
+ * @example
+ * ```typescript
+ * // Hono
+ * import { buildX402Server } from '@agirails/sdk/server';
+ * import { paymentMiddleware } from '@x402/hono';
+ * import { Hono } from 'hono';
+ *
+ * const { httpServer, routes } = await buildX402Server({
+ *   payTo: '0xYourAddress',
+ *   network: 'eip155:8453',
+ *   routes: [{ route: 'GET /api/premium', price: '$0.10' }],
+ * });
+ *
+ * const app = new Hono();
+ * app.use('*', paymentMiddleware(routes, httpServer));
+ * ```
+ */
+async function buildX402Server(config) {
+    if (!config.payTo || !/^0x[0-9a-f]{40}$/i.test(config.payTo)) {
+        throw new Error(`buildX402Server: payTo must be a valid Ethereum address, got "${config.payTo}"`);
+    }
+    if (!config.network || !config.network.includes(':')) {
+        throw new Error(`buildX402Server: network must be a CAIP-2 identifier (e.g. "eip155:8453"), got "${config.network}"`);
+    }
+    if (!config.routes || config.routes.length === 0) {
+        throw new Error('buildX402Server: at least one route is required');
+    }
+    // 1. Facilitator client
+    const facilitator = new server_1.HTTPFacilitatorClient({
+        url: config.facilitatorUrl ?? 'https://x402.org/facilitator',
+    });
+    // 2. Resource server with EVM exact scheme
+    const resourceServer = new server_1.x402ResourceServer(facilitator);
+    (0, server_2.registerExactEvmScheme)(resourceServer);
+    // 3. Build route config
+    const routesConfig = {};
+    const seen = new Set();
+    for (const def of config.routes) {
+        if (!def.route || !/^(GET|POST|PUT|PATCH|DELETE|HEAD|OPTIONS)\s+\/\S*$/.test(def.route)) {
+            throw new Error(`buildX402Server: route must be "METHOD /path" format (e.g. "GET /api/data"), got "${def.route}"`);
+        }
+        if (seen.has(def.route)) {
+            throw new Error(`buildX402Server: duplicate route "${def.route}". Each route must be unique.`);
+        }
+        seen.add(def.route);
+        const routePayTo = def.payTo ?? config.payTo;
+        if (!/^0x[0-9a-f]{40}$/i.test(routePayTo)) {
+            throw new Error(`buildX402Server: route "${def.route}" has invalid payTo "${routePayTo}"`);
+        }
+        const routeNetwork = def.network ?? config.network;
+        if (!routeNetwork.includes(':')) {
+            throw new Error(`buildX402Server: route "${def.route}" has invalid network "${routeNetwork}" (must be CAIP-2)`);
+        }
+        if (!def.price || (typeof def.price === 'string' && def.price.trim() === '')) {
+            throw new Error(`buildX402Server: route "${def.route}" has empty or missing price`);
+        }
+        if (typeof def.price === 'string') {
+            const trimmed = def.price.trim();
+            if (!/^\$?\d+(\.\d+)?$/.test(trimmed)) {
+                throw new Error(`buildX402Server: route "${def.route}" has invalid price "${def.price}" (expected format: "$0.10" or "0.50")`);
+            }
+            if (parseFloat(trimmed.replace('$', '')) <= 0) {
+                throw new Error(`buildX402Server: route "${def.route}" price must be > 0, got "${def.price}"`);
+            }
+        }
+        const timeout = def.maxTimeoutSeconds ?? 300;
+        if (!Number.isFinite(timeout) || timeout <= 0) {
+            throw new Error(`buildX402Server: route "${def.route}" has invalid maxTimeoutSeconds ${def.maxTimeoutSeconds} (must be > 0)`);
+        }
+        const paymentOption = {
+            scheme: 'exact',
+            network: routeNetwork,
+            payTo: routePayTo,
+            price: def.price,
+            maxTimeoutSeconds: timeout,
+        };
+        // Advertise Permit2 so Smart Wallet buyers work out of the box
+        if (config.preferPermit2 !== false) {
+            paymentOption.extra = { assetTransferMethod: 'permit2' };
+        }
+        routesConfig[def.route] = {
+            accepts: [paymentOption],
+            description: def.description,
+        };
+    }
+    // 4. HTTP resource server
+    const httpServer = new http_1.x402HTTPResourceServer(resourceServer, routesConfig);
+    // 5. Initialize (fetches facilitator capabilities, validates routes)
+    try {
+        await httpServer.initialize();
+    }
+    catch (err) {
+        const msg = err instanceof Error ? err.message : String(err);
+        throw new Error(`buildX402Server: failed to initialize — ${msg}`);
+    }
+    return {
+        httpServer,
+        routes: routesConfig,
+        resourceServer,
+    };
+}
+exports.buildX402Server = buildX402Server;
+//# sourceMappingURL=buildX402Server.js.map

package/dist/server/buildX402Server.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"buildX402Server.js","sourceRoot":"","sources":["../../src/server/buildX402Server.ts"],"names":[],"mappings":";AAAA;;;;;;;;;GASG;;;AAEH,8CAA8E;AAC9E,0CAAgG;AAChG,mDAAgE;AA0FhE,+EAA+E;AAC/E,UAAU;AACV,+EAA+E;AAE/E;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6CG;AACI,KAAK,UAAU,eAAe,CACnC,MAAwB;IAExB,IAAI,CAAC,MAAM,CAAC,KAAK,IAAI,CAAC,mBAAmB,CAAC,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC;QAC7D,MAAM,IAAI,KAAK,CACb,iEAAiE,MAAM,CAAC,KAAK,GAAG,CACjF,CAAC;IACJ,CAAC;IACD,IAAI,CAAC,MAAM,CAAC,OAAO,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;QACrD,MAAM,IAAI,KAAK,CACb,mFAAmF,MAAM,CAAC,OAAO,GAAG,CACrG,CAAC;IACJ,CAAC;IACD,IAAI,CAAC,MAAM,CAAC,MAAM,IAAI,MAAM,CAAC,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACjD,MAAM,IAAI,KAAK,CAAC,iDAAiD,CAAC,CAAC;IACrE,CAAC;IAED,wBAAwB;IACxB,MAAM,WAAW,GAAG,IAAI,8BAAqB,CAAC;QAC5C,GAAG,EAAE,MAAM,CAAC,cAAc,IAAI,8BAA8B;KAC7D,CAAC,CAAC;IAEH,2CAA2C;IAC3C,MAAM,cAAc,GAAG,IAAI,2BAAkB,CAAC,WAAW,CAAC,CAAC;IAC3D,IAAA,+BAAsB,EAAC,cAAc,CAAC,CAAC;IAEvC,wBAAwB;IACxB,MAAM,YAAY,GAAuE,EAAE,CAAC;IAE5F,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAC;IAE/B,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,MAAM,EAAE,CAAC;QAChC,IAAI,CAAC,GAAG,CAAC,KAAK,IAAI,CAAC,oDAAoD,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC;YACxF,MAAM,IAAI,KAAK,CACb,qFAAqF,GAAG,CAAC,KAAK,GAAG,CAClG,CAAC;QACJ,CAAC;QAED,IAAI,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC;YACxB,MAAM,IAAI,KAAK,CACb,qCAAqC,GAAG,CAAC,KAAK,+BAA+B,CAC9E,CAAC;QACJ,CAAC;QACD,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;QAEpB,MAAM,UAAU,GAAG,GAAG,CAAC,KAAK,IAAI,MAAM,CAAC,KAAK,CAAC;QAC7C,IAAI,CAAC,mBAAmB,CAAC,IAAI,CAAC,UAAU,CAAC,EAAE,CAAC;YAC1C,MAAM,IAAI,KAAK,CACb,2BAA2B,GAAG,CAAC,KAAK,wBAAwB,UAAU,GAAG,CAC1E,CAAC;QACJ,CAAC;QAED,MAAM,YAAY,GAAG,GAAG,CAAC,OAAO,IAAI,MAAM,CAAC,OAAO,CAAC;QACnD,IAAI,CAAC,YAAY,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;YAChC,MAAM,IAAI,KAAK,CACb,2BAA2B,GAAG,CAAC,KAAK,0BAA0B,YAAY,oBAAoB,CAC/F,CAAC;QACJ,CAAC;QAED,IAAI,CAAC,GAAG,CAAC,KAAK,IAAI,CAAC,OAAO,GAAG,CAAC,KAAK,KAAK,QAAQ,IAAI,GAAG,CAAC,KAAK,CAAC,IAAI,EAAE,KAAK,EAAE,CAAC,EAAE,CAAC;YAC7E,MAAM,IAAI,KAAK,CACb,2BAA2B,GAAG,CAAC,KAAK,8BAA8B,CACnE,CAAC;QACJ,CAAC;QACD,IAAI,OAAO,GAAG,CAAC,KAAK,KAAK,QAAQ,EAAE,CAAC;YAClC,MAAM,OAAO,GAAG,GAAG,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC;YACjC,IAAI,CAAC,kBAAkB,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC;gBACtC,MAAM,IAAI,KAAK,CACb,2BAA2B,GAAG,CAAC,KAAK,wBAAwB,GAAG,CAAC,KAAK,wCAAwC,CAC9G,CAAC;YACJ,CAAC;YACD,IAAI,UAAU,CAAC,OAAO,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC;gBAC9C,MAAM,IAAI,KAAK,CACb,2BAA2B,GAAG,CAAC,KAAK,6BAA6B,GAAG,CAAC,KAAK,GAAG,CAC9E,CAAC;YACJ,CAAC;QACH,CAAC;QAED,MAAM,OAAO,GAAG,GAAG,CAAC,iBAAiB,IAAI,GAAG,CAAC;QAC7C,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,IAAI,OAAO,IAAI,CAAC,EAAE,CAAC;YAC9C,MAAM,IAAI,KAAK,CACb,2BAA2B,GAAG,CAAC,KAAK,mCAAmC,GAAG,CAAC,iBAAiB,gBAAgB,CAC7G,CAAC;QACJ,CAAC;QAED,MAAM,aAAa,GAAkB;YACnC,MAAM,EAAE,OAAO;YACf,OAAO,EAAE,YAAY;YACrB,KAAK,EAAE,UAAU;YACjB,KAAK,EAAE,GAAG,CAAC,KAAK;YAChB,iBAAiB,EAAE,OAAO;SAC3B,CAAC;QAEF,+DAA+D;QAC/D,IAAI,MAAM,CAAC,aAAa,KAAK,KAAK,EAAE,CAAC;YACnC,aAAa,CAAC,KAAK,GAAG,EAAE,mBAAmB,EAAE,SAAS,EAAE,CAAC;QAC3D,CAAC;QAED,YAAY,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG;YACxB,OAAO,EAAE,CAAC,aAAa,CAAC;YACxB,WAAW,EAAE,GAAG,CAAC,WAAW;SAC7B,CAAC;IACJ,CAAC;IAED,0BAA0B;IAC1B,MAAM,UAAU,GAAG,IAAI,6BAAsB,CAC3C,cAAc,EACd,YAA4B,CAC7B,CAAC;IAEF,qEAAqE;IACrE,IAAI,CAAC;QACH,MAAM,UAAU,CAAC,UAAU,EAAE,CAAC;IAChC,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,MAAM,GAAG,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QAC7D,MAAM,IAAI,KAAK,CAAC,2CAA2C,GAAG,EAAE,CAAC,CAAC;IACpE,CAAC;IAED,OAAO;QACL,UAAU;QACV,MAAM,EAAE,YAA4B;QACpC,cAAc;KACf,CAAC;AACJ,CAAC;AA3HD,0CA2HC"}

package/dist/server/index.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Server Module — x402 v2 seller-side helpers.
+ *
+ * Framework-agnostic: builds a configured `x402HTTPResourceServer` + routes
+ * object that plugs directly into upstream middleware (`@x402/express`,
+ * `@x402/hono`, `@x402/next`) or any framework via the raw processHTTPRequest
+ * API from `@x402/core`.
+ *
+ * @module server
+ *
+ * @example
+ * ```typescript
+ * import { buildX402Server } from '@agirails/sdk/server';
+ * import { paymentMiddleware } from '@x402/express';
+ * import express from 'express';
+ *
+ * const { httpServer, routes } = await buildX402Server({
+ *   payTo: '0xYourAddress',
+ *   network: 'eip155:84532',
+ *   routes: [
+ *     { route: 'GET /api/premium', price: '$0.10', description: 'Premium content' },
+ *   ],
+ * });
+ *
+ * const app = express();
+ * app.use(paymentMiddleware(routes, httpServer));
+ * app.get('/api/premium', (req, res) => res.json({ secret: '...' }));
+ * app.listen(3000);
+ * ```
+ */
+export { buildX402Server } from './buildX402Server';
+export type { X402ServerConfig, X402RouteDefinition, X402ServerResult, } from './buildX402Server';
+//# sourceMappingURL=index.d.ts.map

package/dist/server/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/server/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AAEH,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACpD,YAAY,EACV,gBAAgB,EAChB,mBAAmB,EACnB,gBAAgB,GACjB,MAAM,mBAAmB,CAAC"}

package/dist/server/index.js

@@ -0,0 +1,36 @@
+"use strict";
+/**
+ * Server Module — x402 v2 seller-side helpers.
+ *
+ * Framework-agnostic: builds a configured `x402HTTPResourceServer` + routes
+ * object that plugs directly into upstream middleware (`@x402/express`,
+ * `@x402/hono`, `@x402/next`) or any framework via the raw processHTTPRequest
+ * API from `@x402/core`.
+ *
+ * @module server
+ *
+ * @example
+ * ```typescript
+ * import { buildX402Server } from '@agirails/sdk/server';
+ * import { paymentMiddleware } from '@x402/express';
+ * import express from 'express';
+ *
+ * const { httpServer, routes } = await buildX402Server({
+ *   payTo: '0xYourAddress',
+ *   network: 'eip155:84532',
+ *   routes: [
+ *     { route: 'GET /api/premium', price: '$0.10', description: 'Premium content' },
+ *   ],
+ * });
+ *
+ * const app = express();
+ * app.use(paymentMiddleware(routes, httpServer));
+ * app.get('/api/premium', (req, res) => res.json({ secret: '...' }));
+ * app.listen(3000);
+ * ```
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.buildX402Server = void 0;
+var buildX402Server_1 = require("./buildX402Server");
+Object.defineProperty(exports, "buildX402Server", { enumerable: true, get: function () { return buildX402Server_1.buildX402Server; } });
+//# sourceMappingURL=index.js.map

package/dist/server/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/server/index.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;;;AAEH,qDAAoD;AAA3C,kHAAA,eAAe,OAAA"}

package/dist/types/adapter.d.ts

@@ -151,8 +151,15 @@ export declare const PaymentMetadataSchema: z.ZodObject<{
 export interface UnifiedPayParams {
     /** Recipient - address, HTTP endpoint, or ERC-8004 agent ID */
     to: string;
-    /** Amount in human-readable format */
-    amount: string | number;
+    /**
+     * Amount in human-readable format.
+     *
+     * - REQUIRED for ACTP adapters (basic, standard) — client sets the price
+     * - OPTIONAL for x402 URL targets — amount comes from the server's
+     *   payment-required response; this field is ignored. The x402 adapter
+     *   enforces its own per-tx safety cap via `X402AdapterConfig.maxAmountPerTx`.
+     */
+    amount?: string | number;
     /** Deadline (relative like '+24h' or unix timestamp) */
     deadline?: string | number;
     /** Dispute window in seconds (min 3600, max 30 days) */
@@ -167,13 +174,22 @@ export interface UnifiedPayParams {
      * Used for reputation reporting after settlement.
      */
     erc8004AgentId?: string;
+    /**
+     * HTTP method for x402 paid requests. Ignored by ACTP adapters.
+     * Default: 'GET'.
+     */
+    httpMethod?: 'GET' | 'POST' | 'PUT' | 'PATCH' | 'DELETE';
+    /** HTTP body for x402 paid requests (POST/PUT/PATCH). Ignored by ACTP adapters. */
+    httpBody?: string | Uint8Array;
+    /** Extra HTTP headers for x402 paid requests. Ignored by ACTP adapters. */
+    httpHeaders?: Record<string, string>;
 }
 /**
  * Zod schema for UnifiedPayParams with strict validation.
  */
 export declare const UnifiedPayParamsSchema: z.ZodObject<{
     to: z.ZodString;
-    amount: z.ZodUnion<[z.ZodString, z.ZodNumber]>;
+    amount: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodNumber]>>;
     deadline: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodNumber]>>;
     disputeWindow: z.ZodOptional<z.ZodNumber>;
     description: z.ZodOptional<z.ZodString>;
@@ -212,9 +228,12 @@ export declare const UnifiedPayParamsSchema: z.ZodObject<{
         paymentMethod?: "x402" | "actp" | "auto" | undefined;
     }>>;
     erc8004AgentId: z.ZodOptional<z.ZodString>;
+    httpMethod: z.ZodOptional<z.ZodEnum<["GET", "POST", "PUT", "PATCH", "DELETE"]>>;
+    httpBody: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodType<Uint8Array, z.ZodTypeDef, Uint8Array>]>>;
+    httpHeaders: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
 }, "strip", z.ZodTypeAny, {
-    amount: string | number;
     to: string;
+    amount?: string | number | undefined;
     deadline?: string | number | undefined;
     disputeWindow?: number | undefined;
     description?: string | undefined;
@@ -229,9 +248,12 @@ export declare const UnifiedPayParamsSchema: z.ZodObject<{
         paymentMethod?: "x402" | "actp" | "auto" | undefined;
     } | undefined;
     erc8004AgentId?: string | undefined;
+    httpMethod?: "GET" | "POST" | "PUT" | "PATCH" | "DELETE" | undefined;
+    httpBody?: string | Uint8Array | undefined;
+    httpHeaders?: Record<string, string> | undefined;
 }, {
-    amount: string | number;
     to: string;
+    amount?: string | number | undefined;
     deadline?: string | number | undefined;
     disputeWindow?: number | undefined;
     description?: string | undefined;
@@ -246,6 +268,9 @@ export declare const UnifiedPayParamsSchema: z.ZodObject<{
         paymentMethod?: "x402" | "actp" | "auto" | undefined;
     } | undefined;
     erc8004AgentId?: string | undefined;
+    httpMethod?: "GET" | "POST" | "PUT" | "PATCH" | "DELETE" | undefined;
+    httpBody?: string | Uint8Array | undefined;
+    httpHeaders?: Record<string, string> | undefined;
 }>;
 /**
  * Transaction state after payment initiation.
@@ -257,11 +282,13 @@ export type InitialTransactionState = 'COMMITTED' | 'IN_PROGRESS';
 /**
  * Unified payment result returned by all adapters.
  *
- * NOTE: success=true means payment INITIATED, not settled.
- * Caller must call releaseEscrow() after delivery verification.
+ * For escrow adapters (basic/standard), success=true means payment initiated
+ * and caller must later call releaseEscrow() after delivery verification.
+ * For atomic adapters (x402), success=true means settlement is final and
+ * releaseRequired=false.
  */
 export interface UnifiedPayResult {
-    /** ACTP transaction ID */
+    /** Transaction identifier (ACTP txId or x402 settlement transaction hash) */
     txId: string;
     /** Escrow ID (for release) - null for non-escrow adapters */
     escrowId: string | null;
@@ -296,8 +323,11 @@ export interface UnifiedPayResult {
      */
     erc8004AgentId?: string;
     /**
-     * Fee breakdown for x402 payments routed through X402Relay.
-     * Present only when relay is configured and payment used the relay path.
+     * @deprecated Legacy from the pre-v2 x402 flow routed through the
+     * on-chain X402Relay fee-splitting contract. The current X402Adapter
+     * (SDK 3.3.0+) pays seller directly with zero AGIRAILS fee, so this
+     * field is never populated on the x402 path. Retained for API
+     * back-compat; removal scheduled for the next breaking SDK major.
      */
     feeBreakdown?: X402FeeBreakdown;
 }
@@ -348,9 +378,9 @@ export declare const UnifiedPayResultSchema: z.ZodObject<{
     state: "COMMITTED" | "IN_PROGRESS";
     success: boolean;
     releaseRequired: boolean;
+    erc8004AgentId?: string | undefined;
     response?: any;
     error?: string | undefined;
-    erc8004AgentId?: string | undefined;
     feeBreakdown?: {
         grossAmount: string;
         providerNet: string;
@@ -369,9 +399,9 @@ export declare const UnifiedPayResultSchema: z.ZodObject<{
     state: "COMMITTED" | "IN_PROGRESS";
     success: boolean;
     releaseRequired: boolean;
+    erc8004AgentId?: string | undefined;
     response?: any;
     error?: string | undefined;
-    erc8004AgentId?: string | undefined;
     feeBreakdown?: {
         grossAmount: string;
         providerNet: string;

package/dist/types/adapter.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"adapter.d.ts","sourceRoot":"","sources":["../../src/types/adapter.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"adapter.d.ts","sourceRoot":"","sources":["../../src/types/adapter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,QAAQ,CAAC;AAM/C;;;;;;;GAOG;AACH,MAAM,WAAW,eAAe;IAC9B,gCAAgC;IAChC,EAAE,EAAE,MAAM,CAAC;IAEX,0BAA0B;IAC1B,IAAI,EAAE,MAAM,CAAC;IAEb,kCAAkC;IAClC,UAAU,EAAE,OAAO,CAAC;IAEpB,kDAAkD;IAClD,gBAAgB,EAAE,OAAO,CAAC;IAE1B,iDAAiD;IACjD,gBAAgB,EAAE,OAAO,CAAC;IAE1B,mDAAmD;IACnD,sBAAsB,CAAC,EAAE,MAAM,EAAE,CAAC;IAElC;;;;;OAKG;IACH,cAAc,EAAE,UAAU,GAAG,OAAO,GAAG,QAAQ,CAAC;IAEhD,uDAAuD;IACvD,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED;;GAEG;AACH,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;;;;;;;;;;;;;;;EAShC,CAAC;AAMH;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,SAAS,GAAG,KAAK,GAAG,KAAK,GAAG,SAAS,CAAC;IAC5C,KAAK,EAAE,MAAM,CAAC;CACf;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,0CAA0C;IAC1C,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAE1B,gCAAgC;IAChC,cAAc,CAAC,EAAE,OAAO,CAAC;IAEzB,4CAA4C;IAC5C,eAAe,CAAC,EAAE,OAAO,CAAC;IAE1B,2BAA2B;IAC3B,QAAQ,CAAC,EAAE,eAAe,CAAC;IAE3B,yCAAyC;IACzC,aAAa,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,CAAC;CAC1C;AAED;;GAEG;AACH,eAAO,MAAM,qBAAqB;;;;;;;;;EAGhC,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAMhC,CAAC;AAMH;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,+DAA+D;IAC/D,EAAE,EAAE,MAAM,CAAC;IAEX;;;;;;;OAOG;IACH,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IAEzB,wDAAwD;IACxD,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IAE3B,wDAAwD;IACxD,aAAa,CAAC,EAAE,MAAM,CAAC;IAEvB,0BAA0B;IAC1B,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB,iCAAiC;IACjC,QAAQ,CAAC,EAAE,eAAe,CAAC;IAE3B;;;;OAIG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC;IAExB;;;OAGG;IACH,UAAU,CAAC,EAAE,KAAK,GAAG,MAAM,GAAG,KAAK,GAAG,OAAO,GAAG,QAAQ,CAAC;IAEzD,mFAAmF;IACnF,QAAQ,CAAC,EAAE,MAAM,GAAG,UAAU,CAAC;IAE/B,2EAA2E;IAC3E,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACtC;AAcD;;GAEG;AACH,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAkBjC,CAAC;AAMH;;;;;GAKG;AACH,MAAM,MAAM,uBAAuB,GAAG,WAAW,GAAG,aAAa,CAAC;AAElE;;;;;;;GAOG;AACH,MAAM,WAAW,gBAAgB;IAC/B,6EAA6E;IAC7E,IAAI,EAAE,MAAM,CAAC;IAEb,6DAA6D;IAC7D,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IAExB,uCAAuC;IACvC,OAAO,EAAE,MAAM,CAAC;IAEhB,6CAA6C;IAC7C,KAAK,EAAE,uBAAuB,CAAC;IAE/B,2CAA2C;IAC3C,OAAO,EAAE,OAAO,CAAC;IAEjB,gCAAgC;IAChC,MAAM,EAAE,MAAM,CAAC;IAEf,kCAAkC;IAClC,QAAQ,CAAC,EAAE,QAAQ,CAAC;IAEpB,8BAA8B;IAC9B,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf;;;;;OAKG;IACH,eAAe,EAAE,OAAO,CAAC;IAEzB,iDAAiD;IACjD,QAAQ,EAAE,MAAM,CAAC;IAEjB,kDAAkD;IAClD,SAAS,EAAE,MAAM,CAAC;IAElB,qCAAqC;IACrC,QAAQ,EAAE,MAAM,CAAC;IAEjB;;;OAGG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC;IAExB;;;;;;OAMG;IACH,YAAY,CAAC,EAAE,gBAAgB,CAAC;CACjC;AAED;;GAEG;AACH,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAqBjC,CAAC;AAMH;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,OAAO,GAAG,gBAAgB,CAEnE;AAED;;;;;GAKG;AACH,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,OAAO,GAAG,CAAC,CAAC,mBAAmB,CAAC,OAAO,EAAE,gBAAgB,CAAC,CAEvG"}

package/dist/types/adapter.js

@@ -58,7 +58,9 @@ const MAX_DISPUTE_WINDOW = 30 * 24 * 3600;
  */
 exports.UnifiedPayParamsSchema = zod_1.z.object({
     to: zod_1.z.string().min(1),
-    amount: zod_1.z.union([zod_1.z.string().min(1), zod_1.z.number().positive()]),
+    // Optional — x402 URL targets derive amount from server response.
+    // ACTP adapters (basic, standard) validate presence at pay() time.
+    amount: zod_1.z.union([zod_1.z.string().min(1), zod_1.z.number().positive()]).optional(),
     deadline: zod_1.z.union([zod_1.z.string(), zod_1.z.number()]).optional(),
     disputeWindow: zod_1.z
         .number()
@@ -69,6 +71,9 @@ exports.UnifiedPayParamsSchema = zod_1.z.object({
     description: zod_1.z.string().optional(),
     metadata: exports.PaymentMetadataSchema.optional(),
     erc8004AgentId: zod_1.z.string().optional(),
+    httpMethod: zod_1.z.enum(['GET', 'POST', 'PUT', 'PATCH', 'DELETE']).optional(),
+    httpBody: zod_1.z.union([zod_1.z.string(), zod_1.z.custom((v) => ArrayBuffer.isView(v) && !(v instanceof DataView))]).optional(),
+    httpHeaders: zod_1.z.record(zod_1.z.string()).optional(),
 });
 /**
  * Zod schema for UnifiedPayResult validation.

package/dist/types/adapter.js.map

@@ -1 +1 @@
-{"version":3,"file":"adapter.js","sourceRoot":"","sources":["../../src/types/adapter.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;GAUG;;;AAEH,6BAAwB;AA8CxB;;GAEG;AACU,QAAA,qBAAqB,GAAG,OAAC,CAAC,MAAM,CAAC;IAC5C,EAAE,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IACrB,IAAI,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IACvB,UAAU,EAAE,OAAC,CAAC,OAAO,EAAE;IACvB,gBAAgB,EAAE,OAAC,CAAC,OAAO,EAAE;IAC7B,gBAAgB,EAAE,OAAC,CAAC,OAAO,EAAE;IAC7B,sBAAsB,EAAE,OAAC,CAAC,KAAK,CAAC,OAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE;IACtD,cAAc,EAAE,OAAC,CAAC,IAAI,CAAC,CAAC,UAAU,EAAE,OAAO,EAAE,QAAQ,CAAC,CAAC;IACvD,QAAQ,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC;CAC3C,CAAC,CAAC;AAkCH;;GAEG;AACU,QAAA,qBAAqB,GAAG,OAAC,CAAC,MAAM,CAAC;IAC5C,IAAI,EAAE,OAAC,CAAC,IAAI,CAAC,CAAC,SAAS,EAAE,KAAK,EAAE,KAAK,EAAE,SAAS,CAAC,CAAC;IAClD,KAAK,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;CACzB,CAAC,CAAC;AAEH;;GAEG;AACU,QAAA,qBAAqB,GAAG,OAAC,CAAC,MAAM,CAAC;IAC5C,gBAAgB,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IACvC,cAAc,EAAE,OAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;IACtC,eAAe,EAAE,OAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;IACvC,QAAQ,EAAE,6BAAqB,CAAC,QAAQ,EAAE;IAC1C,aAAa,EAAE,OAAC,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC,QAAQ,EAAE;CAC3D,CAAC,CAAC;AAoCH;;;GAGG;AACH,MAAM,kBAAkB,GAAG,IAAI,CAAC;AAEhC;;;GAGG;AACH,MAAM,kBAAkB,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC;AAE1C;;GAEG;AACU,QAAA,sBAAsB,GAAG,OAAC,CAAC,MAAM,CAAC;IAC7C,EAAE,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IACrB,MAAM,EAAE,OAAC,CAAC,KAAK,CAAC,CAAC,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,CAAC;IAC3D,QAAQ,EAAE,OAAC,CAAC,KAAK,CAAC,CAAC,OAAC,CAAC,MAAM,EAAE,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,QAAQ,EAAE;IACtD,aAAa,EAAE,OAAC;SACb,MAAM,EAAE;SACR,GAAG,EAAE;SACL,GAAG,CAAC,kBAAkB,CAAC;SACvB,GAAG,CAAC,kBAAkB,CAAC;SACvB,QAAQ,EAAE;IACb,WAAW,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAClC,QAAQ,EAAE,6BAAqB,CAAC,QAAQ,EAAE;IAC1C,cAAc,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;CACtC,CAAC,CAAC;AA2EH;;GAEG;AACU,QAAA,sBAAsB,GAAG,OAAC,CAAC,MAAM,CAAC;IAC7C,IAAI,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IACvB,QAAQ,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC/B,OAAO,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IAC1B,KAAK,EAAE,OAAC,CAAC,IAAI,CAAC,CAAC,WAAW,EAAE,aAAa,CAAC,CAAC;IAC3C,OAAO,EAAE,OAAC,CAAC,OAAO,EAAE;IACpB,MAAM,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IACzB,QAAQ,EAAE,OAAC,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE;IAC5B,KAAK,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC5B,eAAe,EAAE,OAAC,CAAC,OAAO,EAAE;IAC5B,QAAQ,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IAC3B,SAAS,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IAC5B,QAAQ,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IAC3B,cAAc,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IACrC,YAAY,EAAE,OAAC,CAAC,MAAM,CAAC;QACrB,WAAW,EAAE,OAAC,CAAC,MAAM,EAAE;QACvB,WAAW,EAAE,OAAC,CAAC,MAAM,EAAE;QACvB,WAAW,EAAE,OAAC,CAAC,MAAM,EAAE;QACvB,MAAM,EAAE,OAAC,CAAC,MAAM,EAAE;QAClB,SAAS,EAAE,OAAC,CAAC,OAAO,CAAC,IAAI,CAAC;KAC3B,CAAC,CAAC,QAAQ,EAAE;CACd,CAAC,CAAC;AAEH,+EAA+E;AAC/E,qBAAqB;AACrB,+EAA+E;AAE/E;;;;;;GAMG;AACH,SAAgB,iBAAiB,CAAC,MAAe;IAC/C,OAAO,8BAAsB,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;AAC9C,CAAC;AAFD,8CAEC;AAED;;;;;GAKG;AACH,SAAgB,qBAAqB,CAAC,MAAe;IACnD,OAAO,8BAAsB,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;AAClD,CAAC;AAFD,sDAEC"}
+{"version":3,"file":"adapter.js","sourceRoot":"","sources":["../../src/types/adapter.ts"],"names":[],"mappings":"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"}

package/dist/types/eip712.d.ts

@@ -137,4 +137,24 @@ export declare const MESSAGE_TYPES: {
  * Get EIP-712 types for message type
  */
 export declare function getMessageTypes(messageType: string): Record<string, any>;
+/**
+ * Generic EIP-712 typed data structure (for x402 v2, Permit2, etc.).
+ *
+ * Consumed by `IWalletProvider.signTypedData` and the x402 adapter.
+ * Plain objects only — matches the no-library-types-at-interface-boundary
+ * convention used by IWalletProvider.
+ */
+export interface EIP712TypedData {
+    /** EIP-712 domain separator fields (name, version, chainId, verifyingContract, etc.) */
+    domain: Record<string, unknown>;
+    /** Type definitions keyed by type name. EIP712Domain entry may be omitted. */
+    types: Record<string, Array<{
+        name: string;
+        type: string;
+    }>>;
+    /** Name of the primary type to sign */
+    primaryType: string;
+    /** The message values to sign */
+    message: Record<string, unknown>;
+}
 //# sourceMappingURL=eip712.d.ts.map

package/dist/types/eip712.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"eip712.d.ts","sourceRoot":"","sources":["../../src/types/eip712.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAE1C;;;;;GAKG;AAEH;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,iBAAiB,EAAE,MAAM,CAAC;CAC3B;AAED;;;GAGG;AACH,eAAO,MAAM,iBAAiB;;;;;CAW7B,CAAC;AAEF,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,EAAE,MAAM,CAAC;IACX,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,MAAM,CAAC;IACjB,aAAa,EAAE,MAAM,CAAC;CACvB;AAED;;;GAGG;AACH,eAAO,MAAM,kBAAkB;;;;;CAY9B,CAAC;AAEF,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,EAAE,MAAM,CAAC;IACX,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,EAAE,MAAM,CAAC;IACrB,KAAK,EAAE,MAAM,CAAC;CACf;AAED;;;GAGG;AACH,eAAO,MAAM,kBAAkB;;;;;CAS9B,CAAC;AAEF,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,wBAAgB,0BAA0B,CAAC,KAAK,EAAE,aAAa,GAAG,iBAAiB,CASlF;AAED;;;GAGG;AACH,eAAO,MAAM,sBAAsB;;;;;CAYlC,CAAC;AAEF,MAAM,WAAW,qBAAqB;IACpC,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;CACf;AAED;;GAEG;AACH,eAAO,MAAM,gBAAgB;;;;;CAU5B,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,aAAa;;;;;;;;;;;;;;;;;;;;;;;;;CAMzB,CAAC;AAEF;;GAEG;AACH,wBAAgB,eAAe,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAExE"}
+{"version":3,"file":"eip712.d.ts","sourceRoot":"","sources":["../../src/types/eip712.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAE1C;;;;;GAKG;AAEH;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,iBAAiB,EAAE,MAAM,CAAC;CAC3B;AAED;;;GAGG;AACH,eAAO,MAAM,iBAAiB;;;;;CAW7B,CAAC;AAEF,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,EAAE,MAAM,CAAC;IACX,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,MAAM,CAAC;IACjB,aAAa,EAAE,MAAM,CAAC;CACvB;AAED;;;GAGG;AACH,eAAO,MAAM,kBAAkB;;;;;CAY9B,CAAC;AAEF,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,EAAE,MAAM,CAAC;IACX,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,EAAE,MAAM,CAAC;IACrB,KAAK,EAAE,MAAM,CAAC;CACf;AAED;;;GAGG;AACH,eAAO,MAAM,kBAAkB;;;;;CAS9B,CAAC;AAEF,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,wBAAgB,0BAA0B,CAAC,KAAK,EAAE,aAAa,GAAG,iBAAiB,CASlF;AAED;;;GAGG;AACH,eAAO,MAAM,sBAAsB;;;;;CAYlC,CAAC;AAEF,MAAM,WAAW,qBAAqB;IACpC,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;CACf;AAED;;GAEG;AACH,eAAO,MAAM,gBAAgB;;;;;CAU5B,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,aAAa;;;;;;;;;;;;;;;;;;;;;;;;;CAMzB,CAAC;AAEF;;GAEG;AACH,wBAAgB,eAAe,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAExE;AAED;;;;;;GAMG;AACH,MAAM,WAAW,eAAe;IAC9B,wFAAwF;IACxF,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAChC,8EAA8E;IAC9E,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC,CAAC;IAC7D,uCAAuC;IACvC,WAAW,EAAE,MAAM,CAAC;IACpB,iCAAiC;IACjC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAClC"}

package/dist/types/x402.d.ts

@@ -159,15 +159,15 @@ export declare class X402Error extends Error {
     toString(): string;
 }
 /**
- * Fee breakdown for x402 payments routed through X402Relay.
+ * @deprecated Legacy from the pre-v2 x402 flow that routed payments
+ * through the on-chain X402Relay fee-splitting contract. The current
+ * X402Adapter (SDK 3.3.0+) uses x402 v2 — payments go directly from
+ * buyer to seller via the facilitator pattern and there is no AGIRAILS
+ * fee on the x402 path. This type is retained for API back-compat but
+ * has no active producer. Remove in the next breaking SDK major.
  *
- * Shows how the gross amount was split between provider and platform.
- * Fee = max(grossAmount * feeBps / 10000, MIN_FEE).
- *
- * NOTE: This is a client-side **estimate** computed from the configured
- * platformFeeBps. The on-chain X402Relay contract is the source of truth.
- * If an admin updates the relay's fee rate, this estimate may diverge
- * from the actual on-chain split until the SDK config is refreshed.
+ * Historical semantics: Fee = max(grossAmount * feeBps / 10000, MIN_FEE).
+ * providerNet + platformFee == grossAmount.
  */
 export interface X402FeeBreakdown {
     /** Total amount from the 402 header (USDC wei, 6 decimals) */

package/dist/utils/security.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"security.d.ts","sourceRoot":"","sources":["../../src/utils/security.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAKH;;;;;;;;;GASG;AACH,wBAAgB,eAAe,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,OAAO,CAkB7D;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,YAAY,CAAC,aAAa,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,GAAG,MAAM,CA4BjF;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,mBAAmB,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAgC/D;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAyBvD;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,aAAa,CAAC,CAAC,GAAG,GAAG,EACnC,UAAU,EAAE,MAAM,EAClB,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAC9B,CAAC,GAAG,IAAI,CAoEV;AAqCD;;;;;;GAMG;AACH,qBAAa,QAAQ,CAAC,CAAC,EAAE,CAAC;IACxB,OAAO,CAAC,KAAK,CAAmB;IAChC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;gBAErB,OAAO,GAAE,MAAa;IAOlC;;;;;OAKG;IACH,GAAG,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,GAAG,SAAS;IAU1B;;;;;OAKG;IACH,GAAG,CAAC,GAAG,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,GAAG,IAAI;IAmB3B;;;;;;;;OAQG;IACH,GAAG,CAAC,GAAG,EAAE,CAAC,GAAG,OAAO;IAIpB;;;;OAIG;IACH,MAAM,CAAC,GAAG,EAAE,CAAC,GAAG,IAAI;IAIpB;;OAEG;IACH,KAAK,IAAI,IAAI;IAIb;;OAEG;IACH,IAAI,IAAI,IAAI,MAAM,CAEjB;IAED;;;;;;;OAOG;IACH,MAAM,IAAI,CAAC,EAAE;IAIb;;;;OAIG;IACH,IAAI,IAAI,CAAC,EAAE;IAIX;;;;OAIG;IACH,OAAO,IAAI,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE;CAGpB"}
+{"version":3,"file":"security.d.ts","sourceRoot":"","sources":["../../src/utils/security.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAKH;;;;;;;;;GASG;AACH,wBAAgB,eAAe,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,OAAO,CAgB7D;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,YAAY,CAAC,aAAa,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,GAAG,MAAM,CA4BjF;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,mBAAmB,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAgC/D;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAyBvD;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,aAAa,CAAC,CAAC,GAAG,GAAG,EACnC,UAAU,EAAE,MAAM,EAClB,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAC9B,CAAC,GAAG,IAAI,CAoEV;AAqCD;;;;;;GAMG;AACH,qBAAa,QAAQ,CAAC,CAAC,EAAE,CAAC;IACxB,OAAO,CAAC,KAAK,CAAmB;IAChC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;gBAErB,OAAO,GAAE,MAAa;IAOlC;;;;;OAKG;IACH,GAAG,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,GAAG,SAAS;IAU1B;;;;;OAKG;IACH,GAAG,CAAC,GAAG,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,GAAG,IAAI;IAmB3B;;;;;;;;OAQG;IACH,GAAG,CAAC,GAAG,EAAE,CAAC,GAAG,OAAO;IAIpB;;;;OAIG;IACH,MAAM,CAAC,GAAG,EAAE,CAAC,GAAG,IAAI;IAIpB;;OAEG;IACH,KAAK,IAAI,IAAI;IAIb;;OAEG;IACH,IAAI,IAAI,IAAI,MAAM,CAEjB;IAED;;;;;;;OAOG;IACH,MAAM,IAAI,CAAC,EAAE;IAIb;;;;OAIG;IACH,IAAI,IAAI,CAAC,EAAE;IAIX;;;;OAIG;IACH,OAAO,IAAI,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE;CAGpB"}