x402-express-mantle 1.0.0

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

@@ -0,0 +1,79 @@
+/**
+ * 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/lib/esm/signer-BMkbhFYE.d.mts

@@ -0,0 +1,123 @@
+import { TransactionSigner, MessagePartialSigner, RpcDevnet, SolanaRpcApiDevnet, RpcTestnet, SolanaRpcApiTestnet, RpcMainnet, SolanaRpcApiMainnet, Address } from '@solana/kit';
+
+/**
+ * Client-side signer for creating and signing Solana transactions
+ * This is a wrapper around TransactionSigner from @solana/kit
+ */
+type ClientSvmSigner = TransactionSigner;
+/**
+ * Configuration for client operations
+ */
+type ClientSvmConfig = {
+    /**
+     * Optional custom RPC URL for the client to use
+     */
+    rpcUrl?: string;
+};
+/**
+ * RPC client type from @solana/kit
+ * Can be devnet, testnet, or mainnet RPC client
+ */
+type FacilitatorRpcClient = RpcDevnet<SolanaRpcApiDevnet> | RpcTestnet<SolanaRpcApiTestnet> | RpcMainnet<SolanaRpcApiMainnet>;
+/**
+ * Minimal facilitator signer interface for SVM operations.
+ * Supports multiple signers for load balancing and high availability.
+ * All implementation details (RPC clients, key management, signature handling) are hidden.
+ */
+type FacilitatorSvmSigner = {
+    /**
+     * Get all addresses this facilitator can use as fee payers
+     * Enables dynamic address selection for load balancing and key rotation
+     *
+     * @returns Array of addresses available for signing
+     */
+    getAddresses(): readonly Address[];
+    /**
+     * Sign a partially-signed transaction with the signer matching feePayer
+     * Transaction is decoded, signed, and re-encoded internally
+     *
+     * @param transaction - Base64 encoded partially-signed transaction
+     * @param feePayer - Fee payer address (determines which signer to use)
+     * @param network - CAIP-2 network identifier
+     * @returns Base64 encoded fully-signed transaction
+     * @throws Error if no signer exists for feePayer or signing fails
+     */
+    signTransaction(transaction: string, feePayer: Address, network: string): Promise<string>;
+    /**
+     * Simulate a signed transaction to verify it would succeed
+     * Implementation manages RPC client selection and simulation details
+     *
+     * @param transaction - Base64 encoded signed transaction
+     * @param network - CAIP-2 network identifier
+     * @throws Error if simulation fails
+     */
+    simulateTransaction(transaction: string, network: string): Promise<void>;
+    /**
+     * Send a signed transaction to the network
+     * Implementation manages RPC client selection and sending details
+     *
+     * @param transaction - Base64 encoded signed transaction
+     * @param network - CAIP-2 network identifier
+     * @returns Transaction signature
+     * @throws Error if send fails
+     */
+    sendTransaction(transaction: string, network: string): Promise<string>;
+    /**
+     * Wait for transaction confirmation
+     * Allows signer to implement custom retry logic, timeouts, and confirmation strategies
+     *
+     * @param signature - Transaction signature to confirm
+     * @param network - CAIP-2 network identifier
+     * @returns Promise that resolves when transaction is confirmed
+     * @throws Error if confirmation fails or times out
+     */
+    confirmTransaction(signature: string, network: string): Promise<void>;
+};
+/**
+ * Convert a signer to ClientSvmSigner (identity function for type safety)
+ *
+ * @param signer - The signer to convert
+ * @returns The signer as ClientSvmSigner
+ */
+declare function toClientSvmSigner(signer: ClientSvmSigner): ClientSvmSigner;
+/**
+ * RPC configuration for the facilitator
+ * Can be a single RPC (all networks), a network mapping, or config options
+ */
+type FacilitatorRpcConfig = FacilitatorRpcClient | Record<string, FacilitatorRpcClient> | {
+    defaultRpcUrl?: string;
+};
+/**
+ * Create a FacilitatorSvmSigner from a TransactionSigner and optional RPC config
+ *
+ * @param signer - The TransactionSigner (e.g., from createKeyPairSignerFromBytes)
+ * @param rpcConfig - Optional RPC configuration (single RPC, per-network map, or config)
+ * @returns A complete FacilitatorSvmSigner
+ *
+ * @example
+ * ```ts
+ * import { createKeyPairSignerFromBytes, createSolanaRpc, devnet } from "@solana/kit";
+ *
+ * // Option 1: No RPC - use defaults (SIMPLEST)
+ * const keypair = await createKeyPairSignerFromBytes(privateKeyBytes);
+ * const facilitator = toFacilitatorSvmSigner(keypair);
+ *
+ * // Option 2: Single RPC for all networks
+ * const rpc = createSolanaRpc(devnet("https://api.devnet.solana.com"));
+ * const facilitator = toFacilitatorSvmSigner(keypair, rpc);
+ *
+ * // Option 3: Per-network RPC (FLEXIBLE)
+ * const facilitator = toFacilitatorSvmSigner(keypair, {
+ *   [SOLANA_MAINNET_CAIP2]: myQuickNodeRpc,
+ *   // Devnet/testnet use defaults
+ * });
+ *
+ * // Option 4: Custom default RPC URL
+ * const facilitator = toFacilitatorSvmSigner(keypair, {
+ *   defaultRpcUrl: "https://my-rpc.com"
+ * });
+ * ```
+ */
+declare function toFacilitatorSvmSigner(signer: TransactionSigner & MessagePartialSigner, rpcConfig?: FacilitatorRpcConfig): FacilitatorSvmSigner;
+
+export { type ClientSvmSigner as C, type FacilitatorSvmSigner as F, type ClientSvmConfig as a, toFacilitatorSvmSigner as b, type FacilitatorRpcClient as c, type FacilitatorRpcConfig as d, toClientSvmSigner as t };

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

@@ -0,0 +1 @@
+export { A as AssetAmount, M as Money, t as MoneyParser, N as Network, P as PaymentPayload, k as PaymentPayloadV1, c as PaymentRequired, j as PaymentRequiredV1, a as PaymentRequirements, i as PaymentRequirementsV1, h as Price, R as ResourceServerExtension, d as SchemeNetworkClient, b as SchemeNetworkFacilitator, f as SchemeNetworkServer, s as SettleError, q as SettleRequest, S as SettleResponse, e as SupportedResponse, r as VerifyError, p as VerifyRequest, V as VerifyResponse } from '../mechanisms-CzuGzYsS.mjs';

package/lib/esm/types/index.mjs

@@ -0,0 +1,10 @@
+import {
+  SettleError,
+  VerifyError
+} from "../chunk-X4W4S5RB.mjs";
+import "../chunk-BJTO5JO5.mjs";
+export {
+  SettleError,
+  VerifyError
+};
+//# sourceMappingURL=index.mjs.map

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

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

package/lib/esm/types/v1/index.d.mts

@@ -0,0 +1 @@
+export { k as PaymentPayloadV1, j as PaymentRequiredV1, i as PaymentRequirementsV1, m as SettleRequestV1, n as SettleResponseV1, o as SupportedResponseV1, l as VerifyRequestV1 } from '../../mechanisms-CzuGzYsS.mjs';

package/lib/esm/types/v1/index.mjs

@@ -0,0 +1 @@
+//# sourceMappingURL=index.mjs.map

package/lib/esm/types/v1/index.mjs.map

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

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

@@ -0,0 +1,48 @@
+import { N as Network } from '../mechanisms-CzuGzYsS.mjs';
+
+/**
+ * Scheme data structure for facilitator storage
+ */
+interface SchemeData<T> {
+    facilitator: T;
+    networks: Set<Network>;
+    pattern: Network;
+}
+declare const findSchemesByNetwork: <T>(map: Map<string, Map<string, T>>, network: Network) => Map<string, T> | undefined;
+declare const findByNetworkAndScheme: <T>(map: Map<string, Map<string, T>>, scheme: string, network: Network) => T | undefined;
+/**
+ * Finds a facilitator by scheme and network using pattern matching.
+ * Works with new SchemeData storage structure.
+ *
+ * @param schemeMap - Map of scheme names to SchemeData
+ * @param scheme - The scheme to find
+ * @param network - The network to match against
+ * @returns The facilitator if found, undefined otherwise
+ */
+declare const findFacilitatorBySchemeAndNetwork: <T>(schemeMap: Map<string, SchemeData<T>>, scheme: string, network: Network) => T | undefined;
+declare const Base64EncodedRegex: RegExp;
+/**
+ * Encodes a string to base64 format
+ *
+ * @param data - The string to be encoded to base64
+ * @returns The base64 encoded string
+ */
+declare function safeBase64Encode(data: string): string;
+/**
+ * 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
+ */
+declare function safeBase64Decode(data: string): string;
+/**
+ * Deep equality comparison for payment requirements
+ * Uses a normalized JSON.stringify for consistent comparison
+ *
+ * @param obj1 - First object to compare
+ * @param obj2 - Second object to compare
+ * @returns True if objects are deeply equal
+ */
+declare function deepEqual(obj1: unknown, obj2: unknown): boolean;
+
+export { Base64EncodedRegex, type SchemeData, deepEqual, findByNetworkAndScheme, findFacilitatorBySchemeAndNetwork, findSchemesByNetwork, safeBase64Decode, safeBase64Encode };

package/lib/esm/utils/index.mjs

@@ -0,0 +1,20 @@
+import {
+  Base64EncodedRegex,
+  deepEqual,
+  findByNetworkAndScheme,
+  findFacilitatorBySchemeAndNetwork,
+  findSchemesByNetwork,
+  safeBase64Decode,
+  safeBase64Encode
+} from "../chunk-TDLQZ6MP.mjs";
+import "../chunk-BJTO5JO5.mjs";
+export {
+  Base64EncodedRegex,
+  deepEqual,
+  findByNetworkAndScheme,
+  findFacilitatorBySchemeAndNetwork,
+  findSchemesByNetwork,
+  safeBase64Decode,
+  safeBase64Encode
+};
+//# sourceMappingURL=index.mjs.map

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

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

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

@@ -0,0 +1,12 @@
+export { ExactSvmSchemeV1 } from '../exact/v1/client/index.mjs';
+import '@x402/core/types';
+import '../signer-BMkbhFYE.mjs';
+import '@solana/kit';
+
+/**
+ * V1 exports for the SVM mechanism
+ */
+
+declare const NETWORKS: string[];
+
+export { NETWORKS };

package/lib/esm/v1/index.mjs

@@ -0,0 +1,13 @@
+import {
+  NETWORKS
+} from "../chunk-WWACQNRQ.mjs";
+import {
+  ExactSvmSchemeV1
+} from "../chunk-EEA7DKZI.mjs";
+import "../chunk-3CEIVWNN.mjs";
+import "../chunk-IKSTWKEM.mjs";
+export {
+  ExactSvmSchemeV1,
+  NETWORKS
+};
+//# sourceMappingURL=index.mjs.map

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

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