@t402/svm 2.0.0

package/dist/esm/exact/v1/client/index.mjs.map

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

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

@@ -0,0 +1,71 @@
+import { SchemeNetworkFacilitator, PaymentPayload, PaymentRequirements, VerifyResponse, SettleResponse } from '@t402/core/types';
+import { F as FacilitatorSvmSigner } from '../../../signer-BMkbhFYE.mjs';
+import '@solana/kit';
+
+/**
+ * SVM facilitator implementation for the Exact payment scheme (V1).
+ */
+declare class ExactSvmSchemeV1 implements SchemeNetworkFacilitator {
+    private readonly signer;
+    readonly scheme = "exact";
+    readonly caipFamily = "solana:*";
+    /**
+     * Creates a new ExactSvmFacilitatorV1 instance.
+     *
+     * @param signer - The SVM RPC client for facilitator operations
+     * @returns ExactSvmFacilitatorV1 instance
+     */
+    constructor(signer: FacilitatorSvmSigner);
+    /**
+     * Get mechanism-specific extra data for the supported kinds endpoint.
+     * For SVM, this includes a randomly selected fee payer address.
+     * Random selection distributes load across multiple signers.
+     *
+     * @param _ - The network identifier (unused for SVM)
+     * @returns Extra data with feePayer address
+     */
+    getExtra(_: string): Record<string, unknown> | undefined;
+    /**
+     * Get signer addresses used by this facilitator.
+     * For SVM, returns all available fee payer addresses.
+     *
+     * @param _ - The network identifier (unused for SVM)
+     * @returns Array of fee payer 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 submitting the transaction (V1).
+     * Ensures the correct signer is used based on the feePayer specified in requirements.
+     *
+     * @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>;
+    /**
+     * Verify compute limit instruction
+     *
+     * @param instruction - The compute limit instruction
+     * @param instruction.programAddress - Program address
+     * @param instruction.data - Instruction data bytes
+     */
+    private verifyComputeLimitInstruction;
+    /**
+     * Verify compute price instruction
+     *
+     * @param instruction - The compute price instruction
+     * @param instruction.programAddress - Program address
+     * @param instruction.data - Instruction data bytes
+     */
+    private verifyComputePriceInstruction;
+}
+
+export { ExactSvmSchemeV1 };

package/dist/esm/exact/v1/facilitator/index.mjs

@@ -0,0 +1,8 @@
+import {
+  ExactSvmSchemeV1
+} from "../../../chunk-4BFJL7IW.mjs";
+import "../../../chunk-JFN5MEH3.mjs";
+export {
+  ExactSvmSchemeV1
+};
+//# sourceMappingURL=index.mjs.map

package/dist/esm/exact/v1/facilitator/index.mjs.map

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

package/dist/esm/index.d.mts

@@ -0,0 +1,118 @@
+export { E as ExactSvmScheme } from './scheme-DRerE5zq.mjs';
+export { a as ClientSvmConfig, C as ClientSvmSigner, c as FacilitatorRpcClient, d as FacilitatorRpcConfig, F as FacilitatorSvmSigner, t as toClientSvmSigner, b as toFacilitatorSvmSigner } from './signer-BMkbhFYE.mjs';
+import { Transaction, RpcDevnet, SolanaRpcApiDevnet, RpcTestnet, SolanaRpcApiTestnet, RpcMainnet, SolanaRpcApiMainnet } from '@solana/kit';
+import { Network } from '@t402/core/types';
+
+/**
+ * Exact SVM payload structure containing a base64 encoded Solana transaction
+ */
+type ExactSvmPayloadV1 = {
+    /**
+     * Base64 encoded Solana transaction
+     */
+    transaction: string;
+};
+/**
+ * Exact SVM payload V2 structure (currently same as V1, reserved for future extensions)
+ */
+type ExactSvmPayloadV2 = ExactSvmPayloadV1;
+
+/**
+ * Token program addresses for SPL Token and Token-2022
+ * These addresses are the same across all Solana networks (mainnet, devnet, testnet)
+ */
+declare const TOKEN_PROGRAM_ADDRESS = "TokenkegQfeZyiNwAJbNbGKPFXCWuBvf9Ss623VQ5DA";
+declare const TOKEN_2022_PROGRAM_ADDRESS = "TokenzQdBNbLqP5VEhdkAS6EPFLC1PHnBqCXEpPxuEb";
+declare const COMPUTE_BUDGET_PROGRAM_ADDRESS = "ComputeBudget111111111111111111111111111111";
+/**
+ * Default RPC URLs for Solana networks
+ */
+declare const DEVNET_RPC_URL = "https://api.devnet.solana.com";
+declare const TESTNET_RPC_URL = "https://api.testnet.solana.com";
+declare const MAINNET_RPC_URL = "https://api.mainnet-beta.solana.com";
+declare const DEVNET_WS_URL = "wss://api.devnet.solana.com";
+declare const TESTNET_WS_URL = "wss://api.testnet.solana.com";
+declare const MAINNET_WS_URL = "wss://api.mainnet-beta.solana.com";
+/**
+ * USDC token mint addresses (default stablecoin)
+ */
+declare const USDC_MAINNET_ADDRESS = "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v";
+declare const USDC_DEVNET_ADDRESS = "4zMMC9srt5Ri5X14GAgXhaHii3GnPAEERYPJgZJDncDU";
+declare const USDC_TESTNET_ADDRESS = "4zMMC9srt5Ri5X14GAgXhaHii3GnPAEERYPJgZJDncDU";
+/**
+ * Compute budget configuration
+ * All prices are in microlamports (1 lamport = 1,000,000 microlamports)
+ */
+declare const DEFAULT_COMPUTE_UNIT_PRICE_MICROLAMPORTS = 1;
+declare const MAX_COMPUTE_UNIT_PRICE_MICROLAMPORTS = 5000000;
+declare const DEFAULT_COMPUTE_UNIT_LIMIT = 6500;
+/**
+ * Solana address validation regex (base58, 32-44 characters)
+ */
+declare const SVM_ADDRESS_REGEX: RegExp;
+/**
+ * CAIP-2 network identifiers for Solana (V2)
+ */
+declare const SOLANA_MAINNET_CAIP2 = "solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp";
+declare const SOLANA_DEVNET_CAIP2 = "solana:EtWTRABZaYq6iMfeYKouRu166VU2xqa1";
+declare const SOLANA_TESTNET_CAIP2 = "solana:4uhcVJyU9pJkvQyS88uRDiswHXSCkY3z";
+/**
+ * V1 to V2 network identifier mappings (for backwards compatibility)
+ * V1 used simple names like solana, V2 uses CAIP-2
+ */
+declare const V1_TO_V2_NETWORK_MAP: Record<string, string>;
+
+/**
+ * Normalize network identifier to CAIP-2 format
+ * Handles both V1 names (solana, solana-devnet) and V2 CAIP-2 format
+ *
+ * @param network - Network identifier (V1 or V2 format)
+ * @returns CAIP-2 network identifier
+ */
+declare function normalizeNetwork(network: Network): string;
+/**
+ * Validate Solana address format
+ *
+ * @param address - Base58 encoded address string
+ * @returns true if address is valid, false otherwise
+ */
+declare function validateSvmAddress(address: string): boolean;
+/**
+ * Decode a base64 encoded transaction from an SVM payload
+ *
+ * @param svmPayload - The SVM payload containing a base64 encoded transaction
+ * @returns Decoded Transaction object
+ */
+declare function decodeTransactionFromPayload(svmPayload: ExactSvmPayloadV1): Transaction;
+/**
+ * Extract the token sender (owner of the source token account) from a TransferChecked instruction
+ *
+ * @param transaction - The decoded transaction
+ * @returns The token payer address as a base58 string
+ */
+declare function getTokenPayerFromTransaction(transaction: Transaction): string;
+/**
+ * Create an RPC client for the specified network
+ *
+ * @param network - Network identifier (CAIP-2 or V1 format)
+ * @param customRpcUrl - Optional custom RPC URL
+ * @returns RPC client for the specified network
+ */
+declare function createRpcClient(network: Network, customRpcUrl?: string): RpcDevnet<SolanaRpcApiDevnet> | RpcTestnet<SolanaRpcApiTestnet> | RpcMainnet<SolanaRpcApiMainnet>;
+/**
+ * Get the default USDC mint address for a network
+ *
+ * @param network - Network identifier (CAIP-2 or V1 format)
+ * @returns USDC mint address for the network
+ */
+declare function getUsdcAddress(network: Network): string;
+/**
+ * Convert a decimal amount to token smallest units
+ *
+ * @param decimalAmount - The decimal amount (e.g., "0.10")
+ * @param decimals - The number of decimals for the token (e.g., 6 for USDC)
+ * @returns The amount in smallest units as a string
+ */
+declare function convertToTokenAmount(decimalAmount: string, decimals: number): string;
+
+export { COMPUTE_BUDGET_PROGRAM_ADDRESS, DEFAULT_COMPUTE_UNIT_LIMIT, DEFAULT_COMPUTE_UNIT_PRICE_MICROLAMPORTS, DEVNET_RPC_URL, DEVNET_WS_URL, type ExactSvmPayloadV1, type ExactSvmPayloadV2, MAINNET_RPC_URL, MAINNET_WS_URL, MAX_COMPUTE_UNIT_PRICE_MICROLAMPORTS, SOLANA_DEVNET_CAIP2, SOLANA_MAINNET_CAIP2, SOLANA_TESTNET_CAIP2, SVM_ADDRESS_REGEX, TESTNET_RPC_URL, TESTNET_WS_URL, TOKEN_2022_PROGRAM_ADDRESS, TOKEN_PROGRAM_ADDRESS, USDC_DEVNET_ADDRESS, USDC_MAINNET_ADDRESS, USDC_TESTNET_ADDRESS, V1_TO_V2_NETWORK_MAP, convertToTokenAmount, createRpcClient, decodeTransactionFromPayload, getTokenPayerFromTransaction, getUsdcAddress, normalizeNetwork, validateSvmAddress };

package/dist/esm/index.mjs

@@ -0,0 +1,194 @@
+import {
+  ExactSvmScheme
+} from "./chunk-7S5RSPMY.mjs";
+import {
+  COMPUTE_BUDGET_PROGRAM_ADDRESS,
+  DEFAULT_COMPUTE_UNIT_LIMIT,
+  DEFAULT_COMPUTE_UNIT_PRICE_MICROLAMPORTS,
+  DEVNET_RPC_URL,
+  DEVNET_WS_URL,
+  MAINNET_RPC_URL,
+  MAINNET_WS_URL,
+  MAX_COMPUTE_UNIT_PRICE_MICROLAMPORTS,
+  SOLANA_DEVNET_CAIP2,
+  SOLANA_MAINNET_CAIP2,
+  SOLANA_TESTNET_CAIP2,
+  SVM_ADDRESS_REGEX,
+  TESTNET_RPC_URL,
+  TESTNET_WS_URL,
+  TOKEN_2022_PROGRAM_ADDRESS,
+  TOKEN_PROGRAM_ADDRESS,
+  USDC_DEVNET_ADDRESS,
+  USDC_MAINNET_ADDRESS,
+  USDC_TESTNET_ADDRESS,
+  V1_TO_V2_NETWORK_MAP,
+  convertToTokenAmount,
+  createRpcClient,
+  decodeTransactionFromPayload,
+  getTokenPayerFromTransaction,
+  getUsdcAddress,
+  normalizeNetwork,
+  validateSvmAddress
+} from "./chunk-JFN5MEH3.mjs";
+
+// src/signer.ts
+import { getBase64EncodedWireTransaction } from "@solana/kit";
+function toClientSvmSigner(signer) {
+  return signer;
+}
+function createRpcCapabilitiesFromRpc(rpc) {
+  return {
+    getBalance: async (address) => {
+      const result = await rpc.getBalance(address).send();
+      return result.value;
+    },
+    getTokenAccountBalance: async (address) => {
+      const accountInfo = await rpc.getAccountInfo(address, {
+        encoding: "jsonParsed"
+      }).send();
+      if (!accountInfo.value) {
+        throw new Error(`Token account not found: ${address}`);
+      }
+      const parsed = accountInfo.value.data;
+      return BigInt(parsed.parsed.info.tokenAmount.amount);
+    },
+    getLatestBlockhash: async () => {
+      const result = await rpc.getLatestBlockhash().send();
+      return {
+        blockhash: result.value.blockhash,
+        lastValidBlockHeight: result.value.lastValidBlockHeight
+      };
+    },
+    simulateTransaction: async (transaction, config) => {
+      return await rpc.simulateTransaction(transaction, config).send();
+    },
+    sendTransaction: async (transaction) => {
+      return await rpc.sendTransaction(transaction, {
+        encoding: "base64"
+      }).send();
+    },
+    confirmTransaction: async (signature) => {
+      let confirmed = false;
+      let attempts = 0;
+      const maxAttempts = 30;
+      while (!confirmed && attempts < maxAttempts) {
+        const status = await rpc.getSignatureStatuses([signature]).send();
+        if (status.value[0]?.confirmationStatus === "confirmed" || status.value[0]?.confirmationStatus === "finalized") {
+          confirmed = true;
+          return status.value[0];
+        }
+        await new Promise((resolve) => setTimeout(resolve, 1e3));
+        attempts++;
+      }
+      throw new Error("Transaction confirmation timeout");
+    },
+    fetchMint: async (address) => {
+      const { fetchMint } = await import("@solana-program/token-2022");
+      return await fetchMint(rpc, address);
+    }
+  };
+}
+function toFacilitatorSvmSigner(signer, rpcConfig) {
+  let rpcMap = {};
+  let defaultRpcUrl;
+  if (rpcConfig) {
+    if ("defaultRpcUrl" in rpcConfig && typeof rpcConfig.defaultRpcUrl === "string") {
+      defaultRpcUrl = rpcConfig.defaultRpcUrl;
+    } else if ("getBalance" in rpcConfig || "getSlot" in rpcConfig) {
+      rpcMap["*"] = rpcConfig;
+    } else {
+      rpcMap = rpcConfig;
+    }
+  }
+  const getRpcForNetwork = (network) => {
+    if (rpcMap[network]) {
+      return rpcMap[network];
+    }
+    if (rpcMap["*"]) {
+      return rpcMap["*"];
+    }
+    return createRpcClient(network, defaultRpcUrl);
+  };
+  return {
+    getAddresses: () => {
+      return [signer.address];
+    },
+    signTransaction: async (transaction, feePayer, _) => {
+      if (feePayer !== signer.address) {
+        throw new Error(`No signer for feePayer ${feePayer}. Available: ${signer.address}`);
+      }
+      const tx = decodeTransactionFromPayload({ transaction });
+      const signableMessage = {
+        content: tx.messageBytes,
+        signatures: tx.signatures
+      };
+      const [facilitatorSignatureDictionary] = await signer.signMessages([
+        signableMessage
+      ]);
+      const fullySignedTx = {
+        ...tx,
+        signatures: {
+          ...tx.signatures,
+          ...facilitatorSignatureDictionary
+        }
+      };
+      return getBase64EncodedWireTransaction(fullySignedTx);
+    },
+    simulateTransaction: async (transaction, network) => {
+      const rpc = getRpcForNetwork(network);
+      const result = await rpc.simulateTransaction(transaction, {
+        sigVerify: true,
+        replaceRecentBlockhash: false,
+        commitment: "confirmed",
+        encoding: "base64"
+      }).send();
+      if (result.value.err) {
+        throw new Error(`Simulation failed: ${JSON.stringify(result.value.err)}`);
+      }
+    },
+    sendTransaction: async (transaction, network) => {
+      const rpc = getRpcForNetwork(network);
+      return await rpc.sendTransaction(transaction, {
+        encoding: "base64"
+      }).send();
+    },
+    confirmTransaction: async (signature, network) => {
+      const rpc = getRpcForNetwork(network);
+      const rpcCapabilities = createRpcCapabilitiesFromRpc(rpc);
+      await rpcCapabilities.confirmTransaction(signature);
+    }
+  };
+}
+export {
+  COMPUTE_BUDGET_PROGRAM_ADDRESS,
+  DEFAULT_COMPUTE_UNIT_LIMIT,
+  DEFAULT_COMPUTE_UNIT_PRICE_MICROLAMPORTS,
+  DEVNET_RPC_URL,
+  DEVNET_WS_URL,
+  ExactSvmScheme,
+  MAINNET_RPC_URL,
+  MAINNET_WS_URL,
+  MAX_COMPUTE_UNIT_PRICE_MICROLAMPORTS,
+  SOLANA_DEVNET_CAIP2,
+  SOLANA_MAINNET_CAIP2,
+  SOLANA_TESTNET_CAIP2,
+  SVM_ADDRESS_REGEX,
+  TESTNET_RPC_URL,
+  TESTNET_WS_URL,
+  TOKEN_2022_PROGRAM_ADDRESS,
+  TOKEN_PROGRAM_ADDRESS,
+  USDC_DEVNET_ADDRESS,
+  USDC_MAINNET_ADDRESS,
+  USDC_TESTNET_ADDRESS,
+  V1_TO_V2_NETWORK_MAP,
+  convertToTokenAmount,
+  createRpcClient,
+  decodeTransactionFromPayload,
+  getTokenPayerFromTransaction,
+  getUsdcAddress,
+  normalizeNetwork,
+  toClientSvmSigner,
+  toFacilitatorSvmSigner,
+  validateSvmAddress
+};
+//# sourceMappingURL=index.mjs.map

package/dist/esm/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/signer.ts"],"sourcesContent":["import type {\n  TransactionSigner,\n  MessagePartialSigner,\n  RpcDevnet,\n  SolanaRpcApiDevnet,\n  RpcTestnet,\n  SolanaRpcApiTestnet,\n  RpcMainnet,\n  SolanaRpcApiMainnet,\n  Address,\n} from \"@solana/kit\";\nimport { getBase64EncodedWireTransaction } from \"@solana/kit\";\nimport { createRpcClient, decodeTransactionFromPayload } from \"./utils\";\n\n/**\n * Client-side signer for creating and signing Solana transactions\n * This is a wrapper around TransactionSigner from @solana/kit\n */\nexport type ClientSvmSigner = TransactionSigner;\n\n/**\n * Configuration for client operations\n */\nexport type ClientSvmConfig = {\n  /**\n   * Optional custom RPC URL for the client to use\n   */\n  rpcUrl?: string;\n};\n\n/**\n * Signing capabilities needed by the facilitator\n * Must support both transaction and message signing\n * KeyPairSigner from @solana/kit satisfies this interface\n */\nexport type FacilitatorSigningCapabilities = TransactionSigner & MessagePartialSigner;\n\n/**\n * RPC client type from @solana/kit\n * Can be devnet, testnet, or mainnet RPC client\n */\nexport type FacilitatorRpcClient =\n  | RpcDevnet<SolanaRpcApiDevnet>\n  | RpcTestnet<SolanaRpcApiTestnet>\n  | RpcMainnet<SolanaRpcApiMainnet>;\n\n/**\n * RPC capabilities needed by the facilitator for verification and settlement\n * This is a legacy interface for custom RPC implementations\n */\nexport type FacilitatorRpcCapabilities = {\n  /**\n   * Get the SOL balance of an account\n   *\n   * @param address - Base58 encoded address\n   * @returns Balance in lamports\n   */\n  getBalance(address: string): Promise<bigint>;\n\n  /**\n   * Get the token account balance\n   *\n   * @param address - Base58 encoded token account address\n   * @returns Token balance in smallest units\n   */\n  getTokenAccountBalance(address: string): Promise<bigint>;\n\n  /**\n   * Get the latest blockhash information\n   *\n   * @returns Blockhash and last valid block height\n   */\n  getLatestBlockhash(): Promise<{ blockhash: string; lastValidBlockHeight: bigint }>;\n\n  /**\n   * Simulate a transaction to check if it would succeed\n   *\n   * @param transaction - Base64 encoded transaction\n   * @param config - Simulation configuration\n   * @returns Simulation result\n   */\n  simulateTransaction(transaction: string, config: unknown): Promise<unknown>;\n\n  /**\n   * Send a transaction to the network\n   *\n   * @param transaction - Base64 encoded signed transaction\n   * @returns Transaction signature\n   */\n  sendTransaction(transaction: string): Promise<string>;\n\n  /**\n   * Wait for transaction confirmation\n   *\n   * @param signature - Transaction signature\n   * @returns Confirmation result\n   */\n  confirmTransaction(signature: string): Promise<unknown>;\n\n  /**\n   * Fetch token mint information\n   *\n   * @param address - Base58 encoded mint address\n   * @returns Mint information including decimals\n   */\n  fetchMint(address: string): Promise<unknown>;\n};\n\n/**\n * Minimal facilitator signer interface for SVM operations.\n * Supports multiple signers for load balancing and high availability.\n * All implementation details (RPC clients, key management, signature handling) are hidden.\n */\nexport type FacilitatorSvmSigner = {\n  /**\n   * Get all addresses this facilitator can use as fee payers\n   * Enables dynamic address selection for load balancing and key rotation\n   *\n   * @returns Array of addresses available for signing\n   */\n  getAddresses(): readonly Address[];\n\n  /**\n   * Sign a partially-signed transaction with the signer matching feePayer\n   * Transaction is decoded, signed, and re-encoded internally\n   *\n   * @param transaction - Base64 encoded partially-signed transaction\n   * @param feePayer - Fee payer address (determines which signer to use)\n   * @param network - CAIP-2 network identifier\n   * @returns Base64 encoded fully-signed transaction\n   * @throws Error if no signer exists for feePayer or signing fails\n   */\n  signTransaction(transaction: string, feePayer: Address, network: string): Promise<string>;\n\n  /**\n   * Simulate a signed transaction to verify it would succeed\n   * Implementation manages RPC client selection and simulation details\n   *\n   * @param transaction - Base64 encoded signed transaction\n   * @param network - CAIP-2 network identifier\n   * @throws Error if simulation fails\n   */\n  simulateTransaction(transaction: string, network: string): Promise<void>;\n\n  /**\n   * Send a signed transaction to the network\n   * Implementation manages RPC client selection and sending details\n   *\n   * @param transaction - Base64 encoded signed transaction\n   * @param network - CAIP-2 network identifier\n   * @returns Transaction signature\n   * @throws Error if send fails\n   */\n  sendTransaction(transaction: string, network: string): Promise<string>;\n\n  /**\n   * Wait for transaction confirmation\n   * Allows signer to implement custom retry logic, timeouts, and confirmation strategies\n   *\n   * @param signature - Transaction signature to confirm\n   * @param network - CAIP-2 network identifier\n   * @returns Promise that resolves when transaction is confirmed\n   * @throws Error if confirmation fails or times out\n   */\n  confirmTransaction(signature: string, network: string): Promise<void>;\n};\n\n/**\n * Convert a signer to ClientSvmSigner (identity function for type safety)\n *\n * @param signer - The signer to convert\n * @returns The signer as ClientSvmSigner\n */\nexport function toClientSvmSigner(signer: ClientSvmSigner): ClientSvmSigner {\n  return signer;\n}\n\n/**\n * Create RPC capabilities from a Solana Kit RPC client\n *\n * @param rpc - The RPC client from @solana/kit\n * @returns RPC capabilities for the facilitator\n */\nexport function createRpcCapabilitiesFromRpc(\n  rpc: FacilitatorRpcClient,\n): FacilitatorRpcCapabilities {\n  return {\n    getBalance: async address => {\n      const result = await rpc.getBalance(address as never).send();\n      return result.value;\n    },\n    getTokenAccountBalance: async address => {\n      const accountInfo = await rpc\n        .getAccountInfo(address as never, {\n          encoding: \"jsonParsed\",\n        })\n        .send();\n\n      if (!accountInfo.value) {\n        throw new Error(`Token account not found: ${address}`);\n      }\n\n      const parsed = accountInfo.value.data as {\n        parsed: { info: { tokenAmount: { amount: string } } };\n      };\n      return BigInt(parsed.parsed.info.tokenAmount.amount);\n    },\n    getLatestBlockhash: async () => {\n      const result = await rpc.getLatestBlockhash().send();\n      return {\n        blockhash: result.value.blockhash,\n        lastValidBlockHeight: result.value.lastValidBlockHeight,\n      };\n    },\n    simulateTransaction: async (transaction, config) => {\n      return await rpc.simulateTransaction(transaction as never, config as never).send();\n    },\n    sendTransaction: async transaction => {\n      return await rpc\n        .sendTransaction(transaction as never, {\n          encoding: \"base64\",\n        })\n        .send();\n    },\n    confirmTransaction: async signature => {\n      let confirmed = false;\n      let attempts = 0;\n      const maxAttempts = 30;\n\n      while (!confirmed && attempts < maxAttempts) {\n        const status = await rpc.getSignatureStatuses([signature as never]).send();\n\n        if (\n          status.value[0]?.confirmationStatus === \"confirmed\" ||\n          status.value[0]?.confirmationStatus === \"finalized\"\n        ) {\n          confirmed = true;\n          return status.value[0];\n        }\n\n        await new Promise(resolve => setTimeout(resolve, 1000));\n        attempts++;\n      }\n\n      throw new Error(\"Transaction confirmation timeout\");\n    },\n    fetchMint: async address => {\n      const { fetchMint } = await import(\"@solana-program/token-2022\");\n      return await fetchMint(rpc, address as never);\n    },\n  };\n}\n\n/**\n * RPC configuration for the facilitator\n * Can be a single RPC (all networks), a network mapping, or config options\n */\nexport type FacilitatorRpcConfig =\n  | FacilitatorRpcClient // Single RPC for all networks\n  | Record<string, FacilitatorRpcClient> // Per-network RPC mapping\n  | { defaultRpcUrl?: string }; // Custom default RPC URL\n\n/**\n * Create a FacilitatorSvmSigner from a TransactionSigner and optional RPC config\n *\n * @param signer - The TransactionSigner (e.g., from createKeyPairSignerFromBytes)\n * @param rpcConfig - Optional RPC configuration (single RPC, per-network map, or config)\n * @returns A complete FacilitatorSvmSigner\n *\n * @example\n * ```ts\n * import { createKeyPairSignerFromBytes, createSolanaRpc, devnet } from \"@solana/kit\";\n *\n * // Option 1: No RPC - use defaults (SIMPLEST)\n * const keypair = await createKeyPairSignerFromBytes(privateKeyBytes);\n * const facilitator = toFacilitatorSvmSigner(keypair);\n *\n * // Option 2: Single RPC for all networks\n * const rpc = createSolanaRpc(devnet(\"https://api.devnet.solana.com\"));\n * const facilitator = toFacilitatorSvmSigner(keypair, rpc);\n *\n * // Option 3: Per-network RPC (FLEXIBLE)\n * const facilitator = toFacilitatorSvmSigner(keypair, {\n *   [SOLANA_MAINNET_CAIP2]: myQuickNodeRpc,\n *   // Devnet/testnet use defaults\n * });\n *\n * // Option 4: Custom default RPC URL\n * const facilitator = toFacilitatorSvmSigner(keypair, {\n *   defaultRpcUrl: \"https://my-rpc.com\"\n * });\n * ```\n */\nexport function toFacilitatorSvmSigner(\n  signer: TransactionSigner & MessagePartialSigner,\n  rpcConfig?: FacilitatorRpcConfig,\n): FacilitatorSvmSigner {\n  let rpcMap: Record<string, FacilitatorRpcClient> = {};\n  let defaultRpcUrl: string | undefined;\n\n  if (rpcConfig) {\n    // Check if it's a config object with defaultRpcUrl\n    if (\"defaultRpcUrl\" in rpcConfig && typeof rpcConfig.defaultRpcUrl === \"string\") {\n      defaultRpcUrl = rpcConfig.defaultRpcUrl;\n    }\n    // Check if it's a single RPC client\n    else if (\"getBalance\" in rpcConfig || \"getSlot\" in rpcConfig) {\n      rpcMap[\"*\"] = rpcConfig as FacilitatorRpcClient;\n    }\n    // Otherwise, it's a network mapping\n    else {\n      rpcMap = rpcConfig as Record<string, FacilitatorRpcClient>;\n    }\n  }\n\n  const getRpcForNetwork = (network: string): FacilitatorRpcClient => {\n    // 1. Check for exact network match\n    if (rpcMap[network]) {\n      return rpcMap[network];\n    }\n\n    // 2. Check for wildcard RPC\n    if (rpcMap[\"*\"]) {\n      return rpcMap[\"*\"];\n    }\n\n    // 3. Create default RPC for this network\n    return createRpcClient(network as `${string}:${string}`, defaultRpcUrl);\n  };\n\n  return {\n    getAddresses: () => {\n      return [signer.address];\n    },\n\n    signTransaction: async (transaction: string, feePayer: Address, _: string) => {\n      if (feePayer !== signer.address) {\n        throw new Error(`No signer for feePayer ${feePayer}. Available: ${signer.address}`);\n      }\n\n      // Decode transaction from base64\n      const tx = decodeTransactionFromPayload({ transaction });\n\n      // Sign the transaction\n      const signableMessage = {\n        content: tx.messageBytes,\n        signatures: tx.signatures,\n      };\n\n      const [facilitatorSignatureDictionary] = await signer.signMessages([\n        signableMessage as never,\n      ]);\n\n      // Merge signatures and encode\n      const fullySignedTx = {\n        ...tx,\n        signatures: {\n          ...tx.signatures,\n          ...facilitatorSignatureDictionary,\n        },\n      };\n\n      return getBase64EncodedWireTransaction(fullySignedTx);\n    },\n\n    simulateTransaction: async (transaction: string, network: string) => {\n      const rpc = getRpcForNetwork(network);\n      const result = await rpc\n        .simulateTransaction(transaction as never, {\n          sigVerify: true,\n          replaceRecentBlockhash: false,\n          commitment: \"confirmed\",\n          encoding: \"base64\",\n        })\n        .send();\n\n      if (result.value.err) {\n        throw new Error(`Simulation failed: ${JSON.stringify(result.value.err)}`);\n      }\n    },\n\n    sendTransaction: async (transaction: string, network: string) => {\n      const rpc = getRpcForNetwork(network);\n      return await rpc\n        .sendTransaction(transaction as never, {\n          encoding: \"base64\",\n        })\n        .send();\n    },\n\n    confirmTransaction: async (signature: string, network: string) => {\n      const rpc = getRpcForNetwork(network);\n      const rpcCapabilities = createRpcCapabilitiesFromRpc(rpc);\n      await rpcCapabilities.confirmTransaction(signature);\n    },\n  };\n}\n"],"mappings":"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","names":[]}

package/dist/esm/scheme-DRerE5zq.d.mts

@@ -0,0 +1,29 @@
+import { SchemeNetworkClient, PaymentRequirements, PaymentPayload } from '@t402/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 t402Version - The t402 protocol version
+     * @param paymentRequirements - The payment requirements
+     * @returns Promise resolving to a payment payload
+     */
+    createPaymentPayload(t402Version: number, paymentRequirements: PaymentRequirements): Promise<Pick<PaymentPayload, "t402Version" | "payload">>;
+}
+
+export { ExactSvmScheme as E };

package/dist/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/dist/esm/v1/index.d.mts

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

package/dist/esm/v1/index.mjs

@@ -0,0 +1,13 @@
+import {
+  NETWORKS
+} from "../chunk-WWACQNRQ.mjs";
+import {
+  ExactSvmSchemeV1
+} from "../chunk-FPXYRDTG.mjs";
+import "../chunk-4BFJL7IW.mjs";
+import "../chunk-JFN5MEH3.mjs";
+export {
+  ExactSvmSchemeV1,
+  NETWORKS
+};
+//# sourceMappingURL=index.mjs.map

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

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