@oobe-protocol-labs/synapse-client-sdk 1.0.0-beta → 1.0.2

package/dist/esm/ai/gateway/x402/client.js

@@ -0,0 +1,460 @@
+/**
+ * @module ai/gateway/x402/client
+ * @description x402 Client — Buyer-side x402 payment handler.
+ *
+ * When an agent acts as a BUYER and receives a 402 Payment Required
+ * response, this module handles:
+ *  1. Detecting 402 responses and extracting PaymentRequired headers
+ *  2. Selecting the best matching PaymentRequirements from accepts[]
+ *  3. Calling the developer-provided signer to create a PaymentPayload
+ *  4. Retrying the request with the PAYMENT-SIGNATURE header
+ *  5. Decoding the PAYMENT-RESPONSE header from the final 200 response
+ *
+ * The module is transport-agnostic: works as a fetch wrapper, a middleware,
+ * or integrated into the AgentGateway's execute() pipeline.
+ *
+ * @since 1.0.0
+ */
+import { X402_HEADER_PAYMENT_REQUIRED, X402_HEADER_PAYMENT_SIGNATURE, X402_HEADER_PAYMENT_RESPONSE, X402_STATUS_CODE, } from './types.js';
+/* ═══════════════════════════════════════════════════════════════
+ *  Encoding helpers (re-export from paywall, keep self-contained)
+ * ═══════════════════════════════════════════════════════════════ */
+function encodePaymentHeader(obj) {
+    return Buffer.from(JSON.stringify(obj)).toString('base64');
+}
+function decodePaymentHeader(base64) {
+    return JSON.parse(Buffer.from(base64, 'base64').toString('utf-8'));
+}
+/* ═══════════════════════════════════════════════════════════════
+ *  Errors
+ * ═══════════════════════════════════════════════════════════════ */
+/**
+ * @description Base error class for x402 client-side errors.
+ * @since 1.0.0
+ */
+export class X402ClientError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = 'X402ClientError';
+    }
+}
+/**
+ * @description Error thrown when no acceptable payment method is found in the 402 response.
+ * @since 1.0.0
+ */
+export class NoAcceptablePaymentError extends X402ClientError {
+    paymentRequired;
+    reason;
+    /**
+     * @description Create a NoAcceptablePaymentError.
+     * @param {X402PaymentRequired} paymentRequired - The full 402 response
+     * @param {string} reason - Why no payment method was acceptable
+     * @since 1.0.0
+     */
+    constructor(paymentRequired, reason) {
+        super(`No acceptable payment method found: ${reason}`);
+        this.paymentRequired = paymentRequired;
+        this.reason = reason;
+        this.name = 'NoAcceptablePaymentError';
+    }
+}
+/**
+ * @description Error thrown when signing a payment payload fails.
+ * @since 1.0.0
+ */
+export class PaymentSigningError extends X402ClientError {
+    requirements;
+    cause;
+    /**
+     * @description Create a PaymentSigningError.
+     * @param {X402PaymentRequirements} requirements - The requirements being signed
+     * @param {unknown} cause - The underlying error
+     * @since 1.0.0
+     */
+    constructor(requirements, cause) {
+        super(`Failed to sign payment: ${cause instanceof Error ? cause.message : String(cause)}`);
+        this.requirements = requirements;
+        this.cause = cause;
+        this.name = 'PaymentSigningError';
+    }
+}
+/**
+ * @description Error thrown when the payment retry request fails with a non-402 status.
+ * @since 1.0.0
+ */
+export class PaymentRetryError extends X402ClientError {
+    statusCode;
+    body;
+    /**
+     * @description Create a PaymentRetryError.
+     * @param {number} statusCode - The HTTP status code of the failed retry
+     * @param {unknown} body - The response body
+     * @since 1.0.0
+     */
+    constructor(statusCode, body) {
+        super(`Payment retry failed with status ${statusCode}`);
+        this.statusCode = statusCode;
+        this.body = body;
+        this.name = 'PaymentRetryError';
+    }
+}
+/* ═══════════════════════════════════════════════════════════════
+ *  Default requirements selector
+ * ═══════════════════════════════════════════════════════════════ */
+/**
+ * @description Default selection logic:
+ * 1. Filter by preferred network (if set)
+ * 2. Filter by preferred asset (if set)
+ * 3. Filter by maxAmountPerCall (if set)
+ * 4. Pick the cheapest remaining option
+ *
+ * @param {X402PaymentRequirements[]} accepts - Available payment options from the 402 response
+ * @param {X402ClientConfig} config - Client configuration with preferences
+ * @returns {X402PaymentRequirements | undefined} The selected requirements, or undefined if none match
+ * @since 1.0.0
+ */
+export function defaultRequirementsSelector(accepts, config) {
+    let candidates = [...accepts];
+    // Filter by network
+    if (config.preferredNetwork) {
+        const networkFiltered = candidates.filter(r => r.network === config.preferredNetwork);
+        if (networkFiltered.length > 0)
+            candidates = networkFiltered;
+    }
+    // Filter by asset
+    if (config.preferredAsset) {
+        const assetFiltered = candidates.filter(r => r.asset === config.preferredAsset);
+        if (assetFiltered.length > 0)
+            candidates = assetFiltered;
+    }
+    // Filter by max amount
+    if (config.maxAmountPerCall) {
+        const maxAmount = BigInt(config.maxAmountPerCall);
+        candidates = candidates.filter(r => BigInt(r.amount) <= maxAmount);
+    }
+    if (candidates.length === 0)
+        return undefined;
+    // Pick cheapest
+    candidates.sort((a, b) => {
+        const diff = BigInt(a.amount) - BigInt(b.amount);
+        return diff < 0n ? -1 : diff > 0n ? 1 : 0;
+    });
+    return candidates[0];
+}
+/* ═══════════════════════════════════════════════════════════════
+ *  X402Client
+ * ═══════════════════════════════════════════════════════════════ */
+/**
+ * @description Buyer-side x402 client.
+ *
+ * Wraps outgoing HTTP requests to automatically handle 402 Payment Required
+ * responses by signing a payment and retrying.
+ *
+ * @example
+ * ```ts
+ * const x402Client = new X402Client({
+ *   enabled: true,
+ *   signer: async (requirements, resource) => {
+ *     // Build and sign a Solana transaction
+ *     return { x402Version: 2, accepted: requirements, resource, payload: { transaction: '...' } };
+ *   },
+ *   preferredNetwork: SOLANA_MAINNET,
+ *   preferredAsset: USDC_MAINNET,
+ *   maxAmountPerCall: '100000', // 0.1 USDC max
+ * });
+ *
+ * // Wrap a fetch call
+ * const result = await x402Client.fetch('https://rpc-gateway.example/rpc', {
+ *   method: 'POST',
+ *   body: JSON.stringify({ jsonrpc: '2.0', method: 'getBalance', params: ['...'], id: 1 }),
+ * });
+ * ```
+ *
+ * @since 1.0.0
+ */
+export class X402Client {
+    config;
+    selector;
+    /** Running tally of total amount paid (in atomic units, per-asset) */
+    totalPaid = new Map(); // asset → total
+    paymentCount = 0;
+    /**
+     * @description Create a new X402Client.
+     * @param {X402ClientConfig} config - Client configuration including signer, preferences, and budget
+     * @since 1.0.0
+     */
+    constructor(config) {
+        this.config = config;
+        this.selector = config.requirementsSelector ?? defaultRequirementsSelector;
+    }
+    /* ── Main fetch wrapper ──────────────────────────────────── */
+    /**
+     * @description Perform an HTTP request with automatic x402 payment handling.
+     *
+     * If the server responds with 402, the client:
+     * 1. Decodes PaymentRequired from the header
+     * 2. Selects requirements
+     * 3. Calls the signer
+     * 4. Retries with PAYMENT-SIGNATURE header
+     *
+     * @param {string} url - Target URL
+     * @param {RequestInit} [init] - Fetch options
+     * @returns {Promise<{ response: Response; payment: X402PaymentOutcome | null }>} Response + optional PaymentOutcome
+     * @throws {PaymentRetryError} If the retry response is not 402 but still not OK
+     * @throws {X402ClientError} If max retries are exceeded
+     * @since 1.0.0
+     */
+    async fetch(url, init) {
+        if (!this.config.enabled || this.config.autoDetect === false) {
+            const response = await globalThis.fetch(url, init);
+            return { response, payment: null };
+        }
+        const maxRetries = this.config.maxRetries ?? 1;
+        for (let attempt = 0; attempt <= maxRetries; attempt++) {
+            const response = await globalThis.fetch(url, init);
+            // Not a 402 → return as-is
+            if (response.status !== X402_STATUS_CODE) {
+                // Check for PAYMENT-RESPONSE header (from a previous payment in this session)
+                const paymentResponseHeader = response.headers.get(X402_HEADER_PAYMENT_RESPONSE)
+                    ?? response.headers.get(X402_HEADER_PAYMENT_RESPONSE.toLowerCase());
+                return { response, payment: null };
+            }
+            // 402 → attempt payment
+            if (attempt >= maxRetries) {
+                return { response, payment: null };
+            }
+            const paymentResult = await this.handlePaymentRequired(response, url);
+            if (!paymentResult) {
+                return { response, payment: null };
+            }
+            // Retry with payment
+            const retryHeaders = new Headers(init?.headers);
+            retryHeaders.set(X402_HEADER_PAYMENT_SIGNATURE, encodePaymentHeader(paymentResult.paymentPayload));
+            const retryResponse = await globalThis.fetch(url, {
+                ...init,
+                headers: retryHeaders,
+            });
+            // Parse settlement from response
+            let settlement = null;
+            const paymentResponseRaw = retryResponse.headers.get(X402_HEADER_PAYMENT_RESPONSE)
+                ?? retryResponse.headers.get(X402_HEADER_PAYMENT_RESPONSE.toLowerCase());
+            if (paymentResponseRaw) {
+                try {
+                    settlement = decodePaymentHeader(paymentResponseRaw);
+                }
+                catch {
+                    // Ignore decode errors for the settlement header
+                }
+            }
+            if (retryResponse.ok) {
+                // Track payment
+                this.trackPayment(paymentResult.requirements);
+                return {
+                    response: retryResponse,
+                    payment: {
+                        settlement,
+                        paymentPayload: paymentResult.paymentPayload,
+                        requirements: paymentResult.requirements,
+                        amountPaid: paymentResult.requirements.amount,
+                    },
+                };
+            }
+            // If still 402 after payment, continue loop
+            if (retryResponse.status !== X402_STATUS_CODE) {
+                throw new PaymentRetryError(retryResponse.status, await retryResponse.text().catch(() => ''));
+            }
+        }
+        // Should not reach here, but just in case
+        throw new X402ClientError('Max x402 payment retries exceeded');
+    }
+    /* ── Transport-level interceptor ─────────────────────────── */
+    /**
+     * @description Process a raw 402 response (for integration with custom transports).
+     *
+     * Use this when you have a custom HTTP transport (like SynapseClient's
+     * HttpTransport) and want to intercept 402 responses.
+     *
+     * @param {number} statusCode - HTTP status code
+     * @param {Record<string, string>} headers - Response headers (key-value)
+     * @param {unknown} [body] - Response body (parsed JSON or raw string)
+     * @returns {Promise<{ shouldRetry: boolean; paymentSignatureHeader?: string; paymentPayload?: X402PaymentPayload; requirements?: X402PaymentRequirements }>} Whether to retry and the payment header to attach
+     * @throws {PaymentSigningError} If the signer fails
+     * @since 1.0.0
+     */
+    async interceptResponse(statusCode, headers, body) {
+        if (!this.config.enabled || statusCode !== X402_STATUS_CODE) {
+            return { shouldRetry: false };
+        }
+        // Extract payment required
+        const paymentRequiredRaw = headers[X402_HEADER_PAYMENT_REQUIRED]
+            ?? headers[X402_HEADER_PAYMENT_REQUIRED.toLowerCase()]
+            ?? headers['payment-required'];
+        if (!paymentRequiredRaw) {
+            return { shouldRetry: false };
+        }
+        const paymentRequired = decodePaymentHeader(paymentRequiredRaw);
+        // Select requirements
+        const requirements = this.selector(paymentRequired.accepts, this.config);
+        if (!requirements) {
+            return { shouldRetry: false };
+        }
+        // Budget check
+        if (this.config.budgetCheck) {
+            const canPay = await this.config.budgetCheck(requirements.amount, requirements.asset, requirements.network);
+            if (!canPay) {
+                return { shouldRetry: false };
+            }
+        }
+        // Amount check
+        if (this.config.maxAmountPerCall) {
+            if (BigInt(requirements.amount) > BigInt(this.config.maxAmountPerCall)) {
+                return { shouldRetry: false };
+            }
+        }
+        // Sign
+        const resource = paymentRequired.resource ?? {
+            url: '',
+            description: '',
+            mimeType: 'application/json',
+        };
+        try {
+            const paymentPayload = await this.config.signer(requirements, resource);
+            this.trackPayment(requirements);
+            return {
+                shouldRetry: true,
+                paymentSignatureHeader: encodePaymentHeader(paymentPayload),
+                paymentPayload,
+                requirements,
+            };
+        }
+        catch (err) {
+            throw new PaymentSigningError(requirements, err);
+        }
+    }
+    /**
+     * @description Parse a PAYMENT-RESPONSE header from a successful response.
+     * @param {Record<string, string>} headers - Response headers containing the payment response
+     * @returns {X402SettlementResponse | null} The parsed settlement response, or null if not present
+     * @since 1.0.0
+     */
+    parseSettlementResponse(headers) {
+        const raw = headers[X402_HEADER_PAYMENT_RESPONSE]
+            ?? headers[X402_HEADER_PAYMENT_RESPONSE.toLowerCase()]
+            ?? headers['payment-response'];
+        if (!raw)
+            return null;
+        try {
+            return decodePaymentHeader(raw);
+        }
+        catch {
+            return null;
+        }
+    }
+    /* ── Internal helpers ────────────────────────────────────── */
+    async handlePaymentRequired(response, _url) {
+        // Extract PaymentRequired from header
+        const paymentRequiredRaw = response.headers.get(X402_HEADER_PAYMENT_REQUIRED)
+            ?? response.headers.get(X402_HEADER_PAYMENT_REQUIRED.toLowerCase());
+        if (!paymentRequiredRaw) {
+            // Fallback: try to parse from body
+            try {
+                const body = await response.clone().json();
+                if (body?.accepts?.length > 0) {
+                    return this.selectAndSign(body);
+                }
+            }
+            catch {
+                // Not a valid x402 response
+            }
+            return null;
+        }
+        const paymentRequired = decodePaymentHeader(paymentRequiredRaw);
+        return this.selectAndSign(paymentRequired);
+    }
+    async selectAndSign(paymentRequired) {
+        // Select requirements
+        const requirements = this.selector(paymentRequired.accepts, this.config);
+        if (!requirements) {
+            return null;
+        }
+        // Budget check
+        if (this.config.budgetCheck) {
+            const canPay = await this.config.budgetCheck(requirements.amount, requirements.asset, requirements.network);
+            if (!canPay)
+                return null;
+        }
+        // Amount check
+        if (this.config.maxAmountPerCall) {
+            if (BigInt(requirements.amount) > BigInt(this.config.maxAmountPerCall)) {
+                return null;
+            }
+        }
+        // Sign
+        const resource = paymentRequired.resource ?? {
+            url: '',
+            description: '',
+            mimeType: 'application/json',
+        };
+        try {
+            const paymentPayload = await this.config.signer(requirements, resource);
+            return { paymentPayload, requirements };
+        }
+        catch (err) {
+            throw new PaymentSigningError(requirements, err);
+        }
+    }
+    trackPayment(requirements) {
+        const key = `${requirements.network}:${requirements.asset}`;
+        const current = this.totalPaid.get(key) ?? 0n;
+        this.totalPaid.set(key, current + BigInt(requirements.amount));
+        this.paymentCount++;
+    }
+    /* ── Public stats ────────────────────────────────────────── */
+    /**
+     * @description Total payments made in this client instance.
+     * @returns {number} Number of completed payments
+     * @since 1.0.0
+     */
+    get payments() {
+        return this.paymentCount;
+    }
+    /**
+     * @description Total amount paid per asset (network:asset → bigint).
+     * @returns {ReadonlyMap<string, bigint>} Map of asset keys to total amounts paid
+     * @since 1.0.0
+     */
+    get totalAmountPaid() {
+        return this.totalPaid;
+    }
+    /**
+     * @description Get total paid for a specific asset on a network.
+     * @param {X402Network} network - The CAIP-2 network identifier
+     * @param {string} asset - The token contract address
+     * @returns {bigint} Total amount paid in atomic units
+     * @since 1.0.0
+     */
+    getTotalPaid(network, asset) {
+        return this.totalPaid.get(`${network}:${asset}`) ?? 0n;
+    }
+    /**
+     * @description Check if auto-pay is enabled.
+     * @returns {boolean} Whether the client is enabled for automatic payments
+     * @since 1.0.0
+     */
+    get isEnabled() {
+        return this.config.enabled;
+    }
+}
+/* ═══════════════════════════════════════════════════════════════
+ *  Factory
+ * ═══════════════════════════════════════════════════════════════ */
+/**
+ * @description Create an X402Client with the provided configuration.
+ * @param {X402ClientConfig} config - Client configuration
+ * @returns {X402Client} A new X402Client instance
+ * @since 1.0.0
+ */
+export function createX402Client(config) {
+    return new X402Client(config);
+}
+//# sourceMappingURL=client.js.map

package/dist/esm/ai/gateway/x402/client.js.map

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

package/dist/esm/ai/gateway/x402/facilitator.d.ts

@@ -0,0 +1,169 @@
+/**
+ * @module ai/gateway/x402/facilitator
+ * @description x402 Facilitator Client — HTTP client for the x402 facilitator service.
+ *
+ * The facilitator is a third-party service that:
+ *  1. Verifies payment payloads (checks signatures, balances, allowances)
+ *  2. Settles payments on-chain (co-signs, submits, confirms)
+ *  3. Reports supported payment kinds (scheme + network pairs)
+ *
+ * Supports both direct URL config and known facilitator selection:
+ *
+ * @example
+ * ```ts
+ * // Known facilitator (one-liner)
+ * const f = createFacilitator(KnownFacilitator.PayAI);
+ *
+ * // Custom URL
+ * const f = createFacilitator({ url: 'https://my-facilitator.com' });
+ * ```
+ *
+ * @since 1.0.0
+ */
+import type { X402FacilitatorConfig, X402PaymentPayload, X402PaymentRequirements, X402VerifyResponse, X402SettleResponse, X402SupportedResponse } from './types';
+import { KnownFacilitator } from './types';
+/**
+ * @description Error thrown by the FacilitatorClient when a request fails.
+ * @since 1.0.0
+ */
+export declare class FacilitatorError extends Error {
+    readonly endpoint: string;
+    readonly statusCode: number;
+    readonly responseBody?: unknown | undefined;
+    constructor(message: string, endpoint: string, statusCode: number, responseBody?: unknown | undefined);
+}
+/**
+ * @description Error thrown when payment verification fails at the facilitator.
+ * @since 1.0.0
+ */
+export declare class VerifyError extends FacilitatorError {
+    constructor(statusCode: number, response: X402VerifyResponse);
+}
+/**
+ * @description Error thrown when payment settlement fails at the facilitator.
+ * @since 1.0.0
+ */
+export declare class SettleError extends FacilitatorError {
+    constructor(statusCode: number, response: X402SettleResponse);
+}
+/**
+ * @description HTTP client for an x402 facilitator.
+ *
+ * @example
+ * ```ts
+ * // From known facilitator enum
+ * const facilitator = new FacilitatorClient(KnownFacilitator.PayAI);
+ *
+ * // From config object
+ * const facilitator = new FacilitatorClient({
+ *   url: 'https://x402.org/facilitator',
+ *   createAuthHeaders: async () => ({
+ *     verify: { Authorization: 'Bearer ...' },
+ *     settle: { Authorization: 'Bearer ...' },
+ *     supported: {},
+ *   }),
+ * });
+ *
+ * const verifyResult = await facilitator.verify(payload, requirements);
+ * const settleResult = await facilitator.settle(payload, requirements);
+ * const supported = await facilitator.supported();
+ * ```
+ *
+ * @since 1.0.0
+ */
+export declare class FacilitatorClient {
+    private readonly url;
+    private readonly config;
+    /** @description The known facilitator id if one was used, otherwise undefined @since 1.0.0 */
+    readonly knownFacilitator?: KnownFacilitator;
+    /**
+     * @description Create a new FacilitatorClient.
+     * @param {KnownFacilitator | Partial<X402FacilitatorConfig>} [config] - Known facilitator enum or custom config. Defaults to PayAI free tier.
+     * @since 1.0.0
+     */
+    constructor(config?: KnownFacilitator | Partial<X402FacilitatorConfig>);
+    /**
+     * @description Verify a payment payload against requirements.
+     * POST /verify
+     *
+     * @param {X402PaymentPayload} paymentPayload - The client's signed payment payload
+     * @param {X402PaymentRequirements} paymentRequirements - The accepted payment requirements
+     * @returns {Promise<X402VerifyResponse>} Verification result
+     * @throws {VerifyError} If verification fails
+     * @since 1.0.0
+     */
+    verify(paymentPayload: X402PaymentPayload, paymentRequirements: X402PaymentRequirements): Promise<X402VerifyResponse>;
+    /**
+     * @description Settle a verified payment on-chain.
+     * POST /settle
+     *
+     * @param {X402PaymentPayload} paymentPayload - The client's signed payment payload
+     * @param {X402PaymentRequirements} paymentRequirements - The accepted payment requirements
+     * @returns {Promise<X402SettleResponse>} Settlement result with on-chain tx signature
+     * @throws {SettleError} If settlement fails
+     * @since 1.0.0
+     */
+    settle(paymentPayload: X402PaymentPayload, paymentRequirements: X402PaymentRequirements): Promise<X402SettleResponse>;
+    /**
+     * @description Query the facilitator for supported payment kinds.
+     * GET /supported
+     *
+     * @returns {Promise<X402SupportedResponse>} Supported scheme + network pairs (+ extra like feePayer)
+     * @throws {FacilitatorError} If the request fails
+     * @since 1.0.0
+     */
+    supported(): Promise<X402SupportedResponse>;
+    private getHeaders;
+    /**
+     * @description Fetch with timeout support via AbortController.
+     * @param {string} url - The URL to fetch
+     * @param {RequestInit} init - Fetch options
+     * @returns {Promise<Response>} The response
+     * @throws {FacilitatorError} On timeout
+     * @since 1.0.0
+     */
+    private fetch;
+    /**
+     * @description Ensure BigInt values are serialized as strings for JSON transport.
+     * @param {unknown} obj - The object to serialize
+     * @returns {unknown} A JSON-safe copy of the object
+     * @since 1.0.0
+     */
+    private toJsonSafe;
+    /**
+     * @description Get the configured facilitator URL.
+     * @returns {string} The facilitator base URL
+     * @since 1.0.0
+     */
+    get facilitatorUrl(): string;
+}
+/**
+ * @description Create a facilitator client from a known facilitator enum or custom config.
+ *
+ * @example
+ * ```ts
+ * import { createFacilitator, KnownFacilitator } from '@oobe-protocol-labs/synapse-client-sdk';
+ *
+ * // One-liner with a known facilitator
+ * const facilitator = createFacilitator(KnownFacilitator.PayAI);
+ * const facilitator = createFacilitator(KnownFacilitator.RelAI);
+ * const facilitator = createFacilitator(KnownFacilitator.Dexter);
+ * const facilitator = createFacilitator(KnownFacilitator.CDP);
+ *
+ * // Custom URL
+ * const facilitator = createFacilitator({ url: 'https://my-facilitator.com' });
+ *
+ * // Known facilitator + auth override
+ * const facilitator = createFacilitator(KnownFacilitator.PayAI);
+ * // Then set PAYAI_API_KEY_ID / PAYAI_API_KEY_SECRET env vars for production.
+ *
+ * // Default (PayAI free tier)
+ * const facilitator = createFacilitator();
+ * ```
+ *
+ * @param {KnownFacilitator | Partial<X402FacilitatorConfig>} [config] - Known facilitator or custom config
+ * @returns {FacilitatorClient} A new FacilitatorClient instance
+ * @since 1.0.0
+ */
+export declare function createFacilitator(config?: KnownFacilitator | Partial<X402FacilitatorConfig>): FacilitatorClient;
+//# sourceMappingURL=facilitator.d.ts.map

package/dist/esm/ai/gateway/x402/facilitator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"facilitator.d.ts","sourceRoot":"","sources":["../../../../../src/ai/gateway/x402/facilitator.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAEH,OAAO,KAAK,EACV,qBAAqB,EACrB,kBAAkB,EAClB,uBAAuB,EACvB,kBAAkB,EAClB,kBAAkB,EAClB,qBAAqB,EACtB,MAAM,SAAS,CAAC;AACjB,OAAO,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAC;AAc3C;;;GAGG;AACH,qBAAa,gBAAiB,SAAQ,KAAK;aAGvB,QAAQ,EAAE,MAAM;aAChB,UAAU,EAAE,MAAM;aAClB,YAAY,CAAC,EAAE,OAAO;gBAHtC,OAAO,EAAE,MAAM,EACC,QAAQ,EAAE,MAAM,EAChB,UAAU,EAAE,MAAM,EAClB,YAAY,CAAC,EAAE,OAAO,YAAA;CAKzC;AAED;;;GAGG;AACH,qBAAa,WAAY,SAAQ,gBAAgB;gBACnC,UAAU,EAAE,MAAM,EAAE,QAAQ,EAAE,kBAAkB;CAS7D;AAED;;;GAGG;AACH,qBAAa,WAAY,SAAQ,gBAAgB;gBACnC,UAAU,EAAE,MAAM,EAAE,QAAQ,EAAE,kBAAkB;CAS7D;AAMD;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAS;IAC7B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAwB;IAC/C,8FAA8F;IAC9F,SAAgB,gBAAgB,CAAC,EAAE,gBAAgB,CAAC;IAEpD;;;;OAIG;gBACS,MAAM,CAAC,EAAE,gBAAgB,GAAG,OAAO,CAAC,qBAAqB,CAAC;IAmBtE;;;;;;;;;OASG;IACG,MAAM,CACV,cAAc,EAAE,kBAAkB,EAClC,mBAAmB,EAAE,uBAAuB,GAC3C,OAAO,CAAC,kBAAkB,CAAC;IAuB9B;;;;;;;;;OASG;IACG,MAAM,CACV,cAAc,EAAE,kBAAkB,EAClC,mBAAmB,EAAE,uBAAuB,GAC3C,OAAO,CAAC,kBAAkB,CAAC;IAuB9B;;;;;;;OAOG;IACG,SAAS,IAAI,OAAO,CAAC,qBAAqB,CAAC;YAqBnC,UAAU;IAQxB;;;;;;;OAOG;YACW,KAAK;IA0BnB;;;;;OAKG;IACH,OAAO,CAAC,UAAU;IAQlB;;;;OAIG;IACH,IAAI,cAAc,IAAI,MAAM,CAE3B;CACF;AAMD;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,wBAAgB,iBAAiB,CAC/B,MAAM,CAAC,EAAE,gBAAgB,GAAG,OAAO,CAAC,qBAAqB,CAAC,GACzD,iBAAiB,CAEnB"}