@veridex/sdk 1.0.0-beta.8 → 1.0.1

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 (130) hide show
  1. package/LICENSE +170 -21
  2. package/README.md +574 -117
  3. package/dist/EVMClient-DtqvdfUP.d.mts +376 -0
  4. package/dist/auth/prepareAuth.d.mts +25 -0
  5. package/dist/auth/prepareAuth.js +2406 -0
  6. package/dist/auth/prepareAuth.js.map +1 -0
  7. package/dist/auth/prepareAuth.mjs +151 -0
  8. package/dist/auth/prepareAuth.mjs.map +1 -0
  9. package/dist/chains/aptos/index.d.mts +6 -5
  10. package/dist/chains/aptos/index.js +66 -39
  11. package/dist/chains/aptos/index.js.map +1 -1
  12. package/dist/chains/aptos/index.mjs +5 -547
  13. package/dist/chains/aptos/index.mjs.map +1 -1
  14. package/dist/chains/avalanche/index.d.mts +137 -0
  15. package/dist/chains/avalanche/index.js +1555 -0
  16. package/dist/chains/avalanche/index.js.map +1 -0
  17. package/dist/chains/avalanche/index.mjs +10 -0
  18. package/dist/chains/avalanche/index.mjs.map +1 -0
  19. package/dist/chains/evm/index.d.mts +5 -3
  20. package/dist/chains/evm/index.js +165 -3
  21. package/dist/chains/evm/index.js.map +1 -1
  22. package/dist/chains/evm/index.mjs +8 -1200
  23. package/dist/chains/evm/index.mjs.map +1 -1
  24. package/dist/chains/solana/index.d.mts +1 -1
  25. package/dist/chains/solana/index.js.map +1 -1
  26. package/dist/chains/solana/index.mjs +4 -486
  27. package/dist/chains/solana/index.mjs.map +1 -1
  28. package/dist/chains/stacks/index.d.mts +559 -0
  29. package/dist/chains/stacks/index.js +1207 -0
  30. package/dist/chains/stacks/index.js.map +1 -0
  31. package/dist/chains/stacks/index.mjs +71 -0
  32. package/dist/chains/stacks/index.mjs.map +1 -0
  33. package/dist/chains/starknet/index.d.mts +3 -3
  34. package/dist/chains/starknet/index.js.map +1 -1
  35. package/dist/chains/starknet/index.mjs +5 -503
  36. package/dist/chains/starknet/index.mjs.map +1 -1
  37. package/dist/chains/sui/index.d.mts +2 -2
  38. package/dist/chains/sui/index.js.map +1 -1
  39. package/dist/chains/sui/index.mjs +5 -529
  40. package/dist/chains/sui/index.mjs.map +1 -1
  41. package/dist/chunk-5T6KPH7A.mjs +1082 -0
  42. package/dist/chunk-5T6KPH7A.mjs.map +1 -0
  43. package/dist/chunk-72ZA3OYQ.mjs +20 -0
  44. package/dist/chunk-72ZA3OYQ.mjs.map +1 -0
  45. package/dist/chunk-EFIURACP.mjs +438 -0
  46. package/dist/chunk-EFIURACP.mjs.map +1 -0
  47. package/dist/chunk-F3YAGZSW.mjs +269 -0
  48. package/dist/chunk-F3YAGZSW.mjs.map +1 -0
  49. package/dist/chunk-GWJRKDSA.mjs +549 -0
  50. package/dist/chunk-GWJRKDSA.mjs.map +1 -0
  51. package/dist/chunk-M3MM4YMF.mjs +417 -0
  52. package/dist/chunk-M3MM4YMF.mjs.map +1 -0
  53. package/dist/chunk-N4A2RMUN.mjs +216 -0
  54. package/dist/chunk-N4A2RMUN.mjs.map +1 -0
  55. package/dist/chunk-NUWSMJFJ.mjs +179 -0
  56. package/dist/chunk-NUWSMJFJ.mjs.map +1 -0
  57. package/dist/chunk-OVMMTL6H.mjs +330 -0
  58. package/dist/chunk-OVMMTL6H.mjs.map +1 -0
  59. package/dist/chunk-PDHZ5X5O.mjs +565 -0
  60. package/dist/chunk-PDHZ5X5O.mjs.map +1 -0
  61. package/dist/chunk-PRHNGA4G.mjs +464 -0
  62. package/dist/chunk-PRHNGA4G.mjs.map +1 -0
  63. package/dist/chunk-Q5O3M5LP.mjs +422 -0
  64. package/dist/chunk-Q5O3M5LP.mjs.map +1 -0
  65. package/dist/chunk-QDO6NQ7P.mjs +840 -0
  66. package/dist/chunk-QDO6NQ7P.mjs.map +1 -0
  67. package/dist/chunk-QT4ZZ4GM.mjs +509 -0
  68. package/dist/chunk-QT4ZZ4GM.mjs.map +1 -0
  69. package/dist/chunk-USDA5JTN.mjs +1249 -0
  70. package/dist/chunk-USDA5JTN.mjs.map +1 -0
  71. package/dist/chunk-V636MIV3.mjs +52 -0
  72. package/dist/chunk-V636MIV3.mjs.map +1 -0
  73. package/dist/chunk-X7BZMSPQ.mjs +407 -0
  74. package/dist/chunk-X7BZMSPQ.mjs.map +1 -0
  75. package/dist/chunk-YCUJZ6Z7.mjs +829 -0
  76. package/dist/chunk-YCUJZ6Z7.mjs.map +1 -0
  77. package/dist/constants.d.mts +1 -1
  78. package/dist/constants.js +26 -12
  79. package/dist/constants.js.map +1 -1
  80. package/dist/constants.mjs +16 -375
  81. package/dist/constants.mjs.map +1 -1
  82. package/dist/index-DDalBhAm.d.mts +243 -0
  83. package/dist/index.d.mts +2508 -556
  84. package/dist/index.js +14576 -9628
  85. package/dist/index.js.map +1 -1
  86. package/dist/index.mjs +4108 -7840
  87. package/dist/index.mjs.map +1 -1
  88. package/dist/passkey.d.mts +182 -0
  89. package/dist/passkey.js +914 -0
  90. package/dist/passkey.js.map +1 -0
  91. package/dist/passkey.mjs +15 -0
  92. package/dist/passkey.mjs.map +1 -0
  93. package/dist/payload.js.map +1 -1
  94. package/dist/payload.mjs +25 -244
  95. package/dist/payload.mjs.map +1 -1
  96. package/dist/portfolio-V347KZOL.mjs +13 -0
  97. package/dist/portfolio-V347KZOL.mjs.map +1 -0
  98. package/dist/queries/index.js +145 -12
  99. package/dist/queries/index.js.map +1 -1
  100. package/dist/queries/index.mjs +14 -1496
  101. package/dist/queries/index.mjs.map +1 -1
  102. package/dist/{types-FJL7j6gQ.d.ts → types-B7V5VNbO.d.mts} +6 -2
  103. package/dist/{types-ChIsqCiw.d.mts → types-DP2CQT8p.d.mts} +12 -1
  104. package/dist/types.d.mts +16 -0
  105. package/dist/types.js.map +1 -1
  106. package/dist/utils.js +25 -11
  107. package/dist/utils.js.map +1 -1
  108. package/dist/utils.mjs +19 -371
  109. package/dist/utils.mjs.map +1 -1
  110. package/dist/wormhole.js.map +1 -1
  111. package/dist/wormhole.mjs +25 -397
  112. package/dist/wormhole.mjs.map +1 -1
  113. package/package.json +28 -3
  114. package/scripts/patch-noble-curves.js +78 -0
  115. package/dist/chains/aptos/index.d.ts +0 -145
  116. package/dist/chains/evm/index.d.ts +0 -5
  117. package/dist/chains/solana/index.d.ts +0 -116
  118. package/dist/chains/starknet/index.d.ts +0 -172
  119. package/dist/chains/sui/index.d.ts +0 -182
  120. package/dist/constants.d.ts +0 -150
  121. package/dist/index-0NXfbk0z.d.ts +0 -637
  122. package/dist/index-D0dLVjTA.d.mts +0 -637
  123. package/dist/index.d.ts +0 -3123
  124. package/dist/payload.d.ts +0 -125
  125. package/dist/queries/index.d.ts +0 -148
  126. package/dist/types-ChIsqCiw.d.ts +0 -565
  127. package/dist/types-FJL7j6gQ.d.mts +0 -172
  128. package/dist/types.d.ts +0 -407
  129. package/dist/utils.d.ts +0 -81
  130. package/dist/wormhole.d.ts +0 -167
@@ -0,0 +1,216 @@
1
+ import {
2
+ EVMClient
3
+ } from "./chunk-USDA5JTN.mjs";
4
+
5
+ // src/chains/avalanche/AvalancheClient.ts
6
+ import { ethers } from "ethers";
7
+ var ACP204_PRECOMPILE = "0x0000000000000000000000000000000000000100";
8
+ var CHAINLINK_AGGREGATOR_ABI = [
9
+ "function latestRoundData() view returns (uint80 roundId, int256 answer, uint256 startedAt, uint256 updatedAt, uint80 answeredInRound)",
10
+ "function decimals() view returns (uint8)"
11
+ ];
12
+ var ICM_SPOKE_ABI = [
13
+ "function verifySession(bytes32 sessionKeyHash, uint256 amount) view returns (bool valid, uint256 remainingBudget)",
14
+ "function getSession(bytes32 sessionKeyHash) view returns (bytes32 userKeyHash, uint256 expiry, uint256 maxValue, uint256 totalBudget, uint256 spent, bool active)",
15
+ "function getStatus() view returns (bool paused, uint256 totalMessages, uint256 totalSessions, uint256 totalPayments)",
16
+ "function isKeyAuthorized(bytes32 identityKeyHash, bytes32 keyHash) view returns (bool)"
17
+ ];
18
+ var P256_VERIFIER_ABI = [
19
+ "function isPrecompileAvailable() view returns (bool available)",
20
+ "function computeKeyHash(uint256 x, uint256 y) view returns (bytes32)"
21
+ ];
22
+ var AvalancheClient = class extends EVMClient {
23
+ avaxProvider;
24
+ p256VerifierAddress;
25
+ icmSpokeAddress;
26
+ chainlinkAvaxUsdFeed;
27
+ chainlinkUsdcUsdFeed;
28
+ chainlinkUsdtUsdFeed;
29
+ // Price cache (avoid excessive RPC calls)
30
+ priceCache = /* @__PURE__ */ new Map();
31
+ CACHE_TTL_MS = 3e4;
32
+ // 30 seconds
33
+ constructor(config) {
34
+ super(config);
35
+ this.avaxProvider = new ethers.JsonRpcProvider(config.rpcUrl);
36
+ this.p256VerifierAddress = config.p256VerifierAddress || "";
37
+ this.icmSpokeAddress = config.icmSpokeAddress || "";
38
+ this.chainlinkAvaxUsdFeed = config.chainlinkAvaxUsdFeed || "";
39
+ this.chainlinkUsdcUsdFeed = config.chainlinkUsdcUsdFeed || "";
40
+ this.chainlinkUsdtUsdFeed = config.chainlinkUsdtUsdFeed || "";
41
+ }
42
+ // ========================================================================
43
+ // ACP-204 Precompile Utilities
44
+ // ========================================================================
45
+ /**
46
+ * Check if the ACP-204 secp256r1 precompile is live on this chain.
47
+ * Returns true on Avalanche C-Chain (mainnet + Fuji), false elsewhere.
48
+ */
49
+ async isACP204Available() {
50
+ if (this.p256VerifierAddress) {
51
+ try {
52
+ const verifier = new ethers.Contract(
53
+ this.p256VerifierAddress,
54
+ P256_VERIFIER_ABI,
55
+ this.avaxProvider
56
+ );
57
+ return await verifier.isPrecompileAvailable();
58
+ } catch {
59
+ }
60
+ }
61
+ try {
62
+ const zeroInput = new Uint8Array(160);
63
+ const result = await this.avaxProvider.call({
64
+ to: ACP204_PRECOMPILE,
65
+ data: ethers.hexlify(zeroInput)
66
+ });
67
+ return result.length === 66;
68
+ } catch {
69
+ return false;
70
+ }
71
+ }
72
+ /**
73
+ * Get the estimated gas cost (in wei) for a single P-256 verification.
74
+ * Deterministic on Avalanche: 6,900 gas for precompile + ~300 staticcall overhead.
75
+ */
76
+ async estimatePasskeyVerificationGas() {
77
+ const feeData = await this.avaxProvider.getFeeData();
78
+ const gasPrice = feeData.gasPrice || ethers.parseUnits("25", "gwei");
79
+ return 7200n * gasPrice;
80
+ }
81
+ /**
82
+ * Get estimated USD cost for a passkey verification.
83
+ */
84
+ async estimatePasskeyVerificationCostUSD() {
85
+ const gasCostWei = await this.estimatePasskeyVerificationGas();
86
+ return this.convertAvaxToUsd(gasCostWei);
87
+ }
88
+ // ========================================================================
89
+ // Chainlink Price Feeds
90
+ // ========================================================================
91
+ /**
92
+ * Get current AVAX/USD price from Chainlink.
93
+ * Cached for 30 seconds to avoid excessive RPC calls.
94
+ */
95
+ async getAvaxPriceUSD() {
96
+ return this._getChainlinkPrice(this.chainlinkAvaxUsdFeed, "avax-usd");
97
+ }
98
+ /**
99
+ * Get USDC/USD price (for stablecoin verification).
100
+ */
101
+ async getUsdcPriceUSD() {
102
+ if (!this.chainlinkUsdcUsdFeed) return 1;
103
+ return this._getChainlinkPrice(this.chainlinkUsdcUsdFeed, "usdc-usd");
104
+ }
105
+ /**
106
+ * Get USDT/USD price.
107
+ */
108
+ async getUsdtPriceUSD() {
109
+ if (!this.chainlinkUsdtUsdFeed) return 1;
110
+ return this._getChainlinkPrice(this.chainlinkUsdtUsdFeed, "usdt-usd");
111
+ }
112
+ /**
113
+ * Convert a USD amount to AVAX wei using live Chainlink prices.
114
+ */
115
+ async convertUsdToAvax(usdAmount) {
116
+ const avaxPrice = await this.getAvaxPriceUSD();
117
+ if (avaxPrice <= 0) throw new Error("Invalid AVAX price from Chainlink");
118
+ const avaxAmount = usdAmount / avaxPrice;
119
+ return ethers.parseEther(avaxAmount.toFixed(18));
120
+ }
121
+ /**
122
+ * Convert AVAX wei to USD using live Chainlink prices.
123
+ */
124
+ async convertAvaxToUsd(avaxWei) {
125
+ const avaxPrice = await this.getAvaxPriceUSD();
126
+ return Number(ethers.formatEther(avaxWei)) * avaxPrice;
127
+ }
128
+ // ========================================================================
129
+ // ICM Spoke Queries
130
+ // ========================================================================
131
+ /**
132
+ * Verify a session is valid on the ICM Spoke (cross-L1 verification).
133
+ */
134
+ async verifyICMSession(sessionKeyHash, amount) {
135
+ if (!this.icmSpokeAddress) {
136
+ throw new Error("ICM Spoke address not configured");
137
+ }
138
+ const spoke = new ethers.Contract(this.icmSpokeAddress, ICM_SPOKE_ABI, this.avaxProvider);
139
+ const [valid, remainingBudget] = await spoke.verifySession(sessionKeyHash, amount);
140
+ return { valid, remainingBudget: BigInt(remainingBudget) };
141
+ }
142
+ /**
143
+ * Get status of the ICM Spoke (paused, message count, session count).
144
+ */
145
+ async getICMSpokeStatus() {
146
+ if (!this.icmSpokeAddress) {
147
+ throw new Error("ICM Spoke address not configured");
148
+ }
149
+ const spoke = new ethers.Contract(this.icmSpokeAddress, ICM_SPOKE_ABI, this.avaxProvider);
150
+ const [paused, totalMessages, totalSessions, totalPayments] = await spoke.getStatus();
151
+ return {
152
+ paused,
153
+ totalMessages: BigInt(totalMessages),
154
+ totalSessions: BigInt(totalSessions),
155
+ totalPayments: BigInt(totalPayments)
156
+ };
157
+ }
158
+ /**
159
+ * Check if a key is authorized for an identity on the ICM Spoke.
160
+ */
161
+ async isKeyAuthorizedOnSpoke(identityKeyHash, keyHash) {
162
+ if (!this.icmSpokeAddress) return false;
163
+ const spoke = new ethers.Contract(this.icmSpokeAddress, ICM_SPOKE_ABI, this.avaxProvider);
164
+ return spoke.isKeyAuthorized(identityKeyHash, keyHash);
165
+ }
166
+ // ========================================================================
167
+ // ICM-Aware Routing
168
+ // ========================================================================
169
+ /**
170
+ * Determine whether a cross-chain message should use Teleporter (ICM) or Wormhole.
171
+ *
172
+ * Rule: If the target chain is within the Avalanche ecosystem (C-Chain ID or
173
+ * an Avalanche L1), use ICM/Teleporter for lower latency and no guardian overhead.
174
+ * Otherwise, fall back to Wormhole VAAs for cross-ecosystem messaging.
175
+ *
176
+ * @param targetWormholeChainId Wormhole chain ID of the destination
177
+ * @returns 'icm' | 'wormhole'
178
+ */
179
+ getRoutingStrategy(targetWormholeChainId) {
180
+ const avalancheEcosystemChainIds = /* @__PURE__ */ new Set([6]);
181
+ return avalancheEcosystemChainIds.has(targetWormholeChainId) ? "icm" : "wormhole";
182
+ }
183
+ // ========================================================================
184
+ // Accessors
185
+ // ========================================================================
186
+ getP256VerifierAddress() {
187
+ return this.p256VerifierAddress;
188
+ }
189
+ getICMSpokeAddress() {
190
+ return this.icmSpokeAddress;
191
+ }
192
+ getChainlinkAvaxUsdFeed() {
193
+ return this.chainlinkAvaxUsdFeed;
194
+ }
195
+ // ========================================================================
196
+ // Private Helpers
197
+ // ========================================================================
198
+ async _getChainlinkPrice(feedAddress, cacheKey) {
199
+ if (!feedAddress) throw new Error(`Chainlink feed not configured for ${cacheKey}`);
200
+ const cached = this.priceCache.get(cacheKey);
201
+ if (cached && Date.now() - cached.timestamp < this.CACHE_TTL_MS) {
202
+ return cached.price;
203
+ }
204
+ const aggregator = new ethers.Contract(feedAddress, CHAINLINK_AGGREGATOR_ABI, this.avaxProvider);
205
+ const [, answer] = await aggregator.latestRoundData();
206
+ const decimals = await aggregator.decimals();
207
+ const price = Number(answer) / 10 ** Number(decimals);
208
+ this.priceCache.set(cacheKey, { price, timestamp: Date.now() });
209
+ return price;
210
+ }
211
+ };
212
+
213
+ export {
214
+ AvalancheClient
215
+ };
216
+ //# sourceMappingURL=chunk-N4A2RMUN.mjs.map
@@ -0,0 +1 @@
1
+ {"version":3,"sources":["../src/chains/avalanche/AvalancheClient.ts"],"sourcesContent":["/**\n * Veridex Protocol SDK — Avalanche Chain Client\n *\n * Extends the standard EVMClient with Avalanche-native capabilities:\n * - ACP-204 precompile detection (native secp256r1 at 0x0100, 6,900 gas)\n * - ICM / Teleporter routing awareness for intra-Avalanche L1 messaging\n * - Chainlink AVAX/USD price feeds for USD-denominated session limits\n *\n * @example\n * ```typescript\n * import { AvalancheClient } from '@veridex/sdk/chains/avalanche';\n *\n * const client = new AvalancheClient({\n * chainId: 43113,\n * wormholeChainId: 6,\n * rpcUrl: 'https://api.avax-test.network/ext/bc/C/rpc',\n * hubContractAddress: '0x...',\n * wormholeCoreBridge: '0x7bbcE28e64B3F8b84d876Ab298393c38ad7aac4C',\n * });\n *\n * // Check ACP-204 precompile\n * const available = await client.isACP204Available();\n *\n * // Get AVAX price for budget calculations\n * const price = await client.getAvaxPriceUSD();\n * ```\n */\n\nimport { ethers } from 'ethers';\nimport { EVMClient, type EVMClientConfig } from '../evm/EVMClient.js';\n\n// ============================================================================\n// Types\n// ============================================================================\n\nexport interface AvalancheClientConfig extends EVMClientConfig {\n /** ACP-204 P256 verifier wrapper contract address */\n p256VerifierAddress?: string;\n /** ICM Spoke contract address for cross-L1 session bridging */\n icmSpokeAddress?: string;\n /** Chainlink AVAX/USD price feed address */\n chainlinkAvaxUsdFeed?: string;\n /** Chainlink USDC/USD price feed address */\n chainlinkUsdcUsdFeed?: string;\n /** Chainlink USDT/USD price feed address */\n chainlinkUsdtUsdFeed?: string;\n}\n\n// ============================================================================\n// Constants\n// ============================================================================\n\n/** ACP-204 precompile address on Avalanche C-Chain */\nconst ACP204_PRECOMPILE = '0x0000000000000000000000000000000000000100';\n\n/** Minimal Chainlink AggregatorV3 ABI */\nconst CHAINLINK_AGGREGATOR_ABI = [\n 'function latestRoundData() view returns (uint80 roundId, int256 answer, uint256 startedAt, uint256 updatedAt, uint80 answeredInRound)',\n 'function decimals() view returns (uint8)',\n];\n\n/** Minimal ICM Spoke ABI for session/identity queries */\nconst ICM_SPOKE_ABI = [\n 'function verifySession(bytes32 sessionKeyHash, uint256 amount) view returns (bool valid, uint256 remainingBudget)',\n 'function getSession(bytes32 sessionKeyHash) view returns (bytes32 userKeyHash, uint256 expiry, uint256 maxValue, uint256 totalBudget, uint256 spent, bool active)',\n 'function getStatus() view returns (bool paused, uint256 totalMessages, uint256 totalSessions, uint256 totalPayments)',\n 'function isKeyAuthorized(bytes32 identityKeyHash, bytes32 keyHash) view returns (bool)',\n];\n\n/** Minimal AvalancheP256Verifier ABI */\nconst P256_VERIFIER_ABI = [\n 'function isPrecompileAvailable() view returns (bool available)',\n 'function computeKeyHash(uint256 x, uint256 y) view returns (bytes32)',\n];\n\n// ============================================================================\n// AvalancheClient\n// ============================================================================\n\n/**\n * Avalanche-specific SDK chain client.\n *\n * Wraps the standard EVMClient and adds:\n * - ACP-204 precompile availability checks\n * - Chainlink AVAX/USD price queries (for USD-denominated budgets)\n * - ICM Spoke queries (cross-L1 session verification)\n * - ICM-aware message routing (Teleporter for intra-Avalanche, Wormhole for cross-ecosystem)\n */\nexport class AvalancheClient extends EVMClient {\n private avaxProvider: ethers.JsonRpcProvider;\n private p256VerifierAddress: string;\n private icmSpokeAddress: string;\n private chainlinkAvaxUsdFeed: string;\n private chainlinkUsdcUsdFeed: string;\n private chainlinkUsdtUsdFeed: string;\n\n // Price cache (avoid excessive RPC calls)\n private priceCache: Map<string, { price: number; timestamp: number }> = new Map();\n private readonly CACHE_TTL_MS = 30_000; // 30 seconds\n\n constructor(config: AvalancheClientConfig) {\n super(config);\n this.avaxProvider = new ethers.JsonRpcProvider(config.rpcUrl);\n this.p256VerifierAddress = config.p256VerifierAddress || '';\n this.icmSpokeAddress = config.icmSpokeAddress || '';\n this.chainlinkAvaxUsdFeed = config.chainlinkAvaxUsdFeed || '';\n this.chainlinkUsdcUsdFeed = config.chainlinkUsdcUsdFeed || '';\n this.chainlinkUsdtUsdFeed = config.chainlinkUsdtUsdFeed || '';\n }\n\n // ========================================================================\n // ACP-204 Precompile Utilities\n // ========================================================================\n\n /**\n * Check if the ACP-204 secp256r1 precompile is live on this chain.\n * Returns true on Avalanche C-Chain (mainnet + Fuji), false elsewhere.\n */\n async isACP204Available(): Promise<boolean> {\n // Try via wrapper contract first (more reliable answer)\n if (this.p256VerifierAddress) {\n try {\n const verifier = new ethers.Contract(\n this.p256VerifierAddress,\n P256_VERIFIER_ABI,\n this.avaxProvider,\n );\n return await verifier.isPrecompileAvailable();\n } catch {\n // Fall through to raw check\n }\n }\n\n // Direct precompile probe\n try {\n const zeroInput = new Uint8Array(160);\n const result = await this.avaxProvider.call({\n to: ACP204_PRECOMPILE,\n data: ethers.hexlify(zeroInput),\n });\n return result.length === 66; // 32 bytes = 0x + 64 hex chars\n } catch {\n return false;\n }\n }\n\n /**\n * Get the estimated gas cost (in wei) for a single P-256 verification.\n * Deterministic on Avalanche: 6,900 gas for precompile + ~300 staticcall overhead.\n */\n async estimatePasskeyVerificationGas(): Promise<bigint> {\n const feeData = await this.avaxProvider.getFeeData();\n const gasPrice = feeData.gasPrice || ethers.parseUnits('25', 'gwei');\n return 7_200n * gasPrice;\n }\n\n /**\n * Get estimated USD cost for a passkey verification.\n */\n async estimatePasskeyVerificationCostUSD(): Promise<number> {\n const gasCostWei = await this.estimatePasskeyVerificationGas();\n return this.convertAvaxToUsd(gasCostWei);\n }\n\n // ========================================================================\n // Chainlink Price Feeds\n // ========================================================================\n\n /**\n * Get current AVAX/USD price from Chainlink.\n * Cached for 30 seconds to avoid excessive RPC calls.\n */\n async getAvaxPriceUSD(): Promise<number> {\n return this._getChainlinkPrice(this.chainlinkAvaxUsdFeed, 'avax-usd');\n }\n\n /**\n * Get USDC/USD price (for stablecoin verification).\n */\n async getUsdcPriceUSD(): Promise<number> {\n if (!this.chainlinkUsdcUsdFeed) return 1.0;\n return this._getChainlinkPrice(this.chainlinkUsdcUsdFeed, 'usdc-usd');\n }\n\n /**\n * Get USDT/USD price.\n */\n async getUsdtPriceUSD(): Promise<number> {\n if (!this.chainlinkUsdtUsdFeed) return 1.0;\n return this._getChainlinkPrice(this.chainlinkUsdtUsdFeed, 'usdt-usd');\n }\n\n /**\n * Convert a USD amount to AVAX wei using live Chainlink prices.\n */\n async convertUsdToAvax(usdAmount: number): Promise<bigint> {\n const avaxPrice = await this.getAvaxPriceUSD();\n if (avaxPrice <= 0) throw new Error('Invalid AVAX price from Chainlink');\n const avaxAmount = usdAmount / avaxPrice;\n return ethers.parseEther(avaxAmount.toFixed(18));\n }\n\n /**\n * Convert AVAX wei to USD using live Chainlink prices.\n */\n async convertAvaxToUsd(avaxWei: bigint): Promise<number> {\n const avaxPrice = await this.getAvaxPriceUSD();\n return Number(ethers.formatEther(avaxWei)) * avaxPrice;\n }\n\n // ========================================================================\n // ICM Spoke Queries\n // ========================================================================\n\n /**\n * Verify a session is valid on the ICM Spoke (cross-L1 verification).\n */\n async verifyICMSession(\n sessionKeyHash: string,\n amount: bigint,\n ): Promise<{ valid: boolean; remainingBudget: bigint }> {\n if (!this.icmSpokeAddress) {\n throw new Error('ICM Spoke address not configured');\n }\n const spoke = new ethers.Contract(this.icmSpokeAddress, ICM_SPOKE_ABI, this.avaxProvider);\n const [valid, remainingBudget] = await spoke.verifySession(sessionKeyHash, amount);\n return { valid, remainingBudget: BigInt(remainingBudget) };\n }\n\n /**\n * Get status of the ICM Spoke (paused, message count, session count).\n */\n async getICMSpokeStatus(): Promise<{\n paused: boolean;\n totalMessages: bigint;\n totalSessions: bigint;\n totalPayments: bigint;\n }> {\n if (!this.icmSpokeAddress) {\n throw new Error('ICM Spoke address not configured');\n }\n const spoke = new ethers.Contract(this.icmSpokeAddress, ICM_SPOKE_ABI, this.avaxProvider);\n const [paused, totalMessages, totalSessions, totalPayments] = await spoke.getStatus();\n return {\n paused,\n totalMessages: BigInt(totalMessages),\n totalSessions: BigInt(totalSessions),\n totalPayments: BigInt(totalPayments),\n };\n }\n\n /**\n * Check if a key is authorized for an identity on the ICM Spoke.\n */\n async isKeyAuthorizedOnSpoke(identityKeyHash: string, keyHash: string): Promise<boolean> {\n if (!this.icmSpokeAddress) return false;\n const spoke = new ethers.Contract(this.icmSpokeAddress, ICM_SPOKE_ABI, this.avaxProvider);\n return spoke.isKeyAuthorized(identityKeyHash, keyHash);\n }\n\n // ========================================================================\n // ICM-Aware Routing\n // ========================================================================\n\n /**\n * Determine whether a cross-chain message should use Teleporter (ICM) or Wormhole.\n *\n * Rule: If the target chain is within the Avalanche ecosystem (C-Chain ID or\n * an Avalanche L1), use ICM/Teleporter for lower latency and no guardian overhead.\n * Otherwise, fall back to Wormhole VAAs for cross-ecosystem messaging.\n *\n * @param targetWormholeChainId Wormhole chain ID of the destination\n * @returns 'icm' | 'wormhole'\n */\n getRoutingStrategy(targetWormholeChainId: number): 'icm' | 'wormhole' {\n // Avalanche C-Chain Wormhole chain ID is 6 on both mainnet and testnet.\n // For Avalanche L1s routed over Teleporter, they share the same ecosystem.\n // Currently only the C-Chain (6) is a known ICM target.\n const avalancheEcosystemChainIds = new Set([6]);\n return avalancheEcosystemChainIds.has(targetWormholeChainId) ? 'icm' : 'wormhole';\n }\n\n // ========================================================================\n // Accessors\n // ========================================================================\n\n getP256VerifierAddress(): string {\n return this.p256VerifierAddress;\n }\n\n getICMSpokeAddress(): string {\n return this.icmSpokeAddress;\n }\n\n getChainlinkAvaxUsdFeed(): string {\n return this.chainlinkAvaxUsdFeed;\n }\n\n // ========================================================================\n // Private Helpers\n // ========================================================================\n\n private async _getChainlinkPrice(feedAddress: string, cacheKey: string): Promise<number> {\n if (!feedAddress) throw new Error(`Chainlink feed not configured for ${cacheKey}`);\n\n const cached = this.priceCache.get(cacheKey);\n if (cached && Date.now() - cached.timestamp < this.CACHE_TTL_MS) {\n return cached.price;\n }\n\n const aggregator = new ethers.Contract(feedAddress, CHAINLINK_AGGREGATOR_ABI, this.avaxProvider);\n const [, answer] = await aggregator.latestRoundData();\n const decimals = await aggregator.decimals();\n const price = Number(answer) / 10 ** Number(decimals);\n\n this.priceCache.set(cacheKey, { price, timestamp: Date.now() });\n return price;\n }\n}\n"],"mappings":"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","names":[]}
@@ -0,0 +1,179 @@
1
+ import {
2
+ MAINNET_CHAINS,
3
+ TESTNET_CHAINS
4
+ } from "./chunk-X7BZMSPQ.mjs";
5
+
6
+ // src/utils.ts
7
+ import { ethers } from "ethers";
8
+ function base64URLEncode(buffer) {
9
+ const bytes = Array.from(buffer);
10
+ const binary = String.fromCharCode(...bytes);
11
+ const base64 = btoa(binary);
12
+ return base64.replace(/\+/g, "-").replace(/\//g, "_").replace(/=/g, "");
13
+ }
14
+ function base64URLDecode(str) {
15
+ const base64 = str.replace(/-/g, "+").replace(/_/g, "/");
16
+ const padded = base64 + "=".repeat((4 - base64.length % 4) % 4);
17
+ const binary = atob(padded);
18
+ const bytes = new Uint8Array(binary.length);
19
+ for (let i = 0; i < binary.length; i++) {
20
+ bytes[i] = binary.charCodeAt(i);
21
+ }
22
+ return bytes;
23
+ }
24
+ function parseDERSignature(signature) {
25
+ let offset = 0;
26
+ if (signature[offset++] !== 48) {
27
+ throw new Error("Invalid signature format");
28
+ }
29
+ offset++;
30
+ if (signature[offset++] !== 2) {
31
+ throw new Error("Invalid signature format");
32
+ }
33
+ const rLength = signature[offset++];
34
+ if (rLength === void 0) {
35
+ throw new Error("Invalid signature format: missing r length");
36
+ }
37
+ let r = signature.slice(offset, offset + rLength);
38
+ offset += rLength;
39
+ if (r[0] === 0 && r.length > 32) {
40
+ r = r.slice(1);
41
+ }
42
+ if (r.length < 32) {
43
+ const padded = new Uint8Array(32);
44
+ padded.set(r, 32 - r.length);
45
+ r = padded;
46
+ }
47
+ if (signature[offset++] !== 2) {
48
+ throw new Error("Invalid signature format");
49
+ }
50
+ const sLength = signature[offset++];
51
+ if (sLength === void 0) {
52
+ throw new Error("Invalid signature format: missing s length");
53
+ }
54
+ let s = signature.slice(offset, offset + sLength);
55
+ if (s[0] === 0 && s.length > 32) {
56
+ s = s.slice(1);
57
+ }
58
+ if (s.length < 32) {
59
+ const padded = new Uint8Array(32);
60
+ padded.set(s, 32 - s.length);
61
+ s = padded;
62
+ }
63
+ return { r, s };
64
+ }
65
+ function encodeSignatureForSolidity(r, s) {
66
+ return ethers.solidityPacked(["uint256", "uint256"], [r, s]);
67
+ }
68
+ function computeKeyHash(publicKeyX, publicKeyY) {
69
+ return ethers.keccak256(
70
+ ethers.solidityPacked(["uint256", "uint256"], [publicKeyX, publicKeyY])
71
+ );
72
+ }
73
+ function getChainConfig(chainName, testnet = true) {
74
+ const chains = testnet ? TESTNET_CHAINS : MAINNET_CHAINS;
75
+ return chains[chainName];
76
+ }
77
+ function getChainByWormholeId(wormholeChainId, testnet = true) {
78
+ const chains = testnet ? TESTNET_CHAINS : MAINNET_CHAINS;
79
+ return Object.values(chains).find((chain) => chain.wormholeChainId === wormholeChainId);
80
+ }
81
+ function getChainByEvmId(evmChainId, testnet = true) {
82
+ const chains = testnet ? TESTNET_CHAINS : MAINNET_CHAINS;
83
+ return Object.values(chains).find((chain) => chain.chainId === evmChainId);
84
+ }
85
+ function isEvmChain(wormholeChainId) {
86
+ const nonEvmChains = /* @__PURE__ */ new Set([1, 8, 15, 21, 22]);
87
+ return !nonEvmChains.has(wormholeChainId);
88
+ }
89
+ function getSupportedChains(testnet = true) {
90
+ const chains = testnet ? TESTNET_CHAINS : MAINNET_CHAINS;
91
+ return Object.values(chains);
92
+ }
93
+ function getTxExplorerUrl(chain, txHash) {
94
+ if (chain.isEvm) {
95
+ return `${chain.explorerUrl}/tx/${txHash}`;
96
+ }
97
+ switch (chain.wormholeChainId) {
98
+ case 1:
99
+ return `${chain.explorerUrl}/tx/${txHash}?cluster=devnet`;
100
+ case 21:
101
+ return `${chain.explorerUrl}/tx/${txHash}`;
102
+ case 22:
103
+ return `${chain.explorerUrl}/txn/${txHash}?network=testnet`;
104
+ default:
105
+ return `${chain.explorerUrl}/tx/${txHash}`;
106
+ }
107
+ }
108
+ function getAddressExplorerUrl(chain, address) {
109
+ if (chain.isEvm) {
110
+ return `${chain.explorerUrl}/address/${address}`;
111
+ }
112
+ switch (chain.wormholeChainId) {
113
+ case 1:
114
+ return `${chain.explorerUrl}/address/${address}?cluster=devnet`;
115
+ case 21:
116
+ return `${chain.explorerUrl}/account/${address}`;
117
+ case 22:
118
+ return `${chain.explorerUrl}/account/${address}?network=testnet`;
119
+ default:
120
+ return `${chain.explorerUrl}/address/${address}`;
121
+ }
122
+ }
123
+ function isValidEvmAddress(address) {
124
+ return ethers.isAddress(address);
125
+ }
126
+ function isValidBytes32(hex) {
127
+ const clean = hex.replace("0x", "");
128
+ return /^[0-9a-fA-F]{64}$/.test(clean);
129
+ }
130
+ function isValidWormholeChainId(chainId) {
131
+ return chainId >= 1 && chainId <= 5e4;
132
+ }
133
+ async function retryWithBackoff(fn, options = {}) {
134
+ const {
135
+ maxRetries = 5,
136
+ initialDelayMs = 1e3,
137
+ maxDelayMs = 3e4,
138
+ backoffMultiplier = 2,
139
+ onRetry
140
+ } = options;
141
+ let lastError;
142
+ let delay = initialDelayMs;
143
+ for (let attempt = 1; attempt <= maxRetries; attempt++) {
144
+ try {
145
+ return await fn();
146
+ } catch (error) {
147
+ lastError = error;
148
+ if (attempt < maxRetries) {
149
+ onRetry?.(attempt, lastError);
150
+ await sleep(delay);
151
+ delay = Math.min(delay * backoffMultiplier, maxDelayMs);
152
+ }
153
+ }
154
+ }
155
+ throw lastError ?? new Error("Retry failed");
156
+ }
157
+ function sleep(ms) {
158
+ return new Promise((resolve) => setTimeout(resolve, ms));
159
+ }
160
+
161
+ export {
162
+ base64URLEncode,
163
+ base64URLDecode,
164
+ parseDERSignature,
165
+ encodeSignatureForSolidity,
166
+ computeKeyHash,
167
+ getChainConfig,
168
+ getChainByWormholeId,
169
+ getChainByEvmId,
170
+ isEvmChain,
171
+ getSupportedChains,
172
+ getTxExplorerUrl,
173
+ getAddressExplorerUrl,
174
+ isValidEvmAddress,
175
+ isValidBytes32,
176
+ isValidWormholeChainId,
177
+ retryWithBackoff
178
+ };
179
+ //# sourceMappingURL=chunk-NUWSMJFJ.mjs.map
@@ -0,0 +1 @@
1
+ {"version":3,"sources":["../src/utils.ts"],"sourcesContent":["/**\n * Veridex Protocol SDK - Utility Functions\n */\n\nimport { ethers } from 'ethers';\nimport type { ChainConfig } from './types.js';\nimport { TESTNET_CHAINS, MAINNET_CHAINS } from './constants.js';\n\n// ============================================================================\n// Base64URL Encoding/Decoding (WebAuthn compatible)\n// ============================================================================\n\n/**\n * Base64URL encode a buffer\n */\nexport function base64URLEncode(buffer: Uint8Array): string {\n // Convert Uint8Array to base64 using browser APIs\n const bytes = Array.from(buffer);\n const binary = String.fromCharCode(...bytes);\n const base64 = btoa(binary);\n return base64.replace(/\\+/g, '-').replace(/\\//g, '_').replace(/=/g, '');\n}\n\n/**\n * Base64URL decode a string\n */\nexport function base64URLDecode(str: string): Uint8Array {\n const base64 = str.replace(/-/g, '+').replace(/_/g, '/');\n const padded = base64 + '='.repeat((4 - (base64.length % 4)) % 4);\n // Use browser's atob for base64 decoding\n const binary = atob(padded);\n const bytes = new Uint8Array(binary.length);\n for (let i = 0; i < binary.length; i++) {\n bytes[i] = binary.charCodeAt(i);\n }\n return bytes;\n}\n\n// ============================================================================\n// Signature Utilities\n// ============================================================================\n\n/**\n * Parse DER-encoded ECDSA signature to r and s values\n */\nexport function parseDERSignature(signature: Uint8Array): { r: Uint8Array; s: Uint8Array } {\n let offset = 0;\n\n if (signature[offset++] !== 0x30) {\n throw new Error('Invalid signature format');\n }\n\n // Skip total length\n offset++;\n\n if (signature[offset++] !== 0x02) {\n throw new Error('Invalid signature format');\n }\n\n const rLength = signature[offset++];\n if (rLength === undefined) {\n throw new Error('Invalid signature format: missing r length');\n }\n let r = signature.slice(offset, offset + rLength);\n offset += rLength;\n\n // Remove leading zero if present (for positive number representation)\n if (r[0] === 0x00 && r.length > 32) {\n r = r.slice(1);\n }\n // Pad to 32 bytes if needed\n if (r.length < 32) {\n const padded = new Uint8Array(32);\n padded.set(r, 32 - r.length);\n r = padded;\n }\n\n if (signature[offset++] !== 0x02) {\n throw new Error('Invalid signature format');\n }\n\n const sLength = signature[offset++];\n if (sLength === undefined) {\n throw new Error('Invalid signature format: missing s length');\n }\n let s = signature.slice(offset, offset + sLength);\n\n // Remove leading zero if present\n if (s[0] === 0x00 && s.length > 32) {\n s = s.slice(1);\n }\n // Pad to 32 bytes if needed\n if (s.length < 32) {\n const padded = new Uint8Array(32);\n padded.set(s, 32 - s.length);\n s = padded;\n }\n\n return { r, s };\n}\n\n/**\n * Encode signature for Solidity verification\n */\nexport function encodeSignatureForSolidity(r: bigint, s: bigint): string {\n return ethers.solidityPacked(['uint256', 'uint256'], [r, s]);\n}\n\n// ============================================================================\n// Key Hash Utilities\n// ============================================================================\n\n/**\n * Compute key hash from public key coordinates\n */\nexport function computeKeyHash(publicKeyX: bigint, publicKeyY: bigint): string {\n return ethers.keccak256(\n ethers.solidityPacked(['uint256', 'uint256'], [publicKeyX, publicKeyY])\n );\n}\n\n// ============================================================================\n// Chain Utilities\n// ============================================================================\n\n/**\n * Get chain config by name\n */\nexport function getChainConfig(chainName: string, testnet = true): ChainConfig | undefined {\n const chains = testnet ? TESTNET_CHAINS : MAINNET_CHAINS;\n return chains[chainName];\n}\n\n/**\n * Get chain config by Wormhole chain ID\n */\nexport function getChainByWormholeId(wormholeChainId: number, testnet = true): ChainConfig | undefined {\n const chains = testnet ? TESTNET_CHAINS : MAINNET_CHAINS;\n return Object.values(chains).find(chain => chain.wormholeChainId === wormholeChainId);\n}\n\n/**\n * Get chain config by EVM chain ID\n */\nexport function getChainByEvmId(evmChainId: number, testnet = true): ChainConfig | undefined {\n const chains = testnet ? TESTNET_CHAINS : MAINNET_CHAINS;\n return Object.values(chains).find(chain => chain.chainId === evmChainId);\n}\n\n/**\n * Check if a chain is EVM-compatible\n */\nexport function isEvmChain(wormholeChainId: number): boolean {\n // Non-EVM chains\n const nonEvmChains = new Set([1, 8, 15, 21, 22]); // Solana, Algorand, NEAR, Sui, Aptos\n return !nonEvmChains.has(wormholeChainId);\n}\n\n/**\n * Get all supported chains\n */\nexport function getSupportedChains(testnet = true): ChainConfig[] {\n const chains = testnet ? TESTNET_CHAINS : MAINNET_CHAINS;\n return Object.values(chains);\n}\n\n// ============================================================================\n// Explorer URL Utilities\n// ============================================================================\n\n/**\n * Get transaction explorer URL\n */\nexport function getTxExplorerUrl(chain: ChainConfig, txHash: string): string {\n if (chain.isEvm) {\n return `${chain.explorerUrl}/tx/${txHash}`;\n }\n\n // Non-EVM chains have different URL patterns\n switch (chain.wormholeChainId) {\n case 1: // Solana\n return `${chain.explorerUrl}/tx/${txHash}?cluster=devnet`;\n case 21: // Sui\n return `${chain.explorerUrl}/tx/${txHash}`;\n case 22: // Aptos\n return `${chain.explorerUrl}/txn/${txHash}?network=testnet`;\n default:\n return `${chain.explorerUrl}/tx/${txHash}`;\n }\n}\n\n/**\n * Get address explorer URL\n */\nexport function getAddressExplorerUrl(chain: ChainConfig, address: string): string {\n if (chain.isEvm) {\n return `${chain.explorerUrl}/address/${address}`;\n }\n\n switch (chain.wormholeChainId) {\n case 1: // Solana\n return `${chain.explorerUrl}/address/${address}?cluster=devnet`;\n case 21: // Sui\n return `${chain.explorerUrl}/account/${address}`;\n case 22: // Aptos\n return `${chain.explorerUrl}/account/${address}?network=testnet`;\n default:\n return `${chain.explorerUrl}/address/${address}`;\n }\n}\n\n// ============================================================================\n// Validation Utilities\n// ============================================================================\n\n/**\n * Validate an EVM address\n */\nexport function isValidEvmAddress(address: string): boolean {\n return ethers.isAddress(address);\n}\n\n/**\n * Validate a bytes32 hex string\n */\nexport function isValidBytes32(hex: string): boolean {\n const clean = hex.replace('0x', '');\n return /^[0-9a-fA-F]{64}$/.test(clean);\n}\n\n/**\n * Validate a Wormhole chain ID\n */\nexport function isValidWormholeChainId(chainId: number): boolean {\n // Valid Wormhole chain IDs range from 1 to ~10007 (testnets)\n return chainId >= 1 && chainId <= 50000;\n}\n\n// ============================================================================\n// Retry Utilities\n// ============================================================================\n\n/**\n * Retry a function with exponential backoff\n */\nexport async function retryWithBackoff<T>(\n fn: () => Promise<T>,\n options: {\n maxRetries?: number;\n initialDelayMs?: number;\n maxDelayMs?: number;\n backoffMultiplier?: number;\n onRetry?: (attempt: number, error: Error) => void;\n } = {}\n): Promise<T> {\n const {\n maxRetries = 5,\n initialDelayMs = 1000,\n maxDelayMs = 30000,\n backoffMultiplier = 2,\n onRetry,\n } = options;\n\n let lastError: Error | undefined;\n let delay = initialDelayMs;\n\n for (let attempt = 1; attempt <= maxRetries; attempt++) {\n try {\n return await fn();\n } catch (error) {\n lastError = error as Error;\n\n if (attempt < maxRetries) {\n onRetry?.(attempt, lastError);\n await sleep(delay);\n delay = Math.min(delay * backoffMultiplier, maxDelayMs);\n }\n }\n }\n\n throw lastError ?? new Error('Retry failed');\n}\n\n// ============================================================================\n// Helpers\n// ============================================================================\n\nfunction sleep(ms: number): Promise<void> {\n return new Promise(resolve => setTimeout(resolve, ms));\n}\n"],"mappings":"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","names":[]}