x402-svm-mantle 2.1.1-mantle

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.
Files changed (59) hide show
  1. package/README.md +200 -0
  2. package/dist/cjs/exact/client/index.d.ts +37 -0
  3. package/dist/cjs/exact/client/index.js +281 -0
  4. package/dist/cjs/exact/client/index.js.map +1 -0
  5. package/dist/cjs/exact/facilitator/index.d.ts +110 -0
  6. package/dist/cjs/exact/facilitator/index.js +714 -0
  7. package/dist/cjs/exact/facilitator/index.js.map +1 -0
  8. package/dist/cjs/exact/server/index.d.ts +87 -0
  9. package/dist/cjs/exact/server/index.js +209 -0
  10. package/dist/cjs/exact/server/index.js.map +1 -0
  11. package/dist/cjs/exact/v1/client/index.d.ts +33 -0
  12. package/dist/cjs/exact/v1/client/index.js +169 -0
  13. package/dist/cjs/exact/v1/client/index.js.map +1 -0
  14. package/dist/cjs/exact/v1/facilitator/index.d.ts +71 -0
  15. package/dist/cjs/exact/v1/facilitator/index.js +384 -0
  16. package/dist/cjs/exact/v1/facilitator/index.js.map +1 -0
  17. package/dist/cjs/index.d.ts +118 -0
  18. package/dist/cjs/index.js +433 -0
  19. package/dist/cjs/index.js.map +1 -0
  20. package/dist/cjs/scheme-CkL_b_xl.d.ts +29 -0
  21. package/dist/cjs/scheme-MoBRXFM8.d.ts +29 -0
  22. package/dist/cjs/signer-BMkbhFYE.d.ts +123 -0
  23. package/dist/cjs/v1/index.d.ts +12 -0
  24. package/dist/cjs/v1/index.js +180 -0
  25. package/dist/cjs/v1/index.js.map +1 -0
  26. package/dist/esm/chunk-M7NDDMX7.mjs +111 -0
  27. package/dist/esm/chunk-M7NDDMX7.mjs.map +1 -0
  28. package/dist/esm/chunk-PHFXLBH6.mjs +157 -0
  29. package/dist/esm/chunk-PHFXLBH6.mjs.map +1 -0
  30. package/dist/esm/chunk-TA6OPUHK.mjs +108 -0
  31. package/dist/esm/chunk-TA6OPUHK.mjs.map +1 -0
  32. package/dist/esm/chunk-WRDCPYFH.mjs +339 -0
  33. package/dist/esm/chunk-WRDCPYFH.mjs.map +1 -0
  34. package/dist/esm/chunk-WWACQNRQ.mjs +7 -0
  35. package/dist/esm/chunk-WWACQNRQ.mjs.map +1 -0
  36. package/dist/esm/exact/client/index.d.mts +37 -0
  37. package/dist/esm/exact/client/index.mjs +36 -0
  38. package/dist/esm/exact/client/index.mjs.map +1 -0
  39. package/dist/esm/exact/facilitator/index.d.mts +110 -0
  40. package/dist/esm/exact/facilitator/index.mjs +350 -0
  41. package/dist/esm/exact/facilitator/index.mjs.map +1 -0
  42. package/dist/esm/exact/server/index.d.mts +87 -0
  43. package/dist/esm/exact/server/index.mjs +129 -0
  44. package/dist/esm/exact/server/index.mjs.map +1 -0
  45. package/dist/esm/exact/v1/client/index.d.mts +33 -0
  46. package/dist/esm/exact/v1/client/index.mjs +8 -0
  47. package/dist/esm/exact/v1/client/index.mjs.map +1 -0
  48. package/dist/esm/exact/v1/facilitator/index.d.mts +71 -0
  49. package/dist/esm/exact/v1/facilitator/index.mjs +8 -0
  50. package/dist/esm/exact/v1/facilitator/index.mjs.map +1 -0
  51. package/dist/esm/index.d.mts +118 -0
  52. package/dist/esm/index.mjs +198 -0
  53. package/dist/esm/index.mjs.map +1 -0
  54. package/dist/esm/scheme-VFikrqtD.d.mts +29 -0
  55. package/dist/esm/signer-BMkbhFYE.d.mts +123 -0
  56. package/dist/esm/v1/index.d.mts +12 -0
  57. package/dist/esm/v1/index.mjs +13 -0
  58. package/dist/esm/v1/index.mjs.map +1 -0
  59. package/package.json +130 -0
@@ -0,0 +1 @@
1
+ {"version":3,"sources":["../../src/exact/v1/client/scheme.ts"],"sourcesContent":["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-mantle/types\";\nimport type { PaymentRequirementsV1 } from \"x402-core-mantle/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"],"mappings":";;;;;;;AAAA;AAAA,EACE;AAAA,EACA;AAAA,OACK;AACP,SAAS,6BAA6B;AACtC;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OACK;AACP;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OAEK;AAmBA,IAAM,mBAAN,MAAsD;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAU3D,YACmB,QACA,QACjB;AAFiB;AACA;AAXnB,SAAS,SAAS;AAAA,EAYf;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EASH,MAAM,qBACJ,aACA,qBAGA;AACA,UAAM,aAAa;AACnB,UAAM,MAAM,gBAAgB,WAAW,SAAS,KAAK,QAAQ,MAAM;AAEnE,UAAM,YAAY,MAAM,UAAU,KAAK,WAAW,KAAgB;AAClE,UAAM,sBAAsB,UAAU;AAEtC,QACE,oBAAoB,SAAS,MAAM,sBAAsB,SAAS,KAClE,oBAAoB,SAAS,MAAM,2BAA2B,SAAS,GACvE;AACA,YAAM,IAAI,MAAM,gDAAgD;AAAA,IAClE;AAEA,UAAM,CAAC,SAAS,IAAI,MAAM,uBAAuB;AAAA,MAC/C,MAAM,WAAW;AAAA,MACjB,OAAO,KAAK,OAAO;AAAA,MACnB,cAAc;AAAA,IAChB,CAAC;AAED,UAAM,CAAC,cAAc,IAAI,MAAM,uBAAuB;AAAA,MACpD,MAAM,WAAW;AAAA,MACjB,OAAO,WAAW;AAAA,MAClB,cAAc;AAAA,IAChB,CAAC;AAED,UAAM,aAAa;AAAA,MACjB;AAAA,QACE,QAAQ;AAAA,QACR,MAAM,WAAW;AAAA,QACjB,aAAa;AAAA,QACb,WAAW,KAAK;AAAA,QAChB,QAAQ,OAAO,WAAW,iBAAiB;AAAA,QAC3C,UAAU,UAAU,KAAK;AAAA,MAC3B;AAAA,MACA,EAAE,gBAAgB,oBAAoB;AAAA,IACxC;AAGA,UAAM,WAAW,WAAW,OAAO;AACnC,QAAI,CAAC,UAAU;AACb,YAAM,IAAI,MAAM,wEAAwE;AAAA,IAC1F;AAEA,UAAM,EAAE,OAAO,gBAAgB,IAAI,MAAM,IAAI,mBAAmB,EAAE,KAAK;AAEvE,UAAM,KAAK;AAAA,MACT,yBAAyB,EAAE,SAAS,EAAE,CAAC;AAAA,MACvC,CAAAA,QAAM,sCAAsC,0CAA0CA,GAAE;AAAA,MACxF,CAAAA,QAAM,8BAA8B,UAAUA,GAAE;AAAA,MAChD,CAAAA,QACE;AAAA,QACE,kCAAkC,EAAE,OAAO,2BAA2B,CAAC;AAAA,QACvEA;AAAA,MACF;AAAA,MACF,CAAAA,QAAM,qCAAqC,CAAC,UAAU,GAAGA,GAAE;AAAA,MAC3D,CAAAA,QAAM,4CAA4C,iBAAiBA,GAAE;AAAA,IACvE;AAEA,UAAM,oBAAoB,MAAM,2CAA2C,EAAE;AAC7E,UAAM,+BAA+B,gCAAgC,iBAAiB;AAEtF,UAAM,UAA6B;AAAA,MACjC,aAAa;AAAA,IACf;AAEA,WAAO;AAAA,MACL;AAAA,MACA,QAAQ,WAAW;AAAA,MACnB,SAAS,WAAW;AAAA,MACpB;AAAA,IACF;AAAA,EACF;AACF;","names":["tx"]}
@@ -0,0 +1,157 @@
1
+ // src/constants.ts
2
+ var TOKEN_PROGRAM_ADDRESS = "TokenkegQfeZyiNwAJbNbGKPFXCWuBvf9Ss623VQ5DA";
3
+ var TOKEN_2022_PROGRAM_ADDRESS = "TokenzQdBNbLqP5VEhdkAS6EPFLC1PHnBqCXEpPxuEb";
4
+ var COMPUTE_BUDGET_PROGRAM_ADDRESS = "ComputeBudget111111111111111111111111111111";
5
+ var DEVNET_RPC_URL = "https://api.devnet.solana.com";
6
+ var TESTNET_RPC_URL = "https://api.testnet.solana.com";
7
+ var MAINNET_RPC_URL = "https://api.mainnet-beta.solana.com";
8
+ var DEVNET_WS_URL = "wss://api.devnet.solana.com";
9
+ var TESTNET_WS_URL = "wss://api.testnet.solana.com";
10
+ var MAINNET_WS_URL = "wss://api.mainnet-beta.solana.com";
11
+ var USDC_MAINNET_ADDRESS = "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v";
12
+ var USDC_DEVNET_ADDRESS = "4zMMC9srt5Ri5X14GAgXhaHii3GnPAEERYPJgZJDncDU";
13
+ var USDC_TESTNET_ADDRESS = "4zMMC9srt5Ri5X14GAgXhaHii3GnPAEERYPJgZJDncDU";
14
+ var DEFAULT_COMPUTE_UNIT_PRICE_MICROLAMPORTS = 1;
15
+ var MAX_COMPUTE_UNIT_PRICE_MICROLAMPORTS = 5e6;
16
+ var DEFAULT_COMPUTE_UNIT_LIMIT = 6500;
17
+ var SVM_ADDRESS_REGEX = /^[1-9A-HJ-NP-Za-km-z]{32,44}$/;
18
+ var SOLANA_MAINNET_CAIP2 = "solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp";
19
+ var SOLANA_DEVNET_CAIP2 = "solana:EtWTRABZaYq6iMfeYKouRu166VU2xqa1";
20
+ var SOLANA_TESTNET_CAIP2 = "solana:4uhcVJyU9pJkvQyS88uRDiswHXSCkY3z";
21
+ var V1_TO_V2_NETWORK_MAP = {
22
+ solana: SOLANA_MAINNET_CAIP2,
23
+ "solana-devnet": SOLANA_DEVNET_CAIP2,
24
+ "solana-testnet": SOLANA_TESTNET_CAIP2
25
+ };
26
+
27
+ // src/utils.ts
28
+ import {
29
+ getBase64Encoder,
30
+ getTransactionDecoder,
31
+ getCompiledTransactionMessageDecoder,
32
+ createSolanaRpc,
33
+ devnet,
34
+ testnet,
35
+ mainnet
36
+ } from "@solana/kit";
37
+ import { TOKEN_PROGRAM_ADDRESS as TOKEN_PROGRAM_ADDRESS2 } from "@solana-program/token";
38
+ import { TOKEN_2022_PROGRAM_ADDRESS as TOKEN_2022_PROGRAM_ADDRESS2 } from "@solana-program/token-2022";
39
+ function normalizeNetwork(network) {
40
+ if (network.includes(":")) {
41
+ const supported = [SOLANA_MAINNET_CAIP2, SOLANA_DEVNET_CAIP2, SOLANA_TESTNET_CAIP2];
42
+ if (!supported.includes(network)) {
43
+ throw new Error(`Unsupported SVM network: ${network}`);
44
+ }
45
+ return network;
46
+ }
47
+ const caip2Network = V1_TO_V2_NETWORK_MAP[network];
48
+ if (!caip2Network) {
49
+ throw new Error(`Unsupported SVM network: ${network}`);
50
+ }
51
+ return caip2Network;
52
+ }
53
+ function validateSvmAddress(address) {
54
+ return SVM_ADDRESS_REGEX.test(address);
55
+ }
56
+ function decodeTransactionFromPayload(svmPayload) {
57
+ try {
58
+ const base64Encoder = getBase64Encoder();
59
+ const transactionBytes = base64Encoder.encode(svmPayload.transaction);
60
+ const transactionDecoder = getTransactionDecoder();
61
+ return transactionDecoder.decode(transactionBytes);
62
+ } catch (error) {
63
+ console.error("Error decoding transaction:", error);
64
+ throw new Error("invalid_exact_svm_payload_transaction");
65
+ }
66
+ }
67
+ function getTokenPayerFromTransaction(transaction) {
68
+ const compiled = getCompiledTransactionMessageDecoder().decode(transaction.messageBytes);
69
+ const staticAccounts = compiled.staticAccounts ?? [];
70
+ const instructions = compiled.instructions ?? [];
71
+ for (const ix of instructions) {
72
+ const programIndex = ix.programAddressIndex;
73
+ const programAddress = staticAccounts[programIndex].toString();
74
+ if (programAddress === TOKEN_PROGRAM_ADDRESS2.toString() || programAddress === TOKEN_2022_PROGRAM_ADDRESS2.toString()) {
75
+ const accountIndices = ix.accountIndices ?? [];
76
+ if (accountIndices.length >= 4) {
77
+ const ownerIndex = accountIndices[3];
78
+ const ownerAddress = staticAccounts[ownerIndex].toString();
79
+ if (ownerAddress) return ownerAddress;
80
+ }
81
+ }
82
+ }
83
+ return "";
84
+ }
85
+ function createRpcClient(network, customRpcUrl) {
86
+ const caip2Network = normalizeNetwork(network);
87
+ switch (caip2Network) {
88
+ case SOLANA_DEVNET_CAIP2: {
89
+ const url = customRpcUrl || DEVNET_RPC_URL;
90
+ return createSolanaRpc(devnet(url));
91
+ }
92
+ case SOLANA_TESTNET_CAIP2: {
93
+ const url = customRpcUrl || TESTNET_RPC_URL;
94
+ return createSolanaRpc(testnet(url));
95
+ }
96
+ case SOLANA_MAINNET_CAIP2: {
97
+ const url = customRpcUrl || MAINNET_RPC_URL;
98
+ return createSolanaRpc(mainnet(url));
99
+ }
100
+ default:
101
+ throw new Error(`Unsupported network: ${network}`);
102
+ }
103
+ }
104
+ function getUsdcAddress(network) {
105
+ const caip2Network = normalizeNetwork(network);
106
+ switch (caip2Network) {
107
+ case SOLANA_MAINNET_CAIP2:
108
+ return USDC_MAINNET_ADDRESS;
109
+ case SOLANA_DEVNET_CAIP2:
110
+ return USDC_DEVNET_ADDRESS;
111
+ case SOLANA_TESTNET_CAIP2:
112
+ return USDC_TESTNET_ADDRESS;
113
+ default:
114
+ throw new Error(`No USDC address configured for network: ${network}`);
115
+ }
116
+ }
117
+ function convertToTokenAmount(decimalAmount, decimals) {
118
+ const amount = parseFloat(decimalAmount);
119
+ if (isNaN(amount)) {
120
+ throw new Error(`Invalid amount: ${decimalAmount}`);
121
+ }
122
+ const [intPart, decPart = ""] = String(amount).split(".");
123
+ const paddedDec = decPart.padEnd(decimals, "0").slice(0, decimals);
124
+ const tokenAmount = (intPart + paddedDec).replace(/^0+/, "") || "0";
125
+ return tokenAmount;
126
+ }
127
+
128
+ export {
129
+ TOKEN_PROGRAM_ADDRESS,
130
+ TOKEN_2022_PROGRAM_ADDRESS,
131
+ COMPUTE_BUDGET_PROGRAM_ADDRESS,
132
+ DEVNET_RPC_URL,
133
+ TESTNET_RPC_URL,
134
+ MAINNET_RPC_URL,
135
+ DEVNET_WS_URL,
136
+ TESTNET_WS_URL,
137
+ MAINNET_WS_URL,
138
+ USDC_MAINNET_ADDRESS,
139
+ USDC_DEVNET_ADDRESS,
140
+ USDC_TESTNET_ADDRESS,
141
+ DEFAULT_COMPUTE_UNIT_PRICE_MICROLAMPORTS,
142
+ MAX_COMPUTE_UNIT_PRICE_MICROLAMPORTS,
143
+ DEFAULT_COMPUTE_UNIT_LIMIT,
144
+ SVM_ADDRESS_REGEX,
145
+ SOLANA_MAINNET_CAIP2,
146
+ SOLANA_DEVNET_CAIP2,
147
+ SOLANA_TESTNET_CAIP2,
148
+ V1_TO_V2_NETWORK_MAP,
149
+ normalizeNetwork,
150
+ validateSvmAddress,
151
+ decodeTransactionFromPayload,
152
+ getTokenPayerFromTransaction,
153
+ createRpcClient,
154
+ getUsdcAddress,
155
+ convertToTokenAmount
156
+ };
157
+ //# sourceMappingURL=chunk-PHFXLBH6.mjs.map
@@ -0,0 +1 @@
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\";\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-mantle/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":"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","names":["TOKEN_PROGRAM_ADDRESS","TOKEN_2022_PROGRAM_ADDRESS","TOKEN_PROGRAM_ADDRESS","TOKEN_2022_PROGRAM_ADDRESS"]}
@@ -0,0 +1,108 @@
1
+ import {
2
+ DEFAULT_COMPUTE_UNIT_LIMIT,
3
+ DEFAULT_COMPUTE_UNIT_PRICE_MICROLAMPORTS,
4
+ createRpcClient
5
+ } from "./chunk-PHFXLBH6.mjs";
6
+
7
+ // src/exact/client/scheme.ts
8
+ import {
9
+ getSetComputeUnitLimitInstruction,
10
+ setTransactionMessageComputeUnitPrice
11
+ } from "@solana-program/compute-budget";
12
+ import { TOKEN_PROGRAM_ADDRESS } from "@solana-program/token";
13
+ import {
14
+ fetchMint,
15
+ findAssociatedTokenPda,
16
+ getTransferCheckedInstruction,
17
+ TOKEN_2022_PROGRAM_ADDRESS
18
+ } from "@solana-program/token-2022";
19
+ import {
20
+ appendTransactionMessageInstructions,
21
+ createTransactionMessage,
22
+ getBase64EncodedWireTransaction,
23
+ partiallySignTransactionMessageWithSigners,
24
+ pipe,
25
+ prependTransactionMessageInstruction,
26
+ setTransactionMessageFeePayer,
27
+ setTransactionMessageLifetimeUsingBlockhash
28
+ } from "@solana/kit";
29
+ var ExactSvmScheme = class {
30
+ /**
31
+ * Creates a new ExactSvmClient instance.
32
+ *
33
+ * @param signer - The SVM signer for client operations
34
+ * @param config - Optional configuration with custom RPC URL
35
+ * @returns ExactSvmClient instance
36
+ */
37
+ constructor(signer, config) {
38
+ this.signer = signer;
39
+ this.config = config;
40
+ this.scheme = "exact";
41
+ }
42
+ /**
43
+ * Creates a payment payload for the Exact scheme.
44
+ *
45
+ * @param x402Version - The x402 protocol version
46
+ * @param paymentRequirements - The payment requirements
47
+ * @returns Promise resolving to a payment payload
48
+ */
49
+ async createPaymentPayload(x402Version, paymentRequirements) {
50
+ const rpc = createRpcClient(paymentRequirements.network, this.config?.rpcUrl);
51
+ const tokenMint = await fetchMint(rpc, paymentRequirements.asset);
52
+ const tokenProgramAddress = tokenMint.programAddress;
53
+ if (tokenProgramAddress.toString() !== TOKEN_PROGRAM_ADDRESS.toString() && tokenProgramAddress.toString() !== TOKEN_2022_PROGRAM_ADDRESS.toString()) {
54
+ throw new Error("Asset was not created by a known token program");
55
+ }
56
+ const [sourceATA] = await findAssociatedTokenPda({
57
+ mint: paymentRequirements.asset,
58
+ owner: this.signer.address,
59
+ tokenProgram: tokenProgramAddress
60
+ });
61
+ const [destinationATA] = await findAssociatedTokenPda({
62
+ mint: paymentRequirements.asset,
63
+ owner: paymentRequirements.payTo,
64
+ tokenProgram: tokenProgramAddress
65
+ });
66
+ const transferIx = getTransferCheckedInstruction(
67
+ {
68
+ source: sourceATA,
69
+ mint: paymentRequirements.asset,
70
+ destination: destinationATA,
71
+ authority: this.signer,
72
+ amount: BigInt(paymentRequirements.amount),
73
+ decimals: tokenMint.data.decimals
74
+ },
75
+ { programAddress: tokenProgramAddress }
76
+ );
77
+ const feePayer = paymentRequirements.extra?.feePayer;
78
+ if (!feePayer) {
79
+ throw new Error("feePayer is required in paymentRequirements.extra for SVM transactions");
80
+ }
81
+ const { value: latestBlockhash } = await rpc.getLatestBlockhash().send();
82
+ const tx = pipe(
83
+ createTransactionMessage({ version: 0 }),
84
+ (tx2) => setTransactionMessageComputeUnitPrice(DEFAULT_COMPUTE_UNIT_PRICE_MICROLAMPORTS, tx2),
85
+ (tx2) => setTransactionMessageFeePayer(feePayer, tx2),
86
+ (tx2) => prependTransactionMessageInstruction(
87
+ getSetComputeUnitLimitInstruction({ units: DEFAULT_COMPUTE_UNIT_LIMIT }),
88
+ tx2
89
+ ),
90
+ (tx2) => appendTransactionMessageInstructions([transferIx], tx2),
91
+ (tx2) => setTransactionMessageLifetimeUsingBlockhash(latestBlockhash, tx2)
92
+ );
93
+ const signedTransaction = await partiallySignTransactionMessageWithSigners(tx);
94
+ const base64EncodedWireTransaction = getBase64EncodedWireTransaction(signedTransaction);
95
+ const payload = {
96
+ transaction: base64EncodedWireTransaction
97
+ };
98
+ return {
99
+ x402Version,
100
+ payload
101
+ };
102
+ }
103
+ };
104
+
105
+ export {
106
+ ExactSvmScheme
107
+ };
108
+ //# sourceMappingURL=chunk-TA6OPUHK.mjs.map
@@ -0,0 +1 @@
1
+ {"version":3,"sources":["../../src/exact/client/scheme.ts"],"sourcesContent":["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 { PaymentPayload, PaymentRequirements, SchemeNetworkClient } from \"x402-core-mantle/types\";\nimport {\n DEFAULT_COMPUTE_UNIT_LIMIT,\n DEFAULT_COMPUTE_UNIT_PRICE_MICROLAMPORTS,\n} from \"../../constants\";\nimport type { ClientSvmConfig, ClientSvmSigner } from \"../../signer\";\nimport type { ExactSvmPayloadV2 } from \"../../types\";\nimport { createRpcClient } from \"../../utils\";\n\n/**\n * SVM client implementation for the Exact payment scheme.\n */\nexport class ExactSvmScheme implements SchemeNetworkClient {\n readonly scheme = \"exact\";\n\n /**\n * Creates a new ExactSvmClient instance.\n *\n * @param signer - The SVM signer for client operations\n * @param config - Optional configuration with custom RPC URL\n * @returns ExactSvmClient 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.\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<Pick<PaymentPayload, \"x402Version\" | \"payload\">> {\n const rpc = createRpcClient(paymentRequirements.network, this.config?.rpcUrl);\n\n const tokenMint = await fetchMint(rpc, paymentRequirements.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: paymentRequirements.asset as Address,\n owner: this.signer.address,\n tokenProgram: tokenProgramAddress,\n });\n\n const [destinationATA] = await findAssociatedTokenPda({\n mint: paymentRequirements.asset as Address,\n owner: paymentRequirements.payTo as Address,\n tokenProgram: tokenProgramAddress,\n });\n\n const transferIx = getTransferCheckedInstruction(\n {\n source: sourceATA,\n mint: paymentRequirements.asset as Address,\n destination: destinationATA,\n authority: this.signer,\n amount: BigInt(paymentRequirements.amount),\n decimals: tokenMint.data.decimals,\n },\n { programAddress: tokenProgramAddress },\n );\n\n // Facilitator must provide feePayer to cover transaction fees\n const feePayer = paymentRequirements.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: ExactSvmPayloadV2 = {\n transaction: base64EncodedWireTransaction,\n };\n\n return {\n x402Version,\n payload,\n };\n }\n}\n"],"mappings":";;;;;;;AAAA;AAAA,EACE;AAAA,EACA;AAAA,OACK;AACP,SAAS,6BAA6B;AACtC;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OACK;AACP;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OAEK;AAaA,IAAM,iBAAN,MAAoD;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAUzD,YACmB,QACA,QACjB;AAFiB;AACA;AAXnB,SAAS,SAAS;AAAA,EAYf;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EASH,MAAM,qBACJ,aACA,qBAC0D;AAC1D,UAAM,MAAM,gBAAgB,oBAAoB,SAAS,KAAK,QAAQ,MAAM;AAE5E,UAAM,YAAY,MAAM,UAAU,KAAK,oBAAoB,KAAgB;AAC3E,UAAM,sBAAsB,UAAU;AAEtC,QACE,oBAAoB,SAAS,MAAM,sBAAsB,SAAS,KAClE,oBAAoB,SAAS,MAAM,2BAA2B,SAAS,GACvE;AACA,YAAM,IAAI,MAAM,gDAAgD;AAAA,IAClE;AAEA,UAAM,CAAC,SAAS,IAAI,MAAM,uBAAuB;AAAA,MAC/C,MAAM,oBAAoB;AAAA,MAC1B,OAAO,KAAK,OAAO;AAAA,MACnB,cAAc;AAAA,IAChB,CAAC;AAED,UAAM,CAAC,cAAc,IAAI,MAAM,uBAAuB;AAAA,MACpD,MAAM,oBAAoB;AAAA,MAC1B,OAAO,oBAAoB;AAAA,MAC3B,cAAc;AAAA,IAChB,CAAC;AAED,UAAM,aAAa;AAAA,MACjB;AAAA,QACE,QAAQ;AAAA,QACR,MAAM,oBAAoB;AAAA,QAC1B,aAAa;AAAA,QACb,WAAW,KAAK;AAAA,QAChB,QAAQ,OAAO,oBAAoB,MAAM;AAAA,QACzC,UAAU,UAAU,KAAK;AAAA,MAC3B;AAAA,MACA,EAAE,gBAAgB,oBAAoB;AAAA,IACxC;AAGA,UAAM,WAAW,oBAAoB,OAAO;AAC5C,QAAI,CAAC,UAAU;AACb,YAAM,IAAI,MAAM,wEAAwE;AAAA,IAC1F;AAEA,UAAM,EAAE,OAAO,gBAAgB,IAAI,MAAM,IAAI,mBAAmB,EAAE,KAAK;AAEvE,UAAM,KAAK;AAAA,MACT,yBAAyB,EAAE,SAAS,EAAE,CAAC;AAAA,MACvC,CAAAA,QAAM,sCAAsC,0CAA0CA,GAAE;AAAA,MACxF,CAAAA,QAAM,8BAA8B,UAAUA,GAAE;AAAA,MAChD,CAAAA,QACE;AAAA,QACE,kCAAkC,EAAE,OAAO,2BAA2B,CAAC;AAAA,QACvEA;AAAA,MACF;AAAA,MACF,CAAAA,QAAM,qCAAqC,CAAC,UAAU,GAAGA,GAAE;AAAA,MAC3D,CAAAA,QAAM,4CAA4C,iBAAiBA,GAAE;AAAA,IACvE;AAEA,UAAM,oBAAoB,MAAM,2CAA2C,EAAE;AAC7E,UAAM,+BAA+B,gCAAgC,iBAAiB;AAEtF,UAAM,UAA6B;AAAA,MACjC,aAAa;AAAA,IACf;AAEA,WAAO;AAAA,MACL;AAAA,MACA;AAAA,IACF;AAAA,EACF;AACF;","names":["tx"]}
@@ -0,0 +1,339 @@
1
+ import {
2
+ MAX_COMPUTE_UNIT_PRICE_MICROLAMPORTS,
3
+ decodeTransactionFromPayload,
4
+ getTokenPayerFromTransaction
5
+ } from "./chunk-PHFXLBH6.mjs";
6
+
7
+ // src/exact/v1/facilitator/scheme.ts
8
+ import {
9
+ COMPUTE_BUDGET_PROGRAM_ADDRESS,
10
+ parseSetComputeUnitLimitInstruction,
11
+ parseSetComputeUnitPriceInstruction
12
+ } from "@solana-program/compute-budget";
13
+ import {
14
+ parseTransferCheckedInstruction as parseTransferCheckedInstructionToken,
15
+ TOKEN_PROGRAM_ADDRESS
16
+ } from "@solana-program/token";
17
+ import {
18
+ findAssociatedTokenPda,
19
+ parseTransferCheckedInstruction as parseTransferCheckedInstruction2022,
20
+ TOKEN_2022_PROGRAM_ADDRESS
21
+ } from "@solana-program/token-2022";
22
+ import {
23
+ decompileTransactionMessage,
24
+ getCompiledTransactionMessageDecoder
25
+ } from "@solana/kit";
26
+ var ExactSvmSchemeV1 = class {
27
+ /**
28
+ * Creates a new ExactSvmFacilitatorV1 instance.
29
+ *
30
+ * @param signer - The SVM RPC client for facilitator operations
31
+ * @returns ExactSvmFacilitatorV1 instance
32
+ */
33
+ constructor(signer) {
34
+ this.signer = signer;
35
+ this.scheme = "exact";
36
+ this.caipFamily = "solana:*";
37
+ }
38
+ /**
39
+ * Get mechanism-specific extra data for the supported kinds endpoint.
40
+ * For SVM, this includes a randomly selected fee payer address.
41
+ * Random selection distributes load across multiple signers.
42
+ *
43
+ * @param _ - The network identifier (unused for SVM)
44
+ * @returns Extra data with feePayer address
45
+ */
46
+ getExtra(_) {
47
+ const addresses = this.signer.getAddresses();
48
+ const randomIndex = Math.floor(Math.random() * addresses.length);
49
+ return {
50
+ feePayer: addresses[randomIndex]
51
+ };
52
+ }
53
+ /**
54
+ * Get signer addresses used by this facilitator.
55
+ * For SVM, returns all available fee payer addresses.
56
+ *
57
+ * @param _ - The network identifier (unused for SVM)
58
+ * @returns Array of fee payer addresses
59
+ */
60
+ getSigners(_) {
61
+ return [...this.signer.getAddresses()];
62
+ }
63
+ /**
64
+ * Verifies a payment payload (V1).
65
+ *
66
+ * @param payload - The payment payload to verify
67
+ * @param requirements - The payment requirements
68
+ * @returns Promise resolving to verification response
69
+ */
70
+ async verify(payload, requirements) {
71
+ const requirementsV1 = requirements;
72
+ const payloadV1 = payload;
73
+ const exactSvmPayload = payload.payload;
74
+ if (payloadV1.scheme !== "exact" || requirements.scheme !== "exact") {
75
+ return {
76
+ isValid: false,
77
+ invalidReason: "unsupported_scheme",
78
+ payer: ""
79
+ };
80
+ }
81
+ if (payloadV1.network !== requirements.network) {
82
+ return {
83
+ isValid: false,
84
+ invalidReason: "network_mismatch",
85
+ payer: ""
86
+ };
87
+ }
88
+ if (!requirementsV1.extra?.feePayer || typeof requirementsV1.extra.feePayer !== "string") {
89
+ return {
90
+ isValid: false,
91
+ invalidReason: "invalid_exact_svm_payload_missing_fee_payer",
92
+ payer: ""
93
+ };
94
+ }
95
+ const signerAddresses = this.signer.getAddresses().map((addr) => addr.toString());
96
+ if (!signerAddresses.includes(requirementsV1.extra.feePayer)) {
97
+ return {
98
+ isValid: false,
99
+ invalidReason: "fee_payer_not_managed_by_facilitator",
100
+ payer: ""
101
+ };
102
+ }
103
+ let transaction;
104
+ try {
105
+ transaction = decodeTransactionFromPayload(exactSvmPayload);
106
+ } catch {
107
+ return {
108
+ isValid: false,
109
+ invalidReason: "invalid_exact_svm_payload_transaction_could_not_be_decoded",
110
+ payer: ""
111
+ };
112
+ }
113
+ const compiled = getCompiledTransactionMessageDecoder().decode(transaction.messageBytes);
114
+ const decompiled = decompileTransactionMessage(compiled);
115
+ const instructions = decompiled.instructions ?? [];
116
+ if (instructions.length !== 3) {
117
+ return {
118
+ isValid: false,
119
+ invalidReason: "invalid_exact_svm_payload_transaction_instructions_length",
120
+ payer: ""
121
+ };
122
+ }
123
+ try {
124
+ this.verifyComputeLimitInstruction(instructions[0]);
125
+ this.verifyComputePriceInstruction(instructions[1]);
126
+ } catch (error) {
127
+ const errorMessage = error instanceof Error ? error.message : String(error);
128
+ return {
129
+ isValid: false,
130
+ invalidReason: errorMessage,
131
+ payer: ""
132
+ };
133
+ }
134
+ const payer = getTokenPayerFromTransaction(transaction);
135
+ if (!payer) {
136
+ return {
137
+ isValid: false,
138
+ invalidReason: "invalid_exact_svm_payload_no_transfer_instruction",
139
+ payer: ""
140
+ };
141
+ }
142
+ const transferIx = instructions[2];
143
+ const programAddress = transferIx.programAddress.toString();
144
+ if (programAddress !== TOKEN_PROGRAM_ADDRESS.toString() && programAddress !== TOKEN_2022_PROGRAM_ADDRESS.toString()) {
145
+ return {
146
+ isValid: false,
147
+ invalidReason: "invalid_exact_svm_payload_no_transfer_instruction",
148
+ payer
149
+ };
150
+ }
151
+ let parsedTransfer;
152
+ try {
153
+ if (programAddress === TOKEN_PROGRAM_ADDRESS.toString()) {
154
+ parsedTransfer = parseTransferCheckedInstructionToken(transferIx);
155
+ } else {
156
+ parsedTransfer = parseTransferCheckedInstruction2022(transferIx);
157
+ }
158
+ } catch {
159
+ return {
160
+ isValid: false,
161
+ invalidReason: "invalid_exact_svm_payload_no_transfer_instruction",
162
+ payer
163
+ };
164
+ }
165
+ const authorityAddress = parsedTransfer.accounts.authority.address.toString();
166
+ if (signerAddresses.includes(authorityAddress)) {
167
+ return {
168
+ isValid: false,
169
+ invalidReason: "invalid_exact_svm_payload_transaction_fee_payer_transferring_funds",
170
+ payer
171
+ };
172
+ }
173
+ const mintAddress = parsedTransfer.accounts.mint.address.toString();
174
+ if (mintAddress !== requirements.asset) {
175
+ return {
176
+ isValid: false,
177
+ invalidReason: "invalid_exact_svm_payload_mint_mismatch",
178
+ payer
179
+ };
180
+ }
181
+ const destATA = parsedTransfer.accounts.destination.address.toString();
182
+ try {
183
+ const [expectedDestATA] = await findAssociatedTokenPda({
184
+ mint: requirements.asset,
185
+ owner: requirements.payTo,
186
+ tokenProgram: programAddress === TOKEN_PROGRAM_ADDRESS.toString() ? TOKEN_PROGRAM_ADDRESS : TOKEN_2022_PROGRAM_ADDRESS
187
+ });
188
+ if (destATA !== expectedDestATA.toString()) {
189
+ return {
190
+ isValid: false,
191
+ invalidReason: "invalid_exact_svm_payload_recipient_mismatch",
192
+ payer
193
+ };
194
+ }
195
+ } catch {
196
+ return {
197
+ isValid: false,
198
+ invalidReason: "invalid_exact_svm_payload_recipient_mismatch",
199
+ payer
200
+ };
201
+ }
202
+ const amount = parsedTransfer.data.amount;
203
+ if (amount < BigInt(requirementsV1.maxAmountRequired)) {
204
+ return {
205
+ isValid: false,
206
+ invalidReason: "invalid_exact_svm_payload_amount_insufficient",
207
+ payer
208
+ };
209
+ }
210
+ try {
211
+ const feePayer = requirementsV1.extra.feePayer;
212
+ const fullySignedTransaction = await this.signer.signTransaction(
213
+ exactSvmPayload.transaction,
214
+ feePayer,
215
+ requirements.network
216
+ );
217
+ await this.signer.simulateTransaction(fullySignedTransaction, requirements.network);
218
+ } catch (error) {
219
+ const errorMessage = error instanceof Error ? error.message : String(error);
220
+ return {
221
+ isValid: false,
222
+ invalidReason: `transaction_simulation_failed: ${errorMessage}`,
223
+ payer
224
+ };
225
+ }
226
+ return {
227
+ isValid: true,
228
+ invalidReason: void 0,
229
+ payer
230
+ };
231
+ }
232
+ /**
233
+ * Settles a payment by submitting the transaction (V1).
234
+ * Ensures the correct signer is used based on the feePayer specified in requirements.
235
+ *
236
+ * @param payload - The payment payload to settle
237
+ * @param requirements - The payment requirements
238
+ * @returns Promise resolving to settlement response
239
+ */
240
+ async settle(payload, requirements) {
241
+ const payloadV1 = payload;
242
+ const exactSvmPayload = payload.payload;
243
+ const valid = await this.verify(payload, requirements);
244
+ if (!valid.isValid) {
245
+ return {
246
+ success: false,
247
+ network: payloadV1.network,
248
+ transaction: "",
249
+ errorReason: valid.invalidReason ?? "verification_failed",
250
+ payer: valid.payer || ""
251
+ };
252
+ }
253
+ try {
254
+ const feePayer = requirements.extra.feePayer;
255
+ const fullySignedTransaction = await this.signer.signTransaction(
256
+ exactSvmPayload.transaction,
257
+ feePayer,
258
+ requirements.network
259
+ );
260
+ const signature = await this.signer.sendTransaction(
261
+ fullySignedTransaction,
262
+ requirements.network
263
+ );
264
+ await this.signer.confirmTransaction(signature, requirements.network);
265
+ return {
266
+ success: true,
267
+ transaction: signature,
268
+ network: payloadV1.network,
269
+ payer: valid.payer
270
+ };
271
+ } catch (error) {
272
+ console.error("Failed to settle transaction:", error);
273
+ return {
274
+ success: false,
275
+ errorReason: "transaction_failed",
276
+ transaction: "",
277
+ network: payloadV1.network,
278
+ payer: valid.payer || ""
279
+ };
280
+ }
281
+ }
282
+ /**
283
+ * Verify compute limit instruction
284
+ *
285
+ * @param instruction - The compute limit instruction
286
+ * @param instruction.programAddress - Program address
287
+ * @param instruction.data - Instruction data bytes
288
+ */
289
+ verifyComputeLimitInstruction(instruction) {
290
+ const programAddress = instruction.programAddress.toString();
291
+ if (programAddress !== COMPUTE_BUDGET_PROGRAM_ADDRESS.toString() || !instruction.data || instruction.data[0] !== 2) {
292
+ throw new Error(
293
+ "invalid_exact_svm_payload_transaction_instructions_compute_limit_instruction"
294
+ );
295
+ }
296
+ try {
297
+ parseSetComputeUnitLimitInstruction(instruction);
298
+ } catch {
299
+ throw new Error(
300
+ "invalid_exact_svm_payload_transaction_instructions_compute_limit_instruction"
301
+ );
302
+ }
303
+ }
304
+ /**
305
+ * Verify compute price instruction
306
+ *
307
+ * @param instruction - The compute price instruction
308
+ * @param instruction.programAddress - Program address
309
+ * @param instruction.data - Instruction data bytes
310
+ */
311
+ verifyComputePriceInstruction(instruction) {
312
+ const programAddress = instruction.programAddress.toString();
313
+ if (programAddress !== COMPUTE_BUDGET_PROGRAM_ADDRESS.toString() || !instruction.data || instruction.data[0] !== 3) {
314
+ throw new Error(
315
+ "invalid_exact_svm_payload_transaction_instructions_compute_price_instruction"
316
+ );
317
+ }
318
+ try {
319
+ const parsedInstruction = parseSetComputeUnitPriceInstruction(instruction);
320
+ if (parsedInstruction.microLamports > BigInt(MAX_COMPUTE_UNIT_PRICE_MICROLAMPORTS)) {
321
+ throw new Error(
322
+ "invalid_exact_svm_payload_transaction_instructions_compute_price_instruction_too_high"
323
+ );
324
+ }
325
+ } catch (error) {
326
+ if (error instanceof Error && error.message.includes("too_high")) {
327
+ throw error;
328
+ }
329
+ throw new Error(
330
+ "invalid_exact_svm_payload_transaction_instructions_compute_price_instruction"
331
+ );
332
+ }
333
+ }
334
+ };
335
+
336
+ export {
337
+ ExactSvmSchemeV1
338
+ };
339
+ //# sourceMappingURL=chunk-WRDCPYFH.mjs.map