x402-express-mantle 1.0.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +155 -0
- package/lib/cjs/client/index.d.ts +243 -0
- package/lib/cjs/client/index.js +413 -0
- package/lib/cjs/client/index.js.map +1 -0
- package/lib/cjs/exact/client/index.d.ts +37 -0
- package/lib/cjs/exact/client/index.js +281 -0
- package/lib/cjs/exact/client/index.js.map +1 -0
- package/lib/cjs/exact/facilitator/index.d.ts +110 -0
- package/lib/cjs/exact/facilitator/index.js +714 -0
- package/lib/cjs/exact/facilitator/index.js.map +1 -0
- package/lib/cjs/exact/server/index.d.ts +87 -0
- package/lib/cjs/exact/server/index.js +209 -0
- package/lib/cjs/exact/server/index.js.map +1 -0
- package/lib/cjs/exact/v1/client/index.d.ts +33 -0
- package/lib/cjs/exact/v1/client/index.js +169 -0
- package/lib/cjs/exact/v1/client/index.js.map +1 -0
- package/lib/cjs/exact/v1/facilitator/index.d.ts +71 -0
- package/lib/cjs/exact/v1/facilitator/index.js +384 -0
- package/lib/cjs/exact/v1/facilitator/index.js.map +1 -0
- package/lib/cjs/facilitator/index.d.ts +192 -0
- package/lib/cjs/facilitator/index.js +398 -0
- package/lib/cjs/facilitator/index.js.map +1 -0
- package/lib/cjs/http/index.d.ts +52 -0
- package/lib/cjs/http/index.js +827 -0
- package/lib/cjs/http/index.js.map +1 -0
- package/lib/cjs/index.d.ts +145 -0
- package/lib/cjs/index.js +314 -0
- package/lib/cjs/index.js.map +1 -0
- package/lib/cjs/mechanisms-CzuGzYsS.d.ts +270 -0
- package/lib/cjs/scheme-MoBRXFM8.d.ts +29 -0
- package/lib/cjs/server/index.d.ts +2 -0
- package/lib/cjs/server/index.js +1305 -0
- package/lib/cjs/server/index.js.map +1 -0
- package/lib/cjs/signer-5OVDxViv.d.ts +79 -0
- package/lib/cjs/signer-BMkbhFYE.d.ts +123 -0
- package/lib/cjs/types/index.d.ts +1 -0
- package/lib/cjs/types/index.js +66 -0
- package/lib/cjs/types/index.js.map +1 -0
- package/lib/cjs/types/v1/index.d.ts +1 -0
- package/lib/cjs/types/v1/index.js +19 -0
- package/lib/cjs/types/v1/index.js.map +1 -0
- package/lib/cjs/utils/index.d.ts +48 -0
- package/lib/cjs/utils/index.js +116 -0
- package/lib/cjs/utils/index.js.map +1 -0
- package/lib/cjs/v1/index.d.ts +12 -0
- package/lib/cjs/v1/index.js +180 -0
- package/lib/cjs/v1/index.js.map +1 -0
- package/lib/cjs/x402HTTPResourceServer-D1YtlH_r.d.ts +719 -0
- package/lib/esm/chunk-3CEIVWNN.mjs +339 -0
- package/lib/esm/chunk-3CEIVWNN.mjs.map +1 -0
- package/lib/esm/chunk-BJTO5JO5.mjs +11 -0
- package/lib/esm/chunk-BJTO5JO5.mjs.map +1 -0
- package/lib/esm/chunk-EEA7DKZI.mjs +111 -0
- package/lib/esm/chunk-EEA7DKZI.mjs.map +1 -0
- package/lib/esm/chunk-FOUXRQAV.mjs +88 -0
- package/lib/esm/chunk-FOUXRQAV.mjs.map +1 -0
- package/lib/esm/chunk-IKSTWKEM.mjs +157 -0
- package/lib/esm/chunk-IKSTWKEM.mjs.map +1 -0
- package/lib/esm/chunk-JYZWCLMP.mjs +305 -0
- package/lib/esm/chunk-JYZWCLMP.mjs.map +1 -0
- package/lib/esm/chunk-PNSAJQCF.mjs +108 -0
- package/lib/esm/chunk-PNSAJQCF.mjs.map +1 -0
- package/lib/esm/chunk-PSA4YVU2.mjs +92 -0
- package/lib/esm/chunk-PSA4YVU2.mjs.map +1 -0
- package/lib/esm/chunk-QLXM7BIB.mjs +23 -0
- package/lib/esm/chunk-QLXM7BIB.mjs.map +1 -0
- package/lib/esm/chunk-TDLQZ6MP.mjs +86 -0
- package/lib/esm/chunk-TDLQZ6MP.mjs.map +1 -0
- package/lib/esm/chunk-VE37GDG2.mjs +7 -0
- package/lib/esm/chunk-VE37GDG2.mjs.map +1 -0
- package/lib/esm/chunk-WWACQNRQ.mjs +7 -0
- package/lib/esm/chunk-WWACQNRQ.mjs.map +1 -0
- package/lib/esm/chunk-X4W4S5RB.mjs +39 -0
- package/lib/esm/chunk-X4W4S5RB.mjs.map +1 -0
- package/lib/esm/chunk-Z4QX3O5V.mjs +748 -0
- package/lib/esm/chunk-Z4QX3O5V.mjs.map +1 -0
- package/lib/esm/chunk-ZYXTTU74.mjs +88 -0
- package/lib/esm/chunk-ZYXTTU74.mjs.map +1 -0
- package/lib/esm/client/index.d.mts +243 -0
- package/lib/esm/client/index.mjs +260 -0
- package/lib/esm/client/index.mjs.map +1 -0
- package/lib/esm/exact/client/index.d.mts +37 -0
- package/lib/esm/exact/client/index.mjs +36 -0
- package/lib/esm/exact/client/index.mjs.map +1 -0
- package/lib/esm/exact/facilitator/index.d.mts +110 -0
- package/lib/esm/exact/facilitator/index.mjs +350 -0
- package/lib/esm/exact/facilitator/index.mjs.map +1 -0
- package/lib/esm/exact/server/index.d.mts +87 -0
- package/lib/esm/exact/server/index.mjs +129 -0
- package/lib/esm/exact/server/index.mjs.map +1 -0
- package/lib/esm/exact/v1/client/index.d.mts +33 -0
- package/lib/esm/exact/v1/client/index.mjs +8 -0
- package/lib/esm/exact/v1/client/index.mjs.map +1 -0
- package/lib/esm/exact/v1/facilitator/index.d.mts +71 -0
- package/lib/esm/exact/v1/facilitator/index.mjs +8 -0
- package/lib/esm/exact/v1/facilitator/index.mjs.map +1 -0
- package/lib/esm/facilitator/index.d.mts +192 -0
- package/lib/esm/facilitator/index.mjs +373 -0
- package/lib/esm/facilitator/index.mjs.map +1 -0
- package/lib/esm/http/index.d.mts +52 -0
- package/lib/esm/http/index.mjs +29 -0
- package/lib/esm/http/index.mjs.map +1 -0
- package/lib/esm/index.d.mts +145 -0
- package/lib/esm/index.mjs +277 -0
- package/lib/esm/index.mjs.map +1 -0
- package/lib/esm/mechanisms-CzuGzYsS.d.mts +270 -0
- package/lib/esm/scheme-fjF-9LhT.d.mts +29 -0
- package/lib/esm/server/index.d.mts +2 -0
- package/lib/esm/server/index.mjs +563 -0
- package/lib/esm/server/index.mjs.map +1 -0
- package/lib/esm/signer-5OVDxViv.d.mts +79 -0
- package/lib/esm/signer-BMkbhFYE.d.mts +123 -0
- package/lib/esm/types/index.d.mts +1 -0
- package/lib/esm/types/index.mjs +10 -0
- package/lib/esm/types/index.mjs.map +1 -0
- package/lib/esm/types/v1/index.d.mts +1 -0
- package/lib/esm/types/v1/index.mjs +1 -0
- package/lib/esm/types/v1/index.mjs.map +1 -0
- package/lib/esm/utils/index.d.mts +48 -0
- package/lib/esm/utils/index.mjs +20 -0
- package/lib/esm/utils/index.mjs.map +1 -0
- package/lib/esm/v1/index.d.mts +12 -0
- package/lib/esm/v1/index.mjs +13 -0
- package/lib/esm/v1/index.mjs.map +1 -0
- package/lib/esm/x402HTTPResourceServer-BIfIK5HS.d.mts +719 -0
- package/package.json +39 -0
- package/src/index.js +4 -0
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"sources":["../../../../src/exact/facilitator/index.ts","../../../../src/exact/facilitator/scheme.ts","../../../../src/constants.ts","../../../../src/utils.ts","../../../../src/exact/v1/facilitator/scheme.ts","../../../../src/exact/v1/client/scheme.ts","../../../../src/v1/index.ts","../../../../src/exact/facilitator/register.ts"],"sourcesContent":["export { ExactSvmScheme } from \"./scheme\";\nexport { registerExactSvmScheme } from \"./register\";\nexport type { SvmFacilitatorConfig } from \"./register\";\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 { MAX_COMPUTE_UNIT_PRICE_MICROLAMPORTS } from \"../../constants\";\nimport type { FacilitatorSvmSigner } from \"../../signer\";\nimport type { ExactSvmPayloadV2 } from \"../../types\";\nimport { decodeTransactionFromPayload, getTokenPayerFromTransaction } from \"../../utils\";\n\n/**\n * SVM facilitator implementation for the Exact payment scheme.\n */\nexport class ExactSvmScheme implements SchemeNetworkFacilitator {\n readonly scheme = \"exact\";\n readonly caipFamily = \"solana:*\";\n\n /**\n * Creates a new ExactSvmFacilitator instance.\n *\n * @param signer - The SVM RPC client for facilitator operations\n * @returns ExactSvmFacilitator 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.\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 exactSvmPayload = payload.payload as ExactSvmPayloadV2;\n\n // Step 1: Validate Payment Requirements\n if (payload.accepted.scheme !== \"exact\" || requirements.scheme !== \"exact\") {\n return {\n isValid: false,\n invalidReason: \"unsupported_scheme\",\n payer: \"\",\n };\n }\n\n if (payload.accepted.network !== requirements.network) {\n return {\n isValid: false,\n invalidReason: \"network_mismatch\",\n payer: \"\",\n };\n }\n\n if (!requirements.extra?.feePayer || typeof requirements.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(requirements.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 // 3 instructions: ComputeLimit + ComputePrice + TransferChecked\n if (instructions.length !== 3) {\n return {\n isValid: false,\n invalidReason: \"invalid_exact_svm_payload_transaction_instructions_length\",\n payer: \"\",\n };\n }\n\n // Step 3: Verify Compute Budget Instructions\n try {\n this.verifyComputeLimitInstruction(instructions[0] as never);\n this.verifyComputePriceInstruction(instructions[1] as never);\n } catch (error) {\n const errorMessage = error instanceof Error ? error.message : String(error);\n return {\n isValid: false,\n invalidReason: errorMessage,\n payer: \"\",\n };\n }\n\n const payer = getTokenPayerFromTransaction(transaction);\n if (!payer) {\n return {\n isValid: false,\n invalidReason: \"invalid_exact_svm_payload_no_transfer_instruction\",\n payer: \"\",\n };\n }\n\n // Step 4: Verify Transfer Instruction\n const transferIx = instructions[2];\n const programAddress = transferIx.programAddress.toString();\n\n if (\n programAddress !== TOKEN_PROGRAM_ADDRESS.toString() &&\n programAddress !== TOKEN_2022_PROGRAM_ADDRESS.toString()\n ) {\n return {\n isValid: false,\n invalidReason: \"invalid_exact_svm_payload_no_transfer_instruction\",\n payer,\n };\n }\n\n // Parse the transfer instruction using the appropriate library helper\n let parsedTransfer;\n try {\n if (programAddress === TOKEN_PROGRAM_ADDRESS.toString()) {\n parsedTransfer = parseTransferCheckedInstructionToken(transferIx as never);\n } else {\n parsedTransfer = parseTransferCheckedInstruction2022(transferIx as never);\n }\n } catch {\n return {\n isValid: false,\n invalidReason: \"invalid_exact_svm_payload_no_transfer_instruction\",\n payer,\n };\n }\n\n // Verify that the facilitator's signers are not transferring their own funds\n // SECURITY: Prevent facilitator from signing away their own tokens\n const authorityAddress = parsedTransfer.accounts.authority.address.toString();\n if (signerAddresses.includes(authorityAddress)) {\n return {\n isValid: false,\n invalidReason: \"invalid_exact_svm_payload_transaction_fee_payer_transferring_funds\",\n payer,\n };\n }\n\n // Verify mint address matches requirements\n const mintAddress = parsedTransfer.accounts.mint.address.toString();\n if (mintAddress !== requirements.asset) {\n return {\n isValid: false,\n invalidReason: \"invalid_exact_svm_payload_mint_mismatch\",\n payer,\n };\n }\n\n // Verify destination ATA matches expected ATA for payTo address\n const destATA = parsedTransfer.accounts.destination.address.toString();\n try {\n const [expectedDestATA] = await findAssociatedTokenPda({\n mint: requirements.asset as Address,\n owner: requirements.payTo as Address,\n tokenProgram:\n programAddress === TOKEN_PROGRAM_ADDRESS.toString()\n ? (TOKEN_PROGRAM_ADDRESS as Address)\n : (TOKEN_2022_PROGRAM_ADDRESS as Address),\n });\n\n if (destATA !== expectedDestATA.toString()) {\n return {\n isValid: false,\n invalidReason: \"invalid_exact_svm_payload_recipient_mismatch\",\n payer,\n };\n }\n } catch {\n return {\n isValid: false,\n invalidReason: \"invalid_exact_svm_payload_recipient_mismatch\",\n payer,\n };\n }\n\n // Verify transfer amount meets requirements\n const amount = parsedTransfer.data.amount;\n if (amount < BigInt(requirements.amount)) {\n return {\n isValid: false,\n invalidReason: \"invalid_exact_svm_payload_amount_insufficient\",\n payer,\n };\n }\n\n // Step 5: Sign and Simulate Transaction\n // CRITICAL: Simulation proves transaction will succeed (catches insufficient balance, invalid accounts, etc)\n try {\n const feePayer = 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 // Simulate to verify transaction would succeed\n await this.signer.simulateTransaction(fullySignedTransaction, requirements.network);\n } catch (error) {\n const errorMessage = error instanceof Error ? error.message : String(error);\n return {\n isValid: false,\n invalidReason: `transaction_simulation_failed: ${errorMessage}`,\n payer,\n };\n }\n\n return {\n isValid: true,\n invalidReason: undefined,\n payer,\n };\n }\n\n /**\n * Settles a payment by submitting the transaction.\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 exactSvmPayload = payload.payload as ExactSvmPayloadV2;\n\n const valid = await this.verify(payload, requirements);\n if (!valid.isValid) {\n return {\n success: false,\n network: payload.accepted.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: payload.accepted.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: payload.accepted.network,\n payer: valid.payer || \"\",\n };\n }\n }\n\n /**\n * Verify that the compute limit instruction is valid.\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 // discriminator for SetComputeUnitLimit\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 that the compute price instruction is valid.\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 // discriminator for SetComputeUnitPrice\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","/**\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\";\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 = 6500;\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 { MAX_COMPUTE_UNIT_PRICE_MICROLAMPORTS } from \"../../../constants\";\nimport type { FacilitatorSvmSigner } from \"../../../signer\";\nimport type { ExactSvmPayloadV1 } from \"../../../types\";\nimport { decodeTransactionFromPayload, getTokenPayerFromTransaction } from \"../../../utils\";\n\n/**\n * SVM facilitator implementation for the Exact payment scheme (V1).\n */\nexport class ExactSvmSchemeV1 implements SchemeNetworkFacilitator {\n readonly scheme = \"exact\";\n readonly caipFamily = \"solana:*\";\n\n /**\n * Creates a new ExactSvmFacilitatorV1 instance.\n *\n * @param signer - The SVM RPC client for facilitator operations\n * @returns ExactSvmFacilitatorV1 instance\n */\n constructor(private readonly signer: FacilitatorSvmSigner) {}\n\n /**\n * Get mechanism-specific extra data for the supported kinds endpoint.\n * For SVM, this includes a randomly selected fee payer address.\n * Random selection distributes load across multiple signers.\n *\n * @param _ - The network identifier (unused for SVM)\n * @returns Extra data with feePayer address\n */\n getExtra(_: string): Record<string, unknown> | undefined {\n // Randomly select from available signers to distribute load\n const addresses = this.signer.getAddresses();\n const randomIndex = Math.floor(Math.random() * addresses.length);\n\n return {\n feePayer: addresses[randomIndex],\n };\n }\n\n /**\n * Get signer addresses used by this facilitator.\n * For SVM, returns all available fee payer addresses.\n *\n * @param _ - The network identifier (unused for SVM)\n * @returns Array of fee payer addresses\n */\n getSigners(_: string): string[] {\n return [...this.signer.getAddresses()];\n }\n\n /**\n * Verifies a payment payload (V1).\n *\n * @param payload - The payment payload to verify\n * @param requirements - The payment requirements\n * @returns Promise resolving to verification response\n */\n async verify(\n payload: PaymentPayload,\n requirements: PaymentRequirements,\n ): Promise<VerifyResponse> {\n const requirementsV1 = requirements as unknown as PaymentRequirementsV1;\n const payloadV1 = payload as unknown as PaymentPayloadV1;\n const exactSvmPayload = payload.payload as ExactSvmPayloadV1;\n\n // Step 1: Validate Payment Requirements\n if (payloadV1.scheme !== \"exact\" || requirements.scheme !== \"exact\") {\n return {\n isValid: false,\n invalidReason: \"unsupported_scheme\",\n payer: \"\",\n };\n }\n\n if (payloadV1.network !== requirements.network) {\n return {\n isValid: false,\n invalidReason: \"network_mismatch\",\n payer: \"\",\n };\n }\n\n if (!requirementsV1.extra?.feePayer || typeof requirementsV1.extra.feePayer !== \"string\") {\n return {\n isValid: false,\n invalidReason: \"invalid_exact_svm_payload_missing_fee_payer\",\n payer: \"\",\n };\n }\n\n // Verify that the requested feePayer is managed by this facilitator\n const signerAddresses = this.signer.getAddresses().map(addr => addr.toString());\n if (!signerAddresses.includes(requirementsV1.extra.feePayer)) {\n return {\n isValid: false,\n invalidReason: \"fee_payer_not_managed_by_facilitator\",\n payer: \"\",\n };\n }\n\n // Step 2: Parse and Validate Transaction Structure\n let transaction;\n try {\n transaction = decodeTransactionFromPayload(exactSvmPayload);\n } catch {\n return {\n isValid: false,\n invalidReason: \"invalid_exact_svm_payload_transaction_could_not_be_decoded\",\n payer: \"\",\n };\n }\n\n const compiled = getCompiledTransactionMessageDecoder().decode(transaction.messageBytes);\n const decompiled = decompileTransactionMessage(compiled);\n const instructions = decompiled.instructions ?? [];\n\n // 3 instructions: ComputeLimit + ComputePrice + TransferChecked\n if (instructions.length !== 3) {\n return {\n isValid: false,\n invalidReason: \"invalid_exact_svm_payload_transaction_instructions_length\",\n payer: \"\",\n };\n }\n\n // Step 3: Verify Compute Budget Instructions\n try {\n this.verifyComputeLimitInstruction(instructions[0] as never);\n this.verifyComputePriceInstruction(instructions[1] as never);\n } catch (error) {\n const errorMessage = error instanceof Error ? error.message : String(error);\n return {\n isValid: false,\n invalidReason: errorMessage,\n payer: \"\",\n };\n }\n\n const payer = getTokenPayerFromTransaction(transaction);\n if (!payer) {\n return {\n isValid: false,\n invalidReason: \"invalid_exact_svm_payload_no_transfer_instruction\",\n payer: \"\",\n };\n }\n\n // Step 4: Verify Transfer Instruction\n const transferIx = instructions[2];\n const programAddress = transferIx.programAddress.toString();\n\n if (\n programAddress !== TOKEN_PROGRAM_ADDRESS.toString() &&\n programAddress !== TOKEN_2022_PROGRAM_ADDRESS.toString()\n ) {\n return {\n isValid: false,\n invalidReason: \"invalid_exact_svm_payload_no_transfer_instruction\",\n payer,\n };\n }\n\n // Parse the transfer instruction using the appropriate library helper\n let parsedTransfer;\n try {\n if (programAddress === TOKEN_PROGRAM_ADDRESS.toString()) {\n parsedTransfer = parseTransferCheckedInstructionToken(transferIx as never);\n } else {\n parsedTransfer = parseTransferCheckedInstruction2022(transferIx as never);\n }\n } catch {\n return {\n isValid: false,\n invalidReason: \"invalid_exact_svm_payload_no_transfer_instruction\",\n payer,\n };\n }\n\n // Verify that the facilitator's signers are not transferring their own funds\n // SECURITY: Prevent facilitator from signing away their own tokens\n const authorityAddress = parsedTransfer.accounts.authority.address.toString();\n if (signerAddresses.includes(authorityAddress)) {\n return {\n isValid: false,\n invalidReason: \"invalid_exact_svm_payload_transaction_fee_payer_transferring_funds\",\n payer,\n };\n }\n\n // Verify mint address matches requirements\n const mintAddress = parsedTransfer.accounts.mint.address.toString();\n if (mintAddress !== requirements.asset) {\n return {\n isValid: false,\n invalidReason: \"invalid_exact_svm_payload_mint_mismatch\",\n payer,\n };\n }\n\n // Verify destination ATA matches expected ATA for payTo address\n const destATA = parsedTransfer.accounts.destination.address.toString();\n try {\n const [expectedDestATA] = await findAssociatedTokenPda({\n mint: requirements.asset as Address,\n owner: requirements.payTo as Address,\n tokenProgram:\n programAddress === TOKEN_PROGRAM_ADDRESS.toString()\n ? (TOKEN_PROGRAM_ADDRESS as Address)\n : (TOKEN_2022_PROGRAM_ADDRESS as Address),\n });\n\n if (destATA !== expectedDestATA.toString()) {\n return {\n isValid: false,\n invalidReason: \"invalid_exact_svm_payload_recipient_mismatch\",\n payer,\n };\n }\n } catch {\n return {\n isValid: false,\n invalidReason: \"invalid_exact_svm_payload_recipient_mismatch\",\n payer,\n };\n }\n\n // Verify transfer amount meets requirements\n const amount = parsedTransfer.data.amount;\n if (amount < BigInt(requirementsV1.maxAmountRequired)) {\n return {\n isValid: false,\n invalidReason: \"invalid_exact_svm_payload_amount_insufficient\",\n payer,\n };\n }\n\n // Step 5: Sign and Simulate Transaction\n // CRITICAL: Simulation proves transaction will succeed (catches insufficient balance, invalid accounts, etc)\n try {\n const feePayer = requirementsV1.extra.feePayer as Address;\n\n // Sign transaction with the feePayer's signer\n const fullySignedTransaction = await this.signer.signTransaction(\n exactSvmPayload.transaction,\n feePayer,\n requirements.network,\n );\n\n // Simulate to verify transaction would succeed\n await this.signer.simulateTransaction(fullySignedTransaction, requirements.network);\n } catch (error) {\n const errorMessage = error instanceof Error ? error.message : String(error);\n return {\n isValid: false,\n invalidReason: `transaction_simulation_failed: ${errorMessage}`,\n payer,\n };\n }\n\n return {\n isValid: true,\n invalidReason: undefined,\n payer,\n };\n }\n\n /**\n * Settles a payment by submitting the transaction (V1).\n * Ensures the correct signer is used based on the feePayer specified in requirements.\n *\n * @param payload - The payment payload to settle\n * @param requirements - The payment requirements\n * @returns Promise resolving to settlement response\n */\n async settle(\n payload: PaymentPayload,\n requirements: PaymentRequirements,\n ): Promise<SettleResponse> {\n const payloadV1 = payload as unknown as PaymentPayloadV1;\n const exactSvmPayload = payload.payload as ExactSvmPayloadV1;\n\n const valid = await this.verify(payload, requirements);\n if (!valid.isValid) {\n return {\n success: false,\n network: payloadV1.network,\n transaction: \"\",\n errorReason: valid.invalidReason ?? \"verification_failed\",\n payer: valid.payer || \"\",\n };\n }\n\n try {\n // Extract feePayer from requirements (already validated in verify)\n const feePayer = requirements.extra.feePayer as Address;\n\n // Sign transaction with the feePayer's signer\n const fullySignedTransaction = await this.signer.signTransaction(\n exactSvmPayload.transaction,\n feePayer,\n requirements.network,\n );\n\n // Send transaction to network\n const signature = await this.signer.sendTransaction(\n fullySignedTransaction,\n requirements.network,\n );\n\n // Wait for confirmation\n await this.signer.confirmTransaction(signature, requirements.network);\n\n return {\n success: true,\n transaction: signature,\n network: payloadV1.network,\n payer: valid.payer,\n };\n } catch (error) {\n console.error(\"Failed to settle transaction:\", error);\n return {\n success: false,\n errorReason: \"transaction_failed\",\n transaction: \"\",\n network: payloadV1.network,\n payer: valid.payer || \"\",\n };\n }\n }\n\n /**\n * Verify compute limit instruction\n *\n * @param instruction - The compute limit instruction\n * @param instruction.programAddress - Program address\n * @param instruction.data - Instruction data bytes\n */\n private verifyComputeLimitInstruction(instruction: {\n programAddress: Address;\n data?: Readonly<Uint8Array>;\n }): void {\n const programAddress = instruction.programAddress.toString();\n\n if (\n programAddress !== COMPUTE_BUDGET_PROGRAM_ADDRESS.toString() ||\n !instruction.data ||\n instruction.data[0] !== 2\n ) {\n throw new Error(\n \"invalid_exact_svm_payload_transaction_instructions_compute_limit_instruction\",\n );\n }\n\n try {\n parseSetComputeUnitLimitInstruction(instruction as never);\n } catch {\n throw new Error(\n \"invalid_exact_svm_payload_transaction_instructions_compute_limit_instruction\",\n );\n }\n }\n\n /**\n * Verify compute price instruction\n *\n * @param instruction - The compute price instruction\n * @param instruction.programAddress - Program address\n * @param instruction.data - Instruction data bytes\n */\n private verifyComputePriceInstruction(instruction: {\n programAddress: Address;\n data?: Readonly<Uint8Array>;\n }): void {\n const programAddress = instruction.programAddress.toString();\n\n if (\n programAddress !== COMPUTE_BUDGET_PROGRAM_ADDRESS.toString() ||\n !instruction.data ||\n instruction.data[0] !== 3\n ) {\n throw new Error(\n \"invalid_exact_svm_payload_transaction_instructions_compute_price_instruction\",\n );\n }\n\n try {\n const parsedInstruction = parseSetComputeUnitPriceInstruction(instruction as never);\n\n // Check if price exceeds maximum (5 lamports per compute unit)\n if (\n (parsedInstruction as unknown as { microLamports: bigint }).microLamports >\n BigInt(MAX_COMPUTE_UNIT_PRICE_MICROLAMPORTS)\n ) {\n throw new Error(\n \"invalid_exact_svm_payload_transaction_instructions_compute_price_instruction_too_high\",\n );\n }\n } catch (error) {\n if (error instanceof Error && error.message.includes(\"too_high\")) {\n throw error;\n }\n throw new Error(\n \"invalid_exact_svm_payload_transaction_instructions_compute_price_instruction\",\n );\n }\n }\n}\n","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} 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 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], 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 * V1 exports for the SVM mechanism\n */\nexport { ExactSvmSchemeV1 } from \"../exact/v1\";\n\nexport const NETWORKS: string[] = [\"solana\", \"solana-devnet\", \"solana-testnet\"];\n","import { x402Facilitator } from \"@x402/core/facilitator\";\nimport { Network } from \"@x402/core/types\";\nimport { FacilitatorSvmSigner } from \"../../signer\";\nimport { ExactSvmScheme } from \"./scheme\";\nimport { ExactSvmSchemeV1 } from \"../v1/facilitator/scheme\";\nimport { NETWORKS } from \"../../v1\";\n\n/**\n * Configuration options for registering SVM schemes to an x402Facilitator\n */\nexport interface SvmFacilitatorConfig {\n /**\n * The SVM signer for facilitator operations\n */\n signer: FacilitatorSvmSigner;\n\n /**\n * Networks to register (single network or array of networks)\n * Examples: \"solana:EtWTRABZaYq6iMfeYKouRu166VU2xqa1\", [\"solana:EtWTRABZaYq6iMfeYKouRu166VU2xqa1\", \"solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp\"]\n */\n networks: Network | Network[];\n}\n\n/**\n * Registers SVM payment schemes to an existing x402Facilitator instance.\n *\n * @param facilitator - The x402Facilitator instance to register schemes to\n * @param config - Configuration for SVM facilitator registration\n * @returns The facilitator instance for chaining\n *\n * @example\n * ```typescript\n * // Single network\n * registerExactSvmScheme(facilitator, {\n * signer: svmSigner,\n * networks: \"solana:EtWTRABZaYq6iMfeYKouRu166VU2xqa1\" // Devnet\n * });\n *\n * // Multiple networks (will auto-derive solana:* pattern)\n * registerExactSvmScheme(facilitator, {\n * signer: svmSigner,\n * networks: [\"solana:EtWTRABZaYq6iMfeYKouRu166VU2xqa1\", \"solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp\"]\n * });\n * ```\n */\nexport function registerExactSvmScheme(\n facilitator: x402Facilitator,\n config: SvmFacilitatorConfig,\n): x402Facilitator {\n // Register V2 scheme with specified networks\n facilitator.register(config.networks, new ExactSvmScheme(config.signer));\n\n // Register all V1 networks\n facilitator.registerV1(NETWORKS as Network[], new ExactSvmSchemeV1(config.signer));\n\n return facilitator;\n}\n"],"mappings":"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","names":["import_token","import_token_2022","import_kit","parseTransferCheckedInstructionToken","parseTransferCheckedInstruction2022","import_compute_budget","import_token","import_token_2022","import_kit","parseTransferCheckedInstructionToken","parseTransferCheckedInstruction2022","import_compute_budget","import_token","import_token_2022","import_kit"]}
|
|
@@ -0,0 +1,87 @@
|
|
|
1
|
+
import { SchemeNetworkServer, MoneyParser, Price, Network, AssetAmount, PaymentRequirements } from '@x402/core/types';
|
|
2
|
+
import { x402ResourceServer } from '@x402/core/server';
|
|
3
|
+
|
|
4
|
+
/**
|
|
5
|
+
* SVM server implementation for the Exact payment scheme.
|
|
6
|
+
*/
|
|
7
|
+
declare class ExactSvmScheme implements SchemeNetworkServer {
|
|
8
|
+
readonly scheme = "exact";
|
|
9
|
+
private moneyParsers;
|
|
10
|
+
/**
|
|
11
|
+
* Register a custom money parser in the parser chain.
|
|
12
|
+
* Multiple parsers can be registered - they will be tried in registration order.
|
|
13
|
+
* Each parser receives a decimal amount (e.g., 1.50 for $1.50).
|
|
14
|
+
* If a parser returns null, the next parser in the chain will be tried.
|
|
15
|
+
* The default parser is always the final fallback.
|
|
16
|
+
*
|
|
17
|
+
* @param parser - Custom function to convert amount to AssetAmount (or null to skip)
|
|
18
|
+
* @returns The service instance for chaining
|
|
19
|
+
*/
|
|
20
|
+
registerMoneyParser(parser: MoneyParser): ExactSvmScheme;
|
|
21
|
+
/**
|
|
22
|
+
* Parses a price into an asset amount.
|
|
23
|
+
* If price is already an AssetAmount, returns it directly.
|
|
24
|
+
* If price is Money (string | number), parses to decimal and tries custom parsers.
|
|
25
|
+
* Falls back to default conversion if all custom parsers return null.
|
|
26
|
+
*
|
|
27
|
+
* @param price - The price to parse
|
|
28
|
+
* @param network - The network to use
|
|
29
|
+
* @returns Promise that resolves to the parsed asset amount
|
|
30
|
+
*/
|
|
31
|
+
parsePrice(price: Price, network: Network): Promise<AssetAmount>;
|
|
32
|
+
/**
|
|
33
|
+
* Build payment requirements for this scheme/network combination
|
|
34
|
+
*
|
|
35
|
+
* @param paymentRequirements - The base payment requirements
|
|
36
|
+
* @param supportedKind - The supported kind configuration
|
|
37
|
+
* @param supportedKind.x402Version - The x402 protocol version
|
|
38
|
+
* @param supportedKind.scheme - The payment scheme
|
|
39
|
+
* @param supportedKind.network - The network identifier
|
|
40
|
+
* @param supportedKind.extra - Extra metadata including feePayer address
|
|
41
|
+
* @param extensionKeys - Extension keys supported by the facilitator
|
|
42
|
+
* @returns Enhanced payment requirements with feePayer in extra
|
|
43
|
+
*/
|
|
44
|
+
enhancePaymentRequirements(paymentRequirements: PaymentRequirements, supportedKind: {
|
|
45
|
+
x402Version: number;
|
|
46
|
+
scheme: string;
|
|
47
|
+
network: Network;
|
|
48
|
+
extra?: Record<string, unknown>;
|
|
49
|
+
}, extensionKeys: string[]): Promise<PaymentRequirements>;
|
|
50
|
+
/**
|
|
51
|
+
* Parse Money (string | number) to a decimal number.
|
|
52
|
+
* Handles formats like "$1.50", "1.50", 1.50, etc.
|
|
53
|
+
*
|
|
54
|
+
* @param money - The money value to parse
|
|
55
|
+
* @returns Decimal number
|
|
56
|
+
*/
|
|
57
|
+
private parseMoneyToDecimal;
|
|
58
|
+
/**
|
|
59
|
+
* Default money conversion implementation.
|
|
60
|
+
* Converts decimal amount to USDC on the specified network.
|
|
61
|
+
*
|
|
62
|
+
* @param amount - The decimal amount (e.g., 1.50)
|
|
63
|
+
* @param network - The network to use
|
|
64
|
+
* @returns The parsed asset amount in USDC
|
|
65
|
+
*/
|
|
66
|
+
private defaultMoneyConversion;
|
|
67
|
+
}
|
|
68
|
+
|
|
69
|
+
/**
|
|
70
|
+
* Configuration options for registering SVM schemes to an x402ResourceServer
|
|
71
|
+
*/
|
|
72
|
+
interface SvmResourceServerConfig {
|
|
73
|
+
/**
|
|
74
|
+
* Optional specific networks to register
|
|
75
|
+
*/
|
|
76
|
+
networks?: Network[];
|
|
77
|
+
}
|
|
78
|
+
/**
|
|
79
|
+
* Registers SVM payment schemes to an existing x402ResourceServer instance.
|
|
80
|
+
*
|
|
81
|
+
* @param server - The x402ResourceServer instance to register schemes to
|
|
82
|
+
* @param config - Configuration for SVM resource server registration
|
|
83
|
+
* @returns The server instance for chaining
|
|
84
|
+
*/
|
|
85
|
+
declare function registerExactSvmScheme(server: x402ResourceServer, config?: SvmResourceServerConfig): x402ResourceServer;
|
|
86
|
+
|
|
87
|
+
export { ExactSvmScheme, type SvmResourceServerConfig, registerExactSvmScheme };
|
|
@@ -0,0 +1,209 @@
|
|
|
1
|
+
"use strict";
|
|
2
|
+
var __defProp = Object.defineProperty;
|
|
3
|
+
var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
|
|
4
|
+
var __getOwnPropNames = Object.getOwnPropertyNames;
|
|
5
|
+
var __hasOwnProp = Object.prototype.hasOwnProperty;
|
|
6
|
+
var __export = (target, all) => {
|
|
7
|
+
for (var name in all)
|
|
8
|
+
__defProp(target, name, { get: all[name], enumerable: true });
|
|
9
|
+
};
|
|
10
|
+
var __copyProps = (to, from, except, desc) => {
|
|
11
|
+
if (from && typeof from === "object" || typeof from === "function") {
|
|
12
|
+
for (let key of __getOwnPropNames(from))
|
|
13
|
+
if (!__hasOwnProp.call(to, key) && key !== except)
|
|
14
|
+
__defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
|
|
15
|
+
}
|
|
16
|
+
return to;
|
|
17
|
+
};
|
|
18
|
+
var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
|
|
19
|
+
|
|
20
|
+
// src/exact/server/index.ts
|
|
21
|
+
var server_exports = {};
|
|
22
|
+
__export(server_exports, {
|
|
23
|
+
ExactSvmScheme: () => ExactSvmScheme,
|
|
24
|
+
registerExactSvmScheme: () => registerExactSvmScheme
|
|
25
|
+
});
|
|
26
|
+
module.exports = __toCommonJS(server_exports);
|
|
27
|
+
|
|
28
|
+
// src/utils.ts
|
|
29
|
+
var import_kit = require("@solana/kit");
|
|
30
|
+
var import_token = require("@solana-program/token");
|
|
31
|
+
var import_token_2022 = require("@solana-program/token-2022");
|
|
32
|
+
|
|
33
|
+
// src/constants.ts
|
|
34
|
+
var USDC_MAINNET_ADDRESS = "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v";
|
|
35
|
+
var USDC_DEVNET_ADDRESS = "4zMMC9srt5Ri5X14GAgXhaHii3GnPAEERYPJgZJDncDU";
|
|
36
|
+
var USDC_TESTNET_ADDRESS = "4zMMC9srt5Ri5X14GAgXhaHii3GnPAEERYPJgZJDncDU";
|
|
37
|
+
var SOLANA_MAINNET_CAIP2 = "solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp";
|
|
38
|
+
var SOLANA_DEVNET_CAIP2 = "solana:EtWTRABZaYq6iMfeYKouRu166VU2xqa1";
|
|
39
|
+
var SOLANA_TESTNET_CAIP2 = "solana:4uhcVJyU9pJkvQyS88uRDiswHXSCkY3z";
|
|
40
|
+
var V1_TO_V2_NETWORK_MAP = {
|
|
41
|
+
solana: SOLANA_MAINNET_CAIP2,
|
|
42
|
+
"solana-devnet": SOLANA_DEVNET_CAIP2,
|
|
43
|
+
"solana-testnet": SOLANA_TESTNET_CAIP2
|
|
44
|
+
};
|
|
45
|
+
|
|
46
|
+
// src/utils.ts
|
|
47
|
+
function normalizeNetwork(network) {
|
|
48
|
+
if (network.includes(":")) {
|
|
49
|
+
const supported = [SOLANA_MAINNET_CAIP2, SOLANA_DEVNET_CAIP2, SOLANA_TESTNET_CAIP2];
|
|
50
|
+
if (!supported.includes(network)) {
|
|
51
|
+
throw new Error(`Unsupported SVM network: ${network}`);
|
|
52
|
+
}
|
|
53
|
+
return network;
|
|
54
|
+
}
|
|
55
|
+
const caip2Network = V1_TO_V2_NETWORK_MAP[network];
|
|
56
|
+
if (!caip2Network) {
|
|
57
|
+
throw new Error(`Unsupported SVM network: ${network}`);
|
|
58
|
+
}
|
|
59
|
+
return caip2Network;
|
|
60
|
+
}
|
|
61
|
+
function getUsdcAddress(network) {
|
|
62
|
+
const caip2Network = normalizeNetwork(network);
|
|
63
|
+
switch (caip2Network) {
|
|
64
|
+
case SOLANA_MAINNET_CAIP2:
|
|
65
|
+
return USDC_MAINNET_ADDRESS;
|
|
66
|
+
case SOLANA_DEVNET_CAIP2:
|
|
67
|
+
return USDC_DEVNET_ADDRESS;
|
|
68
|
+
case SOLANA_TESTNET_CAIP2:
|
|
69
|
+
return USDC_TESTNET_ADDRESS;
|
|
70
|
+
default:
|
|
71
|
+
throw new Error(`No USDC address configured for network: ${network}`);
|
|
72
|
+
}
|
|
73
|
+
}
|
|
74
|
+
function convertToTokenAmount(decimalAmount, decimals) {
|
|
75
|
+
const amount = parseFloat(decimalAmount);
|
|
76
|
+
if (isNaN(amount)) {
|
|
77
|
+
throw new Error(`Invalid amount: ${decimalAmount}`);
|
|
78
|
+
}
|
|
79
|
+
const [intPart, decPart = ""] = String(amount).split(".");
|
|
80
|
+
const paddedDec = decPart.padEnd(decimals, "0").slice(0, decimals);
|
|
81
|
+
const tokenAmount = (intPart + paddedDec).replace(/^0+/, "") || "0";
|
|
82
|
+
return tokenAmount;
|
|
83
|
+
}
|
|
84
|
+
|
|
85
|
+
// src/exact/server/scheme.ts
|
|
86
|
+
var ExactSvmScheme = class {
|
|
87
|
+
constructor() {
|
|
88
|
+
this.scheme = "exact";
|
|
89
|
+
this.moneyParsers = [];
|
|
90
|
+
}
|
|
91
|
+
/**
|
|
92
|
+
* Register a custom money parser in the parser chain.
|
|
93
|
+
* Multiple parsers can be registered - they will be tried in registration order.
|
|
94
|
+
* Each parser receives a decimal amount (e.g., 1.50 for $1.50).
|
|
95
|
+
* If a parser returns null, the next parser in the chain will be tried.
|
|
96
|
+
* The default parser is always the final fallback.
|
|
97
|
+
*
|
|
98
|
+
* @param parser - Custom function to convert amount to AssetAmount (or null to skip)
|
|
99
|
+
* @returns The service instance for chaining
|
|
100
|
+
*/
|
|
101
|
+
registerMoneyParser(parser) {
|
|
102
|
+
this.moneyParsers.push(parser);
|
|
103
|
+
return this;
|
|
104
|
+
}
|
|
105
|
+
/**
|
|
106
|
+
* Parses a price into an asset amount.
|
|
107
|
+
* If price is already an AssetAmount, returns it directly.
|
|
108
|
+
* If price is Money (string | number), parses to decimal and tries custom parsers.
|
|
109
|
+
* Falls back to default conversion if all custom parsers return null.
|
|
110
|
+
*
|
|
111
|
+
* @param price - The price to parse
|
|
112
|
+
* @param network - The network to use
|
|
113
|
+
* @returns Promise that resolves to the parsed asset amount
|
|
114
|
+
*/
|
|
115
|
+
async parsePrice(price, network) {
|
|
116
|
+
if (typeof price === "object" && price !== null && "amount" in price) {
|
|
117
|
+
if (!price.asset) {
|
|
118
|
+
throw new Error(`Asset address must be specified for AssetAmount on network ${network}`);
|
|
119
|
+
}
|
|
120
|
+
return {
|
|
121
|
+
amount: price.amount,
|
|
122
|
+
asset: price.asset,
|
|
123
|
+
extra: price.extra || {}
|
|
124
|
+
};
|
|
125
|
+
}
|
|
126
|
+
const amount = this.parseMoneyToDecimal(price);
|
|
127
|
+
for (const parser of this.moneyParsers) {
|
|
128
|
+
const result = await parser(amount, network);
|
|
129
|
+
if (result !== null) {
|
|
130
|
+
return result;
|
|
131
|
+
}
|
|
132
|
+
}
|
|
133
|
+
return this.defaultMoneyConversion(amount, network);
|
|
134
|
+
}
|
|
135
|
+
/**
|
|
136
|
+
* Build payment requirements for this scheme/network combination
|
|
137
|
+
*
|
|
138
|
+
* @param paymentRequirements - The base payment requirements
|
|
139
|
+
* @param supportedKind - The supported kind configuration
|
|
140
|
+
* @param supportedKind.x402Version - The x402 protocol version
|
|
141
|
+
* @param supportedKind.scheme - The payment scheme
|
|
142
|
+
* @param supportedKind.network - The network identifier
|
|
143
|
+
* @param supportedKind.extra - Extra metadata including feePayer address
|
|
144
|
+
* @param extensionKeys - Extension keys supported by the facilitator
|
|
145
|
+
* @returns Enhanced payment requirements with feePayer in extra
|
|
146
|
+
*/
|
|
147
|
+
enhancePaymentRequirements(paymentRequirements, supportedKind, extensionKeys) {
|
|
148
|
+
void extensionKeys;
|
|
149
|
+
return Promise.resolve({
|
|
150
|
+
...paymentRequirements,
|
|
151
|
+
extra: {
|
|
152
|
+
...paymentRequirements.extra,
|
|
153
|
+
feePayer: supportedKind.extra?.feePayer
|
|
154
|
+
}
|
|
155
|
+
});
|
|
156
|
+
}
|
|
157
|
+
/**
|
|
158
|
+
* Parse Money (string | number) to a decimal number.
|
|
159
|
+
* Handles formats like "$1.50", "1.50", 1.50, etc.
|
|
160
|
+
*
|
|
161
|
+
* @param money - The money value to parse
|
|
162
|
+
* @returns Decimal number
|
|
163
|
+
*/
|
|
164
|
+
parseMoneyToDecimal(money) {
|
|
165
|
+
if (typeof money === "number") {
|
|
166
|
+
return money;
|
|
167
|
+
}
|
|
168
|
+
const cleanMoney = money.replace(/^\$/, "").trim();
|
|
169
|
+
const amount = parseFloat(cleanMoney);
|
|
170
|
+
if (isNaN(amount)) {
|
|
171
|
+
throw new Error(`Invalid money format: ${money}`);
|
|
172
|
+
}
|
|
173
|
+
return amount;
|
|
174
|
+
}
|
|
175
|
+
/**
|
|
176
|
+
* Default money conversion implementation.
|
|
177
|
+
* Converts decimal amount to USDC on the specified network.
|
|
178
|
+
*
|
|
179
|
+
* @param amount - The decimal amount (e.g., 1.50)
|
|
180
|
+
* @param network - The network to use
|
|
181
|
+
* @returns The parsed asset amount in USDC
|
|
182
|
+
*/
|
|
183
|
+
defaultMoneyConversion(amount, network) {
|
|
184
|
+
const tokenAmount = convertToTokenAmount(amount.toString(), 6);
|
|
185
|
+
return {
|
|
186
|
+
amount: tokenAmount,
|
|
187
|
+
asset: getUsdcAddress(network),
|
|
188
|
+
extra: {}
|
|
189
|
+
};
|
|
190
|
+
}
|
|
191
|
+
};
|
|
192
|
+
|
|
193
|
+
// src/exact/server/register.ts
|
|
194
|
+
function registerExactSvmScheme(server, config = {}) {
|
|
195
|
+
if (config.networks && config.networks.length > 0) {
|
|
196
|
+
config.networks.forEach((network) => {
|
|
197
|
+
server.register(network, new ExactSvmScheme());
|
|
198
|
+
});
|
|
199
|
+
} else {
|
|
200
|
+
server.register("solana:*", new ExactSvmScheme());
|
|
201
|
+
}
|
|
202
|
+
return server;
|
|
203
|
+
}
|
|
204
|
+
// Annotate the CommonJS export names for ESM import in node:
|
|
205
|
+
0 && (module.exports = {
|
|
206
|
+
ExactSvmScheme,
|
|
207
|
+
registerExactSvmScheme
|
|
208
|
+
});
|
|
209
|
+
//# sourceMappingURL=index.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"sources":["../../../../src/exact/server/index.ts","../../../../src/utils.ts","../../../../src/constants.ts","../../../../src/exact/server/scheme.ts","../../../../src/exact/server/register.ts"],"sourcesContent":["export { ExactSvmScheme } from \"./scheme\";\nexport { registerExactSvmScheme } from \"./register\";\nexport type { SvmResourceServerConfig } from \"./register\";\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","/**\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\";\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 = 6500;\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 type {\n AssetAmount,\n Network,\n PaymentRequirements,\n Price,\n SchemeNetworkServer,\n MoneyParser,\n} from \"@x402/core/types\";\nimport { convertToTokenAmount, getUsdcAddress } from \"../../utils\";\n\n/**\n * SVM server implementation for the Exact payment scheme.\n */\nexport class ExactSvmScheme implements SchemeNetworkServer {\n readonly scheme = \"exact\";\n private moneyParsers: MoneyParser[] = [];\n\n /**\n * Register a custom money parser in the parser chain.\n * Multiple parsers can be registered - they will be tried in registration order.\n * Each parser receives a decimal amount (e.g., 1.50 for $1.50).\n * If a parser returns null, the next parser in the chain will be tried.\n * The default parser is always the final fallback.\n *\n * @param parser - Custom function to convert amount to AssetAmount (or null to skip)\n * @returns The service instance for chaining\n */\n registerMoneyParser(parser: MoneyParser): ExactSvmScheme {\n this.moneyParsers.push(parser);\n return this;\n }\n\n /**\n * Parses a price into an asset amount.\n * If price is already an AssetAmount, returns it directly.\n * If price is Money (string | number), parses to decimal and tries custom parsers.\n * Falls back to default conversion if all custom parsers return null.\n *\n * @param price - The price to parse\n * @param network - The network to use\n * @returns Promise that resolves to the parsed asset amount\n */\n async parsePrice(price: Price, network: Network): Promise<AssetAmount> {\n // If already an AssetAmount, return it directly\n if (typeof price === \"object\" && price !== null && \"amount\" in price) {\n if (!price.asset) {\n throw new Error(`Asset address must be specified for AssetAmount on network ${network}`);\n }\n return {\n amount: price.amount,\n asset: price.asset,\n extra: price.extra || {},\n };\n }\n\n // Parse Money to decimal number\n const amount = this.parseMoneyToDecimal(price);\n\n // Try each custom money parser in order\n for (const parser of this.moneyParsers) {\n const result = await parser(amount, network);\n if (result !== null) {\n return result;\n }\n }\n\n // All custom parsers returned null, use default conversion\n return this.defaultMoneyConversion(amount, network);\n }\n\n /**\n * Build payment requirements for this scheme/network combination\n *\n * @param paymentRequirements - The base payment requirements\n * @param supportedKind - The supported kind configuration\n * @param supportedKind.x402Version - The x402 protocol version\n * @param supportedKind.scheme - The payment scheme\n * @param supportedKind.network - The network identifier\n * @param supportedKind.extra - Extra metadata including feePayer address\n * @param extensionKeys - Extension keys supported by the facilitator\n * @returns Enhanced payment requirements with feePayer in extra\n */\n enhancePaymentRequirements(\n paymentRequirements: PaymentRequirements,\n supportedKind: {\n x402Version: number;\n scheme: string;\n network: Network;\n extra?: Record<string, unknown>;\n },\n extensionKeys: string[],\n ): Promise<PaymentRequirements> {\n // Mark unused parameters to satisfy linter\n void extensionKeys;\n\n // Add feePayer from supportedKind.extra to payment requirements\n // The facilitator provides its address as the fee payer for transaction fees\n return Promise.resolve({\n ...paymentRequirements,\n extra: {\n ...paymentRequirements.extra,\n feePayer: supportedKind.extra?.feePayer,\n },\n });\n }\n\n /**\n * Parse Money (string | number) to a decimal number.\n * Handles formats like \"$1.50\", \"1.50\", 1.50, etc.\n *\n * @param money - The money value to parse\n * @returns Decimal number\n */\n private parseMoneyToDecimal(money: string | number): number {\n if (typeof money === \"number\") {\n return money;\n }\n\n // Remove $ sign and whitespace, then parse\n const cleanMoney = money.replace(/^\\$/, \"\").trim();\n const amount = parseFloat(cleanMoney);\n\n if (isNaN(amount)) {\n throw new Error(`Invalid money format: ${money}`);\n }\n\n return amount;\n }\n\n /**\n * Default money conversion implementation.\n * Converts decimal amount to USDC on the specified network.\n *\n * @param amount - The decimal amount (e.g., 1.50)\n * @param network - The network to use\n * @returns The parsed asset amount in USDC\n */\n private defaultMoneyConversion(amount: number, network: Network): AssetAmount {\n // Convert decimal amount to token amount (USDC has 6 decimals)\n const tokenAmount = convertToTokenAmount(amount.toString(), 6);\n\n return {\n amount: tokenAmount,\n asset: getUsdcAddress(network),\n extra: {},\n };\n }\n}\n","import { x402ResourceServer } from \"@x402/core/server\";\nimport { Network } from \"@x402/core/types\";\nimport { ExactSvmScheme } from \"./scheme\";\n\n/**\n * Configuration options for registering SVM schemes to an x402ResourceServer\n */\nexport interface SvmResourceServerConfig {\n /**\n * Optional specific networks to register\n */\n networks?: Network[];\n}\n\n/**\n * Registers SVM payment schemes to an existing x402ResourceServer instance.\n *\n * @param server - The x402ResourceServer instance to register schemes to\n * @param config - Configuration for SVM resource server registration\n * @returns The server instance for chaining\n */\nexport function registerExactSvmScheme(\n server: x402ResourceServer,\n config: SvmResourceServerConfig = {},\n): x402ResourceServer {\n if (config.networks && config.networks.length > 0) {\n config.networks.forEach(network => {\n server.register(network, new ExactSvmScheme());\n });\n } else {\n server.register(\"solana:*\", new ExactSvmScheme());\n }\n\n return server;\n}\n"],"mappings":"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","names":[]}
|
|
@@ -0,0 +1,33 @@
|
|
|
1
|
+
import { SchemeNetworkClient, PaymentRequirements, PaymentPayload, Network } from '@x402/core/types';
|
|
2
|
+
import { C as ClientSvmSigner, a as ClientSvmConfig } from '../../../signer-BMkbhFYE.js';
|
|
3
|
+
import '@solana/kit';
|
|
4
|
+
|
|
5
|
+
/**
|
|
6
|
+
* SVM client implementation for the Exact payment scheme (V1).
|
|
7
|
+
*/
|
|
8
|
+
declare class ExactSvmSchemeV1 implements SchemeNetworkClient {
|
|
9
|
+
private readonly signer;
|
|
10
|
+
private readonly config?;
|
|
11
|
+
readonly scheme = "exact";
|
|
12
|
+
/**
|
|
13
|
+
* Creates a new ExactSvmClientV1 instance.
|
|
14
|
+
*
|
|
15
|
+
* @param signer - The SVM signer for client operations
|
|
16
|
+
* @param config - Optional configuration with custom RPC URL
|
|
17
|
+
* @returns ExactSvmClientV1 instance
|
|
18
|
+
*/
|
|
19
|
+
constructor(signer: ClientSvmSigner, config?: ClientSvmConfig | undefined);
|
|
20
|
+
/**
|
|
21
|
+
* Creates a payment payload for the Exact scheme (V1).
|
|
22
|
+
*
|
|
23
|
+
* @param x402Version - The x402 protocol version
|
|
24
|
+
* @param paymentRequirements - The payment requirements
|
|
25
|
+
* @returns Promise resolving to a payment payload
|
|
26
|
+
*/
|
|
27
|
+
createPaymentPayload(x402Version: number, paymentRequirements: PaymentRequirements): Promise<Pick<PaymentPayload, "x402Version" | "payload"> & {
|
|
28
|
+
scheme: string;
|
|
29
|
+
network: Network;
|
|
30
|
+
}>;
|
|
31
|
+
}
|
|
32
|
+
|
|
33
|
+
export { ExactSvmSchemeV1 };
|