@gala-chain/launchpad-sdk 8.1.0 → 9.0.0-rc.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.
- package/CHANGELOG.md +837 -0
- package/EXAMPLES.md +95 -681
- package/MIGRATING-TO-9.0.md +343 -0
- package/README.md +46 -17
- package/dist/LaunchpadSDK.d.ts +536 -616
- package/dist/LaunchpadSDK.d.ts.map +1 -1
- package/dist/api/LaunchpadAPI.d.ts +6 -176
- package/dist/api/LaunchpadAPI.d.ts.map +1 -1
- package/dist/auth/SessionAuthService.d.ts +32 -2
- package/dist/auth/SessionAuthService.d.ts.map +1 -1
- package/dist/auth/SignatureAuth.d.ts +2 -2
- package/dist/auth/SignatureAuth.d.ts.map +1 -1
- package/dist/auth/session.d.ts +59 -0
- package/dist/auth/session.d.ts.map +1 -0
- package/dist/auth/types.d.ts +7 -2
- package/dist/auth/types.d.ts.map +1 -1
- package/dist/config/environments.d.ts +7 -2
- package/dist/config/environments.d.ts.map +1 -1
- package/dist/constants/decimals.d.ts +0 -23
- package/dist/constants/decimals.d.ts.map +1 -1
- package/dist/constants/endpoints.d.ts +19 -8
- package/dist/constants/endpoints.d.ts.map +1 -1
- package/dist/constants/enums.d.ts +19 -0
- package/dist/constants/enums.d.ts.map +1 -1
- package/dist/constants/version.generated.d.ts +1 -1
- package/dist/constants/version.generated.d.ts.map +1 -1
- package/dist/errors/LaunchpadSDKError.d.ts +18 -0
- package/dist/errors/LaunchpadSDKError.d.ts.map +1 -1
- package/dist/helpers/sdk.d.ts.map +1 -1
- package/dist/index.browser.d.ts +40 -45
- package/dist/index.browser.d.ts.map +1 -1
- package/dist/index.browser.esm.js +1 -1
- package/dist/index.cjs +1 -1
- package/dist/index.esm.js +1 -1
- package/dist/index.js +1 -1
- package/dist/index.node.d.ts +4 -5
- package/dist/index.node.d.ts.map +1 -1
- package/dist/launchpad/bundle-submission.d.ts +57 -10
- package/dist/launchpad/bundle-submission.d.ts.map +1 -1
- package/dist/launchpad/create-sale-validation.d.ts +19 -0
- package/dist/launchpad/create-sale-validation.d.ts.map +1 -0
- package/dist/launchpad/transport.d.ts +33 -2
- package/dist/launchpad/transport.d.ts.map +1 -1
- package/dist/launchpad/writes.d.ts +37 -11
- package/dist/launchpad/writes.d.ts.map +1 -1
- package/dist/native.cjs +1 -1
- package/dist/native.d.ts +4 -5
- package/dist/native.d.ts.map +1 -1
- package/dist/native.esm.js +1 -1
- package/dist/schemas/launchpad.d.ts +3 -2
- package/dist/schemas/launchpad.d.ts.map +1 -1
- package/dist/schemas/primitives.d.ts +12 -2
- package/dist/schemas/primitives.d.ts.map +1 -1
- package/dist/schemas/user.d.ts +3 -18
- package/dist/schemas/user.d.ts.map +1 -1
- package/dist/schemas/validators.d.ts +3 -3
- package/dist/services/AbstractCacheService.d.ts +2 -2
- package/dist/services/ApiKeyService.d.ts +1 -1
- package/dist/services/BanService.d.ts +1 -1
- package/dist/services/ChartService.d.ts.map +1 -1
- package/dist/services/ContentReactionService.d.ts +6 -18
- package/dist/services/ContentReactionService.d.ts.map +1 -1
- package/dist/services/EventsQueryService.d.ts +47 -0
- package/dist/services/EventsQueryService.d.ts.map +1 -0
- package/dist/services/GalaChainBalanceService.d.ts +17 -89
- package/dist/services/GalaChainBalanceService.d.ts.map +1 -1
- package/dist/services/GalaChainLockService.d.ts +19 -20
- package/dist/services/GalaChainLockService.d.ts.map +1 -1
- package/dist/services/GalaChainService.d.ts +28 -15
- package/dist/services/GalaChainService.d.ts.map +1 -1
- package/dist/services/GalaChainTokenService.d.ts +25 -53
- package/dist/services/GalaChainTokenService.d.ts.map +1 -1
- package/dist/services/GalaChainTransferService.d.ts +42 -41
- package/dist/services/GalaChainTransferService.d.ts.map +1 -1
- package/dist/services/HealthService.d.ts +33 -0
- package/dist/services/HealthService.d.ts.map +1 -0
- package/dist/services/ImageService.d.ts +3 -3
- package/dist/services/ImageService.d.ts.map +1 -1
- package/dist/services/LaunchpadPriceService.d.ts +66 -0
- package/dist/services/LaunchpadPriceService.d.ts.map +1 -0
- package/dist/services/LaunchpadService.d.ts +34 -42
- package/dist/services/LaunchpadService.d.ts.map +1 -1
- package/dist/services/MessagesService.d.ts +12 -44
- package/dist/services/MessagesService.d.ts.map +1 -1
- package/dist/services/ModeratorService.d.ts +2 -2
- package/dist/services/ModeratorService.d.ts.map +1 -1
- package/dist/services/NftCollectionService.d.ts +22 -6
- package/dist/services/NftCollectionService.d.ts.map +1 -1
- package/dist/services/OverseerService.d.ts +3 -3
- package/dist/services/OverseerService.d.ts.map +1 -1
- package/dist/services/PlatformStatsService.d.ts +1 -2
- package/dist/services/PlatformStatsService.d.ts.map +1 -1
- package/dist/services/PoolService.d.ts +28 -65
- package/dist/services/PoolService.d.ts.map +1 -1
- package/dist/services/RestrictedNamesService.d.ts +1 -1
- package/dist/services/RestrictedNamesService.d.ts.map +1 -1
- package/dist/services/StreamChatService.d.ts +8 -19
- package/dist/services/StreamChatService.d.ts.map +1 -1
- package/dist/services/StreamTokenServiceBase.d.ts +2 -1
- package/dist/services/StreamTokenServiceBase.d.ts.map +1 -1
- package/dist/services/StreamWebSocketService.d.ts +423 -451
- package/dist/services/StreamWebSocketService.d.ts.map +1 -1
- package/dist/services/StreamingService.d.ts +14 -15
- package/dist/services/StreamingService.d.ts.map +1 -1
- package/dist/services/TokenBanService.d.ts +1 -1
- package/dist/services/TokenResolverService.d.ts +5 -5
- package/dist/services/TokenResolverService.d.ts.map +1 -1
- package/dist/services/TradeService.d.ts +13 -9
- package/dist/services/TradeService.d.ts.map +1 -1
- package/dist/services/TradingQuotesService.d.ts.map +1 -1
- package/dist/services/UserService.d.ts +64 -20
- package/dist/services/UserService.d.ts.map +1 -1
- package/dist/services/gateway-transport.d.ts +32 -0
- package/dist/services/gateway-transport.d.ts.map +1 -0
- package/dist/services/gateway-writes.d.ts +83 -0
- package/dist/services/gateway-writes.d.ts.map +1 -0
- package/dist/services/realtime/event-catalog.d.ts +456 -0
- package/dist/services/realtime/event-catalog.d.ts.map +1 -0
- package/dist/services/shared/pagination-helpers.d.ts +22 -5
- package/dist/services/shared/pagination-helpers.d.ts.map +1 -1
- package/dist/services/shared/service-validators.d.ts.map +1 -1
- package/dist/signing/index.d.ts +2 -3
- package/dist/signing/index.d.ts.map +1 -1
- package/dist/signing/signers.d.ts +64 -9
- package/dist/signing/signers.d.ts.map +1 -1
- package/dist/signing/types.d.ts +7 -10
- package/dist/signing/types.d.ts.map +1 -1
- package/dist/types/api-key.dto.d.ts +1 -1
- package/dist/types/ban.dto.d.ts +21 -16
- package/dist/types/ban.dto.d.ts.map +1 -1
- package/dist/types/burn.dto.d.ts +4 -2
- package/dist/types/burn.dto.d.ts.map +1 -1
- package/dist/types/chat-messages.dto.d.ts +10 -72
- package/dist/types/chat-messages.dto.d.ts.map +1 -1
- package/dist/types/comments.dto.d.ts +8 -78
- package/dist/types/comments.dto.d.ts.map +1 -1
- package/dist/types/common.d.ts +42 -85
- package/dist/types/common.d.ts.map +1 -1
- package/dist/types/constraints.d.ts +47 -23
- package/dist/types/constraints.d.ts.map +1 -1
- package/dist/types/content-flag.dto.d.ts +5 -1
- package/dist/types/content-flag.dto.d.ts.map +1 -1
- package/dist/types/content-reactions.dto.d.ts +0 -4
- package/dist/types/content-reactions.dto.d.ts.map +1 -1
- package/dist/types/dto.d.ts +0 -5
- package/dist/types/dto.d.ts.map +1 -1
- package/dist/types/engagement-stats.dto.d.ts +16 -27
- package/dist/types/engagement-stats.dto.d.ts.map +1 -1
- package/dist/types/events.dto.d.ts +89 -0
- package/dist/types/events.dto.d.ts.map +1 -1
- package/dist/types/global-feed.dto.d.ts +23 -164
- package/dist/types/global-feed.dto.d.ts.map +1 -1
- package/dist/types/health.dto.d.ts +32 -0
- package/dist/types/health.dto.d.ts.map +1 -0
- package/dist/types/launchpad.dto.d.ts +77 -323
- package/dist/types/launchpad.dto.d.ts.map +1 -1
- package/dist/types/lock.dto.d.ts +12 -7
- package/dist/types/lock.dto.d.ts.map +1 -1
- package/dist/types/messages.dto.d.ts +168 -118
- package/dist/types/messages.dto.d.ts.map +1 -1
- package/dist/types/moderator.dto.d.ts +1 -1
- package/dist/types/options.dto.d.ts +8 -36
- package/dist/types/options.dto.d.ts.map +1 -1
- package/dist/types/overseer.dto.d.ts +2 -1
- package/dist/types/overseer.dto.d.ts.map +1 -1
- package/dist/types/platform-stats.dto.d.ts +3 -3
- package/dist/types/realtime-events.dto.d.ts +340 -0
- package/dist/types/realtime-events.dto.d.ts.map +1 -0
- package/dist/types/restricted-names.dto.d.ts +2 -2
- package/dist/types/restricted-names.dto.d.ts.map +1 -1
- package/dist/types/stream-chat.dto.d.ts +15 -14
- package/dist/types/stream-chat.dto.d.ts.map +1 -1
- package/dist/types/streaming.dto.d.ts +73 -104
- package/dist/types/streaming.dto.d.ts.map +1 -1
- package/dist/types/token-ban.dto.d.ts.map +1 -1
- package/dist/types/token-config.dto.d.ts +34 -19
- package/dist/types/token-config.dto.d.ts.map +1 -1
- package/dist/types/trades-query.dto.d.ts +8 -24
- package/dist/types/trades-query.dto.d.ts.map +1 -1
- package/dist/types/user.dto.d.ts +133 -112
- package/dist/types/user.dto.d.ts.map +1 -1
- package/dist/types/websocket-events.dto.d.ts +5 -5
- package/dist/types/websocket-events.dto.d.ts.map +1 -1
- package/dist/utils/address-formatter.d.ts +25 -2
- package/dist/utils/address-formatter.d.ts.map +1 -1
- package/dist/utils/agent-config.d.ts +9 -4
- package/dist/utils/agent-config.d.ts.map +1 -1
- package/dist/utils/auto-pagination.d.ts +7 -240
- package/dist/utils/auto-pagination.d.ts.map +1 -1
- package/dist/utils/bignumber-helpers.d.ts +3 -2
- package/dist/utils/bignumber-helpers.d.ts.map +1 -1
- package/dist/utils/delimiter-parser.d.ts +0 -13
- package/dist/utils/delimiter-parser.d.ts.map +1 -1
- package/dist/utils/error-factories.d.ts +4 -3
- package/dist/utils/error-factories.d.ts.map +1 -1
- package/dist/utils/error-patterns.d.ts +0 -47
- package/dist/utils/error-patterns.d.ts.map +1 -1
- package/dist/utils/error-wrapper.d.ts +5 -5
- package/dist/utils/errors.d.ts +53 -318
- package/dist/utils/errors.d.ts.map +1 -1
- package/dist/utils/http.d.ts +36 -3
- package/dist/utils/http.d.ts.map +1 -1
- package/dist/utils/message-validators.d.ts.map +1 -1
- package/dist/utils/pagination-helpers.d.ts +17 -0
- package/dist/utils/pagination-helpers.d.ts.map +1 -1
- package/dist/utils/pagination-validation.d.ts +2 -2
- package/dist/utils/response-handlers.d.ts.map +1 -1
- package/dist/utils/service-validators.d.ts +6 -6
- package/dist/utils/service-validators.d.ts.map +1 -1
- package/dist/utils/token-format-converter.d.ts +1 -1
- package/dist/utils/token-parser.d.ts +6 -127
- package/dist/utils/token-parser.d.ts.map +1 -1
- package/dist/utils/token-stringification.d.ts +7 -7
- package/dist/utils/token-stringification.d.ts.map +1 -1
- package/dist/utils/tokenNameNormalizer.d.ts +2 -2
- package/dist/utils/tokenNormalizer.d.ts +5 -29
- package/dist/utils/tokenNormalizer.d.ts.map +1 -1
- package/dist/utils/unique-key-generator.d.ts +7 -134
- package/dist/utils/unique-key-generator.d.ts.map +1 -1
- package/dist/utils/validation-helpers.d.ts +21 -64
- package/dist/utils/validation-helpers.d.ts.map +1 -1
- package/dist/utils/validation.d.ts +4 -1
- package/dist/utils/validation.d.ts.map +1 -1
- package/package.json +47 -87
- package/dist/api/dto/BurnTokensDto.d.ts +0 -77
- package/dist/api/dto/BurnTokensDto.d.ts.map +0 -1
- package/dist/api/dto/LockTokenDto.d.ts +0 -85
- package/dist/api/dto/LockTokenDto.d.ts.map +0 -1
- package/dist/api/dto/TransferTokenDto.d.ts +0 -64
- package/dist/api/dto/TransferTokenDto.d.ts.map +0 -1
- package/dist/api/dto/UnlockTokenDto.d.ts +0 -74
- package/dist/api/dto/UnlockTokenDto.d.ts.map +0 -1
- package/dist/bridge/BridgeService.d.ts +0 -484
- package/dist/bridge/BridgeService.d.ts.map +0 -1
- package/dist/bridge/GalaConnectClient.d.ts +0 -170
- package/dist/bridge/GalaConnectClient.d.ts.map +0 -1
- package/dist/bridge/constants/index.d.ts +0 -7
- package/dist/bridge/constants/index.d.ts.map +0 -1
- package/dist/bridge/constants/tokens.d.ts +0 -212
- package/dist/bridge/constants/tokens.d.ts.map +0 -1
- package/dist/bridge/index.d.ts +0 -24
- package/dist/bridge/index.d.ts.map +0 -1
- package/dist/bridge/public-types.d.ts +0 -2
- package/dist/bridge/public-types.d.ts.map +0 -1
- package/dist/bridge/strategies/BridgeStrategy.d.ts +0 -204
- package/dist/bridge/strategies/BridgeStrategy.d.ts.map +0 -1
- package/dist/bridge/strategies/EthereumBridgeStrategy.d.ts +0 -178
- package/dist/bridge/strategies/EthereumBridgeStrategy.d.ts.map +0 -1
- package/dist/bridge/strategies/SolanaBridgeStrategy.d.ts +0 -236
- package/dist/bridge/strategies/SolanaBridgeStrategy.d.ts.map +0 -1
- package/dist/bridge/types/bridge.dto.d.ts +0 -772
- package/dist/bridge/types/bridge.dto.d.ts.map +0 -1
- package/dist/bridge/types/bridgeable-token.dto.d.ts +0 -209
- package/dist/bridge/types/bridgeable-token.dto.d.ts.map +0 -1
- package/dist/bridge/types/eip712.d.ts +0 -66
- package/dist/bridge/types/eip712.d.ts.map +0 -1
- package/dist/bridge/types/index.d.ts +0 -8
- package/dist/bridge/types/index.d.ts.map +0 -1
- package/dist/bridge/utils/RateLimiter.d.ts +0 -34
- package/dist/bridge/utils/RateLimiter.d.ts.map +0 -1
- package/dist/bridge/utils/address-formatter.d.ts +0 -25
- package/dist/bridge/utils/address-formatter.d.ts.map +0 -1
- package/dist/bridge/utils/addressValidation.d.ts +0 -200
- package/dist/bridge/utils/addressValidation.d.ts.map +0 -1
- package/dist/bridge/utils/balanceHelpers.d.ts +0 -215
- package/dist/bridge/utils/balanceHelpers.d.ts.map +0 -1
- package/dist/bridge/utils/bridgeErrors.d.ts +0 -98
- package/dist/bridge/utils/bridgeErrors.d.ts.map +0 -1
- package/dist/bridge/utils/bridgeOutHelpers.d.ts +0 -68
- package/dist/bridge/utils/bridgeOutHelpers.d.ts.map +0 -1
- package/dist/bridge/utils/bridgePayload.d.ts +0 -98
- package/dist/bridge/utils/bridgePayload.d.ts.map +0 -1
- package/dist/bridge/utils/bridgeStatusParser.d.ts +0 -76
- package/dist/bridge/utils/bridgeStatusParser.d.ts.map +0 -1
- package/dist/bridge/utils/eip712Helpers.d.ts +0 -66
- package/dist/bridge/utils/eip712Helpers.d.ts.map +0 -1
- package/dist/bridge/utils/index.d.ts +0 -19
- package/dist/bridge/utils/index.d.ts.map +0 -1
- package/dist/bridge/utils/retry.d.ts +0 -112
- package/dist/bridge/utils/retry.d.ts.map +0 -1
- package/dist/bridge/utils/strategyDelegation.d.ts +0 -126
- package/dist/bridge/utils/strategyDelegation.d.ts.map +0 -1
- package/dist/bridge/utils/tokenIdUtils.d.ts +0 -86
- package/dist/bridge/utils/tokenIdUtils.d.ts.map +0 -1
- package/dist/bridge/utils/tokenMath.d.ts +0 -39
- package/dist/bridge/utils/tokenMath.d.ts.map +0 -1
- package/dist/bridge/utils/tokenMetadataResolver.d.ts +0 -97
- package/dist/bridge/utils/tokenMetadataResolver.d.ts.map +0 -1
- package/dist/helpers/wallet.d.ts +0 -151
- package/dist/helpers/wallet.d.ts.map +0 -1
- package/dist/react/WalletContext.d.ts +0 -60
- package/dist/react/WalletContext.d.ts.map +0 -1
- package/dist/react/index.d.ts +0 -65
- package/dist/react/index.d.ts.map +0 -1
- package/dist/react/types.d.ts +0 -76
- package/dist/react/types.d.ts.map +0 -1
- package/dist/react/useWallet.d.ts +0 -123
- package/dist/react/useWallet.d.ts.map +0 -1
- package/dist/react/useWalletConnection.d.ts +0 -89
- package/dist/react/useWalletConnection.d.ts.map +0 -1
- package/dist/react/useWalletDetection.d.ts +0 -81
- package/dist/react/useWalletDetection.d.ts.map +0 -1
- package/dist/react.cjs +0 -1
- package/dist/react.esm.js +0 -1
- package/dist/services/AbstractTokenFetchService.d.ts +0 -150
- package/dist/services/AbstractTokenFetchService.d.ts.map +0 -1
- package/dist/services/BatchedCacheService.d.ts +0 -133
- package/dist/services/BatchedCacheService.d.ts.map +0 -1
- package/dist/services/BridgeableTokenCache.d.ts +0 -120
- package/dist/services/BridgeableTokenCache.d.ts.map +0 -1
- package/dist/services/BridgeableTokenService.d.ts +0 -218
- package/dist/services/BridgeableTokenService.d.ts.map +0 -1
- package/dist/services/DexService.d.ts +0 -440
- package/dist/services/DexService.d.ts.map +0 -1
- package/dist/services/NetworkKeyedCacheService.d.ts +0 -185
- package/dist/services/NetworkKeyedCacheService.d.ts.map +0 -1
- package/dist/services/PriceHistoryService.d.ts +0 -209
- package/dist/services/PriceHistoryService.d.ts.map +0 -1
- package/dist/services/StreamingEventService.d.ts +0 -441
- package/dist/services/StreamingEventService.d.ts.map +0 -1
- package/dist/services/WrapService.d.ts +0 -171
- package/dist/services/WrapService.d.ts.map +0 -1
- package/dist/services/WrappableTokenCache.d.ts +0 -100
- package/dist/services/WrappableTokenCache.d.ts.map +0 -1
- package/dist/services/WrappableTokenService.d.ts +0 -130
- package/dist/services/WrappableTokenService.d.ts.map +0 -1
- package/dist/setup.d.ts +0 -8
- package/dist/setup.d.ts.map +0 -1
- package/dist/tokens/transfers.d.ts +0 -95
- package/dist/tokens/transfers.d.ts.map +0 -1
- package/dist/types/comment.dto.d.ts +0 -176
- package/dist/types/comment.dto.d.ts.map +0 -1
- package/dist/types/galachain-api.types.d.ts +0 -297
- package/dist/types/galachain-api.types.d.ts.map +0 -1
- package/dist/types/priceHistory.dto.d.ts +0 -134
- package/dist/types/priceHistory.dto.d.ts.map +0 -1
- package/dist/types/streaming-events.dto.d.ts +0 -605
- package/dist/types/streaming-events.dto.d.ts.map +0 -1
- package/dist/types/token.types.d.ts +0 -359
- package/dist/types/token.types.d.ts.map +0 -1
- package/dist/types/wrappable-token.dto.d.ts +0 -305
- package/dist/types/wrappable-token.dto.d.ts.map +0 -1
- package/dist/utils/crypto-compat.d.ts +0 -40
- package/dist/utils/crypto-compat.d.ts.map +0 -1
- package/dist/utils/load-env.d.ts +0 -31
- package/dist/utils/load-env.d.ts.map +0 -1
- package/dist/utils/token-instance-key.d.ts +0 -57
- package/dist/utils/token-instance-key.d.ts.map +0 -1
- package/dist/utils/wallet.d.ts +0 -166
- package/dist/utils/wallet.d.ts.map +0 -1
- package/dist/wallet/ExternalWalletProvider.d.ts +0 -90
- package/dist/wallet/ExternalWalletProvider.d.ts.map +0 -1
- package/dist/wallet/GalaWalletProvider.d.ts +0 -122
- package/dist/wallet/GalaWalletProvider.d.ts.map +0 -1
- package/dist/wallet/PrivateKeyProvider.d.ts +0 -90
- package/dist/wallet/PrivateKeyProvider.d.ts.map +0 -1
- package/dist/wallet/detection.d.ts +0 -107
- package/dist/wallet/detection.d.ts.map +0 -1
- package/dist/wallet/event-handlers.d.ts +0 -50
- package/dist/wallet/event-handlers.d.ts.map +0 -1
- package/dist/wallet/index.d.ts +0 -51
- package/dist/wallet/index.d.ts.map +0 -1
- package/dist/wallet/signing-operation.d.ts +0 -19
- package/dist/wallet/signing-operation.d.ts.map +0 -1
- package/dist/wallet/typed-data-helpers.d.ts +0 -68
- package/dist/wallet/typed-data-helpers.d.ts.map +0 -1
- package/dist/wallet/types.d.ts +0 -267
- package/dist/wallet/types.d.ts.map +0 -1
- package/dist/wallet/utils.d.ts +0 -117
- package/dist/wallet/utils.d.ts.map +0 -1
- package/dist/wallet.cjs +0 -1
- package/dist/wallet.esm.js +0 -1
|
@@ -1,74 +0,0 @@
|
|
|
1
|
-
import type { TokenClassKey } from '@gala-chain/api';
|
|
2
|
-
import { ChainCallDTO } from '@gala-chain/api';
|
|
3
|
-
import type { NativeSignedPayload } from '../../types/dto';
|
|
4
|
-
/**
|
|
5
|
-
* Token instance structure for unlock operations
|
|
6
|
-
*/
|
|
7
|
-
export interface UnlockTokenInstance {
|
|
8
|
-
/** Owner address of the locked tokens */
|
|
9
|
-
owner: string;
|
|
10
|
-
/** Amount to unlock in decimal string format */
|
|
11
|
-
quantity: string;
|
|
12
|
-
/** Token instance key identifying the specific token */
|
|
13
|
-
tokenInstanceKey: {
|
|
14
|
-
collection: string;
|
|
15
|
-
category: string;
|
|
16
|
-
type: string;
|
|
17
|
-
additionalKey: string;
|
|
18
|
-
instance: string;
|
|
19
|
-
};
|
|
20
|
-
}
|
|
21
|
-
/**
|
|
22
|
-
* DTO for unlocking tokens on GalaChain with EIP-712 signature support
|
|
23
|
-
* Extends ChainCallDTO for proper blockchain transaction handling
|
|
24
|
-
*
|
|
25
|
-
* Unlock operations release previously locked token holds, making them
|
|
26
|
-
* available for transfer again. Must be signed by the lock authority.
|
|
27
|
-
*/
|
|
28
|
-
export declare class UnlockTokenDto extends ChainCallDTO {
|
|
29
|
-
/** Array of token instances to unlock */
|
|
30
|
-
readonly tokenInstances: UnlockTokenInstance[];
|
|
31
|
-
/** Optional name to match specific lock (if used during lock operation) */
|
|
32
|
-
readonly name?: string;
|
|
33
|
-
/** Unique key for idempotency - prevents duplicate unlock operations */
|
|
34
|
-
readonly uniqueKey: string;
|
|
35
|
-
readonly signature?: string;
|
|
36
|
-
constructor(data: {
|
|
37
|
-
tokenInstances: UnlockTokenInstance[];
|
|
38
|
-
name?: string;
|
|
39
|
-
uniqueKey: string;
|
|
40
|
-
signedPayload?: NativeSignedPayload;
|
|
41
|
-
});
|
|
42
|
-
/**
|
|
43
|
-
* Create UnlockTokenDto for a single token from token class key
|
|
44
|
-
*
|
|
45
|
-
* @param owner - Address that owns the locked tokens
|
|
46
|
-
* @param quantity - Amount to unlock
|
|
47
|
-
* @param tokenClassKey - Token identifier (TokenClassKey object or "$"-delimited string)
|
|
48
|
-
* @param options - Optional unlock parameters (name, uniqueKey)
|
|
49
|
-
*/
|
|
50
|
-
static fromTokenClassKey(owner: string, quantity: string, tokenClassKey: TokenClassKey | string, options?: {
|
|
51
|
-
name?: string;
|
|
52
|
-
uniqueKey?: string;
|
|
53
|
-
}): UnlockTokenDto;
|
|
54
|
-
/**
|
|
55
|
-
* Create UnlockTokenDto for GALA tokens
|
|
56
|
-
*/
|
|
57
|
-
static forGALA(owner: string, quantity: string, options?: {
|
|
58
|
-
name?: string;
|
|
59
|
-
uniqueKey?: string;
|
|
60
|
-
}): UnlockTokenDto;
|
|
61
|
-
/**
|
|
62
|
-
* Get the token class key string representation (for single-token unlocks)
|
|
63
|
-
*/
|
|
64
|
-
getTokenClassKey(): string | undefined;
|
|
65
|
-
/**
|
|
66
|
-
* Convert to the payload format expected for signing
|
|
67
|
-
*/
|
|
68
|
-
toSigningPayload(): {
|
|
69
|
-
tokenInstances: UnlockTokenInstance[];
|
|
70
|
-
name?: string;
|
|
71
|
-
uniqueKey: string;
|
|
72
|
-
};
|
|
73
|
-
}
|
|
74
|
-
//# sourceMappingURL=UnlockTokenDto.d.ts.map
|
|
@@ -1 +0,0 @@
|
|
|
1
|
-
{"version":3,"file":"UnlockTokenDto.d.ts","sourceRoot":"","sources":["../../../src/api/dto/UnlockTokenDto.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AACrD,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAE/C,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AAI3D;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,yCAAyC;IACzC,KAAK,EAAE,MAAM,CAAC;IACd,gDAAgD;IAChD,QAAQ,EAAE,MAAM,CAAC;IACjB,wDAAwD;IACxD,gBAAgB,EAAE;QAChB,UAAU,EAAE,MAAM,CAAC;QACnB,QAAQ,EAAE,MAAM,CAAC;QACjB,IAAI,EAAE,MAAM,CAAC;QACb,aAAa,EAAE,MAAM,CAAC;QACtB,QAAQ,EAAE,MAAM,CAAC;KAClB,CAAC;CACH;AAED;;;;;;GAMG;AACH,qBAAa,cAAe,SAAQ,YAAY;IAC9C,yCAAyC;IACzC,SAAgB,cAAc,EAAE,mBAAmB,EAAE,CAAC;IAEtD,2EAA2E;IAC3E,SAAgB,IAAI,CAAC,EAAE,MAAM,CAAC;IAE9B,wEAAwE;IACxE,SAAyB,SAAS,EAAE,MAAM,CAAC;IAG3C,SAAyB,SAAS,CAAC,EAAE,MAAM,CAAC;gBAEhC,IAAI,EAAE;QAChB,cAAc,EAAE,mBAAmB,EAAE,CAAC;QACtC,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,SAAS,EAAE,MAAM,CAAC;QAClB,aAAa,CAAC,EAAE,mBAAmB,CAAC;KACrC;IAgBD;;;;;;;OAOG;IACH,MAAM,CAAC,iBAAiB,CACtB,KAAK,EAAE,MAAM,EACb,QAAQ,EAAE,MAAM,EAChB,aAAa,EAAE,aAAa,GAAG,MAAM,EACrC,OAAO,CAAC,EAAE;QACR,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,SAAS,CAAC,EAAE,MAAM,CAAC;KACpB,GACA,cAAc;IAiBjB;;OAEG;IACH,MAAM,CAAC,OAAO,CACZ,KAAK,EAAE,MAAM,EACb,QAAQ,EAAE,MAAM,EAChB,OAAO,CAAC,EAAE;QACR,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,SAAS,CAAC,EAAE,MAAM,CAAC;KACpB,GACA,cAAc;IAqBjB;;OAEG;IACH,gBAAgB,IAAI,MAAM,GAAG,SAAS;IAItC;;OAEG;IACH,gBAAgB,IAAI;QAClB,cAAc,EAAE,mBAAmB,EAAE,CAAC;QACtC,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,SAAS,EAAE,MAAM,CAAC;KACnB;CAOF"}
|
|
@@ -1,484 +0,0 @@
|
|
|
1
|
-
/**
|
|
2
|
-
* Bridge Service
|
|
3
|
-
*
|
|
4
|
-
* Main orchestrator for cross-chain bridging operations.
|
|
5
|
-
* Provides a unified API for bridging tokens between GalaChain and external chains.
|
|
6
|
-
*/
|
|
7
|
-
import type { BridgeableTokenService } from '../services/BridgeableTokenService.js';
|
|
8
|
-
import { type BridgeEnvironment } from './constants/index.js';
|
|
9
|
-
import type { BridgeConfig, BridgeFeeEstimate, BridgeInParams, BridgeOutParams, BridgeStatus, BridgeToken, BridgeTransaction, EstimateBridgeFeeParams, EthereumTransactionStatus, EthereumWalletBalanceResult, ExternalChainBalance, ExternalNetwork, SolanaTransactionStatus, SolanaWalletBalanceResult, WaitForBridgeOptions } from './types/index.js';
|
|
10
|
-
export type { BridgeEnvironment };
|
|
11
|
-
/**
|
|
12
|
-
* Extended bridge configuration with wallet keys.
|
|
13
|
-
*/
|
|
14
|
-
export interface BridgeServiceConfig extends BridgeConfig {
|
|
15
|
-
/** GalaChain wallet address (eth|0x...) */
|
|
16
|
-
galaChainWalletAddress: string;
|
|
17
|
-
/** Ethereum private key for signing (required for all operations) */
|
|
18
|
-
ethereumPrivateKey: string;
|
|
19
|
-
/** Environment - affects default RPC URLs (STAGE uses Sepolia, PROD uses mainnet) */
|
|
20
|
-
environment?: BridgeEnvironment;
|
|
21
|
-
/**
|
|
22
|
-
* Optional BridgeableTokenService for dynamic token resolution.
|
|
23
|
-
* If provided, tokenId-based operations will resolve symbols dynamically.
|
|
24
|
-
* If not provided, tokenId must match a known bridge token symbol.
|
|
25
|
-
*/
|
|
26
|
-
bridgeableTokenService?: BridgeableTokenService;
|
|
27
|
-
}
|
|
28
|
-
/**
|
|
29
|
-
* Bridge Service - Main entry point for cross-chain operations.
|
|
30
|
-
*
|
|
31
|
-
* Supports bridging between:
|
|
32
|
-
* - GalaChain ↔ Ethereum (6 tokens: GALA, GWETH, GUSDC, GUSDT, GWTRX, GWBTC)
|
|
33
|
-
* - GalaChain ↔ Solana (2 tokens: GALA, GSOL)
|
|
34
|
-
*
|
|
35
|
-
* @example
|
|
36
|
-
* ```typescript
|
|
37
|
-
* const bridgeService = new BridgeService({
|
|
38
|
-
* // Uses GALACONNECT_PRODUCTION_URL by default
|
|
39
|
-
* galaChainWalletAddress: 'eth|0x1234...',
|
|
40
|
-
* ethereumPrivateKey: '0xabcd...',
|
|
41
|
-
* solanaPrivateKey: 'base58EncodedKey...',
|
|
42
|
-
* });
|
|
43
|
-
*
|
|
44
|
-
* // Estimate bridge fees
|
|
45
|
-
* const fee = await bridgeService.estimateBridgeFee({
|
|
46
|
-
* tokenSymbol: 'GALA',
|
|
47
|
-
* destinationChain: 'Ethereum',
|
|
48
|
-
* amount: '100',
|
|
49
|
-
* });
|
|
50
|
-
*
|
|
51
|
-
* // Bridge out (GalaChain → Ethereum)
|
|
52
|
-
* const tx = await bridgeService.bridgeOut({
|
|
53
|
-
* tokenSymbol: 'GALA',
|
|
54
|
-
* amount: '100',
|
|
55
|
-
* destinationChain: 'Ethereum',
|
|
56
|
-
* recipientAddress: '0x5678...',
|
|
57
|
-
* });
|
|
58
|
-
*
|
|
59
|
-
* // Wait for completion
|
|
60
|
-
* const status = await bridgeService.waitForBridgeCompletion(tx.transactionHash);
|
|
61
|
-
* ```
|
|
62
|
-
*/
|
|
63
|
-
export declare class BridgeService {
|
|
64
|
-
private readonly config;
|
|
65
|
-
private readonly galaConnectClient;
|
|
66
|
-
private readonly strategies;
|
|
67
|
-
private readonly bridgeableTokenService?;
|
|
68
|
-
/**
|
|
69
|
-
* Normalize a GalaChain wallet address to the expected format.
|
|
70
|
-
*
|
|
71
|
-
* GalaChain expects: `eth|<checksummed-address-without-0x>`
|
|
72
|
-
*
|
|
73
|
-
* Accepts various formats:
|
|
74
|
-
* - `eth|0xa278...` → `eth|A278...` (removes 0x, checksums)
|
|
75
|
-
* - `eth|a278...` → `eth|A278...` (checksums)
|
|
76
|
-
* - `0xA278...` → `eth|A278...` (adds prefix, removes 0x)
|
|
77
|
-
*
|
|
78
|
-
* @param address - Wallet address in any supported format
|
|
79
|
-
* @returns Normalized address in GalaChain format
|
|
80
|
-
*/
|
|
81
|
-
private static normalizeGalaChainAddress;
|
|
82
|
-
/**
|
|
83
|
-
* Compute EIP-55 checksum for an address.
|
|
84
|
-
*
|
|
85
|
-
* @param address - Address without 0x prefix (40 hex chars)
|
|
86
|
-
* @returns Checksummed address (40 chars, mixed case)
|
|
87
|
-
*/
|
|
88
|
-
private static checksumAddress;
|
|
89
|
-
/**
|
|
90
|
-
* Creates a new Bridge Service.
|
|
91
|
-
*
|
|
92
|
-
* @param config - Service configuration
|
|
93
|
-
*/
|
|
94
|
-
constructor(config: BridgeServiceConfig);
|
|
95
|
-
/**
|
|
96
|
-
* Initialize bridge strategies for supported chains.
|
|
97
|
-
*/
|
|
98
|
-
private initializeStrategies;
|
|
99
|
-
/**
|
|
100
|
-
* Resolve a tokenId to its symbol using BridgeableTokenService.
|
|
101
|
-
*
|
|
102
|
-
* Parses the tokenId and looks up the corresponding token in the cache.
|
|
103
|
-
* The symbol comes from the authoritative DEX API, not derived from the tokenId.
|
|
104
|
-
*
|
|
105
|
-
* @param tokenId - Token identifier (string or TokenClassKey)
|
|
106
|
-
* @param network - Target network for bridging
|
|
107
|
-
* @returns Promise resolving to the token's symbol
|
|
108
|
-
* @throws Error if BridgeableTokenService is not configured
|
|
109
|
-
* @throws Error if token is not found or not bridgeable to the network
|
|
110
|
-
*/
|
|
111
|
-
private resolveTokenSymbol;
|
|
112
|
-
/**
|
|
113
|
-
* Estimate bridge fees for a transfer.
|
|
114
|
-
*
|
|
115
|
-
* @param params - Fee estimation parameters
|
|
116
|
-
* @returns Fee estimate with breakdown
|
|
117
|
-
*/
|
|
118
|
-
estimateBridgeFee(params: EstimateBridgeFeeParams): Promise<BridgeFeeEstimate>;
|
|
119
|
-
/**
|
|
120
|
-
* Bridge tokens out from GalaChain to an external chain.
|
|
121
|
-
*
|
|
122
|
-
* @param params - Bridge out parameters
|
|
123
|
-
* @returns Transaction details
|
|
124
|
-
*/
|
|
125
|
-
bridgeOut(params: BridgeOutParams): Promise<BridgeTransaction>;
|
|
126
|
-
/**
|
|
127
|
-
* Bridge tokens in from an external chain to GalaChain.
|
|
128
|
-
*
|
|
129
|
-
* @param params - Bridge in parameters
|
|
130
|
-
* @returns Transaction details
|
|
131
|
-
*/
|
|
132
|
-
bridgeIn(params: BridgeInParams): Promise<BridgeTransaction>;
|
|
133
|
-
/**
|
|
134
|
-
* Get the status of a bridge transaction.
|
|
135
|
-
*
|
|
136
|
-
* @param transactionHash - Transaction hash to check
|
|
137
|
-
* @param chain - Optional chain hint for faster lookup (if known)
|
|
138
|
-
* @returns Current status
|
|
139
|
-
*/
|
|
140
|
-
getBridgeStatus(transactionHash: string, chain?: ExternalNetwork): Promise<BridgeStatus>;
|
|
141
|
-
/**
|
|
142
|
-
* Wait for a bridge transaction to complete.
|
|
143
|
-
*
|
|
144
|
-
* @param transactionHash - Transaction hash to wait for
|
|
145
|
-
* @param options - Polling options
|
|
146
|
-
* @returns Final status when complete
|
|
147
|
-
*/
|
|
148
|
-
waitForBridgeCompletion(transactionHash: string, options?: WaitForBridgeOptions): Promise<BridgeStatus>;
|
|
149
|
-
/**
|
|
150
|
-
* Get list of all supported bridge tokens.
|
|
151
|
-
*
|
|
152
|
-
* @param chain - Optional chain to filter by
|
|
153
|
-
* @returns Array of supported tokens
|
|
154
|
-
*/
|
|
155
|
-
getSupportedBridgeTokens(chain?: ExternalNetwork): BridgeToken[];
|
|
156
|
-
/**
|
|
157
|
-
* Get list of supported external chains.
|
|
158
|
-
*
|
|
159
|
-
* @returns Array of chain names
|
|
160
|
-
*/
|
|
161
|
-
getSupportedBridgeChains(): ExternalNetwork[];
|
|
162
|
-
/**
|
|
163
|
-
* Check if a token is supported for bridging.
|
|
164
|
-
*
|
|
165
|
-
* @param tokenSymbol - Token symbol to check
|
|
166
|
-
* @param chain - Optional chain to check specifically
|
|
167
|
-
* @returns True if token is supported
|
|
168
|
-
*/
|
|
169
|
-
isTokenSupported(tokenSymbol: string, chain?: ExternalNetwork): boolean;
|
|
170
|
-
/**
|
|
171
|
-
* Validate an address for a specific chain.
|
|
172
|
-
*
|
|
173
|
-
* @param address - Address to validate
|
|
174
|
-
* @param chain - Target chain
|
|
175
|
-
* @returns True if address is valid
|
|
176
|
-
*/
|
|
177
|
-
isValidAddress(address: string, chain: ExternalNetwork): boolean;
|
|
178
|
-
/**
|
|
179
|
-
* Get ERC-20 token balance on Ethereum.
|
|
180
|
-
*
|
|
181
|
-
* @param tokenSymbol - Token symbol (e.g., 'GALA', 'GWETH', 'GUSDC')
|
|
182
|
-
* @param address - Optional Ethereum address (defaults to configured wallet)
|
|
183
|
-
* @returns Token balance as decimal string
|
|
184
|
-
* @throws Error if Ethereum bridge not configured or token not supported
|
|
185
|
-
*
|
|
186
|
-
* @example
|
|
187
|
-
* ```typescript
|
|
188
|
-
* // Check wallet's GALA balance on Ethereum
|
|
189
|
-
* const balance = await bridge.getEthereumTokenBalance('GALA');
|
|
190
|
-
* console.log(`Ethereum GALA: ${balance}`);
|
|
191
|
-
*
|
|
192
|
-
* // Check specific address
|
|
193
|
-
* const otherBalance = await bridge.getEthereumTokenBalance('GUSDC', '0x1234...');
|
|
194
|
-
* ```
|
|
195
|
-
*/
|
|
196
|
-
getEthereumTokenBalance(tokenSymbol: string, address?: string): Promise<string>;
|
|
197
|
-
/**
|
|
198
|
-
* Get native ETH balance on Ethereum.
|
|
199
|
-
*
|
|
200
|
-
* @param address - Optional Ethereum address (defaults to configured wallet)
|
|
201
|
-
* @returns ETH balance as decimal string (18 decimals)
|
|
202
|
-
* @throws Error if Ethereum bridge not configured
|
|
203
|
-
*
|
|
204
|
-
* @example
|
|
205
|
-
* ```typescript
|
|
206
|
-
* // Check wallet's ETH balance (for gas fees)
|
|
207
|
-
* const ethBalance = await bridge.getEthereumNativeBalance();
|
|
208
|
-
* console.log(`ETH for gas: ${ethBalance}`);
|
|
209
|
-
* ```
|
|
210
|
-
*/
|
|
211
|
-
getEthereumNativeBalance(address?: string): Promise<string>;
|
|
212
|
-
/**
|
|
213
|
-
* Get SPL token balance on Solana.
|
|
214
|
-
*
|
|
215
|
-
* @param tokenSymbol - Token symbol ('GALA' or 'GSOL')
|
|
216
|
-
* @param address - Optional Solana address (defaults to configured wallet)
|
|
217
|
-
* @returns Token balance as decimal string
|
|
218
|
-
* @throws Error if Solana bridge not configured or token not supported
|
|
219
|
-
*
|
|
220
|
-
* @example
|
|
221
|
-
* ```typescript
|
|
222
|
-
* // Check wallet's GALA balance on Solana
|
|
223
|
-
* const balance = await bridge.getSolanaTokenBalance('GALA');
|
|
224
|
-
* console.log(`Solana GALA: ${balance}`);
|
|
225
|
-
* ```
|
|
226
|
-
*/
|
|
227
|
-
getSolanaTokenBalance(tokenSymbol: string, address?: string): Promise<string>;
|
|
228
|
-
/**
|
|
229
|
-
* Get native SOL balance on Solana.
|
|
230
|
-
*
|
|
231
|
-
* @param address - Optional Solana address (defaults to configured wallet)
|
|
232
|
-
* @returns SOL balance as decimal string (9 decimals)
|
|
233
|
-
* @throws Error if Solana bridge not configured
|
|
234
|
-
*
|
|
235
|
-
* @example
|
|
236
|
-
* ```typescript
|
|
237
|
-
* // Check wallet's SOL balance (for transaction fees)
|
|
238
|
-
* const solBalance = await bridge.getSolanaNativeBalance();
|
|
239
|
-
* console.log(`SOL for rent: ${solBalance}`);
|
|
240
|
-
* ```
|
|
241
|
-
*/
|
|
242
|
-
getSolanaNativeBalance(address?: string): Promise<string>;
|
|
243
|
-
/**
|
|
244
|
-
* Fetch a single ERC-20 token balance on Ethereum.
|
|
245
|
-
*
|
|
246
|
-
* Efficient method for checking a specific token balance (1 RPC call).
|
|
247
|
-
* Use `fetchEthereumWalletAllBalances()` for complete portfolio view.
|
|
248
|
-
*
|
|
249
|
-
* @param symbol - Token symbol (GALA, GWETH, GUSDC, GUSDT, GWTRX, GWBTC)
|
|
250
|
-
* @param address - Ethereum address (0x format). Defaults to configured wallet.
|
|
251
|
-
* @returns Single token balance with metadata
|
|
252
|
-
* @throws Error if Ethereum bridge not configured or invalid symbol
|
|
253
|
-
*
|
|
254
|
-
* @example
|
|
255
|
-
* ```typescript
|
|
256
|
-
* // Check GALA balance on Ethereum
|
|
257
|
-
* const gala = await bridgeService.fetchEthereumWalletTokenBalance('GALA');
|
|
258
|
-
* console.log(`GALA: ${gala.quantity}`);
|
|
259
|
-
*
|
|
260
|
-
* // Check specific address
|
|
261
|
-
* const gusdc = await bridgeService.fetchEthereumWalletTokenBalance('GUSDC', '0x1234...');
|
|
262
|
-
* ```
|
|
263
|
-
*/
|
|
264
|
-
fetchEthereumWalletTokenBalance(symbol: string, address?: string): Promise<ExternalChainBalance>;
|
|
265
|
-
/**
|
|
266
|
-
* Fetch native ETH balance on Ethereum.
|
|
267
|
-
*
|
|
268
|
-
* Efficient method for checking ETH balance only (1 RPC call).
|
|
269
|
-
* Use `fetchEthereumWalletAllBalances()` for complete portfolio view.
|
|
270
|
-
*
|
|
271
|
-
* @param address - Ethereum address (0x format). Defaults to configured wallet.
|
|
272
|
-
* @returns Native ETH balance with metadata
|
|
273
|
-
* @throws Error if Ethereum bridge not configured
|
|
274
|
-
*
|
|
275
|
-
* @example
|
|
276
|
-
* ```typescript
|
|
277
|
-
* // Check ETH balance (for gas fees)
|
|
278
|
-
* const eth = await bridgeService.fetchEthereumWalletNativeBalance();
|
|
279
|
-
* console.log(`ETH: ${eth.quantity}`);
|
|
280
|
-
* ```
|
|
281
|
-
*/
|
|
282
|
-
fetchEthereumWalletNativeBalance(address?: string): Promise<ExternalChainBalance>;
|
|
283
|
-
/**
|
|
284
|
-
* Fetch a single SPL token balance on Solana.
|
|
285
|
-
*
|
|
286
|
-
* Efficient method for checking a specific token balance (1 RPC call).
|
|
287
|
-
* Use `fetchSolanaWalletAllBalances()` for complete portfolio view.
|
|
288
|
-
*
|
|
289
|
-
* @param symbol - Token symbol (GALA, GSOL)
|
|
290
|
-
* @param address - Solana address (base58 format). Defaults to configured wallet.
|
|
291
|
-
* @returns Single token balance with metadata
|
|
292
|
-
* @throws Error if Solana bridge not configured or invalid symbol
|
|
293
|
-
*
|
|
294
|
-
* @example
|
|
295
|
-
* ```typescript
|
|
296
|
-
* // Check GALA balance on Solana
|
|
297
|
-
* const gala = await bridgeService.fetchSolanaWalletTokenBalance('GALA');
|
|
298
|
-
* console.log(`GALA: ${gala.quantity}`);
|
|
299
|
-
* ```
|
|
300
|
-
*/
|
|
301
|
-
fetchSolanaWalletTokenBalance(symbol: string, address?: string): Promise<ExternalChainBalance>;
|
|
302
|
-
/**
|
|
303
|
-
* Fetch native SOL balance on Solana.
|
|
304
|
-
*
|
|
305
|
-
* Efficient method for checking SOL balance only (1 RPC call).
|
|
306
|
-
* Use `fetchSolanaWalletAllBalances()` for complete portfolio view.
|
|
307
|
-
*
|
|
308
|
-
* @param address - Solana address (base58 format). Defaults to configured wallet.
|
|
309
|
-
* @returns Native SOL balance with metadata
|
|
310
|
-
* @throws Error if Solana bridge not configured
|
|
311
|
-
*
|
|
312
|
-
* @example
|
|
313
|
-
* ```typescript
|
|
314
|
-
* // Check SOL balance (for transaction fees)
|
|
315
|
-
* const sol = await bridgeService.fetchSolanaWalletNativeBalance();
|
|
316
|
-
* console.log(`SOL: ${sol.quantity}`);
|
|
317
|
-
* ```
|
|
318
|
-
*/
|
|
319
|
-
fetchSolanaWalletNativeBalance(address?: string): Promise<ExternalChainBalance>;
|
|
320
|
-
/**
|
|
321
|
-
* Request SOL airdrop from Solana devnet faucet.
|
|
322
|
-
*
|
|
323
|
-
* Only available when connected to Solana devnet (STAGE environment).
|
|
324
|
-
* Will throw an error if RPC endpoint is not devnet or if Solana bridge is not configured.
|
|
325
|
-
*
|
|
326
|
-
* @param amount - Amount of SOL to request (default: 1, max: 2 per request)
|
|
327
|
-
* @param address - Optional recipient address (defaults to configured wallet)
|
|
328
|
-
* @returns Transaction signature
|
|
329
|
-
* @throws Error if not on devnet, Solana not configured, or airdrop fails
|
|
330
|
-
*
|
|
331
|
-
* @example
|
|
332
|
-
* ```typescript
|
|
333
|
-
* // Airdrop 1 SOL to configured wallet
|
|
334
|
-
* const signature = await bridgeService.requestSolanaDevnetAirdrop();
|
|
335
|
-
*
|
|
336
|
-
* // Airdrop 0.5 SOL to specific address
|
|
337
|
-
* const signature = await bridgeService.requestSolanaDevnetAirdrop(0.5, 'Address...');
|
|
338
|
-
* ```
|
|
339
|
-
*/
|
|
340
|
-
requestSolanaDevnetAirdrop(amount?: number, address?: string): Promise<string>;
|
|
341
|
-
/**
|
|
342
|
-
* Get the status of a Solana transaction by signature.
|
|
343
|
-
*
|
|
344
|
-
* This method queries the Solana RPC directly using getSignatureStatuses,
|
|
345
|
-
* which doesn't require WebSockets and works in Node.js environments.
|
|
346
|
-
* Use this to verify airdrop or bridge transactions after submission.
|
|
347
|
-
*
|
|
348
|
-
* @param signature - Base58-encoded Solana transaction signature (87-88 characters)
|
|
349
|
-
* @returns Transaction status including confirmation level and any errors
|
|
350
|
-
* @throws Error if Solana bridge not configured or signature format is invalid
|
|
351
|
-
*
|
|
352
|
-
* @example Basic usage
|
|
353
|
-
* ```typescript
|
|
354
|
-
* const signature = await bridgeService.requestSolanaDevnetAirdrop(1);
|
|
355
|
-
* // Wait a moment for transaction to propagate
|
|
356
|
-
* await new Promise(r => setTimeout(r, 2000));
|
|
357
|
-
* const status = await bridgeService.getSolanaTransactionStatus(signature);
|
|
358
|
-
* if (status.confirmed) {
|
|
359
|
-
* console.log(`Transaction confirmed at slot ${status.slot}`);
|
|
360
|
-
* }
|
|
361
|
-
* ```
|
|
362
|
-
*
|
|
363
|
-
* @example Polling pattern for confirmation
|
|
364
|
-
* ```typescript
|
|
365
|
-
* async function waitForConfirmation(signature: string, maxAttempts = 30) {
|
|
366
|
-
* for (let i = 0; i < maxAttempts; i++) {
|
|
367
|
-
* const status = await bridgeService.getSolanaTransactionStatus(signature);
|
|
368
|
-
* if (status.confirmed) return status;
|
|
369
|
-
* if (status.status === 'failed') throw new Error(status.error);
|
|
370
|
-
* await new Promise(r => setTimeout(r, 2000));
|
|
371
|
-
* }
|
|
372
|
-
* throw new Error('Transaction confirmation timeout');
|
|
373
|
-
* }
|
|
374
|
-
* ```
|
|
375
|
-
*/
|
|
376
|
-
getSolanaTransactionStatus(signature: string): Promise<SolanaTransactionStatus>;
|
|
377
|
-
/**
|
|
378
|
-
* Get the status of an Ethereum transaction by hash.
|
|
379
|
-
*
|
|
380
|
-
* Queries Ethereum RPC directly using `getTransactionReceipt()` and `getTransaction()`.
|
|
381
|
-
* Use this to verify if a bridge or any Ethereum transaction succeeded after submission.
|
|
382
|
-
*
|
|
383
|
-
* Status values:
|
|
384
|
-
* - `pending` - Transaction in mempool, not yet mined
|
|
385
|
-
* - `confirmed` - Mined with <12 confirmations
|
|
386
|
-
* - `finalized` - Mined with 12+ confirmations (practical finality)
|
|
387
|
-
* - `not_found` - Transaction hash not found on network
|
|
388
|
-
* - `failed` - Transaction mined but reverted
|
|
389
|
-
*
|
|
390
|
-
* **Performance:** Single synchronous RPC call sequence (no WebSocket required).
|
|
391
|
-
*
|
|
392
|
-
* @param transactionHash - Ethereum transaction hash (0x + 64 hex characters)
|
|
393
|
-
* @returns Transaction status with confirmation details
|
|
394
|
-
* @throws Error if Ethereum bridge not configured or hash format invalid
|
|
395
|
-
*
|
|
396
|
-
* @example Check bridge out status
|
|
397
|
-
* ```typescript
|
|
398
|
-
* const bridgeResult = await bridgeService.bridgeOut({
|
|
399
|
-
* tokenId: 'Token|Unit|GALA|...',
|
|
400
|
-
* amount: '100',
|
|
401
|
-
* destinationChain: 'Ethereum',
|
|
402
|
-
* recipientAddress: '0x1234...',
|
|
403
|
-
* });
|
|
404
|
-
*
|
|
405
|
-
* const status = await bridgeService.getEthereumTransactionStatus(bridgeResult.transactionHash);
|
|
406
|
-
* console.log(`Status: ${status.status}, Confirmations: ${status.confirmations}`);
|
|
407
|
-
* ```
|
|
408
|
-
*
|
|
409
|
-
* @example Polling pattern for finality
|
|
410
|
-
* ```typescript
|
|
411
|
-
* async function waitForFinality(txHash: string, maxAttempts = 30) {
|
|
412
|
-
* for (let i = 0; i < maxAttempts; i++) {
|
|
413
|
-
* const status = await bridgeService.getEthereumTransactionStatus(txHash);
|
|
414
|
-
* if (status.status === 'finalized') return status;
|
|
415
|
-
* if (status.status === 'failed') throw new Error(status.error);
|
|
416
|
-
* await new Promise(r => setTimeout(r, 15000)); // ~15s per block
|
|
417
|
-
* }
|
|
418
|
-
* throw new Error('Transaction finality timeout');
|
|
419
|
-
* }
|
|
420
|
-
* ```
|
|
421
|
-
*/
|
|
422
|
-
getEthereumTransactionStatus(transactionHash: string): Promise<EthereumTransactionStatus>;
|
|
423
|
-
/**
|
|
424
|
-
* Fetch all supported token balances on Ethereum for a wallet.
|
|
425
|
-
*
|
|
426
|
-
* Returns native ETH balance plus all supported ERC-20 token balances:
|
|
427
|
-
* GALA, GWETH, GUSDC, GUSDT, GWTRX, GWBTC
|
|
428
|
-
*
|
|
429
|
-
* For checking a single token, use `fetchEthereumWalletTokenBalance()` (more efficient).
|
|
430
|
-
*
|
|
431
|
-
* @param address - Ethereum address (0x format). Defaults to configured wallet.
|
|
432
|
-
* @returns Complete balance breakdown for all supported tokens
|
|
433
|
-
* @throws Error if Ethereum bridge not configured
|
|
434
|
-
*
|
|
435
|
-
* @example
|
|
436
|
-
* ```typescript
|
|
437
|
-
* // Get all Ethereum balances
|
|
438
|
-
* const result = await bridgeService.fetchEthereumWalletAllBalances();
|
|
439
|
-
* console.log(`ETH: ${result.native.quantity}`);
|
|
440
|
-
* for (const token of result.tokens) {
|
|
441
|
-
* console.log(`${token.symbol}: ${token.quantity}`);
|
|
442
|
-
* }
|
|
443
|
-
*
|
|
444
|
-
* // Check specific address
|
|
445
|
-
* const otherWallet = await bridgeService.fetchEthereumWalletAllBalances('0x1234...');
|
|
446
|
-
* ```
|
|
447
|
-
*/
|
|
448
|
-
fetchEthereumWalletAllBalances(address?: string): Promise<EthereumWalletBalanceResult>;
|
|
449
|
-
/**
|
|
450
|
-
* Fetch all supported token balances on Solana for a wallet.
|
|
451
|
-
*
|
|
452
|
-
* Returns native SOL balance plus all supported SPL token balances:
|
|
453
|
-
* GALA, GSOL
|
|
454
|
-
*
|
|
455
|
-
* For checking a single token, use `fetchSolanaWalletTokenBalance()` (more efficient).
|
|
456
|
-
*
|
|
457
|
-
* @param address - Solana address (base58 format). Defaults to configured wallet.
|
|
458
|
-
* @returns Complete balance breakdown for all supported tokens
|
|
459
|
-
* @throws Error if Solana bridge not configured
|
|
460
|
-
*
|
|
461
|
-
* @example
|
|
462
|
-
* ```typescript
|
|
463
|
-
* // Get all Solana balances
|
|
464
|
-
* const result = await bridgeService.fetchSolanaWalletAllBalances();
|
|
465
|
-
* console.log(`SOL: ${result.native.quantity}`);
|
|
466
|
-
* for (const token of result.tokens) {
|
|
467
|
-
* console.log(`${token.symbol}: ${token.quantity}`);
|
|
468
|
-
* }
|
|
469
|
-
*
|
|
470
|
-
* // Check specific address
|
|
471
|
-
* const otherWallet = await bridgeService.fetchSolanaWalletAllBalances('9WzDXw...');
|
|
472
|
-
* ```
|
|
473
|
-
*/
|
|
474
|
-
fetchSolanaWalletAllBalances(address?: string): Promise<SolanaWalletBalanceResult>;
|
|
475
|
-
/**
|
|
476
|
-
* Get the strategy for a specific chain.
|
|
477
|
-
*
|
|
478
|
-
* @param chain - Target chain
|
|
479
|
-
* @returns Bridge strategy
|
|
480
|
-
* @throws Error if chain is not supported
|
|
481
|
-
*/
|
|
482
|
-
private getStrategy;
|
|
483
|
-
}
|
|
484
|
-
//# sourceMappingURL=BridgeService.d.ts.map
|
|
@@ -1 +0,0 @@
|
|
|
1
|
-
{"version":3,"file":"BridgeService.d.ts","sourceRoot":"","sources":["../../src/bridge/BridgeService.ts"],"names":[],"mappings":"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"}
|