@t402/svm 2.0.0 → 2.3.1

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

@@ -1,7 +1,7 @@
 import {
   ExactSvmSchemeV1
-} from "../../../chunk-4BFJL7IW.mjs";
-import "../../../chunk-JFN5MEH3.mjs";
+} from "../../../chunk-6M56TEFS.mjs";
+import "../../../chunk-H4JB3QBJ.mjs";
 export {
   ExactSvmSchemeV1
 };

package/dist/esm/index.mjs

@@ -1,6 +1,6 @@
 import {
   ExactSvmScheme
-} from "./chunk-7S5RSPMY.mjs";
+} from "./chunk-BA7IUGUN.mjs";
 import {
   COMPUTE_BUDGET_PROGRAM_ADDRESS,
   DEFAULT_COMPUTE_UNIT_LIMIT,
@@ -29,7 +29,7 @@ import {
   getUsdcAddress,
   normalizeNetwork,
   validateSvmAddress
-} from "./chunk-JFN5MEH3.mjs";
+} from "./chunk-H4JB3QBJ.mjs";
 
 // src/signer.ts
 import { getBase64EncodedWireTransaction } from "@solana/kit";
@@ -68,17 +68,13 @@ function createRpcCapabilitiesFromRpc(rpc) {
       }).send();
     },
     confirmTransaction: async (signature) => {
-      let confirmed = false;
-      let attempts = 0;
       const maxAttempts = 30;
-      while (!confirmed && attempts < maxAttempts) {
+      for (let attempts = 0; attempts < maxAttempts; attempts++) {
         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");
     },

package/dist/esm/index.mjs.map

@@ -1 +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":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAWA,SAAS,uCAAuC;AAkKzC,SAAS,kBAAkB,QAA0C;AAC1E,SAAO;AACT;AAQO,SAAS,6BACd,KAC4B;AAC5B,SAAO;AAAA,IACL,YAAY,OAAM,YAAW;AAC3B,YAAM,SAAS,MAAM,IAAI,WAAW,OAAgB,EAAE,KAAK;AAC3D,aAAO,OAAO;AAAA,IAChB;AAAA,IACA,wBAAwB,OAAM,YAAW;AACvC,YAAM,cAAc,MAAM,IACvB,eAAe,SAAkB;AAAA,QAChC,UAAU;AAAA,MACZ,CAAC,EACA,KAAK;AAER,UAAI,CAAC,YAAY,OAAO;AACtB,cAAM,IAAI,MAAM,4BAA4B,OAAO,EAAE;AAAA,MACvD;AAEA,YAAM,SAAS,YAAY,MAAM;AAGjC,aAAO,OAAO,OAAO,OAAO,KAAK,YAAY,MAAM;AAAA,IACrD;AAAA,IACA,oBAAoB,YAAY;AAC9B,YAAM,SAAS,MAAM,IAAI,mBAAmB,EAAE,KAAK;AACnD,aAAO;AAAA,QACL,WAAW,OAAO,MAAM;AAAA,QACxB,sBAAsB,OAAO,MAAM;AAAA,MACrC;AAAA,IACF;AAAA,IACA,qBAAqB,OAAO,aAAa,WAAW;AAClD,aAAO,MAAM,IAAI,oBAAoB,aAAsB,MAAe,EAAE,KAAK;AAAA,IACnF;AAAA,IACA,iBAAiB,OAAM,gBAAe;AACpC,aAAO,MAAM,IACV,gBAAgB,aAAsB;AAAA,QACrC,UAAU;AAAA,MACZ,CAAC,EACA,KAAK;AAAA,IACV;AAAA,IACA,oBAAoB,OAAM,cAAa;AACrC,UAAI,YAAY;AAChB,UAAI,WAAW;AACf,YAAM,cAAc;AAEpB,aAAO,CAAC,aAAa,WAAW,aAAa;AAC3C,cAAM,SAAS,MAAM,IAAI,qBAAqB,CAAC,SAAkB,CAAC,EAAE,KAAK;AAEzE,YACE,OAAO,MAAM,CAAC,GAAG,uBAAuB,eACxC,OAAO,MAAM,CAAC,GAAG,uBAAuB,aACxC;AACA,sBAAY;AACZ,iBAAO,OAAO,MAAM,CAAC;AAAA,QACvB;AAEA,cAAM,IAAI,QAAQ,aAAW,WAAW,SAAS,GAAI,CAAC;AACtD;AAAA,MACF;AAEA,YAAM,IAAI,MAAM,kCAAkC;AAAA,IACpD;AAAA,IACA,WAAW,OAAM,YAAW;AAC1B,YAAM,EAAE,UAAU,IAAI,MAAM,OAAO,4BAA4B;AAC/D,aAAO,MAAM,UAAU,KAAK,OAAgB;AAAA,IAC9C;AAAA,EACF;AACF;AA0CO,SAAS,uBACd,QACA,WACsB;AACtB,MAAI,SAA+C,CAAC;AACpD,MAAI;AAEJ,MAAI,WAAW;AAEb,QAAI,mBAAmB,aAAa,OAAO,UAAU,kBAAkB,UAAU;AAC/E,sBAAgB,UAAU;AAAA,IAC5B,WAES,gBAAgB,aAAa,aAAa,WAAW;AAC5D,aAAO,GAAG,IAAI;AAAA,IAChB,OAEK;AACH,eAAS;AAAA,IACX;AAAA,EACF;AAEA,QAAM,mBAAmB,CAAC,YAA0C;AAElE,QAAI,OAAO,OAAO,GAAG;AACnB,aAAO,OAAO,OAAO;AAAA,IACvB;AAGA,QAAI,OAAO,GAAG,GAAG;AACf,aAAO,OAAO,GAAG;AAAA,IACnB;AAGA,WAAO,gBAAgB,SAAkC,aAAa;AAAA,EACxE;AAEA,SAAO;AAAA,IACL,cAAc,MAAM;AAClB,aAAO,CAAC,OAAO,OAAO;AAAA,IACxB;AAAA,IAEA,iBAAiB,OAAO,aAAqB,UAAmB,MAAc;AAC5E,UAAI,aAAa,OAAO,SAAS;AAC/B,cAAM,IAAI,MAAM,0BAA0B,QAAQ,gBAAgB,OAAO,OAAO,EAAE;AAAA,MACpF;AAGA,YAAM,KAAK,6BAA6B,EAAE,YAAY,CAAC;AAGvD,YAAM,kBAAkB;AAAA,QACtB,SAAS,GAAG;AAAA,QACZ,YAAY,GAAG;AAAA,MACjB;AAEA,YAAM,CAAC,8BAA8B,IAAI,MAAM,OAAO,aAAa;AAAA,QACjE;AAAA,MACF,CAAC;AAGD,YAAM,gBAAgB;AAAA,QACpB,GAAG;AAAA,QACH,YAAY;AAAA,UACV,GAAG,GAAG;AAAA,UACN,GAAG;AAAA,QACL;AAAA,MACF;AAEA,aAAO,gCAAgC,aAAa;AAAA,IACtD;AAAA,IAEA,qBAAqB,OAAO,aAAqB,YAAoB;AACnE,YAAM,MAAM,iBAAiB,OAAO;AACpC,YAAM,SAAS,MAAM,IAClB,oBAAoB,aAAsB;AAAA,QACzC,WAAW;AAAA,QACX,wBAAwB;AAAA,QACxB,YAAY;AAAA,QACZ,UAAU;AAAA,MACZ,CAAC,EACA,KAAK;AAER,UAAI,OAAO,MAAM,KAAK;AACpB,cAAM,IAAI,MAAM,sBAAsB,KAAK,UAAU,OAAO,MAAM,GAAG,CAAC,EAAE;AAAA,MAC1E;AAAA,IACF;AAAA,IAEA,iBAAiB,OAAO,aAAqB,YAAoB;AAC/D,YAAM,MAAM,iBAAiB,OAAO;AACpC,aAAO,MAAM,IACV,gBAAgB,aAAsB;AAAA,QACrC,UAAU;AAAA,MACZ,CAAC,EACA,KAAK;AAAA,IACV;AAAA,IAEA,oBAAoB,OAAO,WAAmB,YAAoB;AAChE,YAAM,MAAM,iBAAiB,OAAO;AACpC,YAAM,kBAAkB,6BAA6B,GAAG;AACxD,YAAM,gBAAgB,mBAAmB,SAAS;AAAA,IACpD;AAAA,EACF;AACF;","names":[]}
+{"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      const maxAttempts = 30;\n\n      for (let attempts = 0; attempts < maxAttempts; attempts++) {\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          return status.value[0];\n        }\n\n        await new Promise(resolve => setTimeout(resolve, 1000));\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/v1/index.mjs

@@ -3,9 +3,9 @@ import {
 } from "../chunk-WWACQNRQ.mjs";
 import {
   ExactSvmSchemeV1
-} from "../chunk-FPXYRDTG.mjs";
-import "../chunk-4BFJL7IW.mjs";
-import "../chunk-JFN5MEH3.mjs";
+} from "../chunk-H5WQEDGS.mjs";
+import "../chunk-6M56TEFS.mjs";
+import "../chunk-H4JB3QBJ.mjs";
 export {
   ExactSvmSchemeV1,
   NETWORKS

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@t402/svm",
-  "version": "2.0.0",
+  "version": "2.3.1",
   "main": "./dist/cjs/index.js",
   "module": "./dist/esm/index.js",
   "types": "./dist/cjs/index.d.ts",
@@ -24,23 +24,24 @@
     "eslint-plugin-import": "^2.31.0",
     "eslint-plugin-jsdoc": "^50.6.9",
     "eslint-plugin-prettier": "^5.2.6",
+    "glob": "^13.0.0",
     "prettier": "3.5.2",
     "tsup": "^8.4.0",
-    "tsx": "^4.19.2",
+    "tsx": "^4.21.0",
     "typescript": "^5.7.3",
-    "vite": "^6.2.6",
+    "vite": "^7.3.1",
     "vite-tsconfig-paths": "^5.1.4",
-    "vitest": "^3.0.5"
+    "vitest": "^3.2.4"
   },
   "dependencies": {
     "@scure/base": "^1.2.6",
-    "@solana-program/compute-budget": "^0.8.0",
-    "@solana-program/token": "^0.5.1",
-    "@solana-program/token-2022": "^0.4.2",
-    "@solana/kit": "^2.1.1",
-    "@solana/transaction-confirmation": "^2.1.1",
+    "@solana-program/compute-budget": "^0.11.0",
+    "@solana-program/token": "^0.9.0",
+    "@solana-program/token-2022": "^0.6.1",
+    "@solana/kit": "^5.4.0",
+    "@solana/transaction-confirmation": "^5.4.0",
     "zod": "^3.24.2",
-    "@t402/core": "2.0.0"
+    "@t402/core": "2.3.1"
   },
   "exports": {
     ".": {

package/dist/esm/chunk-4BFJL7IW.mjs.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../../src/exact/v1/facilitator/scheme.ts"],"sourcesContent":["import {\n  COMPUTE_BUDGET_PROGRAM_ADDRESS,\n  parseSetComputeUnitLimitInstruction,\n  parseSetComputeUnitPriceInstruction,\n} from \"@solana-program/compute-budget\";\nimport {\n  parseTransferCheckedInstruction as parseTransferCheckedInstructionToken,\n  TOKEN_PROGRAM_ADDRESS,\n} from \"@solana-program/token\";\nimport {\n  findAssociatedTokenPda,\n  parseTransferCheckedInstruction as parseTransferCheckedInstruction2022,\n  TOKEN_2022_PROGRAM_ADDRESS,\n} from \"@solana-program/token-2022\";\nimport {\n  decompileTransactionMessage,\n  getCompiledTransactionMessageDecoder,\n  type Address,\n  type CompiledTransactionMessage,\n} from \"@solana/kit\";\nimport type {\n  PaymentPayload,\n  PaymentRequirements,\n  SchemeNetworkFacilitator,\n  SettleResponse,\n  VerifyResponse,\n} from \"@t402/core/types\";\nimport type { PaymentPayloadV1, PaymentRequirementsV1 } from \"@t402/core/types/v1\";\nimport { MAX_COMPUTE_UNIT_PRICE_MICROLAMPORTS } from \"../../../constants\";\nimport type { FacilitatorSvmSigner } from \"../../../signer\";\nimport type { ExactSvmPayloadV1 } from \"../../../types\";\nimport { decodeTransactionFromPayload, getTokenPayerFromTransaction } from \"../../../utils\";\n\n/**\n * SVM facilitator implementation for the Exact payment scheme (V1).\n */\nexport class ExactSvmSchemeV1 implements SchemeNetworkFacilitator {\n  readonly scheme = \"exact\";\n  readonly caipFamily = \"solana:*\";\n\n  /**\n   * Creates a new ExactSvmFacilitatorV1 instance.\n   *\n   * @param signer - The SVM RPC client for facilitator operations\n   * @returns ExactSvmFacilitatorV1 instance\n   */\n  constructor(private readonly signer: FacilitatorSvmSigner) {}\n\n  /**\n   * Get mechanism-specific extra data for the supported kinds endpoint.\n   * For SVM, this includes a randomly selected fee payer address.\n   * Random selection distributes load across multiple signers.\n   *\n   * @param _ - The network identifier (unused for SVM)\n   * @returns Extra data with feePayer address\n   */\n  getExtra(_: string): Record<string, unknown> | undefined {\n    // Randomly select from available signers to distribute load\n    const addresses = this.signer.getAddresses();\n    const randomIndex = Math.floor(Math.random() * addresses.length);\n\n    return {\n      feePayer: addresses[randomIndex],\n    };\n  }\n\n  /**\n   * Get signer addresses used by this facilitator.\n   * For SVM, returns all available fee payer addresses.\n   *\n   * @param _ - The network identifier (unused for SVM)\n   * @returns Array of fee payer addresses\n   */\n  getSigners(_: string): string[] {\n    return [...this.signer.getAddresses()];\n  }\n\n  /**\n   * Verifies a payment payload (V1).\n   *\n   * @param payload - The payment payload to verify\n   * @param requirements - The payment requirements\n   * @returns Promise resolving to verification response\n   */\n  async verify(\n    payload: PaymentPayload,\n    requirements: PaymentRequirements,\n  ): Promise<VerifyResponse> {\n    const requirementsV1 = requirements as unknown as PaymentRequirementsV1;\n    const payloadV1 = payload as unknown as PaymentPayloadV1;\n    const exactSvmPayload = payload.payload as ExactSvmPayloadV1;\n\n    // Step 1: Validate Payment Requirements\n    if (payloadV1.scheme !== \"exact\" || requirements.scheme !== \"exact\") {\n      return {\n        isValid: false,\n        invalidReason: \"unsupported_scheme\",\n        payer: \"\",\n      };\n    }\n\n    if (payloadV1.network !== requirements.network) {\n      return {\n        isValid: false,\n        invalidReason: \"network_mismatch\",\n        payer: \"\",\n      };\n    }\n\n    if (!requirementsV1.extra?.feePayer || typeof requirementsV1.extra.feePayer !== \"string\") {\n      return {\n        isValid: false,\n        invalidReason: \"invalid_exact_svm_payload_missing_fee_payer\",\n        payer: \"\",\n      };\n    }\n\n    // Verify that the requested feePayer is managed by this facilitator\n    const signerAddresses = this.signer.getAddresses().map(addr => addr.toString());\n    if (!signerAddresses.includes(requirementsV1.extra.feePayer)) {\n      return {\n        isValid: false,\n        invalidReason: \"fee_payer_not_managed_by_facilitator\",\n        payer: \"\",\n      };\n    }\n\n    // Step 2: Parse and Validate Transaction Structure\n    let transaction;\n    try {\n      transaction = decodeTransactionFromPayload(exactSvmPayload);\n    } catch {\n      return {\n        isValid: false,\n        invalidReason: \"invalid_exact_svm_payload_transaction_could_not_be_decoded\",\n        payer: \"\",\n      };\n    }\n\n    const compiled = getCompiledTransactionMessageDecoder().decode(\n      transaction.messageBytes,\n    ) as CompiledTransactionMessage;\n    const decompiled = decompileTransactionMessage(compiled);\n    const instructions = decompiled.instructions ?? [];\n\n    // 3 instructions: ComputeLimit + ComputePrice + TransferChecked\n    if (instructions.length !== 3) {\n      return {\n        isValid: false,\n        invalidReason: \"invalid_exact_svm_payload_transaction_instructions_length\",\n        payer: \"\",\n      };\n    }\n\n    // Step 3: Verify Compute Budget Instructions\n    try {\n      this.verifyComputeLimitInstruction(instructions[0] as never);\n      this.verifyComputePriceInstruction(instructions[1] as never);\n    } catch (error) {\n      const errorMessage = error instanceof Error ? error.message : String(error);\n      return {\n        isValid: false,\n        invalidReason: errorMessage,\n        payer: \"\",\n      };\n    }\n\n    const payer = getTokenPayerFromTransaction(transaction);\n    if (!payer) {\n      return {\n        isValid: false,\n        invalidReason: \"invalid_exact_svm_payload_no_transfer_instruction\",\n        payer: \"\",\n      };\n    }\n\n    // Step 4: Verify Transfer Instruction\n    const transferIx = instructions[2];\n    const programAddress = transferIx.programAddress.toString();\n\n    if (\n      programAddress !== TOKEN_PROGRAM_ADDRESS.toString() &&\n      programAddress !== TOKEN_2022_PROGRAM_ADDRESS.toString()\n    ) {\n      return {\n        isValid: false,\n        invalidReason: \"invalid_exact_svm_payload_no_transfer_instruction\",\n        payer,\n      };\n    }\n\n    // Parse the transfer instruction using the appropriate library helper\n    let parsedTransfer;\n    try {\n      if (programAddress === TOKEN_PROGRAM_ADDRESS.toString()) {\n        parsedTransfer = parseTransferCheckedInstructionToken(transferIx as never);\n      } else {\n        parsedTransfer = parseTransferCheckedInstruction2022(transferIx as never);\n      }\n    } catch {\n      return {\n        isValid: false,\n        invalidReason: \"invalid_exact_svm_payload_no_transfer_instruction\",\n        payer,\n      };\n    }\n\n    // Verify that the facilitator's signers are not transferring their own funds\n    // SECURITY: Prevent facilitator from signing away their own tokens\n    const authorityAddress = parsedTransfer.accounts.authority.address.toString();\n    if (signerAddresses.includes(authorityAddress)) {\n      return {\n        isValid: false,\n        invalidReason: \"invalid_exact_svm_payload_transaction_fee_payer_transferring_funds\",\n        payer,\n      };\n    }\n\n    // Verify mint address matches requirements\n    const mintAddress = parsedTransfer.accounts.mint.address.toString();\n    if (mintAddress !== requirements.asset) {\n      return {\n        isValid: false,\n        invalidReason: \"invalid_exact_svm_payload_mint_mismatch\",\n        payer,\n      };\n    }\n\n    // Verify destination ATA matches expected ATA for payTo address\n    const destATA = parsedTransfer.accounts.destination.address.toString();\n    try {\n      const [expectedDestATA] = await findAssociatedTokenPda({\n        mint: requirements.asset as Address,\n        owner: requirements.payTo as Address,\n        tokenProgram:\n          programAddress === TOKEN_PROGRAM_ADDRESS.toString()\n            ? (TOKEN_PROGRAM_ADDRESS as Address)\n            : (TOKEN_2022_PROGRAM_ADDRESS as Address),\n      });\n\n      if (destATA !== expectedDestATA.toString()) {\n        return {\n          isValid: false,\n          invalidReason: \"invalid_exact_svm_payload_recipient_mismatch\",\n          payer,\n        };\n      }\n    } catch {\n      return {\n        isValid: false,\n        invalidReason: \"invalid_exact_svm_payload_recipient_mismatch\",\n        payer,\n      };\n    }\n\n    // Verify transfer amount meets requirements\n    const amount = parsedTransfer.data.amount;\n    if (amount < BigInt(requirementsV1.maxAmountRequired)) {\n      return {\n        isValid: false,\n        invalidReason: \"invalid_exact_svm_payload_amount_insufficient\",\n        payer,\n      };\n    }\n\n    // Step 5: Sign and Simulate Transaction\n    // CRITICAL: Simulation proves transaction will succeed (catches insufficient balance, invalid accounts, etc)\n    try {\n      const feePayer = requirementsV1.extra.feePayer as Address;\n\n      // Sign transaction with the feePayer's signer\n      const fullySignedTransaction = await this.signer.signTransaction(\n        exactSvmPayload.transaction,\n        feePayer,\n        requirements.network,\n      );\n\n      // Simulate to verify transaction would succeed\n      await this.signer.simulateTransaction(fullySignedTransaction, requirements.network);\n    } catch (error) {\n      const errorMessage = error instanceof Error ? error.message : String(error);\n      return {\n        isValid: false,\n        invalidReason: `transaction_simulation_failed: ${errorMessage}`,\n        payer,\n      };\n    }\n\n    return {\n      isValid: true,\n      invalidReason: undefined,\n      payer,\n    };\n  }\n\n  /**\n   * Settles a payment by submitting the transaction (V1).\n   * Ensures the correct signer is used based on the feePayer specified in requirements.\n   *\n   * @param payload - The payment payload to settle\n   * @param requirements - The payment requirements\n   * @returns Promise resolving to settlement response\n   */\n  async settle(\n    payload: PaymentPayload,\n    requirements: PaymentRequirements,\n  ): Promise<SettleResponse> {\n    const payloadV1 = payload as unknown as PaymentPayloadV1;\n    const exactSvmPayload = payload.payload as ExactSvmPayloadV1;\n\n    const valid = await this.verify(payload, requirements);\n    if (!valid.isValid) {\n      return {\n        success: false,\n        network: payloadV1.network,\n        transaction: \"\",\n        errorReason: valid.invalidReason ?? \"verification_failed\",\n        payer: valid.payer || \"\",\n      };\n    }\n\n    try {\n      // Extract feePayer from requirements (already validated in verify)\n      const feePayer = requirements.extra.feePayer as Address;\n\n      // Sign transaction with the feePayer's signer\n      const fullySignedTransaction = await this.signer.signTransaction(\n        exactSvmPayload.transaction,\n        feePayer,\n        requirements.network,\n      );\n\n      // Send transaction to network\n      const signature = await this.signer.sendTransaction(\n        fullySignedTransaction,\n        requirements.network,\n      );\n\n      // Wait for confirmation\n      await this.signer.confirmTransaction(signature, requirements.network);\n\n      return {\n        success: true,\n        transaction: signature,\n        network: payloadV1.network,\n        payer: valid.payer,\n      };\n    } catch (error) {\n      console.error(\"Failed to settle transaction:\", error);\n      return {\n        success: false,\n        errorReason: \"transaction_failed\",\n        transaction: \"\",\n        network: payloadV1.network,\n        payer: valid.payer || \"\",\n      };\n    }\n  }\n\n  /**\n   * Verify compute limit instruction\n   *\n   * @param instruction - The compute limit instruction\n   * @param instruction.programAddress - Program address\n   * @param instruction.data - Instruction data bytes\n   */\n  private verifyComputeLimitInstruction(instruction: {\n    programAddress: Address;\n    data?: Readonly<Uint8Array>;\n  }): void {\n    const programAddress = instruction.programAddress.toString();\n\n    if (\n      programAddress !== COMPUTE_BUDGET_PROGRAM_ADDRESS.toString() ||\n      !instruction.data ||\n      instruction.data[0] !== 2\n    ) {\n      throw new Error(\n        \"invalid_exact_svm_payload_transaction_instructions_compute_limit_instruction\",\n      );\n    }\n\n    try {\n      parseSetComputeUnitLimitInstruction(instruction as never);\n    } catch {\n      throw new Error(\n        \"invalid_exact_svm_payload_transaction_instructions_compute_limit_instruction\",\n      );\n    }\n  }\n\n  /**\n   * Verify compute price instruction\n   *\n   * @param instruction - The compute price instruction\n   * @param instruction.programAddress - Program address\n   * @param instruction.data - Instruction data bytes\n   */\n  private verifyComputePriceInstruction(instruction: {\n    programAddress: Address;\n    data?: Readonly<Uint8Array>;\n  }): void {\n    const programAddress = instruction.programAddress.toString();\n\n    if (\n      programAddress !== COMPUTE_BUDGET_PROGRAM_ADDRESS.toString() ||\n      !instruction.data ||\n      instruction.data[0] !== 3\n    ) {\n      throw new Error(\n        \"invalid_exact_svm_payload_transaction_instructions_compute_price_instruction\",\n      );\n    }\n\n    try {\n      const parsedInstruction = parseSetComputeUnitPriceInstruction(instruction as never);\n\n      // Check if price exceeds maximum (5 lamports per compute unit)\n      if (\n        (parsedInstruction as unknown as { microLamports: bigint }).microLamports >\n        BigInt(MAX_COMPUTE_UNIT_PRICE_MICROLAMPORTS)\n      ) {\n        throw new Error(\n          \"invalid_exact_svm_payload_transaction_instructions_compute_price_instruction_too_high\",\n        );\n      }\n    } catch (error) {\n      if (error instanceof Error && error.message.includes(\"too_high\")) {\n        throw error;\n      }\n      throw new Error(\n        \"invalid_exact_svm_payload_transaction_instructions_compute_price_instruction\",\n      );\n    }\n  }\n}\n"],"mappings":"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","names":[]}