@x402/svm 2.5.0 → 2.7.0

package/dist/cjs/v1/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../src/v1/index.ts","../../../src/exact/v1/client/scheme.ts","../../../src/constants.ts","../../../src/utils.ts","../../../src/exact/v1/facilitator/scheme.ts"],"sourcesContent":["/**\n * V1 exports for the SVM mechanism\n */\nexport { ExactSvmSchemeV1 } from \"../exact/v1\";\n\nexport const NETWORKS: string[] = [\"solana\", \"solana-devnet\", \"solana-testnet\"];\n","import {\n  getSetComputeUnitLimitInstruction,\n  setTransactionMessageComputeUnitPrice,\n} from \"@solana-program/compute-budget\";\nimport { TOKEN_PROGRAM_ADDRESS } from \"@solana-program/token\";\nimport {\n  fetchMint,\n  findAssociatedTokenPda,\n  getTransferCheckedInstruction,\n  TOKEN_2022_PROGRAM_ADDRESS,\n} from \"@solana-program/token-2022\";\nimport {\n  appendTransactionMessageInstructions,\n  createTransactionMessage,\n  getBase64EncodedWireTransaction,\n  partiallySignTransactionMessageWithSigners,\n  pipe,\n  prependTransactionMessageInstruction,\n  setTransactionMessageFeePayer,\n  setTransactionMessageLifetimeUsingBlockhash,\n  type Address,\n} from \"@solana/kit\";\nimport type {\n  Network,\n  PaymentPayload,\n  PaymentRequirements,\n  SchemeNetworkClient,\n} from \"@x402/core/types\";\nimport type { PaymentRequirementsV1 } from \"@x402/core/types/v1\";\nimport {\n  DEFAULT_COMPUTE_UNIT_LIMIT,\n  DEFAULT_COMPUTE_UNIT_PRICE_MICROLAMPORTS,\n  MEMO_PROGRAM_ADDRESS,\n} from \"../../../constants\";\nimport type { ClientSvmConfig, ClientSvmSigner } from \"../../../signer\";\nimport type { ExactSvmPayloadV1 } from \"../../../types\";\nimport { createRpcClient } from \"../../../utils\";\n\n/**\n * SVM client implementation for the Exact payment scheme (V1).\n */\nexport class ExactSvmSchemeV1 implements SchemeNetworkClient {\n  readonly scheme = \"exact\";\n\n  /**\n   * Creates a new ExactSvmClientV1 instance.\n   *\n   * @param signer - The SVM signer for client operations\n   * @param config - Optional configuration with custom RPC URL\n   * @returns ExactSvmClientV1 instance\n   */\n  constructor(\n    private readonly signer: ClientSvmSigner,\n    private readonly config?: ClientSvmConfig,\n  ) {}\n\n  /**\n   * Creates a payment payload for the Exact scheme (V1).\n   *\n   * @param x402Version - The x402 protocol version\n   * @param paymentRequirements - The payment requirements\n   * @returns Promise resolving to a payment payload\n   */\n  async createPaymentPayload(\n    x402Version: number,\n    paymentRequirements: PaymentRequirements,\n  ): Promise<\n    Pick<PaymentPayload, \"x402Version\" | \"payload\"> & { scheme: string; network: Network }\n  > {\n    const selectedV1 = paymentRequirements as unknown as PaymentRequirementsV1;\n    const rpc = createRpcClient(selectedV1.network, this.config?.rpcUrl);\n\n    const tokenMint = await fetchMint(rpc, selectedV1.asset as Address);\n    const tokenProgramAddress = tokenMint.programAddress;\n\n    if (\n      tokenProgramAddress.toString() !== TOKEN_PROGRAM_ADDRESS.toString() &&\n      tokenProgramAddress.toString() !== TOKEN_2022_PROGRAM_ADDRESS.toString()\n    ) {\n      throw new Error(\"Asset was not created by a known token program\");\n    }\n\n    const [sourceATA] = await findAssociatedTokenPda({\n      mint: selectedV1.asset as Address,\n      owner: this.signer.address,\n      tokenProgram: tokenProgramAddress,\n    });\n\n    const [destinationATA] = await findAssociatedTokenPda({\n      mint: selectedV1.asset as Address,\n      owner: selectedV1.payTo as Address,\n      tokenProgram: tokenProgramAddress,\n    });\n\n    const transferIx = getTransferCheckedInstruction(\n      {\n        source: sourceATA,\n        mint: selectedV1.asset as Address,\n        destination: destinationATA,\n        authority: this.signer,\n        amount: BigInt(selectedV1.maxAmountRequired),\n        decimals: tokenMint.data.decimals,\n      },\n      { programAddress: tokenProgramAddress },\n    );\n\n    // Facilitator must provide feePayer to cover transaction fees\n    const feePayer = selectedV1.extra?.feePayer as Address;\n    if (!feePayer) {\n      throw new Error(\"feePayer is required in paymentRequirements.extra for SVM transactions\");\n    }\n\n    const { value: latestBlockhash } = await rpc.getLatestBlockhash().send();\n\n    const nonce = crypto.getRandomValues(new Uint8Array(16));\n    const memoIx = {\n      programAddress: MEMO_PROGRAM_ADDRESS as Address,\n      accounts: [] as const,\n      data: new TextEncoder().encode(\n        Array.from(nonce)\n          .map(b => b.toString(16).padStart(2, \"0\"))\n          .join(\"\"),\n      ),\n    };\n\n    const tx = pipe(\n      createTransactionMessage({ version: 0 }),\n      tx => setTransactionMessageComputeUnitPrice(DEFAULT_COMPUTE_UNIT_PRICE_MICROLAMPORTS, tx),\n      tx => setTransactionMessageFeePayer(feePayer, tx),\n      tx =>\n        prependTransactionMessageInstruction(\n          getSetComputeUnitLimitInstruction({ units: DEFAULT_COMPUTE_UNIT_LIMIT }),\n          tx,\n        ),\n      tx => appendTransactionMessageInstructions([transferIx, memoIx], tx),\n      tx => setTransactionMessageLifetimeUsingBlockhash(latestBlockhash, tx),\n    );\n\n    const signedTransaction = await partiallySignTransactionMessageWithSigners(tx);\n    const base64EncodedWireTransaction = getBase64EncodedWireTransaction(signedTransaction);\n\n    const payload: ExactSvmPayloadV1 = {\n      transaction: base64EncodedWireTransaction,\n    };\n\n    return {\n      x402Version,\n      scheme: selectedV1.scheme,\n      network: selectedV1.network,\n      payload,\n    };\n  }\n}\n","/**\n * Token program addresses for SPL Token and Token-2022\n * These addresses are the same across all Solana networks (mainnet, devnet, testnet)\n */\nexport const TOKEN_PROGRAM_ADDRESS = \"TokenkegQfeZyiNwAJbNbGKPFXCWuBvf9Ss623VQ5DA\";\nexport const TOKEN_2022_PROGRAM_ADDRESS = \"TokenzQdBNbLqP5VEhdkAS6EPFLC1PHnBqCXEpPxuEb\";\nexport const COMPUTE_BUDGET_PROGRAM_ADDRESS = \"ComputeBudget111111111111111111111111111111\";\nexport const MEMO_PROGRAM_ADDRESS = \"MemoSq4gqABAXKb96qnH8TysNcWxMyWCqXgDLGmfcHr\";\n\n/**\n * Phantom/Solflare Lighthouse program address\n * Phantom and Solflare wallets inject Lighthouse instructions for user protection on mainnet transactions.\n * - Phantom adds 1 Lighthouse instruction (4th instruction)\n * - Solflare adds 2 Lighthouse instructions (4th and 5th instructions)\n * We allow these as optional instructions to support these wallets.\n * See: https://github.com/coinbase/x402/issues/828\n */\nexport const LIGHTHOUSE_PROGRAM_ADDRESS = \"L2TExMFKdjpN9kozasaurPirfHy9P8sbXoAN1qA3S95\";\n\n/**\n * Default RPC URLs for Solana networks\n */\nexport const DEVNET_RPC_URL = \"https://api.devnet.solana.com\";\nexport const TESTNET_RPC_URL = \"https://api.testnet.solana.com\";\nexport const MAINNET_RPC_URL = \"https://api.mainnet-beta.solana.com\";\nexport const DEVNET_WS_URL = \"wss://api.devnet.solana.com\";\nexport const TESTNET_WS_URL = \"wss://api.testnet.solana.com\";\nexport const MAINNET_WS_URL = \"wss://api.mainnet-beta.solana.com\";\n\n/**\n * USDC token mint addresses (default stablecoin)\n */\nexport const USDC_MAINNET_ADDRESS = \"EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v\";\nexport const USDC_DEVNET_ADDRESS = \"4zMMC9srt5Ri5X14GAgXhaHii3GnPAEERYPJgZJDncDU\";\nexport const USDC_TESTNET_ADDRESS = \"4zMMC9srt5Ri5X14GAgXhaHii3GnPAEERYPJgZJDncDU\"; // Same as devnet\n\n/**\n * Compute budget configuration\n * All prices are in microlamports (1 lamport = 1,000,000 microlamports)\n */\nexport const DEFAULT_COMPUTE_UNIT_PRICE_MICROLAMPORTS = 1;\nexport const MAX_COMPUTE_UNIT_PRICE_MICROLAMPORTS = 5_000_000; // 5 lamports\nexport const DEFAULT_COMPUTE_UNIT_LIMIT = 20_000;\n\n/**\n * Solana address validation regex (base58, 32-44 characters)\n */\nexport const SVM_ADDRESS_REGEX = /^[1-9A-HJ-NP-Za-km-z]{32,44}$/;\n\n/**\n * CAIP-2 network identifiers for Solana (V2)\n */\nexport const SOLANA_MAINNET_CAIP2 = \"solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp\";\nexport const SOLANA_DEVNET_CAIP2 = \"solana:EtWTRABZaYq6iMfeYKouRu166VU2xqa1\";\nexport const SOLANA_TESTNET_CAIP2 = \"solana:4uhcVJyU9pJkvQyS88uRDiswHXSCkY3z\";\n\n/**\n * V1 to V2 network identifier mappings (for backwards compatibility)\n * V1 used simple names like solana, V2 uses CAIP-2\n */\nexport const V1_TO_V2_NETWORK_MAP: Record<string, string> = {\n  solana: SOLANA_MAINNET_CAIP2,\n  \"solana-devnet\": SOLANA_DEVNET_CAIP2,\n  \"solana-testnet\": SOLANA_TESTNET_CAIP2,\n};\n","import {\n  getBase64Encoder,\n  getTransactionDecoder,\n  getCompiledTransactionMessageDecoder,\n  type Transaction,\n  createSolanaRpc,\n  devnet,\n  testnet,\n  mainnet,\n  type RpcDevnet,\n  type SolanaRpcApiDevnet,\n  type RpcTestnet,\n  type SolanaRpcApiTestnet,\n  type RpcMainnet,\n  type SolanaRpcApiMainnet,\n} from \"@solana/kit\";\nimport { TOKEN_PROGRAM_ADDRESS } from \"@solana-program/token\";\nimport { TOKEN_2022_PROGRAM_ADDRESS } from \"@solana-program/token-2022\";\nimport type { Network } from \"@x402/core/types\";\nimport {\n  SVM_ADDRESS_REGEX,\n  DEVNET_RPC_URL,\n  TESTNET_RPC_URL,\n  MAINNET_RPC_URL,\n  USDC_MAINNET_ADDRESS,\n  USDC_DEVNET_ADDRESS,\n  USDC_TESTNET_ADDRESS,\n  SOLANA_MAINNET_CAIP2,\n  SOLANA_DEVNET_CAIP2,\n  SOLANA_TESTNET_CAIP2,\n  V1_TO_V2_NETWORK_MAP,\n} from \"./constants\";\nimport type { ExactSvmPayloadV1 } from \"./types\";\n\n/**\n * Normalize network identifier to CAIP-2 format\n * Handles both V1 names (solana, solana-devnet) and V2 CAIP-2 format\n *\n * @param network - Network identifier (V1 or V2 format)\n * @returns CAIP-2 network identifier\n */\nexport function normalizeNetwork(network: Network): string {\n  // If it's already CAIP-2 format (contains \":\"), validate it's supported\n  if (network.includes(\":\")) {\n    const supported = [SOLANA_MAINNET_CAIP2, SOLANA_DEVNET_CAIP2, SOLANA_TESTNET_CAIP2];\n    if (!supported.includes(network)) {\n      throw new Error(`Unsupported SVM network: ${network}`);\n    }\n    return network;\n  }\n\n  // Otherwise, it's a V1 network name, convert to CAIP-2\n  const caip2Network = V1_TO_V2_NETWORK_MAP[network];\n  if (!caip2Network) {\n    throw new Error(`Unsupported SVM network: ${network}`);\n  }\n  return caip2Network;\n}\n\n/**\n * Validate Solana address format\n *\n * @param address - Base58 encoded address string\n * @returns true if address is valid, false otherwise\n */\nexport function validateSvmAddress(address: string): boolean {\n  return SVM_ADDRESS_REGEX.test(address);\n}\n\n/**\n * Decode a base64 encoded transaction from an SVM payload\n *\n * @param svmPayload - The SVM payload containing a base64 encoded transaction\n * @returns Decoded Transaction object\n */\nexport function decodeTransactionFromPayload(svmPayload: ExactSvmPayloadV1): Transaction {\n  try {\n    const base64Encoder = getBase64Encoder();\n    const transactionBytes = base64Encoder.encode(svmPayload.transaction);\n    const transactionDecoder = getTransactionDecoder();\n    return transactionDecoder.decode(transactionBytes);\n  } catch (error) {\n    console.error(\"Error decoding transaction:\", error);\n    throw new Error(\"invalid_exact_svm_payload_transaction\");\n  }\n}\n\n/**\n * Extract the token sender (owner of the source token account) from a TransferChecked instruction\n *\n * @param transaction - The decoded transaction\n * @returns The token payer address as a base58 string\n */\nexport function getTokenPayerFromTransaction(transaction: Transaction): string {\n  const compiled = getCompiledTransactionMessageDecoder().decode(transaction.messageBytes);\n  const staticAccounts = compiled.staticAccounts ?? [];\n  const instructions = compiled.instructions ?? [];\n\n  for (const ix of instructions) {\n    const programIndex = ix.programAddressIndex;\n    const programAddress = staticAccounts[programIndex].toString();\n\n    // Check if this is a token program instruction\n    if (\n      programAddress === TOKEN_PROGRAM_ADDRESS.toString() ||\n      programAddress === TOKEN_2022_PROGRAM_ADDRESS.toString()\n    ) {\n      const accountIndices: number[] = ix.accountIndices ?? [];\n      // TransferChecked account order: [source, mint, destination, owner, ...]\n      if (accountIndices.length >= 4) {\n        const ownerIndex = accountIndices[3];\n        const ownerAddress = staticAccounts[ownerIndex].toString();\n        if (ownerAddress) return ownerAddress;\n      }\n    }\n  }\n\n  return \"\";\n}\n\n/**\n * Create an RPC client for the specified network\n *\n * @param network - Network identifier (CAIP-2 or V1 format)\n * @param customRpcUrl - Optional custom RPC URL\n * @returns RPC client for the specified network\n */\nexport function createRpcClient(\n  network: Network,\n  customRpcUrl?: string,\n):\n  | RpcDevnet<SolanaRpcApiDevnet>\n  | RpcTestnet<SolanaRpcApiTestnet>\n  | RpcMainnet<SolanaRpcApiMainnet> {\n  const caip2Network = normalizeNetwork(network);\n\n  switch (caip2Network) {\n    case SOLANA_DEVNET_CAIP2: {\n      const url = customRpcUrl || DEVNET_RPC_URL;\n      return createSolanaRpc(devnet(url)) as RpcDevnet<SolanaRpcApiDevnet>;\n    }\n    case SOLANA_TESTNET_CAIP2: {\n      const url = customRpcUrl || TESTNET_RPC_URL;\n      return createSolanaRpc(testnet(url)) as RpcTestnet<SolanaRpcApiTestnet>;\n    }\n    case SOLANA_MAINNET_CAIP2: {\n      const url = customRpcUrl || MAINNET_RPC_URL;\n      return createSolanaRpc(mainnet(url)) as RpcMainnet<SolanaRpcApiMainnet>;\n    }\n    default:\n      throw new Error(`Unsupported network: ${network}`);\n  }\n}\n\n/**\n * Get the default USDC mint address for a network\n *\n * @param network - Network identifier (CAIP-2 or V1 format)\n * @returns USDC mint address for the network\n */\nexport function getUsdcAddress(network: Network): string {\n  const caip2Network = normalizeNetwork(network);\n\n  switch (caip2Network) {\n    case SOLANA_MAINNET_CAIP2:\n      return USDC_MAINNET_ADDRESS;\n    case SOLANA_DEVNET_CAIP2:\n      return USDC_DEVNET_ADDRESS;\n    case SOLANA_TESTNET_CAIP2:\n      return USDC_TESTNET_ADDRESS;\n    default:\n      throw new Error(`No USDC address configured for network: ${network}`);\n  }\n}\n\n/**\n * Convert a decimal amount to token smallest units\n *\n * @param decimalAmount - The decimal amount (e.g., \"0.10\")\n * @param decimals - The number of decimals for the token (e.g., 6 for USDC)\n * @returns The amount in smallest units as a string\n */\nexport function convertToTokenAmount(decimalAmount: string, decimals: number): string {\n  const amount = parseFloat(decimalAmount);\n  if (isNaN(amount)) {\n    throw new Error(`Invalid amount: ${decimalAmount}`);\n  }\n  // Convert to smallest unit (e.g., for USDC with 6 decimals: 0.10 * 10^6 = 100000)\n  const [intPart, decPart = \"\"] = String(amount).split(\".\");\n  const paddedDec = decPart.padEnd(decimals, \"0\").slice(0, decimals);\n  const tokenAmount = (intPart + paddedDec).replace(/^0+/, \"\") || \"0\";\n  return tokenAmount;\n}\n","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} from \"@solana/kit\";\nimport type {\n  PaymentPayload,\n  PaymentRequirements,\n  SchemeNetworkFacilitator,\n  SettleResponse,\n  VerifyResponse,\n} from \"@x402/core/types\";\nimport type { PaymentPayloadV1, PaymentRequirementsV1 } from \"@x402/core/types/v1\";\nimport {\n  LIGHTHOUSE_PROGRAM_ADDRESS,\n  MAX_COMPUTE_UNIT_PRICE_MICROLAMPORTS,\n  MEMO_PROGRAM_ADDRESS,\n} 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(transaction.messageBytes);\n    const decompiled = decompileTransactionMessage(compiled);\n    const instructions = decompiled.instructions ?? [];\n\n    // Allow 3-6 instructions:\n    // - 3 instructions: ComputeLimit + ComputePrice + TransferChecked\n    // - 4 instructions: ComputeLimit + ComputePrice + TransferChecked + Lighthouse or Memo\n    // - 5 instructions: ComputeLimit + ComputePrice + TransferChecked + Lighthouse + Lighthouse or Memo\n    // - 6 instructions: ComputeLimit + ComputePrice + TransferChecked + Lighthouse + Lighthouse + Memo\n    // See: https://github.com/coinbase/x402/issues/828\n    if (instructions.length < 3 || instructions.length > 6) {\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: Verify optional instructions (if present)\n    // Allowed optional programs: Lighthouse (wallet protection) and Memo (uniqueness)\n    const optionalInstructions = instructions.slice(3);\n    const invalidReasonByIndex = [\n      \"invalid_exact_svm_payload_unknown_fourth_instruction\",\n      \"invalid_exact_svm_payload_unknown_fifth_instruction\",\n      \"invalid_exact_svm_payload_unknown_sixth_instruction\",\n    ];\n\n    for (let i = 0; i < optionalInstructions.length; i += 1) {\n      const programAddress = optionalInstructions[i].programAddress.toString();\n      if (\n        programAddress === LIGHTHOUSE_PROGRAM_ADDRESS ||\n        programAddress === MEMO_PROGRAM_ADDRESS\n      ) {\n        continue;\n      }\n\n      return {\n        isValid: false,\n        invalidReason:\n          invalidReasonByIndex[i] ?? \"invalid_exact_svm_payload_unknown_optional_instruction\",\n        payer,\n      };\n    }\n\n    // Step 6: 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\",\n        invalidMessage: 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":["import_token","import_token_2022","import_kit","tx","import_compute_budget","import_token","import_token_2022","import_kit"]}
+{"version":3,"sources":["../../../src/v1/index.ts","../../../src/exact/v1/client/scheme.ts","../../../src/constants.ts","../../../src/utils.ts","../../../src/exact/v1/facilitator/scheme.ts"],"sourcesContent":["/**\n * V1 exports for the SVM mechanism\n */\nexport { ExactSvmSchemeV1 } from \"../exact/v1\";\n\nexport const NETWORKS: string[] = [\"solana\", \"solana-devnet\", \"solana-testnet\"];\n","import {\n  getSetComputeUnitLimitInstruction,\n  setTransactionMessageComputeUnitPrice,\n} from \"@solana-program/compute-budget\";\nimport { TOKEN_PROGRAM_ADDRESS } from \"@solana-program/token\";\nimport {\n  fetchMint,\n  findAssociatedTokenPda,\n  getTransferCheckedInstruction,\n  TOKEN_2022_PROGRAM_ADDRESS,\n} from \"@solana-program/token-2022\";\nimport {\n  appendTransactionMessageInstructions,\n  createTransactionMessage,\n  getBase64EncodedWireTransaction,\n  partiallySignTransactionMessageWithSigners,\n  pipe,\n  prependTransactionMessageInstruction,\n  setTransactionMessageFeePayer,\n  setTransactionMessageLifetimeUsingBlockhash,\n  type Address,\n} from \"@solana/kit\";\nimport type {\n  Network,\n  PaymentPayload,\n  PaymentRequirements,\n  SchemeNetworkClient,\n} from \"@x402/core/types\";\nimport type { PaymentRequirementsV1 } from \"@x402/core/types/v1\";\nimport {\n  DEFAULT_COMPUTE_UNIT_LIMIT,\n  DEFAULT_COMPUTE_UNIT_PRICE_MICROLAMPORTS,\n  MEMO_PROGRAM_ADDRESS,\n} from \"../../../constants\";\nimport type { ClientSvmConfig, ClientSvmSigner } from \"../../../signer\";\nimport type { ExactSvmPayloadV1 } from \"../../../types\";\nimport { createRpcClient } from \"../../../utils\";\n\n/**\n * SVM client implementation for the Exact payment scheme (V1).\n */\nexport class ExactSvmSchemeV1 implements SchemeNetworkClient {\n  readonly scheme = \"exact\";\n\n  /**\n   * Creates a new ExactSvmClientV1 instance.\n   *\n   * @param signer - The SVM signer for client operations\n   * @param config - Optional configuration with custom RPC URL\n   * @returns ExactSvmClientV1 instance\n   */\n  constructor(\n    private readonly signer: ClientSvmSigner,\n    private readonly config?: ClientSvmConfig,\n  ) {}\n\n  /**\n   * Creates a payment payload for the Exact scheme (V1).\n   *\n   * @param x402Version - The x402 protocol version\n   * @param paymentRequirements - The payment requirements\n   * @returns Promise resolving to a payment payload\n   */\n  async createPaymentPayload(\n    x402Version: number,\n    paymentRequirements: PaymentRequirements,\n  ): Promise<\n    Pick<PaymentPayload, \"x402Version\" | \"payload\"> & { scheme: string; network: Network }\n  > {\n    const selectedV1 = paymentRequirements as unknown as PaymentRequirementsV1;\n    const rpc = createRpcClient(selectedV1.network, this.config?.rpcUrl);\n\n    const tokenMint = await fetchMint(rpc, selectedV1.asset as Address);\n    const tokenProgramAddress = tokenMint.programAddress;\n\n    if (\n      tokenProgramAddress.toString() !== TOKEN_PROGRAM_ADDRESS.toString() &&\n      tokenProgramAddress.toString() !== TOKEN_2022_PROGRAM_ADDRESS.toString()\n    ) {\n      throw new Error(\"Asset was not created by a known token program\");\n    }\n\n    const [sourceATA] = await findAssociatedTokenPda({\n      mint: selectedV1.asset as Address,\n      owner: this.signer.address,\n      tokenProgram: tokenProgramAddress,\n    });\n\n    const [destinationATA] = await findAssociatedTokenPda({\n      mint: selectedV1.asset as Address,\n      owner: selectedV1.payTo as Address,\n      tokenProgram: tokenProgramAddress,\n    });\n\n    const transferIx = getTransferCheckedInstruction(\n      {\n        source: sourceATA,\n        mint: selectedV1.asset as Address,\n        destination: destinationATA,\n        authority: this.signer,\n        amount: BigInt(selectedV1.maxAmountRequired),\n        decimals: tokenMint.data.decimals,\n      },\n      { programAddress: tokenProgramAddress },\n    );\n\n    // Facilitator must provide feePayer to cover transaction fees\n    const feePayer = selectedV1.extra?.feePayer as Address;\n    if (!feePayer) {\n      throw new Error(\"feePayer is required in paymentRequirements.extra for SVM transactions\");\n    }\n\n    const { value: latestBlockhash } = await rpc.getLatestBlockhash().send();\n\n    const nonce = crypto.getRandomValues(new Uint8Array(16));\n    const memoIx = {\n      programAddress: MEMO_PROGRAM_ADDRESS as Address,\n      accounts: [] as const,\n      data: new TextEncoder().encode(\n        Array.from(nonce)\n          .map(b => b.toString(16).padStart(2, \"0\"))\n          .join(\"\"),\n      ),\n    };\n\n    const tx = pipe(\n      createTransactionMessage({ version: 0 }),\n      tx => setTransactionMessageComputeUnitPrice(DEFAULT_COMPUTE_UNIT_PRICE_MICROLAMPORTS, tx),\n      tx => setTransactionMessageFeePayer(feePayer, tx),\n      tx =>\n        prependTransactionMessageInstruction(\n          getSetComputeUnitLimitInstruction({ units: DEFAULT_COMPUTE_UNIT_LIMIT }),\n          tx,\n        ),\n      tx => appendTransactionMessageInstructions([transferIx, memoIx], tx),\n      tx => setTransactionMessageLifetimeUsingBlockhash(latestBlockhash, tx),\n    );\n\n    const signedTransaction = await partiallySignTransactionMessageWithSigners(tx);\n    const base64EncodedWireTransaction = getBase64EncodedWireTransaction(signedTransaction);\n\n    const payload: ExactSvmPayloadV1 = {\n      transaction: base64EncodedWireTransaction,\n    };\n\n    return {\n      x402Version,\n      scheme: selectedV1.scheme,\n      network: selectedV1.network,\n      payload,\n    };\n  }\n}\n","/**\n * Token program addresses for SPL Token and Token-2022\n * These addresses are the same across all Solana networks (mainnet, devnet, testnet)\n */\nexport const TOKEN_PROGRAM_ADDRESS = \"TokenkegQfeZyiNwAJbNbGKPFXCWuBvf9Ss623VQ5DA\";\nexport const TOKEN_2022_PROGRAM_ADDRESS = \"TokenzQdBNbLqP5VEhdkAS6EPFLC1PHnBqCXEpPxuEb\";\nexport const COMPUTE_BUDGET_PROGRAM_ADDRESS = \"ComputeBudget111111111111111111111111111111\";\nexport const MEMO_PROGRAM_ADDRESS = \"MemoSq4gqABAXKb96qnH8TysNcWxMyWCqXgDLGmfcHr\";\n\n/**\n * Phantom/Solflare Lighthouse program address\n * Phantom and Solflare wallets inject Lighthouse instructions for user protection on mainnet transactions.\n * - Phantom adds 1 Lighthouse instruction (4th instruction)\n * - Solflare adds 2 Lighthouse instructions (4th and 5th instructions)\n * We allow these as optional instructions to support these wallets.\n * See: https://github.com/coinbase/x402/issues/828\n */\nexport const LIGHTHOUSE_PROGRAM_ADDRESS = \"L2TExMFKdjpN9kozasaurPirfHy9P8sbXoAN1qA3S95\";\n\n/**\n * Default RPC URLs for Solana networks\n */\nexport const DEVNET_RPC_URL = \"https://api.devnet.solana.com\";\nexport const TESTNET_RPC_URL = \"https://api.testnet.solana.com\";\nexport const MAINNET_RPC_URL = \"https://api.mainnet-beta.solana.com\";\nexport const DEVNET_WS_URL = \"wss://api.devnet.solana.com\";\nexport const TESTNET_WS_URL = \"wss://api.testnet.solana.com\";\nexport const MAINNET_WS_URL = \"wss://api.mainnet-beta.solana.com\";\n\n/**\n * USDC token mint addresses (default stablecoin)\n */\nexport const USDC_MAINNET_ADDRESS = \"EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v\";\nexport const USDC_DEVNET_ADDRESS = \"4zMMC9srt5Ri5X14GAgXhaHii3GnPAEERYPJgZJDncDU\";\nexport const USDC_TESTNET_ADDRESS = \"4zMMC9srt5Ri5X14GAgXhaHii3GnPAEERYPJgZJDncDU\"; // Same as devnet\n\n/**\n * Compute budget configuration\n * All prices are in microlamports (1 lamport = 1,000,000 microlamports)\n */\nexport const DEFAULT_COMPUTE_UNIT_PRICE_MICROLAMPORTS = 1;\nexport const MAX_COMPUTE_UNIT_PRICE_MICROLAMPORTS = 5_000_000; // 5 lamports\nexport const DEFAULT_COMPUTE_UNIT_LIMIT = 20_000;\n\n/**\n * How long a transaction is held in the duplicate settlement cache (ms).\n * Covers the Solana blockhash lifetime (~60-90s) with margin.\n */\nexport const SETTLEMENT_TTL_MS = 120_000;\n\n/**\n * Solana address validation regex (base58, 32-44 characters)\n */\nexport const SVM_ADDRESS_REGEX = /^[1-9A-HJ-NP-Za-km-z]{32,44}$/;\n\n/**\n * CAIP-2 network identifiers for Solana (V2)\n */\nexport const SOLANA_MAINNET_CAIP2 = \"solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp\";\nexport const SOLANA_DEVNET_CAIP2 = \"solana:EtWTRABZaYq6iMfeYKouRu166VU2xqa1\";\nexport const SOLANA_TESTNET_CAIP2 = \"solana:4uhcVJyU9pJkvQyS88uRDiswHXSCkY3z\";\n\n/**\n * V1 to V2 network identifier mappings (for backwards compatibility)\n * V1 used simple names like solana, V2 uses CAIP-2\n */\nexport const V1_TO_V2_NETWORK_MAP: Record<string, string> = {\n  solana: SOLANA_MAINNET_CAIP2,\n  \"solana-devnet\": SOLANA_DEVNET_CAIP2,\n  \"solana-testnet\": SOLANA_TESTNET_CAIP2,\n};\n","import {\n  getBase64Encoder,\n  getTransactionDecoder,\n  getCompiledTransactionMessageDecoder,\n  type Transaction,\n  createSolanaRpc,\n  devnet,\n  testnet,\n  mainnet,\n  type RpcDevnet,\n  type SolanaRpcApiDevnet,\n  type RpcTestnet,\n  type SolanaRpcApiTestnet,\n  type RpcMainnet,\n  type SolanaRpcApiMainnet,\n} from \"@solana/kit\";\nimport { TOKEN_PROGRAM_ADDRESS } from \"@solana-program/token\";\nimport { TOKEN_2022_PROGRAM_ADDRESS } from \"@solana-program/token-2022\";\nimport type { Network } from \"@x402/core/types\";\nimport {\n  SVM_ADDRESS_REGEX,\n  DEVNET_RPC_URL,\n  TESTNET_RPC_URL,\n  MAINNET_RPC_URL,\n  USDC_MAINNET_ADDRESS,\n  USDC_DEVNET_ADDRESS,\n  USDC_TESTNET_ADDRESS,\n  SOLANA_MAINNET_CAIP2,\n  SOLANA_DEVNET_CAIP2,\n  SOLANA_TESTNET_CAIP2,\n  V1_TO_V2_NETWORK_MAP,\n} from \"./constants\";\nimport type { ExactSvmPayloadV1 } from \"./types\";\n\n/**\n * Normalize network identifier to CAIP-2 format\n * Handles both V1 names (solana, solana-devnet) and V2 CAIP-2 format\n *\n * @param network - Network identifier (V1 or V2 format)\n * @returns CAIP-2 network identifier\n */\nexport function normalizeNetwork(network: Network): string {\n  // If it's already CAIP-2 format (contains \":\"), validate it's supported\n  if (network.includes(\":\")) {\n    const supported = [SOLANA_MAINNET_CAIP2, SOLANA_DEVNET_CAIP2, SOLANA_TESTNET_CAIP2];\n    if (!supported.includes(network)) {\n      throw new Error(`Unsupported SVM network: ${network}`);\n    }\n    return network;\n  }\n\n  // Otherwise, it's a V1 network name, convert to CAIP-2\n  const caip2Network = V1_TO_V2_NETWORK_MAP[network];\n  if (!caip2Network) {\n    throw new Error(`Unsupported SVM network: ${network}`);\n  }\n  return caip2Network;\n}\n\n/**\n * Validate Solana address format\n *\n * @param address - Base58 encoded address string\n * @returns true if address is valid, false otherwise\n */\nexport function validateSvmAddress(address: string): boolean {\n  return SVM_ADDRESS_REGEX.test(address);\n}\n\n/**\n * Decode a base64 encoded transaction from an SVM payload\n *\n * @param svmPayload - The SVM payload containing a base64 encoded transaction\n * @returns Decoded Transaction object\n */\nexport function decodeTransactionFromPayload(svmPayload: ExactSvmPayloadV1): Transaction {\n  try {\n    const base64Encoder = getBase64Encoder();\n    const transactionBytes = base64Encoder.encode(svmPayload.transaction);\n    const transactionDecoder = getTransactionDecoder();\n    return transactionDecoder.decode(transactionBytes);\n  } catch (error) {\n    console.error(\"Error decoding transaction:\", error);\n    throw new Error(\"invalid_exact_svm_payload_transaction\");\n  }\n}\n\n/**\n * Extract the token sender (owner of the source token account) from a TransferChecked instruction\n *\n * @param transaction - The decoded transaction\n * @returns The token payer address as a base58 string\n */\nexport function getTokenPayerFromTransaction(transaction: Transaction): string {\n  const compiled = getCompiledTransactionMessageDecoder().decode(transaction.messageBytes);\n  const staticAccounts = compiled.staticAccounts ?? [];\n  const instructions = compiled.instructions ?? [];\n\n  for (const ix of instructions) {\n    const programIndex = ix.programAddressIndex;\n    const programAddress = staticAccounts[programIndex].toString();\n\n    // Check if this is a token program instruction\n    if (\n      programAddress === TOKEN_PROGRAM_ADDRESS.toString() ||\n      programAddress === TOKEN_2022_PROGRAM_ADDRESS.toString()\n    ) {\n      const accountIndices: number[] = ix.accountIndices ?? [];\n      // TransferChecked account order: [source, mint, destination, owner, ...]\n      if (accountIndices.length >= 4) {\n        const ownerIndex = accountIndices[3];\n        const ownerAddress = staticAccounts[ownerIndex].toString();\n        if (ownerAddress) return ownerAddress;\n      }\n    }\n  }\n\n  return \"\";\n}\n\n/**\n * Create an RPC client for the specified network\n *\n * @param network - Network identifier (CAIP-2 or V1 format)\n * @param customRpcUrl - Optional custom RPC URL\n * @returns RPC client for the specified network\n */\nexport function createRpcClient(\n  network: Network,\n  customRpcUrl?: string,\n):\n  | RpcDevnet<SolanaRpcApiDevnet>\n  | RpcTestnet<SolanaRpcApiTestnet>\n  | RpcMainnet<SolanaRpcApiMainnet> {\n  const caip2Network = normalizeNetwork(network);\n\n  switch (caip2Network) {\n    case SOLANA_DEVNET_CAIP2: {\n      const url = customRpcUrl || DEVNET_RPC_URL;\n      return createSolanaRpc(devnet(url)) as RpcDevnet<SolanaRpcApiDevnet>;\n    }\n    case SOLANA_TESTNET_CAIP2: {\n      const url = customRpcUrl || TESTNET_RPC_URL;\n      return createSolanaRpc(testnet(url)) as RpcTestnet<SolanaRpcApiTestnet>;\n    }\n    case SOLANA_MAINNET_CAIP2: {\n      const url = customRpcUrl || MAINNET_RPC_URL;\n      return createSolanaRpc(mainnet(url)) as RpcMainnet<SolanaRpcApiMainnet>;\n    }\n    default:\n      throw new Error(`Unsupported network: ${network}`);\n  }\n}\n\n/**\n * Get the default USDC mint address for a network\n *\n * @param network - Network identifier (CAIP-2 or V1 format)\n * @returns USDC mint address for the network\n */\nexport function getUsdcAddress(network: Network): string {\n  const caip2Network = normalizeNetwork(network);\n\n  switch (caip2Network) {\n    case SOLANA_MAINNET_CAIP2:\n      return USDC_MAINNET_ADDRESS;\n    case SOLANA_DEVNET_CAIP2:\n      return USDC_DEVNET_ADDRESS;\n    case SOLANA_TESTNET_CAIP2:\n      return USDC_TESTNET_ADDRESS;\n    default:\n      throw new Error(`No USDC address configured for network: ${network}`);\n  }\n}\n\n/**\n * Convert a decimal amount to token smallest units\n *\n * @param decimalAmount - The decimal amount (e.g., \"0.10\")\n * @param decimals - The number of decimals for the token (e.g., 6 for USDC)\n * @returns The amount in smallest units as a string\n */\nexport function convertToTokenAmount(decimalAmount: string, decimals: number): string {\n  const amount = parseFloat(decimalAmount);\n  if (isNaN(amount)) {\n    throw new Error(`Invalid amount: ${decimalAmount}`);\n  }\n  // Convert to smallest unit (e.g., for USDC with 6 decimals: 0.10 * 10^6 = 100000)\n  const [intPart, decPart = \"\"] = String(amount).split(\".\");\n  const paddedDec = decPart.padEnd(decimals, \"0\").slice(0, decimals);\n  const tokenAmount = (intPart + paddedDec).replace(/^0+/, \"\") || \"0\";\n  return tokenAmount;\n}\n","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} from \"@solana/kit\";\nimport type {\n  PaymentPayload,\n  PaymentRequirements,\n  SchemeNetworkFacilitator,\n  SettleResponse,\n  VerifyResponse,\n} from \"@x402/core/types\";\nimport type { PaymentPayloadV1, PaymentRequirementsV1 } from \"@x402/core/types/v1\";\nimport {\n  LIGHTHOUSE_PROGRAM_ADDRESS,\n  MAX_COMPUTE_UNIT_PRICE_MICROLAMPORTS,\n  MEMO_PROGRAM_ADDRESS,\n} from \"../../../constants\";\nimport { SettlementCache } from \"../../../settlement-cache\";\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  private readonly settlementCache: SettlementCache;\n\n  /**\n   * Creates a new ExactSvmFacilitatorV1 instance.\n   *\n   * @param signer - The SVM RPC client for facilitator operations\n   * @param settlementCache - Optional shared settlement cache (one is created if omitted)\n   * @returns ExactSvmFacilitatorV1 instance\n   */\n  constructor(\n    private readonly signer: FacilitatorSvmSigner,\n    settlementCache?: SettlementCache,\n  ) {\n    this.settlementCache = settlementCache ?? new SettlementCache();\n  }\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(transaction.messageBytes);\n    const decompiled = decompileTransactionMessage(compiled);\n    const instructions = decompiled.instructions ?? [];\n\n    // Allow 3-6 instructions:\n    // - 3 instructions: ComputeLimit + ComputePrice + TransferChecked\n    // - 4 instructions: ComputeLimit + ComputePrice + TransferChecked + Lighthouse or Memo\n    // - 5 instructions: ComputeLimit + ComputePrice + TransferChecked + Lighthouse + Lighthouse or Memo\n    // - 6 instructions: ComputeLimit + ComputePrice + TransferChecked + Lighthouse + Lighthouse + Memo\n    // See: https://github.com/coinbase/x402/issues/828\n    if (instructions.length < 3 || instructions.length > 6) {\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 exactly matches 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_mismatch\",\n        payer,\n      };\n    }\n\n    // Step 5: Verify optional instructions (if present)\n    // Allowed optional programs: Lighthouse (wallet protection) and Memo (uniqueness)\n    const optionalInstructions = instructions.slice(3);\n    const invalidReasonByIndex = [\n      \"invalid_exact_svm_payload_unknown_fourth_instruction\",\n      \"invalid_exact_svm_payload_unknown_fifth_instruction\",\n      \"invalid_exact_svm_payload_unknown_sixth_instruction\",\n    ];\n\n    for (let i = 0; i < optionalInstructions.length; i += 1) {\n      const programAddress = optionalInstructions[i].programAddress.toString();\n      if (\n        programAddress === LIGHTHOUSE_PROGRAM_ADDRESS ||\n        programAddress === MEMO_PROGRAM_ADDRESS\n      ) {\n        continue;\n      }\n\n      return {\n        isValid: false,\n        invalidReason:\n          invalidReasonByIndex[i] ?? \"invalid_exact_svm_payload_unknown_optional_instruction\",\n        payer,\n      };\n    }\n\n    // Step 6: 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\",\n        invalidMessage: 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    // Duplicate settlement check: reject if this transaction is already being settled.\n    // Must occur before any async work so concurrent calls for the same tx are caught.\n    const txKey = exactSvmPayload.transaction;\n    if (this.settlementCache.isDuplicate(txKey)) {\n      return {\n        success: false,\n        network: payloadV1.network,\n        transaction: \"\",\n        errorReason: \"duplicate_settlement\",\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":["import_token","import_token_2022","import_kit","tx","import_compute_budget","import_token","import_token_2022","import_kit"]}

package/dist/esm/{chunk-ABSYVIOR.mjs → chunk-HJV6TMZE.mjs}

@@ -3,7 +3,7 @@ import {
   DEFAULT_COMPUTE_UNIT_PRICE_MICROLAMPORTS,
   MEMO_PROGRAM_ADDRESS,
   createRpcClient
-} from "./chunk-FWLOH47E.mjs";
+} from "./chunk-TZGEGCWJ.mjs";
 
 // src/exact/client/scheme.ts
 import {
@@ -114,4 +114,4 @@ var ExactSvmScheme = class {
 export {
   ExactSvmScheme
 };
-//# sourceMappingURL=chunk-ABSYVIOR.mjs.map
+//# sourceMappingURL=chunk-HJV6TMZE.mjs.map

package/dist/esm/{chunk-K4ZT4D23.mjs → chunk-SV64M7KA.mjs}

@@ -1,10 +1,13 @@
+import {
+  SettlementCache
+} from "./chunk-UIASIAEW.mjs";
 import {
   LIGHTHOUSE_PROGRAM_ADDRESS,
   MAX_COMPUTE_UNIT_PRICE_MICROLAMPORTS,
   MEMO_PROGRAM_ADDRESS,
   decodeTransactionFromPayload,
   getTokenPayerFromTransaction
-} from "./chunk-FWLOH47E.mjs";
+} from "./chunk-TZGEGCWJ.mjs";
 
 // src/exact/v1/facilitator/scheme.ts
 import {
@@ -30,12 +33,14 @@ var ExactSvmSchemeV1 = class {
    * Creates a new ExactSvmFacilitatorV1 instance.
    *
    * @param signer - The SVM RPC client for facilitator operations
+   * @param settlementCache - Optional shared settlement cache (one is created if omitted)
    * @returns ExactSvmFacilitatorV1 instance
    */
-  constructor(signer) {
+  constructor(signer, settlementCache) {
     this.signer = signer;
     this.scheme = "exact";
     this.caipFamily = "solana:*";
+    this.settlementCache = settlementCache ?? new SettlementCache();
   }
   /**
    * Get mechanism-specific extra data for the supported kinds endpoint.
@@ -202,10 +207,10 @@ var ExactSvmSchemeV1 = class {
       };
     }
     const amount = parsedTransfer.data.amount;
-    if (amount < BigInt(requirementsV1.maxAmountRequired)) {
+    if (amount !== BigInt(requirementsV1.maxAmountRequired)) {
       return {
         isValid: false,
-        invalidReason: "invalid_exact_svm_payload_amount_insufficient",
+        invalidReason: "invalid_exact_svm_payload_amount_mismatch",
         payer
       };
     }
@@ -270,6 +275,16 @@ var ExactSvmSchemeV1 = class {
         payer: valid.payer || ""
       };
     }
+    const txKey = exactSvmPayload.transaction;
+    if (this.settlementCache.isDuplicate(txKey)) {
+      return {
+        success: false,
+        network: payloadV1.network,
+        transaction: "",
+        errorReason: "duplicate_settlement",
+        payer: valid.payer || ""
+      };
+    }
     try {
       const feePayer = requirements.extra.feePayer;
       const fullySignedTransaction = await this.signer.signTransaction(
@@ -356,4 +371,4 @@ var ExactSvmSchemeV1 = class {
 export {
   ExactSvmSchemeV1
 };
-//# sourceMappingURL=chunk-K4ZT4D23.mjs.map
+//# sourceMappingURL=chunk-SV64M7KA.mjs.map

package/dist/esm/chunk-SV64M7KA.mjs.map

@@ -0,0 +1 @@
+{"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} from \"@solana/kit\";\nimport type {\n  PaymentPayload,\n  PaymentRequirements,\n  SchemeNetworkFacilitator,\n  SettleResponse,\n  VerifyResponse,\n} from \"@x402/core/types\";\nimport type { PaymentPayloadV1, PaymentRequirementsV1 } from \"@x402/core/types/v1\";\nimport {\n  LIGHTHOUSE_PROGRAM_ADDRESS,\n  MAX_COMPUTE_UNIT_PRICE_MICROLAMPORTS,\n  MEMO_PROGRAM_ADDRESS,\n} from \"../../../constants\";\nimport { SettlementCache } from \"../../../settlement-cache\";\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  private readonly settlementCache: SettlementCache;\n\n  /**\n   * Creates a new ExactSvmFacilitatorV1 instance.\n   *\n   * @param signer - The SVM RPC client for facilitator operations\n   * @param settlementCache - Optional shared settlement cache (one is created if omitted)\n   * @returns ExactSvmFacilitatorV1 instance\n   */\n  constructor(\n    private readonly signer: FacilitatorSvmSigner,\n    settlementCache?: SettlementCache,\n  ) {\n    this.settlementCache = settlementCache ?? new SettlementCache();\n  }\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(transaction.messageBytes);\n    const decompiled = decompileTransactionMessage(compiled);\n    const instructions = decompiled.instructions ?? [];\n\n    // Allow 3-6 instructions:\n    // - 3 instructions: ComputeLimit + ComputePrice + TransferChecked\n    // - 4 instructions: ComputeLimit + ComputePrice + TransferChecked + Lighthouse or Memo\n    // - 5 instructions: ComputeLimit + ComputePrice + TransferChecked + Lighthouse + Lighthouse or Memo\n    // - 6 instructions: ComputeLimit + ComputePrice + TransferChecked + Lighthouse + Lighthouse + Memo\n    // See: https://github.com/coinbase/x402/issues/828\n    if (instructions.length < 3 || instructions.length > 6) {\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 exactly matches 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_mismatch\",\n        payer,\n      };\n    }\n\n    // Step 5: Verify optional instructions (if present)\n    // Allowed optional programs: Lighthouse (wallet protection) and Memo (uniqueness)\n    const optionalInstructions = instructions.slice(3);\n    const invalidReasonByIndex = [\n      \"invalid_exact_svm_payload_unknown_fourth_instruction\",\n      \"invalid_exact_svm_payload_unknown_fifth_instruction\",\n      \"invalid_exact_svm_payload_unknown_sixth_instruction\",\n    ];\n\n    for (let i = 0; i < optionalInstructions.length; i += 1) {\n      const programAddress = optionalInstructions[i].programAddress.toString();\n      if (\n        programAddress === LIGHTHOUSE_PROGRAM_ADDRESS ||\n        programAddress === MEMO_PROGRAM_ADDRESS\n      ) {\n        continue;\n      }\n\n      return {\n        isValid: false,\n        invalidReason:\n          invalidReasonByIndex[i] ?? \"invalid_exact_svm_payload_unknown_optional_instruction\",\n        payer,\n      };\n    }\n\n    // Step 6: 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\",\n        invalidMessage: 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    // Duplicate settlement check: reject if this transaction is already being settled.\n    // Must occur before any async work so concurrent calls for the same tx are caught.\n    const txKey = exactSvmPayload.transaction;\n    if (this.settlementCache.isDuplicate(txKey)) {\n      return {\n        success: false,\n        network: payloadV1.network,\n        transaction: \"\",\n        errorReason: \"duplicate_settlement\",\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":";;;;;;;;;;;;AAAA;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,OACK;AACP;AAAA,EACE,mCAAmC;AAAA,EACnC;AAAA,OACK;AACP;AAAA,EACE;AAAA,EACA,mCAAmC;AAAA,EACnC;AAAA,OACK;AACP;AAAA,EACE;AAAA,EACA;AAAA,OAEK;AAsBA,IAAM,mBAAN,MAA2D;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAahE,YACmB,QACjB,iBACA;AAFiB;AAbnB,SAAS,SAAS;AAClB,SAAS,aAAa;AAepB,SAAK,kBAAkB,mBAAmB,IAAI,gBAAgB;AAAA,EAChE;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAUA,SAAS,GAAgD;AAEvD,UAAM,YAAY,KAAK,OAAO,aAAa;AAC3C,UAAM,cAAc,KAAK,MAAM,KAAK,OAAO,IAAI,UAAU,MAAM;AAE/D,WAAO;AAAA,MACL,UAAU,UAAU,WAAW;AAAA,IACjC;AAAA,EACF;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EASA,WAAW,GAAqB;AAC9B,WAAO,CAAC,GAAG,KAAK,OAAO,aAAa,CAAC;AAAA,EACvC;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EASA,MAAM,OACJ,SACA,cACyB;AACzB,UAAM,iBAAiB;AACvB,UAAM,YAAY;AAClB,UAAM,kBAAkB,QAAQ;AAGhC,QAAI,UAAU,WAAW,WAAW,aAAa,WAAW,SAAS;AACnE,aAAO;AAAA,QACL,SAAS;AAAA,QACT,eAAe;AAAA,QACf,OAAO;AAAA,MACT;AAAA,IACF;AAEA,QAAI,UAAU,YAAY,aAAa,SAAS;AAC9C,aAAO;AAAA,QACL,SAAS;AAAA,QACT,eAAe;AAAA,QACf,OAAO;AAAA,MACT;AAAA,IACF;AAEA,QAAI,CAAC,eAAe,OAAO,YAAY,OAAO,eAAe,MAAM,aAAa,UAAU;AACxF,aAAO;AAAA,QACL,SAAS;AAAA,QACT,eAAe;AAAA,QACf,OAAO;AAAA,MACT;AAAA,IACF;AAGA,UAAM,kBAAkB,KAAK,OAAO,aAAa,EAAE,IAAI,UAAQ,KAAK,SAAS,CAAC;AAC9E,QAAI,CAAC,gBAAgB,SAAS,eAAe,MAAM,QAAQ,GAAG;AAC5D,aAAO;AAAA,QACL,SAAS;AAAA,QACT,eAAe;AAAA,QACf,OAAO;AAAA,MACT;AAAA,IACF;AAGA,QAAI;AACJ,QAAI;AACF,oBAAc,6BAA6B,eAAe;AAAA,IAC5D,QAAQ;AACN,aAAO;AAAA,QACL,SAAS;AAAA,QACT,eAAe;AAAA,QACf,OAAO;AAAA,MACT;AAAA,IACF;AAEA,UAAM,WAAW,qCAAqC,EAAE,OAAO,YAAY,YAAY;AACvF,UAAM,aAAa,4BAA4B,QAAQ;AACvD,UAAM,eAAe,WAAW,gBAAgB,CAAC;AAQjD,QAAI,aAAa,SAAS,KAAK,aAAa,SAAS,GAAG;AACtD,aAAO;AAAA,QACL,SAAS;AAAA,QACT,eAAe;AAAA,QACf,OAAO;AAAA,MACT;AAAA,IACF;AAGA,QAAI;AACF,WAAK,8BAA8B,aAAa,CAAC,CAAU;AAC3D,WAAK,8BAA8B,aAAa,CAAC,CAAU;AAAA,IAC7D,SAAS,OAAO;AACd,YAAM,eAAe,iBAAiB,QAAQ,MAAM,UAAU,OAAO,KAAK;AAC1E,aAAO;AAAA,QACL,SAAS;AAAA,QACT,eAAe;AAAA,QACf,OAAO;AAAA,MACT;AAAA,IACF;AAEA,UAAM,QAAQ,6BAA6B,WAAW;AACtD,QAAI,CAAC,OAAO;AACV,aAAO;AAAA,QACL,SAAS;AAAA,QACT,eAAe;AAAA,QACf,OAAO;AAAA,MACT;AAAA,IACF;AAGA,UAAM,aAAa,aAAa,CAAC;AACjC,UAAM,iBAAiB,WAAW,eAAe,SAAS;AAE1D,QACE,mBAAmB,sBAAsB,SAAS,KAClD,mBAAmB,2BAA2B,SAAS,GACvD;AACA,aAAO;AAAA,QACL,SAAS;AAAA,QACT,eAAe;AAAA,QACf;AAAA,MACF;AAAA,IACF;AAGA,QAAI;AACJ,QAAI;AACF,UAAI,mBAAmB,sBAAsB,SAAS,GAAG;AACvD,yBAAiB,qCAAqC,UAAmB;AAAA,MAC3E,OAAO;AACL,yBAAiB,oCAAoC,UAAmB;AAAA,MAC1E;AAAA,IACF,QAAQ;AACN,aAAO;AAAA,QACL,SAAS;AAAA,QACT,eAAe;AAAA,QACf;AAAA,MACF;AAAA,IACF;AAIA,UAAM,mBAAmB,eAAe,SAAS,UAAU,QAAQ,SAAS;AAC5E,QAAI,gBAAgB,SAAS,gBAAgB,GAAG;AAC9C,aAAO;AAAA,QACL,SAAS;AAAA,QACT,eAAe;AAAA,QACf;AAAA,MACF;AAAA,IACF;AAGA,UAAM,cAAc,eAAe,SAAS,KAAK,QAAQ,SAAS;AAClE,QAAI,gBAAgB,aAAa,OAAO;AACtC,aAAO;AAAA,QACL,SAAS;AAAA,QACT,eAAe;AAAA,QACf;AAAA,MACF;AAAA,IACF;AAGA,UAAM,UAAU,eAAe,SAAS,YAAY,QAAQ,SAAS;AACrE,QAAI;AACF,YAAM,CAAC,eAAe,IAAI,MAAM,uBAAuB;AAAA,QACrD,MAAM,aAAa;AAAA,QACnB,OAAO,aAAa;AAAA,QACpB,cACE,mBAAmB,sBAAsB,SAAS,IAC7C,wBACA;AAAA,MACT,CAAC;AAED,UAAI,YAAY,gBAAgB,SAAS,GAAG;AAC1C,eAAO;AAAA,UACL,SAAS;AAAA,UACT,eAAe;AAAA,UACf;AAAA,QACF;AAAA,MACF;AAAA,IACF,QAAQ;AACN,aAAO;AAAA,QACL,SAAS;AAAA,QACT,eAAe;AAAA,QACf;AAAA,MACF;AAAA,IACF;AAGA,UAAM,SAAS,eAAe,KAAK;AACnC,QAAI,WAAW,OAAO,eAAe,iBAAiB,GAAG;AACvD,aAAO;AAAA,QACL,SAAS;AAAA,QACT,eAAe;AAAA,QACf;AAAA,MACF;AAAA,IACF;AAIA,UAAM,uBAAuB,aAAa,MAAM,CAAC;AACjD,UAAM,uBAAuB;AAAA,MAC3B;AAAA,MACA;AAAA,MACA;AAAA,IACF;AAEA,aAAS,IAAI,GAAG,IAAI,qBAAqB,QAAQ,KAAK,GAAG;AACvD,YAAMA,kBAAiB,qBAAqB,CAAC,EAAE,eAAe,SAAS;AACvE,UACEA,oBAAmB,8BACnBA,oBAAmB,sBACnB;AACA;AAAA,MACF;AAEA,aAAO;AAAA,QACL,SAAS;AAAA,QACT,eACE,qBAAqB,CAAC,KAAK;AAAA,QAC7B;AAAA,MACF;AAAA,IACF;AAIA,QAAI;AACF,YAAM,WAAW,eAAe,MAAM;AAGtC,YAAM,yBAAyB,MAAM,KAAK,OAAO;AAAA,QAC/C,gBAAgB;AAAA,QAChB;AAAA,QACA,aAAa;AAAA,MACf;AAGA,YAAM,KAAK,OAAO,oBAAoB,wBAAwB,aAAa,OAAO;AAAA,IACpF,SAAS,OAAO;AACd,YAAM,eAAe,iBAAiB,QAAQ,MAAM,UAAU,OAAO,KAAK;AAC1E,aAAO;AAAA,QACL,SAAS;AAAA,QACT,eAAe;AAAA,QACf,gBAAgB;AAAA,QAChB;AAAA,MACF;AAAA,IACF;AAEA,WAAO;AAAA,MACL,SAAS;AAAA,MACT,eAAe;AAAA,MACf;AAAA,IACF;AAAA,EACF;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAUA,MAAM,OACJ,SACA,cACyB;AACzB,UAAM,YAAY;AAClB,UAAM,kBAAkB,QAAQ;AAEhC,UAAM,QAAQ,MAAM,KAAK,OAAO,SAAS,YAAY;AACrD,QAAI,CAAC,MAAM,SAAS;AAClB,aAAO;AAAA,QACL,SAAS;AAAA,QACT,SAAS,UAAU;AAAA,QACnB,aAAa;AAAA,QACb,aAAa,MAAM,iBAAiB;AAAA,QACpC,OAAO,MAAM,SAAS;AAAA,MACxB;AAAA,IACF;AAIA,UAAM,QAAQ,gBAAgB;AAC9B,QAAI,KAAK,gBAAgB,YAAY,KAAK,GAAG;AAC3C,aAAO;AAAA,QACL,SAAS;AAAA,QACT,SAAS,UAAU;AAAA,QACnB,aAAa;AAAA,QACb,aAAa;AAAA,QACb,OAAO,MAAM,SAAS;AAAA,MACxB;AAAA,IACF;AAEA,QAAI;AAEF,YAAM,WAAW,aAAa,MAAM;AAGpC,YAAM,yBAAyB,MAAM,KAAK,OAAO;AAAA,QAC/C,gBAAgB;AAAA,QAChB;AAAA,QACA,aAAa;AAAA,MACf;AAGA,YAAM,YAAY,MAAM,KAAK,OAAO;AAAA,QAClC;AAAA,QACA,aAAa;AAAA,MACf;AAGA,YAAM,KAAK,OAAO,mBAAmB,WAAW,aAAa,OAAO;AAEpE,aAAO;AAAA,QACL,SAAS;AAAA,QACT,aAAa;AAAA,QACb,SAAS,UAAU;AAAA,QACnB,OAAO,MAAM;AAAA,MACf;AAAA,IACF,SAAS,OAAO;AACd,cAAQ,MAAM,iCAAiC,KAAK;AACpD,aAAO;AAAA,QACL,SAAS;AAAA,QACT,aAAa;AAAA,QACb,aAAa;AAAA,QACb,SAAS,UAAU;AAAA,QACnB,OAAO,MAAM,SAAS;AAAA,MACxB;AAAA,IACF;AAAA,EACF;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EASQ,8BAA8B,aAG7B;AACP,UAAM,iBAAiB,YAAY,eAAe,SAAS;AAE3D,QACE,mBAAmB,+BAA+B,SAAS,KAC3D,CAAC,YAAY,QACb,YAAY,KAAK,CAAC,MAAM,GACxB;AACA,YAAM,IAAI;AAAA,QACR;AAAA,MACF;AAAA,IACF;AAEA,QAAI;AACF,0CAAoC,WAAoB;AAAA,IAC1D,QAAQ;AACN,YAAM,IAAI;AAAA,QACR;AAAA,MACF;AAAA,IACF;AAAA,EACF;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EASQ,8BAA8B,aAG7B;AACP,UAAM,iBAAiB,YAAY,eAAe,SAAS;AAE3D,QACE,mBAAmB,+BAA+B,SAAS,KAC3D,CAAC,YAAY,QACb,YAAY,KAAK,CAAC,MAAM,GACxB;AACA,YAAM,IAAI;AAAA,QACR;AAAA,MACF;AAAA,IACF;AAEA,QAAI;AACF,YAAM,oBAAoB,oCAAoC,WAAoB;AAGlF,UACG,kBAA2D,gBAC5D,OAAO,oCAAoC,GAC3C;AACA,cAAM,IAAI;AAAA,UACR;AAAA,QACF;AAAA,MACF;AAAA,IACF,SAAS,OAAO;AACd,UAAI,iBAAiB,SAAS,MAAM,QAAQ,SAAS,UAAU,GAAG;AAChE,cAAM;AAAA,MACR;AACA,YAAM,IAAI;AAAA,QACR;AAAA,MACF;AAAA,IACF;AAAA,EACF;AACF;","names":["programAddress"]}

package/dist/esm/{chunk-FWLOH47E.mjs → chunk-TZGEGCWJ.mjs}

@@ -16,6 +16,7 @@ var USDC_TESTNET_ADDRESS = "4zMMC9srt5Ri5X14GAgXhaHii3GnPAEERYPJgZJDncDU";
 var DEFAULT_COMPUTE_UNIT_PRICE_MICROLAMPORTS = 1;
 var MAX_COMPUTE_UNIT_PRICE_MICROLAMPORTS = 5e6;
 var DEFAULT_COMPUTE_UNIT_LIMIT = 2e4;
+var SETTLEMENT_TTL_MS = 12e4;
 var SVM_ADDRESS_REGEX = /^[1-9A-HJ-NP-Za-km-z]{32,44}$/;
 var SOLANA_MAINNET_CAIP2 = "solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp";
 var SOLANA_DEVNET_CAIP2 = "solana:EtWTRABZaYq6iMfeYKouRu166VU2xqa1";
@@ -145,6 +146,7 @@ export {
   DEFAULT_COMPUTE_UNIT_PRICE_MICROLAMPORTS,
   MAX_COMPUTE_UNIT_PRICE_MICROLAMPORTS,
   DEFAULT_COMPUTE_UNIT_LIMIT,
+  SETTLEMENT_TTL_MS,
   SVM_ADDRESS_REGEX,
   SOLANA_MAINNET_CAIP2,
   SOLANA_DEVNET_CAIP2,
@@ -158,4 +160,4 @@ export {
   getUsdcAddress,
   convertToTokenAmount
 };
-//# sourceMappingURL=chunk-FWLOH47E.mjs.map
+//# sourceMappingURL=chunk-TZGEGCWJ.mjs.map

package/dist/esm/chunk-TZGEGCWJ.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/constants.ts","../../src/utils.ts"],"sourcesContent":["/**\n * Token program addresses for SPL Token and Token-2022\n * These addresses are the same across all Solana networks (mainnet, devnet, testnet)\n */\nexport const TOKEN_PROGRAM_ADDRESS = \"TokenkegQfeZyiNwAJbNbGKPFXCWuBvf9Ss623VQ5DA\";\nexport const TOKEN_2022_PROGRAM_ADDRESS = \"TokenzQdBNbLqP5VEhdkAS6EPFLC1PHnBqCXEpPxuEb\";\nexport const COMPUTE_BUDGET_PROGRAM_ADDRESS = \"ComputeBudget111111111111111111111111111111\";\nexport const MEMO_PROGRAM_ADDRESS = \"MemoSq4gqABAXKb96qnH8TysNcWxMyWCqXgDLGmfcHr\";\n\n/**\n * Phantom/Solflare Lighthouse program address\n * Phantom and Solflare wallets inject Lighthouse instructions for user protection on mainnet transactions.\n * - Phantom adds 1 Lighthouse instruction (4th instruction)\n * - Solflare adds 2 Lighthouse instructions (4th and 5th instructions)\n * We allow these as optional instructions to support these wallets.\n * See: https://github.com/coinbase/x402/issues/828\n */\nexport const LIGHTHOUSE_PROGRAM_ADDRESS = \"L2TExMFKdjpN9kozasaurPirfHy9P8sbXoAN1qA3S95\";\n\n/**\n * Default RPC URLs for Solana networks\n */\nexport const DEVNET_RPC_URL = \"https://api.devnet.solana.com\";\nexport const TESTNET_RPC_URL = \"https://api.testnet.solana.com\";\nexport const MAINNET_RPC_URL = \"https://api.mainnet-beta.solana.com\";\nexport const DEVNET_WS_URL = \"wss://api.devnet.solana.com\";\nexport const TESTNET_WS_URL = \"wss://api.testnet.solana.com\";\nexport const MAINNET_WS_URL = \"wss://api.mainnet-beta.solana.com\";\n\n/**\n * USDC token mint addresses (default stablecoin)\n */\nexport const USDC_MAINNET_ADDRESS = \"EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v\";\nexport const USDC_DEVNET_ADDRESS = \"4zMMC9srt5Ri5X14GAgXhaHii3GnPAEERYPJgZJDncDU\";\nexport const USDC_TESTNET_ADDRESS = \"4zMMC9srt5Ri5X14GAgXhaHii3GnPAEERYPJgZJDncDU\"; // Same as devnet\n\n/**\n * Compute budget configuration\n * All prices are in microlamports (1 lamport = 1,000,000 microlamports)\n */\nexport const DEFAULT_COMPUTE_UNIT_PRICE_MICROLAMPORTS = 1;\nexport const MAX_COMPUTE_UNIT_PRICE_MICROLAMPORTS = 5_000_000; // 5 lamports\nexport const DEFAULT_COMPUTE_UNIT_LIMIT = 20_000;\n\n/**\n * How long a transaction is held in the duplicate settlement cache (ms).\n * Covers the Solana blockhash lifetime (~60-90s) with margin.\n */\nexport const SETTLEMENT_TTL_MS = 120_000;\n\n/**\n * Solana address validation regex (base58, 32-44 characters)\n */\nexport const SVM_ADDRESS_REGEX = /^[1-9A-HJ-NP-Za-km-z]{32,44}$/;\n\n/**\n * CAIP-2 network identifiers for Solana (V2)\n */\nexport const SOLANA_MAINNET_CAIP2 = \"solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp\";\nexport const SOLANA_DEVNET_CAIP2 = \"solana:EtWTRABZaYq6iMfeYKouRu166VU2xqa1\";\nexport const SOLANA_TESTNET_CAIP2 = \"solana:4uhcVJyU9pJkvQyS88uRDiswHXSCkY3z\";\n\n/**\n * V1 to V2 network identifier mappings (for backwards compatibility)\n * V1 used simple names like solana, V2 uses CAIP-2\n */\nexport const V1_TO_V2_NETWORK_MAP: Record<string, string> = {\n  solana: SOLANA_MAINNET_CAIP2,\n  \"solana-devnet\": SOLANA_DEVNET_CAIP2,\n  \"solana-testnet\": SOLANA_TESTNET_CAIP2,\n};\n","import {\n  getBase64Encoder,\n  getTransactionDecoder,\n  getCompiledTransactionMessageDecoder,\n  type Transaction,\n  createSolanaRpc,\n  devnet,\n  testnet,\n  mainnet,\n  type RpcDevnet,\n  type SolanaRpcApiDevnet,\n  type RpcTestnet,\n  type SolanaRpcApiTestnet,\n  type RpcMainnet,\n  type SolanaRpcApiMainnet,\n} from \"@solana/kit\";\nimport { TOKEN_PROGRAM_ADDRESS } from \"@solana-program/token\";\nimport { TOKEN_2022_PROGRAM_ADDRESS } from \"@solana-program/token-2022\";\nimport type { Network } from \"@x402/core/types\";\nimport {\n  SVM_ADDRESS_REGEX,\n  DEVNET_RPC_URL,\n  TESTNET_RPC_URL,\n  MAINNET_RPC_URL,\n  USDC_MAINNET_ADDRESS,\n  USDC_DEVNET_ADDRESS,\n  USDC_TESTNET_ADDRESS,\n  SOLANA_MAINNET_CAIP2,\n  SOLANA_DEVNET_CAIP2,\n  SOLANA_TESTNET_CAIP2,\n  V1_TO_V2_NETWORK_MAP,\n} from \"./constants\";\nimport type { ExactSvmPayloadV1 } from \"./types\";\n\n/**\n * Normalize network identifier to CAIP-2 format\n * Handles both V1 names (solana, solana-devnet) and V2 CAIP-2 format\n *\n * @param network - Network identifier (V1 or V2 format)\n * @returns CAIP-2 network identifier\n */\nexport function normalizeNetwork(network: Network): string {\n  // If it's already CAIP-2 format (contains \":\"), validate it's supported\n  if (network.includes(\":\")) {\n    const supported = [SOLANA_MAINNET_CAIP2, SOLANA_DEVNET_CAIP2, SOLANA_TESTNET_CAIP2];\n    if (!supported.includes(network)) {\n      throw new Error(`Unsupported SVM network: ${network}`);\n    }\n    return network;\n  }\n\n  // Otherwise, it's a V1 network name, convert to CAIP-2\n  const caip2Network = V1_TO_V2_NETWORK_MAP[network];\n  if (!caip2Network) {\n    throw new Error(`Unsupported SVM network: ${network}`);\n  }\n  return caip2Network;\n}\n\n/**\n * Validate Solana address format\n *\n * @param address - Base58 encoded address string\n * @returns true if address is valid, false otherwise\n */\nexport function validateSvmAddress(address: string): boolean {\n  return SVM_ADDRESS_REGEX.test(address);\n}\n\n/**\n * Decode a base64 encoded transaction from an SVM payload\n *\n * @param svmPayload - The SVM payload containing a base64 encoded transaction\n * @returns Decoded Transaction object\n */\nexport function decodeTransactionFromPayload(svmPayload: ExactSvmPayloadV1): Transaction {\n  try {\n    const base64Encoder = getBase64Encoder();\n    const transactionBytes = base64Encoder.encode(svmPayload.transaction);\n    const transactionDecoder = getTransactionDecoder();\n    return transactionDecoder.decode(transactionBytes);\n  } catch (error) {\n    console.error(\"Error decoding transaction:\", error);\n    throw new Error(\"invalid_exact_svm_payload_transaction\");\n  }\n}\n\n/**\n * Extract the token sender (owner of the source token account) from a TransferChecked instruction\n *\n * @param transaction - The decoded transaction\n * @returns The token payer address as a base58 string\n */\nexport function getTokenPayerFromTransaction(transaction: Transaction): string {\n  const compiled = getCompiledTransactionMessageDecoder().decode(transaction.messageBytes);\n  const staticAccounts = compiled.staticAccounts ?? [];\n  const instructions = compiled.instructions ?? [];\n\n  for (const ix of instructions) {\n    const programIndex = ix.programAddressIndex;\n    const programAddress = staticAccounts[programIndex].toString();\n\n    // Check if this is a token program instruction\n    if (\n      programAddress === TOKEN_PROGRAM_ADDRESS.toString() ||\n      programAddress === TOKEN_2022_PROGRAM_ADDRESS.toString()\n    ) {\n      const accountIndices: number[] = ix.accountIndices ?? [];\n      // TransferChecked account order: [source, mint, destination, owner, ...]\n      if (accountIndices.length >= 4) {\n        const ownerIndex = accountIndices[3];\n        const ownerAddress = staticAccounts[ownerIndex].toString();\n        if (ownerAddress) return ownerAddress;\n      }\n    }\n  }\n\n  return \"\";\n}\n\n/**\n * Create an RPC client for the specified network\n *\n * @param network - Network identifier (CAIP-2 or V1 format)\n * @param customRpcUrl - Optional custom RPC URL\n * @returns RPC client for the specified network\n */\nexport function createRpcClient(\n  network: Network,\n  customRpcUrl?: string,\n):\n  | RpcDevnet<SolanaRpcApiDevnet>\n  | RpcTestnet<SolanaRpcApiTestnet>\n  | RpcMainnet<SolanaRpcApiMainnet> {\n  const caip2Network = normalizeNetwork(network);\n\n  switch (caip2Network) {\n    case SOLANA_DEVNET_CAIP2: {\n      const url = customRpcUrl || DEVNET_RPC_URL;\n      return createSolanaRpc(devnet(url)) as RpcDevnet<SolanaRpcApiDevnet>;\n    }\n    case SOLANA_TESTNET_CAIP2: {\n      const url = customRpcUrl || TESTNET_RPC_URL;\n      return createSolanaRpc(testnet(url)) as RpcTestnet<SolanaRpcApiTestnet>;\n    }\n    case SOLANA_MAINNET_CAIP2: {\n      const url = customRpcUrl || MAINNET_RPC_URL;\n      return createSolanaRpc(mainnet(url)) as RpcMainnet<SolanaRpcApiMainnet>;\n    }\n    default:\n      throw new Error(`Unsupported network: ${network}`);\n  }\n}\n\n/**\n * Get the default USDC mint address for a network\n *\n * @param network - Network identifier (CAIP-2 or V1 format)\n * @returns USDC mint address for the network\n */\nexport function getUsdcAddress(network: Network): string {\n  const caip2Network = normalizeNetwork(network);\n\n  switch (caip2Network) {\n    case SOLANA_MAINNET_CAIP2:\n      return USDC_MAINNET_ADDRESS;\n    case SOLANA_DEVNET_CAIP2:\n      return USDC_DEVNET_ADDRESS;\n    case SOLANA_TESTNET_CAIP2:\n      return USDC_TESTNET_ADDRESS;\n    default:\n      throw new Error(`No USDC address configured for network: ${network}`);\n  }\n}\n\n/**\n * Convert a decimal amount to token smallest units\n *\n * @param decimalAmount - The decimal amount (e.g., \"0.10\")\n * @param decimals - The number of decimals for the token (e.g., 6 for USDC)\n * @returns The amount in smallest units as a string\n */\nexport function convertToTokenAmount(decimalAmount: string, decimals: number): string {\n  const amount = parseFloat(decimalAmount);\n  if (isNaN(amount)) {\n    throw new Error(`Invalid amount: ${decimalAmount}`);\n  }\n  // Convert to smallest unit (e.g., for USDC with 6 decimals: 0.10 * 10^6 = 100000)\n  const [intPart, decPart = \"\"] = String(amount).split(\".\");\n  const paddedDec = decPart.padEnd(decimals, \"0\").slice(0, decimals);\n  const tokenAmount = (intPart + paddedDec).replace(/^0+/, \"\") || \"0\";\n  return tokenAmount;\n}\n"],"mappings":";AAIO,IAAM,wBAAwB;AAC9B,IAAM,6BAA6B;AACnC,IAAM,iCAAiC;AACvC,IAAM,uBAAuB;AAU7B,IAAM,6BAA6B;AAKnC,IAAM,iBAAiB;AACvB,IAAM,kBAAkB;AACxB,IAAM,kBAAkB;AACxB,IAAM,gBAAgB;AACtB,IAAM,iBAAiB;AACvB,IAAM,iBAAiB;AAKvB,IAAM,uBAAuB;AAC7B,IAAM,sBAAsB;AAC5B,IAAM,uBAAuB;AAM7B,IAAM,2CAA2C;AACjD,IAAM,uCAAuC;AAC7C,IAAM,6BAA6B;AAMnC,IAAM,oBAAoB;AAK1B,IAAM,oBAAoB;AAK1B,IAAM,uBAAuB;AAC7B,IAAM,sBAAsB;AAC5B,IAAM,uBAAuB;AAM7B,IAAM,uBAA+C;AAAA,EAC1D,QAAQ;AAAA,EACR,iBAAiB;AAAA,EACjB,kBAAkB;AACpB;;;ACtEA;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EAEA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OAOK;AACP,SAAS,yBAAAA,8BAA6B;AACtC,SAAS,8BAAAC,mCAAkC;AAwBpC,SAAS,iBAAiB,SAA0B;AAEzD,MAAI,QAAQ,SAAS,GAAG,GAAG;AACzB,UAAM,YAAY,CAAC,sBAAsB,qBAAqB,oBAAoB;AAClF,QAAI,CAAC,UAAU,SAAS,OAAO,GAAG;AAChC,YAAM,IAAI,MAAM,4BAA4B,OAAO,EAAE;AAAA,IACvD;AACA,WAAO;AAAA,EACT;AAGA,QAAM,eAAe,qBAAqB,OAAO;AACjD,MAAI,CAAC,cAAc;AACjB,UAAM,IAAI,MAAM,4BAA4B,OAAO,EAAE;AAAA,EACvD;AACA,SAAO;AACT;AAQO,SAAS,mBAAmB,SAA0B;AAC3D,SAAO,kBAAkB,KAAK,OAAO;AACvC;AAQO,SAAS,6BAA6B,YAA4C;AACvF,MAAI;AACF,UAAM,gBAAgB,iBAAiB;AACvC,UAAM,mBAAmB,cAAc,OAAO,WAAW,WAAW;AACpE,UAAM,qBAAqB,sBAAsB;AACjD,WAAO,mBAAmB,OAAO,gBAAgB;AAAA,EACnD,SAAS,OAAO;AACd,YAAQ,MAAM,+BAA+B,KAAK;AAClD,UAAM,IAAI,MAAM,uCAAuC;AAAA,EACzD;AACF;AAQO,SAAS,6BAA6B,aAAkC;AAC7E,QAAM,WAAW,qCAAqC,EAAE,OAAO,YAAY,YAAY;AACvF,QAAM,iBAAiB,SAAS,kBAAkB,CAAC;AACnD,QAAM,eAAe,SAAS,gBAAgB,CAAC;AAE/C,aAAW,MAAM,cAAc;AAC7B,UAAM,eAAe,GAAG;AACxB,UAAM,iBAAiB,eAAe,YAAY,EAAE,SAAS;AAG7D,QACE,mBAAmBC,uBAAsB,SAAS,KAClD,mBAAmBC,4BAA2B,SAAS,GACvD;AACA,YAAM,iBAA2B,GAAG,kBAAkB,CAAC;AAEvD,UAAI,eAAe,UAAU,GAAG;AAC9B,cAAM,aAAa,eAAe,CAAC;AACnC,cAAM,eAAe,eAAe,UAAU,EAAE,SAAS;AACzD,YAAI,aAAc,QAAO;AAAA,MAC3B;AAAA,IACF;AAAA,EACF;AAEA,SAAO;AACT;AASO,SAAS,gBACd,SACA,cAIkC;AAClC,QAAM,eAAe,iBAAiB,OAAO;AAE7C,UAAQ,cAAc;AAAA,IACpB,KAAK,qBAAqB;AACxB,YAAM,MAAM,gBAAgB;AAC5B,aAAO,gBAAgB,OAAO,GAAG,CAAC;AAAA,IACpC;AAAA,IACA,KAAK,sBAAsB;AACzB,YAAM,MAAM,gBAAgB;AAC5B,aAAO,gBAAgB,QAAQ,GAAG,CAAC;AAAA,IACrC;AAAA,IACA,KAAK,sBAAsB;AACzB,YAAM,MAAM,gBAAgB;AAC5B,aAAO,gBAAgB,QAAQ,GAAG,CAAC;AAAA,IACrC;AAAA,IACA;AACE,YAAM,IAAI,MAAM,wBAAwB,OAAO,EAAE;AAAA,EACrD;AACF;AAQO,SAAS,eAAe,SAA0B;AACvD,QAAM,eAAe,iBAAiB,OAAO;AAE7C,UAAQ,cAAc;AAAA,IACpB,KAAK;AACH,aAAO;AAAA,IACT,KAAK;AACH,aAAO;AAAA,IACT,KAAK;AACH,aAAO;AAAA,IACT;AACE,YAAM,IAAI,MAAM,2CAA2C,OAAO,EAAE;AAAA,EACxE;AACF;AASO,SAAS,qBAAqB,eAAuB,UAA0B;AACpF,QAAM,SAAS,WAAW,aAAa;AACvC,MAAI,MAAM,MAAM,GAAG;AACjB,UAAM,IAAI,MAAM,mBAAmB,aAAa,EAAE;AAAA,EACpD;AAEA,QAAM,CAAC,SAAS,UAAU,EAAE,IAAI,OAAO,MAAM,EAAE,MAAM,GAAG;AACxD,QAAM,YAAY,QAAQ,OAAO,UAAU,GAAG,EAAE,MAAM,GAAG,QAAQ;AACjE,QAAM,eAAe,UAAU,WAAW,QAAQ,OAAO,EAAE,KAAK;AAChE,SAAO;AACT;","names":["TOKEN_PROGRAM_ADDRESS","TOKEN_2022_PROGRAM_ADDRESS","TOKEN_PROGRAM_ADDRESS","TOKEN_2022_PROGRAM_ADDRESS"]}

package/dist/esm/chunk-UIASIAEW.mjs

@@ -0,0 +1,45 @@
+import {
+  SETTLEMENT_TTL_MS
+} from "./chunk-TZGEGCWJ.mjs";
+
+// src/settlement-cache.ts
+var SettlementCache = class {
+  constructor() {
+    this.entries = /* @__PURE__ */ new Map();
+  }
+  /**
+   * Returns `true` if `key` is already pending settlement (duplicate),
+   * or `false` after recording it as newly pending.
+   *
+   * Callers should reject the settlement when this returns `true`.
+   *
+   * @param key - The unique identifier for the settlement (typically the transaction signature).
+   * @returns `true` if the key was already present (duplicate); `false` otherwise.
+   */
+  isDuplicate(key) {
+    this.prune();
+    if (this.entries.has(key)) {
+      return true;
+    }
+    this.entries.set(key, Date.now());
+    return false;
+  }
+  /**
+   * Remove entries older than the settlement TTL.
+   */
+  prune() {
+    const cutoff = Date.now() - SETTLEMENT_TTL_MS;
+    for (const [key, timestamp] of this.entries) {
+      if (timestamp < cutoff) {
+        this.entries.delete(key);
+      } else {
+        break;
+      }
+    }
+  }
+};
+
+export {
+  SettlementCache
+};
+//# sourceMappingURL=chunk-UIASIAEW.mjs.map

package/dist/esm/chunk-UIASIAEW.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/settlement-cache.ts"],"sourcesContent":["import { SETTLEMENT_TTL_MS } from \"./constants\";\n\n/**\n * In-memory cache for deduplicating concurrent settlement requests.\n *\n * A single instance should be shared across V1 and V2 facilitator scheme\n * instances so that a transaction submitted through one protocol version is\n * also blocked on the other.  Because Node.js is single-threaded, no lock\n * is required — the cache check + insert must simply occur before the first\n * `await` in the settle path.\n */\nexport class SettlementCache {\n  private readonly entries = new Map<string, number>();\n\n  /**\n   * Returns `true` if `key` is already pending settlement (duplicate),\n   * or `false` after recording it as newly pending.\n   *\n   * Callers should reject the settlement when this returns `true`.\n   *\n   * @param key - The unique identifier for the settlement (typically the transaction signature).\n   * @returns `true` if the key was already present (duplicate); `false` otherwise.\n   */\n  isDuplicate(key: string): boolean {\n    this.prune();\n    if (this.entries.has(key)) {\n      return true;\n    }\n    this.entries.set(key, Date.now());\n    return false;\n  }\n\n  /**\n   * Remove entries older than the settlement TTL.\n   */\n  private prune(): void {\n    const cutoff = Date.now() - SETTLEMENT_TTL_MS;\n    for (const [key, timestamp] of this.entries) {\n      if (timestamp < cutoff) {\n        this.entries.delete(key);\n      } else {\n        break;\n      }\n    }\n  }\n}\n"],"mappings":";;;;;AAWO,IAAM,kBAAN,MAAsB;AAAA,EAAtB;AACL,SAAiB,UAAU,oBAAI,IAAoB;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAWnD,YAAY,KAAsB;AAChC,SAAK,MAAM;AACX,QAAI,KAAK,QAAQ,IAAI,GAAG,GAAG;AACzB,aAAO;AAAA,IACT;AACA,SAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,CAAC;AAChC,WAAO;AAAA,EACT;AAAA;AAAA;AAAA;AAAA,EAKQ,QAAc;AACpB,UAAM,SAAS,KAAK,IAAI,IAAI;AAC5B,eAAW,CAAC,KAAK,SAAS,KAAK,KAAK,SAAS;AAC3C,UAAI,YAAY,QAAQ;AACtB,aAAK,QAAQ,OAAO,GAAG;AAAA,MACzB,OAAO;AACL;AAAA,MACF;AAAA,IACF;AAAA,EACF;AACF;","names":[]}

package/dist/esm/{chunk-6ZXKIZKL.mjs → chunk-V5GMZRSA.mjs}

@@ -3,7 +3,7 @@ import {
   DEFAULT_COMPUTE_UNIT_PRICE_MICROLAMPORTS,
   MEMO_PROGRAM_ADDRESS,
   createRpcClient
-} from "./chunk-FWLOH47E.mjs";
+} from "./chunk-TZGEGCWJ.mjs";
 
 // src/exact/v1/client/scheme.ts
 import {
@@ -117,4 +117,4 @@ var ExactSvmSchemeV1 = class {
 export {
   ExactSvmSchemeV1
 };
-//# sourceMappingURL=chunk-6ZXKIZKL.mjs.map
+//# sourceMappingURL=chunk-V5GMZRSA.mjs.map

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

@@ -1,7 +1,7 @@
-export { E as ExactSvmScheme } from '../../scheme-DnHeaPEu.mjs';
-import { SelectPaymentRequirements, PaymentPolicy, x402Client } from '@x402/core/client';
+export { E as ExactSvmScheme } from '../../scheme-fjF-9LhT.mjs';
+import { x402Client, SelectPaymentRequirements, PaymentPolicy } from '@x402/core/client';
 import { Network } from '@x402/core/types';
-import { C as ClientSvmSigner } from '../../signer-V35oXttt.mjs';
+import { C as ClientSvmSigner } from '../../signer-BMkbhFYE.mjs';
 import '@solana/kit';
 
 /**

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

@@ -1,14 +1,15 @@
 import {
   ExactSvmScheme
-} from "../../chunk-ABSYVIOR.mjs";
+} from "../../chunk-HJV6TMZE.mjs";
 import {
   NETWORKS
 } from "../../chunk-WWACQNRQ.mjs";
 import {
   ExactSvmSchemeV1
-} from "../../chunk-6ZXKIZKL.mjs";
-import "../../chunk-K4ZT4D23.mjs";
-import "../../chunk-FWLOH47E.mjs";
+} from "../../chunk-V5GMZRSA.mjs";
+import "../../chunk-SV64M7KA.mjs";
+import "../../chunk-UIASIAEW.mjs";
+import "../../chunk-TZGEGCWJ.mjs";
 
 // src/exact/client/register.ts
 function registerExactSvmScheme(client, config) {

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

@@ -1 +1 @@
-{"version":3,"sources":["../../../../src/exact/client/register.ts"],"sourcesContent":["import { x402Client, SelectPaymentRequirements, PaymentPolicy } from \"@x402/core/client\";\nimport { Network } from \"@x402/core/types\";\nimport { ClientSvmSigner } from \"../../signer\";\nimport { ExactSvmScheme } from \"./scheme\";\nimport { ExactSvmSchemeV1 } from \"../v1/client/scheme\";\nimport { NETWORKS } from \"../../v1\";\n\n/**\n * Configuration options for registering SVM schemes to an x402Client\n */\nexport interface SvmClientConfig {\n  /**\n   * The SVM signer to use for creating payment payloads\n   */\n  signer: ClientSvmSigner;\n\n  /**\n   * Optional payment requirements selector function\n   */\n  paymentRequirementsSelector?: SelectPaymentRequirements;\n\n  /**\n   * Optional policies to apply to the client\n   */\n  policies?: PaymentPolicy[];\n\n  /**\n   * Optional specific networks to register\n   */\n  networks?: Network[];\n}\n\n/**\n * Registers SVM payment schemes to an existing x402Client instance.\n *\n * @param client - The x402Client instance to register schemes to\n * @param config - Configuration for SVM client registration\n * @returns The client instance for chaining\n */\nexport function registerExactSvmScheme(client: x402Client, config: SvmClientConfig): x402Client {\n  // Register V2 scheme\n  if (config.networks && config.networks.length > 0) {\n    config.networks.forEach(network => {\n      client.register(network, new ExactSvmScheme(config.signer));\n    });\n  } else {\n    client.register(\"solana:*\", new ExactSvmScheme(config.signer));\n  }\n\n  // Register all V1 networks\n  NETWORKS.forEach(network => {\n    client.registerV1(network as Network, new ExactSvmSchemeV1(config.signer));\n  });\n\n  if (config.policies) {\n    config.policies.forEach(policy => {\n      client.registerPolicy(policy);\n    });\n  }\n\n  return client;\n}\n"],"mappings":";;;;;;;;;;;;;AAuCO,SAAS,uBAAuB,QAAoB,QAAqC;AAE9F,MAAI,OAAO,YAAY,OAAO,SAAS,SAAS,GAAG;AACjD,WAAO,SAAS,QAAQ,aAAW;AACjC,aAAO,SAAS,SAAS,IAAI,eAAe,OAAO,MAAM,CAAC;AAAA,IAC5D,CAAC;AAAA,EACH,OAAO;AACL,WAAO,SAAS,YAAY,IAAI,eAAe,OAAO,MAAM,CAAC;AAAA,EAC/D;AAGA,WAAS,QAAQ,aAAW;AAC1B,WAAO,WAAW,SAAoB,IAAI,iBAAiB,OAAO,MAAM,CAAC;AAAA,EAC3E,CAAC;AAED,MAAI,OAAO,UAAU;AACnB,WAAO,SAAS,QAAQ,YAAU;AAChC,aAAO,eAAe,MAAM;AAAA,IAC9B,CAAC;AAAA,EACH;AAEA,SAAO;AACT;","names":[]}
+{"version":3,"sources":["../../../../src/exact/client/register.ts"],"sourcesContent":["import { x402Client, SelectPaymentRequirements, PaymentPolicy } from \"@x402/core/client\";\nimport { Network } from \"@x402/core/types\";\nimport { ClientSvmSigner } from \"../../signer\";\nimport { ExactSvmScheme } from \"./scheme\";\nimport { ExactSvmSchemeV1 } from \"../v1/client/scheme\";\nimport { NETWORKS } from \"../../v1\";\n\n/**\n * Configuration options for registering SVM schemes to an x402Client\n */\nexport interface SvmClientConfig {\n  /**\n   * The SVM signer to use for creating payment payloads\n   */\n  signer: ClientSvmSigner;\n\n  /**\n   * Optional payment requirements selector function\n   */\n  paymentRequirementsSelector?: SelectPaymentRequirements;\n\n  /**\n   * Optional policies to apply to the client\n   */\n  policies?: PaymentPolicy[];\n\n  /**\n   * Optional specific networks to register\n   */\n  networks?: Network[];\n}\n\n/**\n * Registers SVM payment schemes to an existing x402Client instance.\n *\n * @param client - The x402Client instance to register schemes to\n * @param config - Configuration for SVM client registration\n * @returns The client instance for chaining\n */\nexport function registerExactSvmScheme(client: x402Client, config: SvmClientConfig): x402Client {\n  // Register V2 scheme\n  if (config.networks && config.networks.length > 0) {\n    config.networks.forEach(network => {\n      client.register(network, new ExactSvmScheme(config.signer));\n    });\n  } else {\n    client.register(\"solana:*\", new ExactSvmScheme(config.signer));\n  }\n\n  // Register all V1 networks\n  NETWORKS.forEach(network => {\n    client.registerV1(network as Network, new ExactSvmSchemeV1(config.signer));\n  });\n\n  if (config.policies) {\n    config.policies.forEach(policy => {\n      client.registerPolicy(policy);\n    });\n  }\n\n  return client;\n}\n"],"mappings":";;;;;;;;;;;;;;AAuCO,SAAS,uBAAuB,QAAoB,QAAqC;AAE9F,MAAI,OAAO,YAAY,OAAO,SAAS,SAAS,GAAG;AACjD,WAAO,SAAS,QAAQ,aAAW;AACjC,aAAO,SAAS,SAAS,IAAI,eAAe,OAAO,MAAM,CAAC;AAAA,IAC5D,CAAC;AAAA,EACH,OAAO;AACL,WAAO,SAAS,YAAY,IAAI,eAAe,OAAO,MAAM,CAAC;AAAA,EAC/D;AAGA,WAAS,QAAQ,aAAW;AAC1B,WAAO,WAAW,SAAoB,IAAI,iBAAiB,OAAO,MAAM,CAAC;AAAA,EAC3E,CAAC;AAED,MAAI,OAAO,UAAU;AACnB,WAAO,SAAS,QAAQ,YAAU;AAChC,aAAO,eAAe,MAAM;AAAA,IAC9B,CAAC;AAAA,EACH;AAEA,SAAO;AACT;","names":[]}

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

@@ -1,5 +1,6 @@
 import { SchemeNetworkFacilitator, PaymentPayload, PaymentRequirements, VerifyResponse, SettleResponse, Network } from '@x402/core/types';
-import { F as FacilitatorSvmSigner } from '../../signer-V35oXttt.mjs';
+import { S as SettlementCache } from '../../settlement-cache-D9gb94wH.mjs';
+import { F as FacilitatorSvmSigner } from '../../signer-BMkbhFYE.mjs';
 import { x402Facilitator } from '@x402/core/facilitator';
 import '@solana/kit';
 
@@ -10,13 +11,15 @@ declare class ExactSvmScheme implements SchemeNetworkFacilitator {
     private readonly signer;
     readonly scheme = "exact";
     readonly caipFamily = "solana:*";
+    private readonly settlementCache;
     /**
      * Creates a new ExactSvmFacilitator instance.
      *
      * @param signer - The SVM RPC client for facilitator operations
+     * @param settlementCache - Optional shared settlement cache (one is created if omitted)
      * @returns ExactSvmFacilitator instance
      */
-    constructor(signer: FacilitatorSvmSigner);
+    constructor(signer: FacilitatorSvmSigner, settlementCache?: SettlementCache);
     /**
      * Get mechanism-specific extra data for the supported kinds endpoint.
      * For SVM, this includes a randomly selected fee payer address.

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

@@ -1,17 +1,20 @@
 import {
   NETWORKS
 } from "../../chunk-WWACQNRQ.mjs";
-import "../../chunk-6ZXKIZKL.mjs";
+import "../../chunk-V5GMZRSA.mjs";
 import {
   ExactSvmSchemeV1
-} from "../../chunk-K4ZT4D23.mjs";
+} from "../../chunk-SV64M7KA.mjs";
+import {
+  SettlementCache
+} from "../../chunk-UIASIAEW.mjs";
 import {
   LIGHTHOUSE_PROGRAM_ADDRESS,
   MAX_COMPUTE_UNIT_PRICE_MICROLAMPORTS,
   MEMO_PROGRAM_ADDRESS,
   decodeTransactionFromPayload,
   getTokenPayerFromTransaction
-} from "../../chunk-FWLOH47E.mjs";
+} from "../../chunk-TZGEGCWJ.mjs";
 
 // src/exact/facilitator/scheme.ts
 import {
@@ -37,12 +40,14 @@ var ExactSvmScheme = class {
    * Creates a new ExactSvmFacilitator instance.
    *
    * @param signer - The SVM RPC client for facilitator operations
+   * @param settlementCache - Optional shared settlement cache (one is created if omitted)
    * @returns ExactSvmFacilitator instance
    */
-  constructor(signer) {
+  constructor(signer, settlementCache) {
     this.signer = signer;
     this.scheme = "exact";
     this.caipFamily = "solana:*";
+    this.settlementCache = settlementCache ?? new SettlementCache();
   }
   /**
    * Get mechanism-specific extra data for the supported kinds endpoint.
@@ -207,10 +212,10 @@ var ExactSvmScheme = class {
       };
     }
     const amount = parsedTransfer.data.amount;
-    if (amount < BigInt(requirements.amount)) {
+    if (amount !== BigInt(requirements.amount)) {
       return {
         isValid: false,
-        invalidReason: "invalid_exact_svm_payload_amount_insufficient",
+        invalidReason: "invalid_exact_svm_payload_amount_mismatch",
         payer
       };
     }
@@ -274,6 +279,16 @@ var ExactSvmScheme = class {
         payer: valid.payer || ""
       };
     }
+    const txKey = exactSvmPayload.transaction;
+    if (this.settlementCache.isDuplicate(txKey)) {
+      return {
+        success: false,
+        network: payload.accepted.network,
+        transaction: "",
+        errorReason: "duplicate_settlement",
+        payer: valid.payer || ""
+      };
+    }
     try {
       const feePayer = requirements.extra.feePayer;
       const fullySignedTransaction = await this.signer.signTransaction(
@@ -359,8 +374,12 @@ var ExactSvmScheme = class {
 
 // src/exact/facilitator/register.ts
 function registerExactSvmScheme(facilitator, config) {
-  facilitator.register(config.networks, new ExactSvmScheme(config.signer));
-  facilitator.registerV1(NETWORKS, new ExactSvmSchemeV1(config.signer));
+  const settlementCache = new SettlementCache();
+  facilitator.register(config.networks, new ExactSvmScheme(config.signer, settlementCache));
+  facilitator.registerV1(
+    NETWORKS,
+    new ExactSvmSchemeV1(config.signer, settlementCache)
+  );
   return facilitator;
 }
 export {