x402-evm-mantle 2.1.3-mantle → 2.1.4-mantle

package/dist/esm/exact/facilitator/index.d.mts

@@ -1,118 +0,0 @@
-import { SchemeNetworkFacilitator, PaymentPayload, PaymentRequirements, VerifyResponse, SettleResponse, Network } from '@x402/core/types';
-import { F as FacilitatorEvmSigner } from '../../signer-5OVDxViv.mjs';
-import { x402Facilitator } from '@x402/core/facilitator';
-
-interface ExactEvmSchemeConfig {
-    /**
-     * If enabled, the facilitator will deploy ERC-4337 smart wallets
-     * via EIP-6492 when encountering undeployed contract signatures.
-     *
-     * @default false
-     */
-    deployERC4337WithEIP6492?: boolean;
-}
-/**
- * EVM facilitator implementation for the Exact payment scheme.
- */
-declare class ExactEvmScheme implements SchemeNetworkFacilitator {
-    private readonly signer;
-    readonly scheme = "exact";
-    readonly caipFamily = "eip155:*";
-    private readonly config;
-    /**
-     * Creates a new ExactEvmFacilitator instance.
-     *
-     * @param signer - The EVM signer for facilitator operations
-     * @param config - Optional configuration for the facilitator
-     */
-    constructor(signer: FacilitatorEvmSigner, config?: ExactEvmSchemeConfig);
-    /**
-     * Get mechanism-specific extra data for the supported kinds endpoint.
-     * For EVM, no extra data is needed.
-     *
-     * @param _ - The network identifier (unused for EVM)
-     * @returns undefined (EVM has no extra data)
-     */
-    getExtra(_: string): Record<string, unknown> | undefined;
-    /**
-     * Get signer addresses used by this facilitator.
-     * Returns all addresses this facilitator can use for signing/settling transactions.
-     *
-     * @param _ - The network identifier (unused for EVM, addresses are network-agnostic)
-     * @returns Array of facilitator wallet addresses
-     */
-    getSigners(_: string): string[];
-    /**
-     * Verifies a payment payload.
-     *
-     * @param payload - The payment payload to verify
-     * @param requirements - The payment requirements
-     * @returns Promise resolving to verification response
-     */
-    verify(payload: PaymentPayload, requirements: PaymentRequirements): Promise<VerifyResponse>;
-    /**
-     * Settles a payment by executing the transfer.
-     *
-     * @param payload - The payment payload to settle
-     * @param requirements - The payment requirements
-     * @returns Promise resolving to settlement response
-     */
-    settle(payload: PaymentPayload, requirements: PaymentRequirements): Promise<SettleResponse>;
-}
-
-/**
- * Configuration options for registering EVM schemes to an x402Facilitator
- */
-interface EvmFacilitatorConfig {
-    /**
-     * The EVM signer for facilitator operations (verify and settle)
-     */
-    signer: FacilitatorEvmSigner;
-    /**
-     * Networks to register (single network or array of networks)
-     * Examples: "eip155:84532", ["eip155:84532", "eip155:1"]
-     */
-    networks: Network | Network[];
-    /**
-     * If enabled, the facilitator will deploy ERC-4337 smart wallets
-     * via EIP-6492 when encountering undeployed contract signatures.
-     *
-     * @default false
-     */
-    deployERC4337WithEIP6492?: boolean;
-}
-/**
- * Registers EVM exact payment schemes to an x402Facilitator instance.
- *
- * This function registers:
- * - V2: Specified networks with ExactEvmScheme
- * - V1: All supported EVM networks with ExactEvmSchemeV1
- *
- * @param facilitator - The x402Facilitator instance to register schemes to
- * @param config - Configuration for EVM facilitator registration
- * @returns The facilitator instance for chaining
- *
- * @example
- * ```typescript
- * import { registerExactEvmScheme } from "@x402/evm/exact/facilitator/register";
- * import { x402Facilitator } from "@x402/core/facilitator";
- * import { createPublicClient, createWalletClient } from "viem";
- *
- * const facilitator = new x402Facilitator();
- *
- * // Single network
- * registerExactEvmScheme(facilitator, {
- *   signer: combinedClient,
- *   networks: "eip155:84532"  // Base Sepolia
- * });
- *
- * // Multiple networks (will auto-derive eip155:* pattern)
- * registerExactEvmScheme(facilitator, {
- *   signer: combinedClient,
- *   networks: ["eip155:84532", "eip155:1"]  // Base Sepolia and Mainnet
- * });
- * ```
- */
-declare function registerExactEvmScheme(facilitator: x402Facilitator, config: EvmFacilitatorConfig): x402Facilitator;
-
-export { type EvmFacilitatorConfig, ExactEvmScheme, type ExactEvmSchemeConfig, registerExactEvmScheme };

package/dist/esm/exact/server/index.d.mts

@@ -1,140 +0,0 @@
-import { SchemeNetworkServer, MoneyParser, Price, Network, AssetAmount, PaymentRequirements } from '@x402/core/types';
-import { x402ResourceServer } from '@x402/core/server';
-
-/**
- * EVM server implementation for the Exact payment scheme.
- */
-declare class ExactEvmScheme implements SchemeNetworkServer {
-    readonly scheme = "exact";
-    private moneyParsers;
-    /**
-     * Register a custom money parser in the parser chain.
-     * Multiple parsers can be registered - they will be tried in registration order.
-     * Each parser receives a decimal amount (e.g., 1.50 for $1.50).
-     * If a parser returns null, the next parser in the chain will be tried.
-     * The default parser is always the final fallback.
-     *
-     * @param parser - Custom function to convert amount to AssetAmount (or null to skip)
-     * @returns The server instance for chaining
-     *
-     * @example
-     * evmServer.registerMoneyParser(async (amount, network) => {
-     *   // Custom conversion logic
-     *   if (amount > 100) {
-     *     // Use different token for large amounts
-     *     return { amount: (amount * 1e18).toString(), asset: "0xCustomToken" };
-     *   }
-     *   return null; // Use next parser
-     * });
-     */
-    registerMoneyParser(parser: MoneyParser): ExactEvmScheme;
-    /**
-     * Parses a price into an asset amount.
-     * If price is already an AssetAmount, returns it directly.
-     * If price is Money (string | number), parses to decimal and tries custom parsers.
-     * Falls back to default conversion if all custom parsers return null.
-     *
-     * @param price - The price to parse
-     * @param network - The network to use
-     * @returns Promise that resolves to the parsed asset amount
-     */
-    parsePrice(price: Price, network: Network): Promise<AssetAmount>;
-    /**
-     * Build payment requirements for this scheme/network combination
-     *
-     * @param paymentRequirements - The base payment requirements
-     * @param supportedKind - The supported kind from facilitator (unused)
-     * @param supportedKind.x402Version - The x402 version
-     * @param supportedKind.scheme - The logical payment scheme
-     * @param supportedKind.network - The network identifier in CAIP-2 format
-     * @param supportedKind.extra - Optional extra metadata regarding scheme/network implementation details
-     * @param extensionKeys - Extension keys supported by the facilitator (unused)
-     * @returns Payment requirements ready to be sent to clients
-     */
-    enhancePaymentRequirements(paymentRequirements: PaymentRequirements, supportedKind: {
-        x402Version: number;
-        scheme: string;
-        network: Network;
-        extra?: Record<string, unknown>;
-    }, extensionKeys: string[]): Promise<PaymentRequirements>;
-    /**
-     * Parse Money (string | number) to a decimal number.
-     * Handles formats like "$1.50", "1.50", 1.50, etc.
-     *
-     * @param money - The money value to parse
-     * @returns Decimal number
-     */
-    private parseMoneyToDecimal;
-    /**
-     * Default money conversion implementation.
-     * Converts decimal amount to USDC on the specified network.
-     *
-     * @param amount - The decimal amount (e.g., 1.50)
-     * @param network - The network to use
-     * @returns The parsed asset amount in USDC
-     */
-    private defaultMoneyConversion;
-    /**
-     * Convert decimal amount to token units (e.g., 0.10 -> 100000 for 6-decimal USDC)
-     *
-     * @param decimalAmount - The decimal amount to convert
-     * @param network - The network to use
-     * @returns The token amount as a string
-     */
-    private convertToTokenAmount;
-    /**
-     * Get the default asset info for a network (typically USDC)
-     *
-     * @param network - The network to get asset info for
-     * @returns The asset information including address, name, and version
-     */
-    private getDefaultAsset;
-    /**
-     * Get asset info for a given symbol on a network
-     *
-     * @param symbol - The asset symbol
-     * @param network - The network to use
-     * @returns The asset information including address, name, and version
-     */
-    private getAssetInfo;
-    /**
-     * Get the number of decimals for the asset
-     *
-     * @param _ - The network to use (unused)
-     * @returns The number of decimals for the asset
-     */
-    private getAssetDecimals;
-}
-
-/**
- * Configuration options for registering EVM schemes to an x402ResourceServer
- */
-interface EvmResourceServerConfig {
-    /**
-     * Optional specific networks to register
-     * If not provided, registers wildcard support (eip155:*)
-     */
-    networks?: Network[];
-}
-/**
- * Registers EVM exact payment schemes to an x402ResourceServer instance.
- *
- * This function registers:
- * - V2: eip155:* wildcard scheme with ExactEvmScheme (or specific networks if provided)
- *
- * @param server - The x402ResourceServer instance to register schemes to
- * @param config - Configuration for EVM resource server registration
- * @returns The server instance for chaining
- *
- * @example
- * ```typescript
- * import { registerExactEvmScheme } from "@x402/evm/exact/server/register";
- * import { x402ResourceServer } from "@x402/core/server";
- *
- * const server = new x402ResourceServer(facilitatorClient);
- * registerExactEvmScheme(server, {});
- * ```
- */
-declare function registerExactEvmScheme(server: x402ResourceServer, config?: EvmResourceServerConfig): x402ResourceServer;
-
-export { type EvmResourceServerConfig, ExactEvmScheme, registerExactEvmScheme };

package/dist/esm/exact/v1/client/index.d.mts

@@ -1,37 +0,0 @@
-import { SchemeNetworkClient, PaymentRequirements, PaymentPayload, Network } from '@x402/core/types';
-import { C as ClientEvmSigner } from '../../../signer-5OVDxViv.mjs';
-
-/**
- * EVM client implementation for the Exact payment scheme (V1).
- */
-declare class ExactEvmSchemeV1 implements SchemeNetworkClient {
-    private readonly signer;
-    readonly scheme = "exact";
-    /**
-     * Creates a new ExactEvmClientV1 instance.
-     *
-     * @param signer - The EVM signer for client operations
-     */
-    constructor(signer: ClientEvmSigner);
-    /**
-     * Creates a payment payload for the Exact scheme (V1).
-     *
-     * @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"> & {
-        scheme: string;
-        network: Network;
-    }>;
-    /**
-     * Sign the EIP-3009 authorization using EIP-712
-     *
-     * @param authorization - The authorization to sign
-     * @param requirements - The payment requirements
-     * @returns Promise resolving to the signature
-     */
-    private signAuthorization;
-}
-
-export { ExactEvmSchemeV1 };

package/dist/esm/exact/v1/facilitator/index.d.mts

@@ -1,62 +0,0 @@
-import { SchemeNetworkFacilitator, PaymentPayload, PaymentRequirements, VerifyResponse, SettleResponse } from '@x402/core/types';
-import { F as FacilitatorEvmSigner } from '../../../signer-5OVDxViv.mjs';
-
-interface ExactEvmSchemeV1Config {
-    /**
-     * If enabled, the facilitator will deploy ERC-4337 smart wallets
-     * via EIP-6492 when encountering undeployed contract signatures.
-     *
-     * @default false
-     */
-    deployERC4337WithEIP6492?: boolean;
-}
-/**
- * EVM facilitator implementation for the Exact payment scheme (V1).
- */
-declare class ExactEvmSchemeV1 implements SchemeNetworkFacilitator {
-    private readonly signer;
-    readonly scheme = "exact";
-    readonly caipFamily = "eip155:*";
-    private readonly config;
-    /**
-     * Creates a new ExactEvmFacilitatorV1 instance.
-     *
-     * @param signer - The EVM signer for facilitator operations
-     * @param config - Optional configuration for the facilitator
-     */
-    constructor(signer: FacilitatorEvmSigner, config?: ExactEvmSchemeV1Config);
-    /**
-     * Get mechanism-specific extra data for the supported kinds endpoint.
-     * For EVM, no extra data is needed.
-     *
-     * @param _ - The network identifier (unused for EVM)
-     * @returns undefined (EVM has no extra data)
-     */
-    getExtra(_: string): Record<string, unknown> | undefined;
-    /**
-     * Get signer addresses used by this facilitator.
-     * Returns all addresses this facilitator can use for signing/settling transactions.
-     *
-     * @param _ - The network identifier (unused for EVM, addresses are network-agnostic)
-     * @returns Array of facilitator wallet addresses
-     */
-    getSigners(_: string): string[];
-    /**
-     * Verifies a payment payload (V1).
-     *
-     * @param payload - The payment payload to verify
-     * @param requirements - The payment requirements
-     * @returns Promise resolving to verification response
-     */
-    verify(payload: PaymentPayload, requirements: PaymentRequirements): Promise<VerifyResponse>;
-    /**
-     * Settles a payment by executing the transfer (V1).
-     *
-     * @param payload - The payment payload to settle
-     * @param requirements - The payment requirements
-     * @returns Promise resolving to settlement response
-     */
-    settle(payload: PaymentPayload, requirements: PaymentRequirements): Promise<SettleResponse>;
-}
-
-export { ExactEvmSchemeV1, type ExactEvmSchemeV1Config };

package/dist/esm/index.d.mts

@@ -1,36 +0,0 @@
-import { SchemeNetworkClient, PaymentRequirements, PaymentPayload } from '@x402/core/types';
-import { C as ClientEvmSigner } from './signer-5OVDxViv.mjs';
-export { F as FacilitatorEvmSigner, t as toClientEvmSigner, a as toFacilitatorEvmSigner } from './signer-5OVDxViv.mjs';
-
-/**
- * EVM client implementation for the Exact payment scheme.
- *
- */
-declare class ExactEvmScheme implements SchemeNetworkClient {
-    private readonly signer;
-    readonly scheme = "exact";
-    /**
-     * Creates a new ExactEvmClient instance.
-     *
-     * @param signer - The EVM signer for client operations
-     */
-    constructor(signer: ClientEvmSigner);
-    /**
-     * 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">>;
-    /**
-     * Sign the EIP-3009 authorization using EIP-712
-     *
-     * @param authorization - The authorization to sign
-     * @param requirements - The payment requirements
-     * @returns Promise resolving to the signature
-     */
-    private signAuthorization;
-}
-
-export { ClientEvmSigner, ExactEvmScheme };

package/dist/esm/signer-5OVDxViv.d.mts

@@ -1,79 +0,0 @@
-/**
- * ClientEvmSigner - Used by x402 clients to sign payment authorizations
- * This is typically a LocalAccount or wallet that holds private keys
- * and can sign EIP-712 typed data for payment authorizations
- */
-type ClientEvmSigner = {
-    readonly address: `0x${string}`;
-    signTypedData(message: {
-        domain: Record<string, unknown>;
-        types: Record<string, unknown>;
-        primaryType: string;
-        message: Record<string, unknown>;
-    }): Promise<`0x${string}`>;
-};
-/**
- * FacilitatorEvmSigner - Used by x402 facilitators to verify and settle payments
- * This is typically a viem PublicClient + WalletClient combination that can
- * read contract state, verify signatures, write transactions, and wait for receipts
- *
- * Supports multiple addresses for load balancing, key rotation, and high availability
- */
-type FacilitatorEvmSigner = {
-    /**
-     * Get all addresses this facilitator can use for signing
-     * Enables dynamic address selection for load balancing and key rotation
-     */
-    getAddresses(): readonly `0x${string}`[];
-    readContract(args: {
-        address: `0x${string}`;
-        abi: readonly unknown[];
-        functionName: string;
-        args?: readonly unknown[];
-    }): Promise<unknown>;
-    verifyTypedData(args: {
-        address: `0x${string}`;
-        domain: Record<string, unknown>;
-        types: Record<string, unknown>;
-        primaryType: string;
-        message: Record<string, unknown>;
-        signature: `0x${string}`;
-    }): Promise<boolean>;
-    writeContract(args: {
-        address: `0x${string}`;
-        abi: readonly unknown[];
-        functionName: string;
-        args: readonly unknown[];
-    }): Promise<`0x${string}`>;
-    sendTransaction(args: {
-        to: `0x${string}`;
-        data: `0x${string}`;
-    }): Promise<`0x${string}`>;
-    waitForTransactionReceipt(args: {
-        hash: `0x${string}`;
-    }): Promise<{
-        status: string;
-    }>;
-    getCode(args: {
-        address: `0x${string}`;
-    }): Promise<`0x${string}` | undefined>;
-};
-/**
- * Converts a signer to a ClientEvmSigner
- *
- * @param signer - The signer to convert to a ClientEvmSigner
- * @returns The converted signer
- */
-declare function toClientEvmSigner(signer: ClientEvmSigner): ClientEvmSigner;
-/**
- * Converts a viem client with single address to a FacilitatorEvmSigner
- * Wraps the single address in a getAddresses() function for compatibility
- *
- * @param client - The client to convert (must have 'address' property)
- * @returns FacilitatorEvmSigner with getAddresses() support
- */
-declare function toFacilitatorEvmSigner(client: Omit<FacilitatorEvmSigner, "getAddresses"> & {
-    address: `0x${string}`;
-}): FacilitatorEvmSigner;
-
-export { type ClientEvmSigner as C, type FacilitatorEvmSigner as F, toFacilitatorEvmSigner as a, toClientEvmSigner as t };

package/dist/esm/v1/index.d.mts

@@ -1,7 +0,0 @@
-export { ExactEvmSchemeV1 } from '../exact/v1/client/index.mjs';
-import '@x402/core/types';
-import '../signer-5OVDxViv.mjs';
-
-declare const NETWORKS: string[];
-
-export { NETWORKS };