@gala-chain/launchpad-sdk 3.31.2 → 4.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 (86) hide show
  1. package/API.md +524 -4
  2. package/CHANGELOG.md +92 -0
  3. package/EXAMPLES.md +845 -0
  4. package/README.md +421 -14
  5. package/dist/LaunchpadSDK.d.ts +435 -18
  6. package/dist/LaunchpadSDK.d.ts.map +1 -1
  7. package/dist/api/LaunchpadAPI.d.ts.map +1 -1
  8. package/dist/constants/version.generated.d.ts +1 -1
  9. package/dist/constants/version.generated.d.ts.map +1 -1
  10. package/dist/index.cjs.js +1 -1
  11. package/dist/index.d.ts +10 -3
  12. package/dist/index.d.ts.map +1 -1
  13. package/dist/index.esm.js +1 -1
  14. package/dist/index.js +1 -1
  15. package/dist/services/CommentService.d.ts.map +1 -1
  16. package/dist/services/DexBackendClient.d.ts +46 -0
  17. package/dist/services/DexBackendClient.d.ts.map +1 -0
  18. package/dist/services/DexPoolService.d.ts +54 -12
  19. package/dist/services/DexPoolService.d.ts.map +1 -1
  20. package/dist/services/DexQuoteService.d.ts +288 -0
  21. package/dist/services/DexQuoteService.d.ts.map +1 -0
  22. package/dist/services/GSwapService.d.ts +468 -38
  23. package/dist/services/GSwapService.d.ts.map +1 -1
  24. package/dist/services/GalaChainGatewayClient.d.ts +89 -0
  25. package/dist/services/GalaChainGatewayClient.d.ts.map +1 -0
  26. package/dist/services/GalaChainService.d.ts +26 -0
  27. package/dist/services/GalaChainService.d.ts.map +1 -1
  28. package/dist/services/PoolStateManager.d.ts +176 -0
  29. package/dist/services/PoolStateManager.d.ts.map +1 -0
  30. package/dist/services/SignatureService.d.ts +13 -35
  31. package/dist/services/SignatureService.d.ts.map +1 -1
  32. package/dist/services/WebSocketService.d.ts +98 -0
  33. package/dist/services/WebSocketService.d.ts.map +1 -1
  34. package/dist/services/__mocks__/logger.mock.d.ts +17 -0
  35. package/dist/services/__mocks__/logger.mock.d.ts.map +1 -0
  36. package/dist/types/common.d.ts +2 -0
  37. package/dist/types/common.d.ts.map +1 -1
  38. package/dist/types/composite-pool.dto.d.ts +103 -0
  39. package/dist/types/composite-pool.dto.d.ts.map +1 -0
  40. package/dist/types/dex-pool.dto.d.ts +56 -5
  41. package/dist/types/dex-pool.dto.d.ts.map +1 -1
  42. package/dist/types/dto.d.ts +6 -6
  43. package/dist/types/dto.d.ts.map +1 -1
  44. package/dist/types/eip712-types.d.ts +140 -0
  45. package/dist/types/eip712-types.d.ts.map +1 -0
  46. package/dist/types/galachain-api.types.d.ts +206 -0
  47. package/dist/types/galachain-api.types.d.ts.map +1 -0
  48. package/dist/types/gswap-responses.types.d.ts +366 -0
  49. package/dist/types/gswap-responses.types.d.ts.map +1 -0
  50. package/dist/types/gswap.dto.d.ts +58 -3
  51. package/dist/types/gswap.dto.d.ts.map +1 -1
  52. package/dist/types/launchpad.dto.d.ts +57 -0
  53. package/dist/types/launchpad.dto.d.ts.map +1 -1
  54. package/dist/types/pool-state-delta.dto.d.ts +246 -0
  55. package/dist/types/pool-state-delta.dto.d.ts.map +1 -0
  56. package/dist/types/pool-state-manager-config.dto.d.ts +103 -0
  57. package/dist/types/pool-state-manager-config.dto.d.ts.map +1 -0
  58. package/dist/utils/auto-pagination.d.ts +74 -0
  59. package/dist/utils/auto-pagination.d.ts.map +1 -1
  60. package/dist/utils/bignumber-helpers.d.ts +75 -3
  61. package/dist/utils/bignumber-helpers.d.ts.map +1 -1
  62. package/dist/utils/bignumber-pool-cache.d.ts +169 -0
  63. package/dist/utils/bignumber-pool-cache.d.ts.map +1 -0
  64. package/dist/utils/composite-pool-converter.d.ts +121 -0
  65. package/dist/utils/composite-pool-converter.d.ts.map +1 -0
  66. package/dist/utils/errors.d.ts +86 -0
  67. package/dist/utils/errors.d.ts.map +1 -1
  68. package/dist/utils/http.d.ts.map +1 -1
  69. package/dist/utils/load-env.d.ts +31 -0
  70. package/dist/utils/load-env.d.ts.map +1 -0
  71. package/dist/utils/pool-pair-parser.d.ts +55 -0
  72. package/dist/utils/pool-pair-parser.d.ts.map +1 -0
  73. package/dist/utils/pool-state-validator.d.ts +207 -0
  74. package/dist/utils/pool-state-validator.d.ts.map +1 -0
  75. package/dist/utils/position-filters.d.ts +253 -0
  76. package/dist/utils/position-filters.d.ts.map +1 -0
  77. package/dist/utils/swap-delta-calculator.d.ts +231 -0
  78. package/dist/utils/swap-delta-calculator.d.ts.map +1 -0
  79. package/dist/utils/tick-crossing-handler.d.ts +250 -0
  80. package/dist/utils/tick-crossing-handler.d.ts.map +1 -0
  81. package/dist/utils/token-format-converter.d.ts +10 -3
  82. package/dist/utils/token-format-converter.d.ts.map +1 -1
  83. package/dist/utils/token-parser.d.ts +235 -0
  84. package/dist/utils/token-parser.d.ts.map +1 -0
  85. package/dist/utils/transfer-validation.d.ts.map +1 -1
  86. package/package.json +36 -15
package/dist/index.d.ts CHANGED
@@ -14,24 +14,31 @@ import './polyfills/file-global.js';
14
14
  export { LaunchpadSDK, type LaunchpadSDKConfig, WebSocketError, WebSocketTimeoutError, TransactionFailedError } from './LaunchpadSDK';
15
15
  export { createLaunchpadSDK } from './helpers/sdk';
16
16
  export { createWallet } from './helpers/wallet';
17
+ export { loadEnvWithFallback, getEnvOrThrow, getEnv, } from './utils/load-env';
17
18
  export { AgentConfig, type AgentSDKConfig, type AgentEnvironment, type SetupValidation, } from './utils/agent-config';
18
- export { ValidationError, NetworkError, ConfigurationError, TransactionError, GSwapQuoteError, GSwapSwapError, GSwapPoolError, GSwapAssetError, } from './utils/errors';
19
+ export { ValidationError, NetworkError, ConfigurationError, TransactionError, GSwapQuoteError, GSwapSwapError, GSwapPoolError, GSwapAssetError, DexQuoteError, DexPoolNotFoundError, } from './utils/errors';
19
20
  export { FileValidationError } from './utils/multipart';
20
21
  export { formatGalaForDTO, formatLaunchpadTokenForDTO } from './utils/number-utils';
22
+ export { requirePositive, requireNonNegative, requirePositiveWithContext, } from './utils/bignumber-helpers';
23
+ export { filterByLiquidity, filterByMinLiquidity, filterByTokenPair, filterByToken, filterByFeeTier, filterByPoolKey, sortByLiquidity, groupByTokenPair, groupByFeeTier, groupByPoolKey, type SortOrder, type PositionFilter, type PositionFilterOptions, } from './utils/position-filters';
21
24
  export { TRADING_TYPES, POOL_TYPES, CALCULATION_MODES } from './constants/enums';
22
25
  export { MAX_CONCURRENT_POOL_FETCHES } from './constants/config';
23
26
  export { GALA_DECIMALS, LAUNCHPAD_TOKEN_DECIMALS, GALA_TOKEN_CLASS_KEY } from './constants/decimals';
24
27
  export { PAGINATION_DEFAULTS, POOL_FETCH_CONFIG } from './constants/pagination';
25
28
  export { QUERY_FIELD_NAMES } from './constants/query-fields';
26
29
  export type { SDKConfig, TokenClassKey, TokenInstanceKey, TokenId, } from './types/common';
27
- export type { PoolData, LaunchTokenData, ReverseBondingCurveConfiguration, FetchPoolsOptions, PoolsResult, AmountCalculationResult, GraphDataResult, TokenDistributionResult, TokenBadgesResult, TokenSpotPrice, TokenDetails, } from './types/launchpad.dto';
30
+ export type { PoolData, LaunchTokenData, ReverseBondingCurveConfiguration, FetchPoolsOptions, PoolsResult, AmountCalculationResult, GraphDataResult, TokenDistributionResult, TokenBadgesResult, TokenSpotPrice, TokenDetails, TokenClassWithSupply, } from './types/launchpad.dto';
28
31
  export type { PoolDetailsData, TradesResult, } from './types/trade.dto';
29
32
  export type { UserTokenType, TransferFaucetsData, TokenBalanceInfo, UpdateProfileData, FetchGalaBalanceOptions, FetchTokenBalanceOptions, UploadProfileImageOptions, TokenBalanceResult, UserTokenListResult, } from './types/user.dto';
30
33
  export type { CommentsResult, } from './types/comment.dto';
31
34
  export type { FetchPriceHistoryOptions, PriceSnapshot, PriceHistoryResult, PriceSortOrder, } from './types/priceHistory.dto';
32
35
  export type { DexPoolData, DexPoolSortBy, DexPoolSortOrder, FetchDexPoolsOptions, DexPoolsResult, } from './types/dex-pool.dto';
36
+ export type { FetchCompositePoolDataOptions, CompositePoolDataResult, CalculateDexPoolQuoteOptions, DexPoolQuoteResult, } from './types/composite-pool.dto';
37
+ export { COMPOSITE_POOL_FETCH_CONCURRENCY } from './services/DexQuoteService';
38
+ export type { SwapEventData, SwapDeltaResult, PoolStateMetadata, PoolStateValidationResult, InternalSwapState, SwapStepResult, TickCrossingEvent, } from './types/pool-state-delta.dto';
39
+ export { PoolStateManager, type PoolStateManagerConfig, createPoolStateManager, } from './services/PoolStateManager';
33
40
  export type { TransferGalaData, TransferTokenData, TransferError, TransferErrorType, } from './types/transfer.dto';
34
- export type { SwapQuoteParams, SwapQuoteResult, ExecuteSwapParams, ExecuteSwapResult, UserAsset, PoolInfo, GSwapServiceConfig, } from './types/gswap.dto';
41
+ export type { SwapQuoteParams, SwapQuoteResult, ExecuteSwapParams, ExecuteSwapResult, UserAsset, PoolInfo, GSwapServiceConfig, PoolSlot0Data, PoolPriceData, GetLiquidityPositionsOptions, PositionPoolPrice, GetLiquidityPositionsResult, } from './types/gswap.dto';
35
42
  export { TokenMetadataService, type TokenMetadata, type TokenMetadataCache, } from './services/TokenMetadataService';
36
43
  export type { FetchVolumeDataOptions, FetchTradesOptions, FetchCommentsOptions, PostCommentOptions, CalculateBuyAmountOptions, CalculateSellAmountOptions, BuyTokenOptions, SellTokenOptions, UploadImageByTokenNameOptions, FetchTokensHeldOptions, FetchTokensCreatedOptions, GraduateTokenOptions, FetchLaunchpadTokenSpotPriceOptions, CalculateBuyAmountForGraduationOptions, } from './types/options.dto';
37
44
  export type { BaseTransactionResult, TokenLaunchResult, TradeResult, TransferResult, CommentResult, TransactionResult, } from './types/result.types';
@@ -1 +1 @@
1
- {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}