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.
Files changed (127) hide show
  1. package/README.md +155 -0
  2. package/lib/cjs/client/index.d.ts +243 -0
  3. package/lib/cjs/client/index.js +413 -0
  4. package/lib/cjs/client/index.js.map +1 -0
  5. package/lib/cjs/exact/client/index.d.ts +37 -0
  6. package/lib/cjs/exact/client/index.js +281 -0
  7. package/lib/cjs/exact/client/index.js.map +1 -0
  8. package/lib/cjs/exact/facilitator/index.d.ts +110 -0
  9. package/lib/cjs/exact/facilitator/index.js +714 -0
  10. package/lib/cjs/exact/facilitator/index.js.map +1 -0
  11. package/lib/cjs/exact/server/index.d.ts +87 -0
  12. package/lib/cjs/exact/server/index.js +209 -0
  13. package/lib/cjs/exact/server/index.js.map +1 -0
  14. package/lib/cjs/exact/v1/client/index.d.ts +33 -0
  15. package/lib/cjs/exact/v1/client/index.js +169 -0
  16. package/lib/cjs/exact/v1/client/index.js.map +1 -0
  17. package/lib/cjs/exact/v1/facilitator/index.d.ts +71 -0
  18. package/lib/cjs/exact/v1/facilitator/index.js +384 -0
  19. package/lib/cjs/exact/v1/facilitator/index.js.map +1 -0
  20. package/lib/cjs/facilitator/index.d.ts +192 -0
  21. package/lib/cjs/facilitator/index.js +398 -0
  22. package/lib/cjs/facilitator/index.js.map +1 -0
  23. package/lib/cjs/http/index.d.ts +52 -0
  24. package/lib/cjs/http/index.js +827 -0
  25. package/lib/cjs/http/index.js.map +1 -0
  26. package/lib/cjs/index.d.ts +145 -0
  27. package/lib/cjs/index.js +314 -0
  28. package/lib/cjs/index.js.map +1 -0
  29. package/lib/cjs/mechanisms-CzuGzYsS.d.ts +270 -0
  30. package/lib/cjs/scheme-MoBRXFM8.d.ts +29 -0
  31. package/lib/cjs/server/index.d.ts +2 -0
  32. package/lib/cjs/server/index.js +1305 -0
  33. package/lib/cjs/server/index.js.map +1 -0
  34. package/lib/cjs/signer-5OVDxViv.d.ts +79 -0
  35. package/lib/cjs/signer-BMkbhFYE.d.ts +123 -0
  36. package/lib/cjs/types/index.d.ts +1 -0
  37. package/lib/cjs/types/index.js +66 -0
  38. package/lib/cjs/types/index.js.map +1 -0
  39. package/lib/cjs/types/v1/index.d.ts +1 -0
  40. package/lib/cjs/types/v1/index.js +19 -0
  41. package/lib/cjs/types/v1/index.js.map +1 -0
  42. package/lib/cjs/utils/index.d.ts +48 -0
  43. package/lib/cjs/utils/index.js +116 -0
  44. package/lib/cjs/utils/index.js.map +1 -0
  45. package/lib/cjs/v1/index.d.ts +12 -0
  46. package/lib/cjs/v1/index.js +180 -0
  47. package/lib/cjs/v1/index.js.map +1 -0
  48. package/lib/cjs/x402HTTPResourceServer-D1YtlH_r.d.ts +719 -0
  49. package/lib/esm/chunk-3CEIVWNN.mjs +339 -0
  50. package/lib/esm/chunk-3CEIVWNN.mjs.map +1 -0
  51. package/lib/esm/chunk-BJTO5JO5.mjs +11 -0
  52. package/lib/esm/chunk-BJTO5JO5.mjs.map +1 -0
  53. package/lib/esm/chunk-EEA7DKZI.mjs +111 -0
  54. package/lib/esm/chunk-EEA7DKZI.mjs.map +1 -0
  55. package/lib/esm/chunk-FOUXRQAV.mjs +88 -0
  56. package/lib/esm/chunk-FOUXRQAV.mjs.map +1 -0
  57. package/lib/esm/chunk-IKSTWKEM.mjs +157 -0
  58. package/lib/esm/chunk-IKSTWKEM.mjs.map +1 -0
  59. package/lib/esm/chunk-JYZWCLMP.mjs +305 -0
  60. package/lib/esm/chunk-JYZWCLMP.mjs.map +1 -0
  61. package/lib/esm/chunk-PNSAJQCF.mjs +108 -0
  62. package/lib/esm/chunk-PNSAJQCF.mjs.map +1 -0
  63. package/lib/esm/chunk-PSA4YVU2.mjs +92 -0
  64. package/lib/esm/chunk-PSA4YVU2.mjs.map +1 -0
  65. package/lib/esm/chunk-QLXM7BIB.mjs +23 -0
  66. package/lib/esm/chunk-QLXM7BIB.mjs.map +1 -0
  67. package/lib/esm/chunk-TDLQZ6MP.mjs +86 -0
  68. package/lib/esm/chunk-TDLQZ6MP.mjs.map +1 -0
  69. package/lib/esm/chunk-VE37GDG2.mjs +7 -0
  70. package/lib/esm/chunk-VE37GDG2.mjs.map +1 -0
  71. package/lib/esm/chunk-WWACQNRQ.mjs +7 -0
  72. package/lib/esm/chunk-WWACQNRQ.mjs.map +1 -0
  73. package/lib/esm/chunk-X4W4S5RB.mjs +39 -0
  74. package/lib/esm/chunk-X4W4S5RB.mjs.map +1 -0
  75. package/lib/esm/chunk-Z4QX3O5V.mjs +748 -0
  76. package/lib/esm/chunk-Z4QX3O5V.mjs.map +1 -0
  77. package/lib/esm/chunk-ZYXTTU74.mjs +88 -0
  78. package/lib/esm/chunk-ZYXTTU74.mjs.map +1 -0
  79. package/lib/esm/client/index.d.mts +243 -0
  80. package/lib/esm/client/index.mjs +260 -0
  81. package/lib/esm/client/index.mjs.map +1 -0
  82. package/lib/esm/exact/client/index.d.mts +37 -0
  83. package/lib/esm/exact/client/index.mjs +36 -0
  84. package/lib/esm/exact/client/index.mjs.map +1 -0
  85. package/lib/esm/exact/facilitator/index.d.mts +110 -0
  86. package/lib/esm/exact/facilitator/index.mjs +350 -0
  87. package/lib/esm/exact/facilitator/index.mjs.map +1 -0
  88. package/lib/esm/exact/server/index.d.mts +87 -0
  89. package/lib/esm/exact/server/index.mjs +129 -0
  90. package/lib/esm/exact/server/index.mjs.map +1 -0
  91. package/lib/esm/exact/v1/client/index.d.mts +33 -0
  92. package/lib/esm/exact/v1/client/index.mjs +8 -0
  93. package/lib/esm/exact/v1/client/index.mjs.map +1 -0
  94. package/lib/esm/exact/v1/facilitator/index.d.mts +71 -0
  95. package/lib/esm/exact/v1/facilitator/index.mjs +8 -0
  96. package/lib/esm/exact/v1/facilitator/index.mjs.map +1 -0
  97. package/lib/esm/facilitator/index.d.mts +192 -0
  98. package/lib/esm/facilitator/index.mjs +373 -0
  99. package/lib/esm/facilitator/index.mjs.map +1 -0
  100. package/lib/esm/http/index.d.mts +52 -0
  101. package/lib/esm/http/index.mjs +29 -0
  102. package/lib/esm/http/index.mjs.map +1 -0
  103. package/lib/esm/index.d.mts +145 -0
  104. package/lib/esm/index.mjs +277 -0
  105. package/lib/esm/index.mjs.map +1 -0
  106. package/lib/esm/mechanisms-CzuGzYsS.d.mts +270 -0
  107. package/lib/esm/scheme-fjF-9LhT.d.mts +29 -0
  108. package/lib/esm/server/index.d.mts +2 -0
  109. package/lib/esm/server/index.mjs +563 -0
  110. package/lib/esm/server/index.mjs.map +1 -0
  111. package/lib/esm/signer-5OVDxViv.d.mts +79 -0
  112. package/lib/esm/signer-BMkbhFYE.d.mts +123 -0
  113. package/lib/esm/types/index.d.mts +1 -0
  114. package/lib/esm/types/index.mjs +10 -0
  115. package/lib/esm/types/index.mjs.map +1 -0
  116. package/lib/esm/types/v1/index.d.mts +1 -0
  117. package/lib/esm/types/v1/index.mjs +1 -0
  118. package/lib/esm/types/v1/index.mjs.map +1 -0
  119. package/lib/esm/utils/index.d.mts +48 -0
  120. package/lib/esm/utils/index.mjs +20 -0
  121. package/lib/esm/utils/index.mjs.map +1 -0
  122. package/lib/esm/v1/index.d.mts +12 -0
  123. package/lib/esm/v1/index.mjs +13 -0
  124. package/lib/esm/v1/index.mjs.map +1 -0
  125. package/lib/esm/x402HTTPResourceServer-BIfIK5HS.d.mts +719 -0
  126. package/package.json +39 -0
  127. package/src/index.js +4 -0
@@ -0,0 +1,339 @@
1
+ import {
2
+ MAX_COMPUTE_UNIT_PRICE_MICROLAMPORTS,
3
+ decodeTransactionFromPayload,
4
+ getTokenPayerFromTransaction
5
+ } from "./chunk-IKSTWKEM.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-3CEIVWNN.mjs.map
@@ -0,0 +1 @@
1
+ {"version":3,"sources":["../../src/exact/v1/facilitator/scheme.ts"],"sourcesContent":["import {\n COMPUTE_BUDGET_PROGRAM_ADDRESS,\n parseSetComputeUnitLimitInstruction,\n parseSetComputeUnitPriceInstruction,\n} from \"@solana-program/compute-budget\";\nimport {\n parseTransferCheckedInstruction as parseTransferCheckedInstructionToken,\n TOKEN_PROGRAM_ADDRESS,\n} from \"@solana-program/token\";\nimport {\n findAssociatedTokenPda,\n parseTransferCheckedInstruction as parseTransferCheckedInstruction2022,\n TOKEN_2022_PROGRAM_ADDRESS,\n} from \"@solana-program/token-2022\";\nimport {\n decompileTransactionMessage,\n getCompiledTransactionMessageDecoder,\n type Address,\n} from \"@solana/kit\";\nimport type {\n PaymentPayload,\n PaymentRequirements,\n SchemeNetworkFacilitator,\n SettleResponse,\n VerifyResponse,\n} from \"@x402/core/types\";\nimport type { PaymentPayloadV1, PaymentRequirementsV1 } from \"@x402/core/types/v1\";\nimport { 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"],"mappings":";;;;;;;AAAA;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,OACK;AACP;AAAA,EACE,mCAAmC;AAAA,EACnC;AAAA,OACK;AACP;AAAA,EACE;AAAA,EACA,mCAAmC;AAAA,EACnC;AAAA,OACK;AACP;AAAA,EACE;AAAA,EACA;AAAA,OAEK;AAiBA,IAAM,mBAAN,MAA2D;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAUhE,YAA6B,QAA8B;AAA9B;AAT7B,SAAS,SAAS;AAClB,SAAS,aAAa;AAAA,EAQsC;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAU5D,SAAS,GAAgD;AAEvD,UAAM,YAAY,KAAK,OAAO,aAAa;AAC3C,UAAM,cAAc,KAAK,MAAM,KAAK,OAAO,IAAI,UAAU,MAAM;AAE/D,WAAO;AAAA,MACL,UAAU,UAAU,WAAW;AAAA,IACjC;AAAA,EACF;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EASA,WAAW,GAAqB;AAC9B,WAAO,CAAC,GAAG,KAAK,OAAO,aAAa,CAAC;AAAA,EACvC;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EASA,MAAM,OACJ,SACA,cACyB;AACzB,UAAM,iBAAiB;AACvB,UAAM,YAAY;AAClB,UAAM,kBAAkB,QAAQ;AAGhC,QAAI,UAAU,WAAW,WAAW,aAAa,WAAW,SAAS;AACnE,aAAO;AAAA,QACL,SAAS;AAAA,QACT,eAAe;AAAA,QACf,OAAO;AAAA,MACT;AAAA,IACF;AAEA,QAAI,UAAU,YAAY,aAAa,SAAS;AAC9C,aAAO;AAAA,QACL,SAAS;AAAA,QACT,eAAe;AAAA,QACf,OAAO;AAAA,MACT;AAAA,IACF;AAEA,QAAI,CAAC,eAAe,OAAO,YAAY,OAAO,eAAe,MAAM,aAAa,UAAU;AACxF,aAAO;AAAA,QACL,SAAS;AAAA,QACT,eAAe;AAAA,QACf,OAAO;AAAA,MACT;AAAA,IACF;AAGA,UAAM,kBAAkB,KAAK,OAAO,aAAa,EAAE,IAAI,UAAQ,KAAK,SAAS,CAAC;AAC9E,QAAI,CAAC,gBAAgB,SAAS,eAAe,MAAM,QAAQ,GAAG;AAC5D,aAAO;AAAA,QACL,SAAS;AAAA,QACT,eAAe;AAAA,QACf,OAAO;AAAA,MACT;AAAA,IACF;AAGA,QAAI;AACJ,QAAI;AACF,oBAAc,6BAA6B,eAAe;AAAA,IAC5D,QAAQ;AACN,aAAO;AAAA,QACL,SAAS;AAAA,QACT,eAAe;AAAA,QACf,OAAO;AAAA,MACT;AAAA,IACF;AAEA,UAAM,WAAW,qCAAqC,EAAE,OAAO,YAAY,YAAY;AACvF,UAAM,aAAa,4BAA4B,QAAQ;AACvD,UAAM,eAAe,WAAW,gBAAgB,CAAC;AAGjD,QAAI,aAAa,WAAW,GAAG;AAC7B,aAAO;AAAA,QACL,SAAS;AAAA,QACT,eAAe;AAAA,QACf,OAAO;AAAA,MACT;AAAA,IACF;AAGA,QAAI;AACF,WAAK,8BAA8B,aAAa,CAAC,CAAU;AAC3D,WAAK,8BAA8B,aAAa,CAAC,CAAU;AAAA,IAC7D,SAAS,OAAO;AACd,YAAM,eAAe,iBAAiB,QAAQ,MAAM,UAAU,OAAO,KAAK;AAC1E,aAAO;AAAA,QACL,SAAS;AAAA,QACT,eAAe;AAAA,QACf,OAAO;AAAA,MACT;AAAA,IACF;AAEA,UAAM,QAAQ,6BAA6B,WAAW;AACtD,QAAI,CAAC,OAAO;AACV,aAAO;AAAA,QACL,SAAS;AAAA,QACT,eAAe;AAAA,QACf,OAAO;AAAA,MACT;AAAA,IACF;AAGA,UAAM,aAAa,aAAa,CAAC;AACjC,UAAM,iBAAiB,WAAW,eAAe,SAAS;AAE1D,QACE,mBAAmB,sBAAsB,SAAS,KAClD,mBAAmB,2BAA2B,SAAS,GACvD;AACA,aAAO;AAAA,QACL,SAAS;AAAA,QACT,eAAe;AAAA,QACf;AAAA,MACF;AAAA,IACF;AAGA,QAAI;AACJ,QAAI;AACF,UAAI,mBAAmB,sBAAsB,SAAS,GAAG;AACvD,yBAAiB,qCAAqC,UAAmB;AAAA,MAC3E,OAAO;AACL,yBAAiB,oCAAoC,UAAmB;AAAA,MAC1E;AAAA,IACF,QAAQ;AACN,aAAO;AAAA,QACL,SAAS;AAAA,QACT,eAAe;AAAA,QACf;AAAA,MACF;AAAA,IACF;AAIA,UAAM,mBAAmB,eAAe,SAAS,UAAU,QAAQ,SAAS;AAC5E,QAAI,gBAAgB,SAAS,gBAAgB,GAAG;AAC9C,aAAO;AAAA,QACL,SAAS;AAAA,QACT,eAAe;AAAA,QACf;AAAA,MACF;AAAA,IACF;AAGA,UAAM,cAAc,eAAe,SAAS,KAAK,QAAQ,SAAS;AAClE,QAAI,gBAAgB,aAAa,OAAO;AACtC,aAAO;AAAA,QACL,SAAS;AAAA,QACT,eAAe;AAAA,QACf;AAAA,MACF;AAAA,IACF;AAGA,UAAM,UAAU,eAAe,SAAS,YAAY,QAAQ,SAAS;AACrE,QAAI;AACF,YAAM,CAAC,eAAe,IAAI,MAAM,uBAAuB;AAAA,QACrD,MAAM,aAAa;AAAA,QACnB,OAAO,aAAa;AAAA,QACpB,cACE,mBAAmB,sBAAsB,SAAS,IAC7C,wBACA;AAAA,MACT,CAAC;AAED,UAAI,YAAY,gBAAgB,SAAS,GAAG;AAC1C,eAAO;AAAA,UACL,SAAS;AAAA,UACT,eAAe;AAAA,UACf;AAAA,QACF;AAAA,MACF;AAAA,IACF,QAAQ;AACN,aAAO;AAAA,QACL,SAAS;AAAA,QACT,eAAe;AAAA,QACf;AAAA,MACF;AAAA,IACF;AAGA,UAAM,SAAS,eAAe,KAAK;AACnC,QAAI,SAAS,OAAO,eAAe,iBAAiB,GAAG;AACrD,aAAO;AAAA,QACL,SAAS;AAAA,QACT,eAAe;AAAA,QACf;AAAA,MACF;AAAA,IACF;AAIA,QAAI;AACF,YAAM,WAAW,eAAe,MAAM;AAGtC,YAAM,yBAAyB,MAAM,KAAK,OAAO;AAAA,QAC/C,gBAAgB;AAAA,QAChB;AAAA,QACA,aAAa;AAAA,MACf;AAGA,YAAM,KAAK,OAAO,oBAAoB,wBAAwB,aAAa,OAAO;AAAA,IACpF,SAAS,OAAO;AACd,YAAM,eAAe,iBAAiB,QAAQ,MAAM,UAAU,OAAO,KAAK;AAC1E,aAAO;AAAA,QACL,SAAS;AAAA,QACT,eAAe,kCAAkC,YAAY;AAAA,QAC7D;AAAA,MACF;AAAA,IACF;AAEA,WAAO;AAAA,MACL,SAAS;AAAA,MACT,eAAe;AAAA,MACf;AAAA,IACF;AAAA,EACF;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAUA,MAAM,OACJ,SACA,cACyB;AACzB,UAAM,YAAY;AAClB,UAAM,kBAAkB,QAAQ;AAEhC,UAAM,QAAQ,MAAM,KAAK,OAAO,SAAS,YAAY;AACrD,QAAI,CAAC,MAAM,SAAS;AAClB,aAAO;AAAA,QACL,SAAS;AAAA,QACT,SAAS,UAAU;AAAA,QACnB,aAAa;AAAA,QACb,aAAa,MAAM,iBAAiB;AAAA,QACpC,OAAO,MAAM,SAAS;AAAA,MACxB;AAAA,IACF;AAEA,QAAI;AAEF,YAAM,WAAW,aAAa,MAAM;AAGpC,YAAM,yBAAyB,MAAM,KAAK,OAAO;AAAA,QAC/C,gBAAgB;AAAA,QAChB;AAAA,QACA,aAAa;AAAA,MACf;AAGA,YAAM,YAAY,MAAM,KAAK,OAAO;AAAA,QAClC;AAAA,QACA,aAAa;AAAA,MACf;AAGA,YAAM,KAAK,OAAO,mBAAmB,WAAW,aAAa,OAAO;AAEpE,aAAO;AAAA,QACL,SAAS;AAAA,QACT,aAAa;AAAA,QACb,SAAS,UAAU;AAAA,QACnB,OAAO,MAAM;AAAA,MACf;AAAA,IACF,SAAS,OAAO;AACd,cAAQ,MAAM,iCAAiC,KAAK;AACpD,aAAO;AAAA,QACL,SAAS;AAAA,QACT,aAAa;AAAA,QACb,aAAa;AAAA,QACb,SAAS,UAAU;AAAA,QACnB,OAAO,MAAM,SAAS;AAAA,MACxB;AAAA,IACF;AAAA,EACF;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EASQ,8BAA8B,aAG7B;AACP,UAAM,iBAAiB,YAAY,eAAe,SAAS;AAE3D,QACE,mBAAmB,+BAA+B,SAAS,KAC3D,CAAC,YAAY,QACb,YAAY,KAAK,CAAC,MAAM,GACxB;AACA,YAAM,IAAI;AAAA,QACR;AAAA,MACF;AAAA,IACF;AAEA,QAAI;AACF,0CAAoC,WAAoB;AAAA,IAC1D,QAAQ;AACN,YAAM,IAAI;AAAA,QACR;AAAA,MACF;AAAA,IACF;AAAA,EACF;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EASQ,8BAA8B,aAG7B;AACP,UAAM,iBAAiB,YAAY,eAAe,SAAS;AAE3D,QACE,mBAAmB,+BAA+B,SAAS,KAC3D,CAAC,YAAY,QACb,YAAY,KAAK,CAAC,MAAM,GACxB;AACA,YAAM,IAAI;AAAA,QACR;AAAA,MACF;AAAA,IACF;AAEA,QAAI;AACF,YAAM,oBAAoB,oCAAoC,WAAoB;AAGlF,UACG,kBAA2D,gBAC5D,OAAO,oCAAoC,GAC3C;AACA,cAAM,IAAI;AAAA,UACR;AAAA,QACF;AAAA,MACF;AAAA,IACF,SAAS,OAAO;AACd,UAAI,iBAAiB,SAAS,MAAM,QAAQ,SAAS,UAAU,GAAG;AAChE,cAAM;AAAA,MACR;AACA,YAAM,IAAI;AAAA,QACR;AAAA,MACF;AAAA,IACF;AAAA,EACF;AACF;","names":[]}
@@ -0,0 +1,11 @@
1
+ var __require = /* @__PURE__ */ ((x) => typeof require !== "undefined" ? require : typeof Proxy !== "undefined" ? new Proxy(x, {
2
+ get: (a, b) => (typeof require !== "undefined" ? require : a)[b]
3
+ }) : x)(function(x) {
4
+ if (typeof require !== "undefined") return require.apply(this, arguments);
5
+ throw Error('Dynamic require of "' + x + '" is not supported');
6
+ });
7
+
8
+ export {
9
+ __require
10
+ };
11
+ //# sourceMappingURL=chunk-BJTO5JO5.mjs.map
@@ -0,0 +1 @@
1
+ {"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}
@@ -0,0 +1,111 @@
1
+ import {
2
+ DEFAULT_COMPUTE_UNIT_LIMIT,
3
+ DEFAULT_COMPUTE_UNIT_PRICE_MICROLAMPORTS,
4
+ createRpcClient
5
+ } from "./chunk-IKSTWKEM.mjs";
6
+
7
+ // src/exact/v1/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 ExactSvmSchemeV1 = class {
30
+ /**
31
+ * Creates a new ExactSvmClientV1 instance.
32
+ *
33
+ * @param signer - The SVM signer for client operations
34
+ * @param config - Optional configuration with custom RPC URL
35
+ * @returns ExactSvmClientV1 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 (V1).
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 selectedV1 = paymentRequirements;
51
+ const rpc = createRpcClient(selectedV1.network, this.config?.rpcUrl);
52
+ const tokenMint = await fetchMint(rpc, selectedV1.asset);
53
+ const tokenProgramAddress = tokenMint.programAddress;
54
+ if (tokenProgramAddress.toString() !== TOKEN_PROGRAM_ADDRESS.toString() && tokenProgramAddress.toString() !== TOKEN_2022_PROGRAM_ADDRESS.toString()) {
55
+ throw new Error("Asset was not created by a known token program");
56
+ }
57
+ const [sourceATA] = await findAssociatedTokenPda({
58
+ mint: selectedV1.asset,
59
+ owner: this.signer.address,
60
+ tokenProgram: tokenProgramAddress
61
+ });
62
+ const [destinationATA] = await findAssociatedTokenPda({
63
+ mint: selectedV1.asset,
64
+ owner: selectedV1.payTo,
65
+ tokenProgram: tokenProgramAddress
66
+ });
67
+ const transferIx = getTransferCheckedInstruction(
68
+ {
69
+ source: sourceATA,
70
+ mint: selectedV1.asset,
71
+ destination: destinationATA,
72
+ authority: this.signer,
73
+ amount: BigInt(selectedV1.maxAmountRequired),
74
+ decimals: tokenMint.data.decimals
75
+ },
76
+ { programAddress: tokenProgramAddress }
77
+ );
78
+ const feePayer = selectedV1.extra?.feePayer;
79
+ if (!feePayer) {
80
+ throw new Error("feePayer is required in paymentRequirements.extra for SVM transactions");
81
+ }
82
+ const { value: latestBlockhash } = await rpc.getLatestBlockhash().send();
83
+ const tx = pipe(
84
+ createTransactionMessage({ version: 0 }),
85
+ (tx2) => setTransactionMessageComputeUnitPrice(DEFAULT_COMPUTE_UNIT_PRICE_MICROLAMPORTS, tx2),
86
+ (tx2) => setTransactionMessageFeePayer(feePayer, tx2),
87
+ (tx2) => prependTransactionMessageInstruction(
88
+ getSetComputeUnitLimitInstruction({ units: DEFAULT_COMPUTE_UNIT_LIMIT }),
89
+ tx2
90
+ ),
91
+ (tx2) => appendTransactionMessageInstructions([transferIx], tx2),
92
+ (tx2) => setTransactionMessageLifetimeUsingBlockhash(latestBlockhash, tx2)
93
+ );
94
+ const signedTransaction = await partiallySignTransactionMessageWithSigners(tx);
95
+ const base64EncodedWireTransaction = getBase64EncodedWireTransaction(signedTransaction);
96
+ const payload = {
97
+ transaction: base64EncodedWireTransaction
98
+ };
99
+ return {
100
+ x402Version,
101
+ scheme: selectedV1.scheme,
102
+ network: selectedV1.network,
103
+ payload
104
+ };
105
+ }
106
+ };
107
+
108
+ export {
109
+ ExactSvmSchemeV1
110
+ };
111
+ //# sourceMappingURL=chunk-EEA7DKZI.mjs.map
@@ -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/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"],"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,88 @@
1
+ import {
2
+ authorizationTypes,
3
+ createNonce
4
+ } from "./chunk-ZYXTTU74.mjs";
5
+
6
+ // src/exact/client/scheme.ts
7
+ import { getAddress } from "viem";
8
+ var ExactEvmScheme = class {
9
+ /**
10
+ * Creates a new ExactEvmClient instance.
11
+ *
12
+ * @param signer - The EVM signer for client operations
13
+ */
14
+ constructor(signer) {
15
+ this.signer = signer;
16
+ this.scheme = "exact";
17
+ }
18
+ /**
19
+ * Creates a payment payload for the Exact scheme.
20
+ *
21
+ * @param x402Version - The x402 protocol version
22
+ * @param paymentRequirements - The payment requirements
23
+ * @returns Promise resolving to a payment payload
24
+ */
25
+ async createPaymentPayload(x402Version, paymentRequirements) {
26
+ const nonce = createNonce();
27
+ const now = Math.floor(Date.now() / 1e3);
28
+ const authorization = {
29
+ from: this.signer.address,
30
+ to: getAddress(paymentRequirements.payTo),
31
+ value: paymentRequirements.amount,
32
+ validAfter: (now - 600).toString(),
33
+ // 10 minutes before
34
+ validBefore: (now + paymentRequirements.maxTimeoutSeconds).toString(),
35
+ nonce
36
+ };
37
+ const signature = await this.signAuthorization(authorization, paymentRequirements);
38
+ const payload = {
39
+ authorization,
40
+ signature
41
+ };
42
+ return {
43
+ x402Version,
44
+ payload
45
+ };
46
+ }
47
+ /**
48
+ * Sign the EIP-3009 authorization using EIP-712
49
+ *
50
+ * @param authorization - The authorization to sign
51
+ * @param requirements - The payment requirements
52
+ * @returns Promise resolving to the signature
53
+ */
54
+ async signAuthorization(authorization, requirements) {
55
+ const chainId = parseInt(requirements.network.split(":")[1]);
56
+ if (!requirements.extra?.name || !requirements.extra?.version) {
57
+ throw new Error(
58
+ `EIP-712 domain parameters (name, version) are required in payment requirements for asset ${requirements.asset}`
59
+ );
60
+ }
61
+ const { name, version } = requirements.extra;
62
+ const domain = {
63
+ name,
64
+ version,
65
+ chainId,
66
+ verifyingContract: getAddress(requirements.asset)
67
+ };
68
+ const message = {
69
+ from: getAddress(authorization.from),
70
+ to: getAddress(authorization.to),
71
+ value: BigInt(authorization.value),
72
+ validAfter: BigInt(authorization.validAfter),
73
+ validBefore: BigInt(authorization.validBefore),
74
+ nonce: authorization.nonce
75
+ };
76
+ return await this.signer.signTypedData({
77
+ domain,
78
+ types: authorizationTypes,
79
+ primaryType: "TransferWithAuthorization",
80
+ message
81
+ });
82
+ }
83
+ };
84
+
85
+ export {
86
+ ExactEvmScheme
87
+ };
88
+ //# sourceMappingURL=chunk-FOUXRQAV.mjs.map
@@ -0,0 +1 @@
1
+ {"version":3,"sources":["../../src/exact/client/scheme.ts"],"sourcesContent":["import { PaymentPayload, PaymentRequirements, SchemeNetworkClient } from \"@x402/core/types\";\nimport { getAddress } from \"viem\";\nimport { authorizationTypes } from \"../../constants\";\nimport { ClientEvmSigner } from \"../../signer\";\nimport { ExactEvmPayloadV2 } from \"../../types\";\nimport { createNonce } from \"../../utils\";\n\n/**\n * EVM client implementation for the Exact payment scheme.\n *\n */\nexport class ExactEvmScheme implements SchemeNetworkClient {\n readonly scheme = \"exact\";\n\n /**\n * Creates a new ExactEvmClient instance.\n *\n * @param signer - The EVM signer for client operations\n */\n constructor(private readonly signer: ClientEvmSigner) {}\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 nonce = createNonce();\n const now = Math.floor(Date.now() / 1000);\n\n const authorization: ExactEvmPayloadV2[\"authorization\"] = {\n from: this.signer.address,\n to: getAddress(paymentRequirements.payTo),\n value: paymentRequirements.amount,\n validAfter: (now - 600).toString(), // 10 minutes before\n validBefore: (now + paymentRequirements.maxTimeoutSeconds).toString(),\n nonce,\n };\n\n // Sign the authorization\n const signature = await this.signAuthorization(authorization, paymentRequirements);\n\n const payload: ExactEvmPayloadV2 = {\n authorization,\n signature,\n };\n\n return {\n x402Version,\n payload,\n };\n }\n\n /**\n * Sign the EIP-3009 authorization using EIP-712\n *\n * @param authorization - The authorization to sign\n * @param requirements - The payment requirements\n * @returns Promise resolving to the signature\n */\n private async signAuthorization(\n authorization: ExactEvmPayloadV2[\"authorization\"],\n requirements: PaymentRequirements,\n ): Promise<`0x${string}`> {\n const chainId = parseInt(requirements.network.split(\":\")[1]);\n\n if (!requirements.extra?.name || !requirements.extra?.version) {\n throw new Error(\n `EIP-712 domain parameters (name, version) are required in payment requirements for asset ${requirements.asset}`,\n );\n }\n\n const { name, version } = requirements.extra;\n\n const domain = {\n name,\n version,\n chainId,\n verifyingContract: getAddress(requirements.asset),\n };\n\n const message = {\n from: getAddress(authorization.from),\n to: getAddress(authorization.to),\n value: BigInt(authorization.value),\n validAfter: BigInt(authorization.validAfter),\n validBefore: BigInt(authorization.validBefore),\n nonce: authorization.nonce,\n };\n\n return await this.signer.signTypedData({\n domain,\n types: authorizationTypes,\n primaryType: \"TransferWithAuthorization\",\n message,\n });\n }\n}\n"],"mappings":";;;;;;AACA,SAAS,kBAAkB;AAUpB,IAAM,iBAAN,MAAoD;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAQzD,YAA6B,QAAyB;AAAzB;AAP7B,SAAS,SAAS;AAAA,EAOqC;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EASvD,MAAM,qBACJ,aACA,qBAC0D;AAC1D,UAAM,QAAQ,YAAY;AAC1B,UAAM,MAAM,KAAK,MAAM,KAAK,IAAI,IAAI,GAAI;AAExC,UAAM,gBAAoD;AAAA,MACxD,MAAM,KAAK,OAAO;AAAA,MAClB,IAAI,WAAW,oBAAoB,KAAK;AAAA,MACxC,OAAO,oBAAoB;AAAA,MAC3B,aAAa,MAAM,KAAK,SAAS;AAAA;AAAA,MACjC,cAAc,MAAM,oBAAoB,mBAAmB,SAAS;AAAA,MACpE;AAAA,IACF;AAGA,UAAM,YAAY,MAAM,KAAK,kBAAkB,eAAe,mBAAmB;AAEjF,UAAM,UAA6B;AAAA,MACjC;AAAA,MACA;AAAA,IACF;AAEA,WAAO;AAAA,MACL;AAAA,MACA;AAAA,IACF;AAAA,EACF;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EASA,MAAc,kBACZ,eACA,cACwB;AACxB,UAAM,UAAU,SAAS,aAAa,QAAQ,MAAM,GAAG,EAAE,CAAC,CAAC;AAE3D,QAAI,CAAC,aAAa,OAAO,QAAQ,CAAC,aAAa,OAAO,SAAS;AAC7D,YAAM,IAAI;AAAA,QACR,4FAA4F,aAAa,KAAK;AAAA,MAChH;AAAA,IACF;AAEA,UAAM,EAAE,MAAM,QAAQ,IAAI,aAAa;AAEvC,UAAM,SAAS;AAAA,MACb;AAAA,MACA;AAAA,MACA;AAAA,MACA,mBAAmB,WAAW,aAAa,KAAK;AAAA,IAClD;AAEA,UAAM,UAAU;AAAA,MACd,MAAM,WAAW,cAAc,IAAI;AAAA,MACnC,IAAI,WAAW,cAAc,EAAE;AAAA,MAC/B,OAAO,OAAO,cAAc,KAAK;AAAA,MACjC,YAAY,OAAO,cAAc,UAAU;AAAA,MAC3C,aAAa,OAAO,cAAc,WAAW;AAAA,MAC7C,OAAO,cAAc;AAAA,IACvB;AAEA,WAAO,MAAM,KAAK,OAAO,cAAc;AAAA,MACrC;AAAA,MACA,OAAO;AAAA,MACP,aAAa;AAAA,MACb;AAAA,IACF,CAAC;AAAA,EACH;AACF;","names":[]}