@gala-chain/launchpad-sdk 8.0.2 → 9.0.0-rc.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 (269) hide show
  1. package/CHANGELOG.md +362 -0
  2. package/EXAMPLES.md +95 -681
  3. package/MIGRATING-TO-9.0.md +301 -0
  4. package/README.md +46 -17
  5. package/dist/LaunchpadSDK.d.ts +150 -419
  6. package/dist/LaunchpadSDK.d.ts.map +1 -1
  7. package/dist/api/LaunchpadAPI.d.ts +37 -43
  8. package/dist/api/LaunchpadAPI.d.ts.map +1 -1
  9. package/dist/auth/SessionAuthService.d.ts.map +1 -1
  10. package/dist/auth/SignatureAuth.d.ts +2 -2
  11. package/dist/auth/SignatureAuth.d.ts.map +1 -1
  12. package/dist/auth/types.d.ts +1 -1
  13. package/dist/auth/types.d.ts.map +1 -1
  14. package/dist/config/environments.d.ts +7 -2
  15. package/dist/config/environments.d.ts.map +1 -1
  16. package/dist/constants/decimals.d.ts +0 -23
  17. package/dist/constants/decimals.d.ts.map +1 -1
  18. package/dist/constants/endpoints.d.ts +0 -7
  19. package/dist/constants/endpoints.d.ts.map +1 -1
  20. package/dist/constants/version.generated.d.ts +1 -1
  21. package/dist/constants/version.generated.d.ts.map +1 -1
  22. package/dist/helpers/sdk.d.ts.map +1 -1
  23. package/dist/index.browser.d.ts +11 -23
  24. package/dist/index.browser.d.ts.map +1 -1
  25. package/dist/index.browser.esm.js +1 -1
  26. package/dist/index.cjs +1 -1
  27. package/dist/index.esm.js +1 -1
  28. package/dist/index.js +1 -1
  29. package/dist/index.node.d.ts +4 -5
  30. package/dist/index.node.d.ts.map +1 -1
  31. package/dist/launchpad/bundle-submission.d.ts +1 -9
  32. package/dist/launchpad/bundle-submission.d.ts.map +1 -1
  33. package/dist/launchpad/sell-fee-ceiling.d.ts +66 -0
  34. package/dist/launchpad/sell-fee-ceiling.d.ts.map +1 -0
  35. package/dist/launchpad/transport.d.ts +2 -1
  36. package/dist/launchpad/transport.d.ts.map +1 -1
  37. package/dist/launchpad/writes.d.ts +30 -2
  38. package/dist/launchpad/writes.d.ts.map +1 -1
  39. package/dist/native.cjs +1 -1
  40. package/dist/native.d.ts +3 -4
  41. package/dist/native.d.ts.map +1 -1
  42. package/dist/native.esm.js +1 -1
  43. package/dist/schemas/launchpad.d.ts +4 -4
  44. package/dist/schemas/launchpad.d.ts.map +1 -1
  45. package/dist/schemas/user.d.ts +0 -15
  46. package/dist/schemas/user.d.ts.map +1 -1
  47. package/dist/services/AbstractCacheService.d.ts +2 -2
  48. package/dist/services/BundleService.d.ts +9 -1
  49. package/dist/services/BundleService.d.ts.map +1 -1
  50. package/dist/services/GalaChainBalanceService.d.ts +17 -89
  51. package/dist/services/GalaChainBalanceService.d.ts.map +1 -1
  52. package/dist/services/GalaChainLockService.d.ts +19 -20
  53. package/dist/services/GalaChainLockService.d.ts.map +1 -1
  54. package/dist/services/GalaChainService.d.ts +28 -64
  55. package/dist/services/GalaChainService.d.ts.map +1 -1
  56. package/dist/services/GalaChainTokenService.d.ts +25 -53
  57. package/dist/services/GalaChainTokenService.d.ts.map +1 -1
  58. package/dist/services/GalaChainTransferService.d.ts +42 -41
  59. package/dist/services/GalaChainTransferService.d.ts.map +1 -1
  60. package/dist/services/LaunchpadPriceService.d.ts +66 -0
  61. package/dist/services/LaunchpadPriceService.d.ts.map +1 -0
  62. package/dist/services/NftCollectionService.d.ts +22 -6
  63. package/dist/services/NftCollectionService.d.ts.map +1 -1
  64. package/dist/services/TokenResolverService.d.ts +5 -5
  65. package/dist/services/TokenResolverService.d.ts.map +1 -1
  66. package/dist/services/TradingQuotesService.d.ts +3 -5
  67. package/dist/services/TradingQuotesService.d.ts.map +1 -1
  68. package/dist/services/gateway-transport.d.ts +32 -0
  69. package/dist/services/gateway-transport.d.ts.map +1 -0
  70. package/dist/services/gateway-writes.d.ts +83 -0
  71. package/dist/services/gateway-writes.d.ts.map +1 -0
  72. package/dist/signing/index.d.ts +2 -3
  73. package/dist/signing/index.d.ts.map +1 -1
  74. package/dist/signing/signers.d.ts +23 -11
  75. package/dist/signing/signers.d.ts.map +1 -1
  76. package/dist/signing/types.d.ts +7 -10
  77. package/dist/signing/types.d.ts.map +1 -1
  78. package/dist/types/burn.dto.d.ts +4 -2
  79. package/dist/types/burn.dto.d.ts.map +1 -1
  80. package/dist/types/common.d.ts +2 -23
  81. package/dist/types/common.d.ts.map +1 -1
  82. package/dist/types/dto.d.ts +0 -5
  83. package/dist/types/dto.d.ts.map +1 -1
  84. package/dist/types/launchpad.dto.d.ts +0 -269
  85. package/dist/types/launchpad.dto.d.ts.map +1 -1
  86. package/dist/types/lock.dto.d.ts +12 -7
  87. package/dist/types/lock.dto.d.ts.map +1 -1
  88. package/dist/types/options.dto.d.ts +8 -34
  89. package/dist/types/options.dto.d.ts.map +1 -1
  90. package/dist/types/session-auth.dto.d.ts +2 -4
  91. package/dist/types/session-auth.dto.d.ts.map +1 -1
  92. package/dist/types/user.dto.d.ts +7 -62
  93. package/dist/types/user.dto.d.ts.map +1 -1
  94. package/dist/utils/address-formatter.d.ts +10 -2
  95. package/dist/utils/address-formatter.d.ts.map +1 -1
  96. package/dist/utils/agent-config.d.ts +9 -4
  97. package/dist/utils/agent-config.d.ts.map +1 -1
  98. package/dist/utils/auto-pagination.d.ts +6 -239
  99. package/dist/utils/auto-pagination.d.ts.map +1 -1
  100. package/dist/utils/bignumber-helpers.d.ts +3 -2
  101. package/dist/utils/bignumber-helpers.d.ts.map +1 -1
  102. package/dist/utils/delimiter-parser.d.ts +0 -13
  103. package/dist/utils/delimiter-parser.d.ts.map +1 -1
  104. package/dist/utils/error-patterns.d.ts +0 -47
  105. package/dist/utils/error-patterns.d.ts.map +1 -1
  106. package/dist/utils/error-wrapper.d.ts +5 -5
  107. package/dist/utils/errors.d.ts +0 -308
  108. package/dist/utils/errors.d.ts.map +1 -1
  109. package/dist/utils/http.d.ts +15 -3
  110. package/dist/utils/http.d.ts.map +1 -1
  111. package/dist/utils/token-format-converter.d.ts +1 -1
  112. package/dist/utils/token-parser.d.ts +6 -127
  113. package/dist/utils/token-parser.d.ts.map +1 -1
  114. package/dist/utils/token-stringification.d.ts +7 -7
  115. package/dist/utils/token-stringification.d.ts.map +1 -1
  116. package/dist/utils/tokenNameNormalizer.d.ts +2 -2
  117. package/dist/utils/tokenNormalizer.d.ts +5 -29
  118. package/dist/utils/tokenNormalizer.d.ts.map +1 -1
  119. package/dist/utils/trade-quote.d.ts +32 -0
  120. package/dist/utils/trade-quote.d.ts.map +1 -0
  121. package/dist/utils/unique-key-generator.d.ts +7 -134
  122. package/dist/utils/unique-key-generator.d.ts.map +1 -1
  123. package/dist/utils/validation-helpers.d.ts +3 -5
  124. package/dist/utils/validation-helpers.d.ts.map +1 -1
  125. package/package.json +47 -87
  126. package/dist/api/dto/BurnTokensDto.d.ts +0 -77
  127. package/dist/api/dto/BurnTokensDto.d.ts.map +0 -1
  128. package/dist/api/dto/LockTokenDto.d.ts +0 -85
  129. package/dist/api/dto/LockTokenDto.d.ts.map +0 -1
  130. package/dist/api/dto/TransferTokenDto.d.ts +0 -64
  131. package/dist/api/dto/TransferTokenDto.d.ts.map +0 -1
  132. package/dist/api/dto/UnlockTokenDto.d.ts +0 -74
  133. package/dist/api/dto/UnlockTokenDto.d.ts.map +0 -1
  134. package/dist/bridge/BridgeService.d.ts +0 -484
  135. package/dist/bridge/BridgeService.d.ts.map +0 -1
  136. package/dist/bridge/GalaConnectClient.d.ts +0 -170
  137. package/dist/bridge/GalaConnectClient.d.ts.map +0 -1
  138. package/dist/bridge/constants/index.d.ts +0 -7
  139. package/dist/bridge/constants/index.d.ts.map +0 -1
  140. package/dist/bridge/constants/tokens.d.ts +0 -212
  141. package/dist/bridge/constants/tokens.d.ts.map +0 -1
  142. package/dist/bridge/index.d.ts +0 -24
  143. package/dist/bridge/index.d.ts.map +0 -1
  144. package/dist/bridge/public-types.d.ts +0 -2
  145. package/dist/bridge/public-types.d.ts.map +0 -1
  146. package/dist/bridge/strategies/BridgeStrategy.d.ts +0 -204
  147. package/dist/bridge/strategies/BridgeStrategy.d.ts.map +0 -1
  148. package/dist/bridge/strategies/EthereumBridgeStrategy.d.ts +0 -178
  149. package/dist/bridge/strategies/EthereumBridgeStrategy.d.ts.map +0 -1
  150. package/dist/bridge/strategies/SolanaBridgeStrategy.d.ts +0 -236
  151. package/dist/bridge/strategies/SolanaBridgeStrategy.d.ts.map +0 -1
  152. package/dist/bridge/types/bridge.dto.d.ts +0 -772
  153. package/dist/bridge/types/bridge.dto.d.ts.map +0 -1
  154. package/dist/bridge/types/bridgeable-token.dto.d.ts +0 -209
  155. package/dist/bridge/types/bridgeable-token.dto.d.ts.map +0 -1
  156. package/dist/bridge/types/eip712.d.ts +0 -66
  157. package/dist/bridge/types/eip712.d.ts.map +0 -1
  158. package/dist/bridge/types/index.d.ts +0 -8
  159. package/dist/bridge/types/index.d.ts.map +0 -1
  160. package/dist/bridge/utils/RateLimiter.d.ts +0 -34
  161. package/dist/bridge/utils/RateLimiter.d.ts.map +0 -1
  162. package/dist/bridge/utils/address-formatter.d.ts +0 -25
  163. package/dist/bridge/utils/address-formatter.d.ts.map +0 -1
  164. package/dist/bridge/utils/addressValidation.d.ts +0 -200
  165. package/dist/bridge/utils/addressValidation.d.ts.map +0 -1
  166. package/dist/bridge/utils/balanceHelpers.d.ts +0 -215
  167. package/dist/bridge/utils/balanceHelpers.d.ts.map +0 -1
  168. package/dist/bridge/utils/bridgeErrors.d.ts +0 -98
  169. package/dist/bridge/utils/bridgeErrors.d.ts.map +0 -1
  170. package/dist/bridge/utils/bridgeOutHelpers.d.ts +0 -68
  171. package/dist/bridge/utils/bridgeOutHelpers.d.ts.map +0 -1
  172. package/dist/bridge/utils/bridgePayload.d.ts +0 -98
  173. package/dist/bridge/utils/bridgePayload.d.ts.map +0 -1
  174. package/dist/bridge/utils/bridgeStatusParser.d.ts +0 -76
  175. package/dist/bridge/utils/bridgeStatusParser.d.ts.map +0 -1
  176. package/dist/bridge/utils/eip712Helpers.d.ts +0 -66
  177. package/dist/bridge/utils/eip712Helpers.d.ts.map +0 -1
  178. package/dist/bridge/utils/index.d.ts +0 -19
  179. package/dist/bridge/utils/index.d.ts.map +0 -1
  180. package/dist/bridge/utils/retry.d.ts +0 -112
  181. package/dist/bridge/utils/retry.d.ts.map +0 -1
  182. package/dist/bridge/utils/strategyDelegation.d.ts +0 -126
  183. package/dist/bridge/utils/strategyDelegation.d.ts.map +0 -1
  184. package/dist/bridge/utils/tokenIdUtils.d.ts +0 -86
  185. package/dist/bridge/utils/tokenIdUtils.d.ts.map +0 -1
  186. package/dist/bridge/utils/tokenMath.d.ts +0 -39
  187. package/dist/bridge/utils/tokenMath.d.ts.map +0 -1
  188. package/dist/bridge/utils/tokenMetadataResolver.d.ts +0 -97
  189. package/dist/bridge/utils/tokenMetadataResolver.d.ts.map +0 -1
  190. package/dist/helpers/wallet.d.ts +0 -151
  191. package/dist/helpers/wallet.d.ts.map +0 -1
  192. package/dist/react/WalletContext.d.ts +0 -60
  193. package/dist/react/WalletContext.d.ts.map +0 -1
  194. package/dist/react/index.d.ts +0 -65
  195. package/dist/react/index.d.ts.map +0 -1
  196. package/dist/react/types.d.ts +0 -76
  197. package/dist/react/types.d.ts.map +0 -1
  198. package/dist/react/useWallet.d.ts +0 -123
  199. package/dist/react/useWallet.d.ts.map +0 -1
  200. package/dist/react/useWalletConnection.d.ts +0 -89
  201. package/dist/react/useWalletConnection.d.ts.map +0 -1
  202. package/dist/react/useWalletDetection.d.ts +0 -81
  203. package/dist/react/useWalletDetection.d.ts.map +0 -1
  204. package/dist/react.cjs +0 -1
  205. package/dist/react.esm.js +0 -1
  206. package/dist/services/AbstractTokenFetchService.d.ts +0 -150
  207. package/dist/services/AbstractTokenFetchService.d.ts.map +0 -1
  208. package/dist/services/BatchedCacheService.d.ts +0 -133
  209. package/dist/services/BatchedCacheService.d.ts.map +0 -1
  210. package/dist/services/BridgeableTokenCache.d.ts +0 -120
  211. package/dist/services/BridgeableTokenCache.d.ts.map +0 -1
  212. package/dist/services/BridgeableTokenService.d.ts +0 -218
  213. package/dist/services/BridgeableTokenService.d.ts.map +0 -1
  214. package/dist/services/DexService.d.ts +0 -440
  215. package/dist/services/DexService.d.ts.map +0 -1
  216. package/dist/services/NetworkKeyedCacheService.d.ts +0 -185
  217. package/dist/services/NetworkKeyedCacheService.d.ts.map +0 -1
  218. package/dist/services/PriceHistoryService.d.ts +0 -209
  219. package/dist/services/PriceHistoryService.d.ts.map +0 -1
  220. package/dist/services/WrapService.d.ts +0 -171
  221. package/dist/services/WrapService.d.ts.map +0 -1
  222. package/dist/services/WrappableTokenCache.d.ts +0 -100
  223. package/dist/services/WrappableTokenCache.d.ts.map +0 -1
  224. package/dist/services/WrappableTokenService.d.ts +0 -130
  225. package/dist/services/WrappableTokenService.d.ts.map +0 -1
  226. package/dist/setup.d.ts +0 -8
  227. package/dist/setup.d.ts.map +0 -1
  228. package/dist/signing/eip712.d.ts +0 -13
  229. package/dist/signing/eip712.d.ts.map +0 -1
  230. package/dist/tokens/transfers.d.ts +0 -95
  231. package/dist/tokens/transfers.d.ts.map +0 -1
  232. package/dist/types/galachain-api.types.d.ts +0 -297
  233. package/dist/types/galachain-api.types.d.ts.map +0 -1
  234. package/dist/types/priceHistory.dto.d.ts +0 -134
  235. package/dist/types/priceHistory.dto.d.ts.map +0 -1
  236. package/dist/types/token.types.d.ts +0 -359
  237. package/dist/types/token.types.d.ts.map +0 -1
  238. package/dist/types/wrappable-token.dto.d.ts +0 -305
  239. package/dist/types/wrappable-token.dto.d.ts.map +0 -1
  240. package/dist/utils/crypto-compat.d.ts +0 -40
  241. package/dist/utils/crypto-compat.d.ts.map +0 -1
  242. package/dist/utils/load-env.d.ts +0 -31
  243. package/dist/utils/load-env.d.ts.map +0 -1
  244. package/dist/utils/token-instance-key.d.ts +0 -57
  245. package/dist/utils/token-instance-key.d.ts.map +0 -1
  246. package/dist/utils/wallet.d.ts +0 -166
  247. package/dist/utils/wallet.d.ts.map +0 -1
  248. package/dist/wallet/ExternalWalletProvider.d.ts +0 -90
  249. package/dist/wallet/ExternalWalletProvider.d.ts.map +0 -1
  250. package/dist/wallet/GalaWalletProvider.d.ts +0 -122
  251. package/dist/wallet/GalaWalletProvider.d.ts.map +0 -1
  252. package/dist/wallet/PrivateKeyProvider.d.ts +0 -90
  253. package/dist/wallet/PrivateKeyProvider.d.ts.map +0 -1
  254. package/dist/wallet/detection.d.ts +0 -107
  255. package/dist/wallet/detection.d.ts.map +0 -1
  256. package/dist/wallet/event-handlers.d.ts +0 -50
  257. package/dist/wallet/event-handlers.d.ts.map +0 -1
  258. package/dist/wallet/index.d.ts +0 -51
  259. package/dist/wallet/index.d.ts.map +0 -1
  260. package/dist/wallet/signing-operation.d.ts +0 -19
  261. package/dist/wallet/signing-operation.d.ts.map +0 -1
  262. package/dist/wallet/typed-data-helpers.d.ts +0 -68
  263. package/dist/wallet/typed-data-helpers.d.ts.map +0 -1
  264. package/dist/wallet/types.d.ts +0 -267
  265. package/dist/wallet/types.d.ts.map +0 -1
  266. package/dist/wallet/utils.d.ts +0 -117
  267. package/dist/wallet/utils.d.ts.map +0 -1
  268. package/dist/wallet.cjs +0 -1
  269. package/dist/wallet.esm.js +0 -1
@@ -242,312 +242,4 @@ export declare class TransactionError extends Error {
242
242
  */
243
243
  constructor(message: string, transactionId?: string | undefined, code?: string | undefined);
244
244
  }
245
- /**
246
- * Error thrown when GSwap SDK quote operations fail
247
- *
248
- * This error is thrown during quote generation (exact input or exact output).
249
- * It preserves the original GSwap SDK error for detailed diagnostics.
250
- *
251
- * @example Quote generation failure
252
- * ```typescript
253
- * throw new GSwapQuoteError(
254
- * 'Failed to get quote for GALA to GUSDC swap',
255
- * originalGSwapError,
256
- * 'POOL_NOT_FOUND'
257
- * );
258
- * ```
259
- *
260
- * @example Catching quote errors
261
- * ```typescript
262
- * try {
263
- * const quote = await sdk.dex.quoting.quoteExactInput('GALA', 'GUSDC', '100');
264
- * } catch (error) {
265
- * if (error instanceof GSwapQuoteError) {
266
- * console.log(`Quote failed: ${error.message}`);
267
- * console.log(`GSwap error: ${error.code}`);
268
- * // Implement user notification
269
- * }
270
- * }
271
- * ```
272
- */
273
- export declare class GSwapQuoteError extends Error {
274
- originalError: unknown;
275
- code?: string | undefined;
276
- /**
277
- * Creates a new GSwapQuoteError
278
- *
279
- * @param message - Human-readable error message describing what failed
280
- * @param originalError - The original error from GSwap SDK
281
- * @param code - Optional error code from GSwap SDK for programmatic handling
282
- */
283
- constructor(message: string, originalError: unknown, code?: string | undefined);
284
- }
285
- /**
286
- * Error thrown when GSwap SDK swap execution fails
287
- *
288
- * This error is thrown during token swap execution (buy/sell operations).
289
- * It preserves the original GSwap SDK error and transaction details.
290
- *
291
- * @example Swap execution failure
292
- * ```typescript
293
- * throw new GSwapSwapError(
294
- * 'Token swap failed: insufficient balance',
295
- * originalGSwapError,
296
- * 'txHash123',
297
- * 'INSUFFICIENT_BALANCE'
298
- * );
299
- * ```
300
- *
301
- * @example Catching swap errors
302
- * ```typescript
303
- * try {
304
- * const submitted = await sdk.dex.swaps.swap(tokenIn, tokenOut, fee, swapAmount);
305
- * const result = await submitted.confirm();
306
- * } catch (error) {
307
- * if (error instanceof GSwapSwapError) {
308
- * console.log(`Swap failed: ${error.message}`);
309
- * if (error.transactionHash) {
310
- * console.log(`TX: ${error.transactionHash}`);
311
- * }
312
- * }
313
- * }
314
- * ```
315
- */
316
- export declare class GSwapSwapError extends Error {
317
- originalError: unknown;
318
- transactionHash?: string | undefined;
319
- code?: string | undefined;
320
- /**
321
- * Creates a new GSwapSwapError
322
- *
323
- * @param message - Human-readable error message describing what failed
324
- * @param originalError - The original error from GSwap SDK
325
- * @param transactionHash - Optional transaction hash for transaction tracking
326
- * @param code - Optional error code from GSwap SDK for programmatic handling
327
- */
328
- constructor(message: string, originalError: unknown, transactionHash?: string | undefined, code?: string | undefined);
329
- }
330
- /**
331
- * Error thrown when GSwap SDK pool operations fail
332
- *
333
- * This error is thrown when pool-related queries fail, including:
334
- * - Pool information retrieval
335
- * - Available token swaps querying
336
- * - Pool data access errors
337
- *
338
- * @example Pool query failure
339
- * ```typescript
340
- * throw new GSwapPoolError(
341
- * 'Pool not found for GALA/GUSDC pair',
342
- * originalGSwapError,
343
- * 'GALA',
344
- * 'GUSDC',
345
- * 'POOL_NOT_FOUND'
346
- * );
347
- * ```
348
- *
349
- * @example Catching pool errors
350
- * ```typescript
351
- * try {
352
- * const poolInfo = await service.getPoolInfo('GALA', 'GUSDC');
353
- * } catch (error) {
354
- * if (error instanceof GSwapPoolError) {
355
- * console.log(`Pool error: ${error.message}`);
356
- * if (error.code === 'POOL_NOT_FOUND') {
357
- * console.log(`No pool for ${error.tokenA}/${error.tokenB}`);
358
- * }
359
- * }
360
- * }
361
- * ```
362
- */
363
- export declare class GSwapPoolError extends Error {
364
- originalError: unknown;
365
- tokenA?: string | undefined;
366
- tokenB?: string | undefined;
367
- code?: string | undefined;
368
- /**
369
- * Creates a new GSwapPoolError
370
- *
371
- * @param message - Human-readable error message describing what failed
372
- * @param originalError - The original error from GSwap SDK
373
- * @param tokenA - Optional token A symbol in the pool pair
374
- * @param tokenB - Optional token B symbol in the pool pair
375
- * @param code - Optional error code from GSwap SDK for programmatic handling
376
- */
377
- constructor(message: string, originalError: unknown, tokenA?: string | undefined, tokenB?: string | undefined, code?: string | undefined);
378
- }
379
- /**
380
- * Error thrown when GSwap SDK asset/balance operations fail
381
- *
382
- * This error is thrown when asset-related queries fail, including:
383
- * - User asset/balance retrieval
384
- * - Portfolio data access errors
385
- * - Asset validation failures
386
- *
387
- * @example Asset query failure
388
- * ```typescript
389
- * throw new GSwapAssetError(
390
- * 'Failed to fetch user assets',
391
- * originalGSwapError,
392
- * 'userAddress123',
393
- * 'NETWORK_ERROR'
394
- * );
395
- * ```
396
- *
397
- * @example Catching asset errors
398
- * ```typescript
399
- * try {
400
- * const assets = await service.getUserAssets(walletAddress);
401
- * } catch (error) {
402
- * if (error instanceof GSwapAssetError) {
403
- * console.log(`Asset query failed: ${error.message}`);
404
- * console.log(`Wallet: ${error.walletAddress}`);
405
- * }
406
- * }
407
- * ```
408
- */
409
- export declare class GSwapAssetError extends Error {
410
- originalError: unknown;
411
- walletAddress?: string | undefined;
412
- code?: string | undefined;
413
- /**
414
- * Creates a new GSwapAssetError
415
- *
416
- * @param message - Human-readable error message describing what failed
417
- * @param originalError - The original error from GSwap SDK
418
- * @param walletAddress - Optional wallet address being queried
419
- * @param code - Optional error code from GSwap SDK for programmatic handling
420
- */
421
- constructor(message: string, originalError: unknown, walletAddress?: string | undefined, code?: string | undefined);
422
- }
423
- /**
424
- * Error thrown when GSwap SDK liquidity position operations fail
425
- *
426
- * This error is thrown when position management operations fail, including:
427
- * - Position queries (getUserPositions, getPosition, getPositionById)
428
- * - Liquidity addition (addLiquidityByPrice, addLiquidityByTicks)
429
- * - Liquidity removal (removeLiquidity)
430
- * - Fee collection (collectPositionFees)
431
- * - Position estimation (estimateRemoveLiquidity)
432
- *
433
- * @example Position operation failure
434
- * ```typescript
435
- * throw new GSwapPositionError(
436
- * 'Failed to add liquidity to GALA/GUSDC pool',
437
- * originalGSwapError,
438
- * 'INSUFFICIENT_BALANCE'
439
- * );
440
- * ```
441
- *
442
- * @example Catching position errors
443
- * ```typescript
444
- * try {
445
- * const result = await service.addLiquidityByPrice({ token0: 'GALA', token1: 'GUSDC', ... });
446
- * } catch (error) {
447
- * if (error instanceof GSwapPositionError) {
448
- * console.log(`Position operation failed: ${error.message}`);
449
- * console.log(`Error code: ${error.code}`);
450
- * // Implement user notification or recovery logic
451
- * }
452
- * }
453
- * ```
454
- */
455
- export declare class GSwapPositionError extends Error {
456
- originalError: unknown;
457
- code?: string | undefined;
458
- /**
459
- * Creates a new GSwapPositionError
460
- *
461
- * @param message - Human-readable error message describing what failed
462
- * @param originalError - The original error from GSwap SDK
463
- * @param code - Optional error code from GSwap SDK for programmatic handling
464
- */
465
- constructor(message: string, originalError: unknown, code?: string | undefined);
466
- }
467
- /**
468
- * Error thrown when DEX quote operations fail
469
- *
470
- * This error is thrown during DEX quote calculations (local and external),
471
- * composite pool data fetching, and related operations. It captures the
472
- * operation context for debugging and recovery.
473
- *
474
- * @example Quote calculation failure
475
- * ```typescript
476
- * throw new DexQuoteError(
477
- * 'Failed to calculate quote for GALA/BENE swap',
478
- * {
479
- * fromToken: 'GALA|Unit|none|none',
480
- * toToken: 'Token|Unit|BENE|client:123',
481
- * amount: '1000'
482
- * }
483
- * );
484
- * ```
485
- *
486
- * @example Catching quote errors
487
- * ```typescript
488
- * try {
489
- * const quote = await sdk.calculateDexPoolQuoteExactAmountLocal({
490
- * compositePoolData: composite,
491
- * fromToken: 'GALA|Unit|none|none',
492
- * toToken: 'Token|Unit|BENE|client:123',
493
- * amount: '1000'
494
- * });
495
- * } catch (error) {
496
- * if (error instanceof DexQuoteError) {
497
- * console.log(`Quote failed: ${error.message}`);
498
- * if (error.context) {
499
- * console.log(`Tokens: ${error.context.fromToken} → ${error.context.toToken}`);
500
- * }
501
- * }
502
- * }
503
- * ```
504
- */
505
- export declare class DexQuoteError extends ValidationError {
506
- context?: unknown | undefined;
507
- /**
508
- * Creates a new DexQuoteError
509
- *
510
- * @param message - Human-readable error message describing what failed
511
- * @param context - Optional context object with operation details (tokens, amounts, etc.)
512
- */
513
- constructor(message: string, context?: unknown | undefined);
514
- }
515
- /**
516
- * Error thrown when a DEX pool is not found
517
- *
518
- * This error is thrown when attempting to access or fetch data for a DEX pool
519
- * that does not exist, typically during composite pool data retrieval or pool
520
- * discovery operations.
521
- *
522
- * @example Pool not found
523
- * ```typescript
524
- * throw new DexPoolNotFoundError(
525
- * 'Pool not found: GALA/BENE with fee 3000'
526
- * );
527
- * ```
528
- *
529
- * @example Catching pool not found errors
530
- * ```typescript
531
- * try {
532
- * const composite = await sdk.dex.pools.getCompositePool(
533
- * 'GALA|Unit|none|none',
534
- * 'Token|Unit|BENE|client:123',
535
- * 3000
536
- * );
537
- * } catch (error) {
538
- * if (error instanceof DexPoolNotFoundError) {
539
- * console.log('Pool does not exist. Create it first with liquidity.');
540
- * // Implement pool creation or alternative routing
541
- * }
542
- * }
543
- * ```
544
- */
545
- export declare class DexPoolNotFoundError extends ValidationError {
546
- /**
547
- * Creates a new DexPoolNotFoundError
548
- *
549
- * @param message - Human-readable error message describing which pool was not found
550
- */
551
- constructor(message: string);
552
- }
553
245
  //# sourceMappingURL=errors.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/utils/errors.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/utils/errors.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAMH;;;;;;;;;;;;;;;;GAgBG;AACH,eAAO,MAAM,WAAW;IACtB,2CAA2C;;IAE3C,+DAA+D;;IAE/D,qDAAqD;;IAErD,mDAAmD;;IAEnD,oCAAoC;;IAEpC,mCAAmC;;IAEnC,oCAAoC;;IAEpC,qCAAqC;;IAErC,0CAA0C;;IAE1C,mCAAmC;;IAEnC,2CAA2C;;IAE3C,uDAAuD;;IAEvD,+CAA+C;;IAE/C,0CAA0C;;IAE1C,0CAA0C;;IAE1C,gDAAgD;;IAEhD,+CAA+C;;CAEvC,CAAC;AAEX;;;;;;;;;;;;;;;GAeG;AACH,MAAM,MAAM,SAAS,GAAG,CAAC,OAAO,WAAW,CAAC,CAAC,MAAM,OAAO,WAAW,CAAC,CAAC;AAEvE;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,qBAAa,eAAgB,SAAQ,KAAK;IAU/B,KAAK,CAAC,EAAE,MAAM;IACd,IAAI,CAAC,EAAE,MAAM;IAVtB;;;;;;OAMG;gBAED,OAAO,EAAE,MAAM,EACR,KAAK,CAAC,EAAE,MAAM,YAAA,EACd,IAAI,CAAC,EAAE,MAAM,YAAA;CAKvB;AAED,kFAAkF;AAClF,qBAAa,oBAAqB,SAAQ,eAAe;gBAC3C,OAAO,EAAE,MAAM;CAI5B;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,qBAAa,YAAa,SAAQ,KAAK;IAU5B,UAAU,CAAC,EAAE,MAAM;IACnB,aAAa,CAAC,EAAE,KAAK;IAV9B;;;;;;OAMG;gBAED,OAAO,EAAE,MAAM,EACR,UAAU,CAAC,EAAE,MAAM,YAAA,EACnB,aAAa,CAAC,EAAE,KAAK,YAAA;CAK/B;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,qBAAa,kBAAmB,SAAQ,KAAK;IASlC,KAAK,CAAC,EAAE,MAAM;IARvB;;;;;OAKG;gBAED,OAAO,EAAE,MAAM,EACR,KAAK,CAAC,EAAE,MAAM,YAAA;CAKxB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,qBAAa,gBAAiB,SAAQ,KAAK;IAUhC,aAAa,CAAC,EAAE,MAAM;IACtB,IAAI,CAAC,EAAE,MAAM;IAVtB;;;;;;OAMG;gBAED,OAAO,EAAE,MAAM,EACR,aAAa,CAAC,EAAE,MAAM,YAAA,EACtB,IAAI,CAAC,EAAE,MAAM,YAAA;CAKvB"}
@@ -4,8 +4,9 @@ import type { EIP712Domain, EIP712Types } from '../types/trade.dto';
4
4
  /**
5
5
  * HTTP client with optional signature authentication
6
6
  *
7
- * This client automatically adds the `Sign` header to every request
8
- * using wallet signatures generated by SignatureAuth when a wallet is configured.
7
+ * This client adds the `Sign` header to every request using wallet signatures generated by
8
+ * SignatureAuth when a wallet is configured and `signRequests` is on (the default). Clients for
9
+ * hosts other than the launchpad backend turn it off.
9
10
  *
10
11
  * In read-only mode (no wallet), the client skips authentication headers
11
12
  * and allows querying public data endpoints.
@@ -13,11 +14,22 @@ import type { EIP712Domain, EIP712Types } from '../types/trade.dto';
13
14
  export declare class HttpClient {
14
15
  private readonly axios;
15
16
  private readonly auth;
17
+ private readonly signRequests;
16
18
  private readonly debug;
17
19
  private readonly logger;
18
20
  private requestInterceptorId;
19
21
  private responseInterceptorId;
20
- constructor(auth: SignatureAuth | undefined, config?: SDKConfig);
22
+ /**
23
+ * @param auth Signature auth: the request signer for the launchpad backend, and the wallet identity
24
+ * (`getAddress`, `signTypedData`) other services read from this client
25
+ * @param config Base URL, timeout and headers
26
+ * @param options `signRequests: false` keeps the `Sign` header off every request. Only the launchpad
27
+ * backend authenticates with it; the GalaChain gateway, dex-api, the swap backend and the bundler
28
+ * ignore it, and signing each request costs a wallet signature (a prompt for browser wallets).
29
+ */
30
+ constructor(auth: SignatureAuth | undefined, config?: SDKConfig, options?: {
31
+ readonly signRequests: boolean;
32
+ });
21
33
  /**
22
34
  * Makes an authenticated HTTP request and returns body only (legacy default).
23
35
  *
@@ -1 +1 @@
1
- {"version":3,"file":"http.d.ts","sourceRoot":"","sources":["../../src/utils/http.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"http.d.ts","sourceRoot":"","sources":["../../src/utils/http.ts"],"names":[],"mappings":"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"}
@@ -3,7 +3,7 @@
3
3
  *
4
4
  * These convert FORMATS ONLY. A token class key carries no symbol and a symbol carries no class
5
5
  * key, so nothing here infers one from the other: a bare symbol is never expanded into a key.
6
- * For symbol/metadata use GalaChainService.fetchTokenClassFromChain() or DexService.fetchTokenDetails().
6
+ * For symbol/metadata use GalaChainService.fetchTokenClassFromChain() or GalaChainService.fetchTokenDetails().
7
7
  *
8
8
  * @packageDocumentation
9
9
  */
@@ -7,13 +7,13 @@
7
7
  * - Dollar with $ in collection: "$MUSIC$Unit$none$none" (parses from END)
8
8
  *
9
9
  * CRITICAL SECURITY NOTE:
10
- * Plain strings like "GALA" are REJECTED by default - they are not valid token formats!
11
- * Token formats MUST be explicitly delimited with | or $.
12
- * This prevents dangerous assumptions about token structure.
10
+ * Plain strings like "GALA" are not token formats: a caller detects the delimiter
11
+ * (`isPipeDelimited` / `isDollarDelimited`) and parses with the matching parser.
12
+ * The object guard for a token class key is gala-core-sdk's `isTokenClassKey`.
13
13
  *
14
14
  * @packageDocumentation
15
15
  */
16
- import type { TokenClassKey } from '../types/common';
16
+ import type { GalaChainTokenClassKey } from '@gala-chain/gala-core-sdk';
17
17
  /**
18
18
  * PERFORMANCE CHARACTERISTICS:
19
19
  *
@@ -21,10 +21,6 @@ import type { TokenClassKey } from '../types/common';
21
21
  * - Pipe-delimited tokens: Direct split() call, minimal string operations
22
22
  * - Dollar-delimited tokens: Reverse algorithm, ~2x string operations
23
23
  *
24
- * Slow-path (format detection):
25
- * - Plain strings without delimiters: Requires fallback logic
26
- * - Type validation: Object instanceof checks for already-parsed tokens
27
- *
28
24
  * Recommendation: Pre-detect format when parsing large token batches:
29
25
  * ```typescript
30
26
  * import { isPipeDelimited, isDollarDelimited } from './token-parser';
@@ -36,61 +32,12 @@ import type { TokenClassKey } from '../types/common';
36
32
  * }
37
33
  * ```
38
34
  */
39
- /**
40
- * Parse token from ANY format (pipe/dollar delimited) into TokenClassKey
41
- *
42
- * Accepts:
43
- * - Pipe format: "GALA|Unit|none|none"
44
- * - Dollar format: "GALA$Unit$none$none"
45
- * - Dollar with $ in collection: "$MUSIC$Unit$none$none"
46
- * - TokenClassKey objects: { collection, category, type, additionalKey }
47
- *
48
- * REJECTS:
49
- * - Plain strings like "GALA" (DANGEROUS - no delimiters!)
50
- * - Null/undefined values
51
- * - Invalid formats
52
- *
53
- * ⚠️ SECURITY ENFORCEMENT (v3.33.0+):
54
- * Plain token strings are NO LONGER accepted. All tokens must use explicit delimiters.
55
- * This is a breaking change to enforce secure token format validation.
56
- *
57
- * @param token Token string to parse
58
- * @returns TokenClassKey with { collection, category, type, additionalKey }
59
- * @throws ValidationError if format is invalid or if plain string is provided
60
- *
61
- * @example
62
- * ```typescript
63
- * // Pipe-delimited (RECOMMENDED)
64
- * parseToken("GALA|Unit|none|none")
65
- * // → { collection: "GALA", category: "Unit", type: "none", additionalKey: "none" }
66
- *
67
- * // Dollar-delimited
68
- * parseToken("GALA$Unit$none$none")
69
- * // → { collection: "GALA", category: "Unit", type: "none", additionalKey: "none" }
70
- *
71
- * // Dollar with $ in collection (EDGE CASE)
72
- * parseToken("$MUSIC$Unit$none$none")
73
- * // → { collection: "$MUSIC", category: "Unit", type: "none", additionalKey: "none" }
74
- *
75
- * // TokenClassKey object
76
- * parseToken({ collection: "GALA", category: "Unit", type: "none", additionalKey: "none" })
77
- * // → { collection: "GALA", category: "Unit", type: "none", additionalKey: "none" }
78
- *
79
- * // Plain string - PERMANENTLY REJECTED
80
- * parseToken("GALA") // Throws ValidationError
81
- * ```
82
- *
83
- * @since 3.32.0
84
- * @updated 3.33.0 - Removed allowPlainStrings parameter, enforce strict delimiter-only parsing
85
- */
86
- export declare function parseToken(token: string | TokenClassKey | undefined | null): TokenClassKey;
87
35
  /**
88
36
  * Parse pipe-delimited token: "GALA|Unit|none|none"
89
37
  *
90
- * @internal Used by parseToken()
91
38
  * @throws ValidationError if format is invalid
92
39
  */
93
- export declare function parsePipeDelimitedToken(token: string): TokenClassKey;
40
+ export declare function parsePipeDelimitedToken(token: string): GalaChainTokenClassKey;
94
41
  /**
95
42
  * REVERSE-PARSING ALGORITHM FOR DOLLAR-DELIMITED TOKENS
96
43
  *
@@ -140,10 +87,9 @@ export declare function parsePipeDelimitedToken(token: string): TokenClassKey;
140
87
  * - Last 3 parts (from right): category, type, additionalKey
141
88
  * - Everything else: collection
142
89
  *
143
- * @internal Used by parseToken()
144
90
  * @throws ValidationError if format is invalid
145
91
  */
146
- export declare function parseDollarDelimitedToken(token: string): TokenClassKey;
92
+ export declare function parseDollarDelimitedToken(token: string): GalaChainTokenClassKey;
147
93
  /**
148
94
  * Check if token string is in pipe-delimited format
149
95
  *
@@ -165,71 +111,4 @@ export declare function isPipeDelimited(token: string): boolean;
165
111
  * ```
166
112
  */
167
113
  export declare function isDollarDelimited(token: string): boolean;
168
- /**
169
- * Check if token is in ANY valid delimited format (pipe or dollar)
170
- *
171
- * @example
172
- * ```typescript
173
- * isDelimited("GALA|Unit|none|none") // → true
174
- * isDelimited("GALA$Unit$none$none") // → true
175
- * isDelimited("GALA") // → false
176
- * ```
177
- */
178
- export declare function isDelimited(token: string): boolean;
179
- /**
180
- * Check if a value is a valid token format (string OR TokenClassKey object)
181
- *
182
- * @param token Token to validate
183
- * @returns true if token is valid format (pipe/dollar delimited OR TokenClassKey object)
184
- *
185
- * @example
186
- * ```typescript
187
- * isValidTokenFormat("GALA|Unit|none|none") // → true
188
- * isValidTokenFormat("GALA$Unit$none$none") // → true
189
- * isValidTokenFormat({ collection: "GALA", ... }) // → true
190
- * isValidTokenFormat("GALA") // → false (plain string, not delimited)
191
- * ```
192
- */
193
- export declare function isValidTokenFormat(token: unknown): boolean;
194
- /**
195
- * Check if token is a plain symbol string (NOT a delimited format)
196
- *
197
- * Plain token symbols are simple strings like "GALA", "USDC", etc.
198
- * These are REJECTED by default by parseToken() for security reasons.
199
- * Use parseToken(symbol, true) to parse plain symbols.
200
- *
201
- * @param token Token to check
202
- * @returns true if token is plain symbol (no delimiters)
203
- *
204
- * @example
205
- * ```typescript
206
- * isPlainTokenSymbol("GALA") // → true
207
- * isPlainTokenSymbol("GALA|Unit|none|none") // → false
208
- * isPlainTokenSymbol("GALA$Unit$none$none") // → false
209
- * ```
210
- *
211
- * @security WARNING: Plain tokens are inherently ambiguous!
212
- * Always use delimited formats when possible.
213
- */
214
- export declare function isPlainTokenSymbol(token: unknown): boolean;
215
- /**
216
- * Type guard: Check if value is a TokenClassKey object
217
- *
218
- * @param token Value to check
219
- * @returns true if token is a valid TokenClassKey object with all required properties
220
- *
221
- * @example
222
- * ```typescript
223
- * const value: string | TokenClassKey = getToken();
224
- *
225
- * if (isTokenClassKey(value)) {
226
- * // TypeScript now knows value is TokenClassKey
227
- * console.log(value.collection, value.category, value.type, value.additionalKey);
228
- * } else {
229
- * // value is string
230
- * console.log(parseToken(value));
231
- * }
232
- * ```
233
- */
234
- export declare function isTokenClassKey(token: unknown): token is TokenClassKey;
235
114
  //# sourceMappingURL=token-parser.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"token-parser.d.ts","sourceRoot":"","sources":["../../src/utils/token-parser.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AASrD;;;;;;;;;;;;;;;;;;;;;GAqBG;AAEH;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8CG;AACH,wBAAgB,UAAU,CACxB,KAAK,EAAE,MAAM,GAAG,aAAa,GAAG,SAAS,GAAG,IAAI,GAC/C,aAAa,CAyCf;AAED;;;;;GAKG;AACH,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,MAAM,GAAG,aAAa,CAGpE;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsCG;AAEH;;;;;;;;;;;;GAYG;AACH,wBAAgB,yBAAyB,CAAC,KAAK,EAAE,MAAM,GAAG,aAAa,CAGtE;AAGD;;;;;;;;GAQG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAEtD;AAED;;;;;;;;;GASG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAExD;AAED;;;;;;;;;GASG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAElD;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAe1D;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAE1D;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,aAAa,CAqBtE"}
1
+ {"version":3,"file":"token-parser.d.ts","sourceRoot":"","sources":["../../src/utils/token-parser.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,2BAA2B,CAAC;AAOxE;;;;;;;;;;;;;;;;;GAiBG;AAEH;;;;GAIG;AACH,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,MAAM,GAAG,sBAAsB,CAG7E;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsCG;AAEH;;;;;;;;;;;GAWG;AACH,wBAAgB,yBAAyB,CAAC,KAAK,EAAE,MAAM,GAAG,sBAAsB,CAG/E;AAGD;;;;;;;;GAQG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAEtD;AAED;;;;;;;;;GASG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAExD"}
@@ -4,7 +4,7 @@
4
4
  * @category Utilities
5
5
  * @since 6.6.0
6
6
  */
7
- import type { TokenClassKey, TokenInstanceKey } from '../types/common';
7
+ import type { GalaChainTokenClassKey, GalaChainTokenInstanceKey } from '@gala-chain/gala-core-sdk';
8
8
  /**
9
9
  * Convert a TokenClassKey to pipe-delimited string format
10
10
  *
@@ -37,7 +37,7 @@ import type { TokenClassKey, TokenInstanceKey } from '../types/common';
37
37
  *
38
38
  * @since 6.6.0
39
39
  */
40
- export declare function stringifyTokenClassKey(token: TokenClassKey): string;
40
+ export declare function stringifyTokenClassKey(token: GalaChainTokenClassKey): string;
41
41
  /**
42
42
  * Convert a TokenInstanceKey to pipe-delimited string format (with instance)
43
43
  *
@@ -63,7 +63,7 @@ export declare function stringifyTokenClassKey(token: TokenClassKey): string;
63
63
  *
64
64
  * @since 6.6.0
65
65
  */
66
- export declare function stringifyTokenInstanceKey(token: TokenInstanceKey): string;
66
+ export declare function stringifyTokenInstanceKey(token: GalaChainTokenInstanceKey): string;
67
67
  /**
68
68
  * Convert either TokenClassKey or TokenInstanceKey to string
69
69
  *
@@ -88,7 +88,7 @@ export declare function stringifyTokenInstanceKey(token: TokenInstanceKey): stri
88
88
  *
89
89
  * @since 6.6.0
90
90
  */
91
- export declare function stringifyToken(token: TokenClassKey | TokenInstanceKey): string;
91
+ export declare function stringifyToken(token: GalaChainTokenClassKey | GalaChainTokenInstanceKey): string;
92
92
  /**
93
93
  * Convert TokenClassKey to dollar-delimited string format
94
94
  *
@@ -113,7 +113,7 @@ export declare function stringifyToken(token: TokenClassKey | TokenInstanceKey):
113
113
  *
114
114
  * @since 6.7.0
115
115
  */
116
- export declare function stringifyTokenClassKeyDollar(token: TokenClassKey): string;
116
+ export declare function stringifyTokenClassKeyDollar(token: GalaChainTokenClassKey): string;
117
117
  /**
118
118
  * Convert TokenInstanceKey to dollar-delimited string format (with instance)
119
119
  *
@@ -139,7 +139,7 @@ export declare function stringifyTokenClassKeyDollar(token: TokenClassKey): stri
139
139
  *
140
140
  * @since 6.7.0
141
141
  */
142
- export declare function stringifyTokenInstanceKeyDollar(token: TokenInstanceKey): string;
142
+ export declare function stringifyTokenInstanceKeyDollar(token: GalaChainTokenInstanceKey): string;
143
143
  /**
144
144
  * Convert TokenClassKey to dollar-delimited string format with prefix
145
145
  *
@@ -163,5 +163,5 @@ export declare function stringifyTokenInstanceKeyDollar(token: TokenInstanceKey)
163
163
  *
164
164
  * @since 6.7.0
165
165
  */
166
- export declare function stringifyTokenClassKeyDollarPrefixed(token: TokenClassKey): string;
166
+ export declare function stringifyTokenClassKeyDollarPrefixed(token: GalaChainTokenClassKey): string;
167
167
  //# sourceMappingURL=token-stringification.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"token-stringification.d.ts","sourceRoot":"","sources":["../../src/utils/token-stringification.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAEvE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AACH,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,aAAa,GAAG,MAAM,CAEnE;AAED;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,wBAAgB,yBAAyB,CAAC,KAAK,EAAE,gBAAgB,GAAG,MAAM,CAEzE;AAED;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,aAAa,GAAG,gBAAgB,GAAG,MAAM,CAK9E;AAED;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAgB,4BAA4B,CAAC,KAAK,EAAE,aAAa,GAAG,MAAM,CAEzE;AAED;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,wBAAgB,+BAA+B,CAAC,KAAK,EAAE,gBAAgB,GAAG,MAAM,CAE/E;AAED;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAgB,oCAAoC,CAAC,KAAK,EAAE,aAAa,GAAG,MAAM,CAEjF"}
1
+ {"version":3,"file":"token-stringification.d.ts","sourceRoot":"","sources":["../../src/utils/token-stringification.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,sBAAsB,EAAE,yBAAyB,EAAE,MAAM,2BAA2B,CAAC;AAEnG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AACH,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,sBAAsB,GAAG,MAAM,CAE5E;AAED;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,wBAAgB,yBAAyB,CAAC,KAAK,EAAE,yBAAyB,GAAG,MAAM,CAElF;AAED;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,sBAAsB,GAAG,yBAAyB,GAAG,MAAM,CAKhG;AAED;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAgB,4BAA4B,CAAC,KAAK,EAAE,sBAAsB,GAAG,MAAM,CAElF;AAED;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,wBAAgB,+BAA+B,CAAC,KAAK,EAAE,yBAAyB,GAAG,MAAM,CAExF;AAED;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAgB,oCAAoC,CAAC,KAAK,EAAE,sBAAsB,GAAG,MAAM,CAE1F"}
@@ -35,8 +35,8 @@ export declare function normalizeTokenName(tokenName: string): string;
35
35
  /**
36
36
  * Normalizes a token identifier for consistent cache keys.
37
37
  *
38
- * Used by cache services (BridgeableTokenCache, WrappableTokenCache) for
39
- * case-insensitive lookups of token symbols and tokenIds.
38
+ * Used by the cache services (AbstractCacheService) for case-insensitive lookups of token
39
+ * symbols and tokenIds.
40
40
  *
41
41
  * Current normalizations:
42
42
  * - `.trim()` - Remove leading/trailing whitespace