@bankofai/x402 0.5.9 → 0.6.0-beta.1

package/dist/facilitator/x402Facilitator.d.ts

@@ -0,0 +1,97 @@
+/**
+ * X402Facilitator — TypeScript port of `bankofai.x402.facilitator.X402Facilitator`.
+ *
+ * The core in-process payment processor for an x402 facilitator service.
+ * Manages a registry of {@link FacilitatorMechanism}s keyed by `(network, scheme)`
+ * and routes verify / settle / feeQuote calls to the right implementation.
+ *
+ * This is the *engine* — wrap it with an HTTP server (Hono / Express / Fastify)
+ * to expose `/verify`, `/settle`, `/supported`, `/fee/quote` endpoints.
+ */
+import type { FeeQuoteResponse, PaymentPayload, PaymentRequirements, SettleResponse, SupportedResponse, VerifyResponse } from '../types/index.js';
+/**
+ * Server-side mechanism interface for the facilitator.
+ *
+ * One per `(network, scheme)` pair. Implementations live in the chain-specific
+ * mechanism packages (TRON / EVM / etc.) — this interface keeps the facilitator
+ * core agnostic of any particular chain.
+ */
+export interface FacilitatorMechanism {
+    /** Scheme name this mechanism handles (e.g. `"exact"`, `"exact_permit"`). */
+    scheme(): string;
+    /**
+     * Optional fee quote for a single requirement. Return `null` when this
+     * mechanism cannot quote the requirement (e.g. token not in registry).
+     */
+    feeQuote(accept: PaymentRequirements, context?: Record<string, unknown>): Promise<FeeQuoteResponse | null>;
+    /** Off-chain signature / replay / timing verification. */
+    verify(payload: PaymentPayload, requirements: PaymentRequirements): Promise<VerifyResponse>;
+    /** On-chain settlement. */
+    settle(payload: PaymentPayload, requirements: PaymentRequirements): Promise<SettleResponse>;
+}
+/** Optional logger interface for observability hooks. */
+export interface FacilitatorLogger {
+    warn(msg: string, meta?: Record<string, unknown>): void;
+    error(msg: string, meta?: Record<string, unknown>): void;
+}
+/**
+ * In-process payment processor. Mirrors the Python `X402Facilitator` 1:1.
+ *
+ * @example
+ * ```ts
+ * const facilitator = new X402Facilitator()
+ *   .register(['tron:nile'], tronExactMechanism)
+ *   .register(['eip155:97'], bscExactPermitMechanism);
+ *
+ * const verifyResult = await facilitator.verify(payload, requirements);
+ * if (verifyResult.isValid) {
+ *   const settleResult = await facilitator.settle(payload, requirements);
+ * }
+ * ```
+ */
+export declare class X402Facilitator {
+    /** network → scheme → mechanism */
+    private readonly mechanisms;
+    private readonly logger;
+    constructor(opts?: {
+        logger?: FacilitatorLogger;
+    });
+    /**
+     * Register a mechanism for a list of networks. Returns `this` for chaining.
+     */
+    register(networks: string[], mechanism: FacilitatorMechanism): this;
+    /** Snapshot of registered `(x402Version, scheme, network)` triples. */
+    supported(): SupportedResponse;
+    /**
+     * Fee quotes for a list of requirements. Unsupported `(network, scheme)` /
+     * mechanisms returning `null` are silently skipped — the result list may be
+     * shorter than the input. Per-mechanism exceptions surface as a thrown
+     * `Error` (caller decides whether to 4xx or 5xx the HTTP request).
+     */
+    feeQuote(accepts: PaymentRequirements[], context?: Record<string, unknown>): Promise<FeeQuoteResponse[]>;
+    /**
+     * Verify a payment payload off-chain. Always returns a {@link VerifyResponse};
+     * mechanism exceptions become `isValid: false` with the message as
+     * `invalidReason` and a logger.error entry.
+     */
+    verify(payload: PaymentPayload, requirements: PaymentRequirements): Promise<VerifyResponse>;
+    /**
+     * Execute on-chain settlement. Always returns a {@link SettleResponse};
+     * exceptions become `success: false` with `errorReason` set.
+     */
+    settle(payload: PaymentPayload, requirements: PaymentRequirements): Promise<SettleResponse>;
+    private findMechanism;
+    /**
+     * Strict variant — throws if any EVM address fails checksum. Used in verify /
+     * settle so the failure message ends up in the response.
+     */
+    private normalizeEvmRequirements;
+    /**
+     * Lenient variant for `feeQuote` — invalid-EVM-input requirements are simply
+     * skipped (returning the original so they can be filtered out by mechanism
+     * lookup miss).
+     */
+    private tryNormalizeEvmRequirements;
+    private checksumAddressStrict;
+}
+//# sourceMappingURL=x402Facilitator.d.ts.map

package/dist/facilitator/x402Facilitator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"x402Facilitator.d.ts","sourceRoot":"","sources":["../../src/facilitator/x402Facilitator.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAIH,OAAO,KAAK,EACV,gBAAgB,EAChB,cAAc,EACd,mBAAmB,EACnB,cAAc,EACd,iBAAiB,EACjB,cAAc,EACf,MAAM,mBAAmB,CAAC;AAE3B;;;;;;GAMG;AACH,MAAM,WAAW,oBAAoB;IACnC,6EAA6E;IAC7E,MAAM,IAAI,MAAM,CAAC;IACjB;;;OAGG;IACH,QAAQ,CACN,MAAM,EAAE,mBAAmB,EAC3B,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAChC,OAAO,CAAC,gBAAgB,GAAG,IAAI,CAAC,CAAC;IACpC,0DAA0D;IAC1D,MAAM,CACJ,OAAO,EAAE,cAAc,EACvB,YAAY,EAAE,mBAAmB,GAChC,OAAO,CAAC,cAAc,CAAC,CAAC;IAC3B,2BAA2B;IAC3B,MAAM,CACJ,OAAO,EAAE,cAAc,EACvB,YAAY,EAAE,mBAAmB,GAChC,OAAO,CAAC,cAAc,CAAC,CAAC;CAC5B;AAED,yDAAyD;AACzD,MAAM,WAAW,iBAAiB;IAChC,IAAI,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IACxD,KAAK,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;CAC1D;AAOD;;;;;;;;;;;;;;GAcG;AACH,qBAAa,eAAe;IAC1B,mCAAmC;IACnC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAwD;IAEnF,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAoB;gBAE/B,IAAI,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,iBAAiB,CAAA;KAAE;IAIjD;;OAEG;IACH,QAAQ,CAAC,QAAQ,EAAE,MAAM,EAAE,EAAE,SAAS,EAAE,oBAAoB,GAAG,IAAI;IAanE,uEAAuE;IACvE,SAAS,IAAI,iBAAiB;IAU9B;;;;;OAKG;IACG,QAAQ,CACZ,OAAO,EAAE,mBAAmB,EAAE,EAC9B,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAChC,OAAO,CAAC,gBAAgB,EAAE,CAAC;IAuB9B;;;;OAIG;IACG,MAAM,CACV,OAAO,EAAE,cAAc,EACvB,YAAY,EAAE,mBAAmB,GAChC,OAAO,CAAC,cAAc,CAAC;IA0B1B;;;OAGG;IACG,MAAM,CACV,OAAO,EAAE,cAAc,EACvB,YAAY,EAAE,mBAAmB,GAChC,OAAO,CAAC,cAAc,CAAC;IAmC1B,OAAO,CAAC,aAAa;IAIrB;;;OAGG;IACH,OAAO,CAAC,wBAAwB;IAyBhC;;;;OAIG;IACH,OAAO,CAAC,2BAA2B;IAQnC,OAAO,CAAC,qBAAqB;CAM9B"}

package/dist/facilitator/x402Facilitator.js

@@ -0,0 +1,212 @@
+/**
+ * X402Facilitator — TypeScript port of `bankofai.x402.facilitator.X402Facilitator`.
+ *
+ * The core in-process payment processor for an x402 facilitator service.
+ * Manages a registry of {@link FacilitatorMechanism}s keyed by `(network, scheme)`
+ * and routes verify / settle / feeQuote calls to the right implementation.
+ *
+ * This is the *engine* — wrap it with an HTTP server (Hono / Express / Fastify)
+ * to expose `/verify`, `/settle`, `/supported`, `/fee/quote` endpoints.
+ */
+import { getAddress, isAddress } from 'viem';
+const consoleLogger = {
+    warn: (msg, meta) => console.warn(`[X402Facilitator] ${msg}`, meta ?? ''),
+    error: (msg, meta) => console.error(`[X402Facilitator] ${msg}`, meta ?? ''),
+};
+/**
+ * In-process payment processor. Mirrors the Python `X402Facilitator` 1:1.
+ *
+ * @example
+ * ```ts
+ * const facilitator = new X402Facilitator()
+ *   .register(['tron:nile'], tronExactMechanism)
+ *   .register(['eip155:97'], bscExactPermitMechanism);
+ *
+ * const verifyResult = await facilitator.verify(payload, requirements);
+ * if (verifyResult.isValid) {
+ *   const settleResult = await facilitator.settle(payload, requirements);
+ * }
+ * ```
+ */
+export class X402Facilitator {
+    /** network → scheme → mechanism */
+    mechanisms = new Map();
+    logger;
+    constructor(opts) {
+        this.logger = opts?.logger ?? consoleLogger;
+    }
+    /**
+     * Register a mechanism for a list of networks. Returns `this` for chaining.
+     */
+    register(networks, mechanism) {
+        const scheme = mechanism.scheme();
+        for (const network of networks) {
+            let bucket = this.mechanisms.get(network);
+            if (!bucket) {
+                bucket = new Map();
+                this.mechanisms.set(network, bucket);
+            }
+            bucket.set(scheme, mechanism);
+        }
+        return this;
+    }
+    /** Snapshot of registered `(x402Version, scheme, network)` triples. */
+    supported() {
+        const kinds = [];
+        for (const [network, schemes] of this.mechanisms) {
+            for (const scheme of schemes.keys()) {
+                kinds.push({ x402Version: 2, scheme, network });
+            }
+        }
+        return { kinds };
+    }
+    /**
+     * Fee quotes for a list of requirements. Unsupported `(network, scheme)` /
+     * mechanisms returning `null` are silently skipped — the result list may be
+     * shorter than the input. Per-mechanism exceptions surface as a thrown
+     * `Error` (caller decides whether to 4xx or 5xx the HTTP request).
+     */
+    async feeQuote(accepts, context) {
+        const results = [];
+        for (const accept of accepts) {
+            const normalized = this.tryNormalizeEvmRequirements(accept);
+            const mechanism = this.findMechanism(normalized.network, normalized.scheme);
+            if (!mechanism) {
+                continue;
+            }
+            try {
+                const quote = await mechanism.feeQuote(normalized, context);
+                if (quote !== null) {
+                    results.push(quote);
+                }
+            }
+            catch (err) {
+                throw new Error(`Fee quote failed for ${normalized.network}/${normalized.scheme}: ${err.message}`, { cause: err });
+            }
+        }
+        return results;
+    }
+    /**
+     * Verify a payment payload off-chain. Always returns a {@link VerifyResponse};
+     * mechanism exceptions become `isValid: false` with the message as
+     * `invalidReason` and a logger.error entry.
+     */
+    async verify(payload, requirements) {
+        const mechanism = this.findMechanism(requirements.network, requirements.scheme);
+        if (!mechanism) {
+            return {
+                isValid: false,
+                invalidReason: `unsupported_network_scheme: ${requirements.network}/${requirements.scheme}`,
+            };
+        }
+        let normalized;
+        try {
+            normalized = this.normalizeEvmRequirements(requirements);
+        }
+        catch (err) {
+            return { isValid: false, invalidReason: err.message };
+        }
+        try {
+            return await mechanism.verify(payload, normalized);
+        }
+        catch (err) {
+            this.logger.error('verify failed', {
+                network: normalized.network,
+                scheme: normalized.scheme,
+                error: err.message,
+            });
+            return { isValid: false, invalidReason: err.message };
+        }
+    }
+    /**
+     * Execute on-chain settlement. Always returns a {@link SettleResponse};
+     * exceptions become `success: false` with `errorReason` set.
+     */
+    async settle(payload, requirements) {
+        const mechanism = this.findMechanism(requirements.network, requirements.scheme);
+        if (!mechanism) {
+            return {
+                success: false,
+                network: requirements.network,
+                errorReason: `unsupported_network_scheme: ${requirements.network}/${requirements.scheme}`,
+            };
+        }
+        let normalized;
+        try {
+            normalized = this.normalizeEvmRequirements(requirements);
+        }
+        catch (err) {
+            return {
+                success: false,
+                network: requirements.network,
+                errorReason: err.message,
+            };
+        }
+        try {
+            return await mechanism.settle(payload, normalized);
+        }
+        catch (err) {
+            this.logger.error('settle failed', {
+                network: normalized.network,
+                scheme: normalized.scheme,
+                error: err.message,
+            });
+            return {
+                success: false,
+                network: normalized.network,
+                errorReason: err.message,
+            };
+        }
+    }
+    findMechanism(network, scheme) {
+        return this.mechanisms.get(network)?.get(scheme) ?? null;
+    }
+    /**
+     * Strict variant — throws if any EVM address fails checksum. Used in verify /
+     * settle so the failure message ends up in the response.
+     */
+    normalizeEvmRequirements(reqs) {
+        if (!reqs.network.startsWith('eip155:')) {
+            return reqs;
+        }
+        return {
+            ...reqs,
+            asset: this.checksumAddressStrict(reqs.asset, 'asset'),
+            payTo: this.checksumAddressStrict(reqs.payTo, 'payTo'),
+            extra: reqs.extra
+                ? {
+                    ...reqs.extra,
+                    fee: reqs.extra.fee
+                        ? {
+                            ...reqs.extra.fee,
+                            feeTo: this.checksumAddressStrict(reqs.extra.fee.feeTo, 'extra.fee.feeTo'),
+                            caller: reqs.extra.fee.caller
+                                ? this.checksumAddressStrict(reqs.extra.fee.caller, 'extra.fee.caller')
+                                : reqs.extra.fee.caller,
+                        }
+                        : reqs.extra.fee,
+                }
+                : reqs.extra,
+        };
+    }
+    /**
+     * Lenient variant for `feeQuote` — invalid-EVM-input requirements are simply
+     * skipped (returning the original so they can be filtered out by mechanism
+     * lookup miss).
+     */
+    tryNormalizeEvmRequirements(reqs) {
+        try {
+            return this.normalizeEvmRequirements(reqs);
+        }
+        catch {
+            return reqs;
+        }
+    }
+    checksumAddressStrict(address, fieldName) {
+        if (!isAddress(address, { strict: false })) {
+            throw new Error(`Invalid EVM address for ${fieldName}: ${address}`);
+        }
+        return getAddress(address);
+    }
+}
+//# sourceMappingURL=x402Facilitator.js.map

package/dist/facilitator/x402Facilitator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"x402Facilitator.js","sourceRoot":"","sources":["../../src/facilitator/x402Facilitator.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,MAAM,CAAC;AA+C7C,MAAM,aAAa,GAAsB;IACvC,IAAI,EAAE,CAAC,GAAG,EAAE,IAAI,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,qBAAqB,GAAG,EAAE,EAAE,IAAI,IAAI,EAAE,CAAC;IACzE,KAAK,EAAE,CAAC,GAAG,EAAE,IAAI,EAAE,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,qBAAqB,GAAG,EAAE,EAAE,IAAI,IAAI,EAAE,CAAC;CAC5E,CAAC;AAEF;;;;;;;;;;;;;;GAcG;AACH,MAAM,OAAO,eAAe;IAC1B,mCAAmC;IAClB,UAAU,GAAG,IAAI,GAAG,EAA6C,CAAC;IAElE,MAAM,CAAoB;IAE3C,YAAY,IAAqC;QAC/C,IAAI,CAAC,MAAM,GAAG,IAAI,EAAE,MAAM,IAAI,aAAa,CAAC;IAC9C,CAAC;IAED;;OAEG;IACH,QAAQ,CAAC,QAAkB,EAAE,SAA+B;QAC1D,MAAM,MAAM,GAAG,SAAS,CAAC,MAAM,EAAE,CAAC;QAClC,KAAK,MAAM,OAAO,IAAI,QAAQ,EAAE,CAAC;YAC/B,IAAI,MAAM,GAAG,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;YAC1C,IAAI,CAAC,MAAM,EAAE,CAAC;gBACZ,MAAM,GAAG,IAAI,GAAG,EAAgC,CAAC;gBACjD,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;YACvC,CAAC;YACD,MAAM,CAAC,GAAG,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;QAChC,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC;IAED,uEAAuE;IACvE,SAAS;QACP,MAAM,KAAK,GAA+B,EAAE,CAAC;QAC7C,KAAK,MAAM,CAAC,OAAO,EAAE,OAAO,CAAC,IAAI,IAAI,CAAC,UAAU,EAAE,CAAC;YACjD,KAAK,MAAM,MAAM,IAAI,OAAO,CAAC,IAAI,EAAE,EAAE,CAAC;gBACpC,KAAK,CAAC,IAAI,CAAC,EAAE,WAAW,EAAE,CAAC,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,CAAC;YAClD,CAAC;QACH,CAAC;QACD,OAAO,EAAE,KAAK,EAAE,CAAC;IACnB,CAAC;IAED;;;;;OAKG;IACH,KAAK,CAAC,QAAQ,CACZ,OAA8B,EAC9B,OAAiC;QAEjC,MAAM,OAAO,GAAuB,EAAE,CAAC;QACvC,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;YAC7B,MAAM,UAAU,GAAG,IAAI,CAAC,2BAA2B,CAAC,MAAM,CAAC,CAAC;YAC5D,MAAM,SAAS,GAAG,IAAI,CAAC,aAAa,CAAC,UAAU,CAAC,OAAO,EAAE,UAAU,CAAC,MAAM,CAAC,CAAC;YAC5E,IAAI,CAAC,SAAS,EAAE,CAAC;gBACf,SAAS;YACX,CAAC;YACD,IAAI,CAAC;gBACH,MAAM,KAAK,GAAG,MAAM,SAAS,CAAC,QAAQ,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC;gBAC5D,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;oBACnB,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;gBACtB,CAAC;YACH,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACb,MAAM,IAAI,KAAK,CACb,wBAAwB,UAAU,CAAC,OAAO,IAAI,UAAU,CAAC,MAAM,KAAM,GAAa,CAAC,OAAO,EAAE,EAC5F,EAAE,KAAK,EAAE,GAAG,EAAE,CACf,CAAC;YACJ,CAAC;QACH,CAAC;QACD,OAAO,OAAO,CAAC;IACjB,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAC,MAAM,CACV,OAAuB,EACvB,YAAiC;QAEjC,MAAM,SAAS,GAAG,IAAI,CAAC,aAAa,CAAC,YAAY,CAAC,OAAO,EAAE,YAAY,CAAC,MAAM,CAAC,CAAC;QAChF,IAAI,CAAC,SAAS,EAAE,CAAC;YACf,OAAO;gBACL,OAAO,EAAE,KAAK;gBACd,aAAa,EAAE,+BAA+B,YAAY,CAAC,OAAO,IAAI,YAAY,CAAC,MAAM,EAAE;aAC5F,CAAC;QACJ,CAAC;QACD,IAAI,UAA+B,CAAC;QACpC,IAAI,CAAC;YACH,UAAU,GAAG,IAAI,CAAC,wBAAwB,CAAC,YAAY,CAAC,CAAC;QAC3D,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,aAAa,EAAG,GAAa,CAAC,OAAO,EAAE,CAAC;QACnE,CAAC;QACD,IAAI,CAAC;YACH,OAAO,MAAM,SAAS,CAAC,MAAM,CAAC,OAAO,EAAE,UAAU,CAAC,CAAC;QACrD,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,eAAe,EAAE;gBACjC,OAAO,EAAE,UAAU,CAAC,OAAO;gBAC3B,MAAM,EAAE,UAAU,CAAC,MAAM;gBACzB,KAAK,EAAG,GAAa,CAAC,OAAO;aAC9B,CAAC,CAAC;YACH,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,aAAa,EAAG,GAAa,CAAC,OAAO,EAAE,CAAC;QACnE,CAAC;IACH,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,MAAM,CACV,OAAuB,EACvB,YAAiC;QAEjC,MAAM,SAAS,GAAG,IAAI,CAAC,aAAa,CAAC,YAAY,CAAC,OAAO,EAAE,YAAY,CAAC,MAAM,CAAC,CAAC;QAChF,IAAI,CAAC,SAAS,EAAE,CAAC;YACf,OAAO;gBACL,OAAO,EAAE,KAAK;gBACd,OAAO,EAAE,YAAY,CAAC,OAAO;gBAC7B,WAAW,EAAE,+BAA+B,YAAY,CAAC,OAAO,IAAI,YAAY,CAAC,MAAM,EAAE;aAC1F,CAAC;QACJ,CAAC;QACD,IAAI,UAA+B,CAAC;QACpC,IAAI,CAAC;YACH,UAAU,GAAG,IAAI,CAAC,wBAAwB,CAAC,YAAY,CAAC,CAAC;QAC3D,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,OAAO;gBACL,OAAO,EAAE,KAAK;gBACd,OAAO,EAAE,YAAY,CAAC,OAAO;gBAC7B,WAAW,EAAG,GAAa,CAAC,OAAO;aACpC,CAAC;QACJ,CAAC;QACD,IAAI,CAAC;YACH,OAAO,MAAM,SAAS,CAAC,MAAM,CAAC,OAAO,EAAE,UAAU,CAAC,CAAC;QACrD,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,eAAe,EAAE;gBACjC,OAAO,EAAE,UAAU,CAAC,OAAO;gBAC3B,MAAM,EAAE,UAAU,CAAC,MAAM;gBACzB,KAAK,EAAG,GAAa,CAAC,OAAO;aAC9B,CAAC,CAAC;YACH,OAAO;gBACL,OAAO,EAAE,KAAK;gBACd,OAAO,EAAE,UAAU,CAAC,OAAO;gBAC3B,WAAW,EAAG,GAAa,CAAC,OAAO;aACpC,CAAC;QACJ,CAAC;IACH,CAAC;IAEO,aAAa,CAAC,OAAe,EAAE,MAAc;QACnD,OAAO,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,GAAG,CAAC,MAAM,CAAC,IAAI,IAAI,CAAC;IAC3D,CAAC;IAED;;;OAGG;IACK,wBAAwB,CAAC,IAAyB;QACxD,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,SAAS,CAAC,EAAE,CAAC;YACxC,OAAO,IAAI,CAAC;QACd,CAAC;QACD,OAAO;YACL,GAAG,IAAI;YACP,KAAK,EAAE,IAAI,CAAC,qBAAqB,CAAC,IAAI,CAAC,KAAK,EAAE,OAAO,CAAC;YACtD,KAAK,EAAE,IAAI,CAAC,qBAAqB,CAAC,IAAI,CAAC,KAAK,EAAE,OAAO,CAAC;YACtD,KAAK,EAAE,IAAI,CAAC,KAAK;gBACf,CAAC,CAAC;oBACE,GAAG,IAAI,CAAC,KAAK;oBACb,GAAG,EAAE,IAAI,CAAC,KAAK,CAAC,GAAG;wBACjB,CAAC,CAAC;4BACE,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG;4BACjB,KAAK,EAAE,IAAI,CAAC,qBAAqB,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,KAAK,EAAE,iBAAiB,CAAC;4BAC1E,MAAM,EAAE,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,MAAM;gCAC3B,CAAC,CAAC,IAAI,CAAC,qBAAqB,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,MAAM,EAAE,kBAAkB,CAAC;gCACvE,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,MAAM;yBAC1B;wBACH,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG;iBACnB;gBACH,CAAC,CAAC,IAAI,CAAC,KAAK;SACf,CAAC;IACJ,CAAC;IAED;;;;OAIG;IACK,2BAA2B,CAAC,IAAyB;QAC3D,IAAI,CAAC;YACH,OAAO,IAAI,CAAC,wBAAwB,CAAC,IAAI,CAAC,CAAC;QAC7C,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,IAAI,CAAC;QACd,CAAC;IACH,CAAC;IAEO,qBAAqB,CAAC,OAAe,EAAE,SAAiB;QAC9D,IAAI,CAAC,SAAS,CAAC,OAAO,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,EAAE,CAAC;YAC3C,MAAM,IAAI,KAAK,CAAC,2BAA2B,SAAS,KAAK,OAAO,EAAE,CAAC,CAAC;QACtE,CAAC;QACD,OAAO,UAAU,CAAC,OAAO,CAAC,CAAC;IAC7B,CAAC;CACF"}

package/dist/http/client.d.ts

@@ -1,33 +1,82 @@
 /**
- * X402FetchClient - Fetch-based HTTP client with automatic 402 payment handling
+ * X402FetchClient — Fetch-based HTTP client with automatic 402 payment handling.
+ *
+ * Mirrors `bankofai.x402.clients.X402HttpClient` on the Python side. Wraps the
+ * global `fetch` (configurable for tests) so agent code can call any URL and
+ * have 402 challenges silently handled — challenge → sign → retry → return
+ * the final 200 response, with the settled payment receipt parseable via
+ * {@link parsePaymentResponseHeader}.
  */
-import { X402Client, PaymentRequirementsSelector } from '../index.js';
+import { type PaymentRequirementsSelector, type SettleResponse, X402Client } from '../index.js';
+/** Wire-format header names. */
+export declare const PAYMENT_SIGNATURE_HEADER = "PAYMENT-SIGNATURE";
+export declare const PAYMENT_REQUIRED_HEADER = "PAYMENT-REQUIRED";
+export declare const PAYMENT_RESPONSE_HEADER = "PAYMENT-RESPONSE";
+/** Constructor options for {@link X402FetchClient}. */
+export interface X402FetchClientOptions {
+    /** Custom payment requirements selector (defaults to library default). */
+    selector?: PaymentRequirementsSelector;
+    /** Custom fetch implementation (defaults to global `fetch`). Useful for tests. */
+    fetchImpl?: typeof fetch;
+}
 /**
- * Fetch-based HTTP client with automatic 402 payment handling
+ * Fetch-based HTTP client with automatic 402 payment handling.
+ *
+ * @example
+ * ```ts
+ * const x402Client = new X402Client(...).register(mechanism);
+ * const httpClient = new X402FetchClient(x402Client);
+ *
+ * const res = await httpClient.get('https://api.example.com/llm');
+ * if (res.ok) {
+ *   const settled = parsePaymentResponseHeader(res);
+ *   console.log('paid via tx', settled?.transaction);
+ * }
+ * ```
  */
 export declare class X402FetchClient {
-    private x402Client;
-    private selector?;
-    constructor(x402Client: X402Client, selector?: PaymentRequirementsSelector);
+    private readonly x402Client;
+    private readonly selector?;
+    private readonly fetchImpl;
+    constructor(x402Client: X402Client, selectorOrOptions?: PaymentRequirementsSelector | X402FetchClientOptions);
     /**
-     * Make request with automatic 402 payment handling
+     * Issue a request with automatic 402 → pay → retry handling.
+     *
+     * If the server returns a non-402 status, the response is passed through.
+     * If the 402 cannot be parsed (no PAYMENT-REQUIRED header and no parseable
+     * body), the original 402 is returned to the caller for inspection.
      */
     request(url: string, init?: RequestInit): Promise<Response>;
-    /**
-     * GET request with payment handling
-     */
+    /** GET shorthand. */
     get(url: string, init?: RequestInit): Promise<Response>;
-    /**
-     * POST request with payment handling
-     */
+    /** POST shorthand. */
     post(url: string, body?: RequestInit['body'], init?: RequestInit): Promise<Response>;
+    /** PUT shorthand. */
+    put(url: string, body?: RequestInit['body'], init?: RequestInit): Promise<Response>;
+    /** PATCH shorthand. */
+    patch(url: string, body?: RequestInit['body'], init?: RequestInit): Promise<Response>;
+    /** DELETE shorthand. */
+    delete(url: string, init?: RequestInit): Promise<Response>;
     /**
-     * Parse PaymentRequired from 402 response
+     * Try to parse a `PaymentRequired` from the 402 response.
+     *
+     * Order:
+     * 1. `PAYMENT-REQUIRED` header (base64 JSON).
+     * 2. JSON body fallback when header is missing or undecodable.
+     *
+     * Returns `null` if neither path yields a recognizable shape.
      */
     private parsePaymentRequired;
-    /**
-     * Retry request with payment payload
-     */
+    /** Re-issue the original request with the encoded payment payload header. */
     private retryWithPayment;
 }
+/**
+ * Pull the {@link SettleResponse} out of a 200 response's PAYMENT-RESPONSE header.
+ *
+ * Servers attach this on success so the client can record the settlement tx
+ * hash / network without making a separate facilitator call.
+ *
+ * @returns The decoded settle response, or `null` if the header is absent or malformed.
+ */
+export declare function parsePaymentResponseHeader(response: Response): SettleResponse | null;
 //# sourceMappingURL=client.d.ts.map

package/dist/http/client.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../src/http/client.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EACL,UAAU,EAGV,2BAA2B,EAG5B,MAAM,aAAa,CAAC;AAOrB;;GAEG;AACH,qBAAa,eAAe;IAC1B,OAAO,CAAC,UAAU,CAAa;IAC/B,OAAO,CAAC,QAAQ,CAAC,CAA8B;gBAG7C,UAAU,EAAE,UAAU,EACtB,QAAQ,CAAC,EAAE,2BAA2B;IAMxC;;OAEG;IACG,OAAO,CACX,GAAG,EAAE,MAAM,EACX,IAAI,CAAC,EAAE,WAAW,GACjB,OAAO,CAAC,QAAQ,CAAC;IAsBpB;;OAEG;IACG,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,QAAQ,CAAC;IAI7D;;OAEG;IACG,IAAI,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,WAAW,CAAC,MAAM,CAAC,EAAE,IAAI,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,QAAQ,CAAC;IAI1F;;OAEG;YACW,oBAAoB;IAsBlC;;OAEG;YACW,gBAAgB;CAe/B"}
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../src/http/client.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAGL,KAAK,2BAA2B,EAChC,KAAK,cAAc,EACnB,UAAU,EAGX,MAAM,aAAa,CAAC;AAErB,gCAAgC;AAChC,eAAO,MAAM,wBAAwB,sBAAsB,CAAC;AAC5D,eAAO,MAAM,uBAAuB,qBAAqB,CAAC;AAC1D,eAAO,MAAM,uBAAuB,qBAAqB,CAAC;AAE1D,uDAAuD;AACvD,MAAM,WAAW,sBAAsB;IACrC,0EAA0E;IAC1E,QAAQ,CAAC,EAAE,2BAA2B,CAAC;IACvC,kFAAkF;IAClF,SAAS,CAAC,EAAE,OAAO,KAAK,CAAC;CAC1B;AAED;;;;;;;;;;;;;;GAcG;AACH,qBAAa,eAAe;IAC1B,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAa;IACxC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAA8B;IACxD,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAe;gBAGvC,UAAU,EAAE,UAAU,EACtB,iBAAiB,CAAC,EAAE,2BAA2B,GAAG,sBAAsB;IAY1E;;;;;;OAMG;IACG,OAAO,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,QAAQ,CAAC;IAqBjE,qBAAqB;IACf,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,QAAQ,CAAC;IAI7D,sBAAsB;IAChB,IAAI,CACR,GAAG,EAAE,MAAM,EACX,IAAI,CAAC,EAAE,WAAW,CAAC,MAAM,CAAC,EAC1B,IAAI,CAAC,EAAE,WAAW,GACjB,OAAO,CAAC,QAAQ,CAAC;IAIpB,qBAAqB;IACf,GAAG,CACP,GAAG,EAAE,MAAM,EACX,IAAI,CAAC,EAAE,WAAW,CAAC,MAAM,CAAC,EAC1B,IAAI,CAAC,EAAE,WAAW,GACjB,OAAO,CAAC,QAAQ,CAAC;IAIpB,uBAAuB;IACjB,KAAK,CACT,GAAG,EAAE,MAAM,EACX,IAAI,CAAC,EAAE,WAAW,CAAC,MAAM,CAAC,EAC1B,IAAI,CAAC,EAAE,WAAW,GACjB,OAAO,CAAC,QAAQ,CAAC;IAIpB,wBAAwB;IAClB,MAAM,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,QAAQ,CAAC;IAIhE;;;;;;;;OAQG;YACW,oBAAoB;IAsBlC,6EAA6E;YAC/D,gBAAgB;CAU/B;AAED;;;;;;;GAOG;AACH,wBAAgB,0BAA0B,CAAC,QAAQ,EAAE,QAAQ,GAAG,cAAc,GAAG,IAAI,CAUpF"}

package/dist/http/client.js

@@ -1,26 +1,56 @@
 /**
- * X402FetchClient - Fetch-based HTTP client with automatic 402 payment handling
+ * X402FetchClient — Fetch-based HTTP client with automatic 402 payment handling.
+ *
+ * Mirrors `bankofai.x402.clients.X402HttpClient` on the Python side. Wraps the
+ * global `fetch` (configurable for tests) so agent code can call any URL and
+ * have 402 challenges silently handled — challenge → sign → retry → return
+ * the final 200 response, with the settled payment receipt parseable via
+ * {@link parsePaymentResponseHeader}.
  */
-import { encodePaymentPayload, decodePaymentPayload, } from '../index.js';
-/** HTTP headers for x402 protocol */
-const PAYMENT_SIGNATURE_HEADER = 'PAYMENT-SIGNATURE';
-const PAYMENT_REQUIRED_HEADER = 'PAYMENT-REQUIRED';
-const PAYMENT_RESPONSE_HEADER = 'PAYMENT-RESPONSE';
+import { decodePaymentPayload, encodePaymentPayload, } from '../index.js';
+/** Wire-format header names. */
+export const PAYMENT_SIGNATURE_HEADER = 'PAYMENT-SIGNATURE';
+export const PAYMENT_REQUIRED_HEADER = 'PAYMENT-REQUIRED';
+export const PAYMENT_RESPONSE_HEADER = 'PAYMENT-RESPONSE';
 /**
- * Fetch-based HTTP client with automatic 402 payment handling
+ * Fetch-based HTTP client with automatic 402 payment handling.
+ *
+ * @example
+ * ```ts
+ * const x402Client = new X402Client(...).register(mechanism);
+ * const httpClient = new X402FetchClient(x402Client);
+ *
+ * const res = await httpClient.get('https://api.example.com/llm');
+ * if (res.ok) {
+ *   const settled = parsePaymentResponseHeader(res);
+ *   console.log('paid via tx', settled?.transaction);
+ * }
+ * ```
  */
 export class X402FetchClient {
     x402Client;
     selector;
-    constructor(x402Client, selector) {
+    fetchImpl;
+    constructor(x402Client, selectorOrOptions) {
         this.x402Client = x402Client;
-        this.selector = selector;
+        if (typeof selectorOrOptions === 'function') {
+            this.selector = selectorOrOptions;
+            this.fetchImpl = fetch;
+        }
+        else {
+            this.selector = selectorOrOptions?.selector;
+            this.fetchImpl = selectorOrOptions?.fetchImpl ?? fetch;
+        }
     }
     /**
-     * Make request with automatic 402 payment handling
+     * Issue a request with automatic 402 → pay → retry handling.
+     *
+     * If the server returns a non-402 status, the response is passed through.
+     * If the 402 cannot be parsed (no PAYMENT-REQUIRED header and no parseable
+     * body), the original 402 is returned to the caller for inspection.
      */
     async request(url, init) {
-        const response = await fetch(url, init);
+        const response = await this.fetchImpl(url, init);
         if (response.status !== 402) {
             return response;
         }
@@ -31,20 +61,34 @@ export class X402FetchClient {
         const paymentPayload = await this.x402Client.handlePayment(paymentRequired.accepts, url, paymentRequired.extensions, this.selector);
         return this.retryWithPayment(url, init, paymentPayload);
     }
-    /**
-     * GET request with payment handling
-     */
+    /** GET shorthand. */
     async get(url, init) {
         return this.request(url, { ...init, method: 'GET' });
     }
-    /**
-     * POST request with payment handling
-     */
+    /** POST shorthand. */
     async post(url, body, init) {
         return this.request(url, { ...init, method: 'POST', body });
     }
+    /** PUT shorthand. */
+    async put(url, body, init) {
+        return this.request(url, { ...init, method: 'PUT', body });
+    }
+    /** PATCH shorthand. */
+    async patch(url, body, init) {
+        return this.request(url, { ...init, method: 'PATCH', body });
+    }
+    /** DELETE shorthand. */
+    async delete(url, init) {
+        return this.request(url, { ...init, method: 'DELETE' });
+    }
     /**
-     * Parse PaymentRequired from 402 response
+     * Try to parse a `PaymentRequired` from the 402 response.
+     *
+     * Order:
+     * 1. `PAYMENT-REQUIRED` header (base64 JSON).
+     * 2. JSON body fallback when header is missing or undecodable.
+     *
+     * Returns `null` if neither path yields a recognizable shape.
      */
     async parsePaymentRequired(response) {
         const headerValue = response.headers.get(PAYMENT_REQUIRED_HEADER);
@@ -53,31 +97,46 @@ export class X402FetchClient {
                 return decodePaymentPayload(headerValue);
             }
             catch {
-                // Continue to parse body
+                // Header malformed — fall through to body.
             }
         }
         try {
-            const body = await response.json();
-            if (body.accepts && Array.isArray(body.accepts)) {
+            const body = (await response.clone().json());
+            if (Array.isArray(body.accepts)) {
                 return body;
             }
         }
         catch {
-            // Unable to parse
+            // Body not parseable — give up.
         }
         return null;
     }
-    /**
-     * Retry request with payment payload
-     */
+    /** Re-issue the original request with the encoded payment payload header. */
     async retryWithPayment(url, init, paymentPayload) {
-        const encodedPayload = encodePaymentPayload(paymentPayload);
+        const encoded = encodePaymentPayload(paymentPayload);
         const headers = new Headers(init?.headers);
-        headers.set(PAYMENT_SIGNATURE_HEADER, encodedPayload);
-        return fetch(url, {
-            ...init,
-            headers,
-        });
+        headers.set(PAYMENT_SIGNATURE_HEADER, encoded);
+        return this.fetchImpl(url, { ...init, headers });
+    }
+}
+/**
+ * Pull the {@link SettleResponse} out of a 200 response's PAYMENT-RESPONSE header.
+ *
+ * Servers attach this on success so the client can record the settlement tx
+ * hash / network without making a separate facilitator call.
+ *
+ * @returns The decoded settle response, or `null` if the header is absent or malformed.
+ */
+export function parsePaymentResponseHeader(response) {
+    const headerValue = response.headers.get(PAYMENT_RESPONSE_HEADER);
+    if (!headerValue) {
+        return null;
+    }
+    try {
+        return decodePaymentPayload(headerValue);
+    }
+    catch {
+        return null;
     }
 }
 //# sourceMappingURL=client.js.map

package/dist/http/client.js.map

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

package/dist/index.d.ts

@@ -12,9 +12,16 @@ export * from './errors.js';
 export * from './tokens.js';
 export * from './address.js';
 export * from './http/client.js';
+export * from './facilitator/index.js';
+export * from './server/index.js';
+export * from './middleware/index.js';
 export * from './mechanisms/index.js';
-export * from './mechanisms/exactEvm.js';
+export * from './mechanisms/evm/exact_permit/index.js';
 export * from './signers/signer.js';
 export * from './signers/evmSigner.js';
 export type { TronWeb, TypedDataDomain, TypedDataField, TronNetwork, TRON_CHAIN_IDS } from './signers/types.js';
+export { FacilitatorSigner } from './signers/facilitator/base.js';
+export type { FacilitatorTypedDataDomain, FacilitatorTypedDataTypes, FacilitatorTransactionReceipt, } from './signers/index.js';
+export { TronFacilitatorSigner } from './signers/facilitator/tronSigner.js';
+export { EvmFacilitatorSigner } from './signers/facilitator/evmSigner.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,cAAc,mBAAmB,CAAC;AAClC,cAAc,kBAAkB,CAAC;AACjC,cAAc,kBAAkB,CAAC;AACjC,cAAc,UAAU,CAAC;AACzB,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC;AAC5B,cAAc,cAAc,CAAC;AAG7B,cAAc,kBAAkB,CAAC;AAGjC,cAAc,uBAAuB,CAAC;AAGtC,cAAc,0BAA0B,CAAC;AAGzC,cAAc,qBAAqB,CAAC;AAEpC,cAAc,wBAAwB,CAAC;AACvC,YAAY,EAAE,OAAO,EAAE,eAAe,EAAE,cAAc,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,cAAc,mBAAmB,CAAC;AAClC,cAAc,kBAAkB,CAAC;AACjC,cAAc,kBAAkB,CAAC;AACjC,cAAc,UAAU,CAAC;AACzB,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC;AAC5B,cAAc,cAAc,CAAC;AAG7B,cAAc,kBAAkB,CAAC;AAGjC,cAAc,wBAAwB,CAAC;AAGvC,cAAc,mBAAmB,CAAC;AAGlC,cAAc,uBAAuB,CAAC;AAGtC,cAAc,uBAAuB,CAAC;AAGtC,cAAc,wCAAwC,CAAC;AAGvD,cAAc,qBAAqB,CAAC;AAEpC,cAAc,wBAAwB,CAAC;AACvC,YAAY,EAAE,OAAO,EAAE,eAAe,EAAE,cAAc,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAGhH,OAAO,EAAE,iBAAiB,EAAE,MAAM,+BAA+B,CAAC;AAClE,YAAY,EACV,0BAA0B,EAC1B,yBAAyB,EACzB,6BAA6B,GAC9B,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAE,qBAAqB,EAAE,MAAM,qCAAqC,CAAC;AAC5E,OAAO,EAAE,oBAAoB,EAAE,MAAM,oCAAoC,CAAC"}