@gala-chain/launchpad-sdk 8.1.0 → 9.0.0-rc.1

package/MIGRATING-TO-9.0.md

@@ -0,0 +1,343 @@
+# Migrating from launchpad-sdk 8.1.0 to 9.0.0-rc.1
+
+Generated by `scripts/generate-migration-doc.ts` from the built declarations of the published
+`@gala-chain/launchpad-sdk@8.1.0` tarball and of this build (do not edit by hand).
+
+launchpad-sdk 9.0 is launchpad-only. Gateway-generic GalaChain pieces (signing, signers, the
+token reads and writes, wallet helpers, wallet providers, React hooks, the bridge) are
+`@gala-chain/gala-core-sdk`'s, a peer dependency: install it beside launchpad-sdk. The DEX (swap
+backend: quotes, swaps, pools, positions, market prices and price series, leaderboards) is
+`@gala-chain/gswap-sdk`'s: launchpad-sdk no longer depends on it; an app that needs both builds
+both clients. See CHANGELOG.md for behaviour changes.
+
+## `@gala-chain/launchpad-sdk`
+
+| Removed export | Kind | Now |
+| --- | --- | --- |
+| `AuthenticatedEvent` | type | removed: the wire payload is `StreamChatAuthenticatedEvent` (`RealtimeEventPayloads['authenticated']`) |
+| `BaseBridgeStrategy` | value | same name, from `@gala-chain/gala-core-sdk/bridge` |
+| `BaseContentItem` | type | removed: `Message`: the item `GET /v1/messages` lists (`id` and `messageId`, `user`, `reactions: { counts, userReacted? }`) |
+| `BaseTokenCrossRate` | type | same name, from `@gala-chain/gala-core-sdk/bridge` |
+| `BRIDGE_CONTRACT_ABI` | value | same name, from `@gala-chain/gala-core-sdk/bridge` |
+| `BRIDGE_TOKEN_METADATA` | value | `STATIC_TOKEN_METADATA` from `@gala-chain/gala-core-sdk/bridge` |
+| `BridgeableNetwork` | type | same name, from `@gala-chain/gala-core-sdk/bridge` |
+| `BridgeableToken` | type | same name, from `@gala-chain/gala-core-sdk/bridge` |
+| `BridgeConfig` | type | same name, from `@gala-chain/gala-core-sdk/bridge` |
+| `BridgeConfigurationToken` | type | same name, from `@gala-chain/gala-core-sdk/bridge` |
+| `BridgeFeeEstimate` | type | same name, from `@gala-chain/gala-core-sdk/bridge` |
+| `BridgeFeeResponse` | type | same name, from `@gala-chain/gala-core-sdk/bridge` |
+| `BridgeInParams` | type | same name, from `@gala-chain/gala-core-sdk/bridge` |
+| `BridgeLegResult` | type | same name, from `@gala-chain/gala-core-sdk/bridge` |
+| `BridgeOutParams` | type | same name, from `@gala-chain/gala-core-sdk/bridge` |
+| `BridgeRateLimiter` | value | `RateLimiter` from `@gala-chain/gala-core-sdk/bridge` |
+| `BridgeRequestDto` | type | same name, from `@gala-chain/gala-core-sdk/bridge` |
+| `BridgeStatus` | type | same name, from `@gala-chain/gala-core-sdk/bridge` |
+| `BridgeStatusCode` | value | same name, from `@gala-chain/gala-core-sdk/bridge` |
+| `BridgeStatusResponse` | type | same name, from `@gala-chain/gala-core-sdk/bridge` |
+| `BridgeStrategy` | type | same name, from `@gala-chain/gala-core-sdk/bridge` |
+| `BridgeToken` | type | same name, from `@gala-chain/gala-core-sdk/bridge` |
+| `BridgeTokenDescriptor` | type | same name, from `@gala-chain/gala-core-sdk/bridge` |
+| `BridgeTokenInstance` | type | same name, from `@gala-chain/gala-core-sdk/bridge` |
+| `BridgeTokenOutResponse` | type | same name, from `@gala-chain/gala-core-sdk/bridge` |
+| `BridgeTransaction` | type | same name, from `@gala-chain/gala-core-sdk/bridge` |
+| `BridgeTransactionRegistrationResponse` | type | same name, from `@gala-chain/gala-core-sdk/bridge` |
+| `CHAIN_IDS` | value | same name, from `@gala-chain/gala-core-sdk/bridge` |
+| `ChainResult` | type | removed: `sdk.tokens` (TokenWrites) is gone: `transferToken` / `burnTokens` / `lockTokens` / `unlockTokens` return receipts |
+| `ChatMessageItem` | type | removed: `Message` for a listed chat message; `SentChatMessage` / `EditedChatMessage` for what `sendChatMessage` / `updateChatMessage` answer |
+| `ChatStatusChangedEvent` | type | removed: the wire payload is `StreamChatStatusEvent` (`RealtimeEventPayloads['CHAT_STATUS_CHANGED']`) |
+| `CommentData` | type | removed: the shape of the removed `/v1/comments` route: a listed comment is `Message`, a written one `WrittenComment` |
+| `CommentItem` | type | removed: `Message` for a listed comment; `WrittenComment` for what `createComment` / `updateComment` answer |
+| `compareAmounts` | value | same name, from `@gala-chain/gala-core-sdk/bridge` |
+| `ConnectionEvent` | type | removed: the wire payload is `ConnectionGreetingEvent` (`RealtimeEventPayloads['connection']`) |
+| `createProviderFromEip1193` | value | same name, from `@gala-chain/gala-core-sdk/providers` |
+| `createProviderFromWallet` | value | `PrivateKeyProvider` from `@gala-chain/gala-core-sdk/providers` (`PrivateKeyProvider.fromWallet(wallet)`) |
+| `createSolanaWallet` | value | same name, from `@gala-chain/gala-core-sdk/bridge` |
+| `createWallet` | value | same name, from `@gala-chain/gala-core-sdk` |
+| `createWalletProvider` | value | same name, from `@gala-chain/gala-core-sdk/providers` |
+| `CROSS_RATE_TYPED_DATA_TYPES` | value | same name, from `@gala-chain/gala-core-sdk/bridge` |
+| `DEFAULT_ETHEREUM_BRIDGE_CONTRACT` | value | same name, from `@gala-chain/gala-core-sdk/bridge` |
+| `DEFAULT_ETHEREUM_RPC_URL` | value | same name, from `@gala-chain/gala-core-sdk/bridge` |
+| `DEFAULT_ETHEREUM_TOKENS` | value | `ETHEREUM_TOKENS_PROD` from `@gala-chain/gala-core-sdk/bridge` |
+| `DEFAULT_POLL_INTERVAL_MS` | value | same name, from `@gala-chain/gala-core-sdk/bridge` |
+| `DEFAULT_POLL_TIMEOUT_MS` | value | same name, from `@gala-chain/gala-core-sdk/bridge` |
+| `DEFAULT_RATE_LIMIT_RPS` | value | same name, from `@gala-chain/gala-core-sdk/bridge` |
+| `DEFAULT_SOLANA_BRIDGE_PROGRAM` | value | same name, from `@gala-chain/gala-core-sdk/bridge` |
+| `DEFAULT_SOLANA_RPC_URL` | value | same name, from `@gala-chain/gala-core-sdk/bridge` |
+| `DEFAULT_SOLANA_TOKENS` | value | same name, from `@gala-chain/gala-core-sdk/bridge` |
+| `DeleteCommentOptions` | type | removed: the removed `/v1/comments` route: `deleteComment(messageId)` |
+| `DestinationChainTxFee` | type | same name, from `@gala-chain/gala-core-sdk/bridge` |
+| `DetectedWallet` | type | same name, from `@gala-chain/gala-core-sdk/providers` |
+| `detectWallets` | value | same name, from `@gala-chain/gala-core-sdk/providers` |
+| `DexAggregatedVolumeSummary` | type | `VolumeSummary` from `@gala-chain/gswap-sdk` |
+| `DexSeason` | type | `LeaderboardSeason` from `@gala-chain/gswap-sdk` |
+| `Eip1193Provider` | type | same name, from `@gala-chain/gala-core-sdk/providers` |
+| `Eip6963AnnounceProviderEvent` | type | same name, from `@gala-chain/gala-core-sdk/providers` |
+| `Eip6963ProviderDetail` | type | same name, from `@gala-chain/gala-core-sdk/providers` |
+| `Eip6963ProviderInfo` | type | same name, from `@gala-chain/gala-core-sdk/providers` |
+| `EIP712Domain` | type | `EIP712DomainValue` from `@gala-chain/gala-core-sdk` |
+| `EIP712TypeField` | type | removed: one field of gala-core-sdk's `EIP712Types` (`EIP712Types[string][number]`) |
+| `EIP712Types` | type | same name, from `@gala-chain/gala-core-sdk` |
+| `EngagementStatsData` | type | removed: `fetchTokenStats` returns `TokenStatsData`: `{ holdersCount, chatMessageCount, commentCount, roomCount }`, what the backend sends |
+| `ensureConnected` | value | same name, from `@gala-chain/gala-core-sdk/providers` |
+| `ERC20_ABI` | value | same name, from `@gala-chain/gala-core-sdk/bridge` |
+| `EstimateBridgeFeeParams` | type | same name, from `@gala-chain/gala-core-sdk/bridge` |
+| `ETHEREUM_BRIDGE_CONTRACT_SEPOLIA` | value | same name, from `@gala-chain/gala-core-sdk/bridge` |
+| `ETHEREUM_TOKENS_PROD` | value | same name, from `@gala-chain/gala-core-sdk/bridge` |
+| `ETHEREUM_TOKENS_STAGE` | value | same name, from `@gala-chain/gala-core-sdk/bridge` |
+| `EthereumBridgeConfig` | type | same name, from `@gala-chain/gala-core-sdk/bridge` |
+| `EthereumBridgeStrategy` | value | same name, from `@gala-chain/gala-core-sdk/bridge` |
+| `EthereumTokenConfig` | type | same name, from `@gala-chain/gala-core-sdk/bridge` |
+| `EthereumTransactionStatus` | type | same name, from `@gala-chain/gala-core-sdk/bridge` |
+| `EthereumWalletBalanceResult` | type | same name, from `@gala-chain/gala-core-sdk/bridge` |
+| `ExternalChainBalance` | type | same name, from `@gala-chain/gala-core-sdk/bridge` |
+| `ExternalNetwork` | type | same name, from `@gala-chain/gala-core-sdk/bridge` |
+| `ExternalTokenInfo` | type | same name, from `@gala-chain/gala-core-sdk/bridge` |
+| `ExternalWalletProvider` | value | same name, from `@gala-chain/gala-core-sdk/providers` |
+| `FetchBalancesResponse` | type | same name, from `@gala-chain/gala-core-sdk/bridge` |
+| `FetchBridgeableTokensOptions` | type | same name, from `@gala-chain/gala-core-sdk/bridge` |
+| `FetchBridgeableTokensResult` | type | same name, from `@gala-chain/gala-core-sdk/bridge` |
+| `FetchCommentsOptions` | type | removed: the removed `/v1/comments` route: `GetCommentsOptions` |
+| `FetchCommentsResult` | type | removed: the removed `/v1/comments` route: `CommentsResult` |
+| `FetchPriceHistoryOptions` | type | `PriceSeriesTimeframe` from `@gala-chain/gswap-sdk` (`getPriceSeries(token, timeframe)`) |
+| `FetchWrappableTokensOptions` | type | same name, from `@gala-chain/gala-core-sdk/bridge` |
+| `FetchWrappableTokensResult` | type | same name, from `@gala-chain/gala-core-sdk/bridge` |
+| `formatTokenAmount` | value | same name, from `@gala-chain/gala-core-sdk/bridge` |
+| `formatTokenDescriptor` | value | same name, from `@gala-chain/gala-core-sdk/bridge` |
+| `fromBaseUnits` | value | same name, from `@gala-chain/gala-core-sdk/bridge` |
+| `GALA_BRIDGE_TYPED_DATA_DOMAIN` | value | same name, from `@gala-chain/gala-core-sdk/bridge` |
+| `GALA_TOKEN_CLASS_KEY` | value | same name, from `@gala-chain/gala-core-sdk` |
+| `GALACHAIN_CHANNELS` | value | same name, from `@gala-chain/gala-core-sdk/bridge` |
+| `GalaChainChannel` | type | same name, from `@gala-chain/gala-core-sdk/bridge` |
+| `GalaChainSigner` | type | same name, from `@gala-chain/gala-core-sdk` |
+| `GALACONNECT_PRODUCTION_URL` | value | same name, from `@gala-chain/gala-core-sdk/bridge` |
+| `GalaConnectClient` | value | same name, from `@gala-chain/gala-core-sdk/bridge` |
+| `GalaConnectConfig` | type | same name, from `@gala-chain/gala-core-sdk/bridge` |
+| `GalaConnectHttpError` | value | `GalaSDKError` from `@gala-chain/gala-core-sdk` (code `GALACONNECT_HTTP_ERROR` (`isGalaError(error, code)`)) |
+| `GalaExchangeCrossRate` | type | same name, from `@gala-chain/gala-core-sdk/bridge` |
+| `GalaExchangeRate` | type | same name, from `@gala-chain/gala-core-sdk/bridge` |
+| `GeneratedSolanaWallet` | type | same name, from `@gala-chain/gala-core-sdk/bridge` |
+| `generateEIP712Types` | value | same name, from `@gala-chain/gala-core-sdk` |
+| `generateUniqueKey` | value | `createUniqueKey` from `@gala-chain/gala-core-sdk` (`createUniqueKey('galaconnect-operation-')` (`<prefix><uuid v4>`)) |
+| `getEnv` | value | removed: demo tooling: read `process.env` (and load `.env` with dotenv) in the app |
+| `getEnvOrThrow` | value | removed: demo tooling: read `process.env` (and load `.env` with dotenv) in the app |
+| `getEthereumAddressFromPrivateKey` | value | same name, from `@gala-chain/gala-core-sdk` |
+| `getEthereumBridgeContractByEnvironment` | value | same name, from `@gala-chain/gala-core-sdk/bridge` |
+| `getEthereumTokenConfig` | value | same name, from `@gala-chain/gala-core-sdk/bridge` |
+| `getEthereumTokensByEnvironment` | value | same name, from `@gala-chain/gala-core-sdk/bridge` |
+| `getGalaBridgeTypedDataTypes` | value | same name, from `@gala-chain/gala-core-sdk/bridge` |
+| `getInjectedEip1193Provider` | value | same name, from `@gala-chain/gala-core-sdk/providers` |
+| `getPublicKeyFromPrivateKey` | value | same name, from `@gala-chain/gala-core-sdk` |
+| `getSolanaTokenConfig` | value | same name, from `@gala-chain/gala-core-sdk/bridge` |
+| `getStaticTokenMetadata` | value | same name, from `@gala-chain/gala-core-sdk/bridge` |
+| `getWalletByRdns` | value | same name, from `@gala-chain/gala-core-sdk/providers` |
+| `GetWrappableTokenOptions` | type | same name, from `@gala-chain/gala-core-sdk/bridge` |
+| `GlobalFeedEvent` | type | removed: the global feed delivers the token-room payload types: `RealtimeEventPayloads`; `FeedTokenEvent` names each occurrence |
+| `GlobalFeedEventType` | type | removed: the feed events are the wire names (`FeedEventName`), not lowercase discriminators |
+| `GlobalFeedSiteConfigEvent` | type | removed: `SiteConfigChangedEvent` / `FeatureGlobalStatusEvent` |
+| `GlobalFeedSiteConfigEventType` | type | removed: the feed events are the wire names (`FeedEventName`) |
+| `GlobalFeedStatsUpdatedEvent` | type | removed: `StatsUpdatedEvent` |
+| `GlobalFeedSubscriptionOptions` | type | removed: `subscribeToGlobalFeed(callbacks)` returns an unsubscribe; there are no options |
+| `GlobalFeedTokenConfigUpdatedEvent` | type | removed: `TokenConfigUpdatedEvent` |
+| `GlobalFeedTokenEvent` | type | removed: `FeedTokenEvent`: `{ event, data }`, named by the wire event |
+| `GlobalFeedTokenEventType` | type | removed: the feed events are the wire names (`FeedTokenEventName`) |
+| `GSwap` | value | same name, from `@gala-chain/gswap-sdk` |
+| `hasAnyWallet` | value | same name, from `@gala-chain/gala-core-sdk/providers` |
+| `HttpRequestor` | type | same name, from `@gala-chain/gala-core-sdk` |
+| `isChatMessageItem` | value | removed: `isMessage` |
+| `isEip1193Provider` | value | same name, from `@gala-chain/gala-core-sdk/providers` |
+| `isExternalProvider` | value | same name, from `@gala-chain/gala-core-sdk/providers` |
+| `isPrivateKeyProvider` | value | same name, from `@gala-chain/gala-core-sdk/providers` |
+| `isStreamingEvent` | value | removed: `StreamingEventService` is deleted (nothing fed it) |
+| `IsTokenBridgeableOptions` | type | same name, from `@gala-chain/gala-core-sdk/bridge` |
+| `IsTokenBridgeableResult` | type | same name, from `@gala-chain/gala-core-sdk/bridge` |
+| `IsTokenWrappableResult` | type | same name, from `@gala-chain/gala-core-sdk/bridge` |
+| `isValidGalaChainChannel` | value | same name, from `@gala-chain/gala-core-sdk/bridge` |
+| `isWalletAvailable` | value | same name, from `@gala-chain/gala-core-sdk/providers` |
+| `KNOWN_WALLET_RDNS` | value | same name, from `@gala-chain/gala-core-sdk/providers` |
+| `LeaderboardEntry` | type | same name, from `@gala-chain/gswap-sdk` |
+| `LeaderboardResult` | type | `SeasonLeaderboard` from `@gala-chain/gswap-sdk` |
+| `LEGACY_TYPED_DATA_TYPES` | value | same name, from `@gala-chain/gala-core-sdk/bridge` |
+| `loadEnvWithFallback` | value | removed: demo tooling: load `.env` with dotenv in the app |
+| `LockInput` | type | removed: `sdk.tokens` (TokenWrites) is gone: `sdk.lockTokens({ tokens: [...] })` |
+| `MasteryTitle` | type | same name, from `@gala-chain/gswap-sdk` |
+| `ModeratedTokenInviteScope` | type | removed: `InviteScope` |
+| `PostCommentOptions` | type | removed: the removed `/v1/comments` route: `CreateCommentOptions` |
+| `PostCommentResult` | type | removed: the removed `/v1/comments` route: `CreateCommentResult` |
+| `PriceHistoryResult` | type | `PriceSeries` from `@gala-chain/gswap-sdk` (`gSwap.market.getPriceSeries(token, timeframe)` answers the whole series) |
+| `PriceSnapshot` | type | `PriceSeriesPoint` from `@gala-chain/gswap-sdk` |
+| `PriceSortOrder` | type | `PriceSeriesTimeframe` from `@gala-chain/gswap-sdk` (a series comes oldest first; sort it yourself) |
+| `PrivateKeyProvider` | value | same name, from `@gala-chain/gala-core-sdk/providers` |
+| `providerToWallet` | value | removed: `isPrivateKeyProvider(p) ? new Wallet(p.exportPrivateKey()) : undefined` (ethers stays the app's) |
+| `PublicKeyResult` | type | same name, from `@gala-chain/gala-core-sdk` |
+| `QuoteTokenCrossRate` | type | same name, from `@gala-chain/gala-core-sdk/bridge` |
+| `RecordingStatusChangedEvent` | type | removed: the wire payload is `RecordingStatusEvent` |
+| `RequestBridgeOutResponse` | type | same name, from `@gala-chain/gala-core-sdk/bridge` |
+| `RoomLeftEvent` | type | removed: the wire payload is `RoomAckEvent` |
+| `RoomSubscribedEvent` | type | removed: the wire payload is `RoomAckEvent` |
+| `SimulcastStatusChangedEvent` | type | removed: the wire payload is `SimulcastStatusEvent` |
+| `SOLANA_COMPUTE` | value | same name, from `@gala-chain/gala-core-sdk/bridge` |
+| `SOLANA_DISCRIMINATORS` | value | same name, from `@gala-chain/gala-core-sdk/bridge` |
+| `SolanaBridgeConfig` | type | same name, from `@gala-chain/gala-core-sdk/bridge` |
+| `SolanaBridgeStrategy` | value | same name, from `@gala-chain/gala-core-sdk/bridge` |
+| `SolanaTokenConfig` | type | same name, from `@gala-chain/gala-core-sdk/bridge` |
+| `SolanaTransactionStatus` | type | same name, from `@gala-chain/gala-core-sdk/bridge` |
+| `SolanaWalletBalanceResult` | type | same name, from `@gala-chain/gala-core-sdk/bridge` |
+| `StreamCountdownUpdatedEvent` | type | removed: the wire payload is `StreamCountdownEvent` |
+| `StreamingEvent` | type | removed: `StreamingEventService` is deleted (nothing fed it): `RealtimeEventPayloads` types every event the socket delivers |
+| `StreamingEventCallback` | type | removed: `StreamingEventService` is deleted (nothing fed it): a subscriber is `RealtimeListener<'EVENT_NAME'>` |
+| `StreamingEventRegistry` | type | removed: `StreamingEventService` is deleted (nothing fed it): `StreamWebSocketService` keeps the one registry of subscribers |
+| `StreamingEventService` | value | removed: nothing fed it. The `LaunchpadSDK.on*` methods and `sdk.realtime.subscribe*` are subscribers of the `StreamWebSocketService` registry |
+| `StreamLanguageUpdatedEvent` | type | removed: the wire payload is `StreamLanguageEvent` |
+| `StreamStatusChangedEvent` | type | removed: the wire payload is `StreamStatusEvent` |
+| `stripHexPrefix` | value | same name, from `@gala-chain/gala-core-sdk/bridge` |
+| `subscribeToWalletChanges` | value | same name, from `@gala-chain/gala-core-sdk/providers` |
+| `toBaseUnits` | value | same name, from `@gala-chain/gala-core-sdk/bridge` |
+| `TokenAmountInput` | type | removed: `sdk.tokens` (TokenWrites) is gone |
+| `TokenBalanceEntry` | type | same name, from `@gala-chain/gala-core-sdk/bridge` |
+| `TokenClassKey` | type | `GalaChainTokenClassKey` from `@gala-chain/gala-core-sdk` |
+| `TokenClassWithSupply` | type | `GalaChainTokenClass` from `@gala-chain/gala-core-sdk` |
+| `TokenHold` | type | `GalaChainTokenHold` from `@gala-chain/gala-core-sdk` |
+| `tokenHoldSchema` | value | removed: the zod schema of a hold; holds are `GalaChainTokenHold` (gala-core-sdk) and core checks them |
+| `TokenIdentifier` | type | removed: `sdk.tokens` (TokenWrites) is gone: a token is a `TokenId` |
+| `TokenInstanceKey` | type | `GalaChainTokenInstanceKey` from `@gala-chain/gala-core-sdk` |
+| `TokenRoundTripResult` | type | same name, from `@gala-chain/gala-core-sdk/bridge` |
+| `TokenSubscribedEvent` | type | removed: the wire payload is `StreamSubscribedEvent` |
+| `TokenUnsubscribedEvent` | type | removed: the wire payload is `StreamUnsubscribedEvent` |
+| `TokenWrites` | value | removed: `sdk.tokens` is gone: `transferToken` / `burnTokens` / `lockTokens` / `unlockTokens`; or `GatewayWrites` (gala-core-sdk) |
+| `TRADES_QUERY_CONSTRAINTS` | value | removed: a deprecated composite: `TOKEN_NAME_DTO_CONSTRAINT` for the token name |
+| `TradesListResult` | type | removed: `TradesQueryResult`: the `{ trades, pageInfo }` `getTrades` returns |
+| `TransferInput` | type | removed: `sdk.tokens` (TokenWrites) is gone: `sdk.transferToken({ to, tokenId, amount })` |
+| `TypedDataDomain` | type | same name, from `@gala-chain/gala-core-sdk/providers` |
+| `TypedDataField` | type | same name, from `@gala-chain/gala-core-sdk/providers` |
+| `UnwrapTokenOptions` | type | same name, from `@gala-chain/gala-core-sdk/bridge` |
+| `UserTypingEvent` | type | removed: the wire payload is `TypingIndicatorEvent` |
+| `ViewerCountChangedEvent` | type | removed: the wire payload is `ViewerCountEvent` |
+| `WaitForBridgeOptions` | type | same name, from `@gala-chain/gala-core-sdk/bridge` |
+| `WaitOptions` | type | same name, from `@gala-chain/gala-core-sdk/bridge` |
+| `WalletConnectionState` | type | same name, from `@gala-chain/gala-core-sdk/providers` |
+| `WalletDetectionResult` | type | same name, from `@gala-chain/gala-core-sdk/providers` |
+| `WalletProvider` | type | same name, from `@gala-chain/gala-core-sdk/providers` |
+| `WalletProviderConfig` | type | same name, from `@gala-chain/gala-core-sdk/providers` |
+| `WalletProviderType` | type | same name, from `@gala-chain/gala-core-sdk/providers` |
+| `walletToProvider` | value | `PrivateKeyProvider` from `@gala-chain/gala-core-sdk/providers` (`PrivateKeyProvider.fromWallet(wallet)`) |
+| `WrappableToken` | type | same name, from `@gala-chain/gala-core-sdk/bridge` |
+| `WrappableTokenApiResponse` | type | same name, from `@gala-chain/gala-core-sdk/bridge` |
+| `WrappableTokenCacheStats` | type | same name, from `@gala-chain/gala-core-sdk/bridge` |
+| `WrappableTokenPrices` | type | same name, from `@gala-chain/gala-core-sdk/bridge` |
+| `WrapTokenOptions` | type | same name, from `@gala-chain/gala-core-sdk/bridge` |
+| `WrapUnwrapFeeEstimate` | type | same name, from `@gala-chain/gala-core-sdk/bridge` |
+| `WrapUnwrapResult` | type | same name, from `@gala-chain/gala-core-sdk/bridge` |
+| `WrapUnwrapStatus` | type | removed: a wrap resolves only once completed (`WrapUnwrapResult`); there is no status read |
+| `WrapUnwrapStatusResult` | type | removed: a wrap resolves only once completed (`WrapUnwrapResult`); there is no status read |
+
+## `@gala-chain/launchpad-sdk/native`
+
+| Removed export | Kind | Now |
+| --- | --- | --- |
+| `createWallet` | value | same name, from `@gala-chain/gala-core-sdk` |
+| `EIP712Domain` | type | `EIP712DomainValue` from `@gala-chain/gala-core-sdk` |
+| `EIP712TypeField` | type | removed: one field of gala-core-sdk's `EIP712Types` (`EIP712Types[string][number]`) |
+| `EIP712Types` | type | same name, from `@gala-chain/gala-core-sdk` |
+| `GalaChainSigner` | type | same name, from `@gala-chain/gala-core-sdk` |
+| `generateEIP712Types` | value | same name, from `@gala-chain/gala-core-sdk` |
+| `getEthereumAddressFromPrivateKey` | value | same name, from `@gala-chain/gala-core-sdk` |
+| `getPublicKeyFromPrivateKey` | value | same name, from `@gala-chain/gala-core-sdk` |
+| `PublicKeyResult` | type | same name, from `@gala-chain/gala-core-sdk` |
+| `TokenClassKey` | type | `GalaChainTokenClassKey` from `@gala-chain/gala-core-sdk` |
+
+## `@gala-chain/launchpad-sdk/wallet`
+
+This entry point is REMOVED (34 exports).
+
+| Removed export | Kind | Now |
+| --- | --- | --- |
+| `createProviderFromEip1193` | value | same name, from `@gala-chain/gala-core-sdk/providers` |
+| `createProviderFromWallet` | value | `PrivateKeyProvider` from `@gala-chain/gala-core-sdk/providers` (`PrivateKeyProvider.fromWallet(wallet)`) |
+| `createWalletProvider` | value | same name, from `@gala-chain/gala-core-sdk/providers` |
+| `DetectedWallet` | type | same name, from `@gala-chain/gala-core-sdk/providers` |
+| `detectWallets` | value | same name, from `@gala-chain/gala-core-sdk/providers` |
+| `Eip1193Provider` | type | same name, from `@gala-chain/gala-core-sdk/providers` |
+| `Eip6963AnnounceProviderEvent` | type | same name, from `@gala-chain/gala-core-sdk/providers` |
+| `Eip6963ProviderDetail` | type | same name, from `@gala-chain/gala-core-sdk/providers` |
+| `Eip6963ProviderInfo` | type | same name, from `@gala-chain/gala-core-sdk/providers` |
+| `ensureConnected` | value | same name, from `@gala-chain/gala-core-sdk/providers` |
+| `ExternalWalletProvider` | value | same name, from `@gala-chain/gala-core-sdk/providers` |
+| `GalaWalletProvider` | value | same name, from `@gala-chain/gala-core-sdk/providers` |
+| `getInjectedEip1193Provider` | value | same name, from `@gala-chain/gala-core-sdk/providers` |
+| `getPrivateKeyIfAvailable` | value | same name, from `@gala-chain/gala-core-sdk/providers` |
+| `getWalletByRdns` | value | same name, from `@gala-chain/gala-core-sdk/providers` |
+| `hasAnyWallet` | value | same name, from `@gala-chain/gala-core-sdk/providers` |
+| `isEip1193Provider` | value | same name, from `@gala-chain/gala-core-sdk/providers` |
+| `isExternalProvider` | value | same name, from `@gala-chain/gala-core-sdk/providers` |
+| `isPrivateKeyProvider` | value | same name, from `@gala-chain/gala-core-sdk/providers` |
+| `isWalletAvailable` | value | same name, from `@gala-chain/gala-core-sdk/providers` |
+| `KNOWN_WALLET_RDNS` | value | same name, from `@gala-chain/gala-core-sdk/providers` |
+| `PrivateKeyProvider` | value | same name, from `@gala-chain/gala-core-sdk/providers` |
+| `providerToWallet` | value | removed: `isPrivateKeyProvider(p) ? new Wallet(p.exportPrivateKey()) : undefined` (ethers stays the app's) |
+| `subscribeToWalletChanges` | value | same name, from `@gala-chain/gala-core-sdk/providers` |
+| `TypedDataDomain` | type | same name, from `@gala-chain/gala-core-sdk/providers` |
+| `TypedDataField` | type | same name, from `@gala-chain/gala-core-sdk/providers` |
+| `WalletConnectionState` | type | same name, from `@gala-chain/gala-core-sdk/providers` |
+| `WalletDetectionResult` | type | same name, from `@gala-chain/gala-core-sdk/providers` |
+| `WalletProvider` | type | same name, from `@gala-chain/gala-core-sdk/providers` |
+| `WalletProviderConfig` | type | same name, from `@gala-chain/gala-core-sdk/providers` |
+| `WalletProviderError` | value | `GalaSDKError` from `@gala-chain/gala-core-sdk` (`isGalaError(error, code)` with the wallet codes) |
+| `WalletProviderErrorCode` | value | `GalaErrorCode` from `@gala-chain/gala-core-sdk` (the wallet codes (`WALLET_NOT_CONNECTED`, ...)) |
+| `WalletProviderType` | type | same name, from `@gala-chain/gala-core-sdk/providers` |
+| `walletToProvider` | value | `PrivateKeyProvider` from `@gala-chain/gala-core-sdk/providers` (`PrivateKeyProvider.fromWallet(wallet)`) |
+
+## `@gala-chain/launchpad-sdk/react`
+
+This entry point is REMOVED (25 exports).
+
+| Removed export | Kind | Now |
+| --- | --- | --- |
+| `ConnectionStatus` | type | same name, from `@gala-chain/gala-core-sdk/react` |
+| `DetectedWallet` | type | same name, from `@gala-chain/gala-core-sdk/providers` |
+| `detectWallets` | value | same name, from `@gala-chain/gala-core-sdk/providers` |
+| `Eip6963ProviderInfo` | type | same name, from `@gala-chain/gala-core-sdk/providers` |
+| `ExternalWalletProvider` | value | same name, from `@gala-chain/gala-core-sdk/providers` |
+| `KNOWN_WALLET_RDNS` | value | same name, from `@gala-chain/gala-core-sdk/providers` |
+| `PrivateKeyProvider` | value | same name, from `@gala-chain/gala-core-sdk/providers` |
+| `useGalaAddress` | value | same name, from `@gala-chain/gala-core-sdk/react` |
+| `useIsWalletConnected` | value | same name, from `@gala-chain/gala-core-sdk/react` |
+| `useWallet` | value | same name, from `@gala-chain/gala-core-sdk/react` |
+| `useWalletAddress` | value | same name, from `@gala-chain/gala-core-sdk/react` |
+| `useWalletConnection` | value | same name, from `@gala-chain/gala-core-sdk/react` |
+| `UseWalletConnectionReturn` | type | same name, from `@gala-chain/gala-core-sdk/react` |
+| `useWalletContext` | value | same name, from `@gala-chain/gala-core-sdk/react` |
+| `useWalletDetection` | value | same name, from `@gala-chain/gala-core-sdk/react` |
+| `UseWalletDetectionReturn` | type | same name, from `@gala-chain/gala-core-sdk/react` |
+| `useWalletProvider` | value | same name, from `@gala-chain/gala-core-sdk/react` |
+| `WalletConnectionState` | type | same name, from `@gala-chain/gala-core-sdk/providers` |
+| `WalletContext` | value | same name, from `@gala-chain/gala-core-sdk/react` |
+| `WalletContextActions` | type | same name, from `@gala-chain/gala-core-sdk/react` |
+| `WalletContextState` | type | same name, from `@gala-chain/gala-core-sdk/react` |
+| `WalletContextValue` | type | same name, from `@gala-chain/gala-core-sdk/react` |
+| `WalletProvider` | value | same name, from `@gala-chain/gala-core-sdk/react` |
+| `WalletProviderInterface` | type | `WalletProvider` from `@gala-chain/gala-core-sdk/providers` |
+| `WalletProviderProps` | type | same name, from `@gala-chain/gala-core-sdk/react` |
+
+## Removed `LaunchpadSDK` members
+
+| Member | Now |
+| --- | --- |
+| `dex` | gswap-sdk's own client: `new GSwap({ env, signer, walletAddress })` |
+| `fetchAllDexSeasons` | gswap-sdk `gSwap.leaderboard.getSeasons()` |
+| `fetchAllPriceHistory` | gswap-sdk `gSwap.market.getPriceSeries(key, timeframe)` (one read answers the whole series) |
+| `fetchCurrentDexLeaderboard` | gswap-sdk `gSwap.leaderboard.getCurrentLeaderboard()` |
+| `fetchCurrentDexSeason` | gswap-sdk `gSwap.leaderboard.getCurrentSeason()` |
+| `fetchDexAggregatedVolumeSummary` | gswap-sdk `gSwap.market.getVolumeSummary()` |
+| `fetchDexLeaderboardBySeasonId` | gswap-sdk `gSwap.leaderboard.getLeaderboard(seasonId)` |
+| `fetchGalaPrice` | gswap-sdk `gSwap.market.getPrice('GALA\|Unit\|none\|none')` |
+| `fetchPriceHistory` | gswap-sdk `gSwap.market.getPriceSeries(await sdk.resolveTokenClassKey(name), timeframe)` |
+| `getWrapStatus` | none: a wrap resolves only once completed |
+| `onDexPoolCreation` | gswap-sdk `gSwap.pools.watchNewPools(onPool, { minTvl })` |
+| `tokens` | `transferToken`, `burnTokens`, `lockTokens`, `unlockTokens` (or gala-core-sdk `GatewayWrites`) |
+
+## Changed `LaunchpadSDK` members
+
+- `fetchTokenPrice(params)` takes `{ tokenName }` only (a launchpad token: bonding curve, or the swap
+  backend once graduated). A token by class key is gswap-sdk's `gSwap.market.getPrice(tokenId)`; a
+  `tokenId` is refused with a `ValidationError`.
+- `getSupportedBridgeTokens()` is `async` (it returned a Promise already).

package/README.md

@@ -2,15 +2,19 @@
 
 The SDK signs with `@gala-chain/api` and `ethers`; it does not depend on `@gala-chain/connect`.
 
-The v6 TypeScript SDK for Gala Launchpad. It provides read APIs for launchpad data, typed launchpad submissions, gateway-backed token transactions, and the official GSwap DEX client through `sdk.dex`.
+The TypeScript SDK for Gala Launchpad (9.0, a release candidate under the `next` dist-tag; `latest` is still 8.1.0). It provides read APIs for launchpad data, typed launchpad submissions and gateway-backed token transactions. Version 9.0 is launchpad-only: the DEX is a separate SDK, `@gala-chain/gswap-sdk` (this package has no DEX client and does not depend on it), and the gateway-generic pieces (signers, wallet helpers and providers, React hooks, the bridge) are `@gala-chain/gala-core-sdk`'s. See [MIGRATING-TO-9.0.md](./MIGRATING-TO-9.0.md) for every removed export and where it went.
 
 ## Install
 
 ```bash
-pnpm add @gala-chain/launchpad-sdk
+pnpm add @gala-chain/launchpad-sdk@next @gala-chain/gala-core-sdk@next @gala-chain/api axios bignumber.js ethers socket.io-client zod
 ```
 
-The v6 DEX surface delegates to `@gala-chain/gswap-sdk`. Until its rc is published to the public registry, install the unpublished rc from the sibling package or configure the workspace link used by this repository.
+An install without `@next` gets 8.1.0. Pin the exact versions in an app build.
+
+`@gala-chain/gala-core-sdk` and the others are peer dependencies: install them next to this package. An app that bridges or wraps tokens installs the bridge's own peers (`ethers`, `@solana/web3.js`, `@solana/spl-token`) and hands the bridge module to the SDK: `new LaunchpadSDK({ ..., bridge: () => import('@gala-chain/gala-core-sdk/bridge') })` (loaded at the first bridge or wrap call). This package never loads that module or Solana itself, so an app that does not bridge bundles and installs neither; without the loader the bridge and wrap methods throw a `ConfigurationError` naming the `bridge` option.
+
+For the DEX, install `@gala-chain/gswap-sdk` 2.0 (also under `next`) next to this package: `pnpm add @gala-chain/gswap-sdk@next`.
 
 ## Configure
 
@@ -45,33 +49,52 @@ console.log(submission.bundleId, result);
 
 ## Token writes
 
-Token transfers and other direct chain token operations go straight to the GalaChain gateway and return a `ChainResult` carrying `status`, `data`, and — read from the `x-transaction-id` and `x-block-number` response headers — `transactionId` and `blockNumber`:
+Token transfers, burns, locks and unlocks go straight to the GalaChain gateway (signed and sent by
+`@gala-chain/gala-core-sdk`'s `GatewayWrites`) and report the chain transaction id and block from the
+gateway's `x-transaction-id` and `x-block-number` headers. They are made as the SDK's wallet, or, for an
+SDK configured with `{ signer, walletAddress }`, as that identity (an `eth|` account or a `client|` alias):
 
 ```ts
-const submission = await sdk.tokens.transfer({
-  tokenClassKey: 'GALA|Unit|none|none',
-  quantity: '1',
-  from: 'eth|0x0123456789012345678901234567890123456789',
-  to: 'eth|0x9876543210987654321098765432109876543210',
+const { transactionId, blockNumber } = await sdk.transferToken({
+  to: 'eth|9876543210987654321098765432109876543210',
+  tokenId: 'GALA|Unit|none|none', // or tokenName: 'anime' for a launchpad token
+  amount: '1', // whole tokens, sent as written
 });
 
-console.log(submission.transactionId, submission.blockNumber, submission.data);
+const locked = await sdk.lockTokens({ tokens: [{ tokenName: 'anime', amount: '100' }] });
+console.log(locked.transactionId, locked.blockNumber);
 ```
 
+To send to a `client|` recipient, or to write without a launchpad SDK, use `GatewayWrites` from
+`@gala-chain/gala-core-sdk` directly.
+
 Never place a private key in source control. For a write-capable SDK, provide a signer through the supported wallet configuration.
 
 ## GSwap DEX
 
-DEX calls live under `sdk.dex` and use the `@gala-chain/gswap-sdk` contracts:
+DEX calls use `@gala-chain/gswap-sdk`'s `GSwap` client. An app that trades on both builds both
+clients from the same key (`sdk.dex` is gone, and so are `fetchAllDexSeasons`,
+`fetchCurrentDexSeason`, `fetchDexLeaderboardBySeasonId`, `fetchCurrentDexLeaderboard`,
+`fetchDexAggregatedVolumeSummary` and `onDexPoolCreation`: they are `gSwap.leaderboard.*`,
+`gSwap.market.getVolumeSummary()` and `gSwap.pools.watchNewPools()`):
 
 ```ts
-const quote = await sdk.dex.quoting.quoteExactInput(
+import { PrivateKeySigner } from '@gala-chain/gala-core-sdk';
+import { GSwap } from '@gala-chain/gswap-sdk';
+
+const gSwap = new GSwap({
+  env: 'stage',
+  signer: new PrivateKeySigner(process.env.PRIVATE_KEY!),
+  walletAddress: sdk.getAddress(), // the launchpad SDK built with the same key
+});
+
+const quote = await gSwap.quoting.quoteExactInput(
   'GALA|Unit|none|none',
   'GUSDC|Unit|none|none',
   '100',
 );
 
-const swap = await sdk.dex.swaps.swap(
+const swap = await gSwap.swaps.swap(
   'GALA|Unit|none|none',
   'GUSDC|Unit|none|none',
   quote.fee,
@@ -83,7 +106,11 @@ const applied = await swap.confirm();
 console.log(applied.transactionId, applied.result);
 ```
 
-Use `sdk.dex.pools`, `sdk.dex.positions`, `sdk.dex.symbols`, and `sdk.dex.assets` for pool discovery, liquidity, token identifiers, and user assets. DEX reads are unsigned; state-changing DEX calls require the configured signer.
+Use `gSwap.pools`, `gSwap.positions`, `gSwap.symbols`, `gSwap.assets`, `gSwap.market` and `gSwap.leaderboard` for pool discovery, liquidity, token identifiers, user assets, prices and volume, and the trading competition. DEX reads are unsigned; state-changing DEX calls require the client's signer. Runnable DEX demos and guides live in `packages/gswap-sdk/examples/demos`.
+
+## Prices
+
+`sdk.fetchTokenPrice({ tokenName })` prices a launchpad token (the bonding curve, or the swap backend once graduated). It takes `tokenName` only: `fetchGalaPrice`, `fetchTokenPrice({ tokenId })`, `fetchPriceHistory` and `fetchAllPriceHistory` are gone. Prices and price series for any token by class key are gswap-sdk's `gSwap.market.getPrice(tokenId)` and `gSwap.market.getPriceSeries(key, timeframe)`; `sdk.resolveTokenClassKey(name)` gives a launchpad token's key. The MCP tools of the same names still work.
 
 ## Hosts
 
@@ -91,6 +118,8 @@ The stage defaults are `lpad-backend.stage.defi.ovh.gala.com` for launchpad read
 
 ## Further reading
 
-- [Migration 5.x → 6.0](../../MIGRATION.md)
-- [GSwap integration](../../docs/gswap-integration.md)
-- [Examples](../../examples/)
+- [Migrating to 9.0](./MIGRATING-TO-9.0.md)
+- [Changelog](./CHANGELOG.md)
+- [API reference](./docs/API-REFERENCE.md)
+- [Examples](./examples/README.md)
+- [gswap-sdk DEX demos](../gswap-sdk/examples/demos/README.md)