@t402/svm 2.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 (58) 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 +720 -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 +207 -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 +388 -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 +429 -0
  19. package/dist/cjs/index.js.map +1 -0
  20. package/dist/cjs/scheme-ByJE6QYY.d.ts +29 -0
  21. package/dist/cjs/signer-BMkbhFYE.d.ts +123 -0
  22. package/dist/cjs/v1/index.d.ts +12 -0
  23. package/dist/cjs/v1/index.js +180 -0
  24. package/dist/cjs/v1/index.js.map +1 -0
  25. package/dist/esm/chunk-4BFJL7IW.mjs +341 -0
  26. package/dist/esm/chunk-4BFJL7IW.mjs.map +1 -0
  27. package/dist/esm/chunk-7S5RSPMY.mjs +108 -0
  28. package/dist/esm/chunk-7S5RSPMY.mjs.map +1 -0
  29. package/dist/esm/chunk-FPXYRDTG.mjs +111 -0
  30. package/dist/esm/chunk-FPXYRDTG.mjs.map +1 -0
  31. package/dist/esm/chunk-JFN5MEH3.mjs +157 -0
  32. package/dist/esm/chunk-JFN5MEH3.mjs.map +1 -0
  33. package/dist/esm/chunk-WWACQNRQ.mjs +7 -0
  34. package/dist/esm/chunk-WWACQNRQ.mjs.map +1 -0
  35. package/dist/esm/exact/client/index.d.mts +37 -0
  36. package/dist/esm/exact/client/index.mjs +36 -0
  37. package/dist/esm/exact/client/index.mjs.map +1 -0
  38. package/dist/esm/exact/facilitator/index.d.mts +110 -0
  39. package/dist/esm/exact/facilitator/index.mjs +352 -0
  40. package/dist/esm/exact/facilitator/index.mjs.map +1 -0
  41. package/dist/esm/exact/server/index.d.mts +87 -0
  42. package/dist/esm/exact/server/index.mjs +129 -0
  43. package/dist/esm/exact/server/index.mjs.map +1 -0
  44. package/dist/esm/exact/v1/client/index.d.mts +33 -0
  45. package/dist/esm/exact/v1/client/index.mjs +8 -0
  46. package/dist/esm/exact/v1/client/index.mjs.map +1 -0
  47. package/dist/esm/exact/v1/facilitator/index.d.mts +71 -0
  48. package/dist/esm/exact/v1/facilitator/index.mjs +8 -0
  49. package/dist/esm/exact/v1/facilitator/index.mjs.map +1 -0
  50. package/dist/esm/index.d.mts +118 -0
  51. package/dist/esm/index.mjs +194 -0
  52. package/dist/esm/index.mjs.map +1 -0
  53. package/dist/esm/scheme-DRerE5zq.d.mts +29 -0
  54. package/dist/esm/signer-BMkbhFYE.d.mts +123 -0
  55. package/dist/esm/v1/index.d.mts +12 -0
  56. package/dist/esm/v1/index.mjs +13 -0
  57. package/dist/esm/v1/index.mjs.map +1 -0
  58. package/package.json +132 -0
@@ -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(
69
+ transaction.messageBytes
70
+ );
71
+ const staticAccounts = compiled.staticAccounts ?? [];
72
+ const instructions = compiled.instructions ?? [];
73
+ for (const ix of instructions) {
74
+ const programIndex = ix.programAddressIndex;
75
+ const programAddress = staticAccounts[programIndex].toString();
76
+ if (programAddress === TOKEN_PROGRAM_ADDRESS2.toString() || programAddress === TOKEN_2022_PROGRAM_ADDRESS2.toString()) {
77
+ const accountIndices = ix.accountIndices ?? [];
78
+ if (accountIndices.length >= 4) {
79
+ const ownerIndex = accountIndices[3];
80
+ const ownerAddress = staticAccounts[ownerIndex].toString();
81
+ if (ownerAddress) return ownerAddress;
82
+ }
83
+ }
84
+ }
85
+ return "";
86
+ }
87
+ function createRpcClient(network, customRpcUrl) {
88
+ const caip2Network = normalizeNetwork(network);
89
+ switch (caip2Network) {
90
+ case SOLANA_DEVNET_CAIP2: {
91
+ const url = customRpcUrl || DEVNET_RPC_URL;
92
+ return createSolanaRpc(devnet(url));
93
+ }
94
+ case SOLANA_TESTNET_CAIP2: {
95
+ const url = customRpcUrl || TESTNET_RPC_URL;
96
+ return createSolanaRpc(testnet(url));
97
+ }
98
+ case SOLANA_MAINNET_CAIP2: {
99
+ const url = customRpcUrl || MAINNET_RPC_URL;
100
+ return createSolanaRpc(mainnet(url));
101
+ }
102
+ default:
103
+ throw new Error(`Unsupported network: ${network}`);
104
+ }
105
+ }
106
+ function getUsdcAddress(network) {
107
+ const caip2Network = normalizeNetwork(network);
108
+ switch (caip2Network) {
109
+ case SOLANA_MAINNET_CAIP2:
110
+ return USDC_MAINNET_ADDRESS;
111
+ case SOLANA_DEVNET_CAIP2:
112
+ return USDC_DEVNET_ADDRESS;
113
+ case SOLANA_TESTNET_CAIP2:
114
+ return USDC_TESTNET_ADDRESS;
115
+ default:
116
+ throw new Error(`No USDC address configured for network: ${network}`);
117
+ }
118
+ }
119
+ function convertToTokenAmount(decimalAmount, decimals) {
120
+ const amount = parseFloat(decimalAmount);
121
+ if (isNaN(amount)) {
122
+ throw new Error(`Invalid amount: ${decimalAmount}`);
123
+ }
124
+ const tokenAmount = Math.floor(amount * Math.pow(10, decimals));
125
+ return tokenAmount.toString();
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-JFN5MEH3.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 type CompiledTransactionMessage,\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 \"@t402/core/types\";\nimport {\n SVM_ADDRESS_REGEX,\n DEVNET_RPC_URL,\n TESTNET_RPC_URL,\n MAINNET_RPC_URL,\n USDC_MAINNET_ADDRESS,\n USDC_DEVNET_ADDRESS,\n USDC_TESTNET_ADDRESS,\n SOLANA_MAINNET_CAIP2,\n SOLANA_DEVNET_CAIP2,\n SOLANA_TESTNET_CAIP2,\n V1_TO_V2_NETWORK_MAP,\n} from \"./constants\";\nimport type { ExactSvmPayloadV1 } from \"./types\";\n\n/**\n * Normalize network identifier to CAIP-2 format\n * Handles both V1 names (solana, solana-devnet) and V2 CAIP-2 format\n *\n * @param network - Network identifier (V1 or V2 format)\n * @returns CAIP-2 network identifier\n */\nexport function normalizeNetwork(network: Network): string {\n // If it's already CAIP-2 format (contains \":\"), validate it's supported\n if (network.includes(\":\")) {\n const supported = [SOLANA_MAINNET_CAIP2, SOLANA_DEVNET_CAIP2, SOLANA_TESTNET_CAIP2];\n if (!supported.includes(network)) {\n throw new Error(`Unsupported SVM network: ${network}`);\n }\n return network;\n }\n\n // Otherwise, it's a V1 network name, convert to CAIP-2\n const caip2Network = V1_TO_V2_NETWORK_MAP[network];\n if (!caip2Network) {\n throw new Error(`Unsupported SVM network: ${network}`);\n }\n return caip2Network;\n}\n\n/**\n * Validate Solana address format\n *\n * @param address - Base58 encoded address string\n * @returns true if address is valid, false otherwise\n */\nexport function validateSvmAddress(address: string): boolean {\n return SVM_ADDRESS_REGEX.test(address);\n}\n\n/**\n * Decode a base64 encoded transaction from an SVM payload\n *\n * @param svmPayload - The SVM payload containing a base64 encoded transaction\n * @returns Decoded Transaction object\n */\nexport function decodeTransactionFromPayload(svmPayload: ExactSvmPayloadV1): Transaction {\n try {\n const base64Encoder = getBase64Encoder();\n const transactionBytes = base64Encoder.encode(svmPayload.transaction);\n const transactionDecoder = getTransactionDecoder();\n return transactionDecoder.decode(transactionBytes);\n } catch (error) {\n console.error(\"Error decoding transaction:\", error);\n throw new Error(\"invalid_exact_svm_payload_transaction\");\n }\n}\n\n/**\n * Extract the token sender (owner of the source token account) from a TransferChecked instruction\n *\n * @param transaction - The decoded transaction\n * @returns The token payer address as a base58 string\n */\nexport function getTokenPayerFromTransaction(transaction: Transaction): string {\n const compiled = getCompiledTransactionMessageDecoder().decode(\n transaction.messageBytes,\n ) as CompiledTransactionMessage;\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 tokenAmount = Math.floor(amount * Math.pow(10, decimals));\n return tokenAmount.toString();\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,7 @@
1
+ // src/v1/index.ts
2
+ var NETWORKS = ["solana", "solana-devnet", "solana-testnet"];
3
+
4
+ export {
5
+ NETWORKS
6
+ };
7
+ //# sourceMappingURL=chunk-WWACQNRQ.mjs.map
@@ -0,0 +1 @@
1
+ {"version":3,"sources":["../../src/v1/index.ts"],"sourcesContent":["/**\n * V1 exports for the SVM mechanism\n */\nexport { ExactSvmSchemeV1 } from \"../exact/v1\";\n\nexport const NETWORKS: string[] = [\"solana\", \"solana-devnet\", \"solana-testnet\"];\n"],"mappings":";AAKO,IAAM,WAAqB,CAAC,UAAU,iBAAiB,gBAAgB;","names":[]}
@@ -0,0 +1,37 @@
1
+ export { E as ExactSvmScheme } from '../../scheme-DRerE5zq.mjs';
2
+ import { t402Client, SelectPaymentRequirements, PaymentPolicy } from '@t402/core/client';
3
+ import { Network } from '@t402/core/types';
4
+ import { C as ClientSvmSigner } from '../../signer-BMkbhFYE.mjs';
5
+ import '@solana/kit';
6
+
7
+ /**
8
+ * Configuration options for registering SVM schemes to an t402Client
9
+ */
10
+ interface SvmClientConfig {
11
+ /**
12
+ * The SVM signer to use for creating payment payloads
13
+ */
14
+ signer: ClientSvmSigner;
15
+ /**
16
+ * Optional payment requirements selector function
17
+ */
18
+ paymentRequirementsSelector?: SelectPaymentRequirements;
19
+ /**
20
+ * Optional policies to apply to the client
21
+ */
22
+ policies?: PaymentPolicy[];
23
+ /**
24
+ * Optional specific networks to register
25
+ */
26
+ networks?: Network[];
27
+ }
28
+ /**
29
+ * Registers SVM payment schemes to an existing t402Client instance.
30
+ *
31
+ * @param client - The t402Client instance to register schemes to
32
+ * @param config - Configuration for SVM client registration
33
+ * @returns The client instance for chaining
34
+ */
35
+ declare function registerExactSvmScheme(client: t402Client, config: SvmClientConfig): t402Client;
36
+
37
+ export { type SvmClientConfig, registerExactSvmScheme };
@@ -0,0 +1,36 @@
1
+ import {
2
+ ExactSvmScheme
3
+ } from "../../chunk-7S5RSPMY.mjs";
4
+ import {
5
+ NETWORKS
6
+ } from "../../chunk-WWACQNRQ.mjs";
7
+ import {
8
+ ExactSvmSchemeV1
9
+ } from "../../chunk-FPXYRDTG.mjs";
10
+ import "../../chunk-4BFJL7IW.mjs";
11
+ import "../../chunk-JFN5MEH3.mjs";
12
+
13
+ // src/exact/client/register.ts
14
+ function registerExactSvmScheme(client, config) {
15
+ if (config.networks && config.networks.length > 0) {
16
+ config.networks.forEach((network) => {
17
+ client.register(network, new ExactSvmScheme(config.signer));
18
+ });
19
+ } else {
20
+ client.register("solana:*", new ExactSvmScheme(config.signer));
21
+ }
22
+ NETWORKS.forEach((network) => {
23
+ client.registerV1(network, new ExactSvmSchemeV1(config.signer));
24
+ });
25
+ if (config.policies) {
26
+ config.policies.forEach((policy) => {
27
+ client.registerPolicy(policy);
28
+ });
29
+ }
30
+ return client;
31
+ }
32
+ export {
33
+ ExactSvmScheme,
34
+ registerExactSvmScheme
35
+ };
36
+ //# sourceMappingURL=index.mjs.map
@@ -0,0 +1 @@
1
+ {"version":3,"sources":["../../../../src/exact/client/register.ts"],"sourcesContent":["import { t402Client, SelectPaymentRequirements, PaymentPolicy } from \"@t402/core/client\";\nimport { Network } from \"@t402/core/types\";\nimport { ClientSvmSigner } from \"../../signer\";\nimport { ExactSvmScheme } from \"./scheme\";\nimport { ExactSvmSchemeV1 } from \"../v1/client/scheme\";\nimport { NETWORKS } from \"../../v1\";\n\n/**\n * Configuration options for registering SVM schemes to an t402Client\n */\nexport interface SvmClientConfig {\n /**\n * The SVM signer to use for creating payment payloads\n */\n signer: ClientSvmSigner;\n\n /**\n * Optional payment requirements selector function\n */\n paymentRequirementsSelector?: SelectPaymentRequirements;\n\n /**\n * Optional policies to apply to the client\n */\n policies?: PaymentPolicy[];\n\n /**\n * Optional specific networks to register\n */\n networks?: Network[];\n}\n\n/**\n * Registers SVM payment schemes to an existing t402Client instance.\n *\n * @param client - The t402Client instance to register schemes to\n * @param config - Configuration for SVM client registration\n * @returns The client instance for chaining\n */\nexport function registerExactSvmScheme(client: t402Client, config: SvmClientConfig): t402Client {\n // Register V2 scheme\n if (config.networks && config.networks.length > 0) {\n config.networks.forEach(network => {\n client.register(network, new ExactSvmScheme(config.signer));\n });\n } else {\n client.register(\"solana:*\", new ExactSvmScheme(config.signer));\n }\n\n // Register all V1 networks\n NETWORKS.forEach(network => {\n client.registerV1(network as Network, new ExactSvmSchemeV1(config.signer));\n });\n\n if (config.policies) {\n config.policies.forEach(policy => {\n client.registerPolicy(policy);\n });\n }\n\n return client;\n}\n"],"mappings":";;;;;;;;;;;;;AAuCO,SAAS,uBAAuB,QAAoB,QAAqC;AAE9F,MAAI,OAAO,YAAY,OAAO,SAAS,SAAS,GAAG;AACjD,WAAO,SAAS,QAAQ,aAAW;AACjC,aAAO,SAAS,SAAS,IAAI,eAAe,OAAO,MAAM,CAAC;AAAA,IAC5D,CAAC;AAAA,EACH,OAAO;AACL,WAAO,SAAS,YAAY,IAAI,eAAe,OAAO,MAAM,CAAC;AAAA,EAC/D;AAGA,WAAS,QAAQ,aAAW;AAC1B,WAAO,WAAW,SAAoB,IAAI,iBAAiB,OAAO,MAAM,CAAC;AAAA,EAC3E,CAAC;AAED,MAAI,OAAO,UAAU;AACnB,WAAO,SAAS,QAAQ,YAAU;AAChC,aAAO,eAAe,MAAM;AAAA,IAC9B,CAAC;AAAA,EACH;AAEA,SAAO;AACT;","names":[]}
@@ -0,0 +1,110 @@
1
+ import { SchemeNetworkFacilitator, PaymentPayload, PaymentRequirements, VerifyResponse, SettleResponse, Network } from '@t402/core/types';
2
+ import { F as FacilitatorSvmSigner } from '../../signer-BMkbhFYE.mjs';
3
+ import { t402Facilitator } from '@t402/core/facilitator';
4
+ import '@solana/kit';
5
+
6
+ /**
7
+ * SVM facilitator implementation for the Exact payment scheme.
8
+ */
9
+ declare class ExactSvmScheme implements SchemeNetworkFacilitator {
10
+ private readonly signer;
11
+ readonly scheme = "exact";
12
+ readonly caipFamily = "solana:*";
13
+ /**
14
+ * Creates a new ExactSvmFacilitator instance.
15
+ *
16
+ * @param signer - The SVM RPC client for facilitator operations
17
+ * @returns ExactSvmFacilitator instance
18
+ */
19
+ constructor(signer: FacilitatorSvmSigner);
20
+ /**
21
+ * Get mechanism-specific extra data for the supported kinds endpoint.
22
+ * For SVM, this includes a randomly selected fee payer address.
23
+ * Random selection distributes load across multiple signers.
24
+ *
25
+ * @param _ - The network identifier (unused for SVM)
26
+ * @returns Extra data with feePayer address
27
+ */
28
+ getExtra(_: string): Record<string, unknown> | undefined;
29
+ /**
30
+ * Get signer addresses used by this facilitator.
31
+ * For SVM, returns all available fee payer addresses.
32
+ *
33
+ * @param _ - The network identifier (unused for SVM)
34
+ * @returns Array of fee payer addresses
35
+ */
36
+ getSigners(_: string): string[];
37
+ /**
38
+ * Verifies a payment payload.
39
+ *
40
+ * @param payload - The payment payload to verify
41
+ * @param requirements - The payment requirements
42
+ * @returns Promise resolving to verification response
43
+ */
44
+ verify(payload: PaymentPayload, requirements: PaymentRequirements): Promise<VerifyResponse>;
45
+ /**
46
+ * Settles a payment by submitting the transaction.
47
+ * Ensures the correct signer is used based on the feePayer specified in requirements.
48
+ *
49
+ * @param payload - The payment payload to settle
50
+ * @param requirements - The payment requirements
51
+ * @returns Promise resolving to settlement response
52
+ */
53
+ settle(payload: PaymentPayload, requirements: PaymentRequirements): Promise<SettleResponse>;
54
+ /**
55
+ * Verify that the compute limit instruction is valid.
56
+ *
57
+ * @param instruction - The compute limit instruction
58
+ * @param instruction.programAddress - Program address
59
+ * @param instruction.data - Instruction data bytes
60
+ */
61
+ private verifyComputeLimitInstruction;
62
+ /**
63
+ * Verify that the compute price instruction is valid.
64
+ *
65
+ * @param instruction - The compute price instruction
66
+ * @param instruction.programAddress - Program address
67
+ * @param instruction.data - Instruction data bytes
68
+ */
69
+ private verifyComputePriceInstruction;
70
+ }
71
+
72
+ /**
73
+ * Configuration options for registering SVM schemes to an t402Facilitator
74
+ */
75
+ interface SvmFacilitatorConfig {
76
+ /**
77
+ * The SVM signer for facilitator operations
78
+ */
79
+ signer: FacilitatorSvmSigner;
80
+ /**
81
+ * Networks to register (single network or array of networks)
82
+ * Examples: "solana:EtWTRABZaYq6iMfeYKouRu166VU2xqa1", ["solana:EtWTRABZaYq6iMfeYKouRu166VU2xqa1", "solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp"]
83
+ */
84
+ networks: Network | Network[];
85
+ }
86
+ /**
87
+ * Registers SVM payment schemes to an existing t402Facilitator instance.
88
+ *
89
+ * @param facilitator - The t402Facilitator instance to register schemes to
90
+ * @param config - Configuration for SVM facilitator registration
91
+ * @returns The facilitator instance for chaining
92
+ *
93
+ * @example
94
+ * ```typescript
95
+ * // Single network
96
+ * registerExactSvmScheme(facilitator, {
97
+ * signer: svmSigner,
98
+ * networks: "solana:EtWTRABZaYq6iMfeYKouRu166VU2xqa1" // Devnet
99
+ * });
100
+ *
101
+ * // Multiple networks (will auto-derive solana:* pattern)
102
+ * registerExactSvmScheme(facilitator, {
103
+ * signer: svmSigner,
104
+ * networks: ["solana:EtWTRABZaYq6iMfeYKouRu166VU2xqa1", "solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp"]
105
+ * });
106
+ * ```
107
+ */
108
+ declare function registerExactSvmScheme(facilitator: t402Facilitator, config: SvmFacilitatorConfig): t402Facilitator;
109
+
110
+ export { ExactSvmScheme, type SvmFacilitatorConfig, registerExactSvmScheme };