@gala-chain/launchpad-sdk 9.0.0-rc.4 → 9.0.0-rc.6

package/CHANGELOG.md

@@ -1,5 +1,21 @@
 # Changelog
 
+## 9.0.0-rc.6
+
+Since 9.0.0-rc.5 (published). Core peer range is unchanged (`>=1.0.0-rc.7 <2`).
+
+- **`OverseerSummaryResponse.graduatedPools`**: `getOverseerSummary()` / `OverseerService.getSummary()` now
+  carry the number of graduated pools (the pools `fetchPools({ isGraduated: true })` lists), next to
+  `totalPools`. It is a new field of the `/v1/overseer-summary` response, so it is present once the
+  launchpad backend that adds it is deployed; against an older backend it is `undefined` at runtime.
+
+## 9.0.0-rc.5
+
+No behaviour change. Since 9.0.0-rc.4 (published): the published declarations no longer name a
+Gala-internal repo (two `@deprecated` notes say "the swap backend"), and the JSDoc examples match the
+API (`creds.rtmpsUrl`, reaction options without a `tokenName`, chat events with a top-level
+`content`). Core peer range is unchanged (`>=1.0.0-rc.7 <2`).
+
 ## 9.0.0-rc.4
 
 Since 9.0.0-rc.3 (published). Core peer floor is now `>=1.0.0-rc.7 <2`.
@@ -180,7 +196,7 @@ built declarations of both versions (`pnpm docs:migration`).
 
 ### App-owned session (a browser app's httpOnly-cookie JWT session)
 
-- **`session` in `LaunchpadSDKConfig`.** A browser app (launchpad-frontend-v3) keeps its own JWT
+- **`session` in `LaunchpadSDKConfig`.** A browser app keeps its own JWT
   session: the refresh token is an httpOnly cookie the backend sets for `cookieSession: true`
   logins, and the app is the one token authority. With `session: { accessToken, onUnauthorized,
   credentials? }` every launchpad-backend request takes its bearer from `accessToken()` (awaited per
@@ -653,17 +669,17 @@ typed entry on it (`RealtimeEventPayloads`, read from the emit sites, not from t
   their `EXECUTE_*` flag said) are plain boolean tests, and `tests/constant-boolean-null-check.test.ts`
   refuses the shape.
 
-### The `/bundle` signing schemes (unchanged bytes; for Andy)
+### The `/bundle` signing schemes (unchanged bytes)
 
 Two schemes post to the bundler's `/bundle`, and both have callers, so both stay:
 `sdk.launchpad.buyWithNative / buyExactToken / sellWithNative / sellExactToken / createSale`
 (`BundlerTransport`) signs EIP-712 typed data (`signTypedData`, the GalaChain domain; pinned by
-`tests/golden/bundler-typed-data.golden.json`): what the live launchpad frontend
-(launchpad-frontend-v3, `signTypedData` / `eth_signTypedData`) and the MCP trading tools send.
+`tests/golden/bundler-typed-data.golden.json`): what the live launchpad web app
+(`signTypedData` / `eth_signTypedData`) and the MCP trading tools send.
 `sdk.buy()` / `sdk.sell()` (`BundleService.buyToken / sellToken`) sign with the signer's
-`signObject` (native for a private key, personal-sign for a browser wallet): the native app calls
-these (`src/sdk/facades/trade.ts`), as do the examples. Retiring `BundleService`'s trade methods
-needs the native app moved to `sdk.launchpad.*` first (which changes the bytes it sends).
+`signObject` (native for a private key, personal-sign for a browser wallet): React Native apps
+call these (`src/sdk/facades/trade.ts`), as do the examples. Retiring `BundleService`'s trade
+methods needs those apps moved to `sdk.launchpad.*` first (which changes the bytes they send).
 
 ### What moved to gala-core-sdk (the extraction steps, from the 8.1.0 baseline)
 

package/EXAMPLES.md

@@ -4,7 +4,7 @@ Practical code examples for the launchpad SDK (9.0.0), organized by category. Fo
 
 > **9.0 is launchpad-only.** The DEX (quotes, swaps, pools, liquidity, fees, market prices, leaderboards) is
 > `@gala-chain/gswap-sdk`; its runnable demos are in
-> [`packages/gswap-sdk/examples/demos`](../gswap-sdk/examples/demos/README.md). Gateway-generic pieces
+> `packages/gswap-sdk/examples/demos`. Gateway-generic pieces
 > (signers, wallet providers, React hooks, the bridge) are `@gala-chain/gala-core-sdk`'s. See
 > [MIGRATING-TO-9.0.md](./MIGRATING-TO-9.0.md) for where each removed export went.
 
@@ -26,7 +26,7 @@ Practical code examples for the launchpad SDK (9.0.0), organized by category. Fo
 
 **Launchpad tokens are addressed by `tokenName`; standard GalaChain tokens by a token id (`collection|category|type|additionalKey`).**
 
-```
+```text
 Q: What operation am I performing?
 │
 ├── Buying/selling tokens on the bonding curve (pre-graduation)?
@@ -95,7 +95,7 @@ if (isGraduated) {
 | `lockTokens()` | ✅ | ✅ | Both work |
 | `fetchTokenBalance()` | ✅ | ✅ | Both work |
 
-> **See Also:** For complete type definitions and utilities, see [`src/types/token.types.ts`](./src/types/token.types.ts)
+> **See Also:** For complete type definitions and utilities, see `src/types/token.types.ts`
 
 ---
 
@@ -183,7 +183,7 @@ npm run demo:token-supply   # Token supply metrics from GalaChain
 ### 5. The DEX
 
 Swaps, liquidity, fees, pools and market data are `@gala-chain/gswap-sdk`'s. Its demos:
-[`packages/gswap-sdk/examples/demos/README.md`](../gswap-sdk/examples/demos/README.md)
+`packages/gswap-sdk/examples/demos/README.md`
 (`npx tsx src/<dir>/<file>.ts`).
 
 ---
@@ -202,7 +202,7 @@ const sdk = createLaunchpadSDK({
 });
 
 // Query operations work without wallet
-const pools = await sdk.fetchPools({ type: 'popular', limit: 10 });
+const pools = await sdk.fetchPools({ type: 'popular', pageSize: 10 });
 const price = await sdk.fetchTokenPrice({ tokenName: 'anime' });
 ```
 
@@ -211,7 +211,7 @@ const price = await sdk.fetchTokenPrice({ tokenName: 'anime' });
 ```typescript
 const sdk = createLaunchpadSDK({
   env: 'prod',
-  privateKey: process.env.WALLET_PRIVATE_KEY
+  privateKey: process.env.WALLET_PRIVATE_KEY!
 });
 
 // Now you can submit trades
@@ -221,14 +221,16 @@ const result = await sdk.buy({ tokenName: 'anime', amount: '100', type: 'native'
 **Dynamic Wallet Configuration:**
 
 ```typescript
+import { Wallet } from 'ethers';
+
 // Start in read-only mode
 const sdk = createLaunchpadSDK({ env: 'prod' });
 
 // Later, upgrade to full-access
-sdk.setWallet('your-private-key');
+sdk.setWallet(new Wallet(process.env.WALLET_PRIVATE_KEY!));
 
 // Now signing operations work
-const result = await sdk.buy({ tokenName: 'anime', amount: '100', ... });
+const result = await sdk.buy({ tokenName: 'anime', amount: '100', type: 'native', expectedAmount: '1' });
 ```
 
 **Demos:**
@@ -247,7 +249,7 @@ Trade tokens that are still in bonding curve pools (pre-graduation).
 ```typescript
 const sdk = createLaunchpadSDK({
   env: 'prod',
-  privateKey: process.env.WALLET_PRIVATE_KEY
+  privateKey: process.env.WALLET_PRIVATE_KEY!
 });
 
 // Calculate purchase amounts
@@ -359,14 +361,14 @@ Live streaming and real-time chat features for token communities.
 ```typescript
 const sdk = createLaunchpadSDK({
   env: 'prod',
-  privateKey: process.env.WALLET_PRIVATE_KEY,
+  privateKey: process.env.WALLET_PRIVATE_KEY!,
   streamWebSocketUrl: 'wss://stream.example.com'
 });
 
-// Get stream info for a token
-const streamInfo = await sdk.getStreamInfo('mytoken');
-console.log(`Status: ${streamInfo.status}`);
-console.log(`Is Live: ${streamInfo.isLive}`);
+// Stream credentials (stream key, RTMP URL, playback id) of a token you own
+const creds = await sdk.getStreamCredentials('mytoken');
+console.log(`RTMPS URL: ${creds.rtmpsUrl}`);
+console.log(`Playback ID: ${creds.playbackId}`);
 
 // Check global streaming status
 const globalStatus = await sdk.getGlobalStreamingStatus();
@@ -376,17 +378,12 @@ console.log(`Streaming enabled globally: ${globalStatus.enabled}`);
 ### Engagement Statistics
 
 ```typescript
-// Get engagement metrics for analytics dashboards
-const stats = await sdk.getEngagementStats({ tokenName: 'mytoken' });
-
-console.log('Chat Statistics (Current/Last Session):');
-console.log(`  Message Count: ${stats.chat.messageCount}`);
-console.log(`  Unique Chatters: ${stats.chat.uniqueChatters}`);
-console.log(`  Session Since: ${stats.chat.since || 'N/A'}`);
-
-console.log('Comment Statistics (All-Time):');
-console.log(`  Total Comments: ${stats.comments.count}`);
-console.log(`  Unique Commenters: ${stats.comments.uniqueCommenters}`);
+// Engagement metrics for analytics dashboards arrive on the token room about every 15 seconds
+// while there is chat activity
+const unsubscribe = sdk.onEngagementStatsUpdated((event) => {
+  console.log(`${event.tokenName}: ${event.chat.messageCount} chat messages`);
+  console.log(`Comments: ${event.comments.count} from ${event.comments.uniqueCommenters} users`);
+});
 ```
 
 ### Real-Time Chat with WebSocket
@@ -397,13 +394,13 @@ await sdk.connectStreamWebSocket({
   onTypingIndicator: (event) => {
     const count = event.typingUsers.length;
     if (count === 1) {
-      console.log(`${event.typingUsers[0].fullName} is typing...`);
+      console.log(`${event.typingUsers[0]?.fullName} is typing...`);
     } else if (count > 1) {
       console.log(`${count} people are typing...`);
     }
   },
   onChatMessage: (event) => {
-    console.log(`[${event.message.user?.fullName}]: ${event.message.content}`);
+    console.log(`[${event.user?.fullName}]: ${event.content}`);
   }
 });
 
@@ -474,7 +471,7 @@ const sdk = createLaunchpadSDK({ env: 'prod' });
 
 // GALA balance
 const galaBalance = await sdk.fetchGalaBalance('eth|...');
-console.log(`GALA: ${galaBalance?.balance}`);
+console.log(`GALA: ${galaBalance?.quantity}`);
 
 // Tokens you hold
 const held = await sdk.fetchTokensHeld({
@@ -502,6 +499,7 @@ const supplies = await sdk.fetchTokenClassesWithSupply([
 ]);
 
 const gala = supplies[0];
+if (gala === undefined) throw new Error('GALA token class not returned');
 console.log(`Token: ${gala.symbol} (${gala.name})`);
 console.log(`Total Supply: ${gala.totalSupply}`);
 console.log(`Max Supply: ${gala.maxSupply}`);
@@ -525,7 +523,7 @@ console.log(`Burned: ${burnPercent.toFixed(2)}% of total supply`);
 ```typescript
 // Warm cache by fetching pools
 console.log('Warming cache...');
-await sdk.fetchPools({ type: 'popular', limit: 50 });
+await sdk.fetchPools({ type: 'popular', pageSize: 50 });
 
 // Check cache statistics
 const stats = sdk.getCacheInfo();
@@ -581,7 +579,7 @@ const sdk = createLaunchpadSDK({ env: 'prod' });
 // No wallet configured
 
 try {
-  await sdk.buy({ tokenName: 'anime', amount: '100', ... });
+  await sdk.buy({ tokenName: 'anime', amount: '100', type: 'native', expectedAmount: '1' });
 } catch (error) {
   if (error instanceof ValidationError && error.code === 'WALLET_REQUIRED') {
     console.log('This operation requires a wallet');
@@ -603,7 +601,7 @@ try {
     slippageToleranceFactor: 0.01
   });
 } catch (error) {
-  if (error.message.includes('slippage')) {
+  if (error instanceof Error && error.message.includes('slippage')) {
     console.log('Price moved beyond slippage tolerance');
     console.log('Increase slippage or retry with a fresh quote');
   }
@@ -616,6 +614,6 @@ try {
 
 See the `examples/` directory for the working demos by category (`examples/README.md` lists them);
 `npm run demo:list` browses them. DEX demos live in
-[`packages/gswap-sdk/examples/demos`](../gswap-sdk/examples/demos/README.md).
+`packages/gswap-sdk/examples/demos`.
 
-For migration from old demo structure, see [docs/DEMO_MIGRATION_GUIDE.md](./docs/DEMO_MIGRATION_GUIDE.md).
+For migration from old demo structure, see `docs/DEMO_MIGRATION_GUIDE.md` in the package.

package/README.md

@@ -21,10 +21,7 @@ For the DEX, install `@gala-chain/gswap-sdk` 2.0 (also under `next`) next to thi
 ```ts
 import { createLaunchpadSDK } from '@gala-chain/launchpad-sdk';
 
-const sdk = createLaunchpadSDK({
-  env: 'stage',
-  baseUrl: 'https://lpad-backend.stage.defi.ovh.gala.com',
-});
+const sdk = createLaunchpadSDK({ env: 'stage' });
 
 const pools = await sdk.fetchPools({ pageSize: 10 });
 console.log(pools);
@@ -79,6 +76,7 @@ clients from the same key (`sdk.dex` is gone, and so are `fetchAllDexSeasons`,
 `gSwap.market.getVolumeSummary()` and `gSwap.pools.watchNewPools()`):
 
 ```ts
+import BigNumber from 'bignumber.js';
 import { PrivateKeySigner } from '@gala-chain/gala-core-sdk';
 import { GSwap } from '@gala-chain/gswap-sdk';
 
@@ -97,8 +95,10 @@ const quote = await gSwap.quoting.quoteExactInput(
 const swap = await gSwap.swaps.swap(
   'GALA|Unit|none|none',
   'GUSDC|Unit|none|none',
-  quote.fee,
-  { exactIn: '100', amountOutMinimum: quote.amountOut },
+  quote.feeTier,
+  // The least you accept: a swap is applied seconds after the quote, so a bound equal to the quote
+  // is rejected whenever the price moves in between.
+  { exactIn: '100', amountOutMinimum: new BigNumber(quote.amountOut).multipliedBy('0.99').toFixed() },
 );
 // The swap is queued (swap.mode === 'queued'); confirm() resolves the applied trade
 // or throws the chain's rejection.
@@ -114,12 +114,12 @@ Use `gSwap.pools`, `gSwap.positions`, `gSwap.symbols`, `gSwap.assets`, `gSwap.ma
 
 ## Hosts
 
-The stage defaults are `lpad-backend.stage.defi.ovh.gala.com` for launchpad reads, `swap-backend.stage.defi.ovh.gala.com` for DEX reads, and `gateway-testnet.galachain.com` for gateway operations. Production host values are selected by `env: 'prod'`.
+`env: 'stage'` selects the Gala staging backends for launchpad reads and DEX reads, and `gateway-testnet.galachain.com` for gateway operations. Production host values are selected by `env: 'prod'`; `baseUrl` overrides the launchpad host.
 
 ## Further reading
 
 - [Migrating to 9.0](./MIGRATING-TO-9.0.md)
-- [Changelog](./CHANGELOG.md)
+- Changelog: `CHANGELOG.md` in the package root
 - [API reference](./docs/API-REFERENCE.md)
-- [Examples](./examples/README.md)
-- [gswap-sdk DEX demos](../gswap-sdk/examples/demos/README.md)
+- [Examples](./EXAMPLES.md)
+- [gswap-sdk](../gswap-sdk/README.md): the DEX SDK, with its own runnable demos

package/dist/LaunchpadSDK.d.ts

@@ -2866,7 +2866,7 @@ export declare class LaunchpadSDK {
      * ```typescript
      * const creds = await sdk.getStreamCredentials('mytoken');
      * console.log(`Stream Key: ${creds.streamKey}`);
-     * console.log(`RTMP URL: ${creds.rtmpUrl}`);
+     * console.log(`RTMPS URL: ${creds.rtmpsUrl}`);
      * console.log(`Playback ID: ${creds.playbackId}`);
      * ```
      */
@@ -4389,6 +4389,7 @@ export declare class LaunchpadSDK {
      * console.log(`Total viewers: ${summary.totalViewers}`);
      * console.log(`Pending flags: ${summary.pendingFlags}`);
      * console.log(`Total pools: ${summary.totalPools}`);
+     * console.log(`Graduated pools: ${summary.graduatedPools}`);
      * ```
      */
     getOverseerSummary(): Promise<OverseerSummaryResponse>;
@@ -5418,7 +5419,7 @@ export declare class LaunchpadSDK {
      * Adding the same reaction type again is a no-op (idempotent).
      * Users can have multiple different reaction types on the same message.
      *
-     * @param options - Options including tokenName, messageId, and reactionType
+     * @param options - Options including messageId and reactionType
      * @returns Updated reaction data and whether reaction was newly created
      * @throws ValidationError if parameters are invalid
      * @throws ConfigurationError if authentication is not configured
@@ -5429,7 +5430,6 @@ export declare class LaunchpadSDK {
      * @example Add a heart reaction
      * ```typescript
      * const result = await sdk.addContentReaction({
-     *   tokenName: 'mytoken',
      *   messageId: 'msg-1703443200000-a1b2c3d4e5f6789012345678901234ab',
      *   reactionType: 'heart'
      * });
@@ -5444,7 +5444,7 @@ export declare class LaunchpadSDK {
      * Requires JWT or API key authentication.
      * Only the user who created the reaction can remove it.
      *
-     * @param options - Options including tokenName, messageId, and reactionType
+     * @param options - Options including messageId and reactionType
      * @returns Success indicator
      * @throws ValidationError if parameters are invalid
      * @throws ConfigurationError if authentication is not configured
@@ -5455,7 +5455,6 @@ export declare class LaunchpadSDK {
      * @example Remove a heart reaction
      * ```typescript
      * await sdk.removeContentReaction({
-     *   tokenName: 'mytoken',
      *   messageId: 'msg-1703443200000-a1b2c3d4e5f6789012345678901234ab',
      *   reactionType: 'heart'
      * });
@@ -5467,7 +5466,7 @@ export declare class LaunchpadSDK {
      *
      * Convenience wrapper for addContentReaction specifically for chat messages.
      *
-     * @param options - Options including tokenName, messageId, and reactionType
+     * @param options - Options including messageId and reactionType
      * @returns Updated reaction data
      *
      * @since 5.12.0
@@ -5476,7 +5475,6 @@ export declare class LaunchpadSDK {
      * @example Add a fire reaction to a chat message
      * ```typescript
      * await sdk.addReactionToChatMessage({
-     *   tokenName: 'mytoken',
      *   messageId: 'msg-1703443200000-a1b2c3d4e5f6789012345678901234ab',
      *   reactionType: 'fire'
      * });
@@ -5488,7 +5486,7 @@ export declare class LaunchpadSDK {
      *
      * Convenience wrapper for removeContentReaction specifically for chat messages.
      *
-     * @param options - Options including tokenName, messageId, and reactionType
+     * @param options - Options including messageId and reactionType
      * @returns Success indicator
      *
      * @since 5.12.0
@@ -5497,7 +5495,6 @@ export declare class LaunchpadSDK {
      * @example Remove a fire reaction from a chat message
      * ```typescript
      * await sdk.removeReactionFromChatMessage({
-     *   tokenName: 'mytoken',
      *   messageId: 'msg-1703443200000-a1b2c3d4e5f6789012345678901234ab',
      *   reactionType: 'fire'
      * });
@@ -5509,7 +5506,7 @@ export declare class LaunchpadSDK {
      *
      * Convenience wrapper for addContentReaction specifically for comments.
      *
-     * @param options - Options including tokenName, messageId, and reactionType
+     * @param options - Options including messageId and reactionType
      * @returns Updated reaction data
      *
      * @since 5.12.0
@@ -5518,7 +5515,6 @@ export declare class LaunchpadSDK {
      * @example Add a thumbs_up reaction to a comment
      * ```typescript
      * await sdk.addReactionToComment({
-     *   tokenName: 'mytoken',
      *   messageId: 'msg-1703443200000-a1b2c3d4e5f6789012345678901234ab',
      *   reactionType: 'thumbs_up'
      * });
@@ -5530,7 +5526,7 @@ export declare class LaunchpadSDK {
      *
      * Convenience wrapper for removeContentReaction specifically for comments.
      *
-     * @param options - Options including tokenName, messageId, and reactionType
+     * @param options - Options including messageId and reactionType
      * @returns Success indicator
      *
      * @since 5.12.0
@@ -5539,7 +5535,6 @@ export declare class LaunchpadSDK {
      * @example Remove a thumbs_up reaction from a comment
      * ```typescript
      * await sdk.removeReactionFromComment({
-     *   tokenName: 'mytoken',
      *   messageId: 'msg-1703443200000-a1b2c3d4e5f6789012345678901234ab',
      *   reactionType: 'thumbs_up'
      * });
@@ -6345,7 +6340,7 @@ export declare class LaunchpadSDK {
      *     console.log(`Viewers: ${event.viewerCount}`);
      *   },
      *   onChatMessage: (event) => {
-     *     console.log(`Chat: ${event.message.content}`);
+     *     console.log(`Chat: ${event.content}`);
      *   },
      * });
      * ```
@@ -7540,7 +7535,7 @@ export declare class LaunchpadSDK {
      * Use when you want guaranteed accuracy but don't mind network latency.
      *
      * @deprecated Use `getTradeQuote()` instead — it uses the backend-proxy for instant
-     * calculations without a direct GalaChain call. The defi-backend has removed direct
+     * calculations without a direct GalaChain call. The swap backend has removed direct
      * chain quote endpoints in favour of the backend-proxy approach.
      *
      * @param options Buy amount calculation options
@@ -7562,7 +7557,7 @@ export declare class LaunchpadSDK {
      * Use when you want guaranteed accuracy but don't mind network latency.
      *
      * @deprecated Use `getTradeQuote()` instead — it uses the backend-proxy for instant
-     * calculations without a direct GalaChain call. The defi-backend has removed direct
+     * calculations without a direct GalaChain call. The swap backend has removed direct
      * chain quote endpoints in favour of the backend-proxy approach.
      *
      * @param options Sell amount calculation options