@ic-pay/icpay-sdk 1.3.96 → 1.4.13

package/dist/x402/builders.d.ts

@@ -0,0 +1,60 @@
+import { Eip712Domain, TransferWithAuthorizationMessage, PermitMessage, X402Acceptance, X402Header } from './types';
+export declare function buildTransferWithAuthorizationTypedData(domain: Eip712Domain, message: TransferWithAuthorizationMessage): {
+    types: {
+        EIP712Domain: {
+            name: string;
+            type: string;
+        }[];
+        TransferWithAuthorization: {
+            name: string;
+            type: string;
+        }[];
+    };
+    domain: Eip712Domain;
+    primaryType: string;
+    message: TransferWithAuthorizationMessage;
+};
+export declare function buildPermitTypedData(domain: Eip712Domain, message: PermitMessage): {
+    types: {
+        EIP712Domain: {
+            name: string;
+            type: string;
+        }[];
+        Permit: {
+            name: string;
+            type: string;
+        }[];
+    };
+    domain: Eip712Domain;
+    primaryType: string;
+    message: PermitMessage;
+};
+export declare function encodeX402Header(header: X402Header): string;
+export declare function makeEip712Domain(params: {
+    name: string;
+    version: string;
+    chainId?: number;
+    verifyingContract: string;
+}): Eip712Domain;
+export declare function buildX402HeaderFromAuthorization(input: {
+    x402Version: number;
+    scheme: string;
+    network: string;
+    from: string;
+    to: string;
+    value: string;
+    validAfter: string;
+    validBefore: string;
+    nonce: string;
+    signature: string;
+}): X402Header;
+/**
+ * Build and sign an X402 payment header using an EVM wallet (eth_signTypedData_v4).
+ * Returns a base64-encoded header string suitable for the X402 settle endpoint.
+ */
+export declare function buildAndSignX402PaymentHeader(requirement: X402Acceptance, context?: {
+    x402Version?: number;
+    debug?: boolean;
+    provider?: any;
+}): Promise<string>;
+//# sourceMappingURL=builders.d.ts.map

package/dist/x402/builders.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"builders.d.ts","sourceRoot":"","sources":["../../src/x402/builders.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,gCAAgC,EAAE,aAAa,EAAE,cAAc,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAEpH,wBAAgB,uCAAuC,CACrD,MAAM,EAAE,YAAY,EACpB,OAAO,EAAE,gCAAgC;;;;;;;;;;;;;;EAwB1C;AAED,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,YAAY,EAAE,OAAO,EAAE,aAAa;;;;;;;;;;;;;;EAsBhF;AAED,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,UAAU,GAAG,MAAM,CAO3D;AAED,wBAAgB,gBAAgB,CAAC,MAAM,EAAE;IACvC,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,iBAAiB,EAAE,MAAM,CAAC;CAC3B,GAAG,YAAY,CAOf;AAED,wBAAgB,gCAAgC,CAAC,KAAK,EAAE;IACtD,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;CACnB,GAAG,UAAU,CAiBb;AAED;;;GAGG;AACH,wBAAsB,6BAA6B,CACjD,WAAW,EAAE,cAAc,EAC3B,OAAO,CAAC,EAAE;IAAE,WAAW,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,OAAO,CAAC;IAAC,QAAQ,CAAC,EAAE,GAAG,CAAA;CAAE,GAClE,OAAO,CAAC,MAAM,CAAC,CAmHjB"}

package/dist/x402/builders.js

@@ -0,0 +1,210 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.buildTransferWithAuthorizationTypedData = buildTransferWithAuthorizationTypedData;
+exports.buildPermitTypedData = buildPermitTypedData;
+exports.encodeX402Header = encodeX402Header;
+exports.makeEip712Domain = makeEip712Domain;
+exports.buildX402HeaderFromAuthorization = buildX402HeaderFromAuthorization;
+exports.buildAndSignX402PaymentHeader = buildAndSignX402PaymentHeader;
+function buildTransferWithAuthorizationTypedData(domain, message) {
+    const types = {
+        EIP712Domain: [
+            { name: 'name', type: 'string' },
+            { name: 'version', type: 'string' },
+            { name: 'chainId', type: 'uint256' },
+            { name: 'verifyingContract', type: 'address' },
+        ],
+        TransferWithAuthorization: [
+            { name: 'from', type: 'address' },
+            { name: 'to', type: 'address' },
+            { name: 'value', type: 'uint256' },
+            { name: 'validAfter', type: 'uint256' },
+            { name: 'validBefore', type: 'uint256' },
+            { name: 'nonce', type: 'bytes32' },
+        ],
+    };
+    return {
+        types,
+        domain,
+        primaryType: 'TransferWithAuthorization',
+        message,
+    };
+}
+function buildPermitTypedData(domain, message) {
+    const types = {
+        EIP712Domain: [
+            { name: 'name', type: 'string' },
+            { name: 'version', type: 'string' },
+            { name: 'chainId', type: 'uint256' },
+            { name: 'verifyingContract', type: 'address' },
+        ],
+        Permit: [
+            { name: 'owner', type: 'address' },
+            { name: 'spender', type: 'address' },
+            { name: 'value', type: 'uint256' },
+            { name: 'nonce', type: 'uint256' },
+            { name: 'deadline', type: 'uint256' },
+        ],
+    };
+    return {
+        types,
+        domain,
+        primaryType: 'Permit',
+        message,
+    };
+}
+function encodeX402Header(header) {
+    const json = JSON.stringify(header);
+    try {
+        return btoa(json);
+    }
+    catch {
+        return Buffer.from(json, 'utf8').toString('base64');
+    }
+}
+function makeEip712Domain(params) {
+    return {
+        name: String(params.name),
+        version: String(params.version),
+        chainId: typeof params.chainId === 'number' ? params.chainId : undefined,
+        verifyingContract: String(params.verifyingContract),
+    };
+}
+function buildX402HeaderFromAuthorization(input) {
+    return {
+        x402Version: Number(input.x402Version || 1),
+        scheme: String(input.scheme || 'exact'),
+        network: String(input.network || ''),
+        payload: {
+            authorization: {
+                from: input.from,
+                to: input.to,
+                value: input.value,
+                validAfter: input.validAfter,
+                validBefore: input.validBefore,
+                nonce: input.nonce,
+            },
+            signature: input.signature,
+        },
+    };
+}
+/**
+ * Build and sign an X402 payment header using an EVM wallet (eth_signTypedData_v4).
+ * Returns a base64-encoded header string suitable for the X402 settle endpoint.
+ */
+async function buildAndSignX402PaymentHeader(requirement, context) {
+    const w = globalThis?.window || globalThis;
+    const eth = context?.provider || w?.ethereum;
+    if (!eth || !eth.request) {
+        throw new Error('No EVM wallet available for X402');
+    }
+    // Ensure wallet is on the intended chain for reliable eth_call (token name) and consistent UX
+    try {
+        const netStr = requirement?.network || '';
+        const chainIdDec = typeof netStr === 'string' ? parseInt(netStr, 10) : Number(netStr || 0);
+        if (Number.isFinite(chainIdDec) && chainIdDec > 0) {
+            const hex = '0x' + chainIdDec.toString(16);
+            try {
+                const currentHex = await eth.request({ method: 'eth_chainId' });
+                if (typeof currentHex !== 'string' || currentHex.toLowerCase() !== hex.toLowerCase()) {
+                    await eth.request({ method: 'wallet_switchEthereumChain', params: [{ chainId: hex }] });
+                }
+            }
+            catch {
+                // Best-effort: if switch fails, continue; signing does not require chain match,
+                // but eth_call for token name may fail. We'll handle that gracefully.
+            }
+        }
+    }
+    catch { }
+    const accounts = await eth.request({ method: 'eth_requestAccounts' });
+    const from = (accounts && accounts[0]) || '';
+    if (!from)
+        throw new Error('No wallet account available for X402');
+    const nowSec = Math.floor(Date.now() / 1000);
+    const validAfter = (nowSec - 86400).toString();
+    const validBefore = (nowSec + Number(requirement?.maxTimeoutSeconds || 300)).toString();
+    // Generate 32-byte nonce (prefer secure sources)
+    let nonceBytes;
+    try {
+        if (w?.crypto?.getRandomValues) {
+            nonceBytes = w.crypto.getRandomValues(new Uint8Array(32));
+        }
+        else {
+            // Try Node crypto for non-browser environments
+            // eslint-disable-next-line @typescript-eslint/no-var-requires
+            const nodeCrypto = typeof require === 'function' ? require('crypto') : null;
+            nonceBytes = nodeCrypto?.randomBytes ? nodeCrypto.randomBytes(32) : new Uint8Array(32);
+            if (!nodeCrypto?.randomBytes) {
+                for (let i = 0; i < nonceBytes.length; i++) {
+                    nonceBytes[i] = Math.floor(Math.random() * 256);
+                }
+            }
+        }
+    }
+    catch {
+        nonceBytes = new Uint8Array(32);
+        for (let i = 0; i < nonceBytes.length; i++) {
+            nonceBytes[i] = Math.floor(Math.random() * 256);
+        }
+    }
+    const bytesArr = Array.from(nonceBytes);
+    const nonce = '0x' + bytesArr.map(b => b.toString(16).padStart(2, '0')).join('');
+    const extra = (requirement?.extra || {});
+    const primaryType = String(extra?.primaryType || 'TransferWithAuthorization');
+    const domain = makeEip712Domain({
+        name: String(extra?.name || 'Token'),
+        version: String(extra?.eip3009Version || '1'),
+        chainId: Number(requirement?.network || 0) || undefined,
+        verifyingContract: String(requirement?.asset || requirement?.payTo || ''),
+    });
+    const typedData = primaryType === 'Permit'
+        ? buildPermitTypedData(domain, {
+            owner: from,
+            spender: String(requirement?.payTo || ''),
+            value: String(requirement?.maxAmountRequired || '0'),
+            nonce: String(BigInt(nonce)),
+            deadline: String(validBefore),
+        })
+        : buildTransferWithAuthorizationTypedData(domain, {
+            from,
+            to: String(requirement?.payTo || ''),
+            value: String(requirement?.maxAmountRequired || '0'),
+            validAfter: String(validAfter),
+            validBefore: String(validBefore),
+            nonce,
+        });
+    if (context?.debug) {
+        try {
+            // eslint-disable-next-line no-console
+            console.debug('X402 EIP-712 typedData (pre-sign)', {
+                domain,
+                primaryType: typedData.primaryType,
+                verifyingContract: domain.verifyingContract,
+                chainId: domain.chainId,
+                types: Object.keys((typedData.types || {})),
+                message: typedData.message,
+            });
+        }
+        catch { }
+    }
+    const payload = JSON.stringify(typedData);
+    const signature = await eth.request({
+        method: 'eth_signTypedData_v4',
+        params: [from, payload],
+    });
+    const headerObj = buildX402HeaderFromAuthorization({
+        x402Version: Number(context?.x402Version || 1),
+        scheme: String(requirement?.scheme || 'exact'),
+        network: String(requirement?.network || ''),
+        from,
+        to: String(requirement?.payTo || ''),
+        value: String(requirement?.maxAmountRequired || '0'),
+        validAfter: String(validAfter),
+        validBefore: String(validBefore),
+        nonce,
+        signature,
+    });
+    return encodeX402Header(headerObj);
+}
+//# sourceMappingURL=builders.js.map

package/dist/x402/builders.js.map

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

package/dist/x402/common.d.ts

@@ -0,0 +1,23 @@
+import type { ThirdwebClient } from "../client/client.js";
+import { type RequestedPaymentPayload, type RequestedPaymentRequirements } from "./schemas.js";
+import { type ERC20TokenAmount, type PaymentArgs, type PaymentRequiredResult, type SupportedSignatureType } from "./types.js";
+type GetPaymentRequirementsResult = {
+    status: 200;
+    paymentRequirements: RequestedPaymentRequirements[];
+    selectedPaymentRequirements: RequestedPaymentRequirements;
+    decodedPayment: RequestedPaymentPayload;
+};
+/**
+ * Decodes a payment request and returns the payment requirements, selected payment requirements, and decoded payment
+ * @param args
+ * @returns The payment requirements, selected payment requirements, and decoded payment
+ */
+export declare function decodePaymentRequest(args: PaymentArgs): Promise<GetPaymentRequirementsResult | PaymentRequiredResult>;
+export declare function getSupportedSignatureType(args: {
+    client: ThirdwebClient;
+    asset: string;
+    chainId: number;
+    eip712Extras: ERC20TokenAmount["asset"]["eip712"] | undefined;
+}): Promise<SupportedSignatureType | undefined>;
+export {};
+//# sourceMappingURL=common.d.ts.map

package/dist/x402/common.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"common.d.ts","sourceRoot":"","sources":["../../src/x402/common.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAM1D,OAAO,EAEL,KAAK,uBAAuB,EAC5B,KAAK,4BAA4B,EAClC,MAAM,cAAc,CAAC;AACtB,OAAO,EACL,KAAK,gBAAgB,EACrB,KAAK,WAAW,EAChB,KAAK,qBAAqB,EAC1B,KAAK,sBAAsB,EAE5B,MAAM,YAAY,CAAC;AAEpB,KAAK,4BAA4B,GAAG;IAClC,MAAM,EAAE,GAAG,CAAC;IACZ,mBAAmB,EAAE,4BAA4B,EAAE,CAAC;IACpD,2BAA2B,EAAE,4BAA4B,CAAC;IAC1D,cAAc,EAAE,uBAAuB,CAAC;CACzC,CAAC;AAEF;;;;GAIG;AACH,wBAAsB,oBAAoB,CACxC,IAAI,EAAE,WAAW,GAChB,OAAO,CAAC,4BAA4B,GAAG,qBAAqB,CAAC,CAgF/D;AAED,wBAAsB,yBAAyB,CAAC,IAAI,EAAE;IACpD,MAAM,EAAE,cAAc,CAAC;IACvB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,YAAY,EAAE,gBAAgB,CAAC,OAAO,CAAC,CAAC,QAAQ,CAAC,GAAG,SAAS,CAAC;CAC/D,GAAG,OAAO,CAAC,sBAAsB,GAAG,SAAS,CAAC,CAiC9C"}

package/dist/x402/common.js

@@ -0,0 +1,108 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.decodePaymentRequest = decodePaymentRequest;
+exports.getSupportedSignatureType = getSupportedSignatureType;
+const utils_1 = require("viem/utils");
+const utils_js_1 = require("../chains/utils.js");
+const resolve_abi_js_1 = require("../contract/actions/resolve-abi.js");
+const contract_js_1 = require("../contract/contract.js");
+const permit_js_1 = require("../extensions/erc20/__generated__/IERC20Permit/write/permit.js");
+const transferWithAuthorization_js_1 = require("../extensions/erc20/__generated__/USDC/write/transferWithAuthorization.js");
+const encode_js_1 = require("./encode.js");
+const schemas_js_1 = require("./schemas.js");
+const types_js_1 = require("./types.js");
+/**
+ * Decodes a payment request and returns the payment requirements, selected payment requirements, and decoded payment
+ * @param args
+ * @returns The payment requirements, selected payment requirements, and decoded payment
+ */
+async function decodePaymentRequest(args) {
+    const { price, network, facilitator, payTo, resourceUrl, routeConfig = {}, method, paymentData, extraMetadata, } = args;
+    const { errorMessages } = routeConfig;
+    const paymentRequirementsResult = await facilitator.accepts({
+        resourceUrl,
+        method,
+        network,
+        price,
+        routeConfig,
+        payTo,
+        extraMetadata,
+    });
+    // Check for payment header, if none, return the payment requirements
+    if (!paymentData) {
+        return paymentRequirementsResult;
+    }
+    const paymentRequirements = paymentRequirementsResult.responseBody.accepts;
+    // decode b64 payment
+    let decodedPayment;
+    try {
+        decodedPayment = (0, encode_js_1.decodePayment)(paymentData);
+        decodedPayment.x402Version = types_js_1.x402Version;
+    }
+    catch (error) {
+        return {
+            status: 402,
+            responseHeaders: {
+                "Content-Type": "application/json",
+            },
+            responseBody: {
+                x402Version: types_js_1.x402Version,
+                error: errorMessages?.invalidPayment ||
+                    (error instanceof Error ? error.message : "Invalid payment"),
+                accepts: paymentRequirements,
+            },
+        };
+    }
+    const selectedPaymentRequirements = paymentRequirements.find((value) => value.scheme === decodedPayment.scheme &&
+        (0, schemas_js_1.networkToCaip2ChainId)(value.network) ===
+            (0, schemas_js_1.networkToCaip2ChainId)(decodedPayment.network));
+    if (!selectedPaymentRequirements) {
+        return {
+            status: 402,
+            responseHeaders: {
+                "Content-Type": "application/json",
+            },
+            responseBody: {
+                x402Version: types_js_1.x402Version,
+                error: errorMessages?.noMatchingRequirements ||
+                    "Unable to find matching payment requirements",
+                accepts: paymentRequirements,
+            },
+        };
+    }
+    return {
+        status: 200,
+        paymentRequirements,
+        decodedPayment,
+        selectedPaymentRequirements,
+    };
+}
+async function getSupportedSignatureType(args) {
+    const primaryType = args.eip712Extras?.primaryType;
+    if (primaryType === "Permit" || primaryType === "TransferWithAuthorization") {
+        return primaryType;
+    }
+    // not specified, so we need to detect it
+    const abi = await (0, resolve_abi_js_1.resolveContractAbi)((0, contract_js_1.getContract)({
+        client: args.client,
+        address: args.asset,
+        chain: (0, utils_js_1.getCachedChain)(args.chainId),
+    })).catch((error) => {
+        console.error("Error resolving contract ABI", error);
+        return [];
+    });
+    const selectors = abi
+        .filter((f) => f.type === "function")
+        .map((f) => (0, utils_1.toFunctionSelector)(f));
+    const hasPermit = (0, permit_js_1.isPermitSupported)(selectors);
+    const hasTransferWithAuthorization = (0, transferWithAuthorization_js_1.isTransferWithAuthorizationSupported)(selectors);
+    // prefer transferWithAuthorization over permit
+    if (hasTransferWithAuthorization) {
+        return "TransferWithAuthorization";
+    }
+    if (hasPermit) {
+        return "Permit";
+    }
+    return undefined;
+}
+//# sourceMappingURL=common.js.map

package/dist/x402/common.js.map

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

package/dist/x402/encode.d.ts

@@ -0,0 +1,23 @@
+import { type RequestedPaymentPayload } from "./schemas.js";
+/**
+ * Encodes a payment payload into a base64 string, ensuring bigint values are properly stringified
+ *
+ * @param payment - The payment payload to encode
+ * @returns A base64 encoded string representation of the payment payload
+ */
+export declare function encodePayment(payment: RequestedPaymentPayload): string;
+/**
+ * Decodes a base64 encoded payment string back into a PaymentPayload object
+ *
+ * @param payment - The base64 encoded payment string to decode
+ * @returns The decoded and validated PaymentPayload object
+ */
+export declare function decodePayment(payment: string): RequestedPaymentPayload;
+/**
+ * Encodes a string to base64 format
+ *
+ * @param data - The string to be encoded to base64
+ * @returns The base64 encoded string
+ */
+export declare function safeBase64Encode(data: string): string;
+//# sourceMappingURL=encode.d.ts.map

package/dist/x402/encode.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"encode.d.ts","sourceRoot":"","sources":["../../src/x402/encode.ts"],"names":[],"mappings":"AACA,OAAO,EACL,KAAK,uBAAuB,EAE7B,MAAM,cAAc,CAAC;AAEtB;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,uBAAuB,GAAG,MAAM,CAkBtE;AAED;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,uBAAuB,CAUtE;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAQrD"}

package/dist/x402/encode.js

@@ -0,0 +1,71 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.encodePayment = encodePayment;
+exports.decodePayment = decodePayment;
+exports.safeBase64Encode = safeBase64Encode;
+const schemas_js_1 = require("./schemas.js");
+/**
+ * Encodes a payment payload into a base64 string, ensuring bigint values are properly stringified
+ *
+ * @param payment - The payment payload to encode
+ * @returns A base64 encoded string representation of the payment payload
+ */
+function encodePayment(payment) {
+    let safe;
+    // evm
+    const evmPayload = payment.payload;
+    safe = {
+        ...payment,
+        payload: {
+            ...evmPayload,
+            authorization: Object.fromEntries(Object.entries(evmPayload.authorization).map(([key, value]) => [
+                key,
+                typeof value === "bigint" ? value.toString() : value,
+            ])),
+        },
+    };
+    return safeBase64Encode(JSON.stringify(safe));
+}
+/**
+ * Decodes a base64 encoded payment string back into a PaymentPayload object
+ *
+ * @param payment - The base64 encoded payment string to decode
+ * @returns The decoded and validated PaymentPayload object
+ */
+function decodePayment(payment) {
+    const decoded = safeBase64Decode(payment);
+    const parsed = JSON.parse(decoded);
+    const obj = {
+        ...parsed,
+        payload: parsed.payload,
+    };
+    const validated = schemas_js_1.RequestedPaymentPayloadSchema.parse(obj);
+    return validated;
+}
+/**
+ * Encodes a string to base64 format
+ *
+ * @param data - The string to be encoded to base64
+ * @returns The base64 encoded string
+ */
+function safeBase64Encode(data) {
+    if (typeof globalThis !== "undefined" &&
+        typeof globalThis.btoa === "function") {
+        return globalThis.btoa(data);
+    }
+    return Buffer.from(data).toString("base64");
+}
+/**
+ * Decodes a base64 string back to its original format
+ *
+ * @param data - The base64 encoded string to be decoded
+ * @returns The decoded string in UTF-8 format
+ */
+function safeBase64Decode(data) {
+    if (typeof globalThis !== "undefined" &&
+        typeof globalThis.atob === "function") {
+        return globalThis.atob(data);
+    }
+    return Buffer.from(data, "base64").toString("utf-8");
+}
+//# sourceMappingURL=encode.js.map

package/dist/x402/encode.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"encode.js","sourceRoot":"","sources":["../../src/x402/encode.ts"],"names":[],"mappings":";;AAYA,sCAkBC;AAQD,sCAUC;AAQD,4CAQC;AA/DD,6CAGsB;AAEtB;;;;;GAKG;AACH,SAAgB,aAAa,CAAC,OAAgC;IAC5D,IAAI,IAA6B,CAAC;IAElC,MAAM;IACN,MAAM,UAAU,GAAG,OAAO,CAAC,OAA0B,CAAC;IACtD,IAAI,GAAG;QACL,GAAG,OAAO;QACV,OAAO,EAAE;YACP,GAAG,UAAU;YACb,aAAa,EAAE,MAAM,CAAC,WAAW,CAC/B,MAAM,CAAC,OAAO,CAAC,UAAU,CAAC,aAAa,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,EAAE,KAAK,CAAC,EAAE,EAAE,CAAC;gBAC7D,GAAG;gBACH,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAE,KAAgB,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,KAAK;aACjE,CAAC,CACiC;SACtC;KACF,CAAC;IACF,OAAO,gBAAgB,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC;AAChD,CAAC;AAED;;;;;GAKG;AACH,SAAgB,aAAa,CAAC,OAAe;IAC3C,MAAM,OAAO,GAAG,gBAAgB,CAAC,OAAO,CAAC,CAAC;IAC1C,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IAEnC,MAAM,GAAG,GAA4B;QACnC,GAAG,MAAM;QACT,OAAO,EAAE,MAAM,CAAC,OAA0B;KAC3C,CAAC;IACF,MAAM,SAAS,GAAG,0CAA6B,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IAC3D,OAAO,SAAS,CAAC;AACnB,CAAC;AAED;;;;;GAKG;AACH,SAAgB,gBAAgB,CAAC,IAAY;IAC3C,IACE,OAAO,UAAU,KAAK,WAAW;QACjC,OAAO,UAAU,CAAC,IAAI,KAAK,UAAU,EACrC,CAAC;QACD,OAAO,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC/B,CAAC;IACD,OAAO,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;AAC9C,CAAC;AAED;;;;;GAKG;AACH,SAAS,gBAAgB,CAAC,IAAY;IACpC,IACE,OAAO,UAAU,KAAK,WAAW;QACjC,OAAO,UAAU,CAAC,IAAI,KAAK,UAAU,EACrC,CAAC;QACD,OAAO,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC/B,CAAC;IACD,OAAO,MAAM,CAAC,IAAI,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;AACvD,CAAC"}

package/dist/x402/facilitator.d.ts

@@ -0,0 +1,88 @@
+import type { ThirdwebClient } from "../client/client.js";
+import { type FacilitatorSettleResponse, type FacilitatorSupportedResponse, type FacilitatorVerifyResponse, type RequestedPaymentPayload, type RequestedPaymentRequirements } from "./schemas.js";
+import type { PaymentArgs, PaymentRequiredResult } from "./types.js";
+export type WaitUntil = "simulated" | "submitted" | "confirmed";
+export type ThirdwebX402FacilitatorConfig = {
+    client: ThirdwebClient;
+    serverWalletAddress: string;
+    waitUntil?: WaitUntil;
+    vaultAccessToken?: string;
+    baseUrl?: string;
+};
+/**
+ * facilitator for the x402 payment protocol.
+ * @public
+ */
+export type ThirdwebX402Facilitator = {
+    url: `${string}://${string}`;
+    address: string;
+    createAuthHeaders: () => Promise<{
+        verify: Record<string, string>;
+        settle: Record<string, string>;
+        supported: Record<string, string>;
+        list: Record<string, string>;
+    }>;
+    verify: (payload: RequestedPaymentPayload, paymentRequirements: RequestedPaymentRequirements) => Promise<FacilitatorVerifyResponse>;
+    settle: (payload: RequestedPaymentPayload, paymentRequirements: RequestedPaymentRequirements, waitUntil?: WaitUntil) => Promise<FacilitatorSettleResponse>;
+    supported: (filters?: {
+        chainId: number;
+        tokenAddress?: string;
+    }) => Promise<FacilitatorSupportedResponse>;
+    accepts: (args: Omit<PaymentArgs, "facilitator">) => Promise<PaymentRequiredResult>;
+};
+/**
+ * Creates a facilitator for the x402 payment protocol.
+ * You can use this with `settlePayment` or with any x402 middleware to enable settling transactions with your thirdweb server wallet.
+ *
+ * @param config - The configuration for the facilitator
+ * @returns a x402 compatible FacilitatorConfig
+ *
+ * @example
+ * ```ts
+ * import { facilitator } from "thirdweb/x402";
+ * import { createThirdwebClient } from "thirdweb";
+ * import { paymentMiddleware } from 'x402-hono'
+ *
+ * const client = createThirdwebClient({
+ *   secretKey: "your-secret-key",
+ * });
+ * const thirdwebX402Facilitator = facilitator({
+ *   client: client,
+ *   serverWalletAddress: "0x1234567890123456789012345678901234567890",
+ * });
+ *
+ * // add the facilitator to any x402 payment middleware
+ * const middleware = paymentMiddleware(
+ *   "0x1234567890123456789012345678901234567890",
+ *   {
+ *     "/api/paywall": {
+ *       price: "$0.01",
+ *       network: "base-sepolia",
+ *       config: {
+ *         description: "Access to paid content",
+ *       },
+ *     },
+ *   },
+ *   thirdwebX402Facilitator,
+ * );
+ * ```
+ *
+ * #### Configuration Options
+ *
+ * ```ts
+ * const thirdwebX402Facilitator = facilitator({
+ *   client: client,
+ *   serverWalletAddress: "0x1234567890123456789012345678901234567890",
+ *   // Optional: Wait behavior for settlements
+ *   // - "simulated": Only simulate the transaction (fastest)
+ *   // - "submitted": Wait until transaction is submitted
+ *   // - "confirmed": Wait for full on-chain confirmation (slowest, default)
+ *   waitUntil: "confirmed",
+ * });
+
+ * ```
+ *
+ * @bridge x402
+ */
+export declare function facilitator(config: ThirdwebX402FacilitatorConfig): ThirdwebX402Facilitator;
+//# sourceMappingURL=facilitator.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"facilitator.d.ts","sourceRoot":"","sources":["../../src/x402/facilitator.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAG1D,OAAO,EACL,KAAK,yBAAyB,EAC9B,KAAK,4BAA4B,EACjC,KAAK,yBAAyB,EAE9B,KAAK,uBAAuB,EAC5B,KAAK,4BAA4B,EAClC,MAAM,cAAc,CAAC;AACtB,OAAO,KAAK,EAAE,WAAW,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAC;AAErE,MAAM,MAAM,SAAS,GAAG,WAAW,GAAG,WAAW,GAAG,WAAW,CAAC;AAEhE,MAAM,MAAM,6BAA6B,GAAG;IAC1C,MAAM,EAAE,cAAc,CAAC;IACvB,mBAAmB,EAAE,MAAM,CAAC;IAC5B,SAAS,CAAC,EAAE,SAAS,CAAC;IACtB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB,CAAC;AAEF;;;GAGG;AACH,MAAM,MAAM,uBAAuB,GAAG;IACpC,GAAG,EAAE,GAAG,MAAM,MAAM,MAAM,EAAE,CAAC;IAC7B,OAAO,EAAE,MAAM,CAAC;IAChB,iBAAiB,EAAE,MAAM,OAAO,CAAC;QAC/B,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QAC/B,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QAC/B,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QAClC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;KAC9B,CAAC,CAAC;IACH,MAAM,EAAE,CACN,OAAO,EAAE,uBAAuB,EAChC,mBAAmB,EAAE,4BAA4B,KAC9C,OAAO,CAAC,yBAAyB,CAAC,CAAC;IACxC,MAAM,EAAE,CACN,OAAO,EAAE,uBAAuB,EAChC,mBAAmB,EAAE,4BAA4B,EACjD,SAAS,CAAC,EAAE,SAAS,KAClB,OAAO,CAAC,yBAAyB,CAAC,CAAC;IACxC,SAAS,EAAE,CAAC,OAAO,CAAC,EAAE;QACpB,OAAO,EAAE,MAAM,CAAC;QAChB,YAAY,CAAC,EAAE,MAAM,CAAC;KACvB,KAAK,OAAO,CAAC,4BAA4B,CAAC,CAAC;IAC5C,OAAO,EAAE,CACP,IAAI,EAAE,IAAI,CAAC,WAAW,EAAE,aAAa,CAAC,KACnC,OAAO,CAAC,qBAAqB,CAAC,CAAC;CACrC,CAAC;AAIF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqDG;AACH,wBAAgB,WAAW,CACzB,MAAM,EAAE,6BAA6B,GACpC,uBAAuB,CA8LzB"}