@gala-chain/launchpad-mcp-server 5.0.2-beta.1 → 5.0.4-beta.0

package/dist/tools/utils/explainSdkUsage.js

@@ -6,9 +6,12 @@
  * Acts as a development reference showing how MCP tools map to SDK methods.
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.explainSdkUsageTool = exports.COMPOSITE_TOPICS = exports.TOPIC_METHOD_MAPPING = void 0;
+exports.explainSdkUsageTool = exports.SDK_EXAMPLES = exports.COMPOSITE_TOPICS = exports.TOPIC_METHOD_MAPPING = void 0;
 const error_handler_js_1 = require("../../utils/error-handler.js");
 const response_formatter_js_1 = require("../../utils/response-formatter.js");
+// BigNumber utilities for precise currency handling (imported from SDK)
+// These are shown in examples but note: developers would typically import directly from '@gala-chain/launchpad-sdk'
+// import { compareAmounts, formatTokenAmount } from '@gala-chain/launchpad-sdk';
 /**
  * Topic-to-method mapping for documentation validation
  * Defines which SDK methods are covered by each documentation topic
@@ -21,19 +24,19 @@ exports.TOPIC_METHOD_MAPPING = {
     // Pool Discovery
     'fetch-pools': [
         'fetchPools', 'fetchAllPools', 'fetchPoolDetails', 'fetchPoolDetailsForCalculation',
-        'fetchVolumeData', 'fetchTokenPrice', 'fetchLaunchpadTokenSpotPrice',
+        'fetchVolumeData', 'fetchTokenPrice',
         'fetchTokenDistribution', 'fetchTokenBadges', 'resolveVaultAddress', 'resolveTokenClassKey'
     ],
     'balances': ['fetchGalaBalance', 'fetchTokenBalance', 'fetchTokensHeld', 'fetchTokensCreated', 'fetchAvailableBalance'],
     // Token Creation & Management
     'token-creation': ['isTokenNameAvailable', 'isTokenSymbolAvailable', 'fetchLaunchTokenFee', 'uploadTokenImage', 'launchToken'],
     'token-details': ['fetchTokenDetails'],
-    'token-distribution': ['fetchTokenDistribution'],
+    'token-distribution': ['fetchTokenDistribution', 'fetchUserHolderContext'],
     'token-status': ['isTokenGraduated', 'onDexPoolCreation', 'onLaunchpadTokenCreation'],
     // Portfolio Management
     'multi-wallet': [], // Composite workflow topic
     'transfers': ['transferGala', 'transferToken'],
-    'locks': ['lockTokens', 'unlockTokens', 'burnTokens', 'fetchLockedTokens'],
+    'locks': ['lockTokens', 'unlockTokens', 'burnTokens', 'fetchLockedBalance'],
     // DEX Trading
     'dex-trading': ['getSwapQuoteExactInput', 'getSwapQuoteExactOutput', 'executeSwap', 'getSwapUserAssets', 'getAllSwapUserAssets', 'getSwapPoolInfo'],
     'error-handling': [], // Cross-cutting concern
@@ -44,22 +47,23 @@ exports.TOPIC_METHOD_MAPPING = {
     'price-history': ['fetchPriceHistory', 'fetchAllPriceHistory'],
     'spot-prices-smart-routing': ['fetchTokenPrice', 'getSwapPoolPrice'],
     // User Profile
-    'profile-management': ['fetchProfile', 'updateProfile', 'uploadProfileImage'],
+    'profile-management': ['fetchProfile', 'updateProfile', 'uploadProfileImage', 'getManagedTokens'],
     // Liquidity Management
     'liquidity-positions': ['getSwapUserLiquidityPositions', 'getAllSwapUserLiquidityPositions', 'getSwapLiquidityPosition', 'getSwapLiquidityPositionById', 'addSwapLiquidityByPrice', 'addSwapLiquidityByTicks', 'getSwapEstimateRemoveLiquidity', 'removeSwapLiquidity', 'collectSwapPositionFees'],
     // Advanced Analysis
     'advanced-dex-analysis': ['fetchCompositePoolData', 'calculateDexPoolQuoteExactAmountLocal', 'calculateDexPoolQuoteExactAmountExternal', 'calculateDexPoolQuoteExactAmount'],
-    'trading-analytics': ['fetchTrades'],
+    'trading-analytics': ['fetchTrades', 'getTrades'],
     'utilities-and-helpers': ['fetchGalaPrice', 'fetchTokenClassesWithSupply', 'calculateInitialBuyAmount', 'getBundlerTransactionResult', 'getSwapPoolPrice', 'fetchSwapPositionDirect', 'getAllSwapUserAssets', 'cleanup', 'clearCache', 'getCacheInfo'],
     'utilities-system': ['getAddress', 'getConfig', 'getEthereumAddress', 'getUrlByTokenName', 'getVersion', 'getWallet', 'hasWallet', 'setWallet', 'createWallet', 'connectWebSocket', 'disconnectWebSocket', 'isWebSocketConnected'],
     // DEX Leaderboards & Metrics
     'fetch-all-dex-seasons': ['fetchAllDexSeasons'],
     'fetch-current-dex-season': ['fetchCurrentDexSeason'],
-    'fetch-dex-leaderboard-by-season-id': ['fetchDexLeaderboardBySeasonId', 'fetchCurrentDexLeaderboard'],
+    'fetch-dex-leaderboard-by-season-id': ['fetchDexLeaderboardBySeasonId'],
+    'fetch-current-dex-leaderboard': ['fetchCurrentDexLeaderboard'],
     'fetch-dex-aggregated-volume-summary': ['fetchDexAggregatedVolumeSummary'],
     'fetch-dex-pools': ['fetchDexPools', 'fetchAllDexPools'],
     // Event Subscriptions
-    'event-subscriptions': ['subscribeToEvent', 'subscribeToDexLiquidityAdded', 'subscribeToDexLiquidityChanged', 'subscribeToDexLiquidityRemoved', 'subscribeToDexPoolAdded', 'subscribeToDexSwapExecuted', 'subscribeToTokenCreations'],
+    'event-subscriptions': ['subscribeToStream', 'unsubscribeFromStream', 'onStreamStatusChanged', 'onUserBanned', 'onUserUnbanned', 'onBanEnforcement', 'onContentFlagged', 'onFlagResolved', 'onStreamChatMessage', 'onStreamChatUpdated', 'onStreamChatDeleted', 'onStreamChatPinned', 'onStreamChatUnpinned', 'onChatStatusChanged', 'onViewerCountChanged', 'onRecordingStatusChanged', 'onSimulcastStatusChanged', 'onDownloadReady', 'onUserTyping', 'onStreamReaction', 'onContentReactionAdded', 'onContentReactionRemoved', 'onStreamCountdownUpdated', 'onStreamLanguageUpdated', 'onStreamControlStatusChanged', 'onConnection', 'onAuthenticated', 'onTokenSubscribed', 'onTokenUnsubscribed', 'onRoomSubscribed', 'onRoomLeft', 'onDexPoolCreation', 'onLaunchpadTokenCreation'],
     // MCP Integration
     'mcp-to-sdk-mapping': [], // Composite workflow topic
     // Bridge Operations
@@ -94,6 +98,66 @@ exports.TOPIC_METHOD_MAPPING = {
     'account-management': [
         'registerAccount'
     ],
+    // Session Authentication (JWT)
+    'session-auth': [
+        'login', 'logout', 'refreshToken', 'getSession', 'isAuthenticated',
+        'shouldRefreshToken', 'getAccessToken', 'ensureValidToken'
+    ],
+    // Live Streaming
+    'streaming': [
+        'startStream', 'stopStream', 'getStreamInfo', 'disableStream', 'enableStream', 'resetStreamKey',
+        'getStreamRecordings', 'getRecordingDownload', 'deleteRecording',
+        'getSimulcastTargets', 'addSimulcastTarget', 'removeSimulcastTarget',
+        'getGlobalStreamingStatus', 'setGlobalStreamingEnabled',
+        'getAvailableRoles', 'getStreamRole', 'getTokenAccess'
+    ],
+    // Stream Chat
+    'stream-chat': [
+        'getChatMessages', 'sendChatMessage', 'updateChatMessage', 'deleteChatMessage', 'getChatStatus', 'disableChat', 'enableChat',
+        'getGlobalChatStatus', 'setGlobalChatEnabled',
+        'connectStreamWebSocket', 'authenticateStreamWebSocket', 'subscribeToStream',
+        'unsubscribeFromStream', 'sendStreamChatViaWebSocket', 'sendStreamReaction', 'disconnectStreamWebSocket',
+        'isStreamWebSocketConnected', 'getEngagementStats'
+    ],
+    // Ban/Moderation Operations
+    'ban-management': [
+        'createBan', 'removeBan', 'listBans', 'getBanStatus', 'getActiveUsers'
+    ],
+    // API Key Management
+    'api-key-management': [
+        'createApiKey', 'listApiKeys', 'getApiKey', 'updateApiKey', 'revokeApiKey', 'getApiKeyRoles'
+    ],
+    // Moderator Invites (Magic Link Delegation)
+    'moderator-invites': [
+        'createModeratorInvite', 'claimModeratorInvite', 'getModeratedTokens',
+        'listModeratorInvites', 'revokeModeratorInvite', 'getModeratorInviteByCode',
+        'updateModeratorInviteRole'
+    ],
+    // Overseer System (Global Platform Oversight)
+    'overseer-invites': [
+        'createOverseerInvite', 'claimOverseerInvite', 'listOverseerInvites',
+        'getOverseerInviteByCode', 'revokeOverseerInvite', 'listOverseers',
+        'revokeOverseer', 'getMyOverseerStatus', 'getOverseerSummary'
+    ],
+    // Content Moderation (Flags & Comments)
+    'content-flag-management': [
+        'createFlag', 'listFlags', 'listGlobalFlags', 'dismissFlag', 'actionFlag',
+        'getComments', 'createComment', 'updateComment', 'deleteComment'
+    ],
+    // Content Reactions (Chat Messages & Comments)
+    'content-reactions': [
+        'addContentReaction', 'removeContentReaction',
+        'addReactionToChatMessage', 'removeReactionFromChatMessage',
+        'addReactionToComment', 'removeReactionFromComment'
+    ],
+    // Trade History Queries
+    'trade-history': [
+        'getTrades'
+    ],
+    // Token Ban Management (Platform-wide, Overseer Only)
+    'token-ban-management': [
+        'banToken', 'unbanToken', 'listTokenBans', 'getTokenBan', 'isTokenBanned'
+    ],
 };
 /**
  * Composite topics that don't map 1:1 to SDK methods
@@ -106,14 +170,17 @@ exports.COMPOSITE_TOPICS = new Set([
     'spot-prices-smart-routing', 'profile-management', 'token-distribution',
     'liquidity-positions', 'advanced-dex-analysis',
     'trading-analytics', 'utilities-and-helpers', 'utilities-system', 'fetch-all-dex-seasons',
-    'fetch-current-dex-season', 'fetch-dex-leaderboard-by-season-id', 'fetch-dex-aggregated-volume-summary',
+    'fetch-current-dex-season', 'fetch-current-dex-leaderboard', 'fetch-dex-leaderboard-by-season-id', 'fetch-dex-aggregated-volume-summary',
     'fetch-dex-pools', 'event-subscriptions', 'mcp-to-sdk-mapping', 'bridge-operations', 'dex-token-discovery',
     'wrap-unwrap-operations', 'referral-system', 'account-management',
+    'session-auth', 'streaming', 'stream-chat', 'ban-management', 'api-key-management',
+    'moderator-invites', 'overseer-invites', 'content-flag-management', 'content-reactions', 'trade-history', 'token-ban-management',
 ]);
 /**
  * SDK code examples organized by topic
+ * Exported for use in documentation generation and AI agents
  */
-const SDK_EXAMPLES = {
+exports.SDK_EXAMPLES = {
     // ============================================================================
     // TRADING WORKFLOWS: Bonding Curve Trading
     // ============================================================================
@@ -218,7 +285,7 @@ async function sellTokens() {
 - \`graduateToken()\`
 
 \`\`\`typescript
-import { createLaunchpadSDK } from '@gala-chain/launchpad-sdk';
+import { createLaunchpadSDK, compareAmounts } from '@gala-chain/launchpad-sdk';
 
 async function graduatePool() {
   const sdk = createLaunchpadSDK({
@@ -234,7 +301,8 @@ async function graduatePool() {
 
   // Check if you have enough balance
   const balance = await sdk.fetchGalaBalance();
-  if (parseFloat(balance.balance) < parseFloat(calculation.amount)) {
+  // Use compareAmounts() instead of parseFloat for precision with currency amounts
+  if (compareAmounts(balance.balance, calculation.amount) < 0) {
     throw new Error('Insufficient GALA balance');
   }
 
@@ -271,14 +339,13 @@ async function graduatePool() {
 - \`fetchPoolDetailsForCalculation()\`
 - \`fetchVolumeData()\`
 - \`fetchTokenPrice()\`
-- \`fetchLaunchpadTokenSpotPrice()\`
 - \`fetchTokenDistribution()\`
 - \`fetchTokenBadges()\`
 - \`resolveVaultAddress()\`
 - \`resolveTokenClassKey()\`
 
 \`\`\`typescript
-import { createLaunchpadSDK } from '@gala-chain/launchpad-sdk';
+import { createLaunchpadSDK, compareAmounts } from '@gala-chain/launchpad-sdk';
 
 // 1. BASIC POOL FETCHING - With Pagination
 async function basicPoolFetching() {
@@ -363,14 +430,14 @@ async function getDexTokenPrices() {
   console.log(\`MUSIC: $\${prices.MUSIC}\`);
 }
 
-// 7. LAUNCHPAD TOKEN SPOT PRICES
+// 7. LAUNCHPAD TOKEN SPOT PRICES (via smart router)
 async function getLaunchpadTokenPrice(tokenName) {
   const sdk = createLaunchpadSDK({ wallet: 'your-private-key' });
 
   // Get USD spot price for a launchpad token (anime, woohoo, etc.)
-  const price = await sdk.fetchLaunchpadTokenSpotPrice(tokenName);
+  const price = await sdk.fetchTokenPrice({ tokenName });
 
-  console.log(\`\${tokenName} price: $\${price}\`);
+  console.log(\`\${tokenName} price: $\${price.price}\`);
 }
 
 // 8. RESOLVE UTILITY ADDRESSES
@@ -403,16 +470,18 @@ async function analyzeToken(tokenName) {
   console.log(\`Supply: \${details.currentSupply} / \${details.maxSupply}\`);
 
   // Analyze volume trend
-  const volumes = volumeData.map(v => parseFloat(v.volume));
+  // Note: For analytics/aggregation, we use safeParseFloat for performance. For trades, use BigNumber via SDK
+  const volumes = volumeData.map(v => safeParseFloat(v.volume, 0));
   const avgVolume = volumes.reduce((a, b) => a + b, 0) / volumes.length;
-  console.log(\`Avg daily volume: $\${avgVolume.toFixed(2)}\`);
+  console.log(\`Avg daily volume: $\${toBigNumberFixed(avgVolume, 2)}\`);
 
   // Analyze distribution
+  // Use compareAmounts for precise balance comparisons
   const top5Ownership = distribution.holders
-    .sort((a, b) => parseFloat(b.balance) - parseFloat(a.balance))
+    .sort((a, b) => compareAmounts(b.balance, a.balance) > 0 ? 1 : -1)
     .slice(0, 5)
     .reduce((sum, h) => sum + h.percentage, 0);
-  console.log(\`Top 5 holders: \${top5Ownership.toFixed(2)}%\`);
+  console.log(\`Top 5 holders: \${toBigNumberFixed(top5Ownership, 2)}%\`);
 
   // Check badges
   console.log(\`Badges: \${badges.join(', ')}\`);
@@ -504,6 +573,27 @@ async function checkBalances() {
 - \`gala_launchpad_fetch_tokens_held\`
 - \`gala_launchpad_fetch_tokens_created\`
 - \`gala_launchpad_fetch_profile\`
+- \`gala_launchpad_fetch_available_balance\`
+- \`gala_launchpad_fetch_locked_tokens\`
+
+### Available vs Locked Balance
+
+\`\`\`typescript
+// Get available balance (excludes locked/escrowed tokens)
+const available = await sdk.fetchAvailableBalance({
+  tokenName: 'anime',
+  address: walletAddress
+});
+
+// Get locked tokens with details
+const locked = await sdk.fetchLockedTokens({
+  tokenName: 'anime',
+  address: walletAddress
+});
+
+console.log('Available:', available.quantity);
+console.log('Locked:', locked.lockedQuantity);
+\`\`\`
 `,
     // ============================================================================
     // TOKEN CREATION & MANAGEMENT: Launch New Tokens
@@ -694,7 +784,7 @@ async function transferTokens() {
 - \`lockTokens()\` - Lock one or more token types in a single transaction
 - \`unlockTokens()\` - Unlock one or more token types in a single transaction
 - \`burnTokens()\` - Permanently destroy tokens (IRREVERSIBLE)
-- \`fetchLockedTokens()\` - Query locked token balances with hold details
+- \`fetchLockedBalance()\` - Query locked token balances with hold details
 
 Lock, unlock, and burn tokens on GalaChain for staking, escrow, vesting, or token management.
 
@@ -819,7 +909,7 @@ async function tokenLockingAndBurning() {
   // QUERY LOCKED TOKENS - Check lock status
   // ============================================================================
 
-  const lockedTokens = await sdk.fetchLockedTokens({
+  const lockedTokens = await sdk.fetchLockedBalance({
     tokenName: 'anime',
     address: sdk.getAddress()
   });
@@ -1205,7 +1295,7 @@ const sdk = createLaunchpadSDK({
 - \`calculateSellAmountExternal()\`
 
 \`\`\`typescript
-import { createLaunchpadSDK } from '@gala-chain/launchpad-sdk';
+import { createLaunchpadSDK, compareAmounts } from '@gala-chain/launchpad-sdk';
 
 async function localCalculationsExample() {
   const sdk = createLaunchpadSDK({
@@ -1275,11 +1365,13 @@ async function localCalculationsExample() {
   // A/B COMPARISON - Verify local accuracy
   // ============================================================================
 
-  const buyDiff = Math.abs(parseFloat(localBuy.amount) - parseFloat(externalBuy.amount));
-  const buyPct = (buyDiff / parseFloat(externalBuy.amount)) * 100;
+  // Use compareAmounts for precise quote comparison
+  const buyComparison = compareAmounts(localBuy.amount, externalBuy.amount);
+  const buyDiff = Math.abs(safeParseNumber(localBuy.amount, 0) - safeParseNumber(externalBuy.amount, 0));
+  const buyPct = (buyDiff / safeParseNumber(externalBuy.amount, 1)) * 100;
 
   console.log('Local vs External Accuracy:');
-  console.log(\`  Buy difference: \${buyPct.toFixed(4)}% (should be <0.01%)\`);
+  console.log(\`  Buy difference: \${toBigNumberFixed(buyPct, 4)}% (should be <0.01%)\`);
 
   // ============================================================================
   // PERFORMANCE BENEFIT - Local is instant
@@ -1353,13 +1445,14 @@ async function analyzePriceHistory() {
     sortOrder: 'ASC'
   });
 
-  // Price analysis
-  const prices = allHistory.snapshots.map(s => parseFloat(s.price));
+  // Price analysis - Convert strings to numbers for statistical calculations
+  // Note: For precise trading amounts, use compareAmounts() from SDK instead
+  const prices = allHistory.snapshots.map(s => safeParseNumber(s.price, 0));
   const avg = prices.reduce((a, b) => a + b, 0) / prices.length;
   const variance = prices.reduce((sum, p) => sum + Math.pow(p - avg, 2), 0) / prices.length;
   const volatility = Math.sqrt(variance);
 
-  console.log(\`Average: $\${avg.toFixed(4)}, Volatility: $\${volatility.toFixed(4)}\`);
+  console.log(\`Average: $\${toBigNumberFixed(avg, 4)}, Volatility: $\${toBigNumberFixed(volatility, 4)}\`);
 
   // Data export (CSV)
   const csv = ['timestamp,price'].concat(
@@ -1478,7 +1571,6 @@ async function analyzeTokenDetails() {
 
 **Covers Methods:**
 - \`fetchTokenPrice()\` (smart routing)
-- \`fetchLaunchpadTokenSpotPrice()\`
 - \`isTokenGraduated()\`
 
 The SDK intelligently routes pricing requests between DEX and Launchpad backends based on token graduation status - no need to know which backend a token uses!
@@ -1511,41 +1603,25 @@ async function tokenPricing() {
   });
   console.log(\`DEX Token GALA: $\${dexPrices}\`);
 
-  // OPTION 3: EXPLICIT LAUNCHPAD PRICING - Ungraduated tokens
-  // Use tokenName for launchpad bonding curve tokens
-  console.log('\\n=== Explicit Launchpad Pricing ===');
-  const launchpadPrice = await sdk.fetchLaunchpadTokenSpotPrice('anime');
-  console.log(\`Launchpad token anime: $\${launchpadPrice}\`);
-
-  // ADVANCED: Handle both pricing methods with error recovery
-  console.log('\\n=== Fallback Pricing Strategy ===');
-  async function getPriceWithFallback(tokenId: string, tokenName?: string) {
-    try {
-      // Try DEX pricing first
-      return await sdk.fetchTokenPrice({ tokenId });
-    } catch (error) {
-      // If not on DEX, try launchpad pricing
-      if (tokenName) {
-        try {
-          return await sdk.fetchLaunchpadTokenSpotPrice(tokenName);
-        } catch (fallbackError) {
-          throw new Error(\`Could not fetch price for \${tokenName}\`);
-        }
-      }
-      throw error;
-    }
-  }
-
-  const fallbackPrice = await getPriceWithFallback(
-    'Token|Unit|ANIME|eth:0x...',
-    'anime'
-  );
-  console.log(\`Fallback price: $\${fallbackPrice}\`);
+  // OPTION 3: TOKEN NAME PRICING - For launchpad tokens by name
+  // Use tokenName for simple lookup of launchpad tokens
+  console.log('\\n=== Token Name Pricing ===');
+  const launchpadPrice = await sdk.fetchTokenPrice({ tokenName: 'anime' });
+  console.log(\`Launchpad token anime: $\${launchpadPrice.price}\`);
+
+  // ADVANCED: The smart router handles fallback automatically!
+  // No need for manual fallback - fetchTokenPrice with tokenId detects
+  // ungraduated tokens and automatically falls back to launchpad pricing
+  console.log('\\n=== Automatic Fallback (Built-in) ===');
+  const autoPrice = await sdk.fetchTokenPrice({
+    tokenId: 'Token|Unit|ANIME|eth:0x...'  // Auto-fallback if ungraduated
+  });
+  console.log(\`Auto-routed price: $\${autoPrice.price}\`);
 
   // USECASE: Price comparison and discovery
   console.log('\\n=== Price Discovery ===');
   async function comparePrices(tokenName: string) {
-    const launchpadPrice = await sdk.fetchLaunchpadTokenSpotPrice(tokenName);
+    const launchpadPrice = await sdk.fetchTokenPrice({ tokenName });
 
     // Check if graduated (on DEX)
     const isGraduated = await sdk.isTokenGraduated(tokenName);
@@ -1554,10 +1630,10 @@ async function tokenPricing() {
       const dexPrice = await sdk.fetchTokenPrice({
         tokenId: \`Token|Unit|\${tokenName.toUpperCase()}|eth:0x...\`
       });
-      console.log(\`Launchpad: $\${launchpadPrice}, DEX: $\${dexPrice}\`);
+      console.log(\`Launchpad: $\${launchpadPrice.price}, DEX: $\${dexPrice.price}\`);
       return { launchpadPrice, dexPrice, graduated: true };
     } else {
-      console.log(\`Launchpad: $\${launchpadPrice} (not on DEX yet)\`);
+      console.log(\`Launchpad: $\${launchpadPrice.price} (not on DEX yet)\`);
       return { launchpadPrice, graduated: false };
     }
   }
@@ -1577,14 +1653,14 @@ async function tokenPricing() {
 | Method | Use Case | Token Status |
 |--------|----------|--------------|
 | \`fetchTokenPrice({ tokenId })\` | Smart routing (recommended) | Any (DEX or Launchpad) |
-| \`fetchLaunchpadTokenSpotPrice(name)\` | Launchpad-only pricing | Ungraduated tokens |
+| \`fetchTokenPrice({ tokenName })\` | Token name pricing | Any |
 | \`isTokenGraduated(name)\` | Check token status | Any |
 
 **Key Differences:**
 
 **Ungraduated Tokens (Launchpad):**
 - Priced on exponential bonding curve
-- Token name parameter works: \`fetchLaunchpadTokenSpotPrice('anime')\`
+- Token name parameter works: \`fetchTokenPrice({ tokenName: 'anime' })\`
 - Price affected by supply/demand
 
 **Graduated Tokens (DEX):**
@@ -1713,6 +1789,7 @@ async function manageUserProfiles() {
 - \`fetchProfile(address?)\` - Get user profile
 - \`updateProfile(data)\` - Update profile info
 - \`uploadProfileImage(options)\` - Upload avatar (Node.js)
+- \`getManagedTokens()\` - Get tokens you manage (creator, moderator, manager, technical producer)
 
 **Profile Fields:**
 - \`fullName\` - Display name (max 100 chars)
@@ -1732,15 +1809,17 @@ async function manageUserProfiles() {
 - \`gala_launchpad_fetch_profile\`
 - \`gala_launchpad_update_profile\`
 - \`gala_launchpad_upload_profile_image\`
+- \`gala_launchpad_get_managed_tokens\`
 `,
     'token-distribution': `
 ## Token Holder Distribution with SDK
 
 **Covers Methods:**
 - \`fetchTokenDistribution()\`
+- \`fetchUserHolderContext()\`
 
 \`\`\`typescript
-import { createLaunchpadSDK } from '@gala-chain/launchpad-sdk';
+import { createLaunchpadSDK, compareAmounts } from '@gala-chain/launchpad-sdk';
 
 async function analyzeTokenDistribution() {
   const sdk = createLaunchpadSDK({
@@ -1755,35 +1834,36 @@ async function analyzeTokenDistribution() {
   console.log(\`Last updated: \${distribution.lastUpdated.toISOString()}\`);
 
   // Analyze top holders
+  // Use compareAmounts for precise balance sorting with large numbers
   distribution.holders
-    .sort((a, b) => parseFloat(b.balance) - parseFloat(a.balance))
+    .sort((a, b) => compareAmounts(b.balance, a.balance) > 0 ? 1 : -1)
     .slice(0, 5)
     .forEach((holder, index) => {
       console.log(\`#\${index + 1}: \${holder.address}\`);
       console.log(\`  Balance: \${holder.balance}\`);
-      console.log(\`  Ownership: \${holder.percentage.toFixed(2)}%\`);
+      console.log(\`  Ownership: \${toBigNumberFixed(holder.percentage, 2)}%\`);
     });
 
   // Check concentration risk (e.g., top 5 holders own >80%)
   const top5Ownership = distribution.holders
-    .sort((a, b) => parseFloat(b.balance) - parseFloat(a.balance))
+    .sort((a, b) => compareAmounts(b.balance, a.balance) > 0 ? 1 : -1)
     .slice(0, 5)
     .reduce((sum, holder) => sum + holder.percentage, 0);
 
-  console.log(\`Top 5 holders control: \${top5Ownership.toFixed(2)}%\`);
+  console.log(\`Top 5 holders control: \${toBigNumberFixed(top5Ownership, 2)}%\`);
 
   // Find specific holder
   const myAddress = sdk.getAddress();
   const myHolding = distribution.holders.find(h => h.address === myAddress);
 
   if (myHolding) {
-    console.log(\`Your ownership: \${myHolding.percentage.toFixed(4)}%\`);
+    console.log(\`Your ownership: \${toBigNumberFixed(myHolding.percentage, 4)}%\`);
     console.log(\`Your balance: \${myHolding.balance}\`);
   }
 
   // Calculate concentration metrics
   const giniCoefficient = calculateGini(distribution.holders);
-  console.log(\`Gini coefficient: \${giniCoefficient.toFixed(4)}\`);
+  console.log(\`Gini coefficient: \${toBigNumberFixed(giniCoefficient, 4)}\`);
 
   // Count whales (holders with >5%)
   const whales = distribution.holders.filter(h => h.percentage > 5);
@@ -1792,7 +1872,7 @@ async function analyzeTokenDistribution() {
 
 // Helper: Calculate Gini coefficient for wealth distribution
 function calculateGini(holders: Array<{balance: string}>) {
-  const balances = holders.map(h => parseFloat(h.balance)).sort((a, b) => a - b);
+  const balances = holders.map(h => safeParseFloat(h.balance, 0)).sort((a, b) => a - b);
   const n = balances.length;
   const sum = balances.reduce((a, b) => a + b, 0);
 
@@ -1820,6 +1900,61 @@ function calculateGini(holders: Array<{balance: string}>) {
 - Calculate distribution metrics (Gini coefficient, etc.)
 
 **MCP Tool Equivalent:** \`gala_launchpad_fetch_token_distribution\`
+
+---
+
+## User Holder Context (Single User Lookup)
+
+**Covers Methods:**
+- \`fetchUserHolderContext()\`
+
+Use this when you need holder info for a **specific user** rather than the full holder list.
+Perfect for user cards in comments/chat.
+
+\`\`\`typescript
+import { createLaunchpadSDK } from '@gala-chain/launchpad-sdk';
+
+async function getUserCard() {
+  const sdk = createLaunchpadSDK({ wallet: 'your-private-key' });
+
+  // Fetch single user's holder context for a token
+  const holderContext = await sdk.fetchUserHolderContext('anime', 'eth|abc123...');
+
+  // Response shape:
+  // {
+  //   tokenName: 'anime',
+  //   userAddress: 'abc123...',
+  //   quantity: '25000' | null,      // null if not a holder
+  //   percentage: 2.5 | null,         // null if not a holder
+  //   rank: 3 | null,                 // 1-indexed rank (null if not a holder)
+  //   holderTier: { tier: 3, tierName: 'Major Holder' } | null,
+  //   isCreator: false
+  // }
+
+  if (holderContext.quantity !== null) {
+    console.log(\`Rank: #\${holderContext.rank}\`);
+    console.log(\`Holder Tier: \${holderContext.holderTier?.tierName}\`);
+    console.log(\`Owns: \${holderContext.percentage ? toBigNumberFixed(holderContext.percentage, 4) : 'N/A'}%\`);
+  } else {
+    console.log('User is not a holder of this token');
+  }
+
+  if (holderContext.isCreator) {
+    console.log('This user created the token!');
+  }
+}
+\`\`\`
+
+**Holder Tiers (based on % of max supply):**
+| Tier | Name | Min % |
+|------|------|-------|
+| 5 | Whale | 5% |
+| 4 | Top Holder | 1% |
+| 3 | Major Holder | 0.1% |
+| 2 | Strong Holder | 0.01% |
+| 1 | Holder | 0.001% |
+
+**MCP Tool Equivalent:** \`gala_launchpad_fetch_user_holder_context\`
 `,
     // ============================================================================
     // LIQUIDITY MANAGEMENT: GalaSwap LP Positions
@@ -1957,7 +2092,7 @@ async function advancedDexAnalysis() {
   console.log('Local calculation:', localQuote.outputAmount);
   console.log('External API:', externalQuote.outputAmount);
   console.log('Price difference:',
-    Math.abs(parseFloat(localQuote.outputAmount) - parseFloat(externalQuote.outputAmount))
+    Math.abs(safeParseFloat(localQuote.outputAmount, 0) - safeParseFloat(externalQuote.outputAmount, 0))
   );
 
   // Step 3: Use smart routing for best price
@@ -1982,7 +2117,8 @@ async function advancedDexAnalysis() {
 ## Trading History and Analytics
 
 **Covers Methods:**
-- \`fetchTrades()\`
+- \`fetchTrades()\` - Legacy trade fetching by token
+- \`getV1Trades()\` - Flexible trade queries with tokenName/userAddress filters
 
 Analyze individual trades for technical analysis and bot development.
 
@@ -1991,6 +2127,7 @@ Analyze individual trades for technical analysis and bot development.
 - Calculate average trade size
 - Identify whale transactions
 - Build trading bots with historical data
+- Query a user's trading history across all tokens
 
 \`\`\`typescript
 import { createLaunchpadSDK } from '@gala-chain/launchpad-sdk';
@@ -1998,7 +2135,7 @@ import { createLaunchpadSDK } from '@gala-chain/launchpad-sdk';
 async function tradingAnalytics() {
   const sdk = createLaunchpadSDK({ environment: 'production' });
 
-  // Fetch recent trades
+  // Fetch recent trades for a token (legacy method)
   const trades = await sdk.fetchTrades('anime', {
     limit: 100,
     page: 1
@@ -2007,9 +2144,9 @@ async function tradingAnalytics() {
   console.log(\`Analyzing \${trades.total} trades\`);
 
   // Calculate analytics
-  const totalVolume = trades.trades.reduce((sum, t) => sum + parseFloat(t.galaAmount), 0);
+  const totalVolume = trades.trades.reduce((sum, t) => sum + safeParseFloat(t.galaAmount, 0), 0);
   const averageTradeSize = totalVolume / trades.trades.length;
-  const whaleTrades = trades.trades.filter(t => parseFloat(t.galaAmount) > 1000);
+  const whaleTrades = trades.trades.filter(t => safeParseFloat(t.galaAmount, 0) > 1000);
 
   console.log(\`Total volume: \${totalVolume} GALA\`);
   console.log(\`Average trade size: \${averageTradeSize} GALA\`);
@@ -2020,6 +2157,35 @@ async function tradingAnalytics() {
     console.log(\`\${trade.type}: \${trade.galaAmount} GALA at \${trade.timestamp}\`);
   });
 }
+
+// V1 Trades API - Flexible queries with filters
+async function queryTradesV1() {
+  const sdk = createLaunchpadSDK({ environment: 'production' });
+
+  // Query all trades for a specific token
+  const { trades, meta } = await sdk.getV1Trades({ tokenName: 'anime' });
+  console.log(\`Found \${meta.totalItems} trades for anime\`);
+
+  // Query all trades by a specific user
+  const userTrades = await sdk.getV1Trades({
+    userAddress: 'eth|1234567890abcdef...'
+  });
+  console.log(\`User has \${userTrades.meta.totalItems} trades across all tokens\`);
+
+  // Query a user's trades on a specific token with pagination
+  const filteredTrades = await sdk.getV1Trades({
+    tokenName: 'anime',
+    userAddress: 'eth|1234567890abcdef...',
+    page: 2,
+    limit: 20
+  });
+  console.log(\`Page \${filteredTrades.meta.currentPage} of \${filteredTrades.meta.totalPages}\`);
+
+  // Analyze trade types
+  filteredTrades.trades.forEach(trade => {
+    console.log(\`\${trade.txnType}: \${trade.inputAmount} -> \${trade.outputAmount}\`);
+  });
+}
 \`\`\`
 
 **Related Topics:**
@@ -2027,7 +2193,8 @@ async function tradingAnalytics() {
 - See \`dex-trading\` for executing trades
 
 **MCP Tools:**
-- \`gala_launchpad_fetch_trades\`
+- \`gala_launchpad_fetch_trades\` - Legacy trade fetching
+- \`gala_launchpad_get_v1_trades\` - Flexible trade queries with filters
 `,
     'utilities-and-helpers': `
 ## Utility Methods and Helpers
@@ -2101,6 +2268,26 @@ console.log(\`Initial buy: \${buyAmount} tokens\`);
 await sdk.cleanup();
 \`\`\`
 
+### Monitor Bundler Transactions
+
+\`\`\`typescript
+// After a trade, monitor transaction status
+const tradeResult = await sdk.buy({ tokenName, amount, type: 'native', expectedAmount, slippageToleranceFactor: 0.01 });
+
+// Poll for completion
+const status = await sdk.getBundlerTransactionResult(tradeResult.transactionId);
+console.log('Status:', status.status); // PENDING, PROCESSING, COMPLETED, FAILED
+
+// Wait with polling
+let attempts = 0;
+while (status.status === 'PENDING' || status.status === 'PROCESSING') {
+  await new Promise(r => setTimeout(r, 2000));
+  const updated = await sdk.getBundlerTransactionResult(tradeResult.transactionId);
+  if (updated.status === 'COMPLETED') break;
+  if (++attempts > 30) throw new Error('Transaction timeout');
+}
+\`\`\`
+
 **MCP Tools:**
 - \`gala_launchpad_fetch_gala_price\`
 - \`gala_launchpad_fetch_token_classes_with_supply\`
@@ -2239,9 +2426,9 @@ async function analyzeVolumeTrends() {
   const trend7d = summary.volume7dDelta > 0 ? '📈 UP' : '📉 DOWN';
   const trend30d = summary.volume30dDelta > 0 ? '📈 UP' : '📉 DOWN';
 
-  console.log(\`1-Day Trend: \${trend1d} (\${(summary.volume1dDelta * 100).toFixed(2)}%)\`);
-  console.log(\`7-Day Trend: \${trend7d} (\${(summary.volume7dDelta * 100).toFixed(2)}%)\`);
-  console.log(\`30-Day Trend: \${trend30d} (\${(summary.volume30dDelta * 100).toFixed(2)}%)\`);
+  console.log(\`1-Day Trend: \${trend1d} (\${toBigNumberFixed(summary.volume1dDelta * 100, 2)}%)\`);
+  console.log(\`7-Day Trend: \${trend7d} (\${toBigNumberFixed(summary.volume7dDelta * 100, 2)}%)\`);
+  console.log(\`30-Day Trend: \${trend30d} (\${toBigNumberFixed(summary.volume30dDelta * 100, 2)}%)\`);
 
   // Growth analysis
   if (summary.volume30dDelta > 0.1) {
@@ -2290,8 +2477,8 @@ async function queryDexPools() {
   console.log(\`Total pools: \${allPools.pools.length}\`);
 
   // Analyze pool metrics
-  const avgTvl = allPools.pools.reduce((sum, p) => sum + parseFloat(p.tvl), 0) / allPools.pools.length;
-  console.log(\`Average TVL: $\${avgTvl.toFixed(2)}\`);
+  const avgTvl = allPools.pools.reduce((sum, p) => sum + safeParseFloat(p.tvl, 0), 0) / allPools.pools.length;
+  console.log(\`Average TVL: $\${toBigNumberFixed(avgTvl, 2)}\`);
 }
 \`\`\`
 
@@ -2637,7 +2824,7 @@ async function sdkUtilities() {
 Subscribe to real-time WebSocket events for DEX trading, liquidity changes, and token launches.
 
 \`\`\`typescript
-import { createLaunchpadSDK } from '@gala-chain/launchpad-sdk';
+import { createLaunchpadSDK, compareAmounts } from '@gala-chain/launchpad-sdk';
 
 async function subscribeToEvents() {
   const sdk = createLaunchpadSDK({ wallet: 'your-private-key' });
@@ -2776,7 +2963,8 @@ async function subscribeToEvents() {
 
       // Check if pool has sufficient depth for arbitrage
       const poolInfo = await sdk.getSwapPoolInfo(event.token0, event.token1);
-      if (parseFloat(poolInfo.liquidity) > 100000) {
+      // Use compareAmounts for precise liquidity threshold comparison
+      if (compareAmounts(poolInfo.liquidity, '100000') > 0) {
         console.log('Pool has sufficient liquidity for arbitrage');
       }
     });
@@ -2798,7 +2986,8 @@ async function subscribeToEvents() {
         const poolInfo = await sdk.getSwapPoolInfo(pool.token0, pool.token1);
 
         // Add liquidity if TVL is high enough
-        if (parseFloat(poolInfo.liquidity) > 50000) {
+        // Use compareAmounts for precise liquidity threshold comparison
+        if (compareAmounts(poolInfo.liquidity, '50000') > 0) {
           await sdk.addSwapLiquidityByPrice({
             token0: pool.token0,
             token1: pool.token1,
@@ -2879,6 +3068,50 @@ async function subscribeToEvents() {
 - **Position Monitoring**: Track liquidity changes in your positions
 - **Market Analysis**: Analyze trading patterns and volumes
 
+### WebSocket Connection Lifecycle
+
+\`\`\`typescript
+// Handle connection lifecycle events
+await sdk.connectStreamWebSocket({
+  onConnect: () => {
+    console.log('WebSocket connected');
+  },
+  onDisconnect: (reason) => {
+    console.log('WebSocket disconnected:', reason);
+    // Implement reconnection logic if needed
+  },
+  onError: (error) => {
+    console.error('WebSocket error:', error);
+  }
+});
+
+// Check connection state
+if (sdk.isStreamWebSocketConnected()) {
+  console.log('Ready to send/receive messages');
+}
+\`\`\`
+
+### Typing Indicators
+
+\`\`\`typescript
+// Subscribe to typing indicators in chat
+await sdk.connectStreamWebSocket({
+  onTypingIndicator: (event) => {
+    if (event.isTyping) {
+      console.log(\`\${event.userAddress} is typing...\`);
+    } else {
+      console.log(\`\${event.userAddress} stopped typing\`);
+    }
+  }
+});
+
+// Send typing indicator (auto-expires after 5 seconds)
+await sdk.sendTypingIndicator({
+  tokenName: 'anime',
+  isTyping: true
+});
+\`\`\`
+
 **MCP Tool Equivalents:**
 - \`gala_launchpad_subscribe_to_dex_liquidity_added\`
 - \`gala_launchpad_subscribe_to_dex_liquidity_changed\`
@@ -2907,13 +3140,13 @@ This is a conceptual guide showing how MCP (Model Context Protocol) tools map to
 \`\`\`
 ┌─────────────────────────────────────────────────────────────┐
 │                     MCP Server Layer                         │
-│  (89 tools - user-friendly wrappers with validation)        │
+│  (181 tools - user-friendly wrappers with validation)       │
 └─────────────────────────────────────────────────────────────┘
                             │
                             ▼
 ┌─────────────────────────────────────────────────────────────┐
 │                    LaunchpadSDK Layer                        │
-│   (91 methods - low-level programmatic access)              │
+│   (116 methods - low-level programmatic access)             │
 └─────────────────────────────────────────────────────────────┘
                             │
                             ▼
@@ -3588,6 +3821,1574 @@ interface RegisterAccountResult {
 
 **MCP Tool Equivalents:**
 - \`gala_launchpad_register_account\`
+`,
+    // ============================================================================
+    // LIVE STREAMING: Stream Management & Recordings
+    // ============================================================================
+    'streaming': `
+# Live Streaming SDK
+
+The SDK provides comprehensive live streaming management including stream control,
+recordings management, and simulcast to external platforms.
+
+## Starting a Stream
+
+\`\`\`typescript
+import { createLaunchpadSDK } from '@gala-chain/launchpad-sdk';
+
+async function manageStream() {
+  const sdk = createLaunchpadSDK({
+    wallet: 'your-private-key',
+    streamWebSocketUrl: 'wss://stream.example.com',  // Required for streaming
+    streamAdminApiKey: 'your-admin-key',  // Optional: for admin operations
+  });
+
+  // Start a stream for your token
+  const stream = await sdk.startStream('mytoken');
+  console.log('Stream Key:', stream.streamKey);
+  console.log('RTMP URL:', stream.rtmpUrl);
+  console.log('Playback URL:', stream.playbackUrl);
+  // Use stream.streamKey in OBS or other RTMP software
+
+  // Get stream info (public endpoint)
+  const info = await sdk.getStreamInfo('mytoken');
+  console.log('Status:', info.status);  // IDLE, ACTIVE, DISABLED
+  console.log('Is Live:', info.isLive);
+  console.log('Viewers:', info.viewerCount);
+
+  // Stop the stream when done
+  await sdk.stopStream('mytoken');
+  console.log('Stream stopped');
+
+  // Reset stream key if compromised
+  const newKey = await sdk.resetStreamKey('mytoken');
+  console.log('New Stream Key:', newKey.streamKey);
+}
+\`\`\`
+
+## Recordings Management
+
+\`\`\`typescript
+async function manageRecordings() {
+  const sdk = createLaunchpadSDK({ wallet: 'your-private-key' });
+
+  // List recordings (paginated)
+  const recordings = await sdk.getStreamRecordings({
+    tokenName: 'mytoken',
+    page: 1,
+    limit: 20,
+  });
+  console.log('Total recordings:', recordings.total);
+
+  for (const rec of recordings.recordings) {
+    console.log('Asset ID:', rec.assetId);
+    console.log('Duration:', rec.duration, 'seconds');
+    console.log('Status:', rec.status);  // READY, PROCESSING, ERRORED
+  }
+
+  // Get download URL for a recording
+  const download = await sdk.getRecordingDownload('mytoken', 'asset-123');
+  console.log('Download URL:', download.downloadUrl);
+  console.log('Expires:', download.expiresAt);
+
+  // Delete a recording
+  await sdk.deleteRecording('mytoken', 'asset-123');
+}
+\`\`\`
+
+## Simulcast Management
+
+Rebroadcast your stream to external platforms (YouTube, Twitch, Facebook).
+
+\`\`\`typescript
+async function manageSimulcast() {
+  const sdk = createLaunchpadSDK({ wallet: 'your-private-key' });
+
+  // Get existing simulcast targets
+  const targets = await sdk.getSimulcastTargets('mytoken');
+  console.log('Max targets:', targets.maxTargets);
+  console.log('Current targets:', targets.targets.length);
+
+  // Add YouTube simulcast
+  const youtube = await sdk.addSimulcastTarget({
+    tokenName: 'mytoken',
+    platform: 'YOUTUBE',
+    rtmpUrl: 'rtmp://a.rtmp.youtube.com/live2',
+    streamKey: 'your-youtube-stream-key',
+    name: 'My YouTube Channel',
+  });
+  console.log('Added target:', youtube.target.targetId);
+
+  // Add Twitch simulcast
+  await sdk.addSimulcastTarget({
+    tokenName: 'mytoken',
+    platform: 'TWITCH',
+    rtmpUrl: 'rtmp://live.twitch.tv/app',
+    streamKey: 'live_123456_abcdef',
+    name: 'Twitch Stream',
+  });
+
+  // Remove a simulcast target
+  await sdk.removeSimulcastTarget('mytoken', youtube.target.targetId);
+}
+\`\`\`
+
+## Admin Operations
+
+Enable/disable streaming globally or per-token (requires admin API key).
+
+\`\`\`typescript
+async function adminOperations() {
+  const sdk = createLaunchpadSDK({
+    wallet: 'your-private-key',
+    streamAdminApiKey: 'your-admin-key',
+  });
+
+  // Disable streaming for a specific token (admin-only)
+  await sdk.disableStream('mytoken');
+
+  // Re-enable streaming for a token (admin-only)
+  await sdk.enableStream('mytoken');
+
+  // Get global streaming status
+  const globalStatus = await sdk.getGlobalStreamingStatus();
+  console.log('Global streaming enabled:', globalStatus.enabled);
+
+  // Enable/disable streaming globally (maintenance mode)
+  await sdk.setGlobalStreamingEnabled(false);  // Disable all streams
+  await sdk.setGlobalStreamingEnabled(true);   // Re-enable
+}
+\`\`\`
+
+**Available SDK Methods:**
+| Method | Description | Auth |
+|--------|-------------|------|
+| \`startStream(tokenName)\` | Start a stream | Wallet |
+| \`stopStream(tokenName)\` | Stop a stream | Wallet |
+| \`getStreamInfo(tokenName)\` | Get stream status | Public |
+| \`resetStreamKey(tokenName)\` | Generate new stream key | Wallet |
+| \`disableStream(tokenName)\` | Disable token streaming | Admin |
+| \`enableStream(tokenName)\` | Enable token streaming | Admin |
+| \`getStreamRecordings(options)\` | List recordings | Public |
+| \`getRecordingDownload(tokenName, assetId)\` | Get download URL | Wallet |
+| \`deleteRecording(tokenName, assetId)\` | Delete recording | Wallet |
+| \`getSimulcastTargets(tokenName)\` | List simulcast targets | Public |
+| \`addSimulcastTarget(options)\` | Add simulcast target | Wallet |
+| \`removeSimulcastTarget(tokenName, targetId)\` | Remove target | Wallet |
+| \`getGlobalStreamingStatus()\` | Get global status | Public |
+| \`setGlobalStreamingEnabled(enabled)\` | Enable/disable globally | Admin |
+| \`getAvailableRoles()\` | Get list of available streaming roles | Public |
+| \`getStreamRole(options)\` | Get user's role for a token | JWT |
+| \`getTokenAccess(options)\` | Check user's access to a token stream | JWT (optional) |
+
+**MCP Tool Equivalents:**
+- \`gala_launchpad_start_stream\`
+- \`gala_launchpad_stop_stream\`
+- \`gala_launchpad_get_stream_info\`
+- \`gala_launchpad_reset_stream_key\`
+- \`gala_launchpad_disable_stream\`
+- \`gala_launchpad_enable_stream\`
+- \`gala_launchpad_get_stream_recordings\`
+- \`gala_launchpad_get_recording_download\`
+- \`gala_launchpad_delete_recording\`
+- \`gala_launchpad_get_simulcast_targets\`
+- \`gala_launchpad_add_simulcast_target\`
+- \`gala_launchpad_remove_simulcast_target\`
+- \`gala_launchpad_get_global_streaming_status\`
+- \`gala_launchpad_set_global_streaming_enabled\`
+- \`gala_launchpad_get_available_roles\`
+- \`gala_launchpad_get_stream_role\`
+- \`gala_launchpad_get_token_access\`
+`,
+    // ============================================================================
+    // STREAM CHAT: Real-time Chat Operations
+    // ============================================================================
+    'stream-chat': `
+# Stream Chat SDK
+
+The SDK provides chat functionality for live streams, including REST API and
+WebSocket real-time messaging.
+
+## REST API Chat
+
+\`\`\`typescript
+import { createLaunchpadSDK } from '@gala-chain/launchpad-sdk';
+
+async function restChat() {
+  const sdk = createLaunchpadSDK({ wallet: 'your-private-key' });
+
+  // Get chat messages (public endpoint)
+  const messages = await sdk.getChatMessages({
+    tokenName: 'mytoken',
+    page: 1,
+    limit: 50,
+  });
+
+  for (const msg of messages.messages) {
+    console.log(\`[\${msg.createdAt}] \${msg.user?.fullName}: \${msg.content}\`);
+  }
+
+  // Send a chat message via REST
+  const sent = await sdk.sendChatMessage({
+    tokenName: 'mytoken',
+    content: 'Hello everyone!',
+  });
+  console.log('Message ID:', sent.message.messageId);
+
+  // Delete a chat message (user can delete own, admin can delete any)
+  const deleted = await sdk.deleteChatMessage({
+    tokenName: 'mytoken',
+    messageId: sent.message.messageId,
+  });
+  console.log('Message deleted:', deleted.deleted);
+
+  // Check chat status
+  const status = await sdk.getChatStatus('mytoken');
+  console.log('Chat enabled:', status.enabled);
+  if (!status.enabled) {
+    console.log('Reason:', status.reason);  // 'global' or 'token'
+  }
+}
+\`\`\`
+
+## WebSocket Real-time Chat
+
+Lower latency messaging with real-time updates.
+
+\`\`\`typescript
+async function webSocketChat() {
+  const sdk = createLaunchpadSDK({
+    wallet: 'your-private-key',
+    streamWebSocketUrl: 'wss://stream.example.com',
+  });
+
+  // Connect with event callbacks
+  await sdk.connectStreamWebSocket({
+    onConnect: () => console.log('Connected!'),
+    onDisconnect: (reason) => console.log('Disconnected:', reason),
+    onError: (error) => console.error('Error:', error),
+    onChatMessage: (msg) => {
+      console.log(\`[\${msg.tokenName}] \${msg.userAddress}: \${msg.content}\`);
+    },
+    onViewerCount: (data) => {
+      console.log(\`Viewers on \${data.tokenName}: \${data.count}\`);
+    },
+    onStreamStatus: (status) => {
+      console.log(\`Stream \${status.tokenName}: \${status.status}\`);
+    },
+  });
+
+  // Authenticate (required for sending messages)
+  await sdk.authenticateStreamWebSocket();
+
+  // Subscribe to a stream's events
+  const subscribed = await sdk.subscribeToStream('mytoken');
+  console.log('Subscribed, stream status:', subscribed.status);
+
+  // Send message via WebSocket (lower latency)
+  await sdk.sendStreamChatViaWebSocket('mytoken', 'Hello via WebSocket!');
+
+  // Send emoji reaction (ephemeral, not persisted)
+  await sdk.sendStreamReaction('mytoken', '🔥', 0);
+
+  // Unsubscribe when done
+  await sdk.unsubscribeFromStream('mytoken');
+
+  // Disconnect
+  sdk.disconnectStreamWebSocket();
+}
+\`\`\`
+
+## Admin Chat Operations
+
+\`\`\`typescript
+async function adminChat() {
+  const sdk = createLaunchpadSDK({
+    wallet: 'your-private-key',
+    streamAdminApiKey: 'your-admin-key',
+  });
+
+  // Disable chat for a token
+  await sdk.disableChat('mytoken');
+
+  // Re-enable chat
+  await sdk.enableChat('mytoken');
+
+  // Get global chat status
+  const globalStatus = await sdk.getGlobalChatStatus();
+  console.log('Global chat enabled:', globalStatus.enabled);
+
+  // Disable/enable chat globally
+  await sdk.setGlobalChatEnabled(false);  // Disable all chat
+  await sdk.setGlobalChatEnabled(true);   // Re-enable
+}
+\`\`\`
+
+**WebSocket Events:**
+| Event | Description | Payload |
+|-------|-------------|---------|
+| \`chat_message\` | New chat message | \`{ tokenName, messageId, content, userAddress, user? }\` |
+| \`viewer_count\` | Viewer count update | \`{ tokenName, count }\` |
+| \`stream_status\` | Stream status change | \`{ tokenName, status, isLive, playbackId }\` |
+| \`chat_status\` | Chat enabled/disabled | \`{ tokenName, enabled }\` |
+
+**Available SDK Methods:**
+| Method | Description | Auth |
+|--------|-------------|------|
+| \`getChatMessages(options)\` | Get chat history | Public |
+| \`sendChatMessage(options)\` | Send via REST | Wallet |
+| \`deleteChatMessage(options)\` | Delete message | Wallet/Admin |
+| \`getChatStatus(tokenName)\` | Check chat status | Public |
+| \`disableChat(tokenName)\` | Disable token chat | Admin |
+| \`enableChat(tokenName)\` | Enable token chat | Admin |
+| \`getGlobalChatStatus()\` | Get global status | Public |
+| \`setGlobalChatEnabled(enabled)\` | Enable/disable globally | Admin |
+| \`connectStreamWebSocket(callbacks)\` | Connect WebSocket | None |
+| \`authenticateStreamWebSocket()\` | Authenticate WS | Wallet |
+| \`subscribeToStream(tokenName)\` | Subscribe to events | None |
+| \`unsubscribeFromStream(tokenName)\` | Unsubscribe | None |
+| \`sendStreamChatViaWebSocket(tokenName, content)\` | Send via WS | Wallet |
+| \`sendStreamReaction(tokenName, emoji, streamTime)\` | Send emoji reaction | Wallet |
+| \`disconnectStreamWebSocket()\` | Close connection | None |
+| \`getEngagementStats(tokenName)\` | Get viewer and chat engagement stats | Public |
+
+**MCP Tool Equivalents:**
+- \`gala_launchpad_get_chat_messages\`
+- \`gala_launchpad_send_chat_message\`
+- \`gala_launchpad_delete_chat_message\`
+- \`gala_launchpad_get_chat_status\`
+- \`gala_launchpad_set_chat_enabled\`
+- \`gala_launchpad_get_global_chat_status\`
+- \`gala_launchpad_set_global_chat_enabled\`
+- \`gala_launchpad_connect_stream_websocket\`
+- \`gala_launchpad_subscribe_to_stream\`
+- \`gala_launchpad_send_stream_chat_websocket\`
+- \`gala_launchpad_send_stream_reaction\`
+- \`gala_launchpad_get_engagement_stats\`
+`,
+    // ============================================================================
+    // SESSION AUTHENTICATION (JWT)
+    // ============================================================================
+    'session-auth': `
+# Session Authentication (JWT) - SDK v5.1.0+
+
+JWT-based session authentication for protected operations (streaming, chat, profile updates).
+
+## Authentication Flow
+
+\`\`\`typescript
+import { createLaunchpadSDK } from '@gala-chain/launchpad-sdk';
+
+const sdk = createLaunchpadSDK({
+  privateKey: process.env.PRIVATE_KEY,
+  environment: 'production',
+});
+
+// 1. Login to get JWT token
+const session = await sdk.login();
+console.log('Authenticated:', session.address);
+console.log('Token expires in:', session.expiresIn, 'seconds');
+
+// 2. Check authentication status
+if (sdk.isAuthenticated()) {
+  console.log('Session is valid');
+}
+
+// 3. Get current session info
+const info = await sdk.getSession();
+console.log('Session issued at:', info.issuedAt);
+console.log('Session expires at:', info.expiresAt);
+
+// 4. Access token directly (for custom requests)
+const token = sdk.getAccessToken();
+console.log('JWT token:', token);
+
+// 5. Refresh token before expiry
+if (sdk.shouldRefreshToken()) {
+  const refreshed = await sdk.refreshToken();
+  console.log('Token refreshed, new expiry:', refreshed.expiresIn);
+}
+
+// 6. Ensure valid token (auto-refreshes if needed)
+const validToken = await sdk.ensureValidToken();
+console.log('Valid token obtained');
+
+// 7. Logout when done
+sdk.logout();
+console.log('Logged out');
+\`\`\`
+
+## Auto-Refresh Behavior
+
+The SDK automatically refreshes tokens when:
+- Token expires within 5 minutes (default threshold)
+- Making requests to JWT-protected endpoints
+
+\`\`\`typescript
+// Manual refresh threshold check
+const shouldRefresh = sdk.shouldRefreshToken(10 * 60 * 1000); // 10 min threshold
+
+// ensureValidToken auto-refreshes if needed
+const token = await sdk.ensureValidToken(5 * 60 * 1000); // 5 min threshold
+\`\`\`
+
+## Protected Endpoints
+
+These operations require JWT authentication (call \\\`login()\\\` first):
+
+**Streaming:**
+- \\\`startStream()\\\` - Start live stream
+- \\\`resetStreamKey()\\\` - Reset RTMP key
+- \\\`getRecordingDownload()\\\` - Download recordings
+- \\\`deleteRecording()\\\` - Delete recordings
+- \\\`addSimulcastTarget()\\\` - Add simulcast
+- \\\`removeSimulcastTarget()\\\` - Remove simulcast
+
+**Chat:**
+- \\\`sendChatMessage()\\\` - Send chat messages
+
+**Profile:**
+- \\\`updateProfile()\\\` - Update user profile
+
+**Uploads:**
+- \\\`uploadTokenImage()\\\` - Upload token images
+- \\\`uploadProfileImage()\\\` - Upload profile images
+
+## Error Handling
+
+\`\`\`typescript
+try {
+  await sdk.login();
+} catch (error) {
+  if (error.message.includes('signature')) {
+    console.error('Wallet signature failed');
+  } else if (error.message.includes('network')) {
+    console.error('Network error during login');
+  }
+}
+
+// Check auth before protected operations
+if (!sdk.isAuthenticated()) {
+  await sdk.login();
+}
+
+try {
+  await sdk.startStream('mytoken');
+} catch (error) {
+  if (error.message.includes('JWT') || error.message.includes('token')) {
+    // Re-authenticate and retry
+    await sdk.login();
+    await sdk.startStream('mytoken');
+  }
+}
+\`\`\`
+
+## Session Methods Reference
+
+| Method | Description | Returns |
+|--------|-------------|---------|
+| \\\`login()\\\` | Authenticate with wallet signature | \\\`{ accessToken, expiresIn, address }\\\` |
+| \\\`logout()\\\` | Clear JWT token (client-side) | \\\`void\\\` |
+| \\\`refreshToken()\\\` | Get new JWT token | \\\`{ accessToken, expiresIn, address }\\\` |
+| \\\`getSession()\\\` | Get session info | \\\`{ address, issuedAt, expiresAt }\\\` |
+| \\\`isAuthenticated()\\\` | Check if token exists and valid | \\\`boolean\\\` |
+| \\\`shouldRefreshToken(threshold?)\\\` | Check if refresh needed | \\\`boolean\\\` |
+| \\\`getAccessToken()\\\` | Get raw JWT token | \\\`string | null\\\` |
+| \\\`ensureValidToken(threshold?)\\\` | Auto-refresh if needed | \\\`Promise<string>\\\` |
+
+## Dev Bypass (STAGE Only)
+
+For testing in STAGE environment without JWT:
+
+\`\`\`typescript
+const sdk = createLaunchpadSDK({
+  privateKey: process.env.PRIVATE_KEY,
+  environment: 'development',
+  devBypass: true, // Skip JWT auth in STAGE
+});
+
+// Protected methods work without login() in STAGE
+await sdk.startStream('testtoken');
+\`\`\`
+
+**Note:** Dev bypass only works in STAGE/development environments.
+`,
+    // ============================================================================
+    // BAN/MODERATION OPERATIONS
+    // ============================================================================
+    'ban-management': `
+# Ban/Moderation Operations - SDK v5.5.0+
+
+User ban management for stream moderation, including creating bans, removing bans,
+listing banned users, checking ban status, and viewing active users.
+
+## Creating and Removing Bans
+
+\`\`\`typescript
+import { createLaunchpadSDK, BAN_DURATIONS } from '@gala-chain/launchpad-sdk';
+
+const sdk = createLaunchpadSDK({
+  privateKey: process.env.PRIVATE_KEY,
+  streamAdminApiKey: process.env.STREAM_ADMIN_API_KEY, // Admin key for ban ops
+});
+
+// Create a permanent ban
+const permanentBan = await sdk.createBan({
+  tokenName: 'mytoken',
+  userAddress: 'eth|0x1234567890abcdef1234567890abcdef12345678',
+  reason: 'Spamming chat',
+});
+console.log('Permanent ban created:', permanentBan.ban.id);
+
+// Create a temporary ban (1 hour)
+const tempBan = await sdk.createBan({
+  tokenName: 'mytoken',
+  userAddress: 'eth|0xabcdef1234567890abcdef1234567890abcdef12',
+  reason: 'Inappropriate behavior',
+  durationSeconds: BAN_DURATIONS.ONE_HOUR, // 3600 seconds
+});
+console.log('Temp ban expires:', tempBan.ban.expiresAt);
+
+// Remove a ban (unban user)
+const unbanned = await sdk.removeBan({
+  tokenName: 'mytoken',
+  userAddress: 'eth|0x1234567890abcdef1234567890abcdef12345678',
+});
+console.log('User unbanned:', unbanned.removed);
+\`\`\`
+
+## Duration Presets
+
+\`\`\`typescript
+import { BAN_DURATIONS } from '@gala-chain/launchpad-sdk';
+
+// Available presets
+BAN_DURATIONS.ONE_HOUR   // 3600 seconds (1 hour)
+BAN_DURATIONS.ONE_DAY    // 86400 seconds (24 hours)
+BAN_DURATIONS.ONE_WEEK   // 604800 seconds (7 days)
+BAN_DURATIONS.ONE_MONTH  // 2592000 seconds (30 days)
+
+// Custom duration (min: 60 sec, max: 31536000 sec / 1 year)
+const customBan = await sdk.createBan({
+  tokenName: 'mytoken',
+  userAddress: 'eth|0x...',
+  durationSeconds: 7200, // 2 hours
+});
+\`\`\`
+
+## Listing Bans
+
+\`\`\`typescript
+// List all bans for a token
+const allBans = await sdk.listBans({
+  tokenName: 'mytoken',
+  page: 1,
+  limit: 20,
+});
+console.log('Total bans:', allBans.meta.total);
+
+for (const ban of allBans.bans) {
+  console.log(\`- \${ban.userAddress}: \${ban.reason || 'No reason'}\`);
+  console.log(\`  Permanent: \${ban.isPermanent}\`);
+  console.log(\`  Expires: \${ban.expiresAt || 'Never'}\`);
+}
+
+// Search bans by user
+const searchResults = await sdk.listBans({
+  tokenName: 'mytoken',
+  search: '0x1234', // Searches userAddress OR fullName
+});
+
+// Filter by specific field
+const filteredBans = await sdk.listBans({
+  tokenName: 'mytoken',
+  userAddress: '0x1234', // Filter by address only
+  name: 'John',          // Filter by display name only
+});
+\`\`\`
+
+## Checking Ban Status
+
+\`\`\`typescript
+// Check if specific user is banned
+const status = await sdk.getBanStatus({
+  tokenName: 'mytoken',
+  userAddress: 'eth|0x1234567890abcdef1234567890abcdef12345678',
+});
+
+if (status.banned) {
+  console.log('User is banned!');
+  console.log('Reason:', status.ban?.reason);
+  console.log('Permanent:', status.ban?.isPermanent);
+  console.log('Expires:', status.ban?.expiresAt);
+} else {
+  console.log('User is not banned');
+}
+\`\`\`
+
+## Viewing Active Users
+
+\`\`\`typescript
+import { ACTIVE_USER_TYPE } from '@gala-chain/launchpad-sdk';
+
+// Get all active viewers
+const viewers = await sdk.getActiveUsers({
+  tokenName: 'mytoken',
+  type: ACTIVE_USER_TYPE.VIEWERS, // or 'viewers'
+});
+console.log('Active viewers:', viewers.total);
+
+// Get only chat participants
+const chatters = await sdk.getActiveUsers({
+  tokenName: 'mytoken',
+  type: ACTIVE_USER_TYPE.CHAT_PARTICIPANTS, // or 'chat_participants'
+});
+console.log('Chat participants:', chatters.total);
+
+// Search active users
+const searchActive = await sdk.getActiveUsers({
+  tokenName: 'mytoken',
+  search: 'john', // Search by name or address
+});
+
+for (const user of searchActive.users) {
+  console.log(\`- \${user.fullName || user.userAddress}\`);
+  console.log(\`  In chat: \${user.isChatParticipant}\`);
+}
+\`\`\`
+
+## Authentication
+
+Ban operations support two authentication modes:
+
+1. **Admin API Key** (streamAdminApiKey) - Full moderation access
+2. **JWT Auth** (login()) - Token owner moderation only
+
+\`\`\`typescript
+// Admin mode - can moderate any token
+const adminSdk = createLaunchpadSDK({
+  privateKey: process.env.PRIVATE_KEY,
+  streamAdminApiKey: process.env.STREAM_ADMIN_API_KEY,
+});
+
+// Owner mode - can only moderate own tokens
+const ownerSdk = createLaunchpadSDK({
+  privateKey: process.env.PRIVATE_KEY,
+});
+await ownerSdk.login(); // JWT authentication required
+\`\`\`
+
+## WebSocket Events
+
+Ban events are broadcast to affected users via WebSocket:
+
+\`\`\`typescript
+// Listen for ban events
+sdk.connectStreamWebSocket({
+  onUserBanned: (event) => {
+    console.log('User banned:', event.userAddress);
+    console.log('Reason:', event.reason);
+    console.log('Expires:', event.expiresAt);
+  },
+  onUserUnbanned: (event) => {
+    console.log('User unbanned:', event.userAddress);
+  },
+  onBanEnforcement: (event) => {
+    // Received when banned user tries to chat/react
+    console.log('Ban enforced for action:', event.action);
+    console.log('Reason:', event.reason);
+  },
+});
+\`\`\`
+
+## SDK Methods Reference
+
+| Method | Description | Auth |
+|--------|-------------|------|
+| \`createBan(options)\` | Create a new ban | Admin/Owner |
+| \`removeBan(options)\` | Remove a ban (unban user) | Admin/Owner |
+| \`listBans(options)\` | List banned users | Admin/Owner |
+| \`getBanStatus(options)\` | Check if user is banned | Admin/Owner |
+| \`getActiveUsers(options)\` | Get active viewers/chatters | Admin/Owner |
+
+**MCP Tool Equivalents:**
+- \`gala_launchpad_create_ban\`
+- \`gala_launchpad_remove_ban\`
+- \`gala_launchpad_list_bans\`
+- \`gala_launchpad_get_ban_status\`
+- \`gala_launchpad_get_active_users\`
+`,
+    'api-key-management': `
+# API Key Management - SDK v5.6.0+
+
+User-managed API keys with role-based permissions for delegating token management
+authority to third-party services or automated systems.
+
+**CRITICAL**: Raw API keys are ONLY shown once at creation time. Store them
+securely immediately - they cannot be retrieved again.
+
+## Creating API Keys
+
+\`\`\`typescript
+import { createLaunchpadSDK, API_KEY_ROLE } from '@gala-chain/launchpad-sdk';
+
+const sdk = createLaunchpadSDK({
+  privateKey: process.env.PRIVATE_KEY,
+});
+
+// MUST authenticate first
+await sdk.login();
+
+// Create a moderator key for specific tokens
+const result = await sdk.createApiKey({
+  role: API_KEY_ROLE.MODERATOR,
+  description: 'Chat moderation bot',
+  delegateAllTokens: false,
+  tokenNames: ['mytoken', 'othertoken'],
+  expiresAt: '2025-12-31T23:59:59Z', // Optional expiration
+});
+
+// CRITICAL: Save this immediately - shown only once!
+console.log('Raw Key:', result.rawKey);
+// Format: glp_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
+console.log('Key ID:', result.id);
+console.log('Prefix:', result.keyPrefix);
+\`\`\`
+
+## Role Hierarchy
+
+\`\`\`typescript
+import { API_KEY_ROLE, API_KEY_ROLE_HIERARCHY } from '@gala-chain/launchpad-sdk';
+
+// Available roles (hierarchical)
+API_KEY_ROLE.MODERATOR          // Chat, comments, bans
+API_KEY_ROLE.TECHNICAL_PRODUCER // Simulcast, stream key, stop/start
+API_KEY_ROLE.MANAGER            // Moderator + Technical Producer + recordings
+API_KEY_ROLE.OWNER              // Full access (indistinguishable from normal auth)
+
+// Role hierarchy levels
+API_KEY_ROLE_HIERARCHY.MODERATOR           // 1
+API_KEY_ROLE_HIERARCHY.TECHNICAL_PRODUCER  // 1
+API_KEY_ROLE_HIERARCHY.MANAGER             // 2
+API_KEY_ROLE_HIERARCHY.OWNER               // 3
+
+// Check if role has sufficient permission
+import { roleHasSufficientPermission } from '@gala-chain/launchpad-sdk';
+
+const canManage = roleHasSufficientPermission('MANAGER', 'MODERATOR'); // true
+const canOwn = roleHasSufficientPermission('MODERATOR', 'OWNER');      // false
+\`\`\`
+
+## Token Delegation
+
+\`\`\`typescript
+// Delegate all tokens (current and future)
+const allTokensKey = await sdk.createApiKey({
+  role: API_KEY_ROLE.MODERATOR,
+  description: 'All tokens moderator',
+  delegateAllTokens: true,
+});
+
+// Delegate specific tokens only
+const specificKey = await sdk.createApiKey({
+  role: API_KEY_ROLE.MANAGER,
+  description: 'Project manager for specific tokens',
+  delegateAllTokens: false,
+  tokenNames: ['token1', 'token2', 'token3'], // Case-insensitive
+});
+\`\`\`
+
+## Listing and Getting API Keys
+
+\`\`\`typescript
+// List all API keys (paginated)
+const list = await sdk.listApiKeys({
+  page: 1,
+  limit: 20,
+});
+console.log('Total keys:', list.meta.total);
+
+for (const key of list.apiKeys) {
+  console.log(\`- \${key.keyPrefix}: \${key.role}\`);
+  console.log(\`  Description: \${key.description || 'None'}\`);
+  console.log(\`  Last used: \${key.lastUsedAt || 'Never'}\`);
+  console.log(\`  Expires: \${key.expiresAt || 'Never'}\`);
+}
+
+// Get single API key by ID
+const key = await sdk.getApiKey(123);
+console.log('Key details:', key);
+\`\`\`
+
+## Updating API Keys
+
+\`\`\`typescript
+// Update description
+const updated = await sdk.updateApiKey(123, {
+  description: 'Updated description',
+});
+
+// Upgrade role
+await sdk.updateApiKey(123, {
+  role: API_KEY_ROLE.MANAGER,
+});
+
+// Change token delegation
+await sdk.updateApiKey(123, {
+  delegateAllTokens: true,
+});
+
+// Update specific token access (replaces existing)
+await sdk.updateApiKey(123, {
+  delegateAllTokens: false,
+  tokenNames: ['newtoken1', 'newtoken2'],
+});
+
+// Update expiration (null to remove)
+await sdk.updateApiKey(123, {
+  expiresAt: '2026-12-31T23:59:59Z',
+});
+
+// Remove expiration
+await sdk.updateApiKey(123, {
+  expiresAt: null,
+});
+\`\`\`
+
+## Revoking API Keys
+
+\`\`\`typescript
+// Revoke (soft delete) an API key
+await sdk.revokeApiKey(123);
+console.log('API key revoked');
+
+// Key is now unusable - attempts to use it will fail with 401
+\`\`\`
+
+## Getting Available Roles
+
+\`\`\`typescript
+// Get list of valid roles
+const roles = sdk.getApiKeyRoles();
+console.log('Available roles:', roles);
+// ['MODERATOR', 'TECHNICAL_PRODUCER', 'MANAGER', 'OWNER']
+\`\`\`
+
+## Validation Helpers
+
+\`\`\`typescript
+import {
+  isValidApiKeyRole,
+  validateCreateApiKeyOptions,
+  validateUpdateApiKeyOptions,
+} from '@gala-chain/launchpad-sdk';
+
+// Validate role string
+if (isValidApiKeyRole('MODERATOR')) {
+  console.log('Valid role');
+}
+
+// Validate creation options
+const createErrors = validateCreateApiKeyOptions({
+  role: 'MODERATOR',
+  description: 'Test key',
+});
+if (createErrors.length > 0) {
+  console.error('Validation errors:', createErrors);
+}
+
+// Validate update options
+const updateErrors = validateUpdateApiKeyOptions({
+  role: 'MANAGER',
+  expiresAt: '2025-12-31T23:59:59Z',
+});
+\`\`\`
+
+## SDK Methods Reference
+
+| Method | Description | Auth |
+|--------|-------------|------|
+| \`createApiKey(options)\` | Create new API key | JWT |
+| \`listApiKeys(options?)\` | List API keys (paginated) | JWT |
+| \`getApiKey(id)\` | Get API key by ID | JWT |
+| \`updateApiKey(id, options)\` | Update API key | JWT |
+| \`revokeApiKey(id)\` | Revoke (soft delete) key | JWT |
+| \`getApiKeyRoles()\` | Get valid role list | None |
+
+**MCP Tool Equivalents:**
+- \`gala_launchpad_create_api_key\`
+- \`gala_launchpad_list_api_keys\`
+- \`gala_launchpad_get_api_key\`
+- \`gala_launchpad_update_api_key\`
+- \`gala_launchpad_revoke_api_key\`
+- \`gala_launchpad_get_api_key_roles\`
+`,
+    'moderator-invites': `
+# Moderator Invites - SDK v5.7.0+
+
+Magic link-based moderator delegation system. Token owners can create invite
+links to grant stream management access to other users without needing their
+wallet address upfront.
+
+## Flow Overview
+
+1. **Owner creates invite** → Gets magic link URL
+2. **Owner shares link** (email, Slack, Discord, etc.)
+3. **Recipient clicks link** → Redirected to claim page
+4. **Recipient logs in** → Claims invite with their wallet
+5. **Recipient gains access** → Token appears in their /studio dashboard
+
+## Creating Moderator Invites
+
+\`\`\`typescript
+import { createLaunchpadSDK, MODERATOR_ROLE } from '@gala-chain/launchpad-sdk';
+
+const sdk = createLaunchpadSDK({
+  privateKey: process.env.PRIVATE_KEY,
+});
+
+// MUST authenticate first
+await sdk.login();
+
+// Create an invite for a moderator
+const result = await sdk.createModeratorInvite({
+  tokenName: 'mytoken',
+  role: MODERATOR_ROLE.MODERATOR,
+  description: 'John - Friday stream moderator',
+  expiresAt: '2025-12-31T23:59:59Z', // Optional expiration
+});
+
+// Share this URL with the intended moderator
+console.log('Invite URL:', result.invite.inviteUrl);
+console.log('Invite Code:', result.invite.inviteCode);
+console.log('Status:', result.invite.status); // PENDING
+\`\`\`
+
+## Moderator Roles
+
+\`\`\`typescript
+import { MODERATOR_ROLE } from '@gala-chain/launchpad-sdk';
+
+// Available roles (OWNER not available for invites)
+MODERATOR_ROLE.MODERATOR           // Chat, comments, bans
+MODERATOR_ROLE.TECHNICAL_PRODUCER  // Simulcast, stream key, stop/start
+MODERATOR_ROLE.MANAGER             // All of the above + recordings + stream settings
+\`\`\`
+
+## Listing Invites
+
+\`\`\`typescript
+// List all invites for a token (owner only)
+const list = await sdk.listModeratorInvites({
+  tokenName: 'mytoken',
+  status: 'PENDING', // Optional filter: PENDING, CLAIMED, REVOKED, EXPIRED
+  page: 1,
+  limit: 20,
+});
+
+console.log('Total invites:', list.meta.totalItems);
+
+for (const invite of list.invites) {
+  console.log(\`- ID \${invite.id}: \${invite.role}\`);
+  console.log(\`  Status: \${invite.status}\`);
+  console.log(\`  Description: \${invite.description || 'None'}\`);
+  console.log(\`  Created: \${invite.createdAt}\`);
+  console.log(\`  Expires: \${invite.expiresAt || 'Never'}\`);
+}
+\`\`\`
+
+## Claiming Invites (Recipient Side)
+
+\`\`\`typescript
+// Extract code from magic link URL
+const inviteCode = 'abc123...'; // 64-character hex code
+
+// Recipient authenticates and claims
+await sdk.login();
+
+const result = await sdk.claimModeratorInvite({
+  inviteCode: inviteCode,
+});
+
+console.log('Claimed token:', result.token.tokenName);
+console.log('Your role:', result.token.role);
+console.log('Claimed at:', result.token.claimedAt);
+// Token now appears in /studio dashboard
+\`\`\`
+
+## Previewing Invites (Public)
+
+\`\`\`typescript
+// Preview invite details before logging in (public endpoint)
+const preview = await sdk.getModeratorInviteByCode('abc123...');
+
+console.log('Token:', preview.tokenName);
+console.log('Symbol:', preview.tokenSymbol);
+console.log('Role offered:', preview.role);
+console.log('Status:', preview.status);
+console.log('Invited by:', preview.invitedBy.fullName);
+\`\`\`
+
+## Getting Moderated Tokens (Studio Dashboard)
+
+\`\`\`typescript
+// Get all tokens where you have moderator access
+await sdk.login();
+
+const tokens = await sdk.getModeratedTokens({
+  page: 1,
+  limit: 20,
+});
+
+for (const token of tokens.tokens) {
+  console.log(\`- \${token.tokenName} (\${token.tokenSymbol})\`);
+  console.log(\`  Role: \${token.role}\`);
+  console.log(\`  Stream status: \${token.muxStreamStatus}\`);
+}
+\`\`\`
+
+## Revoking Invites
+
+\`\`\`typescript
+// Revoke by invite ID (owner only)
+await sdk.revokeModeratorInvite(123);
+console.log('Invite revoked');
+
+// If already claimed, moderator loses access immediately
+// If pending, invite can no longer be claimed
+\`\`\`
+
+## SDK Methods Reference
+
+| Method | Description | Auth |
+|--------|-------------|------|
+| \`createModeratorInvite(options)\` | Create magic link invite | JWT (owner) |
+| \`claimModeratorInvite(options)\` | Claim invite with code | JWT |
+| \`getModeratedTokens(options?)\` | Get tokens you moderate | JWT |
+| \`listModeratorInvites(options)\` | List invites for token | JWT (owner) |
+| \`revokeModeratorInvite(id)\` | Revoke invite by ID | JWT (owner) |
+| \`getModeratorInviteByCode(code)\` | Preview invite details | None |
+
+**MCP Tool Equivalents:**
+- \`gala_launchpad_create_moderator_invite\`
+- \`gala_launchpad_claim_moderator_invite\`
+- \`gala_launchpad_get_moderated_tokens\`
+- \`gala_launchpad_list_moderator_invites\`
+- \`gala_launchpad_revoke_moderator_invite\`
+- \`gala_launchpad_get_moderator_invite\`
+`,
+    'overseer-invites': `
+# Overseer System - SDK v5.9.0+
+
+Global platform oversight via magic link invites. Overseers have MANAGER-level
+access to ALL tokens (current and future), unlike moderators who have token-scoped access.
+
+## Key Differences from Moderators
+
+| Feature | Moderator | Overseer |
+|---------|-----------|----------|
+| Scope | Per-token or blanket (owner's tokens) | ALL tokens on platform |
+| Access Level | MODERATOR, TECHNICAL_PRODUCER, or MANAGER | Always MANAGER |
+| Grant Authority | Token owner | Admin or existing Overseer |
+| Use Case | Stream management delegation | Platform-wide oversight |
+
+## Creating Overseer Invites
+
+\`\`\`typescript
+import { createLaunchpadSDK } from '@gala-chain/launchpad-sdk';
+
+const sdk = createLaunchpadSDK({
+  privateKey: process.env.PRIVATE_KEY,
+  streamAdminApiKey: process.env.STREAM_ADMIN_API_KEY, // Admin key OR JWT auth
+});
+
+// Option 1: Using Admin API key
+const result = await sdk.createOverseerInvite({
+  description: 'John - Platform Support Team',
+  expiresAt: '2025-12-31T23:59:59Z', // Optional
+});
+
+// Option 2: Using JWT (as existing Overseer)
+await sdk.login();
+const result = await sdk.createOverseerInvite({
+  description: 'Platform team member',
+});
+
+console.log('Share this link:', result.invite.inviteUrl);
+console.log('Invite Code:', result.invite.inviteCode);
+\`\`\`
+
+## Claiming Overseer Invites
+
+\`\`\`typescript
+// Recipient must be authenticated
+await sdk.login();
+
+// Claim the invite
+const claimed = await sdk.claimOverseerInvite('abc123...');
+console.log('Now an overseer!');
+console.log('Status:', claimed.invite.status); // CLAIMED
+
+// Check own status
+const status = await sdk.getMyOverseerStatus();
+console.log('Is Overseer:', status.isOverseer); // true
+console.log('Granted at:', status.overseer?.createdAt);
+\`\`\`
+
+## Listing Overseers and Invites
+
+\`\`\`typescript
+// List all overseer invites (paginated)
+const invites = await sdk.listOverseerInvites({
+  status: 'PENDING', // PENDING, CLAIMED, REVOKED, EXPIRED
+  page: 1,
+  limit: 20,
+});
+
+for (const invite of invites.invites) {
+  console.log(\`#\${invite.id}: \${invite.description || 'No description'}\`);
+  console.log(\`  Status: \${invite.status}\`);
+  console.log(\`  Created by: \${invite.invitedBy.fullName || invite.invitedBy.address}\`);
+}
+
+// List all active overseers
+const overseers = await sdk.listOverseers({
+  status: 'ACTIVE', // ACTIVE or REVOKED
+  page: 1,
+  limit: 20,
+});
+
+for (const overseer of overseers.overseers) {
+  console.log(\`Overseer: \${overseer.userAddress}\`);
+  console.log(\`  Since: \${overseer.createdAt}\`);
+}
+\`\`\`
+
+## Public Invite Preview
+
+\`\`\`typescript
+// Get public info about an invite (no auth required)
+const preview = await sdk.getOverseerInviteByCode('abc123...');
+
+console.log('Status:', preview.status);
+console.log('Description:', preview.description);
+console.log('Invited by:', preview.invitedBy.fullName);
+console.log('Expires:', preview.expiresAt);
+\`\`\`
+
+## Revoking Access
+
+\`\`\`typescript
+// Revoke an invite by ID
+await sdk.revokeOverseerInvite(123);
+console.log('Invite revoked');
+
+// Revoke an overseer by wallet address
+await sdk.revokeOverseer('eth|1234567890abcdef...');
+console.log('Overseer access revoked');
+\`\`\`
+
+## SDK Methods Reference
+
+| Method | Description | Auth |
+|--------|-------------|------|
+| \`createOverseerInvite(options?)\` | Create magic link invite | Admin API key OR JWT (Overseer) |
+| \`claimOverseerInvite(code)\` | Claim invite with code | JWT |
+| \`listOverseerInvites(options?)\` | List all overseer invites | Admin API key OR JWT (Overseer) |
+| \`getOverseerInviteByCode(code)\` | Preview invite details | None (public) |
+| \`revokeOverseerInvite(id)\` | Revoke invite by ID | Admin API key OR JWT (Overseer) |
+| \`listOverseers(options?)\` | List all overseers | Admin API key OR JWT (Overseer) |
+| \`revokeOverseer(address)\` | Revoke overseer by address | Admin API key OR JWT (Overseer) |
+| \`getMyOverseerStatus()\` | Check own overseer status | JWT |
+
+**MCP Tool Equivalents:**
+- \`gala_launchpad_create_overseer_invite\`
+- \`gala_launchpad_claim_overseer_invite\`
+- \`gala_launchpad_list_overseer_invites\`
+- \`gala_launchpad_get_overseer_invite\`
+- \`gala_launchpad_revoke_overseer_invite\`
+- \`gala_launchpad_list_overseers\`
+- \`gala_launchpad_revoke_overseer\`
+- \`gala_launchpad_get_my_overseer_status\`
+- \`gala_launchpad_get_overseer_summary\`
+`,
+    'content-flag-management': `
+# Content Flag Management - SDK v5.11.0+
+
+Content moderation via flags and comments. Moderators can flag content for review,
+take action on flags (delete content, ban users), and manage pool comments.
+
+## Content Types
+
+Flags can be created for:
+- \`MESSAGE\` - Chat messages
+- \`COMMENT\` - Pool comments
+- \`STREAM\` - Live streams (admin only)
+
+## Creating Content Flags
+
+\`\`\`typescript
+import { createLaunchpadSDK, CONTENT_TYPE } from '@gala-chain/launchpad-sdk';
+
+const sdk = createLaunchpadSDK({
+  privateKey: process.env.PRIVATE_KEY,
+});
+
+await sdk.login();
+
+// Flag a chat message
+const flag = await sdk.createFlag({
+  tokenName: 'mytoken',
+  contentType: CONTENT_TYPE.MESSAGE,
+  contentId: 'msg-123',
+  reason: 'Spam/harassment',
+});
+
+console.log('Flag ID:', flag.id);
+console.log('Status:', flag.status); // PENDING
+\`\`\`
+
+## Listing Flags
+
+\`\`\`typescript
+// List all pending flags for a token
+const flags = await sdk.listFlags({
+  tokenName: 'mytoken',
+  status: 'PENDING',
+  page: 1,
+  limit: 20,
+});
+
+for (const flag of flags.flags) {
+  console.log(\`Flag #\${flag.id}: \${flag.contentType}\`);
+  console.log(\`  Reason: \${flag.reason}\`);
+  console.log(\`  Reporter: \${flag.reporterAddress}\`);
+}
+\`\`\`
+
+## Taking Action on Flags
+
+\`\`\`typescript
+// Dismiss a flag (no action taken)
+await sdk.dismissFlag(flagId);
+
+// Take action - delete content only
+await sdk.actionFlag(flagId, {
+  action: 'DELETE_CONTENT',
+});
+
+// Take action - ban the user
+await sdk.actionFlag(flagId, {
+  action: 'BAN_USER',
+  banDuration: 3600, // 1 hour ban
+});
+
+// Take action - delete content AND ban user
+await sdk.actionFlag(flagId, {
+  action: 'DELETE_AND_BAN',
+  banDuration: 86400, // 24 hour ban
+});
+\`\`\`
+
+## Managing Pool Comments with Reactions
+
+Comments include a \`messageId\` for reactions integration and optional \`reactions\` data.
+
+\`\`\`typescript
+// Fetch comments for a pool (with reactions data)
+const comments = await sdk.getComments({
+  tokenName: 'mytoken',
+  page: 1,
+  limit: 20,
+});
+
+for (const comment of comments.comments) {
+  console.log(\`ID: \${comment.id}, MessageId: \${comment.messageId}\`);
+  console.log(\`\${comment.userAddress}: \${comment.content}\`);
+
+  // Check reactions on this comment
+  if (comment.reactions) {
+    console.log(\`Total reactions: \${comment.reactions.totalCount}\`);
+    for (const reaction of comment.reactions.reactions) {
+      console.log(\`  \${reaction.reactionType}: \${reaction.count} (you reacted: \${reaction.userReacted})\`);
+    }
+  }
+}
+
+// Post a comment (requires JWT auth)
+await sdk.login();
+const newComment = await sdk.createComment({
+  tokenName: 'mytoken',
+  content: 'Great project! Looking forward to the launch.',
+});
+console.log('Comment messageId:', newComment.comment.messageId);
+
+// Add a reaction to a comment using its messageId
+await sdk.addReaction({
+  messageId: newComment.comment.messageId,
+  reaction: '👍',
+});
+
+// Remove a reaction
+await sdk.removeReaction({
+  messageId: newComment.comment.messageId,
+  reaction: '👍',
+});
+
+// Delete a comment (moderator only)
+await sdk.deleteComment({ commentId: comment.id });
+\`\`\`
+
+## SDK Methods Reference
+
+| Method | Description | Auth |
+|--------|-------------|------|
+| \`createFlag(options)\` | Flag content for review | JWT |
+| \`listFlags(options)\` | List flags for a token | API key OR JWT (Moderator) |
+| \`dismissFlag(flagId)\` | Dismiss flag (no action) | API key OR JWT (Moderator) |
+| \`actionFlag(flagId, options)\` | Take action on flag | API key OR JWT (Moderator) |
+| \`getComments(options)\` | Get pool comments with reactions | None (public) |
+| \`createComment(options)\` | Post a comment, returns messageId | JWT |
+| \`deleteComment(options)\` | Delete a comment | API key OR JWT (Moderator) |
+| \`addReaction(options)\` | Add reaction to comment/message | JWT |
+| \`removeReaction(options)\` | Remove reaction from comment/message | JWT |
+
+**MCP Tool Equivalents:**
+- \`gala_launchpad_create_flag\`
+- \`gala_launchpad_list_flags\`
+- \`gala_launchpad_dismiss_flag\`
+- \`gala_launchpad_action_flag\`
+- \`gala_launchpad_fetch_comments\`
+- \`gala_launchpad_post_comment\`
+- \`gala_launchpad_delete_comment\`
+- \`gala_launchpad_add_reaction\`
+- \`gala_launchpad_remove_reaction\`
+`,
+    'trade-history': `
+## Trade History
+
+Query and analyze trading activity for tokens.
+
+### Basic Usage
+
+\`\`\`typescript
+import { LaunchpadSDK } from '@gala-chain/launchpad-sdk';
+
+const sdk = new LaunchpadSDK({ environment: 'production' });
+
+// Get recent trades for a token
+const result = await sdk.getTrades({
+  tokenName: 'anime',
+  limit: 10,
+  page: 1
+});
+
+console.log(\`Found \${result.trades.length} trades\`);
+for (const trade of result.trades) {
+  console.log(\`\${trade.txnType}: \${trade.inputAmount} → \${trade.outputAmount}\`);
+}
+\`\`\`
+
+### Filter by Trade Type
+
+\`\`\`typescript
+// Get only buy orders
+const buyTrades = await sdk.getTrades({
+  tokenName: 'anime',
+  txnType: 'BUY',
+  limit: 50
+});
+
+// Get only sell orders
+const sellTrades = await sdk.getTrades({
+  tokenName: 'anime',
+  txnType: 'SELL',
+  limit: 50
+});
+\`\`\`
+
+### Date Range Queries
+
+\`\`\`typescript
+const oneWeekAgo = new Date(Date.now() - 7 * 24 * 60 * 60 * 1000);
+const now = new Date();
+
+const recentTrades = await sdk.getTrades({
+  tokenName: 'anime',
+  startDate: oneWeekAgo,
+  endDate: now,
+  limit: 50
+});
+\`\`\`
+
+### Filter by User
+
+\`\`\`typescript
+// Get trades for a specific wallet
+const userTrades = await sdk.getTrades({
+  tokenName: 'anime',
+  userAddress: 'eth|0x1234...',
+  limit: 20
+});
+\`\`\`
+
+### Pagination
+
+\`\`\`typescript
+// Paginate through all trades
+let page = 1;
+let hasMore = true;
+
+while (hasMore) {
+  const result = await sdk.getTrades({ tokenName: 'anime', page, limit: 50 });
+  console.log(\`Page \${page}: \${result.trades.length} trades\`);
+
+  hasMore = result.trades.length === 50;
+  page++;
+}
+\`\`\`
+
+**MCP Tool Equivalents:**
+- \`gala_launchpad_get_trades\`
+`,
+    // ============================================================================
+    // TOKEN BAN MANAGEMENT (Overseer Only)
+    // ============================================================================
+    'token-ban-management': `
+# Token Ban Management - SDK v6.x.0+
+
+Platform-wide token ban operations for overseers. Banned tokens are hidden from ALL listings
+and have actions (comments, streaming, chat) blocked. This is different from user bans which
+only affect specific users on specific tokens.
+
+**Access Control:** All methods require either:
+- streamAdminApiKey (server-to-server)
+- JWT with overseer status (authenticated overseer user)
+
+**Effects of Token Bans:**
+- Hidden from ALL pool listings (including creator's profile)
+- Comments blocked on banned tokens
+- Live streaming blocked on banned tokens
+- Chat messages blocked on banned tokens
+- Trading NOT blocked (GalaChain handles trading independently)
+
+## Banning a Token
+
+\`\`\`typescript
+import { createLaunchpadSDK } from '@gala-chain/launchpad-sdk';
+
+// Using Admin API key
+const sdk = createLaunchpadSDK({
+  streamAdminApiKey: process.env.STREAM_ADMIN_API_KEY,
+});
+
+// Or using JWT auth (must be an overseer)
+const sdkWithAuth = createLaunchpadSDK({
+  privateKey: process.env.PRIVATE_KEY,
+});
+await sdkWithAuth.login({ walletAddress: 'eth|0x...' });
+
+// Ban a token with reason
+const result = await sdk.banToken({
+  tokenName: 'scamtoken',
+  reason: 'Fraudulent project - reported by multiple users',
+});
+console.log('Token banned:', result.tokenName);
+console.log('Ban ID:', result.ban.id);
+console.log('Banned by:', result.ban.bannedBy);
+
+// Ban without reason (optional)
+await sdk.banToken({ tokenName: 'problematictoken' });
+\`\`\`
+
+## Unbanning a Token
+
+\`\`\`typescript
+// Remove a token ban
+const result = await sdk.unbanToken({ tokenName: 'scamtoken' });
+console.log('Ban removed:', result.removed); // true
+console.log('Token:', result.tokenName);
+
+// Token is now:
+// - Visible in pool listings again
+// - Comments re-enabled
+// - Live streaming re-enabled
+// - Chat re-enabled
+\`\`\`
+
+## Checking Token Ban Status
+
+\`\`\`typescript
+// Check if a specific token is banned
+const status = await sdk.isTokenBanned({ tokenName: 'sometoken' });
+
+if (status.banned) {
+  console.log('Token is banned!');
+  console.log('Reason:', status.ban?.reason);
+  console.log('Banned by:', status.ban?.bannedBy);
+  console.log('Banned at:', status.ban?.createdAt);
+} else {
+  console.log('Token is not banned');
+}
+
+// getTokenBan is an alias - use whichever is more readable
+const details = await sdk.getTokenBan({ tokenName: 'sometoken' });
+\`\`\`
+
+## Listing All Banned Tokens
+
+\`\`\`typescript
+// Get first page with default limit (20)
+const page1 = await sdk.listTokenBans({});
+console.log('Total banned tokens:', page1.meta.total);
+
+for (const ban of page1.items) {
+  console.log(\`- \${ban.tokenName}: \${ban.reason || 'No reason'}\`);
+  console.log(\`  Banned by: \${ban.bannedBy}\`);
+  console.log(\`  Date: \${ban.createdAt}\`);
+}
+
+// Search for specific tokens (partial match, case-insensitive)
+const searchResults = await sdk.listTokenBans({
+  search: 'scam',
+  page: 1,
+  limit: 10,
+});
+
+// Paginate through all banned tokens
+let page = 1;
+let hasMore = true;
+while (hasMore) {
+  const results = await sdk.listTokenBans({ page, limit: 20 });
+  console.log(\`Page \${page}: \${results.items.length} bans\`);
+  for (const ban of results.items) {
+    console.log(\`  - \${ban.tokenName}\`);
+  }
+  hasMore = page < results.meta.totalPages;
+  page++;
+}
+\`\`\`
+
+## Important Notes
+
+1. **Permanent Bans Only**: Token bans do not expire. They remain in effect until
+   explicitly removed by an overseer.
+
+2. **Case Normalization**: Token names are automatically normalized to lowercase
+   in all requests and responses.
+
+3. **Idempotency**: Banning an already-banned token returns a 409 Conflict error.
+   Unbanning a non-banned token returns a 404 Not Found error.
+
+4. **Trading Continues**: Token bans do NOT stop trading on GalaChain. The
+   launchpad hides visibility and blocks social features only.
+
+**MCP Tool Equivalents:**
+- \`gala_launchpad_ban_token\`
+- \`gala_launchpad_unban_token\`
+- \`gala_launchpad_list_token_bans\`
+- \`gala_launchpad_get_token_ban\`
+- \`gala_launchpad_is_token_banned\`
 `,
 };
 /**
@@ -3595,7 +5396,7 @@ interface RegisterAccountResult {
  */
 exports.explainSdkUsageTool = {
     name: 'gala_launchpad_explain_sdk_usage',
-    description: 'Get detailed SDK code examples for all 116 SDK methods organized into 37 composite workflow topics covering: buy-tokens, sell-tokens, pool-graduation, fetch-pools, balances, token-creation, token-status, dex-trading, liquidity-positions, advanced-dex-analysis, price-history, token-details, token-distribution, profile-management, multi-wallet, transfers, locks, trading-analytics, utilities-and-helpers, utilities-system, error-handling, installation, local-calculations, spot-prices-smart-routing, event-subscriptions, mcp-to-sdk-mapping, DEX leaderboards, bridge-operations, dex-token-discovery, wrap-unwrap-operations, referral-system, and account-management',
+    description: 'Get detailed SDK code examples for all 224 MCP tools (mapping to ~208 SDK methods) organized into 48 composite workflow topics covering: buy-tokens, sell-tokens, pool-graduation, fetch-pools, balances, token-creation, token-status, dex-trading, liquidity-positions, advanced-dex-analysis, price-history, token-details, token-distribution, profile-management, multi-wallet, transfers, locks, trading-analytics, utilities-and-helpers, utilities-system, error-handling, installation, local-calculations, spot-prices-smart-routing, event-subscriptions, mcp-to-sdk-mapping, DEX leaderboards, bridge-operations, dex-token-discovery, wrap-unwrap-operations, referral-system, account-management, session-auth, streaming, stream-chat, ban-management, api-key-management, moderator-invites, overseer-invites, content-flag-management, content-reactions, trade-history, and token-ban-management',
     inputSchema: {
         type: 'object',
         properties: {
@@ -3639,6 +5440,17 @@ exports.explainSdkUsageTool = {
                     'wrap-unwrap-operations',
                     'referral-system',
                     'account-management',
+                    'streaming',
+                    'stream-chat',
+                    'session-auth',
+                    'ban-management',
+                    'api-key-management',
+                    'moderator-invites',
+                    'overseer-invites',
+                    'content-flag-management',
+                    'content-reactions',
+                    'trade-history',
+                    'token-ban-management',
                 ],
                 description: 'The SDK usage topic to explain',
             },
@@ -3646,14 +5458,14 @@ exports.explainSdkUsageTool = {
         required: ['topic'],
     },
     handler: (0, error_handler_js_1.withErrorHandling)(async (_sdk, args) => {
-        const example = SDK_EXAMPLES[args.topic];
+        const example = exports.SDK_EXAMPLES[args.topic];
         if (!example) {
             throw new Error('Unknown topic: ' + args.topic);
         }
         return (0, response_formatter_js_1.formatSuccess)({
             topic: args.topic,
             explanation: example,
-            sdkVersion: '4.0.0',
+            sdkVersion: '5.6.0',
             packageName: '@gala-chain/launchpad-sdk',
             documentation: 'https://www.npmjs.com/package/@gala-chain/launchpad-sdk',
         });