@gala-chain/launchpad-sdk 9.0.0-rc.3 → 9.0.0-rc.5

package/CHANGELOG.md

@@ -1,5 +1,32 @@
 # Changelog
 
+## 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`.
+
+- **`eth|0x<hex>` is refused everywhere, with one message, and core agrees.** This SDK already
+  refused it (rc.3); the text now is gala-core-sdk's own (`INVALID_ETH_USER_REF_PREFIX`):
+  `Invalid <field>: "<value>" is not a GalaChain user reference. An eth| reference takes the 40 hex
+  digits of the account with no 0x prefix; write it as "eth|<EIP-55 digits>".` It is the message
+  of `userRef` / `backendUserRef` (`ValidationError`, `code: 'INVALID_FORMAT'`), `AddressFormatter`
+  (`assertValid`, `toEthereumFormat`), `assertBackendUserAddress`, the `walletAddress` validator,
+  `flexibleAddressSchema`, the trade-filter `userAddress` schema and the signers'
+  `INVALID_SIGNER_OPTIONS`. Core rc.7 itself no longer converts `eth|0x...`, so a signer, a bridge
+  recipient or a gateway write handed one is refused the same way before anything is signed or sent.
+- Two places still ACCEPTED `eth|0x...` and no longer do: `vaultAddressSchema`
+  (`/^eth\|(0x)?[0-9a-fA-F]{40}$/`) and `VAULT_ADDRESS_CONSTRAINT.ETH_PATTERN` / `isValidVaultAddress`
+  (`/^eth\|0x[0-9a-fA-F]{40}$/`, which refused the real `eth|<40 hex>`): both are `eth|<40 hex>`
+  now.
+- Docs, doc comments and examples no longer show `eth|0x...` as an address (it was written in
+  about a hundred places).
+
 ## 9.0.0-rc.3
 
 Since 9.0.0-rc.2 (published). Core peer floor stays `>=1.0.0-rc.6 <2`.
@@ -160,7 +187,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
@@ -633,17 +660,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
@@ -330,7 +332,7 @@ const unsubscribe = sdk.onLaunchpadTokenCreation(
     console.log(`   Created: ${new Date(token.createdAt).toISOString()}`);
   },
   {
-    creatorAddress: 'eth|0x...',  // Optional: watch specific creator
+    creatorAddress: 'eth|...',  // Optional: watch specific creator
     intervalMs: 30000              // Poll every 30 seconds
   }
 );
@@ -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}`);
   }
 });
 
@@ -473,12 +470,12 @@ await sdk.connectStreamWebSocket({
 const sdk = createLaunchpadSDK({ env: 'prod' });
 
 // GALA balance
-const galaBalance = await sdk.fetchGalaBalance('eth|0x...');
-console.log(`GALA: ${galaBalance?.balance}`);
+const galaBalance = await sdk.fetchGalaBalance('eth|...');
+console.log(`GALA: ${galaBalance?.quantity}`);
 
 // Tokens you hold
 const held = await sdk.fetchTokensHeld({
-  address: 'eth|0x...',
+  address: 'eth|...',
   search: 'dragon'  // Optional: filter by search
 });
 
@@ -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/MIGRATING-TO-9.0.md

@@ -1,4 +1,4 @@
-# Migrating from launchpad-sdk 8.1.0 to 9.0.0-rc.3
+# Migrating from launchpad-sdk 8.1.0 to 9.0.0-rc.4
 
 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).

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);
@@ -97,7 +94,7 @@ const quote = await gSwap.quoting.quoteExactInput(
 const swap = await gSwap.swaps.swap(
   'GALA|Unit|none|none',
   'GUSDC|Unit|none|none',
-  quote.fee,
+  quote.feeTier,
   { exactIn: '100', amountOutMinimum: quote.amountOut },
 );
 // The swap is queued (swap.mode === 'queued'); confirm() resolves the applied trade
@@ -114,12 +111,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

@@ -1013,7 +1013,7 @@ export declare class LaunchpadSDK {
      *
      * @example
      * ```typescript
-     * const rank = await sdk.getHolderRank('anime', 'eth|0x1234...');
+     * const rank = await sdk.getHolderRank('anime', 'eth|1234...');
      * if (rank) {
      *   console.log(`Rank #${rank.rank} of ${rank.holderCount} holders, balance: ${rank.balance}`);
      * }
@@ -1069,7 +1069,7 @@ export declare class LaunchpadSDK {
      *
      * @example
      * ```typescript
-     * const history = await sdk.getHolderHistory('anime', 'eth|0x1234...', 10);
+     * const history = await sdk.getHolderHistory('anime', 'eth|1234...', 10);
      * history.trades.forEach(t => console.log(`${t.txnType}: ${t.inputAmount} → ${t.outputAmount}`));
      * ```
      */
@@ -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}`);
      * ```
      */
@@ -3505,7 +3505,7 @@ export declare class LaunchpadSDK {
      * @example Permanent global ban
      * ```typescript
      * const result = await sdk.createGlobalBan({
-     *   userAddress: 'eth|0x123...',
+     *   userAddress: 'eth|123...',
      *   reason: 'Serious platform violation'
      * });
      * console.log('User globally banned:', result.ban.userAddress);
@@ -3514,7 +3514,7 @@ export declare class LaunchpadSDK {
      * @example Temporary global ban (7 days)
      * ```typescript
      * const result = await sdk.createGlobalBan({
-     *   userAddress: 'eth|0x123...',
+     *   userAddress: 'eth|123...',
      *   reason: 'Spam across multiple streams',
      *   durationSeconds: 604800 // 7 days
      * });
@@ -3539,7 +3539,7 @@ export declare class LaunchpadSDK {
      * @example
      * ```typescript
      * const result = await sdk.removeGlobalBan({
-     *   userAddress: 'eth|0x123...'
+     *   userAddress: 'eth|123...'
      * });
      * console.log('Global ban removed:', result.removed);
      * ```
@@ -3575,7 +3575,7 @@ export declare class LaunchpadSDK {
      * @example Search for banned user
      * ```typescript
      * const result = await sdk.listGlobalBans({
-     *   userAddress: 'eth|0x123...',
+     *   userAddress: 'eth|123...',
      *   pageSize: 10
      * });
      * ```
@@ -3597,7 +3597,7 @@ export declare class LaunchpadSDK {
      * @example
      * ```typescript
      * const status = await sdk.getGlobalBan({
-     *   userAddress: 'eth|0x123...'
+     *   userAddress: 'eth|123...'
      * });
      * if (status.banned) {
      *   console.log('User is globally banned');
@@ -4310,7 +4310,7 @@ export declare class LaunchpadSDK {
      * @example Promote a user to overseer
      * ```typescript
      * const result = await sdk.createOverseerDirect({
-     *   userAddress: 'eth|0x1234567890abcdef1234567890abcdef12345678',
+     *   userAddress: 'eth|1234567890abcdef1234567890abcdef12345678',
      *   description: 'Platform team - John'
      * });
      * console.log('Overseer created:', result.overseer.userAddress);
@@ -5149,7 +5149,7 @@ export declare class LaunchpadSDK {
      * @example Get token weekly history
      * ```typescript
      * const { snapshots } = await sdk.getTokenWeeklyHistory({
-     *   vaultAddress: 'eth|0xabc123...'
+     *   vaultAddress: 'eth|abc123...'
      * });
      *
      * for (const snap of snapshots) {
@@ -5228,7 +5228,7 @@ export declare class LaunchpadSDK {
      *
      * @example Get profile oEmbed
      * ```typescript
-     * const { oembed } = await sdk.getProfileOEmbed({ address: 'eth|0x123...' });
+     * const { oembed } = await sdk.getProfileOEmbed({ address: 'eth|123...' });
      * console.log('User:', oembed.displayName);
      * console.log('Tokens created:', oembed.tokensCreated);
      * console.log('Volume:', oembed.totalVolumeGala);
@@ -5418,7 +5418,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 +5429,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 +5443,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 +5454,6 @@ export declare class LaunchpadSDK {
      * @example Remove a heart reaction
      * ```typescript
      * await sdk.removeContentReaction({
-     *   tokenName: 'mytoken',
      *   messageId: 'msg-1703443200000-a1b2c3d4e5f6789012345678901234ab',
      *   reactionType: 'heart'
      * });
@@ -5467,7 +5465,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 +5474,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 +5485,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 +5494,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 +5505,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 +5514,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 +5525,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 +5534,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'
      * });
@@ -5571,7 +5565,7 @@ export declare class LaunchpadSDK {
      * @example Get comments by a user
      * ```typescript
      * const result = await sdk.getComments({
-     *   userAddress: 'eth|0x123...',
+     *   userAddress: 'eth|123...',
      *   pageSize: 20
      * });
      * ```
@@ -5669,7 +5663,7 @@ export declare class LaunchpadSDK {
      * @example Get chat messages by a user
      * ```typescript
      * const result = await sdk.getChatMessages({
-     *   userAddress: 'eth|0x123...',
+     *   userAddress: 'eth|123...',
      *   pageSize: 50
      * });
      * ```
@@ -5776,7 +5770,7 @@ export declare class LaunchpadSDK {
      * @example Get all messages from a user with pagination
      * ```typescript
      * const result = await sdk.fetchMessages({
-     *   userAddress: 'eth|0x123...',
+     *   userAddress: 'eth|123...',
      *   pageSize: 20,
      *   cursor: 'next_cursor'
      * });
@@ -6345,7 +6339,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 +7534,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 +7556,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
@@ -8695,7 +8689,7 @@ export declare class LaunchpadSDK {
      * ```typescript
      * const result = await sdk.lockTokens({
      *   tokens: [
-     *     { tokenName: 'anime', amount: '500', lockAuthority: 'eth|0x1234...' },
+     *     { tokenName: 'anime', amount: '500', lockAuthority: 'eth|1234...' },
      *     { tokenName: 'dragon', amount: '250', expires: Date.now() + 86400000, name: 'vesting-lock' }
      *   ]
      * });
@@ -9056,7 +9050,7 @@ export declare class LaunchpadSDK {
      * ```typescript
      * const unsubscribe = sdk.onLaunchpadTokenCreation(
      *   (token) => console.log(`${token.name} created!`),
-     *   { creatorAddress: 'eth|0x1234...' }
+     *   { creatorAddress: 'eth|1234...' }
      * );
      * ```
      */