x402-express-mantle 1.0.0 → 1.0.2

package/lib/esm/facilitator/index.mjs.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../../../src/facilitator/x402Facilitator.ts"],"sourcesContent":["import { x402Version } from \"..\";\nimport { SettleResponse, VerifyResponse } from \"../types/facilitator\";\nimport { SchemeNetworkFacilitator } from \"../types/mechanisms\";\nimport { PaymentPayload, PaymentRequirements } from \"../types/payments\";\nimport { Network } from \"../types\";\nimport { type SchemeData } from \"../utils\";\n\n/**\n * Facilitator Hook Context Interfaces\n */\n\nexport interface FacilitatorVerifyContext {\n  paymentPayload: PaymentPayload;\n  requirements: PaymentRequirements;\n}\n\nexport interface FacilitatorVerifyResultContext extends FacilitatorVerifyContext {\n  result: VerifyResponse;\n}\n\nexport interface FacilitatorVerifyFailureContext extends FacilitatorVerifyContext {\n  error: Error;\n}\n\nexport interface FacilitatorSettleContext {\n  paymentPayload: PaymentPayload;\n  requirements: PaymentRequirements;\n}\n\nexport interface FacilitatorSettleResultContext extends FacilitatorSettleContext {\n  result: SettleResponse;\n}\n\nexport interface FacilitatorSettleFailureContext extends FacilitatorSettleContext {\n  error: Error;\n}\n\n/**\n * Facilitator Hook Type Definitions\n */\n\nexport type FacilitatorBeforeVerifyHook = (\n  context: FacilitatorVerifyContext,\n) => Promise<void | { abort: true; reason: string }>;\n\nexport type FacilitatorAfterVerifyHook = (context: FacilitatorVerifyResultContext) => Promise<void>;\n\nexport type FacilitatorOnVerifyFailureHook = (\n  context: FacilitatorVerifyFailureContext,\n) => Promise<void | { recovered: true; result: VerifyResponse }>;\n\nexport type FacilitatorBeforeSettleHook = (\n  context: FacilitatorSettleContext,\n) => Promise<void | { abort: true; reason: string }>;\n\nexport type FacilitatorAfterSettleHook = (context: FacilitatorSettleResultContext) => Promise<void>;\n\nexport type FacilitatorOnSettleFailureHook = (\n  context: FacilitatorSettleFailureContext,\n) => Promise<void | { recovered: true; result: SettleResponse }>;\n\n/**\n * Facilitator client for the x402 payment protocol.\n * Manages payment scheme registration, verification, and settlement.\n */\nexport class x402Facilitator {\n  private readonly registeredFacilitatorSchemes: Map<\n    number,\n    SchemeData<SchemeNetworkFacilitator>[] // Array to support multiple facilitators per version\n  > = new Map();\n  private readonly extensions: string[] = [];\n\n  private beforeVerifyHooks: FacilitatorBeforeVerifyHook[] = [];\n  private afterVerifyHooks: FacilitatorAfterVerifyHook[] = [];\n  private onVerifyFailureHooks: FacilitatorOnVerifyFailureHook[] = [];\n  private beforeSettleHooks: FacilitatorBeforeSettleHook[] = [];\n  private afterSettleHooks: FacilitatorAfterSettleHook[] = [];\n  private onSettleFailureHooks: FacilitatorOnSettleFailureHook[] = [];\n\n  /**\n   * Registers a scheme facilitator for the current x402 version.\n   * Networks are stored and used for getSupported() - no need to specify them later.\n   *\n   * @param networks - Single network or array of networks this facilitator supports\n   * @param facilitator - The scheme network facilitator to register\n   * @returns The x402Facilitator instance for chaining\n   */\n  register(networks: Network | Network[], facilitator: SchemeNetworkFacilitator): x402Facilitator {\n    const networksArray = Array.isArray(networks) ? networks : [networks];\n    return this._registerScheme(x402Version, networksArray, facilitator);\n  }\n\n  /**\n   * Registers a scheme facilitator for x402 version 1.\n   * Networks are stored and used for getSupported() - no need to specify them later.\n   *\n   * @param networks - Single network or array of networks this facilitator supports\n   * @param facilitator - The scheme network facilitator to register\n   * @returns The x402Facilitator instance for chaining\n   */\n  registerV1(\n    networks: Network | Network[],\n    facilitator: SchemeNetworkFacilitator,\n  ): x402Facilitator {\n    const networksArray = Array.isArray(networks) ? networks : [networks];\n    return this._registerScheme(1, networksArray, facilitator);\n  }\n\n  /**\n   * Registers a protocol extension.\n   *\n   * @param extension - The extension name to register (e.g., \"bazaar\", \"sign_in_with_x\")\n   * @returns The x402Facilitator instance for chaining\n   */\n  registerExtension(extension: string): x402Facilitator {\n    // Check if already registered\n    if (!this.extensions.includes(extension)) {\n      this.extensions.push(extension);\n    }\n    return this;\n  }\n\n  /**\n   * Gets the list of registered extensions.\n   *\n   * @returns Array of extension names\n   */\n  getExtensions(): string[] {\n    return [...this.extensions];\n  }\n\n  /**\n   * Register a hook to execute before facilitator payment verification.\n   * Can abort verification by returning { abort: true, reason: string }\n   *\n   * @param hook - The hook function to register\n   * @returns The x402Facilitator instance for chaining\n   */\n  onBeforeVerify(hook: FacilitatorBeforeVerifyHook): x402Facilitator {\n    this.beforeVerifyHooks.push(hook);\n    return this;\n  }\n\n  /**\n   * Register a hook to execute after successful facilitator payment verification (isValid: true).\n   * This hook is NOT called when verification fails (isValid: false) - use onVerifyFailure for that.\n   *\n   * @param hook - The hook function to register\n   * @returns The x402Facilitator instance for chaining\n   */\n  onAfterVerify(hook: FacilitatorAfterVerifyHook): x402Facilitator {\n    this.afterVerifyHooks.push(hook);\n    return this;\n  }\n\n  /**\n   * Register a hook to execute when facilitator payment verification fails.\n   * Called when: verification returns isValid: false, or an exception is thrown during verification.\n   * Can recover from failure by returning { recovered: true, result: VerifyResponse }\n   *\n   * @param hook - The hook function to register\n   * @returns The x402Facilitator instance for chaining\n   */\n  onVerifyFailure(hook: FacilitatorOnVerifyFailureHook): x402Facilitator {\n    this.onVerifyFailureHooks.push(hook);\n    return this;\n  }\n\n  /**\n   * Register a hook to execute before facilitator payment settlement.\n   * Can abort settlement by returning { abort: true, reason: string }\n   *\n   * @param hook - The hook function to register\n   * @returns The x402Facilitator instance for chaining\n   */\n  onBeforeSettle(hook: FacilitatorBeforeSettleHook): x402Facilitator {\n    this.beforeSettleHooks.push(hook);\n    return this;\n  }\n\n  /**\n   * Register a hook to execute after successful facilitator payment settlement.\n   *\n   * @param hook - The hook function to register\n   * @returns The x402Facilitator instance for chaining\n   */\n  onAfterSettle(hook: FacilitatorAfterSettleHook): x402Facilitator {\n    this.afterSettleHooks.push(hook);\n    return this;\n  }\n\n  /**\n   * Register a hook to execute when facilitator payment settlement fails.\n   * Can recover from failure by returning { recovered: true, result: SettleResponse }\n   *\n   * @param hook - The hook function to register\n   * @returns The x402Facilitator instance for chaining\n   */\n  onSettleFailure(hook: FacilitatorOnSettleFailureHook): x402Facilitator {\n    this.onSettleFailureHooks.push(hook);\n    return this;\n  }\n\n  /**\n   * Gets supported payment kinds, extensions, and signers.\n   * Uses networks registered during register() calls - no parameters needed.\n   * Returns flat array format for backward compatibility with V1 clients.\n   *\n   * @returns Supported response with kinds as array (with version in each element), extensions, and signers\n   */\n  getSupported(): {\n    kinds: Array<{\n      x402Version: number;\n      scheme: string;\n      network: string;\n      extra?: Record<string, unknown>;\n    }>;\n    extensions: string[];\n    signers: Record<string, string[]>;\n  } {\n    const kinds: Array<{\n      x402Version: number;\n      scheme: string;\n      network: string;\n      extra?: Record<string, unknown>;\n    }> = [];\n    const signersByFamily: Record<string, Set<string>> = {};\n\n    // Iterate over registered scheme data (array supports multiple facilitators per version)\n    for (const [version, schemeDataArray] of this.registeredFacilitatorSchemes) {\n      for (const schemeData of schemeDataArray) {\n        const { facilitator, networks } = schemeData;\n        const scheme = facilitator.scheme;\n\n        // Iterate over stored concrete networks\n        for (const network of networks) {\n          const extra = facilitator.getExtra(network);\n          kinds.push({\n            x402Version: version,\n            scheme,\n            network,\n            ...(extra && { extra }),\n          });\n\n          // Collect signers by CAIP family for this network\n          const family = facilitator.caipFamily;\n          if (!signersByFamily[family]) {\n            signersByFamily[family] = new Set();\n          }\n          facilitator.getSigners(network).forEach(signer => signersByFamily[family].add(signer));\n        }\n      }\n    }\n\n    // Convert signer sets to arrays\n    const signers: Record<string, string[]> = {};\n    for (const [family, signerSet] of Object.entries(signersByFamily)) {\n      signers[family] = Array.from(signerSet);\n    }\n\n    return {\n      kinds,\n      extensions: this.extensions,\n      signers,\n    };\n  }\n\n  /**\n   * Verifies a payment payload against requirements.\n   *\n   * @param paymentPayload - The payment payload to verify\n   * @param paymentRequirements - The payment requirements to verify against\n   * @returns Promise resolving to the verification response\n   */\n  async verify(\n    paymentPayload: PaymentPayload,\n    paymentRequirements: PaymentRequirements,\n  ): Promise<VerifyResponse> {\n    const context: FacilitatorVerifyContext = {\n      paymentPayload,\n      requirements: paymentRequirements,\n    };\n\n    // Execute beforeVerify hooks\n    for (const hook of this.beforeVerifyHooks) {\n      const result = await hook(context);\n      if (result && \"abort\" in result && result.abort) {\n        return {\n          isValid: false,\n          invalidReason: result.reason,\n        };\n      }\n    }\n\n    try {\n      const schemeDataArray = this.registeredFacilitatorSchemes.get(paymentPayload.x402Version);\n      if (!schemeDataArray) {\n        throw new Error(\n          `No facilitator registered for x402 version: ${paymentPayload.x402Version}`,\n        );\n      }\n\n      // Find matching facilitator from array\n      let schemeNetworkFacilitator: SchemeNetworkFacilitator | undefined;\n      for (const schemeData of schemeDataArray) {\n        if (schemeData.facilitator.scheme === paymentRequirements.scheme) {\n          // Check if network matches\n          if (schemeData.networks.has(paymentRequirements.network)) {\n            schemeNetworkFacilitator = schemeData.facilitator;\n            break;\n          }\n          // Try pattern matching\n          const patternRegex = new RegExp(\"^\" + schemeData.pattern.replace(\"*\", \".*\") + \"$\");\n          if (patternRegex.test(paymentRequirements.network)) {\n            schemeNetworkFacilitator = schemeData.facilitator;\n            break;\n          }\n        }\n      }\n\n      if (!schemeNetworkFacilitator) {\n        throw new Error(\n          `No facilitator registered for scheme: ${paymentRequirements.scheme} and network: ${paymentRequirements.network}`,\n        );\n      }\n\n      const verifyResult = await schemeNetworkFacilitator.verify(\n        paymentPayload,\n        paymentRequirements,\n      );\n\n      // Check if verification failed (isValid: false)\n      if (!verifyResult.isValid) {\n        const failureContext: FacilitatorVerifyFailureContext = {\n          ...context,\n          error: new Error(verifyResult.invalidReason || \"Verification failed\"),\n        };\n\n        // Execute onVerifyFailure hooks\n        for (const hook of this.onVerifyFailureHooks) {\n          const result = await hook(failureContext);\n          if (result && \"recovered\" in result && result.recovered) {\n            // If recovered, execute afterVerify hooks with recovered result\n            const recoveredContext: FacilitatorVerifyResultContext = {\n              ...context,\n              result: result.result,\n            };\n            for (const hook of this.afterVerifyHooks) {\n              await hook(recoveredContext);\n            }\n            return result.result;\n          }\n        }\n\n        return verifyResult;\n      }\n\n      // Execute afterVerify hooks only for successful verification\n      const resultContext: FacilitatorVerifyResultContext = {\n        ...context,\n        result: verifyResult,\n      };\n\n      for (const hook of this.afterVerifyHooks) {\n        await hook(resultContext);\n      }\n\n      return verifyResult;\n    } catch (error) {\n      const failureContext: FacilitatorVerifyFailureContext = {\n        ...context,\n        error: error as Error,\n      };\n\n      // Execute onVerifyFailure hooks\n      for (const hook of this.onVerifyFailureHooks) {\n        const result = await hook(failureContext);\n        if (result && \"recovered\" in result && result.recovered) {\n          return result.result;\n        }\n      }\n\n      throw error;\n    }\n  }\n\n  /**\n   * Settles a payment based on the payload and requirements.\n   *\n   * @param paymentPayload - The payment payload to settle\n   * @param paymentRequirements - The payment requirements for settlement\n   * @returns Promise resolving to the settlement response\n   */\n  async settle(\n    paymentPayload: PaymentPayload,\n    paymentRequirements: PaymentRequirements,\n  ): Promise<SettleResponse> {\n    const context: FacilitatorSettleContext = {\n      paymentPayload,\n      requirements: paymentRequirements,\n    };\n\n    // Execute beforeSettle hooks\n    for (const hook of this.beforeSettleHooks) {\n      const result = await hook(context);\n      if (result && \"abort\" in result && result.abort) {\n        throw new Error(`Settlement aborted: ${result.reason}`);\n      }\n    }\n\n    try {\n      const schemeDataArray = this.registeredFacilitatorSchemes.get(paymentPayload.x402Version);\n      if (!schemeDataArray) {\n        throw new Error(\n          `No facilitator registered for x402 version: ${paymentPayload.x402Version}`,\n        );\n      }\n\n      // Find matching facilitator from array\n      let schemeNetworkFacilitator: SchemeNetworkFacilitator | undefined;\n      for (const schemeData of schemeDataArray) {\n        if (schemeData.facilitator.scheme === paymentRequirements.scheme) {\n          // Check if network matches\n          if (schemeData.networks.has(paymentRequirements.network)) {\n            schemeNetworkFacilitator = schemeData.facilitator;\n            break;\n          }\n          // Try pattern matching\n          const patternRegex = new RegExp(\"^\" + schemeData.pattern.replace(\"*\", \".*\") + \"$\");\n          if (patternRegex.test(paymentRequirements.network)) {\n            schemeNetworkFacilitator = schemeData.facilitator;\n            break;\n          }\n        }\n      }\n\n      if (!schemeNetworkFacilitator) {\n        throw new Error(\n          `No facilitator registered for scheme: ${paymentRequirements.scheme} and network: ${paymentRequirements.network}`,\n        );\n      }\n\n      const settleResult = await schemeNetworkFacilitator.settle(\n        paymentPayload,\n        paymentRequirements,\n      );\n\n      // Execute afterSettle hooks\n      const resultContext: FacilitatorSettleResultContext = {\n        ...context,\n        result: settleResult,\n      };\n\n      for (const hook of this.afterSettleHooks) {\n        await hook(resultContext);\n      }\n\n      return settleResult;\n    } catch (error) {\n      const failureContext: FacilitatorSettleFailureContext = {\n        ...context,\n        error: error as Error,\n      };\n\n      // Execute onSettleFailure hooks\n      for (const hook of this.onSettleFailureHooks) {\n        const result = await hook(failureContext);\n        if (result && \"recovered\" in result && result.recovered) {\n          return result.result;\n        }\n      }\n\n      throw error;\n    }\n  }\n\n  /**\n   * Internal method to register a scheme facilitator.\n   *\n   * @param x402Version - The x402 protocol version\n   * @param networks - Array of concrete networks this facilitator supports\n   * @param facilitator - The scheme network facilitator to register\n   * @returns The x402Facilitator instance for chaining\n   */\n  private _registerScheme(\n    x402Version: number,\n    networks: Network[],\n    facilitator: SchemeNetworkFacilitator,\n  ): x402Facilitator {\n    if (!this.registeredFacilitatorSchemes.has(x402Version)) {\n      this.registeredFacilitatorSchemes.set(x402Version, []);\n    }\n    const schemeDataArray = this.registeredFacilitatorSchemes.get(x402Version)!;\n\n    // Add new scheme data (supports multiple facilitators with same scheme name)\n    schemeDataArray.push({\n      facilitator,\n      networks: new Set(networks),\n      pattern: this.derivePattern(networks),\n    });\n\n    return this;\n  }\n\n  /**\n   * Derives a wildcard pattern from an array of networks.\n   * If all networks share the same namespace, returns wildcard pattern.\n   * Otherwise returns the first network for exact matching.\n   *\n   * @param networks - Array of networks\n   * @returns Derived pattern for matching\n   */\n  private derivePattern(networks: Network[]): Network {\n    if (networks.length === 0) return \"\" as Network;\n    if (networks.length === 1) return networks[0];\n\n    // Extract namespaces (e.g., \"eip155\" from \"eip155:84532\")\n    const namespaces = networks.map(n => n.split(\":\")[0]);\n    const uniqueNamespaces = new Set(namespaces);\n\n    // If all same namespace, use wildcard\n    if (uniqueNamespaces.size === 1) {\n      return `${namespaces[0]}:*` as Network;\n    }\n\n    // Mixed namespaces - use first network for exact matching\n    return networks[0];\n  }\n}\n"],"mappings":"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","names":["hook","x402Version"]}

package/lib/esm/http/index.d.mts

@@ -1,52 +0,0 @@
-import { P as PaymentPayload, c as PaymentRequired, S as SettleResponse, a as PaymentRequirements } from '../mechanisms-CzuGzYsS.mjs';
-export { C as CompiledRoute, D as DynamicPayTo, g as DynamicPrice, F as FacilitatorClient, o as FacilitatorConfig, H as HTTPAdapter, n as HTTPFacilitatorClient, c as HTTPProcessResult, a as HTTPRequestContext, b as HTTPResponseInstructions, e as PaymentOption, P as PaywallConfig, d as PaywallProvider, k as ProcessSettleFailureResponse, i as ProcessSettleResultResponse, j as ProcessSettleSuccessResponse, R as RouteConfig, m as RouteConfigurationError, l as RouteValidationError, f as RoutesConfig, U as UnpaidResponseBody, h as UnpaidResponseResult, x as x402HTTPResourceServer } from '../x402HTTPResourceServer-BIfIK5HS.mjs';
-export { x402HTTPClient } from '../client/index.mjs';
-
-type QueryParamMethods = "GET" | "HEAD" | "DELETE";
-type BodyMethods = "POST" | "PUT" | "PATCH";
-/**
- * Encodes a payment payload as a base64 header value.
- *
- * @param paymentPayload - The payment payload to encode
- * @returns Base64 encoded string representation of the payment payload
- */
-declare function encodePaymentSignatureHeader(paymentPayload: PaymentPayload): string;
-/**
- * Decodes a base64 payment signature header into a payment payload.
- *
- * @param paymentSignatureHeader - The base64 encoded payment signature header
- * @returns The decoded payment payload
- */
-declare function decodePaymentSignatureHeader(paymentSignatureHeader: string): PaymentPayload;
-/**
- * Encodes a payment required object as a base64 header value.
- *
- * @param paymentRequired - The payment required object to encode
- * @returns Base64 encoded string representation of the payment required object
- */
-declare function encodePaymentRequiredHeader(paymentRequired: PaymentRequired): string;
-/**
- * Decodes a base64 payment required header into a payment required object.
- *
- * @param paymentRequiredHeader - The base64 encoded payment required header
- * @returns The decoded payment required object
- */
-declare function decodePaymentRequiredHeader(paymentRequiredHeader: string): PaymentRequired;
-/**
- * Encodes a payment response as a base64 header value.
- *
- * @param paymentResponse - The payment response to encode
- * @returns Base64 encoded string representation of the payment response
- */
-declare function encodePaymentResponseHeader(paymentResponse: SettleResponse & {
-    requirements: PaymentRequirements;
-}): string;
-/**
- * Decodes a base64 payment response header into a settle response.
- *
- * @param paymentResponseHeader - The base64 encoded payment response header
- * @returns The decoded settle response
- */
-declare function decodePaymentResponseHeader(paymentResponseHeader: string): SettleResponse;
-
-export { type BodyMethods, type QueryParamMethods, decodePaymentRequiredHeader, decodePaymentResponseHeader, decodePaymentSignatureHeader, encodePaymentRequiredHeader, encodePaymentResponseHeader, encodePaymentSignatureHeader };

package/lib/esm/http/index.mjs

@@ -1,29 +0,0 @@
-import {
-  HTTPFacilitatorClient,
-  RouteConfigurationError,
-  decodePaymentRequiredHeader,
-  decodePaymentResponseHeader,
-  decodePaymentSignatureHeader,
-  encodePaymentRequiredHeader,
-  encodePaymentResponseHeader,
-  encodePaymentSignatureHeader,
-  x402HTTPClient,
-  x402HTTPResourceServer
-} from "../chunk-Z4QX3O5V.mjs";
-import "../chunk-VE37GDG2.mjs";
-import "../chunk-X4W4S5RB.mjs";
-import "../chunk-TDLQZ6MP.mjs";
-import "../chunk-BJTO5JO5.mjs";
-export {
-  HTTPFacilitatorClient,
-  RouteConfigurationError,
-  decodePaymentRequiredHeader,
-  decodePaymentResponseHeader,
-  decodePaymentSignatureHeader,
-  encodePaymentRequiredHeader,
-  encodePaymentResponseHeader,
-  encodePaymentSignatureHeader,
-  x402HTTPClient,
-  x402HTTPResourceServer
-};
-//# sourceMappingURL=index.mjs.map

package/lib/esm/http/index.mjs.map

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

package/lib/esm/mechanisms-CzuGzYsS.d.mts

@@ -1,270 +0,0 @@
-type PaymentRequirementsV1 = {
-    scheme: string;
-    network: Network;
-    maxAmountRequired: string;
-    resource: string;
-    description: string;
-    mimeType: string;
-    outputSchema: Record<string, unknown>;
-    payTo: string;
-    maxTimeoutSeconds: number;
-    asset: string;
-    extra: Record<string, unknown>;
-};
-type PaymentRequiredV1 = {
-    x402Version: 1;
-    error?: string;
-    accepts: PaymentRequirementsV1[];
-};
-type PaymentPayloadV1 = {
-    x402Version: 1;
-    scheme: string;
-    network: Network;
-    payload: Record<string, unknown>;
-};
-type VerifyRequestV1 = {
-    paymentPayload: PaymentPayloadV1;
-    paymentRequirements: PaymentRequirementsV1;
-};
-type SettleRequestV1 = {
-    paymentPayload: PaymentPayloadV1;
-    paymentRequirements: PaymentRequirementsV1;
-};
-type SettleResponseV1 = {
-    success: boolean;
-    errorReason?: string;
-    payer?: string;
-    transaction: string;
-    network: Network;
-};
-type SupportedResponseV1 = {
-    kinds: {
-        x402Version: number;
-        scheme: string;
-        network: Network;
-        extra?: Record<string, unknown>;
-    }[];
-};
-
-interface ResourceServerExtension {
-    key: string;
-    enrichDeclaration?: (declaration: unknown, transportContext: unknown) => unknown;
-}
-
-type Network = `${string}:${string}`;
-type Money = string | number;
-type AssetAmount = {
-    asset: string;
-    amount: string;
-    extra?: Record<string, unknown>;
-};
-type Price = Money | AssetAmount;
-
-interface ResourceInfo {
-    url: string;
-    description: string;
-    mimeType: string;
-}
-type PaymentRequirements = {
-    scheme: string;
-    network: Network;
-    asset: string;
-    amount: string;
-    payTo: string;
-    maxTimeoutSeconds: number;
-    extra: Record<string, unknown>;
-};
-type PaymentRequired = {
-    x402Version: number;
-    error?: string;
-    resource: ResourceInfo;
-    accepts: PaymentRequirements[];
-    extensions?: Record<string, unknown>;
-};
-type PaymentPayload = {
-    x402Version: number;
-    resource: ResourceInfo;
-    accepted: PaymentRequirements;
-    payload: Record<string, unknown>;
-    extensions?: Record<string, unknown>;
-};
-
-type VerifyRequest = {
-    paymentPayload: PaymentPayload;
-    paymentRequirements: PaymentRequirements;
-};
-type VerifyResponse = {
-    isValid: boolean;
-    invalidReason?: string;
-    payer?: string;
-};
-type SettleRequest = {
-    paymentPayload: PaymentPayload;
-    paymentRequirements: PaymentRequirements;
-};
-type SettleResponse = {
-    success: boolean;
-    errorReason?: string;
-    payer?: string;
-    transaction: string;
-    network: Network;
-};
-type SupportedKind = {
-    x402Version: number;
-    scheme: string;
-    network: Network;
-    extra?: Record<string, unknown>;
-};
-type SupportedResponse = {
-    kinds: SupportedKind[];
-    extensions: string[];
-    signers: Record<string, string[]>;
-};
-/**
- * Error thrown when payment verification fails.
- */
-declare class VerifyError extends Error {
-    readonly invalidReason?: string;
-    readonly payer?: string;
-    readonly statusCode: number;
-    /**
-     * Creates a VerifyError from a failed verification response.
-     *
-     * @param statusCode - HTTP status code from the facilitator
-     * @param response - The verify response containing error details
-     */
-    constructor(statusCode: number, response: VerifyResponse);
-}
-/**
- * Error thrown when payment settlement fails.
- */
-declare class SettleError extends Error {
-    readonly errorReason?: string;
-    readonly payer?: string;
-    readonly transaction: string;
-    readonly network: Network;
-    readonly statusCode: number;
-    /**
-     * Creates a SettleError from a failed settlement response.
-     *
-     * @param statusCode - HTTP status code from the facilitator
-     * @param response - The settle response containing error details
-     */
-    constructor(statusCode: number, response: SettleResponse);
-}
-
-/**
- * Money parser function that converts a numeric amount to an AssetAmount
- * Receives the amount as a decimal number (e.g., 1.50 for $1.50)
- * Returns null to indicate "cannot handle this amount", causing fallback to next parser
- * Always returns a Promise for consistency - use async/await
- *
- * @param amount - The decimal amount (e.g., 1.50)
- * @param network - The network identifier for context
- * @returns AssetAmount or null to try next parser
- */
-type MoneyParser = (amount: number, network: Network) => Promise<AssetAmount | null>;
-interface SchemeNetworkClient {
-    readonly scheme: string;
-    createPaymentPayload(x402Version: number, paymentRequirements: PaymentRequirements): Promise<Pick<PaymentPayload, "x402Version" | "payload">>;
-}
-interface SchemeNetworkFacilitator {
-    readonly scheme: string;
-    /**
-     * CAIP family pattern that this facilitator supports.
-     * Used to group signers by blockchain family in the supported response.
-     *
-     * @example
-     * // EVM facilitators
-     * readonly caipFamily = "eip155:*";
-     *
-     * @example
-     * // SVM facilitators
-     * readonly caipFamily = "solana:*";
-     */
-    readonly caipFamily: string;
-    /**
-     * Get mechanism-specific extra data needed for the supported kinds endpoint.
-     * This method is called when building the facilitator's supported response.
-     *
-     * @param network - The network identifier for context
-     * @returns Extra data object or undefined if no extra data is needed
-     *
-     * @example
-     * // EVM schemes return undefined (no extra data needed)
-     * getExtra(network: Network): undefined {
-     *   return undefined;
-     * }
-     *
-     * @example
-     * // SVM schemes return feePayer address
-     * getExtra(network: Network): Record<string, unknown> | undefined {
-     *   return { feePayer: this.signer.address };
-     * }
-     */
-    getExtra(network: Network): Record<string, unknown> | undefined;
-    /**
-     * Get signer addresses used by this facilitator for a given network.
-     * These are included in the supported response to help clients understand
-     * which addresses might sign/pay for transactions.
-     *
-     * Supports multiple addresses for load balancing, key rotation, and high availability.
-     *
-     * @param network - The network identifier
-     * @returns Array of signer addresses (wallet addresses, fee payer addresses, etc.)
-     *
-     * @example
-     * // EVM facilitator
-     * getSigners(network: string): string[] {
-     *   return [...this.signer.getAddresses()];
-     * }
-     *
-     * @example
-     * // SVM facilitator
-     * getSigners(network: string): string[] {
-     *   return [...this.signer.getAddresses()];
-     * }
-     */
-    getSigners(network: string): string[];
-    verify(payload: PaymentPayload, requirements: PaymentRequirements): Promise<VerifyResponse>;
-    settle(payload: PaymentPayload, requirements: PaymentRequirements): Promise<SettleResponse>;
-}
-interface SchemeNetworkServer {
-    readonly scheme: string;
-    /**
-     * Convert a user-friendly price to the scheme's specific amount and asset format
-     * Always returns a Promise for consistency
-     *
-     * @param price - User-friendly price (e.g., "$0.10", "0.10", { amount: "100000", asset: "USDC" })
-     * @param network - The network identifier for context
-     * @returns Promise that resolves to the converted amount, asset identifier, and any extra metadata
-     *
-     * @example
-     * // For EVM networks with USDC:
-     * await parsePrice("$0.10", "eip155:8453") => { amount: "100000", asset: "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913" }
-     *
-     * // For custom schemes:
-     * await parsePrice("10 points", "custom:network") => { amount: "10", asset: "points" }
-     */
-    parsePrice(price: Price, network: Network): Promise<AssetAmount>;
-    /**
-     * Build payment requirements for this scheme/network combination
-     *
-     * @param paymentRequirements - Base payment requirements with amount/asset already set
-     * @param supportedKind - The supported kind from facilitator's /supported endpoint
-     * @param supportedKind.x402Version - The x402 version
-     * @param supportedKind.scheme - The payment scheme
-     * @param supportedKind.network - The network identifier
-     * @param supportedKind.extra - Optional extra metadata
-     * @param facilitatorExtensions - Extensions supported by the facilitator
-     * @returns Enhanced payment requirements ready to be sent to clients
-     */
-    enhancePaymentRequirements(paymentRequirements: PaymentRequirements, supportedKind: {
-        x402Version: number;
-        scheme: string;
-        network: Network;
-        extra?: Record<string, unknown>;
-    }, facilitatorExtensions: string[]): Promise<PaymentRequirements>;
-}
-
-export { type AssetAmount as A, type Money as M, type Network as N, type PaymentPayload as P, type ResourceServerExtension as R, type SettleResponse as S, type VerifyResponse as V, type PaymentRequirements as a, type SchemeNetworkFacilitator as b, type PaymentRequired as c, type SchemeNetworkClient as d, type SupportedResponse as e, type SchemeNetworkServer as f, type SupportedKind as g, type Price as h, type PaymentRequirementsV1 as i, type PaymentRequiredV1 as j, type PaymentPayloadV1 as k, type VerifyRequestV1 as l, type SettleRequestV1 as m, type SettleResponseV1 as n, type SupportedResponseV1 as o, type VerifyRequest as p, type SettleRequest as q, VerifyError as r, SettleError as s, type MoneyParser as t };

package/lib/esm/scheme-fjF-9LhT.d.mts

@@ -1,29 +0,0 @@
-import { SchemeNetworkClient, PaymentRequirements, PaymentPayload } from '@x402/core/types';
-import { C as ClientSvmSigner, a as ClientSvmConfig } from './signer-BMkbhFYE.mjs';
-
-/**
- * SVM client implementation for the Exact payment scheme.
- */
-declare class ExactSvmScheme implements SchemeNetworkClient {
-    private readonly signer;
-    private readonly config?;
-    readonly scheme = "exact";
-    /**
-     * Creates a new ExactSvmClient instance.
-     *
-     * @param signer - The SVM signer for client operations
-     * @param config - Optional configuration with custom RPC URL
-     * @returns ExactSvmClient instance
-     */
-    constructor(signer: ClientSvmSigner, config?: ClientSvmConfig | undefined);
-    /**
-     * Creates a payment payload for the Exact scheme.
-     *
-     * @param x402Version - The x402 protocol version
-     * @param paymentRequirements - The payment requirements
-     * @returns Promise resolving to a payment payload
-     */
-    createPaymentPayload(x402Version: number, paymentRequirements: PaymentRequirements): Promise<Pick<PaymentPayload, "x402Version" | "payload">>;
-}
-
-export { ExactSvmScheme as E };

package/lib/esm/server/index.d.mts

@@ -1,2 +0,0 @@
-export { C as CompiledRoute, F as FacilitatorClient, o as FacilitatorConfig, H as HTTPAdapter, n as HTTPFacilitatorClient, c as HTTPProcessResult, a as HTTPRequestContext, b as HTTPResponseInstructions, P as PaywallConfig, d as PaywallProvider, k as ProcessSettleFailureResponse, i as ProcessSettleResultResponse, j as ProcessSettleSuccessResponse, q as ResourceConfig, r as ResourceInfo, R as RouteConfig, m as RouteConfigurationError, l as RouteValidationError, f as RoutesConfig, U as UnpaidResponseBody, h as UnpaidResponseResult, x as x402HTTPResourceServer, p as x402ResourceServer } from '../x402HTTPResourceServer-BIfIK5HS.mjs';
-import '../mechanisms-CzuGzYsS.mjs';