@gala-chain/launchpad-mcp-server 5.0.4-beta.2 → 5.0.4

package/dist/explain-sdk-usage-ai.json

@@ -1,3539 +0,0 @@
-{
-  "meta": {
-    "version": "5.0.4-beta.2",
-    "generatedAt": "2026-01-13T03:28:59.193Z",
-    "topicCount": 49,
-    "methodCount": 241
-  },
-  "topics": {
-    "buy-tokens": {
-      "key": "buy-tokens",
-      "label": "Buy tokens",
-      "description": "Buy tokens operations",
-      "category": "trading",
-      "methods": [
-        "calculateBuyAmount",
-        "buy"
-      ],
-      "mcpTools": [
-        "gala_launchpad_calculate_buy_amount",
-        "gala_launchpad_buy"
-      ],
-      "explanation": "\n## Buying Tokens with SDK\n\n**Covers Methods:**\n- `calculateBuyAmount()`\n- `buy()`\n\n```typescript\nimport { createLaunchpadSDK } from '@gala-chain/launchpad-sdk';\n\nasync function buyTokens() {\n  // 1. Create SDK instance\n  const sdk = createLaunchpadSDK({\n    wallet: 'your-private-key-or-mnemonic'\n  });\n\n  // 2. Calculate expected amounts FIRST (REQUIRED)\n  const calculation = await sdk.calculateBuyAmount({\n    tokenName: 'dragnrkti',\n    amount: '100',      // Spending 100 GALA\n    type: 'native'      // 'native' = GALA amount, 'exact' = token amount\n  });\n\n  console.log('Expected tokens:', calculation.amount);\n  console.log('RBC Fee:', calculation.reverseBondingCurveFee);\n  console.log('Transaction fee:', calculation.transactionFee);\n\n  // 3. Execute buy with slippage protection\n  const result = await sdk.buy({\n    tokenName: 'dragnrkti',\n    amount: '100',\n    type: 'native',\n    expectedAmount: calculation.amount,  // REQUIRED: from step 2\n    maxAcceptableReverseBondingCurveFee: calculation.reverseBondingCurveFee, // RECOMMENDED\n    slippageToleranceFactor: 0.01  // 1% slippage tolerance (REQUIRED)\n  });\n\n  console.log('Transaction ID:', result.transactionId);\n  console.log('GALA spent:', result.inputAmount);\n  console.log('Tokens received:', result.outputAmount);\n  console.log('Total fees:', result.totalFees);\n}\n```\n\n**MCP Tool Equivalent:** `gala_launchpad_buy_tokens`\n",
-      "samplePrompts": [
-        "How do I buy tokens?",
-        "Show me how to buy tokens with the SDK",
-        "Explain the buy tokens workflow",
-        "What methods do I need for buy tokens?"
-      ]
-    },
-    "sell-tokens": {
-      "key": "sell-tokens",
-      "label": "Sell tokens",
-      "description": "Sell tokens operations",
-      "category": "trading",
-      "methods": [
-        "calculateSellAmount",
-        "sell"
-      ],
-      "mcpTools": [
-        "gala_launchpad_calculate_sell_amount",
-        "gala_launchpad_sell"
-      ],
-      "explanation": "\n## Selling Tokens with SDK\n\n**Covers Methods:**\n- `calculateSellAmount()`\n- `sell()`\n\n```typescript\nimport { createLaunchpadSDK } from '@gala-chain/launchpad-sdk';\n\nasync function sellTokens() {\n  // 1. Create SDK instance\n  const sdk = createLaunchpadSDK({\n    wallet: 'your-private-key'\n  });\n\n  // 2. Calculate expected GALA FIRST (REQUIRED)\n  const calculation = await sdk.calculateSellAmount({\n    tokenName: 'dragnrkti',\n    amount: '1000',     // Selling 1000 tokens\n    type: 'exact'       // 'exact' = exact tokens, 'native' = target GALA amount\n  });\n\n  console.log('Expected GALA:', calculation.amount);\n  console.log('RBC Fee:', calculation.reverseBondingCurveFee);\n\n  // 3. Execute sell with slippage protection\n  const result = await sdk.sell({\n    tokenName: 'dragnrkti',\n    amount: '1000',\n    type: 'exact',\n    expectedAmount: calculation.amount,  // REQUIRED: from step 2\n    maxAcceptableReverseBondingCurveFee: calculation.reverseBondingCurveFee, // RECOMMENDED\n    slippageToleranceFactor: 0.01  // 1% slippage\n  });\n\n  console.log('Tokens sold:', result.inputAmount);\n  console.log('GALA received:', result.outputAmount);\n}\n```\n\n**MCP Tool Equivalent:** `gala_launchpad_sell_tokens`\n",
-      "samplePrompts": [
-        "How do I sell tokens?",
-        "Show me how to sell tokens with the SDK",
-        "Explain the sell tokens workflow",
-        "What methods do I need for sell tokens?"
-      ]
-    },
-    "pool-graduation": {
-      "key": "pool-graduation",
-      "label": "Pool graduation",
-      "description": "Pool graduation operations",
-      "category": "trading",
-      "methods": [
-        "calculateBuyAmountForGraduation",
-        "graduateToken"
-      ],
-      "mcpTools": [
-        "gala_launchpad_calculate_buy_amount_for_graduation",
-        "gala_launchpad_graduate_token"
-      ],
-      "explanation": "\n## Pool Graduation with SDK\n\n**Covers Methods:**\n- `calculateBuyAmountForGraduation()`\n- `graduateToken()`\n\n```typescript\nimport { createLaunchpadSDK, compareAmounts } from '@gala-chain/launchpad-sdk';\n\nasync function graduatePool() {\n  const sdk = createLaunchpadSDK({\n    wallet: 'your-private-key'\n  });\n\n  // Option 1: Calculate graduation cost first (recommended)\n  const calculation = await sdk.calculateBuyAmountForGraduation('dragnrkti');\n\n  console.log('GALA cost to graduate:', calculation.amount);\n  console.log('RBC Fee:', calculation.reverseBondingCurveFee);\n  console.log('Transaction fee:', calculation.transactionFee);\n\n  // Check if you have enough balance\n  const balance = await sdk.fetchGalaBalance();\n  // Use compareAmounts() instead of parseFloat for precision with currency amounts\n  if (compareAmounts(balance.balance, calculation.amount) < 0) {\n    throw new Error('Insufficient GALA balance');\n  }\n\n  // Option 2: One-step graduation (convenience method)\n  const result = await sdk.graduateToken({\n    tokenName: 'dragnrkti',\n    slippageToleranceFactor: 0.01  // Optional: defaults to SDK config\n  });\n\n  console.log('Pool graduated!');\n  console.log('Transaction ID:', result.transactionId);\n  console.log('Total GALA spent:', result.inputAmount);\n  console.log('Tokens received:', result.outputAmount);\n}\n```\n\n**MCP Tool Equivalents:**\n- `gala_launchpad_calculate_buy_amount_for_graduation`\n- `gala_launchpad_graduate_token`\n",
-      "samplePrompts": [
-        "How do I graduate token pools?",
-        "Show me how to graduate token pools with the SDK",
-        "Explain the graduate token pools workflow",
-        "What methods do I need for graduate token pools?"
-      ]
-    },
-    "fetch-pools": {
-      "key": "fetch-pools",
-      "label": "Fetch pools",
-      "description": "Fetch pools operations",
-      "category": "pools",
-      "methods": [
-        "fetchPools",
-        "fetchAllPools",
-        "fetchPoolDetails",
-        "fetchPoolDetailsForCalculation",
-        "fetchVolumeData",
-        "fetchTokenPrice",
-        "fetchTokenDistribution",
-        "fetchTokenBadges",
-        "resolveVaultAddress",
-        "resolveTokenClassKey"
-      ],
-      "mcpTools": [
-        "gala_launchpad_fetch_pools",
-        "gala_launchpad_fetch_all_pools",
-        "gala_launchpad_fetch_pool_details",
-        "gala_launchpad_fetch_pool_details_for_calculation",
-        "gala_launchpad_fetch_volume_data",
-        "gala_launchpad_fetch_token_distribution",
-        "gala_launchpad_fetch_token_badges",
-        "gala_launchpad_resolve_vault_address",
-        "gala_launchpad_resolve_token_class_key"
-      ],
-      "explanation": "\n## Fetching Pool Data with Advanced Methods\n\n**Covers Methods:**\n- `fetchPools()`\n- `fetchAllPools()`\n- `fetchPoolDetails()`\n- `fetchPoolDetailsForCalculation()`\n- `fetchVolumeData()`\n- `fetchTokenPrice()`\n- `fetchTokenDistribution()`\n- `fetchTokenBadges()`\n- `resolveVaultAddress()`\n- `resolveTokenClassKey()`\n\n```typescript\nimport { createLaunchpadSDK, compareAmounts } from '@gala-chain/launchpad-sdk';\n\n// 1. BASIC POOL FETCHING - With Pagination\nasync function basicPoolFetching() {\n  const sdk = createLaunchpadSDK({ wallet: 'your-private-key' });\n\n  // Fetch recent pools with pagination\n  const pools = await sdk.fetchPools({\n    type: 'recent',\n    limit: 10,\n    page: 1\n  });\n\n  console.log(`Found ${pools.total} pools, page ${pools.page} of ${pools.totalPages}`);\n  pools.pools.forEach(pool => {\n    console.log(`${pool.tokenName}: ${pool.tokenSymbol}`);\n  });\n}\n\n// 2. AUTO-PAGINATED FETCHING - Get ALL Pools\nasync function fetchAllPools() {\n  const sdk = createLaunchpadSDK({ wallet: 'your-private-key' });\n\n  // Auto-paginated - returns all pools without manual pagination\n  const allPools = await sdk.fetchAllPools({\n    type: 'recent'\n  });\n\n  console.log(`Total pools: ${allPools.pools.length}`);\n}\n\n// 3. POOL DETAILS - Complete information\nasync function getPoolDetails(tokenName) {\n  const sdk = createLaunchpadSDK({ wallet: 'your-private-key' });\n\n  const details = await sdk.fetchPoolDetails(tokenName);\n\n  console.log('Sale status:', details.saleStatus); // 'Ongoing' or 'Completed'\n  console.log('Base price:', details.basePrice);\n  console.log('Max supply:', details.maxSupply);\n  console.log('Remaining tokens:', details.sellingTokenQuantity);\n}\n\n// 4. POOL DETAILS FOR CALCULATIONS - Optimized for math\nasync function getOptimizedPoolDetails(tokenName) {\n  const sdk = createLaunchpadSDK({ wallet: 'your-private-key' });\n\n  // Returns only fields needed for bonding curve calculations\n  const poolData = await sdk.fetchPoolDetailsForCalculation(tokenName);\n\n  console.log('Current supply:', poolData.currentSupply);\n  console.log('Remaining tokens:', poolData.remainingTokens);\n  console.log('Max supply:', poolData.maxSupply);\n  console.log('Reverse bonding curve max fee:', poolData.reverseBondingCurveMaxFeeFactor);\n}\n\n// 5. VOLUME & OHLCV DATA - Historical candlestick data\nasync function getVolumeData(tokenName) {\n  const sdk = createLaunchpadSDK({ wallet: 'your-private-key' });\n\n  // Different resolutions: '1m', '5m', '15m', '1h', '4h', '1d'\n  const volumeData = await sdk.fetchVolumeData({\n    tokenName: tokenName,\n    from: new Date(Date.now() - 7 * 24 * 60 * 60 * 1000), // Last 7 days\n    to: new Date(),\n    resolution: '1h' // 1-hour candlesticks\n  });\n\n  volumeData.forEach(candle => {\n    console.log(`${candle.time}: O:${candle.open} H:${candle.high} L:${candle.low} C:${candle.close} V:${candle.volume}`);\n  });\n}\n\n// 6. SPOT PRICES - DEX tokens (GALA, SILK, MUSIC)\nasync function getDexTokenPrices() {\n  const sdk = createLaunchpadSDK({ wallet: 'your-private-key' });\n\n  // Fetch prices for multiple DEX tokens\n  const prices = await sdk.fetchTokenPrice(['GALA', 'SILK', 'MUSIC']);\n\n  console.log(`GALA: $${prices.GALA}`);\n  console.log(`SILK: $${prices.SILK}`);\n  console.log(`MUSIC: $${prices.MUSIC}`);\n}\n\n// 7. LAUNCHPAD TOKEN SPOT PRICES (via smart router)\nasync function getLaunchpadTokenPrice(tokenName) {\n  const sdk = createLaunchpadSDK({ wallet: 'your-private-key' });\n\n  // Get USD spot price for a launchpad token (anime, woohoo, etc.)\n  const price = await sdk.fetchTokenPrice({ tokenName });\n\n  console.log(`${tokenName} price: $${price.price}`);\n}\n\n// 8. RESOLVE UTILITY ADDRESSES\nasync function resolveAddresses(tokenName) {\n  const sdk = createLaunchpadSDK({ wallet: 'your-private-key' });\n\n  // Get GalaChain vault address for token\n  const vaultAddress = await sdk.resolveVaultAddress(tokenName);\n  console.log(`Vault address: ${vaultAddress}`);\n\n  // Get TokenClassKey for token\n  const tokenClassKey = await sdk.resolveTokenClassKey(tokenName);\n  console.log(`TokenClassKey: ${tokenClassKey}`);\n}\n\n// 9. COMPLETE INVESTMENT ANALYSIS WORKFLOW\nasync function analyzeToken(tokenName) {\n  const sdk = createLaunchpadSDK({ wallet: 'your-private-key' });\n\n  // Get all token data in parallel\n  const [details, volumeData, distribution, badges] = await Promise.all([\n    sdk.fetchPoolDetails(tokenName),\n    sdk.fetchVolumeData({ tokenName, resolution: '1d' }),\n    sdk.fetchTokenDistribution(tokenName),\n    sdk.fetchTokenBadges(tokenName)\n  ]);\n\n  // Analyze status\n  console.log(`Pool Status: ${details.saleStatus}`);\n  console.log(`Supply: ${details.currentSupply} / ${details.maxSupply}`);\n\n  // Analyze volume trend\n  // Note: For analytics/aggregation, we use safeParseFloat for performance. For trades, use BigNumber via SDK\n  const volumes = volumeData.map(v => safeParseFloat(v.volume, 0));\n  const avgVolume = volumes.reduce((a, b) => a + b, 0) / volumes.length;\n  console.log(`Avg daily volume: $${toBigNumberFixed(avgVolume, 2)}`);\n\n  // Analyze distribution\n  // Use compareAmounts for precise balance comparisons\n  const top5Ownership = distribution.holders\n    .sort((a, b) => compareAmounts(b.balance, a.balance) > 0 ? 1 : -1)\n    .slice(0, 5)\n    .reduce((sum, h) => sum + h.percentage, 0);\n  console.log(`Top 5 holders: ${toBigNumberFixed(top5Ownership, 2)}%`);\n\n  // Check badges\n  console.log(`Badges: ${badges.join(', ')}`);\n}\n```\n\n**MCP Tool Equivalents:**\n- `gala_launchpad_fetch_pools` - Paginated pool list\n- `gala_launchpad_fetch_all_pools` - Auto-paginated all pools\n- `gala_launchpad_fetch_pool_details` - Complete pool information\n- `gala_launchpad_fetch_pool_details_for_calculation` - Optimized for calculations\n- `gala_launchpad_fetch_volume_data` - OHLCV candlestick data\n- `gala_launchpad_fetch_token_spot_price` - DEX token prices (GALA, SILK, MUSIC)\n- `gala_launchpad_fetch_launchpad_token_spot_price` - Launchpad token USD prices\n- `gala_launchpad_fetch_token_distribution` - Token holder analysis\n- `gala_launchpad_fetch_token_badges` - Achievement badges\n- `gala_launchpad_resolve_vault_address` - Get vault address\n- `gala_launchpad_resolve_token_class_key` - Get TokenClassKey\n",
-      "samplePrompts": [
-        "How do I fetch and search token pools?",
-        "Show me how to fetch and search token pools with the SDK",
-        "Explain the fetch and search token pools workflow",
-        "What methods do I need for fetch and search token pools?"
-      ]
-    },
-    "balances": {
-      "key": "balances",
-      "label": "Balances",
-      "description": "Balances operations",
-      "category": "balance",
-      "methods": [
-        "fetchGalaBalance",
-        "fetchTokenBalance",
-        "fetchTokensHeld",
-        "fetchTokensCreated",
-        "fetchAvailableBalance"
-      ],
-      "mcpTools": [
-        "gala_launchpad_fetch_gala_balance",
-        "gala_launchpad_fetch_token_balance",
-        "gala_launchpad_fetch_tokens_held",
-        "gala_launchpad_fetch_tokens_created",
-        "gala_launchpad_fetch_available_balance"
-      ],
-      "explanation": "\n## Checking Balances with SDK\n\n**Covers Methods:**\n- `fetchGalaBalance()`\n- `fetchTokenBalance()`\n- `fetchTokensHeld()`\n- `fetchTokensCreated()`\n- `fetchProfile()`\n\n```typescript\nimport { createLaunchpadSDK } from '@gala-chain/launchpad-sdk';\n\nasync function checkBalances() {\n  const sdk = createLaunchpadSDK({\n    wallet: 'your-private-key'\n  });\n\n  // Check GALA balance\n  const galaBalance = await sdk.fetchGalaBalance();\n  console.log(`GALA: ${galaBalance.balance}`);\n  console.log(`Decimals: ${galaBalance.decimals}`);\n  console.log(`Last updated: ${galaBalance.lastUpdated.toISOString()}`);\n\n  // Check specific token balance\n  const tokenBalance = await sdk.fetchTokenBalance({\n    tokenName: 'dragnrkti',\n    address: sdk.getAddress()\n  });\n\n  console.log(`Token: ${tokenBalance.quantity}`);\n  console.log(`USD value: $${tokenBalance.holdingPriceUsd}`);\n  console.log(`GALA value: ${tokenBalance.holdingPriceGala}`);\n\n  // Check all tokens held\n  const portfolio = await sdk.fetchTokensHeld({\n    address: sdk.getAddress(),\n    limit: 20\n  });\n\n  console.log(`Holding ${portfolio.total} different tokens`);\n  portfolio.tokens.forEach(token => {\n    console.log(`${token.name}: ${token.quantity}`);\n  });\n\n  // Check tokens created by this wallet\n  const createdTokens = await sdk.fetchTokensCreated({\n    address: sdk.getAddress(),\n    limit: 10\n  });\n\n  console.log(`Created ${createdTokens.total} tokens`);\n  createdTokens.tokens.forEach(token => {\n    console.log(`  ${token.symbol}: ${token.name}`);\n  });\n\n  // Get user profile\n  const profile = await sdk.fetchProfile();\n  console.log(`Profile: ${profile.fullName}`);\n\n  // Check profile of another user\n  const otherProfile = await sdk.fetchProfile('eth|0x...');\n  console.log(`Other user: ${otherProfile.fullName}`);\n}\n```\n\n**MCP Tool Equivalents:**\n- `gala_launchpad_fetch_gala_balance`\n- `gala_launchpad_fetch_token_balance`\n- `gala_launchpad_fetch_tokens_held`\n- `gala_launchpad_fetch_tokens_created`\n- `gala_launchpad_fetch_profile`\n- `gala_launchpad_fetch_available_balance`\n- `gala_launchpad_fetch_locked_tokens`\n\n### Available vs Locked Balance\n\n```typescript\n// Get available balance (excludes locked/escrowed tokens)\nconst available = await sdk.fetchAvailableBalance({\n  tokenName: 'anime',\n  address: walletAddress\n});\n\n// Get locked tokens with details\nconst locked = await sdk.fetchLockedTokens({\n  tokenName: 'anime',\n  address: walletAddress\n});\n\nconsole.log('Available:', available.quantity);\nconsole.log('Locked:', locked.lockedQuantity);\n```\n",
-      "samplePrompts": [
-        "How do I check token balances?",
-        "Show me how to check token balances with the SDK",
-        "Explain the check token balances workflow",
-        "What methods do I need for check token balances?"
-      ]
-    },
-    "token-creation": {
-      "key": "token-creation",
-      "label": "Token creation",
-      "description": "Token creation operations",
-      "category": "utils",
-      "methods": [
-        "isTokenNameAvailable",
-        "isTokenSymbolAvailable",
-        "fetchLaunchTokenFee",
-        "uploadTokenImage",
-        "launchToken"
-      ],
-      "mcpTools": [
-        "gala_launchpad_fetch_launch_token_fee",
-        "gala_launchpad_upload_token_image",
-        "gala_launchpad_launch_token"
-      ],
-      "explanation": "\n## Creating Tokens with SDK\n\n**Covers Methods:**\n- `isTokenNameAvailable()`\n- `isTokenSymbolAvailable()`\n- `fetchLaunchTokenFee()`\n- `uploadTokenImage()`\n- `launchToken()`\n\n```typescript\nimport { createLaunchpadSDK } from '@gala-chain/launchpad-sdk';\n\nasync function launchToken() {\n  const sdk = createLaunchpadSDK({\n    wallet: 'your-private-key'\n  });\n\n  // 1. Check if name/symbol available\n  const nameAvailable = await sdk.isTokenNameAvailable('mytoken');\n  const symbolAvailable = await sdk.isTokenSymbolAvailable('MTK');\n\n  if (!nameAvailable || !symbolAvailable) {\n    throw new Error('Name or symbol already taken');\n  }\n\n  // 2. Check launch fee\n  const launchFee = await sdk.fetchLaunchTokenFee();\n  console.log(`Launch fee: ${launchFee} GALA`);\n\n  // 3. Upload token image (Node.js only)\n  const imageUpload = await sdk.uploadTokenImage({\n    tokenName: 'mytoken',\n    imagePath: '/path/to/image.png'\n  });\n\n  // 4. Launch the token\n  const result = await sdk.launchToken({\n    tokenName: 'mytoken',\n    tokenSymbol: 'MTK',\n    tokenDescription: 'My awesome token',\n    tokenImage: imageUpload.imageUrl,\n    websiteUrl: 'https://mytoken.com',\n    twitterUrl: 'https://twitter.com/mytoken',\n    preBuyQuantity: '100'  // Optional: pre-buy with GALA\n  });\n\n  console.log('Token launched!');\n  console.log('Transaction ID:', result.transactionId);\n\n  // Get frontend URL\n  const url = sdk.getUrlByTokenName('mytoken');\n  console.log(`View at: ${url}`);\n}\n```\n\n**MCP Tool Equivalents:**\n- `gala_launchpad_check_token_name`\n- `gala_launchpad_check_token_symbol`\n- `gala_launchpad_fetch_launch_token_fee`\n- `gala_launchpad_upload_token_image`\n- `gala_launchpad_launch_token`\n- `gala_launchpad_get_url_by_token_name`\n",
-      "samplePrompts": [
-        "How do I create and launch new tokens?",
-        "Show me how to create and launch new tokens with the SDK",
-        "Explain the create and launch new tokens workflow",
-        "What methods do I need for create and launch new tokens?"
-      ]
-    },
-    "token-details": {
-      "key": "token-details",
-      "label": "Token details",
-      "description": "Token details operations",
-      "category": "pools",
-      "methods": [
-        "fetchTokenDetails"
-      ],
-      "mcpTools": [
-        "gala_launchpad_fetch_token_details"
-      ],
-      "explanation": "\n## Token Details and Metadata with SDK\n\n**Covers Methods:**\n- `fetchTokenDetails()`\n\n```typescript\nimport { createLaunchpadSDK } from '@gala-chain/launchpad-sdk';\n\nasync function analyzeTokenDetails() {\n  const sdk = createLaunchpadSDK({\n    wallet: 'your-private-key-or-mnemonic'\n  });\n\n  // Fetch token metadata\n  const details = await sdk.fetchTokenDetails('GUSDC|Unit|none|eth:0x...');\n\n  console.log('Token Information:');\n  console.log(`  Name: ${details.name}`);\n  console.log(`  Symbol: ${details.symbol}`);\n  console.log(`  Decimals: ${details.decimals}`);\n  console.log(`  Verified: ${details.verified}`);\n  console.log(`  Trading: ${details.tradingEnabled}`);\n  console.log(`  Network: ${details.network}`);\n  console.log(`  Image: ${details.image}`);\n\n  // Pre-trading validation\n  async function validateBeforeTrade(tokenId: string) {\n    const token = await sdk.fetchTokenDetails(tokenId);\n\n    if (!token.verified) {\n      console.warn(`⚠️  ${token.symbol} is NOT verified`);\n    }\n\n    if (!token.tradingEnabled) {\n      throw new Error(`Trading disabled for ${token.symbol}`);\n    }\n\n    if (token.network !== 'ethereum') {\n      throw new Error(`Wrong network: got ${token.network}`);\n    }\n\n    return token;\n  }\n\n  // Batch token comparison\n  const tokens = ['GALA|Unit|none|none', 'GUSDC|Unit|none|eth:0x...'];\n  const details_list = await Promise.all(\n    tokens.map(id => sdk.fetchTokenDetails(id).catch(() => null))\n  );\n\n  const verified = details_list.filter(t => t?.verified).length;\n  console.log(`Verified tokens: ${verified}/${tokens.length}`);\n}\n```\n\n**Response Fields:**\n- `symbol` - Token symbol (e.g., 'GUSDC')\n- `name` - Full token name\n- `decimals` - Decimal places\n- `verified` - Verification status\n- `tradingEnabled` - Trading availability\n- `network` - Network name (e.g., 'ethereum')\n- `contractAddress` - Smart contract address\n- `image` - Token image URL\n- `chainId` - Blockchain chain ID\n\n**Use Cases:**\n- Pre-trading validation and safety checks\n- Display token metadata in UI\n- Verify token authenticity\n- Network compatibility checking\n\n**Token ID Formats:**\n- String: `GUSDC|Unit|none|eth:0x...`\n- Object: `{ collection, category, type, additionalKey }`\n\n**MCP Tool Equivalent:** `gala_launchpad_fetch_token_details`\n",
-      "samplePrompts": [
-        "How do I get token details and information?",
-        "Show me how to get token details and information with the SDK",
-        "Explain the get token details and information workflow",
-        "What methods do I need for get token details and information?"
-      ]
-    },
-    "token-distribution": {
-      "key": "token-distribution",
-      "label": "Token distribution",
-      "description": "Token distribution operations",
-      "category": "pools",
-      "methods": [
-        "fetchTokenDistribution",
-        "fetchUserHolderContext"
-      ],
-      "mcpTools": [
-        "gala_launchpad_fetch_token_distribution",
-        "gala_launchpad_fetch_user_holder_context"
-      ],
-      "explanation": "\n## Token Holder Distribution with SDK\n\n**Covers Methods:**\n- `fetchTokenDistribution()`\n- `fetchUserHolderContext()`\n\n```typescript\nimport { createLaunchpadSDK, compareAmounts } from '@gala-chain/launchpad-sdk';\n\nasync function analyzeTokenDistribution() {\n  const sdk = createLaunchpadSDK({\n    wallet: 'your-private-key-or-mnemonic'\n  });\n\n  // Fetch complete token distribution (all holders, non-paginated)\n  const distribution = await sdk.fetchTokenDistribution('anime');\n\n  console.log(`Total holders: ${distribution.totalHolders}`);\n  console.log(`Total supply: ${distribution.totalSupply}`);\n  console.log(`Last updated: ${distribution.lastUpdated.toISOString()}`);\n\n  // Analyze top holders\n  // Use compareAmounts for precise balance sorting with large numbers\n  distribution.holders\n    .sort((a, b) => compareAmounts(b.balance, a.balance) > 0 ? 1 : -1)\n    .slice(0, 5)\n    .forEach((holder, index) => {\n      console.log(`#${index + 1}: ${holder.address}`);\n      console.log(`  Balance: ${holder.balance}`);\n      console.log(`  Ownership: ${toBigNumberFixed(holder.percentage, 2)}%`);\n    });\n\n  // Check concentration risk (e.g., top 5 holders own >80%)\n  const top5Ownership = distribution.holders\n    .sort((a, b) => compareAmounts(b.balance, a.balance) > 0 ? 1 : -1)\n    .slice(0, 5)\n    .reduce((sum, holder) => sum + holder.percentage, 0);\n\n  console.log(`Top 5 holders control: ${toBigNumberFixed(top5Ownership, 2)}%`);\n\n  // Find specific holder\n  const myAddress = sdk.getAddress();\n  const myHolding = distribution.holders.find(h => h.address === myAddress);\n\n  if (myHolding) {\n    console.log(`Your ownership: ${toBigNumberFixed(myHolding.percentage, 4)}%`);\n    console.log(`Your balance: ${myHolding.balance}`);\n  }\n\n  // Calculate concentration metrics\n  const giniCoefficient = calculateGini(distribution.holders);\n  console.log(`Gini coefficient: ${toBigNumberFixed(giniCoefficient, 4)}`);\n\n  // Count whales (holders with >5%)\n  const whales = distribution.holders.filter(h => h.percentage > 5);\n  console.log(`Whales (>5%): ${whales.length}`);\n}\n\n// Helper: Calculate Gini coefficient for wealth distribution\nfunction calculateGini(holders: Array<{balance: string}>) {\n  const balances = holders.map(h => safeParseFloat(h.balance, 0)).sort((a, b) => a - b);\n  const n = balances.length;\n  const sum = balances.reduce((a, b) => a + b, 0);\n\n  let numerator = 0;\n  for (let i = 0; i < n; i++) {\n    numerator += (2 * (i + 1) - n - 1) * balances[i];\n  }\n\n  return numerator / (n * sum);\n}\n```\n\n**Key Characteristics:**\n- **Non-Paginated**: Returns ALL token holders in single response (no pagination)\n- **Complete Distribution**: Full holder list with addresses, balances, and ownership percentages\n- **BigNumber Precision**: Uses BigNumber.js for accurate percentage calculations\n- **Total Supply**: Computed from holder balances (sum of all holdings)\n- **Service Account Included**: Vault/service accounts appear in holder list\n\n**Use Cases:**\n- Analyze token concentration risk\n- Identify whale holders\n- Track ownership changes over time\n- Generate holder reports\n- Calculate distribution metrics (Gini coefficient, etc.)\n\n**MCP Tool Equivalent:** `gala_launchpad_fetch_token_distribution`\n\n---\n\n## User Holder Context (Single User Lookup)\n\n**Covers Methods:**\n- `fetchUserHolderContext()`\n\nUse this when you need holder info for a **specific user** rather than the full holder list.\nPerfect for user cards in comments/chat.\n\n```typescript\nimport { createLaunchpadSDK } from '@gala-chain/launchpad-sdk';\n\nasync function getUserCard() {\n  const sdk = createLaunchpadSDK({ wallet: 'your-private-key' });\n\n  // Fetch single user's holder context for a token\n  const holderContext = await sdk.fetchUserHolderContext('anime', 'eth|abc123...');\n\n  // Response shape:\n  // {\n  //   tokenName: 'anime',\n  //   userAddress: 'abc123...',\n  //   quantity: '25000' | null,      // null if not a holder\n  //   percentage: 2.5 | null,         // null if not a holder\n  //   rank: 3 | null,                 // 1-indexed rank (null if not a holder)\n  //   holderTier: { tier: 3, tierName: 'Major Holder' } | null,\n  //   isCreator: false\n  // }\n\n  if (holderContext.quantity !== null) {\n    console.log(`Rank: #${holderContext.rank}`);\n    console.log(`Holder Tier: ${holderContext.holderTier?.tierName}`);\n    console.log(`Owns: ${holderContext.percentage ? toBigNumberFixed(holderContext.percentage, 4) : 'N/A'}%`);\n  } else {\n    console.log('User is not a holder of this token');\n  }\n\n  if (holderContext.isCreator) {\n    console.log('This user created the token!');\n  }\n}\n```\n\n**Holder Tiers (based on % of max supply):**\n| Tier | Name | Min % |\n|------|------|-------|\n| 5 | Whale | 5% |\n| 4 | Top Holder | 1% |\n| 3 | Major Holder | 0.1% |\n| 2 | Strong Holder | 0.01% |\n| 1 | Holder | 0.001% |\n\n**MCP Tool Equivalent:** `gala_launchpad_fetch_user_holder_context`\n",
-      "samplePrompts": [
-        "How do I analyze token distribution?",
-        "Show me how to analyze token distribution with the SDK",
-        "Explain the analyze token distribution workflow",
-        "What methods do I need for analyze token distribution?"
-      ]
-    },
-    "token-status": {
-      "key": "token-status",
-      "label": "Token status",
-      "description": "Token status operations",
-      "category": "utils",
-      "methods": [
-        "isTokenGraduated",
-        "onDexPoolCreation",
-        "onLaunchpadTokenCreation"
-      ],
-      "mcpTools": [
-        "gala_launchpad_is_token_graduated",
-        "gala_launchpad_on_dex_pool_creation",
-        "gala_launchpad_on_launchpad_token_creation"
-      ],
-      "explanation": "\n## Token Status and Event Monitoring\n\n**Covers Methods:**\n- `isTokenGraduated()`\n- `onDexPoolCreation()`\n- `onLaunchpadTokenCreation()`\n\nCheck token graduation status and monitor real-time token/pool creation events.\n\n```typescript\nimport { createLaunchpadSDK } from '@gala-chain/launchpad-sdk';\n\nasync function monitorTokenStatus() {\n  const sdk = createLaunchpadSDK({ wallet: 'your-private-key' });\n\n  // ============================================================================\n  // CHECK GRADUATION STATUS - Determine if token is on DEX or bonding curve\n  // ============================================================================\n\n  // Check if token has graduated from bonding curve to DEX\n  const isGraduated = await sdk.isTokenGraduated('anime');\n\n  if (isGraduated) {\n    console.log('Token has graduated to DEX - trade via GalaSwap');\n    // Use DEX trading methods: executeSwap(), getSwapQuoteExactInput(), etc.\n  } else {\n    console.log('Token on bonding curve - trade via launchpad');\n    // Use bonding curve methods: buy(), sell(), calculateBuyAmount(), etc.\n  }\n\n  // ============================================================================\n  // MONITOR DEX POOL CREATION - Real-time notifications\n  // ============================================================================\n\n  // Set up listener for new DEX pools\n  const cleanupDexPool = sdk.onDexPoolCreation((poolData) => {\n    console.log('New DEX pool created!');\n    console.log(`  Token: ${poolData.tokenName}`);\n    console.log(`  Token0: ${poolData.token0}`);\n    console.log(`  Token1: ${poolData.token1}`);\n    console.log(`  Fee Tier: ${poolData.feeTier}`);\n    console.log(`  Initial TVL: ${poolData.tvl}`);\n\n    // Take action on new pool\n    // Example: Automatically provide liquidity or execute arbitrage\n  });\n\n  // ============================================================================\n  // MONITOR TOKEN LAUNCHES - Real-time notifications\n  // ============================================================================\n\n  // Set up listener for new token launches\n  const cleanupTokenCreation = sdk.onLaunchpadTokenCreation((tokenData) => {\n    console.log('New token launched!');\n    console.log(`  Name: ${tokenData.tokenName}`);\n    console.log(`  Symbol: ${tokenData.tokenSymbol}`);\n    console.log(`  Creator: ${tokenData.creator}`);\n    console.log(`  Max Supply: ${tokenData.maxSupply}`);\n    console.log(`  Base Price: ${tokenData.basePrice}`);\n\n    // Take action on new token\n    // Example: Automatically buy early or analyze opportunity\n  });\n\n  // ============================================================================\n  // COMPLETE WORKFLOW: Monitoring + Trading\n  // ============================================================================\n\n  async function autoTrade() {\n    // Monitor new tokens\n    sdk.onLaunchpadTokenCreation(async (token) => {\n      console.log(`New token: ${token.tokenName}`);\n\n      // Wait for graduation\n      const checkGraduation = setInterval(async () => {\n        const graduated = await sdk.isTokenGraduated(token.tokenName);\n\n        if (graduated) {\n          clearInterval(checkGraduation);\n          console.log(`${token.tokenName} graduated! Switching to DEX trading.`);\n\n          // Now use DEX methods instead of bonding curve\n          const quote = await sdk.getSwapQuoteExactInput('GALA', token.tokenName, '100');\n          console.log(`DEX quote: ${quote.estimatedOutput}`);\n        }\n      }, 60000); // Check every minute\n    });\n\n    // Monitor new DEX pools\n    sdk.onDexPoolCreation(async (pool) => {\n      console.log(`New pool: ${pool.tokenName}`);\n\n      // Analyze liquidity opportunity\n      const poolInfo = await sdk.getSwapPoolInfo(pool.token0, pool.token1);\n      console.log(`Pool liquidity: ${poolInfo.liquidity}`);\n    });\n  }\n\n  // Keep process running\n  console.log('Monitoring events... Press Ctrl+C to stop');\n  await new Promise(() => {}); // Run forever\n\n  // Cleanup when done\n  cleanupDexPool();\n  cleanupTokenCreation();\n}\n```\n\n**Use Cases:**\n- **Arbitrage Bots**: Detect graduation events and switch trading strategies\n- **Early Bird Trading**: Monitor new token launches and trade immediately\n- **Liquidity Provision**: Detect new DEX pools and provide liquidity\n- **Portfolio Automation**: Automatically adjust positions on graduation\n- **Price Discovery**: Track token lifecycle from launch to DEX\n\n**Event Data:**\n- **DEX Pool Creation**: tokenName, token0, token1, feeTier, tvl, timestamp\n- **Token Launch**: tokenName, tokenSymbol, creator, maxSupply, basePrice, timestamp\n\n**MCP Tool Equivalents:**\n- `gala_launchpad_is_token_graduated`\n- `gala_launchpad_on_dex_pool_creation` (WebSocket event)\n- `gala_launchpad_on_launchpad_token_creation` (WebSocket event)\n",
-      "samplePrompts": [
-        "How do I check token pool status?",
-        "Show me how to check token pool status with the SDK",
-        "Explain the check token pool status workflow",
-        "What methods do I need for check token pool status?"
-      ]
-    },
-    "multi-wallet": {
-      "key": "multi-wallet",
-      "label": "Multi wallet",
-      "description": "Multi wallet operations",
-      "category": "utils",
-      "methods": [],
-      "mcpTools": [],
-      "explanation": "\n## Multi-Wallet Support with SDK\n\n**Covers Methods:**\n- `createWallet()` (utility function)\n- `buy()`, `sell()`, `launchToken()` with privateKey override\n\n```typescript\nimport { createLaunchpadSDK, createWallet } from '@gala-chain/launchpad-sdk';\n\nasync function multiWalletExample() {\n  // Main SDK with your wallet\n  const sdk = createLaunchpadSDK({\n    wallet: 'your-main-private-key'\n  });\n\n  // Create a test wallet\n  const testWallet = createWallet();\n  console.log('Test wallet:', testWallet.address);\n\n  // 1. Fund test wallet from main wallet\n  await sdk.transferGala({\n    recipientAddress: testWallet.address,\n    amount: '1000'\n  });\n\n  // 2. Have test wallet buy tokens (using privateKey override)\n  const buyCalc = await sdk.calculateBuyAmount({\n    tokenName: 'dragnrkti',\n    amount: '100',\n    type: 'native'\n  });\n\n  const buyResult = await sdk.buy({\n    tokenName: 'dragnrkti',\n    amount: '100',\n    type: 'native',\n    expectedAmount: buyCalc.amount,\n    slippageToleranceFactor: 0.01,\n    privateKey: testWallet.privateKey  // Override to use test wallet\n  });\n\n  console.log('Test wallet bought tokens');\n\n  // 3. Check balances for both wallets\n  const mainBalance = await sdk.fetchGalaBalance();  // Main wallet\n  const testBalance = await sdk.fetchGalaBalance(testWallet.address);  // Test wallet\n\n  console.log(`Main wallet: ${mainBalance.balance} GALA`);\n  console.log(`Test wallet: ${testBalance.balance} GALA`);\n}\n```\n\n**Key Points:**\n- All signing operations support `privateKey` parameter\n- Creates temporary SDK instance internally\n- Supports: buy, sell, launchToken, transfers, profile updates\n",
-      "samplePrompts": [
-        "How do I work with multiple wallets?",
-        "Show me how to work with multiple wallets with the SDK",
-        "Explain the work with multiple wallets workflow",
-        "What methods do I need for work with multiple wallets?"
-      ]
-    },
-    "transfers": {
-      "key": "transfers",
-      "label": "Transfers",
-      "description": "Transfers operations",
-      "category": "transfers",
-      "methods": [
-        "transferGala",
-        "transferToken"
-      ],
-      "mcpTools": [
-        "gala_launchpad_transfer_gala",
-        "gala_launchpad_transfer_token"
-      ],
-      "explanation": "\n## Token Transfers with SDK\n\n**Covers Methods:**\n- `transferGala()`\n- `transferToken()`\n\n```typescript\nimport { createLaunchpadSDK } from '@gala-chain/launchpad-sdk';\n\nasync function transferTokens() {\n  const sdk = createLaunchpadSDK({\n    wallet: 'your-private-key'\n  });\n\n  // Transfer GALA tokens\n  const galaTransfer = await sdk.transferGala({\n    recipientAddress: '0x1234...', // or 'eth|1234...'\n    amount: '100',\n    uniqueKey: 'galaconnect-operation-my-transfer-123'  // Optional idempotency\n  });\n\n  console.log('GALA transfer ID:', galaTransfer.transactionId);\n  console.log('Status:', galaTransfer.status);\n\n  // Transfer launchpad tokens\n  const tokenTransfer = await sdk.transferToken({\n    to: 'eth|5678...',\n    tokenName: 'dragnrkti',\n    amount: '1000',  // Token amount\n    uniqueKey: 'galaconnect-operation-token-456'\n  });\n\n  console.log('Token transfer ID:', tokenTransfer.transactionId);\n}\n```\n\n**Features:**\n- EIP-712 signatures for security\n- Supports both `0x` and `eth|` address formats\n- Optional idempotency keys prevent duplicates\n- Comprehensive validation\n\n**MCP Tool Equivalents:**\n- `gala_launchpad_transfer_gala`\n- `gala_launchpad_transfer_token`\n",
-      "samplePrompts": [
-        "How do I transfer tokens?",
-        "Show me how to transfer tokens with the SDK",
-        "Explain the transfer tokens workflow",
-        "What methods do I need for transfer tokens?"
-      ]
-    },
-    "locks": {
-      "key": "locks",
-      "label": "Locks",
-      "description": "Locks operations",
-      "category": "locks",
-      "methods": [
-        "lockTokens",
-        "unlockTokens",
-        "burnTokens",
-        "fetchLockedBalance"
-      ],
-      "mcpTools": [
-        "gala_launchpad_lock_tokens",
-        "gala_launchpad_unlock_tokens",
-        "gala_launchpad_burn_tokens"
-      ],
-      "explanation": "\n## Token Locking, Unlocking, and Burning with SDK\n\n**Covers Methods:**\n- `lockTokens()` - Lock one or more token types in a single transaction\n- `unlockTokens()` - Unlock one or more token types in a single transaction\n- `burnTokens()` - Permanently destroy tokens (IRREVERSIBLE)\n- `fetchLockedBalance()` - Query locked token balances with hold details\n\nLock, unlock, and burn tokens on GalaChain for staking, escrow, vesting, or token management.\n\n```typescript\nimport { createLaunchpadSDK } from '@gala-chain/launchpad-sdk';\n\nasync function tokenLockingAndBurning() {\n  const sdk = createLaunchpadSDK({\n    wallet: 'your-private-key'\n  });\n\n  // ============================================================================\n  // LOCK TOKENS - Single token (batch API wraps single token)\n  // ============================================================================\n\n  // Lock 1000 tokens with default options (caller is lock authority)\n  const lockResult = await sdk.lockTokens({\n    tokens: [{\n      tokenName: 'anime',\n      amount: '1000'\n    }]\n  });\n\n  console.log('Lock transaction ID:', lockResult.transactionId);\n  console.log('Locked entries:', lockResult.locked);\n\n  // ============================================================================\n  // LOCK TOKENS - Multiple tokens in one transaction (batch)\n  // ============================================================================\n\n  // Lock multiple token types atomically\n  const batchLock = await sdk.lockTokens({\n    tokens: [\n      { tokenName: 'anime', amount: '500' },\n      { tokenName: 'dragon', amount: '200' },\n      { tokenName: 'mystic', amount: '100', lockAuthority: 'eth|0x1234...' }\n    ]\n  });\n\n  console.log('Batch lock completed:', batchLock.locked.length, 'tokens locked');\n\n  // ============================================================================\n  // LOCK TOKENS - Advanced options\n  // ============================================================================\n\n  // Lock with custom lock authority (another address can unlock)\n  const escrowLock = await sdk.lockTokens({\n    tokens: [{\n      tokenName: 'anime',\n      amount: '500',\n      lockAuthority: 'eth|0x1234...',  // Escrow agent address\n      name: 'escrow-payment-001',       // Identifier for matching during unlock\n      expires: Date.now() + 30 * 24 * 60 * 60 * 1000  // Auto-release in 30 days\n    }]\n  });\n\n  console.log('Escrow lock created');\n\n  // Lock for time-based vesting\n  const vestingLock = await sdk.lockTokens({\n    tokens: [{\n      tokenName: 'anime',\n      amount: '10000',\n      name: 'vesting-q1-2025',\n      expires: new Date('2025-04-01').getTime()  // Auto-unlock on April 1st\n    }]\n  });\n\n  console.log('Vesting lock created with expiry');\n\n  // ============================================================================\n  // UNLOCK TOKENS - Release locked tokens\n  // ============================================================================\n\n  // Unlock tokens (must be called by lock authority)\n  const unlockResult = await sdk.unlockTokens({\n    tokens: [{\n      tokenName: 'anime',\n      amount: '500'\n    }]\n  });\n\n  console.log('Unlock transaction ID:', unlockResult.transactionId);\n  console.log('Unlocked entries:', unlockResult.unlocked);\n\n  // Unlock multiple tokens in one transaction\n  const batchUnlock = await sdk.unlockTokens({\n    tokens: [\n      { tokenName: 'anime', amount: '500' },\n      { tokenName: 'dragon', amount: '200', name: 'escrow-payment-001' }\n    ]\n  });\n\n  console.log('Batch unlock completed');\n\n  // ============================================================================\n  // BURN TOKENS - Permanently destroy (IRREVERSIBLE!)\n  // ============================================================================\n\n  // WARNING: Burn operations are permanent and cannot be undone!\n  const burnResult = await sdk.burnTokens({\n    tokens: [{\n      tokenName: 'anime',\n      amount: '100'\n    }]\n  });\n\n  console.log('Burn transaction ID:', burnResult.transactionId);\n  console.log('Burned:', burnResult.burned);\n\n  // Batch burn multiple token types\n  const batchBurn = await sdk.burnTokens({\n    tokens: [\n      { tokenName: 'anime', amount: '50' },\n      { tokenName: 'oldtoken', amount: '1000' }  // Clean up deprecated tokens\n    ]\n  });\n\n  console.log('Batch burn completed:', batchBurn.burned.length, 'token types burned');\n\n  // ============================================================================\n  // QUERY LOCKED TOKENS - Check lock status\n  // ============================================================================\n\n  const lockedTokens = await sdk.fetchLockedBalance({\n    tokenName: 'anime',\n    address: sdk.getAddress()\n  });\n\n  console.log('Locked quantity:', lockedTokens.lockedQuantity);\n  console.log('Active holds:', lockedTokens.holds);\n\n  // Each hold contains: lockAuthority, expires, name, quantity\n  for (const hold of lockedTokens.holds) {\n    console.log(`  - ${hold.quantity} locked by ${hold.lockAuthority}`);\n    if (hold.expires) console.log(`    Expires: ${new Date(hold.expires)}`);\n    if (hold.name) console.log(`    Name: ${hold.name}`);\n  }\n\n  // ============================================================================\n  // STAKING WORKFLOW EXAMPLE\n  // ============================================================================\n\n  async function stakingWorkflow() {\n    // Step 1: Lock tokens for staking period\n    const stake = await sdk.lockTokens({\n      tokens: [{\n        tokenName: 'anime',\n        amount: '5000',\n        name: 'staking-period-1',\n        expires: Date.now() + 90 * 24 * 60 * 60 * 1000  // 90-day staking period\n      }]\n    });\n\n    console.log('Staked 5000 tokens for 90 days');\n\n    // Step 2: After staking period expires, unlock\n    const unstake = await sdk.unlockTokens({\n      tokens: [{\n        tokenName: 'anime',\n        amount: '5000',\n        name: 'staking-period-1'\n      }]\n    });\n\n    console.log('Unstaked tokens after staking period');\n    return { stake, unstake };\n  }\n\n  // ============================================================================\n  // ESCROW WORKFLOW EXAMPLE\n  // ============================================================================\n\n  async function escrowWorkflow(buyerAddress: string, sellerAddress: string) {\n    // Step 1: Buyer locks payment in escrow (seller is lock authority)\n    const escrow = await sdk.lockTokens({\n      tokens: [{\n        tokenName: 'anime',\n        amount: '1000',\n        lockAuthority: sellerAddress,  // Seller can release upon delivery\n        name: 'order-12345'\n      }]\n    });\n\n    console.log('Escrow created: seller can release payment upon delivery');\n\n    // Step 2: Seller releases escrow after delivery (seller calls unlock)\n    // This would be executed by the seller's SDK instance\n    // const release = await sellerSdk.unlockTokens({\n    //   tokens: [{ tokenName: 'anime', amount: '1000', name: 'order-12345' }]\n    // });\n\n    return escrow;\n  }\n}\n```\n\n**Key Features:**\n- **Batch Operations**: Lock/unlock/burn multiple token types in one transaction\n- **Lock Authority**: Specify who can unlock (defaults to caller)\n- **Expiration**: Optional auto-release timestamp for time-based vesting\n- **Named Locks**: Use `name` to identify specific locks for targeted unlocks\n- **EIP-712 Signatures**: Secure blockchain transactions\n- **Error Handling**: `LockError` and `BurnError` classes with specific error types\n\n**Lock Parameters (per token in array):**\n| Parameter | Required | Description |\n|-----------|----------|-------------|\n| `tokenName` | Yes* | Token to lock (e.g., 'anime') |\n| `tokenId` | Yes* | Alternative: TokenClassKey or pipe-delimited string |\n| `amount` | Yes | Amount of tokens to lock |\n| `lockAuthority` | No | Address that can unlock (defaults to caller) |\n| `expires` | No | Timestamp in ms for auto-unlock |\n| `name` | No | Identifier for matching during unlock |\n\n*Either `tokenName` or `tokenId` required\n\n**Unlock Parameters (per token in array):**\n| Parameter | Required | Description |\n|-----------|----------|-------------|\n| `tokenName` | Yes* | Token to unlock (e.g., 'anime') |\n| `tokenId` | Yes* | Alternative: TokenClassKey or pipe-delimited string |\n| `amount` | Yes | Amount of tokens to unlock |\n| `name` | No | Lock name to match (if used during lock) |\n\n**Burn Parameters (per token in array):**\n| Parameter | Required | Description |\n|-----------|----------|-------------|\n| `tokenName` | Yes* | Token to burn (e.g., 'anime') |\n| `tokenId` | Yes* | Alternative: TokenClassKey or pipe-delimited string |\n| `amount` | Yes | Amount of tokens to burn (PERMANENT!) |\n\n**Use Cases:**\n- **Staking**: Lock tokens for rewards/governance\n- **Escrow**: Third-party controlled releases\n- **Vesting**: Time-based token releases\n- **Governance**: Lock tokens for voting power\n- **Token Retirement**: Permanently burn deprecated tokens\n- **Deflationary Mechanics**: Reduce supply via burns\n\n**MCP Tool Equivalents:**\n- `gala_launchpad_lock_tokens` (batch)\n- `gala_launchpad_unlock_tokens` (batch)\n- `gala_launchpad_burn_tokens` (batch)\n- `gala_launchpad_fetch_locked_tokens`\n",
-      "samplePrompts": [
-        "How do I lock and unlock tokens?",
-        "Show me how to lock and unlock tokens with the SDK",
-        "Explain the lock and unlock tokens workflow",
-        "What methods do I need for lock and unlock tokens?"
-      ]
-    },
-    "dex-trading": {
-      "key": "dex-trading",
-      "label": "Dex trading",
-      "description": "Dex trading operations",
-      "category": "dex",
-      "methods": [
-        "getSwapQuoteExactInput",
-        "getSwapQuoteExactOutput",
-        "executeSwap",
-        "getSwapUserAssets",
-        "getAllSwapUserAssets",
-        "getSwapPoolInfo"
-      ],
-      "mcpTools": [
-        "gala_launchpad_get_swap_quote_exact_input",
-        "gala_launchpad_get_swap_quote_exact_output",
-        "gala_launchpad_execute_swap",
-        "gala_launchpad_get_swap_user_assets",
-        "gala_launchpad_get_all_swap_user_assets",
-        "gala_launchpad_get_swap_pool_info"
-      ],
-      "explanation": "\n## DEX Trading with SDK - GalaSwap Integration\n\n**Covers Methods:**\n- `getSwapQuoteExactInput()`\n- `getSwapQuoteExactOutput()`\n- `executeSwap()`\n- `getSwapUserAssets()`\n- `getAllSwapUserAssets()`\n- `getSwapPoolInfo()`\n\nTrade graduated tokens on the GalaSwap DEX with real-time WebSocket monitoring:\n\n```typescript\nimport { createLaunchpadSDK } from '@gala-chain/launchpad-sdk';\n\nasync function dexTradingExample() {\n  // 1. Initialize SDK with wallet\n  const sdk = createLaunchpadSDK({\n    wallet: 'your-private-key',\n    env: 'production'\n  });\n\n  // ============================================================================\n  // QUOTES: Get pricing information (read-only operations)\n  // ============================================================================\n\n  // Quote 1: Exact input (spend known GALA amount)\n  const quoteIn = await sdk.getSwapQuoteExactInput('GALA', 'GUSDC', '100');\n  console.log('Spend 100 GALA → get ~' + quoteIn.estimatedOutput + ' GUSDC');\n  console.log('Price impact: ' + quoteIn.priceImpact + '%');\n  console.log('Fee tier: ' + quoteIn.feeTier + ' bps');\n\n  // Quote 2: Exact output (get known token amount)\n  const quoteOut = await sdk.getSwapQuoteExactOutput('GALA', 'GUSDC', '100');\n  console.log('Get exactly 100 GUSDC → need ~' + quoteOut.inputAmount + ' GALA');\n\n  // ============================================================================\n  // EXECUTE: Perform the swap with slippage protection\n  // ============================================================================\n\n  const result = await sdk.executeSwap(\n    'GALA',                       // from token\n    'GUSDC',                      // to token\n    '100',                        // input amount (100 GALA)\n    quoteIn.estimatedOutput,      // Use quote's output!\n    quoteIn.feeTier,              // Use quote's fee tier!\n    0.01                          // 1% slippage tolerance\n  );\n\n  console.log('Transaction ID: ' + result.transactionId);\n  console.log('Status: ' + result.status);\n  console.log('Received: ' + result.outputAmount + ' ' + result.toToken);\n\n  // ============================================================================\n  // PORTFOLIO: Check balances and assets\n  // ============================================================================\n\n  const assets = await sdk.getSwapUserAssets(sdk.getEthereumAddress());\n  console.log('Assets in wallet:');\n  assets.forEach(asset => {\n    console.log('  ' + asset.symbol + ': ' + asset.balance);\n  });\n\n  // ============================================================================\n  // PORTFOLIO: Get ALL assets (auto-paginated)\n  // ============================================================================\n\n  const allAssets = await sdk.getAllSwapUserAssets(sdk.getEthereumAddress());\n  console.log('Complete asset portfolio:');\n  console.log('Total assets: ' + allAssets.length);\n  allAssets.forEach(asset => {\n    console.log('  ' + asset.symbol + ': ' + asset.balance);\n  });\n\n  // ============================================================================\n  // POOL INFO: Check liquidity before trading\n  // ============================================================================\n\n  const pool = await sdk.getSwapPoolInfo('GALA', 'GUSDC');\n  console.log('GALA↔GUSDC Pool Info:');\n  console.log('  Liquidity: ' + pool.liquidity);\n  console.log('  Available fee tiers: ' + pool.feeTiers.join(', ') + ' bps');\n  console.log('  24h swaps: ' + pool.swapCount);\n}\n```\n\n**Key Architecture:**\n- **Unified WebSocket**: Uses LaunchpadSDK's unified WebSocket for transaction monitoring\n- **Environment Alignment**: STAGE/PROD URLs must match between LaunchpadSDK and GSwapService\n- **Token Formats**:\n  - **Launchpad bonding curve**: Use `tokenName` (lowercase simple symbols like 'anime', 'dragon')\n  - **DEX trading**: Use `tokenId` (pipe-delimited format like 'GALA|Unit|none|none', 'GUSDC|Unit|none|eth:0x...')\n- **Slippage Protection**: Always use quote values for execution\n- **Fee Tiers**: 500 (0.05%), 3000 (0.30%), 10000 (1.00%)\n- **Auto-Pagination**: Use `getAllSwapUserAssets()` for complete portfolio\n\n**MCP Tool Equivalents:**\n- `gala_launchpad_get_swap_quote_exact_input`\n- `gala_launchpad_get_swap_quote_exact_output`\n- `gala_launchpad_execute_swap`\n- `gala_launchpad_get_swap_user_assets`\n- `gala_launchpad_get_all_swap_user_assets`\n- `gala_launchpad_get_swap_pool_info`\n",
-      "samplePrompts": [
-        "How do I trade tokens on GalaSwap?",
-        "Show me how to trade tokens on GalaSwap with the SDK",
-        "Explain the trade tokens on GalaSwap workflow",
-        "What methods do I need for trade tokens on GalaSwap?"
-      ]
-    },
-    "error-handling": {
-      "key": "error-handling",
-      "label": "Error handling",
-      "description": "Error handling operations",
-      "category": "utils",
-      "methods": [],
-      "mcpTools": [],
-      "explanation": "\n## Error Handling with SDK\n\n**Covers Methods:**\n- Error types from SDK (ValidationError, NetworkError, TransactionError, TokenNotFoundError, etc.)\n\n```typescript\nimport {\n  createLaunchpadSDK,\n  ValidationError,\n  NetworkError,\n  TransactionError,\n  TokenNotFoundError\n} from '@gala-chain/launchpad-sdk';\n\nasync function errorHandlingExample() {\n  const sdk = createLaunchpadSDK({\n    wallet: 'your-private-key'\n  });\n\n  try {\n    // Attempt trade\n    const result = await sdk.buy({\n      tokenName: 'dragnrkti',\n      amount: '100',\n      type: 'native',\n      expectedAmount: '5000',\n      slippageToleranceFactor: 0.01\n    });\n\n    console.log('Success:', result.transactionId);\n\n  } catch (error) {\n    if (error instanceof ValidationError) {\n      console.error('Invalid input:', error.message);\n      console.error('Field:', error.field);\n      console.error('Code:', error.code);\n\n    } else if (error instanceof TokenNotFoundError) {\n      console.error('Token does not exist:', error.tokenName);\n\n    } else if (error instanceof NetworkError) {\n      console.error('Network issue:', error.message);\n      console.error('Status code:', error.statusCode);\n\n    } else if (error instanceof TransactionError) {\n      console.error('Transaction failed:', error.message);\n      console.error('Transaction ID:', error.transactionId);\n\n    } else {\n      console.error('Unexpected error:', error);\n    }\n  }\n}\n```\n\n**Error Types:**\n- `ValidationError` - Invalid input parameters\n- `NetworkError` - HTTP/network failures\n- `TransactionError` - Blockchain transaction failures\n- `TokenNotFoundError` - Token doesn't exist\n- `ConfigurationError` - SDK misconfiguration\n- `WebSocketError` - Real-time connection issues\n",
-      "samplePrompts": [
-        "How do I handle SDK errors properly?",
-        "Show me how to handle SDK errors properly with the SDK",
-        "Explain the handle SDK errors properly workflow",
-        "What methods do I need for handle SDK errors properly?"
-      ]
-    },
-    "installation": {
-      "key": "installation",
-      "label": "Installation",
-      "description": "Installation operations",
-      "category": "utils",
-      "methods": [],
-      "mcpTools": [],
-      "explanation": "\n## Installing and Importing SDK\n\n**Covers Methods:**\n- SDK installation, imports, and configuration\n\n### NPM Installation\n\n```bash\n# Install SDK\nnpm install @gala-chain/launchpad-sdk\n\n# Install peer dependencies\nnpm install ethers@^6.15.0 @gala-chain/api@^2.4.3 @gala-chain/connect@^2.4.3 \\\n  socket.io-client@^4.8.1 axios@^1.12.2 bignumber.js@^9.1.2 zod@^3.25.76\n```\n\n### Import Patterns\n\n```typescript\n// Main SDK class\nimport { LaunchpadSDK } from '@gala-chain/launchpad-sdk';\n\n// Helper functions (recommended)\nimport {\n  createLaunchpadSDK,\n  createTestLaunchpadSDK,\n  createWallet,\n  validateWalletInput\n} from '@gala-chain/launchpad-sdk';\n\n// Error types\nimport {\n  ValidationError,\n  NetworkError,\n  TransactionError,\n  TokenNotFoundError\n} from '@gala-chain/launchpad-sdk';\n\n// Type definitions\nimport type {\n  PoolData,\n  TradeResult,\n  TokenBalanceInfo,\n  BuyTokenOptions,\n  SellTokenOptions\n} from '@gala-chain/launchpad-sdk';\n```\n\n### Environment Configuration\n\n```typescript\n// Production (default)\nconst sdk = createLaunchpadSDK({\n  wallet: 'your-private-key',\n  config: {\n    baseUrl: 'https://lpad-backend-prod1.defi.gala.com',\n    debug: false,\n    timeout: 60000\n  }\n});\n\n// Development\nconst sdk = createLaunchpadSDK({\n  wallet: 'your-private-key',\n  config: {\n    baseUrl: 'https://lpad-backend-dev1.defi.gala.com',\n    debug: true\n  }\n});\n```\n",
-      "samplePrompts": [
-        "How do I install and configure the SDK?",
-        "Show me how to install and configure the SDK with the SDK",
-        "Explain the install and configure the SDK workflow",
-        "What methods do I need for install and configure the SDK?"
-      ]
-    },
-    "local-calculations": {
-      "key": "local-calculations",
-      "label": "Local calculations",
-      "description": "Local calculations operations",
-      "category": "trading",
-      "methods": [
-        "calculateBuyAmountLocal",
-        "calculateSellAmountLocal",
-        "calculateBuyAmountExternal",
-        "calculateSellAmountExternal",
-        "calculateInitialBuyAmount"
-      ],
-      "mcpTools": [
-        "gala_launchpad_calculate_buy_amount_local",
-        "gala_launchpad_calculate_sell_amount_local",
-        "gala_launchpad_calculate_buy_amount_external",
-        "gala_launchpad_calculate_sell_amount_external"
-      ],
-      "explanation": "\n## Local Bonding Curve Calculations with SDK\n\n**Covers Methods:**\n- `calculateBuyAmountLocal()`\n- `calculateSellAmountLocal()`\n- `calculateBuyAmountExternal()`\n- `calculateSellAmountExternal()`\n\n```typescript\nimport { createLaunchpadSDK, compareAmounts } from '@gala-chain/launchpad-sdk';\n\nasync function localCalculationsExample() {\n  const sdk = createLaunchpadSDK({\n    wallet: 'your-private-key'\n  });\n\n  // ============================================================================\n  // LOCAL CALCULATIONS - Instant quotes without network calls\n  // ============================================================================\n\n  // 1. Buy calculation (local, instant)\n  const localBuy = await sdk.calculateBuyAmountLocal({\n    tokenName: 'dragnrkti',\n    amount: '100',      // Spending 100 GALA\n    type: 'native'      // 'native' = GALA amount, 'exact' = token amount\n  });\n\n  console.log('LOCAL Buy Quote (instant):');\n  console.log('  Tokens received:', localBuy.amount);\n  console.log('  Transaction fee:', localBuy.transactionFee);\n  console.log('  RBC Fee:', localBuy.reverseBondingCurveFee); // Always \"0\" for buys\n  console.log('  Gas fee:', localBuy.gasFee);\n\n  // 2. Sell calculation (local, requires pool details)\n  const poolDetails = await sdk.fetchPoolDetails('dragnrkti');\n\n  const localSell = await sdk.calculateSellAmountLocal({\n    tokenName: 'dragnrkti',\n    amount: '1000',     // Selling 1000 tokens\n    type: 'exact',\n    // Required parameters from pool details:\n    maxSupply: poolDetails.maxSupply.toString(),\n    minFeePortion: poolDetails.reverseBondingCurveMinFeeFactor || 0,\n    maxFeePortion: poolDetails.reverseBondingCurveMaxFeeFactor || 0\n  });\n\n  console.log('LOCAL Sell Quote (instant):');\n  console.log('  GALA received:', localSell.amount);\n  console.log('  RBC Fee:', localSell.reverseBondingCurveFee);\n  console.log('  Transaction fee:', localSell.transactionFee);\n\n  // ============================================================================\n  // EXTERNAL CALCULATIONS - Real-time network queries (explicit)\n  // ============================================================================\n\n  // 3. External buy (explicit network call)\n  const externalBuy = await sdk.calculateBuyAmountExternal({\n    tokenName: 'dragnrkti',\n    amount: '100',\n    type: 'native'\n  });\n\n  console.log('EXTERNAL Buy Quote (network):');\n  console.log('  Tokens received:', externalBuy.amount);\n\n  // 4. External sell (explicit network call)\n  const externalSell = await sdk.calculateSellAmountExternal({\n    tokenName: 'dragnrkti',\n    amount: '1000',\n    type: 'exact'\n  });\n\n  console.log('EXTERNAL Sell Quote (network):');\n  console.log('  GALA received:', externalSell.amount);\n\n  // ============================================================================\n  // A/B COMPARISON - Verify local accuracy\n  // ============================================================================\n\n  // Use compareAmounts for precise quote comparison\n  const buyComparison = compareAmounts(localBuy.amount, externalBuy.amount);\n  const buyDiff = Math.abs(safeParseNumber(localBuy.amount, 0) - safeParseNumber(externalBuy.amount, 0));\n  const buyPct = (buyDiff / safeParseNumber(externalBuy.amount, 1)) * 100;\n\n  console.log('Local vs External Accuracy:');\n  console.log(`  Buy difference: ${toBigNumberFixed(buyPct, 4)}% (should be <0.01%)`);\n\n  // ============================================================================\n  // PERFORMANCE BENEFIT - Local is instant\n  // ============================================================================\n\n  console.time('Local calculation');\n  await sdk.calculateBuyAmountLocal({ tokenName: 'dragnrkti', amount: '100', type: 'native' });\n  console.timeEnd('Local calculation');  // ~0ms (instant)\n\n  console.time('External calculation');\n  await sdk.calculateBuyAmountExternal({ tokenName: 'dragnrkti', amount: '100', type: 'native' });\n  console.timeEnd('External calculation');  // ~200-500ms (network roundtrip)\n}\n```\n\n**Benefits of Local Calculations:**\n- ✅ Instant quotes (no network delay)\n- ✅ Offline support (no internet required)\n- ✅ No API rate limits\n- ✅ Perfect accuracy (<0.01% difference)\n- ✅ Reduced server load\n\n**When to Use:**\n- Local: Price discovery, UI updates, offline scenarios\n- External: Production trades (always verify before executing)\n\n**MCP Tool Equivalents:**\n- `gala_launchpad_calculate_buy_amount_local`\n- `gala_launchpad_calculate_buy_amount_external`\n- `gala_launchpad_calculate_sell_amount_local`\n- `gala_launchpad_calculate_sell_amount_external`\n",
-      "samplePrompts": [
-        "How do I perform local calculations?",
-        "Show me how to perform local calculations with the SDK",
-        "Explain the perform local calculations workflow",
-        "What methods do I need for perform local calculations?"
-      ]
-    },
-    "price-history": {
-      "key": "price-history",
-      "label": "Price history",
-      "description": "Price history operations",
-      "category": "pools",
-      "methods": [
-        "fetchPriceHistory",
-        "fetchAllPriceHistory"
-      ],
-      "mcpTools": [
-        "gala_launchpad_fetch_price_history",
-        "gala_launchpad_fetch_all_price_history"
-      ],
-      "explanation": "\n## Historical Price Analysis with SDK\n\n**Covers Methods:**\n- `fetchPriceHistory()`\n- `fetchAllPriceHistory()`\n\n```typescript\nimport { createLaunchpadSDK } from '@gala-chain/launchpad-sdk';\n\nasync function analyzePriceHistory() {\n  const sdk = createLaunchpadSDK({\n    wallet: 'your-private-key-or-mnemonic'\n  });\n\n  // Paginated price history\n  const history = await sdk.fetchPriceHistory({\n    tokenId: 'GUSDC|Unit|none|eth:0x...',\n    from: new Date('2025-01-01'),\n    to: new Date('2025-01-31'),\n    sortOrder: 'DESC',\n    page: 1,\n    limit: 50\n  });\n\n  console.log(`Found ${history.snapshots.length} snapshots`);\n  console.log(`Total available: ${history.total} (page ${history.page} of ${history.totalPages})`);\n\n  // Auto-paginated complete history\n  const allHistory = await sdk.fetchAllPriceHistory({\n    tokenId: 'GWETH|Unit|none|none',\n    from: new Date('2024-01-01'),\n    sortOrder: 'ASC'\n  });\n\n  // Price analysis - Convert strings to numbers for statistical calculations\n  // Note: For precise trading amounts, use compareAmounts() from SDK instead\n  const prices = allHistory.snapshots.map(s => safeParseNumber(s.price, 0));\n  const avg = prices.reduce((a, b) => a + b, 0) / prices.length;\n  const variance = prices.reduce((sum, p) => sum + Math.pow(p - avg, 2), 0) / prices.length;\n  const volatility = Math.sqrt(variance);\n\n  console.log(`Average: $${toBigNumberFixed(avg, 4)}, Volatility: $${toBigNumberFixed(volatility, 4)}`);\n\n  // Data export (CSV)\n  const csv = ['timestamp,price'].concat(\n    allHistory.snapshots.map(s => `${s.timestamp.toISOString()},${s.price}`)\n  ).join('\\n');\n\n  console.log('CSV export:', csv.split('\\n').slice(0, 3).join('\\n'));\n}\n```\n\n**Key Methods:**\n- `fetchPriceHistory()` - Paginated historical prices (max 50 per page)\n- `fetchAllPriceHistory()` - Auto-paginated complete history (all snapshots)\n\n**Response Fields:**\n- `price` - Token price as decimal string\n- `timestamp` - ISO 8601 timestamp\n- `tokenId` - Token identifier (pipe-delimited)\n\n**Use Cases:**\n- Technical analysis and charting\n- Volatility assessment\n- Price trend identification\n- Data export for analytics\n- Backtesting strategies\n\n**Token ID Formats:**\n- String: `GUSDC|Unit|none|eth:0x...`\n- Object: `{ collection, category, type, additionalKey }`\n\n**MCP Tool Equivalents:**\n- `gala_launchpad_fetch_price_history` - Paginated\n- `gala_launchpad_fetch_all_price_history` - Auto-paginated\n",
-      "samplePrompts": [
-        "How do I view token price history?",
-        "Show me how to view token price history with the SDK",
-        "Explain the view token price history workflow",
-        "What methods do I need for view token price history?"
-      ]
-    },
-    "spot-prices-smart-routing": {
-      "key": "spot-prices-smart-routing",
-      "label": "Spot prices smart routing",
-      "description": "Spot prices smart routing operations",
-      "category": "utils",
-      "methods": [
-        "fetchTokenPrice",
-        "getSwapPoolPrice"
-      ],
-      "mcpTools": [
-        "gala_launchpad_get_swap_pool_price"
-      ],
-      "explanation": "\n## Smart Spot Price Routing with DEX Fallback\n\n**Covers Methods:**\n- `fetchTokenPrice()` (smart routing)\n- `isTokenGraduated()`\n\nThe SDK intelligently routes pricing requests between DEX and Launchpad backends based on token graduation status - no need to know which backend a token uses!\n\n```typescript\nimport { createLaunchpadSDK } from '@gala-chain/launchpad-sdk';\n\nasync function tokenPricing() {\n  const sdk = createLaunchpadSDK({\n    wallet: 'your-private-key'\n  });\n\n  // OPTION 1: SMART ROUTING (Recommended) - Automatic backend selection\n  // Use tokenId for ANY token (graduated or ungraduated)\n  // SDK automatically detects and routes to correct backend\n  console.log('=== Smart Routing (Recommended) ===');\n  const smartPrice = await sdk.fetchTokenPrice({\n    tokenId: 'Token|Unit|ANIME|eth:0x...'  // Works for ANY token!\n  });\n  console.log(`Token price: $${smartPrice}`);\n  // ✅ Handles graduated tokens (DEX) automatically\n  // ✅ Handles ungraduated tokens (Launchpad) automatically\n  // ✅ No need to know token status beforehand\n\n  // OPTION 2: EXPLICIT DEX PRICING - Graduated tokens only\n  // Use tokenId directly for DEX tokens\n  console.log('\\n=== Explicit DEX Pricing ===');\n  const dexPrices = await sdk.fetchTokenPrice({\n    tokenId: 'GALA|Unit|none|none'  // Or other DEX token\n  });\n  console.log(`DEX Token GALA: $${dexPrices}`);\n\n  // OPTION 3: TOKEN NAME PRICING - For launchpad tokens by name\n  // Use tokenName for simple lookup of launchpad tokens\n  console.log('\\n=== Token Name Pricing ===');\n  const launchpadPrice = await sdk.fetchTokenPrice({ tokenName: 'anime' });\n  console.log(`Launchpad token anime: $${launchpadPrice.price}`);\n\n  // ADVANCED: The smart router handles fallback automatically!\n  // No need for manual fallback - fetchTokenPrice with tokenId detects\n  // ungraduated tokens and automatically falls back to launchpad pricing\n  console.log('\\n=== Automatic Fallback (Built-in) ===');\n  const autoPrice = await sdk.fetchTokenPrice({\n    tokenId: 'Token|Unit|ANIME|eth:0x...'  // Auto-fallback if ungraduated\n  });\n  console.log(`Auto-routed price: $${autoPrice.price}`);\n\n  // USECASE: Price comparison and discovery\n  console.log('\\n=== Price Discovery ===');\n  async function comparePrices(tokenName: string) {\n    const launchpadPrice = await sdk.fetchTokenPrice({ tokenName });\n\n    // Check if graduated (on DEX)\n    const isGraduated = await sdk.isTokenGraduated(tokenName);\n\n    if (isGraduated) {\n      const dexPrice = await sdk.fetchTokenPrice({\n        tokenId: `Token|Unit|${tokenName.toUpperCase()}|eth:0x...`\n      });\n      console.log(`Launchpad: $${launchpadPrice.price}, DEX: $${dexPrice.price}`);\n      return { launchpadPrice, dexPrice, graduated: true };\n    } else {\n      console.log(`Launchpad: $${launchpadPrice.price} (not on DEX yet)`);\n      return { launchpadPrice, graduated: false };\n    }\n  }\n\n  const priceComparison = await comparePrices('anime');\n}\n```\n\n**Smart Routing Benefits:**\n- ✅ **Seamless Transitions** - Works before and after token graduation\n- ✅ **No Backend Knowledge** - SDK handles routing automatically\n- ✅ **Error Handling** - Automatic fallback if needed\n- ✅ **Single API** - Use same method for all tokens\n\n**When to Use Each Method:**\n\n| Method | Use Case | Token Status |\n|--------|----------|--------------|\n| `fetchTokenPrice({ tokenId })` | Smart routing (recommended) | Any (DEX or Launchpad) |\n| `fetchTokenPrice({ tokenName })` | Token name pricing | Any |\n| `isTokenGraduated(name)` | Check token status | Any |\n\n**Key Differences:**\n\n**Ungraduated Tokens (Launchpad):**\n- Priced on exponential bonding curve\n- Token name parameter works: `fetchTokenPrice({ tokenName: 'anime' })`\n- Price affected by supply/demand\n\n**Graduated Tokens (DEX):**\n- Priced on DEX via order books\n- Token ID format needed: `Token|Unit|SYMBOL|eth:0x...`\n- Market-driven pricing\n\n**Graduation Impact:**\nWhen a token graduates from launchpad to DEX:\n- Bonding curve closes\n- Trading moves to DEX order books\n- Smart routing automatically switches backends\n- Old launchpad queries will fail (use DEX pricing instead)\n\n**Error Handling:**\n```typescript\nasync function safePriceQuery(tokenId: string) {\n  try {\n    // Always try smart routing first\n    return await sdk.fetchTokenPrice({ tokenId });\n  } catch (error) {\n    if (error.message.includes('not found')) {\n      console.log('Token not available on DEX');\n      // Could try fallback to launchpad pricing here\n    }\n    throw error;\n  }\n}\n```\n\n**MCP Tool Equivalents:**\n- `gala_launchpad_fetch_token_spot_price` - Smart routing\n- `gala_launchpad_fetch_launchpad_token_spot_price` - Launchpad-only\n- `gala_launchpad_is_token_graduated` - Check graduation status\n",
-      "samplePrompts": [
-        "How do I get token prices with smart routing?",
-        "Show me how to get token prices with smart routing with the SDK",
-        "Explain the get token prices with smart routing workflow",
-        "What methods do I need for get token prices with smart routing?"
-      ]
-    },
-    "profile-management": {
-      "key": "profile-management",
-      "label": "Profile management",
-      "description": "Profile management operations",
-      "category": "balance",
-      "methods": [
-        "fetchProfile",
-        "updateProfile",
-        "uploadProfileImage",
-        "getManagedTokens"
-      ],
-      "mcpTools": [
-        "gala_launchpad_fetch_profile",
-        "gala_launchpad_update_profile",
-        "gala_launchpad_upload_profile_image",
-        "gala_launchpad_get_managed_tokens"
-      ],
-      "explanation": "\n## User Profile Management with SDK\n\n**Covers Methods:**\n- `fetchProfile()`\n- `updateProfile()`\n- `uploadProfileImage()`\n\n```typescript\nimport { createLaunchpadSDK } from '@gala-chain/launchpad-sdk';\n\nasync function manageUserProfiles() {\n  const sdk = createLaunchpadSDK({\n    wallet: 'your-private-key-or-mnemonic'\n  });\n\n  // Fetch current user profile\n  const myProfile = await sdk.fetchProfile();\n  console.log(`Name: ${myProfile.fullName}`);\n  console.log(`Avatar: ${myProfile.profileImage}`);\n\n  // Fetch another user's profile\n  const other = await sdk.fetchProfile('eth|0x...');\n  console.log(`Other user: ${other.fullName}`);\n\n  // Update profile\n  const updated = await sdk.updateProfile({\n    fullName: 'Satoshi Nakamoto',\n    profileImage: 'https://example.com/avatar.png',\n    address: sdk.getAddress()\n  });\n\n  console.log(`Updated: ${updated.fullName}`);\n\n  // Upload profile image (Node.js only)\n  const imgResult = await sdk.uploadProfileImage({\n    imagePath: '/path/to/avatar.png'\n  });\n\n  // Update with uploaded image\n  await sdk.updateProfile({\n    fullName: 'My Name',\n    profileImage: imgResult.imageUrl,\n    address: sdk.getAddress()\n  });\n\n  // Complete workflow: Update profile, then launch token\n  async function createTokenWithProfile() {\n    const avatar = await sdk.uploadProfileImage({\n      imagePath: '/path/to/pic.png'\n    });\n\n    await sdk.updateProfile({\n      fullName: 'Token Creator',\n      profileImage: avatar.imageUrl,\n      address: sdk.getAddress()\n    });\n\n    const logo = await sdk.uploadTokenImage({\n      tokenName: 'mytoken',\n      imagePath: '/path/to/logo.png'\n    });\n\n    const result = await sdk.launchToken({\n      tokenName: 'mytoken',\n      tokenSymbol: 'MTK',\n      tokenDescription: 'Awesome token',\n      tokenImage: logo.imageUrl,\n      websiteUrl: 'https://mytoken.com'\n    });\n\n    return result;\n  }\n\n  // Batch profile fetching\n  const addresses = ['eth|0xaddress1', 'eth|0xaddress2'];\n  const profiles = await Promise.all(\n    addresses.map(addr => sdk.fetchProfile(addr).catch(() => null))\n  );\n\n  console.log('Profiles:', profiles.filter(p => p).map(p => p.fullName));\n}\n```\n\n**Profile Methods:**\n- `fetchProfile(address?)` - Get user profile\n- `updateProfile(data)` - Update profile info\n- `uploadProfileImage(options)` - Upload avatar (Node.js)\n- `getManagedTokens()` - Get tokens you manage (creator, moderator, manager, technical producer)\n\n**Profile Fields:**\n- `fullName` - Display name (max 100 chars)\n- `profileImage` - Avatar image URL\n- `address` - Wallet address\n- `createdAt` - Creation date\n- `updatedAt` - Update timestamp\n\n**Use Cases:**\n- Display user profiles\n- Allow profile customization\n- Manage profile images\n- Token creator attribution\n- Multi-wallet profiles\n\n**MCP Tool Equivalents:**\n- `gala_launchpad_fetch_profile`\n- `gala_launchpad_update_profile`\n- `gala_launchpad_upload_profile_image`\n- `gala_launchpad_get_managed_tokens`\n",
-      "samplePrompts": [
-        "How do I manage user profiles?",
-        "Show me how to manage user profiles with the SDK",
-        "Explain the manage user profiles workflow",
-        "What methods do I need for manage user profiles?"
-      ]
-    },
-    "liquidity-positions": {
-      "key": "liquidity-positions",
-      "label": "Liquidity positions",
-      "description": "Liquidity positions operations",
-      "category": "utils",
-      "methods": [
-        "getSwapUserLiquidityPositions",
-        "getAllSwapUserLiquidityPositions",
-        "getSwapLiquidityPosition",
-        "getSwapLiquidityPositionById",
-        "addSwapLiquidityByPrice",
-        "addSwapLiquidityByTicks",
-        "getSwapEstimateRemoveLiquidity",
-        "removeSwapLiquidity",
-        "collectSwapPositionFees"
-      ],
-      "mcpTools": [],
-      "explanation": "\n## GSwap Liquidity Position Management\n\n**Covers Methods:**\n- `getSwapUserLiquidityPositions()`\n- `getAllSwapUserLiquidityPositions()`\n- `getSwapLiquidityPosition()`\n- `getSwapLiquidityPositionById()`\n- `addSwapLiquidityByPrice()`\n- `addSwapLiquidityByTicks()`\n- `getSwapEstimateRemoveLiquidity()`\n- `removeSwapLiquidity()`\n- `collectSwapPositionFees()`\n\nProvide liquidity on GalaSwap DEX and earn passive trading fees from swaps.\n\n**Overview:** Concentrated liquidity allows capital deployment within specific price ranges. Liquidity providers earn fees when trades occur within their price range, making it an attractive passive income strategy.\n\n**9 Core SDK Methods:**\n\n1. **getSwapUserLiquidityPositions(ownerAddress, limit?, bookmark?)** - View all open positions for wallet\n   - Returns: Array of positions with token pairs, amounts, accumulated fees\n\n2. **getSwapLiquidityPositionById(ownerAddress, positionId)** - Get specific position by UUID\n\n3. **getSwapLiquidityPosition(ownerAddress, position)** - Get position by token pair and tick range\n\n4. **addSwapLiquidityByPrice(args)** - Create position using user-friendly price ranges\n   - params: token0, token1, fee, minPrice, maxPrice, amount0Desired, amount1Desired\n\n5. **addSwapLiquidityByTicks(args)** - Create position using precise tick boundaries (advanced)\n\n6. **getSwapEstimateRemoveLiquidity(args)** - Preview removal amounts before executing\n   - Returns: estimated token amounts and accumulated fees\n\n7. **removeSwapLiquidity(args)** - Close or reduce position with slippage protection\n   - Removes liquidity and collects accumulated fees\n\n8. **collectSwapPositionFees(args)** - Harvest accumulated fees without closing position\n   - Passive income collection\n\n**Fee Tiers:** 500 bps (0.05%), 3000 bps (0.30%), 10000 bps (1.00%)\n\n**MCP Tools (8 tools):**\n- gala_launchpad_get_user_liquidity_positions\n- gala_launchpad_get_liquidity_position_by_id\n- gala_launchpad_get_liquidity_position\n- gala_launchpad_add_liquidity_by_price\n- gala_launchpad_add_liquidity_by_ticks\n- gala_launchpad_estimate_remove_liquidity\n- gala_launchpad_remove_liquidity\n- gala_launchpad_collect_position_fees\n\n**Slash Commands (4 commands):**\n- /galachain-launchpad:my-positions - View all positions\n- /galachain-launchpad:add-liquidity - Create position\n- /galachain-launchpad:remove-liquidity - Close position\n- /galachain-launchpad:collect-fees - Harvest fees\n\n**Auto-Pagination Method:**\n\nUse `getAllSwapUserLiquidityPositions()` to fetch all positions without manual pagination:\n\n```typescript\n// Fetch ALL positions automatically (handles pagination internally)\nconst allPositions = await sdk.getAllSwapUserLiquidityPositions(ownerAddress);\n\nconsole.log(`Total positions: ${allPositions.length}`);\nallPositions.forEach(position => {\n  const fees = position.fees0 + position.fees1; // Total accumulated fees\n  console.log(`Position: ${position.token0}-${position.token1}`);\n  console.log(`Accumulated fees: ${fees}`);\n});\n```\n\n**Demo Script:** See packages/sdk/examples/demo-liquidity-positions.ts for complete workflows\n",
-      "samplePrompts": [
-        "How do I manage liquidity positions?",
-        "Show me how to manage liquidity positions with the SDK",
-        "Explain the manage liquidity positions workflow",
-        "What methods do I need for manage liquidity positions?"
-      ]
-    },
-    "advanced-dex-analysis": {
-      "key": "advanced-dex-analysis",
-      "label": "Advanced dex analysis",
-      "description": "Advanced dex analysis operations",
-      "category": "dex-pools",
-      "methods": [
-        "fetchCompositePoolData",
-        "calculateDexPoolQuoteExactAmountLocal",
-        "calculateDexPoolQuoteExactAmountExternal",
-        "calculateDexPoolQuoteExactAmount"
-      ],
-      "mcpTools": [
-        "gala_launchpad_fetch_composite_pool_data"
-      ],
-      "explanation": "\n## Advanced DEX Pool Analysis with SDK\n\n**Covers Methods:**\n- `fetchCompositePoolData()`\n- `calculateDexPoolQuoteExactAmountLocal()`\n- `calculateDexPoolQuoteExactAmountExternal()`\n- `calculateDexPoolQuoteExactAmount()`\n\nThis workflow demonstrates analyzing graduated tokens using composite data and price calculations.\n\n**Use Cases:**\n- Arbitrage opportunity detection\n- Price impact analysis before large trades\n- Comparing bonding curve vs DEX pricing\n- Smart routing for best execution\n\n```typescript\nimport { createLaunchpadSDK } from '@gala-chain/launchpad-sdk';\n\nasync function advancedDexAnalysis() {\n  const sdk = createLaunchpadSDK({ environment: 'production' });\n\n  // Step 1: Get composite pool data (bonding curve + DEX if graduated)\n  const composite = await sdk.fetchCompositePoolData('anime');\n\n  if (composite.isGraduated) {\n    console.log('Token graduated to DEX!');\n    console.log('DEX Pool TVL:', composite.dexPool.tvl);\n    console.log('DEX 24h Volume:', composite.dexPool.volume1d);\n  }\n\n  // Step 2: Compare local vs external price calculations\n  const localQuote = await sdk.calculateDexPoolQuoteExactAmountLocal(\n    'GALA|Unit|none|none',\n    'anime|Unit|none|eth:0x...',\n    '100'\n  );\n\n  const externalQuote = await sdk.calculateDexPoolQuoteExactAmountExternal(\n    'GALA|Unit|none|none',\n    'anime|Unit|none|eth:0x...',\n    '100'\n  );\n\n  console.log('Local calculation:', localQuote.outputAmount);\n  console.log('External API:', externalQuote.outputAmount);\n  console.log('Price difference:',\n    Math.abs(safeParseFloat(localQuote.outputAmount, 0) - safeParseFloat(externalQuote.outputAmount, 0))\n  );\n\n  // Step 3: Use smart routing for best price\n  const bestQuote = await sdk.calculateDexPoolQuoteExactAmount(\n    'GALA|Unit|none|none',\n    'anime|Unit|none|eth:0x...',\n    '100'\n  );\n\n  console.log('Best route:', bestQuote.route); // 'local' or 'external'\n  console.log('Best price:', bestQuote.outputAmount);\n}\n```\n\n**MCP Tools:**\n- `gala_launchpad_fetch_composite_pool_data`\n- `gala_launchpad_calculate_dex_pool_quote_exact_amount_local`\n- `gala_launchpad_calculate_dex_pool_quote_exact_amount_external`\n- `gala_launchpad_calculate_dex_pool_quote_exact_amount`\n",
-      "samplePrompts": [
-        "How do I analyze DEX trading data?",
-        "Show me how to analyze DEX trading data with the SDK",
-        "Explain the analyze DEX trading data workflow",
-        "What methods do I need for analyze DEX trading data?"
-      ]
-    },
-    "trading-analytics": {
-      "key": "trading-analytics",
-      "label": "Trading analytics",
-      "description": "Trading analytics operations",
-      "category": "trading",
-      "methods": [
-        "fetchTrades",
-        "getTrades"
-      ],
-      "mcpTools": [
-        "gala_launchpad_fetch_trades",
-        "gala_launchpad_get_trades"
-      ],
-      "explanation": "\n## Trading History and Analytics\n\n**Covers Methods:**\n- `fetchTrades()` - Legacy trade fetching by token\n- `getV1Trades()` - Flexible trade queries with tokenName/userAddress filters\n\nAnalyze individual trades for technical analysis and bot development.\n\n**Use Cases:**\n- Track recent trading activity\n- Calculate average trade size\n- Identify whale transactions\n- Build trading bots with historical data\n- Query a user's trading history across all tokens\n\n```typescript\nimport { createLaunchpadSDK } from '@gala-chain/launchpad-sdk';\n\nasync function tradingAnalytics() {\n  const sdk = createLaunchpadSDK({ environment: 'production' });\n\n  // Fetch recent trades for a token (legacy method)\n  const trades = await sdk.fetchTrades('anime', {\n    limit: 100,\n    page: 1\n  });\n\n  console.log(`Analyzing ${trades.total} trades`);\n\n  // Calculate analytics\n  const totalVolume = trades.trades.reduce((sum, t) => sum + safeParseFloat(t.galaAmount, 0), 0);\n  const averageTradeSize = totalVolume / trades.trades.length;\n  const whaleTrades = trades.trades.filter(t => safeParseFloat(t.galaAmount, 0) > 1000);\n\n  console.log(`Total volume: ${totalVolume} GALA`);\n  console.log(`Average trade size: ${averageTradeSize} GALA`);\n  console.log(`Whale trades (>1000 GALA): ${whaleTrades.length}`);\n\n  // Most recent trades\n  trades.trades.slice(0, 10).forEach(trade => {\n    console.log(`${trade.type}: ${trade.galaAmount} GALA at ${trade.timestamp}`);\n  });\n}\n\n// V1 Trades API - Flexible queries with filters\nasync function queryTradesV1() {\n  const sdk = createLaunchpadSDK({ environment: 'production' });\n\n  // Query all trades for a specific token\n  const { trades, meta } = await sdk.getV1Trades({ tokenName: 'anime' });\n  console.log(`Found ${meta.totalItems} trades for anime`);\n\n  // Query all trades by a specific user\n  const userTrades = await sdk.getV1Trades({\n    userAddress: 'eth|1234567890abcdef...'\n  });\n  console.log(`User has ${userTrades.meta.totalItems} trades across all tokens`);\n\n  // Query a user's trades on a specific token with pagination\n  const filteredTrades = await sdk.getV1Trades({\n    tokenName: 'anime',\n    userAddress: 'eth|1234567890abcdef...',\n    page: 2,\n    limit: 20\n  });\n  console.log(`Page ${filteredTrades.meta.currentPage} of ${filteredTrades.meta.totalPages}`);\n\n  // Analyze trade types\n  filteredTrades.trades.forEach(trade => {\n    console.log(`${trade.txnType}: ${trade.inputAmount} -> ${trade.outputAmount}`);\n  });\n}\n```\n\n**Related Topics:**\n- See `fetch-pools` for volume data analysis\n- See `dex-trading` for executing trades\n\n**MCP Tools:**\n- `gala_launchpad_fetch_trades` - Legacy trade fetching\n- `gala_launchpad_get_v1_trades` - Flexible trade queries with filters\n",
-      "samplePrompts": [
-        "How do I analyze trading data?",
-        "Show me how to analyze trading data with the SDK",
-        "Explain the analyze trading data workflow",
-        "What methods do I need for analyze trading data?"
-      ]
-    },
-    "utilities-and-helpers": {
-      "key": "utilities-and-helpers",
-      "label": "Utilities and helpers",
-      "description": "Utilities and helpers operations",
-      "category": "utils",
-      "methods": [
-        "fetchGalaPrice",
-        "fetchTokenClassesWithSupply",
-        "calculateInitialBuyAmount",
-        "getBundlerTransactionResult",
-        "getSwapPoolPrice",
-        "fetchSwapPositionDirect",
-        "getAllSwapUserAssets",
-        "cleanup",
-        "clearCache",
-        "getCacheInfo"
-      ],
-      "mcpTools": [
-        "gala_launchpad_fetch_token_classes_with_supply",
-        "gala_launchpad_get_bundler_transaction_result",
-        "gala_launchpad_get_swap_pool_price",
-        "gala_launchpad_fetch_swap_position_direct",
-        "gala_launchpad_get_all_swap_user_assets",
-        "gala_launchpad_cleanup",
-        "gala_launchpad_clear_cache",
-        "gala_launchpad_get_cache_info"
-      ],
-      "explanation": "\n## Utility Methods and Helpers\n\n**Covers Methods:**\n- `fetchGalaPrice()`\n- `fetchTokenClassesWithSupply()`\n- `calculateInitialBuyAmount()`\n- `getBundlerTransactionResult()`\n- `getSwapPoolPrice()`\n- `fetchSwapPositionDirect()`\n- `getAllSwapUserAssets()`\n- `cleanup()`\n\nEssential helper methods for development, debugging, and special use cases.\n\n### Price & Supply Queries\n\n```typescript\n// Get current GALA price in USD\nconst galaPrice = await sdk.fetchGalaPrice();\nconsole.log(`GALA: $${galaPrice}`);\n\n// Get token supply metrics from GalaChain\nconst supplies = await sdk.fetchTokenClassesWithSupply();\nsupplies.forEach(token => {\n  console.log(`${token.tokenClass}: ${token.totalSupply}`);\n});\n```\n\n### Transaction Monitoring\n\n```typescript\n// Check transaction status\nconst status = await sdk.getBundlerTransactionResult('tx-id-123');\nconsole.log('Status:', status.status); // 'pending' | 'success' | 'failed'\n```\n\n### Advanced Swap Queries\n\n```typescript\n// Get pool price without full quote\nconst price = await sdk.getSwapPoolPrice('GALA|Unit|none|none', 'GUSDC|Unit|none|none');\nconsole.log(`Pool price: ${price}`);\n\n// Auto-paginated asset fetch\nconst allAssets = await sdk.getAllSwapUserAssets('eth|0x...', { limit: 100 });\nconsole.log(`Total assets: ${allAssets.length}`);\n\n// Direct position lookup (if you have compound key)\nconst position = await sdk.fetchSwapPositionDirect({\n  owner: 'eth|0x...',\n  token0: 'GALA|Unit|none|none',\n  token1: 'GUSDC|Unit|none|none',\n  feeTier: 3000\n});\n```\n\n### Launch Calculations\n\n```typescript\n// Calculate initial buy amount for token launch\nconst buyAmount = await sdk.calculateInitialBuyAmount('100');\nconsole.log(`Initial buy: ${buyAmount} tokens`);\n```\n\n### SDK Cleanup\n\n```typescript\n// Proper cleanup when done (closes connections)\nawait sdk.cleanup();\n```\n\n### Monitor Bundler Transactions\n\n```typescript\n// After a trade, monitor transaction status\nconst tradeResult = await sdk.buy({ tokenName, amount, type: 'native', expectedAmount, slippageToleranceFactor: 0.01 });\n\n// Poll for completion\nconst status = await sdk.getBundlerTransactionResult(tradeResult.transactionId);\nconsole.log('Status:', status.status); // PENDING, PROCESSING, COMPLETED, FAILED\n\n// Wait with polling\nlet attempts = 0;\nwhile (status.status === 'PENDING' || status.status === 'PROCESSING') {\n  await new Promise(r => setTimeout(r, 2000));\n  const updated = await sdk.getBundlerTransactionResult(tradeResult.transactionId);\n  if (updated.status === 'COMPLETED') break;\n  if (++attempts > 30) throw new Error('Transaction timeout');\n}\n```\n\n**MCP Tools:**\n- `gala_launchpad_fetch_gala_price`\n- `gala_launchpad_fetch_token_classes_with_supply`\n- `gala_launchpad_calculate_initial_buy_amount`\n- `gala_launchpad_get_bundler_transaction_result`\n- `gala_launchpad_get_swap_pool_price`\n- `gala_launchpad_fetch_swap_position_direct`\n- `gala_launchpad_get_all_swap_user_assets`\n",
-      "samplePrompts": [
-        "How do I use SDK utilities and helpers?",
-        "Show me how to use SDK utilities and helpers with the SDK",
-        "Explain the use SDK utilities and helpers workflow",
-        "What methods do I need for use SDK utilities and helpers?"
-      ]
-    },
-    "utilities-system": {
-      "key": "utilities-system",
-      "label": "Utilities system",
-      "description": "Utilities system operations",
-      "category": "wallet",
-      "methods": [
-        "getAddress",
-        "getConfig",
-        "getEthereumAddress",
-        "getUrlByTokenName",
-        "getVersion",
-        "getWallet",
-        "hasWallet",
-        "setWallet",
-        "connectWebSocket",
-        "disconnectWebSocket",
-        "isWebSocketConnected"
-      ],
-      "mcpTools": [
-        "gala_launchpad_get_address",
-        "gala_launchpad_get_config",
-        "gala_launchpad_get_ethereum_address",
-        "gala_launchpad_get_url_by_token_name",
-        "gala_launchpad_get_version",
-        "gala_launchpad_get_wallet",
-        "gala_launchpad_has_wallet",
-        "gala_launchpad_set_wallet"
-      ],
-      "explanation": "\n## SDK Configuration and Wallet Utilities\n\n**Covers Methods:**\n- `getAddress()`\n- `getConfig()`\n- `getEthereumAddress()`\n- `getUrlByTokenName()`\n- `getVersion()`\n- `getWallet()`\n- `hasWallet()`\n- `setWallet()`\n\nEssential utilities for SDK configuration, wallet management, and system information.\n\n```typescript\nimport { createLaunchpadSDK } from '@gala-chain/launchpad-sdk';\n\nasync function sdkUtilities() {\n  // ============================================================================\n  // ADDRESS MANAGEMENT - Get wallet addresses in different formats\n  // ============================================================================\n\n  const sdk = createLaunchpadSDK({ wallet: 'your-private-key' });\n\n  // Get GalaChain address (eth|0x... format)\n  const galaAddress = sdk.getAddress();\n  console.log(`GalaChain address: ${galaAddress}`); // \"eth|0x1234...\"\n\n  // Get Ethereum address (0x... format)\n  const ethAddress = sdk.getEthereumAddress();\n  console.log(`Ethereum address: ${ethAddress}`); // \"0x1234...\"\n\n  // ============================================================================\n  // WALLET MANAGEMENT - Check and update wallet\n  // ============================================================================\n\n  // Check if SDK has wallet configured\n  if (sdk.hasWallet()) {\n    console.log('Wallet configured - can execute trades');\n\n    // Get wallet instance (for advanced use)\n    const wallet = sdk.getWallet();\n    console.log(`Wallet address: ${wallet.address}`);\n  } else {\n    console.log('Read-only mode - cannot execute trades');\n  }\n\n  // Update wallet at runtime\n  sdk.setWallet('new-private-key');\n  console.log(`New address: ${sdk.getAddress()}`);\n\n  // ============================================================================\n  // CONFIGURATION ACCESS - Get SDK config\n  // ============================================================================\n\n  // Get SDK configuration\n  const config = sdk.getConfig();\n  console.log(`Base URL: ${config.baseUrl}`);\n  console.log(`Environment: ${config.env}`);\n  console.log(`Debug: ${config.debug}`);\n  console.log(`Timeout: ${config.timeout}ms`);\n\n  // ============================================================================\n  // VERSION INFORMATION - Get SDK version\n  // ============================================================================\n\n  // Get SDK version\n  const version = sdk.getVersion();\n  console.log(`SDK Version: ${version}`); // \"4.0.4-beta.0\"\n\n  // ============================================================================\n  // URL GENERATION - Get frontend URLs for tokens\n  // ============================================================================\n\n  // Generate frontend URL for token\n  const url = sdk.getUrlByTokenName('anime');\n  console.log(`Token URL: ${url}`);\n  // \"https://launchpad.gala.com/token/anime\" (production)\n  // \"https://lpad-dev1.defi.gala.com/token/anime\" (development)\n\n  // Complete workflow: Launch token + share URL\n  const launchResult = await sdk.launchToken({\n    tokenName: 'mytoken',\n    tokenSymbol: 'MTK',\n    tokenDescription: 'My awesome token'\n  });\n\n  const tokenUrl = sdk.getUrlByTokenName('mytoken');\n  console.log(`Share your token: ${tokenUrl}`);\n\n  // ============================================================================\n  // MULTI-WALLET SCENARIO - Check multiple addresses\n  // ============================================================================\n\n  async function compareWallets() {\n    const wallet1 = createLaunchpadSDK({ wallet: 'private-key-1' });\n    const wallet2 = createLaunchpadSDK({ wallet: 'private-key-2' });\n\n    console.log(`Wallet 1: ${wallet1.getAddress()}`);\n    console.log(`Wallet 2: ${wallet2.getAddress()}`);\n\n    // Compare balances\n    const balance1 = await wallet1.fetchGalaBalance();\n    const balance2 = await wallet2.fetchGalaBalance();\n\n    console.log(`Wallet 1 balance: ${balance1.balance}`);\n    console.log(`Wallet 2 balance: ${balance2.balance}`);\n  }\n\n  // ============================================================================\n  // READ-ONLY SDK - Public data without wallet\n  // ============================================================================\n\n  async function readOnlyMode() {\n    // Create SDK without wallet (read-only mode)\n    const readOnlySdk = createLaunchpadSDK();\n\n    console.log(`Has wallet: ${readOnlySdk.hasWallet()}`); // false\n\n    // Can fetch public data\n    const pools = await readOnlySdk.fetchPools({ type: 'recent', limit: 10 });\n    console.log(`Found ${pools.total} pools`);\n\n    // Cannot execute trades (will throw error)\n    try {\n      await readOnlySdk.buy({ tokenName: 'anime', amount: '100', type: 'native' });\n    } catch (error) {\n      console.error('Cannot trade without wallet');\n    }\n  }\n\n  // ============================================================================\n  // ENVIRONMENT SWITCHING - Change environments at runtime\n  // ============================================================================\n\n  async function switchEnvironments() {\n    // Production SDK\n    const prodSdk = createLaunchpadSDK({\n      wallet: 'your-private-key',\n      config: { env: 'production' }\n    });\n\n    console.log(`Prod config: ${prodSdk.getConfig().baseUrl}`);\n    console.log(`Prod URL: ${prodSdk.getUrlByTokenName('anime')}`);\n\n    // Development SDK\n    const devSdk = createLaunchpadSDK({\n      wallet: 'your-private-key',\n      config: { env: 'development' }\n    });\n\n    console.log(`Dev config: ${devSdk.getConfig().baseUrl}`);\n    console.log(`Dev URL: ${devSdk.getUrlByTokenName('anime')}`);\n  }\n}\n```\n\n**Key Methods:**\n\n| Method | Returns | Use Case |\n|--------|---------|----------|\n| `getAddress()` | GalaChain address (eth|0x...) | Trading, transfers, profile |\n| `getEthereumAddress()` | Ethereum address (0x...) | DEX trading, external systems |\n| `getConfig()` | SDK configuration object | Debug, environment info |\n| `getVersion()` | SDK version string | Compatibility checks |\n| `getUrlByTokenName()` | Frontend URL | Share token pages |\n| `getWallet()` | Wallet instance | Advanced wallet operations |\n| `hasWallet()` | Boolean | Check if trades enabled |\n| `setWallet()` | void | Update wallet at runtime |\n\n**MCP Tool Equivalents:**\n- `gala_launchpad_get_address`\n- `gala_launchpad_get_ethereum_address`\n- `gala_launchpad_get_config`\n- `gala_launchpad_get_version`\n- `gala_launchpad_get_url_by_token_name`\n",
-      "samplePrompts": [
-        "How do I access system utilities?",
-        "Show me how to access system utilities with the SDK",
-        "Explain the access system utilities workflow",
-        "What methods do I need for access system utilities?"
-      ]
-    },
-    "fetch-all-dex-seasons": {
-      "key": "fetch-all-dex-seasons",
-      "label": "Fetch all dex seasons",
-      "description": "Fetch all dex seasons operations",
-      "category": "dex-analytics",
-      "methods": [
-        "fetchAllDexSeasons"
-      ],
-      "mcpTools": [
-        "gala_launchpad_fetch_all_dex_seasons"
-      ],
-      "explanation": "\n## DEX Leaderboard Seasons Management\n\n**Covers Methods:**\n- `fetchAllDexSeasons()`\n- `fetchCurrentDexSeason()`\n\nDiscover and manage DEX leaderboard seasons for competitive trading events.\n\n```typescript\nimport { createLaunchpadSDK } from '@gala-chain/launchpad-sdk';\n\nasync function manageDexSeasons() {\n  const sdk = createLaunchpadSDK({ wallet: 'your-private-key' });\n\n  // Fetch all available seasons\n  const seasons = await sdk.fetchAllDexSeasons();\n\n  // Display season information\n  seasons.forEach(season => {\n    console.log(`Season: ${season.name} (ID: ${season.id})`);\n    console.log(`Duration: ${season.start} to ${season.end}`);\n  });\n\n  // Get current season\n  const activeSeason = await sdk.fetchCurrentDexSeason();\n  if (activeSeason) {\n    console.log(`Active: ${activeSeason.name}`);\n  } else {\n    console.log('No active season (between seasons)');\n  }\n\n  // Verify season is active\n  const now = new Date();\n  const isActive = activeSeason && now >= activeSeason.start && now <= activeSeason.end;\n  console.log(`Season active: ${isActive}`);\n}\n```\n\n**MCP Tool Equivalents:**\n- `gala_launchpad_fetch_all_dex_seasons`\n- `gala_launchpad_fetch_current_dex_season`\n",
-      "samplePrompts": [
-        "How do I fetch DEX leaderboard seasons?",
-        "Show me how to fetch DEX leaderboard seasons with the SDK",
-        "Explain the fetch DEX leaderboard seasons workflow",
-        "What methods do I need for fetch DEX leaderboard seasons?"
-      ]
-    },
-    "fetch-current-dex-season": {
-      "key": "fetch-current-dex-season",
-      "label": "Fetch current dex season",
-      "description": "Fetch current dex season operations",
-      "category": "dex-analytics",
-      "methods": [
-        "fetchCurrentDexSeason"
-      ],
-      "mcpTools": [
-        "gala_launchpad_fetch_current_dex_season"
-      ],
-      "explanation": "\n## Fetch Current DEX Season\n\n**Covers Methods:**\n- `fetchCurrentDexSeason()`\n\nGet the currently active DEX leaderboard season for competitive trading.\n\n```typescript\nimport { createLaunchpadSDK } from '@gala-chain/launchpad-sdk';\n\nasync function getCurrentSeason() {\n  const sdk = createLaunchpadSDK({ wallet: 'your-private-key' });\n\n  // Fetch the current active season\n  const currentSeason = await sdk.fetchCurrentDexSeason();\n\n  if (currentSeason) {\n    console.log('Current DEX Season:');\n    console.log(`  Season ID: ${currentSeason.id}`);\n    console.log(`  Name: ${currentSeason.name}`);\n    console.log(`  Start: ${currentSeason.start.toISOString()}`);\n    console.log(`  End: ${currentSeason.end.toISOString()}`);\n\n    // Check if season is currently active\n    const now = new Date();\n    const isActive = now >= currentSeason.start && now <= currentSeason.end;\n\n    console.log(`  Active: ${isActive}`);\n\n    // Calculate time remaining\n    const timeRemaining = currentSeason.end.getTime() - now.getTime();\n    const daysRemaining = Math.floor(timeRemaining / (1000 * 60 * 60 * 24));\n\n    console.log(`  Days remaining: ${daysRemaining}`);\n\n    // Fetch leaderboard for current season\n    const leaderboard = await sdk.fetchDexLeaderboardBySeasonId(currentSeason.id);\n    console.log(`  Total participants: ${leaderboard.entries.length}`);\n\n    // Show top 3 players\n    leaderboard.entries.slice(0, 3).forEach((entry, index) => {\n      console.log(`  #${index + 1}: ${entry.wallet} - ${entry.totalXp} XP`);\n    });\n  } else {\n    console.log('No active season (between seasons)');\n\n    // Fetch all seasons to see when next one starts\n    const allSeasons = await sdk.fetchAllDexSeasons();\n    const futureSeason = allSeasons.find(s => s.start > new Date());\n\n    if (futureSeason) {\n      console.log(`Next season starts: ${futureSeason.start.toISOString()}`);\n    }\n  }\n}\n\n// Complete workflow: Check season + participate\nasync function participateInSeason() {\n  const sdk = createLaunchpadSDK({ wallet: 'your-private-key' });\n\n  const season = await sdk.fetchCurrentDexSeason();\n\n  if (season) {\n    console.log(`Active season: ${season.name}`);\n\n    // Execute trades to earn XP\n    const quote = await sdk.getSwapQuoteExactInput('GALA', 'GUSDC', '100');\n    const swap = await sdk.executeSwap(\n      'GALA',\n      'GUSDC',\n      '100',\n      quote.estimatedOutput,\n      quote.feeTier,\n      0.01\n    );\n\n    console.log('Trade executed - XP earned!');\n\n    // Check updated leaderboard position\n    const leaderboard = await sdk.fetchCurrentDexLeaderboard();\n    const myPosition = leaderboard?.entries.find(\n      e => e.wallet === sdk.getAddress()\n    );\n\n    if (myPosition) {\n      console.log(`Current rank: #${myPosition.rank}`);\n      console.log(`Total XP: ${myPosition.totalXp}`);\n    }\n  } else {\n    console.log('No active season - trades won't earn XP');\n  }\n}\n```\n\n**Use Cases:**\n- Check if competitive trading is active\n- Display season information in UI\n- Calculate time remaining in season\n- Auto-participate in seasonal trading\n- Track seasonal leaderboard position\n\n**Related Methods:**\n- `fetchAllDexSeasons()` - Get all seasons (past, current, future)\n- `fetchDexLeaderboardBySeasonId()` - Get leaderboard for specific season\n- `fetchCurrentDexLeaderboard()` - Get current season leaderboard (convenience)\n\n**MCP Tool Equivalent:** `gala_launchpad_fetch_current_dex_season`\n",
-      "samplePrompts": [
-        "How do I get current DEX season info?",
-        "Show me how to get current DEX season info with the SDK",
-        "Explain the get current DEX season info workflow",
-        "What methods do I need for get current DEX season info?"
-      ]
-    },
-    "fetch-dex-leaderboard-by-season-id": {
-      "key": "fetch-dex-leaderboard-by-season-id",
-      "label": "Fetch dex leaderboard by season id",
-      "description": "Fetch dex leaderboard by season id operations",
-      "category": "dex-analytics",
-      "methods": [
-        "fetchDexLeaderboardBySeasonId"
-      ],
-      "mcpTools": [
-        "gala_launchpad_fetch_dex_leaderboard_by_season_id"
-      ],
-      "explanation": "\n## DEX Leaderboard Rankings by Season\n\n**Covers Methods:**\n- `fetchDexLeaderboardBySeasonId()`\n- `fetchCurrentDexLeaderboard()`\n\nQuery leaderboard rankings for competitive DEX trading seasons.\n\n```typescript\nimport { createLaunchpadSDK } from '@gala-chain/launchpad-sdk';\n\nasync function viewLeaderboards() {\n  const sdk = createLaunchpadSDK({ wallet: 'your-private-key' });\n\n  // Option 1: Fetch leaderboard for specific season\n  const leaderboard = await sdk.fetchDexLeaderboardBySeasonId(4);\n\n  // Display top 10 ranked players\n  console.log(`Season ${leaderboard.seasonId} - Top 10 Players:`);\n  leaderboard.entries.slice(0, 10).forEach(entry => {\n    console.log(`  ${entry.rank}. ${entry.wallet}`);\n    console.log(`     XP: ${entry.totalXp} (Liquidity: ${entry.liquidityXp}, Trading: ${entry.tradingXp})`);\n  });\n\n  // Analyze mastery titles\n  const topPlayer = leaderboard.entries[0];\n  topPlayer.masteryTitles.forEach(title => {\n    console.log(`  🏆 ${title.name} (Type: ${title.type}, Tier: ${title.order})`);\n  });\n\n  // Option 2: Get current leaderboard (convenience method)\n  const currentBoard = await sdk.fetchCurrentDexLeaderboard();\n\n  if (currentBoard) {\n    console.log(`Season ${currentBoard.seasonId} is active`);\n    console.log(`Total participants: ${currentBoard.entries.length}`);\n\n    // Top 3 performers\n    const topThree = currentBoard.entries.slice(0, 3);\n    topThree.forEach(entry => {\n      console.log(`  #${entry.rank}: ${entry.totalXp} XP`);\n    });\n  }\n}\n```\n\n**MCP Tool Equivalents:**\n- `gala_launchpad_fetch_dex_leaderboard_by_season_id`\n- `gala_launchpad_fetch_current_dex_leaderboard`\n",
-      "samplePrompts": [
-        "How do I view DEX leaderboard rankings?",
-        "Show me how to view DEX leaderboard rankings with the SDK",
-        "Explain the view DEX leaderboard rankings workflow",
-        "What methods do I need for view DEX leaderboard rankings?"
-      ]
-    },
-    "fetch-current-dex-leaderboard": {
-      "key": "fetch-current-dex-leaderboard",
-      "label": "Fetch current dex leaderboard",
-      "description": "Fetch current dex leaderboard operations",
-      "category": "dex-analytics",
-      "methods": [
-        "fetchCurrentDexLeaderboard"
-      ],
-      "mcpTools": [
-        "gala_launchpad_fetch_current_dex_leaderboard"
-      ],
-      "explanation": "",
-      "samplePrompts": [
-        "How do I view current DEX leaderboard?",
-        "Show me how to view current DEX leaderboard with the SDK",
-        "Explain the view current DEX leaderboard workflow",
-        "What methods do I need for view current DEX leaderboard?"
-      ]
-    },
-    "fetch-dex-aggregated-volume-summary": {
-      "key": "fetch-dex-aggregated-volume-summary",
-      "label": "Fetch dex aggregated volume summary",
-      "description": "Fetch dex aggregated volume summary operations",
-      "category": "dex-analytics",
-      "methods": [
-        "fetchDexAggregatedVolumeSummary"
-      ],
-      "mcpTools": [
-        "gala_launchpad_fetch_dex_aggregated_volume_summary"
-      ],
-      "explanation": "\n## DEX Aggregated Volume Summary and Trends\n\n**Covers Methods:**\n- `fetchDexAggregatedVolumeSummary()`\n\nAnalyze DEX trading volume trends across different time periods.\n\n```typescript\nimport { createLaunchpadSDK } from '@gala-chain/launchpad-sdk';\n\nasync function analyzeVolumeTrends() {\n  const sdk = createLaunchpadSDK({ wallet: 'your-private-key' });\n\n  // Get volume summary with trend metrics\n  const summary = await sdk.fetchDexAggregatedVolumeSummary();\n\n  // Display volumes\n  console.log(`1-Day Volume: $${summary.volume1d.toLocaleString()}`);\n  console.log(`7-Day Volume: $${summary.volume7d.toLocaleString()}`);\n  console.log(`30-Day Volume: $${summary.volume30d.toLocaleString()}`);\n\n  // Analyze trends\n  const trend1d = summary.volume1dDelta > 0 ? '📈 UP' : '📉 DOWN';\n  const trend7d = summary.volume7dDelta > 0 ? '📈 UP' : '📉 DOWN';\n  const trend30d = summary.volume30dDelta > 0 ? '📈 UP' : '📉 DOWN';\n\n  console.log(`1-Day Trend: ${trend1d} (${toBigNumberFixed(summary.volume1dDelta * 100, 2)}%)`);\n  console.log(`7-Day Trend: ${trend7d} (${toBigNumberFixed(summary.volume7dDelta * 100, 2)}%)`);\n  console.log(`30-Day Trend: ${trend30d} (${toBigNumberFixed(summary.volume30dDelta * 100, 2)}%)`);\n\n  // Growth analysis\n  if (summary.volume30dDelta > 0.1) {\n    console.log('Strong growth - Platform adoption increasing');\n  } else if (summary.volume30dDelta < -0.1) {\n    console.log('Declining volume - Platform may be slowing');\n  }\n}\n```\n\n**MCP Tool Equivalent:** `gala_launchpad_fetch_dex_aggregated_volume_summary`\n",
-      "samplePrompts": [
-        "How do I analyze DEX volume metrics?",
-        "Show me how to analyze DEX volume metrics with the SDK",
-        "Explain the analyze DEX volume metrics workflow",
-        "What methods do I need for analyze DEX volume metrics?"
-      ]
-    },
-    "fetch-dex-pools": {
-      "key": "fetch-dex-pools",
-      "label": "Fetch dex pools",
-      "description": "Fetch dex pools operations",
-      "category": "dex-pools",
-      "methods": [
-        "fetchDexPools",
-        "fetchAllDexPools"
-      ],
-      "mcpTools": [
-        "gala_launchpad_fetch_dex_pools",
-        "gala_launchpad_fetch_all_dex_pools"
-      ],
-      "explanation": "\n## Fetch DEX Pools with Pagination\n\n**Covers Methods:**\n- `fetchDexPools()`\n- `fetchAllDexPools()`\n\nDiscover and query liquidity pools on GalaSwap with advanced filtering and pagination.\n\n```typescript\nimport { createLaunchpadSDK } from '@gala-chain/launchpad-sdk';\n\nasync function queryDexPools() {\n  const sdk = createLaunchpadSDK({ wallet: 'your-private-key' });\n\n  // Option 1: Fetch pools with pagination\n  const pools = await sdk.fetchDexPools({\n    search: 'GALA',\n    sortBy: 'tvl',      // Sort by: tvl, volume30d, volume1d\n    limit: 20,\n    page: 1\n  });\n\n  console.log(`Found ${pools.total} pools, page ${pools.page} of ${pools.totalPages}`);\n  pools.pools.forEach(pool => {\n    console.log(`${pool.tokenName}: TVL ${pool.tvl}, 24h Volume: ${pool.volume1d}`);\n  });\n\n  // Option 2: Fetch ALL pools automatically (handles pagination)\n  const allPools = await sdk.fetchAllDexPools({\n    sortBy: 'tvl'\n  });\n\n  console.log(`Total pools: ${allPools.pools.length}`);\n\n  // Analyze pool metrics\n  const avgTvl = allPools.pools.reduce((sum, p) => sum + safeParseFloat(p.tvl, 0), 0) / allPools.pools.length;\n  console.log(`Average TVL: $${toBigNumberFixed(avgTvl, 2)}`);\n}\n```\n\n**Key Features:**\n- **Sorting**: TVL (total value locked), volume30d (30-day volume), volume1d (24-hour volume)\n- **Pool Metrics**: Token prices, fee tiers, liquidity, 24h/30d volume, APR\n- **Auto-Pagination**: `fetchAllDexPools()` handles pagination automatically\n- **Search**: Filter by token name or pair\n\n**MCP Tool Equivalents:**\n- `gala_launchpad_fetch_dex_pools`\n- `gala_launchpad_fetch_all_dex_pools`\n",
-      "samplePrompts": [
-        "How do I fetch dex pools?",
-        "Show me how to fetch dex pools with the SDK",
-        "Explain the fetch dex pools workflow",
-        "What methods do I need for fetch dex pools?"
-      ]
-    },
-    "event-subscriptions": {
-      "key": "event-subscriptions",
-      "label": "Event subscriptions",
-      "description": "Event subscriptions operations",
-      "category": "chat",
-      "methods": [
-        "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"
-      ],
-      "mcpTools": [
-        "gala_launchpad_subscribe_to_stream",
-        "gala_launchpad_on_dex_pool_creation",
-        "gala_launchpad_on_launchpad_token_creation"
-      ],
-      "explanation": "\n## Real-Time Event Subscriptions and Monitoring\n\n**Covers Methods:**\n- `subscribeToDexLiquidityAdded()`\n- `subscribeToDexLiquidityChanged()`\n- `subscribeToDexLiquidityRemoved()`\n- `subscribeToDexPoolAdded()`\n- `subscribeToDexSwapExecuted()`\n- `subscribeToTokenCreations()`\n\nSubscribe to real-time WebSocket events for DEX trading, liquidity changes, and token launches.\n\n```typescript\nimport { createLaunchpadSDK, compareAmounts } from '@gala-chain/launchpad-sdk';\n\nasync function subscribeToEvents() {\n  const sdk = createLaunchpadSDK({ wallet: 'your-private-key' });\n\n  // ============================================================================\n  // LIQUIDITY EVENTS - Monitor position changes\n  // ============================================================================\n\n  // Subscribe to liquidity additions\n  const cleanupAdded = sdk.subscribeToDexLiquidityAdded((event) => {\n    console.log('Liquidity added!');\n    console.log(`  Pool: ${event.token0}-${event.token1}`);\n    console.log(`  Amount0: ${event.amount0}`);\n    console.log(`  Amount1: ${event.amount1}`);\n    console.log(`  Owner: ${event.owner}`);\n    console.log(`  Position ID: ${event.positionId}`);\n  });\n\n  // Subscribe to liquidity changes (compound events)\n  const cleanupChanged = sdk.subscribeToDexLiquidityChanged((event) => {\n    console.log('Liquidity changed!');\n    console.log(`  Type: ${event.type}`); // 'added', 'removed', 'modified'\n    console.log(`  Pool: ${event.token0}-${event.token1}`);\n    console.log(`  Delta: ${event.liquidityDelta}`);\n  });\n\n  // Subscribe to liquidity removals\n  const cleanupRemoved = sdk.subscribeToDexLiquidityRemoved((event) => {\n    console.log('Liquidity removed!');\n    console.log(`  Pool: ${event.token0}-${event.token1}`);\n    console.log(`  Amount0: ${event.amount0}`);\n    console.log(`  Amount1: ${event.amount1}`);\n    console.log(`  Owner: ${event.owner}`);\n    console.log(`  Fees collected: ${event.fees0}, ${event.fees1}`);\n  });\n\n  // ============================================================================\n  // POOL EVENTS - Monitor new DEX pools\n  // ============================================================================\n\n  // Subscribe to new DEX pool creation\n  const cleanupPool = sdk.subscribeToDexPoolAdded((pool) => {\n    console.log('New DEX pool created!');\n    console.log(`  Token: ${pool.tokenName}`);\n    console.log(`  Token0: ${pool.token0}`);\n    console.log(`  Token1: ${pool.token1}`);\n    console.log(`  Fee Tier: ${pool.feeTier}`);\n    console.log(`  Initial TVL: ${pool.tvl}`);\n\n    // Auto-provide liquidity to new pools\n    sdk.addSwapLiquidityByPrice({\n      token0: pool.token0,\n      token1: pool.token1,\n      fee: pool.feeTier,\n      minPrice: '0.95',\n      maxPrice: '1.05',\n      amount0Desired: '1000',\n      amount1Desired: '1000'\n    }).then(() => console.log('Liquidity provided to new pool'));\n  });\n\n  // ============================================================================\n  // SWAP EVENTS - Monitor all DEX swaps\n  // ============================================================================\n\n  // Subscribe to DEX swap executions\n  const cleanupSwap = sdk.subscribeToDexSwapExecuted((swap) => {\n    console.log('DEX swap executed!');\n    console.log(`  Pair: ${swap.tokenIn} → ${swap.tokenOut}`);\n    console.log(`  Amount In: ${swap.amountIn}`);\n    console.log(`  Amount Out: ${swap.amountOut}`);\n    console.log(`  Trader: ${swap.trader}`);\n    console.log(`  Fee Tier: ${swap.feeTier}`);\n\n    // Track volume and price impact\n    const priceImpact = calculatePriceImpact(swap.amountIn, swap.amountOut);\n    console.log(`  Price impact: ${priceImpact}%`);\n  });\n\n  // ============================================================================\n  // TOKEN CREATION EVENTS - Monitor new token launches\n  // ============================================================================\n\n  // Subscribe to new token launches\n  const cleanupToken = sdk.subscribeToTokenCreations((token) => {\n    console.log('New token launched!');\n    console.log(`  Name: ${token.tokenName}`);\n    console.log(`  Symbol: ${token.tokenSymbol}`);\n    console.log(`  Creator: ${token.creator}`);\n    console.log(`  Max Supply: ${token.maxSupply}`);\n    console.log(`  Base Price: ${token.basePrice}`);\n\n    // Auto-buy new tokens\n    sdk.buy({\n      tokenName: token.tokenName,\n      amount: '100',\n      type: 'native',\n      slippageToleranceFactor: 0.01\n    }).then(() => console.log('Auto-bought new token'));\n  });\n\n  // ============================================================================\n  // ARBITRAGE BOT EXAMPLE - Multi-event monitoring\n  // ============================================================================\n\n  async function arbitrageBot() {\n    const sdk = createLaunchpadSDK({ wallet: 'your-private-key' });\n\n    // Track all swaps for arbitrage opportunities\n    sdk.subscribeToDexSwapExecuted(async (swap) => {\n      // Check if price divergence exists\n      const poolPrice = await sdk.getSwapPoolPrice(swap.tokenIn, swap.tokenOut);\n      const externalPrice = await getExternalPrice(swap.tokenIn, swap.tokenOut);\n\n      const divergence = Math.abs(poolPrice - externalPrice) / externalPrice;\n\n      if (divergence > 0.01) {\n        // 1% arbitrage opportunity\n        console.log(`Arbitrage opportunity: ${divergence * 100}%`);\n\n        // Execute arbitrage trade\n        await sdk.executeSwap(\n          swap.tokenOut,\n          swap.tokenIn,\n          calculateArbitrageAmount(divergence),\n          '0', // min output\n          3000, // fee tier\n          0.01 // slippage\n        );\n      }\n    });\n\n    // Monitor liquidity additions for new opportunities\n    sdk.subscribeToDexLiquidityAdded(async (event) => {\n      console.log(`New liquidity in ${event.token0}-${event.token1}`);\n\n      // Check if pool has sufficient depth for arbitrage\n      const poolInfo = await sdk.getSwapPoolInfo(event.token0, event.token1);\n      // Use compareAmounts for precise liquidity threshold comparison\n      if (compareAmounts(poolInfo.liquidity, '100000') > 0) {\n        console.log('Pool has sufficient liquidity for arbitrage');\n      }\n    });\n  }\n\n  // ============================================================================\n  // LIQUIDITY PROVIDER BOT - Auto-manage positions\n  // ============================================================================\n\n  async function liquidityProviderBot() {\n    const sdk = createLaunchpadSDK({ wallet: 'your-private-key' });\n\n    // Auto-add liquidity to new pools\n    sdk.subscribeToDexPoolAdded(async (pool) => {\n      console.log(`New pool: ${pool.tokenName}`);\n\n      // Wait for some initial swaps to establish price\n      setTimeout(async () => {\n        const poolInfo = await sdk.getSwapPoolInfo(pool.token0, pool.token1);\n\n        // Add liquidity if TVL is high enough\n        // Use compareAmounts for precise liquidity threshold comparison\n        if (compareAmounts(poolInfo.liquidity, '50000') > 0) {\n          await sdk.addSwapLiquidityByPrice({\n            token0: pool.token0,\n            token1: pool.token1,\n            fee: pool.feeTier,\n            minPrice: '0.9',\n            maxPrice: '1.1',\n            amount0Desired: '10000',\n            amount1Desired: '10000'\n          });\n\n          console.log('Liquidity added to new pool');\n        }\n      }, 60000); // Wait 1 minute\n    });\n\n    // Monitor liquidity removals (potential exit signal)\n    sdk.subscribeToDexLiquidityRemoved((event) => {\n      console.log(`Large liquidity removal: ${event.amount0}, ${event.amount1}`);\n\n      // Check if we should also exit\n      if (isLargeRemoval(event)) {\n        console.log('Large removal detected - consider exiting position');\n      }\n    });\n  }\n\n  // Keep subscriptions running\n  console.log('Subscriptions active... Press Ctrl+C to stop');\n  await new Promise(() => {}); // Run forever\n\n  // Cleanup when done\n  cleanupAdded();\n  cleanupChanged();\n  cleanupRemoved();\n  cleanupPool();\n  cleanupSwap();\n  cleanupToken();\n}\n```\n\n**Event Data Structures:**\n\n**LiquidityAdded:**\n- token0, token1, feeTier\n- amount0, amount1\n- owner, positionId\n- timestamp\n\n**LiquidityRemoved:**\n- token0, token1, feeTier\n- amount0, amount1\n- fees0, fees1\n- owner, positionId\n- timestamp\n\n**DexPoolAdded:**\n- tokenName, token0, token1\n- feeTier, tvl\n- timestamp\n\n**SwapExecuted:**\n- tokenIn, tokenOut\n- amountIn, amountOut\n- trader, feeTier\n- priceImpact\n- timestamp\n\n**TokenCreation:**\n- tokenName, tokenSymbol\n- creator, maxSupply\n- basePrice\n- timestamp\n\n**Use Cases:**\n- **Arbitrage Bots**: Monitor swaps for price divergence\n- **Liquidity Management**: Auto-provide liquidity to new pools\n- **Early Bird Trading**: Buy new tokens immediately after launch\n- **Position Monitoring**: Track liquidity changes in your positions\n- **Market Analysis**: Analyze trading patterns and volumes\n\n### WebSocket Connection Lifecycle\n\n```typescript\n// Handle connection lifecycle events\nawait sdk.connectStreamWebSocket({\n  onConnect: () => {\n    console.log('WebSocket connected');\n  },\n  onDisconnect: (reason) => {\n    console.log('WebSocket disconnected:', reason);\n    // Implement reconnection logic if needed\n  },\n  onError: (error) => {\n    console.error('WebSocket error:', error);\n  }\n});\n\n// Check connection state\nif (sdk.isStreamWebSocketConnected()) {\n  console.log('Ready to send/receive messages');\n}\n```\n\n### Typing Indicators\n\n```typescript\n// Subscribe to typing indicators in chat\nawait sdk.connectStreamWebSocket({\n  onTypingIndicator: (event) => {\n    if (event.isTyping) {\n      console.log(`${event.userAddress} is typing...`);\n    } else {\n      console.log(`${event.userAddress} stopped typing`);\n    }\n  }\n});\n\n// Send typing start indicator\nawait sdk.sendTypingStart({\n  tokenName: 'anime'\n});\n\n// Later: Send typing stop indicator\nawait sdk.sendTypingStop({\n  tokenName: 'anime'\n});\n```\n\n**MCP Tool Equivalents:**\n- `gala_launchpad_subscribe_to_dex_liquidity_added`\n- `gala_launchpad_subscribe_to_dex_liquidity_changed`\n- `gala_launchpad_subscribe_to_dex_liquidity_removed`\n- `gala_launchpad_subscribe_to_dex_pool_added`\n- `gala_launchpad_subscribe_to_dex_swap_executed`\n- `gala_launchpad_subscribe_to_token_creations`\n",
-      "samplePrompts": [
-        "How do I subscribe to real-time events?",
-        "Show me how to subscribe to real-time events with the SDK",
-        "Explain the subscribe to real-time events workflow",
-        "What methods do I need for subscribe to real-time events?"
-      ]
-    },
-    "mcp-to-sdk-mapping": {
-      "key": "mcp-to-sdk-mapping",
-      "label": "Mcp to sdk mapping",
-      "description": "Mcp to sdk mapping operations",
-      "category": "utils",
-      "methods": [],
-      "mcpTools": [],
-      "explanation": "\n## MCP Tool to SDK Method Mapping Guide\n\n**Covers Concepts:**\n- Understanding MCP tool architecture\n- Mapping between MCP tools and SDK methods\n- When to use MCP vs direct SDK\n\nThis is a conceptual guide showing how MCP (Model Context Protocol) tools map to SDK methods.\n\n### Architecture Overview\n\n```\n┌─────────────────────────────────────────────────────────────┐\n│                     MCP Server Layer                         │\n│  (241 tools - user-friendly wrappers with validation)       │\n└─────────────────────────────────────────────────────────────┘\n                            │\n                            ▼\n┌─────────────────────────────────────────────────────────────┐\n│                    LaunchpadSDK Layer                        │\n│   (217 methods - low-level programmatic access)             │\n└─────────────────────────────────────────────────────────────┘\n                            │\n                            ▼\n┌─────────────────────────────────────────────────────────────┐\n│               Gala Launchpad Backend APIs                    │\n│  (REST endpoints, WebSocket events, GalaChain)              │\n└─────────────────────────────────────────────────────────────┘\n```\n\n### MCP vs SDK Decision Matrix\n\n| Scenario | Use MCP | Use SDK |\n|----------|---------|---------|\n| **AI Agent Development** | ✅ Yes | ❌ No |\n| **Claude Desktop Integration** | ✅ Yes | ❌ No |\n| **LLM-Driven Trading Bots** | ✅ Yes | ❌ No |\n| **TypeScript Application** | ❌ No | ✅ Yes |\n| **Node.js Backend Service** | ❌ No | ✅ Yes |\n| **React/Vue Frontend** | ❌ No | ✅ Yes |\n| **Python Application** | ❌ No (SDK only) | ❌ No (not yet) |\n\n### Tool Naming Conventions\n\n**MCP Tool Pattern:** `gala_launchpad_{action}_{resource}`\n**SDK Method Pattern:** `{action}{Resource}`\n\nExamples:\n- MCP: `gala_launchpad_fetch_pools` → SDK: `fetchPools()`\n- MCP: `gala_launchpad_buy_tokens` → SDK: `buy()`\n- MCP: `gala_launchpad_get_swap_quote_exact_input` → SDK: `getSwapQuoteExactInput()`\n\n### Common Mapping Patterns\n\n**1. Direct 1:1 Mapping (Most Common):**\n\n```typescript\n// MCP Tool: gala_launchpad_fetch_pools\n// SDK Method: fetchPools()\n\n// MCP Usage (AI agent)\nconst result = await tools.gala_launchpad_fetch_pools({\n  type: 'recent',\n  limit: 10\n});\n\n// SDK Usage (TypeScript app)\nconst sdk = createLaunchpadSDK({ wallet: 'private-key' });\nconst result = await sdk.fetchPools({ type: 'recent', limit: 10 });\n```\n\n**2. Composite Tool → Multiple SDK Methods:**\n\n```typescript\n// MCP Tool: gala_launchpad_buy_tokens_with_calculation\n// Calls TWO SDK methods internally:\n\n// 1. Calculate quote\nconst quote = await sdk.calculateBuyAmount({\n  tokenName: 'anime',\n  amount: '100',\n  type: 'native'\n});\n\n// 2. Execute trade\nconst result = await sdk.buy({\n  tokenName: 'anime',\n  amount: '100',\n  type: 'native',\n  expectedAmount: quote.amount,\n  slippageToleranceFactor: 0.01\n});\n```\n\n**3. SDK Method → No MCP Tool (Advanced Features):**\n\nSome SDK methods don't have MCP equivalents:\n- `setWallet()` - Runtime wallet changes\n- `getConfig()` - SDK configuration access\n- `warmCacheFromPoolData()` - Cache optimization\n\n**4. MCP Tool → No Direct SDK Method (Abstractions):**\n\nSome MCP tools provide abstractions:\n- `gala_launchpad_portfolio` - Aggregates multiple SDK calls\n- `gala_launchpad_analyze_token` - Composite analysis workflow\n\n### Complete Mapping Reference\n\n**Trading (13 MCP tools → 9 SDK methods):**\n\n| MCP Tool | SDK Method |\n|----------|-----------|\n| `gala_launchpad_buy_tokens` | `buy()` |\n| `gala_launchpad_sell_tokens` | `sell()` |\n| `gala_launchpad_calculate_buy_amount` | `calculateBuyAmount()` |\n| `gala_launchpad_calculate_sell_amount` | `calculateSellAmount()` |\n| `gala_launchpad_graduate_token` | `graduateToken()` |\n| `gala_launchpad_calculate_buy_amount_local` | `calculateBuyAmountLocal()` |\n| `gala_launchpad_calculate_sell_amount_local` | `calculateSellAmountLocal()` |\n| `gala_launchpad_calculate_buy_amount_external` | `calculateBuyAmountExternal()` |\n| `gala_launchpad_calculate_sell_amount_external` | `calculateSellAmountExternal()` |\n\n**DEX Trading (6 MCP tools → 6 SDK methods):**\n\n| MCP Tool | SDK Method |\n|----------|-----------|\n| `gala_launchpad_get_swap_quote_exact_input` | `getSwapQuoteExactInput()` |\n| `gala_launchpad_get_swap_quote_exact_output` | `getSwapQuoteExactOutput()` |\n| `gala_launchpad_execute_swap` | `executeSwap()` |\n| `gala_launchpad_get_swap_user_assets` | `getSwapUserAssets()` |\n| `gala_launchpad_get_all_swap_user_assets` | `getAllSwapUserAssets()` |\n| `gala_launchpad_get_swap_pool_info` | `getSwapPoolInfo()` |\n\n**Liquidity Management (8 MCP tools → 9 SDK methods):**\n\n| MCP Tool | SDK Method |\n|----------|-----------|\n| `gala_launchpad_get_user_liquidity_positions` | `getSwapUserLiquidityPositions()` |\n| `gala_launchpad_get_all_user_liquidity_positions` | `getAllSwapUserLiquidityPositions()` |\n| `gala_launchpad_get_liquidity_position_by_id` | `getSwapLiquidityPositionById()` |\n| `gala_launchpad_add_liquidity_by_price` | `addSwapLiquidityByPrice()` |\n| `gala_launchpad_add_liquidity_by_ticks` | `addSwapLiquidityByTicks()` |\n| `gala_launchpad_estimate_remove_liquidity` | `getSwapEstimateRemoveLiquidity()` |\n| `gala_launchpad_remove_liquidity` | `removeSwapLiquidity()` |\n| `gala_launchpad_collect_position_fees` | `collectSwapPositionFees()` |\n\n### When to Use Each\n\n**Use MCP Tools When:**\n- Building AI agents (Claude, GPT, etc.)\n- Need LLM-friendly error messages\n- Want automatic parameter validation\n- Working in Claude Desktop environment\n- Need slash command shortcuts\n\n**Use SDK Directly When:**\n- Building TypeScript/JavaScript applications\n- Need maximum performance\n- Want full TypeScript type safety\n- Building React/Vue components\n- Need fine-grained control\n\n### Migration Example\n\n**From MCP to SDK:**\n\n```typescript\n// AI Agent using MCP\nasync function mcpExample() {\n  const result = await tools.gala_launchpad_buy_tokens({\n    tokenName: 'anime',\n    amount: '100',\n    type: 'native',\n    slippageToleranceFactor: 0.01\n  });\n  return result;\n}\n\n// TypeScript App using SDK\nimport { createLaunchpadSDK } from '@gala-chain/launchpad-sdk';\n\nasync function sdkExample() {\n  const sdk = createLaunchpadSDK({ wallet: 'private-key' });\n\n  // Step 1: Calculate quote\n  const quote = await sdk.calculateBuyAmount({\n    tokenName: 'anime',\n    amount: '100',\n    type: 'native'\n  });\n\n  // Step 2: Execute trade\n  const result = await sdk.buy({\n    tokenName: 'anime',\n    amount: '100',\n    type: 'native',\n    expectedAmount: quote.amount,\n    slippageToleranceFactor: 0.01\n  });\n\n  return result;\n}\n```\n\n**Key Differences:**\n1. MCP combines calculation + execution (safer for AI)\n2. SDK exposes individual steps (more control)\n3. MCP validates all inputs via Zod schemas\n4. SDK provides TypeScript type safety\n\n### Resources\n\n- **SDK Documentation**: packages/sdk/README.md\n- **MCP Documentation**: packages/mcp-server/README.md\n- **API Reference**: docs/API-REFERENCE.md\n- **Tool Registry**: packages/mcp-server/src/tools/registry.ts\n",
-      "samplePrompts": [
-        "How do I map MCP tools to SDK methods?",
-        "Show me how to map MCP tools to SDK methods with the SDK",
-        "Explain the map MCP tools to SDK methods workflow",
-        "What methods do I need for map MCP tools to SDK methods?"
-      ]
-    },
-    "bridge-operations": {
-      "key": "bridge-operations",
-      "label": "Bridge operations",
-      "description": "Bridge operations operations",
-      "category": "bridge",
-      "methods": [
-        "estimateBridgeFee",
-        "bridgeOut",
-        "bridgeIn",
-        "getBridgeStatus",
-        "fetchEthereumWalletTokenBalance",
-        "fetchEthereumWalletNativeBalance",
-        "fetchEthereumWalletAllBalances",
-        "fetchSolanaWalletTokenBalance",
-        "fetchSolanaWalletNativeBalance",
-        "fetchSolanaWalletAllBalances",
-        "getSupportedBridgeTokens",
-        "getEthereumTransactionStatus",
-        "getSolanaTransactionStatus",
-        "fetchBridgeableTokensByNetwork",
-        "fetchAllBridgeableTokensByNetwork",
-        "fetchAllTokensBridgeableToEthereum",
-        "fetchAllTokensBridgeableToSolana",
-        "isTokenBridgeableToNetwork",
-        "isTokenBridgeableToEthereum",
-        "isTokenBridgeableToSolana",
-        "requestSolanaDevnetAirdrop"
-      ],
-      "mcpTools": [
-        "gala_launchpad_estimate_bridge_fee",
-        "gala_launchpad_bridge_out",
-        "gala_launchpad_bridge_in",
-        "gala_launchpad_get_bridge_status",
-        "gala_launchpad_fetch_ethereum_wallet_token_balance",
-        "gala_launchpad_fetch_ethereum_wallet_native_balance",
-        "gala_launchpad_fetch_ethereum_wallet_all_balances",
-        "gala_launchpad_fetch_solana_wallet_token_balance",
-        "gala_launchpad_fetch_solana_wallet_native_balance",
-        "gala_launchpad_fetch_solana_wallet_all_balances",
-        "gala_launchpad_get_supported_bridge_tokens",
-        "gala_launchpad_get_ethereum_transaction_status",
-        "gala_launchpad_get_solana_transaction_status",
-        "gala_launchpad_fetch_bridgeable_tokens_by_network",
-        "gala_launchpad_fetch_all_bridgeable_tokens_by_network",
-        "gala_launchpad_fetch_all_tokens_bridgeable_to_ethereum",
-        "gala_launchpad_fetch_all_tokens_bridgeable_to_solana",
-        "gala_launchpad_is_token_bridgeable_to_network",
-        "gala_launchpad_is_token_bridgeable_to_ethereum",
-        "gala_launchpad_is_token_bridgeable_to_solana",
-        "gala_launchpad_request_solana_devnet_airdrop"
-      ],
-      "explanation": "\n## Cross-Chain Bridge Operations with SDK\n\n**Covers Methods:**\n- `estimateBridgeFee()`\n- `bridgeOut()`\n- `bridgeIn()`\n- `getBridgeStatus()`\n- `getSupportedBridgeTokens()`\n- `getEthereumTransactionStatus()`\n- `getSolanaTransactionStatus()`\n- `fetchEthereumWalletTokenBalance()` / `fetchSolanaWalletTokenBalance()`\n- `fetchEthereumWalletNativeBalance()` / `fetchSolanaWalletNativeBalance()`\n- `fetchEthereumWalletAllBalances()` / `fetchSolanaWalletAllBalances()`\n- `fetchBridgeableTokensByNetwork()` / `fetchAllBridgeableTokensByNetwork()`\n- `fetchAllTokensBridgeableToEthereum()` / `fetchAllTokensBridgeableToSolana()`\n- `isTokenBridgeableToNetwork()` / `isTokenBridgeableToEthereum()` / `isTokenBridgeableToSolana()`\n- `requestSolanaDevnetAirdrop()`\n\n```typescript\nimport { createLaunchpadSDK } from '@gala-chain/launchpad-sdk';\n\nasync function bridgeOperations() {\n  // 1. Create SDK with wallet configuration\n  const sdk = createLaunchpadSDK({\n    privateKey: '0xabcd...',\n    environment: 'production',  // or 'staging' for testnet\n  });\n\n  // 2. Get supported bridge tokens\n  const supportedTokens = await sdk.getSupportedBridgeTokens('Ethereum');\n  console.log('Bridgeable to Ethereum:', supportedTokens.map(t => t.symbol));\n\n  // 3. Check if specific token is bridgeable\n  const canBridge = await sdk.isTokenBridgeableToEthereum('GALA');\n  console.log('GALA bridgeable to Ethereum:', canBridge.bridgeable);\n\n  // 4. Estimate bridge fee (calculated externally by GalaConnect API)\n  const fee = await sdk.estimateBridgeFee({\n    tokenId: 'GALA|Unit|none|none',\n    destinationChain: 'Ethereum',\n    amount: '100',\n  });\n  console.log('Bridge fee:', fee.totalFee, 'GALA');\n\n  // 5. Bridge Out: GalaChain → Ethereum\n  const bridgeOutTx = await sdk.bridgeOut({\n    tokenId: 'GALA|Unit|none|none',\n    amount: '100',\n    destinationChain: 'Ethereum',\n    recipientAddress: '0x5678...',\n  });\n  console.log('Bridge out TX:', bridgeOutTx.transactionHash);\n\n  // 6. Get bridge status\n  const status = await sdk.getBridgeStatus(bridgeOutTx.transactionHash);\n  console.log('Bridge status:', status.status);\n\n  // 7. Get Ethereum transaction status\n  const ethTxStatus = await sdk.getEthereumTransactionStatus(bridgeOutTx.transactionHash);\n  console.log('ETH TX confirmed:', ethTxStatus.confirmed);\n\n  // 8. Query external chain balances\n  const ethBalance = await sdk.fetchEthereumWalletNativeBalance();\n  const galaEthBalance = await sdk.fetchEthereumWalletTokenBalance('GALA');\n  const allEthBalances = await sdk.fetchEthereumWalletAllBalances();\n\n  // 9. Discover all bridgeable tokens\n  const allBridgeable = await sdk.fetchAllBridgeableTokensByNetwork('ETHEREUM');\n  console.log('All tokens bridgeable to Ethereum:', allBridgeable.length);\n}\n```\n\n**Supported Tokens:**\n- **Ethereum:** GALA, GWETH, GUSDC, GUSDT, GWTRX, GWBTC\n- **Solana:** GALA, GSOL\n\n**Environment Configuration:**\n- `PROD`: Ethereum Mainnet, Solana Mainnet\n- `STAGE`: Ethereum Sepolia, Solana Devnet\n\n**MCP Tool Equivalents:**\n- `gala_launchpad_bridge_estimate_fee`\n- `gala_launchpad_bridge_out`\n- `gala_launchpad_bridge_in`\n- `gala_launchpad_bridge_status`\n- `gala_launchpad_bridge_ethereum_balance`\n- `gala_launchpad_bridge_ethereum_all_balances`\n- `gala_launchpad_bridge_solana_balance`\n- `gala_launchpad_bridge_solana_all_balances`\n",
-      "samplePrompts": [
-        "How do I bridge tokens across chains?",
-        "Show me how to bridge tokens across chains with the SDK",
-        "Explain the bridge tokens across chains workflow",
-        "What methods do I need for bridge tokens across chains?"
-      ]
-    },
-    "dex-token-discovery": {
-      "key": "dex-token-discovery",
-      "label": "Dex token discovery",
-      "description": "Dex token discovery operations",
-      "category": "dex-pools",
-      "methods": [
-        "fetchAvailableDexTokens",
-        "fetchAllAvailableDexTokens"
-      ],
-      "mcpTools": [
-        "gala_launchpad_fetch_available_dex_tokens",
-        "gala_launchpad_fetch_all_available_dex_tokens"
-      ],
-      "explanation": "\n## DEX Token Discovery with SDK\n\n**Covers Methods:**\n- `fetchAvailableDexTokens()`\n- `fetchAllAvailableDexTokens()`\n\nDiscover all tokens available for trading on GalaSwap DEX with rich metadata.\n\n```typescript\nimport { createLaunchpadSDK } from '@gala-chain/launchpad-sdk';\n\nasync function discoverDexTokens() {\n  const sdk = createLaunchpadSDK({ wallet: 'your-private-key' });\n\n  // Option 1: Paginated token discovery\n  const tokens = await sdk.fetchAvailableDexTokens({\n    search: 'GALA',  // Optional search filter\n    page: 1,\n    limit: 20\n  });\n\n  console.log(`Found ${tokens.total} tokens, page ${tokens.page} of ${tokens.totalPages}`);\n  tokens.items.forEach(token => {\n    console.log(`${token.symbol}: ${token.name} (decimals: ${token.decimals})`);\n  });\n\n  // Option 2: Fetch ALL tokens (auto-pagination)\n  const allTokens = await sdk.fetchAllAvailableDexTokens();\n  console.log(`Total DEX tokens: ${allTokens.length}`);\n\n  // Option 3: Search for specific tokens\n  const searchResults = await sdk.fetchAllAvailableDexTokens({ search: 'USD' });\n  console.log('USD-related tokens:', searchResults.map(t => t.symbol));\n}\n```\n\n**Token Metadata Includes:**\n- Symbol and full name\n- Decimal precision\n- Token class key (collection, category, type, additionalKey)\n- Verification status\n- Trading availability\n\n**MCP Tool Equivalents:**\n- `gala_launchpad_fetch_available_dex_tokens`\n- `gala_launchpad_fetch_all_available_dex_tokens`\n",
-      "samplePrompts": [
-        "How do I discover tokens on DEX?",
-        "Show me how to discover tokens on DEX with the SDK",
-        "Explain the discover tokens on DEX workflow",
-        "What methods do I need for discover tokens on DEX?"
-      ]
-    },
-    "wrap-unwrap-operations": {
-      "key": "wrap-unwrap-operations",
-      "label": "Wrap unwrap operations",
-      "description": "Wrap unwrap operations operations",
-      "category": "bridge",
-      "methods": [
-        "wrapToken",
-        "unwrapToken",
-        "estimateWrapFee",
-        "estimateUnwrapFee",
-        "getWrapStatus",
-        "fetchWrappableTokens",
-        "fetchAllWrappableTokens",
-        "getWrappableToken",
-        "getWrapCounterpart",
-        "isTokenWrappable"
-      ],
-      "mcpTools": [
-        "gala_launchpad_wrap_token",
-        "gala_launchpad_unwrap_token",
-        "gala_launchpad_estimate_wrap_fee",
-        "gala_launchpad_estimate_unwrap_fee",
-        "gala_launchpad_get_wrap_status",
-        "gala_launchpad_fetch_wrappable_tokens",
-        "gala_launchpad_fetch_all_wrappable_tokens",
-        "gala_launchpad_get_wrappable_token",
-        "gala_launchpad_get_wrap_counterpart",
-        "gala_launchpad_is_token_wrappable"
-      ],
-      "explanation": "\n# Wrap/Unwrap Operations (Cross-Channel GalaChain Bridge)\n\nThe SDK provides methods for wrapping and unwrapping tokens between GalaChain channels.\nThis is an **internal GalaChain cross-channel bridge**, NOT external bridging to Ethereum/Solana.\n\n**Key Concept:**\n- **Wrap**: Move token from native channel → asset channel (e.g., MUSIC → GMUSIC)\n- **Unwrap**: Move token from asset channel → native channel (e.g., GMUSIC → MUSIC)\n\n## Wrap Token\n\n```typescript\nimport { createLaunchpadSDK } from '@gala-chain/launchpad-sdk';\n\nasync function wrapToken() {\n  const sdk = createLaunchpadSDK({ wallet: 'your-private-key' });\n\n  // Wrap MUSIC to GMUSIC (music channel → asset channel)\n  const result = await sdk.wrapToken({\n    tokenId: 'MUSIC',  // or '$MUSIC|Unit|none|none'\n    amount: '100',\n    recipient: '0x...',  // Optional, defaults to sender\n    memo: 'Wrapping for DEX trading'  // Optional\n  });\n\n  console.log('Wrap transaction:', result.transactionId);\n}\n```\n\n## Unwrap Token\n\n```typescript\nasync function unwrapToken() {\n  const sdk = createLaunchpadSDK({ wallet: 'your-private-key' });\n\n  // Unwrap GMUSIC back to MUSIC (asset channel → music channel)\n  const result = await sdk.unwrapToken({\n    tokenId: 'GMUSIC',  // or '$GMUSIC|Unit|none|none'\n    amount: '50',\n    recipient: '0x...',  // Optional\n    memo: 'Unwrapping after trading'  // Optional\n  });\n\n  console.log('Unwrap transaction:', result.transactionId);\n}\n```\n\n## Fee Estimation\n\n```typescript\nasync function estimateFees() {\n  const sdk = createLaunchpadSDK({ wallet: 'your-private-key' });\n\n  // Estimate wrap fee (uses cross_channel_authorization)\n  const wrapFee = await sdk.estimateWrapFee('MUSIC', '100');\n  console.log('Wrap fee:', wrapFee);\n\n  // Estimate unwrap fee (uses automatic authorization)\n  const unwrapFee = await sdk.estimateUnwrapFee('GMUSIC', '100');\n  console.log('Unwrap fee:', unwrapFee);\n}\n```\n\n## Transaction Status\n\n```typescript\nasync function checkStatus() {\n  const sdk = createLaunchpadSDK({ wallet: 'your-private-key' });\n\n  const status = await sdk.getWrapStatus('transaction-id-here');\n  console.log('Status:', status.status);  // pending, processing, completed, failed\n}\n```\n\n## Wrappable Token Discovery\n\n```typescript\nasync function discoverWrappableTokens() {\n  const sdk = createLaunchpadSDK({ wallet: 'your-private-key' });\n\n  // Paginated fetch\n  const tokens = await sdk.fetchWrappableTokens({ limit: 100 });\n\n  // Auto-paginated (all tokens)\n  const allTokens = await sdk.fetchAllWrappableTokens();\n\n  // Get specific wrappable token\n  const token = await sdk.getWrappableToken('$MUSIC|Unit|none|none');\n\n  // Get wrap counterpart (MUSIC → GMUSIC or vice versa)\n  const counterpart = await sdk.getWrapCounterpart('$MUSIC|Unit|none|none');\n\n  // Check if token is wrappable\n  const isWrappable = await sdk.isTokenWrappable('$MUSIC|Unit|none|none');\n  console.log('Is wrappable:', isWrappable.isWrappable);\n}\n```\n\n**MCP Tool Equivalents:**\n- `gala_launchpad_wrap_token`\n- `gala_launchpad_unwrap_token`\n- `gala_launchpad_estimate_wrap_fee`\n- `gala_launchpad_estimate_unwrap_fee`\n- `gala_launchpad_get_wrap_status`\n- `gala_launchpad_fetch_wrappable_tokens`\n- `gala_launchpad_fetch_all_wrappable_tokens`\n- `gala_launchpad_get_wrappable_token`\n- `gala_launchpad_get_wrap_counterpart`\n- `gala_launchpad_is_token_wrappable`\n",
-      "samplePrompts": [
-        "How do I wrap and unwrap tokens?",
-        "Show me how to wrap and unwrap tokens with the SDK",
-        "Explain the wrap and unwrap tokens workflow",
-        "What methods do I need for wrap and unwrap tokens?"
-      ]
-    },
-    "referral-system": {
-      "key": "referral-system",
-      "label": "Referral system",
-      "description": "Referral system operations",
-      "category": "referrals",
-      "methods": [
-        "fetchReferralUrl",
-        "fetchReferrals",
-        "fetchAllReferrals",
-        "fetchReferralsSummary"
-      ],
-      "mcpTools": [
-        "gala_launchpad_fetch_referral_url",
-        "gala_launchpad_fetch_referrals",
-        "gala_launchpad_fetch_all_referrals",
-        "gala_launchpad_fetch_referrals_summary"
-      ],
-      "explanation": "\n# Referral System\n\nThe SDK provides methods for managing referral URLs and tracking referral activity.\n\n## Get Your Referral URL\n\n```typescript\nimport { createLaunchpadSDK } from '@gala-chain/launchpad-sdk';\n\nasync function getReferralUrl() {\n  const sdk = createLaunchpadSDK({ wallet: 'your-private-key' });\n\n  // Get your unique referral URL\n  const result = await sdk.fetchReferralUrl();\n  console.log('Share this URL:', result.referralUrl);\n}\n```\n\n## Fetch Referrals (Paginated)\n\n```typescript\nasync function fetchReferrals() {\n  const sdk = createLaunchpadSDK({ wallet: 'your-private-key' });\n\n  // Paginated referral list\n  const referrals = await sdk.fetchReferrals({\n    address: '0x...',  // Optional, defaults to SDK wallet\n    page: 1,\n    limit: 20\n  });\n\n  console.log('Total referrals:', referrals.total);\n  referrals.items.forEach(ref => {\n    console.log(`Referred: ${ref.referredAddress} on ${ref.createdAt}`);\n  });\n}\n```\n\n## Fetch All Referrals (Auto-Paginated)\n\n```typescript\nasync function fetchAllReferrals() {\n  const sdk = createLaunchpadSDK({ wallet: 'your-private-key' });\n\n  // Get ALL referrals with auto-pagination\n  const allReferrals = await sdk.fetchAllReferrals({ address: '0x...' });\n  console.log('Total referrals:', allReferrals.length);\n}\n```\n\n## Referral Summary\n\n```typescript\nasync function getReferralSummary() {\n  const sdk = createLaunchpadSDK({ wallet: 'your-private-key' });\n\n  const summary = await sdk.fetchReferralsSummary({ address: '0x...' });\n  console.log('Total referred users:', summary.totalReferrals);\n  console.log('Total rewards earned:', summary.totalRewards);\n}\n```\n\n**MCP Tool Equivalents:**\n- `gala_launchpad_fetch_referral_url`\n- `gala_launchpad_fetch_referrals`\n- `gala_launchpad_fetch_all_referrals`\n- `gala_launchpad_fetch_referrals_summary`\n",
-      "samplePrompts": [
-        "How do I manage referral rewards?",
-        "Show me how to manage referral rewards with the SDK",
-        "Explain the manage referral rewards workflow",
-        "What methods do I need for manage referral rewards?"
-      ]
-    },
-    "account-management": {
-      "key": "account-management",
-      "label": "Account management",
-      "description": "Account management operations",
-      "category": "balance",
-      "methods": [
-        "registerAccount"
-      ],
-      "mcpTools": [
-        "gala_launchpad_register_account"
-      ],
-      "explanation": "\n# Account Management\n\nThe SDK provides methods for account registration and management.\n\n## Register Account\n\nRegister an account for trading on Gala. This should be called before the first purchase\nto ensure the wallet is ready for trading operations.\n\n```typescript\nimport { createLaunchpadSDK } from '@gala-chain/launchpad-sdk';\n\nasync function registerAccount() {\n  const sdk = createLaunchpadSDK({ wallet: 'your-private-key' });\n\n  // Register the SDK wallet\n  const result = await sdk.registerAccount();\n  console.log('Account exists:', result.exists);\n  console.log('Wallet alias:', result.walletAlias);\n\n  // Register a specific address\n  const otherResult = await sdk.registerAccount({\n    address: '0x1234...'  // Supports eth|, 0x, or client| formats\n  });\n  console.log('Other account exists:', otherResult.exists);\n}\n```\n\n**Response Structure:**\n```typescript\ninterface RegisterAccountResult {\n  exists: boolean;       // Whether account is registered\n  walletAlias: string;   // Normalized wallet alias (client|...)\n}\n```\n\n**MCP Tool Equivalents:**\n- `gala_launchpad_register_account`\n",
-      "samplePrompts": [
-        "How do I manage your account?",
-        "Show me how to manage your account with the SDK",
-        "Explain the manage your account workflow",
-        "What methods do I need for manage your account?"
-      ]
-    },
-    "session-auth": {
-      "key": "session-auth",
-      "label": "Session auth",
-      "description": "Session auth operations",
-      "category": "auth",
-      "methods": [
-        "login",
-        "logout",
-        "refreshToken",
-        "getSession",
-        "isAuthenticated",
-        "shouldRefreshToken",
-        "getAccessToken",
-        "ensureValidToken"
-      ],
-      "mcpTools": [
-        "gala_launchpad_login",
-        "gala_launchpad_logout",
-        "gala_launchpad_refresh_token",
-        "gala_launchpad_get_session",
-        "gala_launchpad_is_authenticated",
-        "gala_launchpad_should_refresh_token",
-        "gala_launchpad_get_access_token",
-        "gala_launchpad_ensure_valid_token"
-      ],
-      "explanation": "\n# Session Authentication (JWT) - SDK v5.1.0+\n\nJWT-based session authentication for protected operations (streaming, chat, profile updates).\n\n## Authentication Flow\n\n```typescript\nimport { createLaunchpadSDK } from '@gala-chain/launchpad-sdk';\n\nconst sdk = createLaunchpadSDK({\n  privateKey: process.env.PRIVATE_KEY,\n  environment: 'production',\n});\n\n// 1. Login to get JWT token\nconst session = await sdk.login();\nconsole.log('Authenticated:', session.address);\nconsole.log('Token expires in:', session.expiresIn, 'seconds');\n\n// 2. Check authentication status\nif (sdk.isAuthenticated()) {\n  console.log('Session is valid');\n}\n\n// 3. Get current session info\nconst info = await sdk.getSession();\nconsole.log('Session issued at:', info.issuedAt);\nconsole.log('Session expires at:', info.expiresAt);\n\n// 4. Access token directly (for custom requests)\nconst token = sdk.getAccessToken();\nconsole.log('JWT token:', token);\n\n// 5. Refresh token before expiry\nif (sdk.shouldRefreshToken()) {\n  const refreshed = await sdk.refreshToken();\n  console.log('Token refreshed, new expiry:', refreshed.expiresIn);\n}\n\n// 6. Ensure valid token (auto-refreshes if needed)\nconst validToken = await sdk.ensureValidToken();\nconsole.log('Valid token obtained');\n\n// 7. Logout when done\nsdk.logout();\nconsole.log('Logged out');\n```\n\n## Auto-Refresh Behavior\n\nThe SDK automatically refreshes tokens when:\n- Token expires within 5 minutes (default threshold)\n- Making requests to JWT-protected endpoints\n\n```typescript\n// Manual refresh threshold check\nconst shouldRefresh = sdk.shouldRefreshToken(10 * 60 * 1000); // 10 min threshold\n\n// ensureValidToken auto-refreshes if needed\nconst token = await sdk.ensureValidToken(5 * 60 * 1000); // 5 min threshold\n```\n\n## Protected Endpoints\n\nThese operations require JWT authentication (call \\`login()\\` first):\n\n**Streaming:**\n- \\`startStream()\\` - Start live stream\n- \\`resetStreamKey()\\` - Reset RTMP key\n- \\`getRecordingDownload()\\` - Download recordings\n- \\`deleteRecording()\\` - Delete recordings\n- \\`addSimulcastTarget()\\` - Add simulcast\n- \\`removeSimulcastTarget()\\` - Remove simulcast\n\n**Chat:**\n- \\`sendChatMessage()\\` - Send chat messages\n\n**Profile:**\n- \\`updateProfile()\\` - Update user profile\n\n**Uploads:**\n- \\`uploadTokenImage()\\` - Upload token images\n- \\`uploadProfileImage()\\` - Upload profile images\n\n## Error Handling\n\n```typescript\ntry {\n  await sdk.login();\n} catch (error) {\n  if (error.message.includes('signature')) {\n    console.error('Wallet signature failed');\n  } else if (error.message.includes('network')) {\n    console.error('Network error during login');\n  }\n}\n\n// Check auth before protected operations\nif (!sdk.isAuthenticated()) {\n  await sdk.login();\n}\n\ntry {\n  await sdk.startStream('mytoken');\n} catch (error) {\n  if (error.message.includes('JWT') || error.message.includes('token')) {\n    // Re-authenticate and retry\n    await sdk.login();\n    await sdk.startStream('mytoken');\n  }\n}\n```\n\n## Session Methods Reference\n\n| Method | Description | Returns |\n|--------|-------------|---------|\n| \\`login()\\` | Authenticate with wallet signature | \\`{ accessToken, expiresIn, address }\\` |\n| \\`logout()\\` | Clear JWT token (client-side) | \\`void\\` |\n| \\`refreshToken()\\` | Get new JWT token | \\`{ accessToken, expiresIn, address }\\` |\n| \\`getSession()\\` | Get session info | \\`{ address, issuedAt, expiresAt }\\` |\n| \\`isAuthenticated()\\` | Check if token exists and valid | \\`boolean\\` |\n| \\`shouldRefreshToken(threshold?)\\` | Check if refresh needed | \\`boolean\\` |\n| \\`getAccessToken()\\` | Get raw JWT token | \\`string | null\\` |\n| \\`ensureValidToken(threshold?)\\` | Auto-refresh if needed | \\`Promise<string>\\` |\n\n## Dev Bypass (STAGE Only)\n\nFor testing in STAGE environment without JWT:\n\n```typescript\nconst sdk = createLaunchpadSDK({\n  privateKey: process.env.PRIVATE_KEY,\n  environment: 'development',\n  devBypass: true, // Skip JWT auth in STAGE\n});\n\n// Protected methods work without login() in STAGE\nawait sdk.startStream('testtoken');\n```\n\n**Note:** Dev bypass only works in STAGE/development environments.\n",
-      "samplePrompts": [
-        "How do I manage JWT authentication?",
-        "Show me how to manage JWT authentication with the SDK",
-        "Explain the manage JWT authentication workflow",
-        "What methods do I need for manage JWT authentication?"
-      ]
-    },
-    "streaming": {
-      "key": "streaming",
-      "label": "Streaming",
-      "description": "Streaming operations",
-      "category": "streaming",
-      "methods": [
-        "startStream",
-        "stopStream",
-        "getStreamInfo",
-        "disableStream",
-        "enableStream",
-        "resetStreamKey",
-        "getStreamRecordings",
-        "getRecordingDownload",
-        "deleteRecording",
-        "getSimulcastTargets",
-        "addSimulcastTarget",
-        "removeSimulcastTarget",
-        "getGlobalStreamingStatus",
-        "setGlobalStreamingEnabled",
-        "getAvailableRoles",
-        "getStreamRole",
-        "getTokenAccess"
-      ],
-      "mcpTools": [
-        "gala_launchpad_start_stream",
-        "gala_launchpad_stop_stream",
-        "gala_launchpad_get_stream_info",
-        "gala_launchpad_reset_stream_key",
-        "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"
-      ],
-      "explanation": "\n# Live Streaming SDK\n\nThe SDK provides comprehensive live streaming management including stream control,\nrecordings management, and simulcast to external platforms.\n\n## Starting a Stream\n\n```typescript\nimport { createLaunchpadSDK } from '@gala-chain/launchpad-sdk';\n\nasync function manageStream() {\n  const sdk = createLaunchpadSDK({\n    wallet: 'your-private-key',\n    streamWebSocketUrl: 'wss://stream.example.com',  // Required for streaming\n    streamAdminApiKey: 'your-admin-key',  // Optional: for admin operations\n  });\n\n  // Start a stream for your token\n  const stream = await sdk.startStream('mytoken');\n  console.log('Stream Key:', stream.streamKey);\n  console.log('RTMP URL:', stream.rtmpUrl);\n  console.log('Playback URL:', stream.playbackUrl);\n  // Use stream.streamKey in OBS or other RTMP software\n\n  // Get stream info (public endpoint)\n  const info = await sdk.getStreamInfo('mytoken');\n  console.log('Status:', info.status);  // IDLE, ACTIVE, DISABLED\n  console.log('Is Live:', info.isLive);\n  console.log('Viewers:', info.viewerCount);\n\n  // Stop the stream when done\n  await sdk.stopStream('mytoken');\n  console.log('Stream stopped');\n\n  // Reset stream key if compromised\n  const newKey = await sdk.resetStreamKey('mytoken');\n  console.log('New Stream Key:', newKey.streamKey);\n}\n```\n\n## Recordings Management\n\n```typescript\nasync function manageRecordings() {\n  const sdk = createLaunchpadSDK({ wallet: 'your-private-key' });\n\n  // List recordings (paginated)\n  const recordings = await sdk.getStreamRecordings({\n    tokenName: 'mytoken',\n    page: 1,\n    limit: 20,\n  });\n  console.log('Total recordings:', recordings.total);\n\n  for (const rec of recordings.recordings) {\n    console.log('Asset ID:', rec.assetId);\n    console.log('Duration:', rec.duration, 'seconds');\n    console.log('Status:', rec.status);  // READY, PROCESSING, ERRORED\n  }\n\n  // Get download URL for a recording\n  const download = await sdk.getRecordingDownload('mytoken', 'asset-123');\n  console.log('Download URL:', download.downloadUrl);\n  console.log('Expires:', download.expiresAt);\n\n  // Delete a recording\n  await sdk.deleteRecording('mytoken', 'asset-123');\n}\n```\n\n## Simulcast Management\n\nRebroadcast your stream to external platforms (YouTube, Twitch, Facebook).\n\n```typescript\nasync function manageSimulcast() {\n  const sdk = createLaunchpadSDK({ wallet: 'your-private-key' });\n\n  // Get existing simulcast targets\n  const targets = await sdk.getSimulcastTargets('mytoken');\n  console.log('Max targets:', targets.maxTargets);\n  console.log('Current targets:', targets.targets.length);\n\n  // Add YouTube simulcast\n  const youtube = await sdk.addSimulcastTarget({\n    tokenName: 'mytoken',\n    platform: 'YOUTUBE',\n    rtmpUrl: 'rtmp://a.rtmp.youtube.com/live2',\n    streamKey: 'your-youtube-stream-key',\n    name: 'My YouTube Channel',\n  });\n  console.log('Added target:', youtube.target.targetId);\n\n  // Add Twitch simulcast\n  await sdk.addSimulcastTarget({\n    tokenName: 'mytoken',\n    platform: 'TWITCH',\n    rtmpUrl: 'rtmp://live.twitch.tv/app',\n    streamKey: 'live_123456_abcdef',\n    name: 'Twitch Stream',\n  });\n\n  // Remove a simulcast target\n  await sdk.removeSimulcastTarget('mytoken', youtube.target.targetId);\n}\n```\n\n## Admin Operations\n\nEnable/disable streaming globally or per-token (requires admin API key).\n\n```typescript\nasync function adminOperations() {\n  const sdk = createLaunchpadSDK({\n    wallet: 'your-private-key',\n    streamAdminApiKey: 'your-admin-key',\n  });\n\n  // Disable streaming for a specific token (admin-only)\n  await sdk.disableStream('mytoken');\n\n  // Re-enable streaming for a token (admin-only)\n  await sdk.enableStream('mytoken');\n\n  // Get global streaming status\n  const globalStatus = await sdk.getGlobalStreamingStatus();\n  console.log('Global streaming enabled:', globalStatus.enabled);\n\n  // Enable/disable streaming globally (maintenance mode)\n  await sdk.setGlobalStreamingEnabled(false);  // Disable all streams\n  await sdk.setGlobalStreamingEnabled(true);   // Re-enable\n}\n```\n\n**Available SDK Methods:**\n| Method | Description | Auth |\n|--------|-------------|------|\n| `startStream(tokenName)` | Start a stream | Wallet |\n| `stopStream(tokenName)` | Stop a stream | Wallet |\n| `getStreamInfo(tokenName)` | Get stream status | Public |\n| `resetStreamKey(tokenName)` | Generate new stream key | Wallet |\n| `disableStream(tokenName)` | Disable token streaming | Admin |\n| `enableStream(tokenName)` | Enable token streaming | Admin |\n| `getStreamRecordings(options)` | List recordings | Public |\n| `getRecordingDownload(tokenName, assetId)` | Get download URL | Wallet |\n| `deleteRecording(tokenName, assetId)` | Delete recording | Wallet |\n| `getSimulcastTargets(tokenName)` | List simulcast targets | Public |\n| `addSimulcastTarget(options)` | Add simulcast target | Wallet |\n| `removeSimulcastTarget(tokenName, targetId)` | Remove target | Wallet |\n| `getGlobalStreamingStatus()` | Get global status | Public |\n| `setGlobalStreamingEnabled(enabled)` | Enable/disable globally | Admin |\n| `getAvailableRoles()` | Get list of available streaming roles | Public |\n| `getStreamRole(options)` | Get user's role for a token | JWT |\n| `getTokenAccess(options)` | Check user's access to a token stream | JWT (optional) |\n\n**MCP Tool Equivalents:**\n- `gala_launchpad_start_stream`\n- `gala_launchpad_stop_stream`\n- `gala_launchpad_get_stream_info`\n- `gala_launchpad_reset_stream_key`\n- `gala_launchpad_disable_stream`\n- `gala_launchpad_enable_stream`\n- `gala_launchpad_get_stream_recordings`\n- `gala_launchpad_get_recording_download`\n- `gala_launchpad_delete_recording`\n- `gala_launchpad_get_simulcast_targets`\n- `gala_launchpad_add_simulcast_target`\n- `gala_launchpad_remove_simulcast_target`\n- `gala_launchpad_get_global_streaming_status`\n- `gala_launchpad_set_global_streaming_enabled`\n- `gala_launchpad_get_available_roles`\n- `gala_launchpad_get_stream_role`\n- `gala_launchpad_get_token_access`\n",
-      "samplePrompts": [
-        "How do I manage live streams?",
-        "Show me how to manage live streams with the SDK",
-        "Explain the manage live streams workflow",
-        "What methods do I need for manage live streams?"
-      ]
-    },
-    "stream-chat": {
-      "key": "stream-chat",
-      "label": "Stream chat",
-      "description": "Stream chat operations",
-      "category": "chat-messages",
-      "methods": [
-        "getChatMessages",
-        "sendChatMessage",
-        "updateChatMessage",
-        "deleteChatMessage",
-        "getChatStatus",
-        "disableChat",
-        "enableChat",
-        "getGlobalChatStatus",
-        "setGlobalChatEnabled",
-        "connectStreamWebSocket",
-        "authenticateStreamWebSocket",
-        "subscribeToStream",
-        "unsubscribeFromStream",
-        "sendStreamChatViaWebSocket",
-        "sendStreamReaction",
-        "disconnectStreamWebSocket",
-        "isStreamWebSocketConnected",
-        "getEngagementStats"
-      ],
-      "mcpTools": [
-        "gala_launchpad_get_chat_messages",
-        "gala_launchpad_send_chat_message",
-        "gala_launchpad_update_chat_message",
-        "gala_launchpad_delete_chat_message",
-        "gala_launchpad_get_chat_status",
-        "gala_launchpad_get_global_chat_status",
-        "gala_launchpad_set_global_chat_enabled",
-        "gala_launchpad_subscribe_to_stream",
-        "gala_launchpad_send_stream_chat_via_web_socket",
-        "gala_launchpad_send_stream_reaction",
-        "gala_launchpad_get_engagement_stats"
-      ],
-      "explanation": "\n# Stream Chat SDK\n\nThe SDK provides chat functionality for live streams, including REST API and\nWebSocket real-time messaging.\n\n## REST API Chat\n\n```typescript\nimport { createLaunchpadSDK } from '@gala-chain/launchpad-sdk';\n\nasync function restChat() {\n  const sdk = createLaunchpadSDK({ wallet: 'your-private-key' });\n\n  // Get chat messages (public endpoint)\n  const messages = await sdk.getChatMessages({\n    tokenName: 'mytoken',\n    page: 1,\n    limit: 50,\n  });\n\n  for (const msg of messages.messages) {\n    console.log(`[${msg.createdAt}] ${msg.user?.fullName}: ${msg.content}`);\n  }\n\n  // Send a chat message via REST\n  const sent = await sdk.sendChatMessage({\n    tokenName: 'mytoken',\n    content: 'Hello everyone!',\n  });\n  console.log('Message ID:', sent.message.messageId);\n\n  // Delete a chat message (user can delete own, admin can delete any)\n  const deleted = await sdk.deleteChatMessage({\n    tokenName: 'mytoken',\n    messageId: sent.message.messageId,\n  });\n  console.log('Message deleted:', deleted.deleted);\n\n  // Check chat status\n  const status = await sdk.getChatStatus('mytoken');\n  console.log('Chat enabled:', status.enabled);\n  if (!status.enabled) {\n    console.log('Reason:', status.reason);  // 'global' or 'token'\n  }\n}\n```\n\n## WebSocket Real-time Chat\n\nLower latency messaging with real-time updates.\n\n```typescript\nasync function webSocketChat() {\n  const sdk = createLaunchpadSDK({\n    wallet: 'your-private-key',\n    streamWebSocketUrl: 'wss://stream.example.com',\n  });\n\n  // Connect with event callbacks\n  await sdk.connectStreamWebSocket({\n    onConnect: () => console.log('Connected!'),\n    onDisconnect: (reason) => console.log('Disconnected:', reason),\n    onError: (error) => console.error('Error:', error),\n    onChatMessage: (msg) => {\n      console.log(`[${msg.tokenName}] ${msg.userAddress}: ${msg.content}`);\n    },\n    onViewerCount: (data) => {\n      console.log(`Viewers on ${data.tokenName}: ${data.count}`);\n    },\n    onStreamStatus: (status) => {\n      console.log(`Stream ${status.tokenName}: ${status.status}`);\n    },\n  });\n\n  // Authenticate (required for sending messages)\n  await sdk.authenticateStreamWebSocket();\n\n  // Subscribe to a stream's events\n  const subscribed = await sdk.subscribeToStream('mytoken');\n  console.log('Subscribed, stream status:', subscribed.status);\n\n  // Send message via WebSocket (lower latency)\n  await sdk.sendStreamChatViaWebSocket('mytoken', 'Hello via WebSocket!');\n\n  // Send emoji reaction (ephemeral, not persisted)\n  await sdk.sendStreamReaction('mytoken', '🔥', 0);\n\n  // Unsubscribe when done\n  await sdk.unsubscribeFromStream('mytoken');\n\n  // Disconnect\n  sdk.disconnectStreamWebSocket();\n}\n```\n\n## Admin Chat Operations\n\n```typescript\nasync function adminChat() {\n  const sdk = createLaunchpadSDK({\n    wallet: 'your-private-key',\n    streamAdminApiKey: 'your-admin-key',\n  });\n\n  // Disable chat for a token\n  await sdk.disableChat('mytoken');\n\n  // Re-enable chat\n  await sdk.enableChat('mytoken');\n\n  // Get global chat status\n  const globalStatus = await sdk.getGlobalChatStatus();\n  console.log('Global chat enabled:', globalStatus.enabled);\n\n  // Disable/enable chat globally\n  await sdk.setGlobalChatEnabled(false);  // Disable all chat\n  await sdk.setGlobalChatEnabled(true);   // Re-enable\n}\n```\n\n**WebSocket Events:**\n| Event | Description | Payload |\n|-------|-------------|---------|\n| `chat_message` | New chat message | `{ tokenName, messageId, content, userAddress, user? }` |\n| `viewer_count` | Viewer count update | `{ tokenName, count }` |\n| `stream_status` | Stream status change | `{ tokenName, status, isLive, playbackId }` |\n| `chat_status` | Chat enabled/disabled | `{ tokenName, enabled }` |\n\n**Available SDK Methods:**\n| Method | Description | Auth |\n|--------|-------------|------|\n| `getChatMessages(options)` | Get chat history | Public |\n| `sendChatMessage(options)` | Send via REST | Wallet |\n| `deleteChatMessage(options)` | Delete message | Wallet/Admin |\n| `getChatStatus(tokenName)` | Check chat status | Public |\n| `disableChat(tokenName)` | Disable token chat | Admin |\n| `enableChat(tokenName)` | Enable token chat | Admin |\n| `getGlobalChatStatus()` | Get global status | Public |\n| `setGlobalChatEnabled(enabled)` | Enable/disable globally | Admin |\n| `connectStreamWebSocket(callbacks)` | Connect WebSocket | None |\n| `authenticateStreamWebSocket()` | Authenticate WS | Wallet |\n| `subscribeToStream(tokenName)` | Subscribe to events | None |\n| `unsubscribeFromStream(tokenName)` | Unsubscribe | None |\n| `sendStreamChatViaWebSocket(tokenName, content)` | Send via WS | Wallet |\n| `sendStreamReaction(tokenName, emoji, streamTime)` | Send emoji reaction | Wallet |\n| `disconnectStreamWebSocket()` | Close connection | None |\n| `getEngagementStats(tokenName)` | Get viewer and chat engagement stats | Public |\n\n**MCP Tool Equivalents:**\n- `gala_launchpad_get_chat_messages`\n- `gala_launchpad_send_chat_message`\n- `gala_launchpad_delete_chat_message`\n- `gala_launchpad_get_chat_status`\n- `gala_launchpad_set_chat_enabled`\n- `gala_launchpad_get_global_chat_status`\n- `gala_launchpad_set_global_chat_enabled`\n- `gala_launchpad_connect_stream_websocket`\n- `gala_launchpad_subscribe_to_stream`\n- `gala_launchpad_send_stream_chat_websocket`\n- `gala_launchpad_send_stream_reaction`\n- `gala_launchpad_get_engagement_stats`\n",
-      "samplePrompts": [
-        "How do I handle stream chat and messaging?",
-        "Show me how to handle stream chat and messaging with the SDK",
-        "Explain the handle stream chat and messaging workflow",
-        "What methods do I need for handle stream chat and messaging?"
-      ]
-    },
-    "ban-management": {
-      "key": "ban-management",
-      "label": "Ban management",
-      "description": "Ban management operations",
-      "category": "ban",
-      "methods": [
-        "createBan",
-        "removeBan",
-        "listBans",
-        "getBanStatus",
-        "getActiveUsers"
-      ],
-      "mcpTools": [
-        "gala_launchpad_create_ban",
-        "gala_launchpad_remove_ban",
-        "gala_launchpad_list_bans",
-        "gala_launchpad_get_ban_status",
-        "gala_launchpad_get_active_users"
-      ],
-      "explanation": "\n# Ban/Moderation Operations - SDK v5.5.0+\n\nUser ban management for stream moderation, including creating bans, removing bans,\nlisting banned users, checking ban status, and viewing active users.\n\n## Creating and Removing Bans\n\n```typescript\nimport { createLaunchpadSDK, BAN_DURATIONS } from '@gala-chain/launchpad-sdk';\n\nconst sdk = createLaunchpadSDK({\n  privateKey: process.env.PRIVATE_KEY,\n  streamAdminApiKey: process.env.STREAM_ADMIN_API_KEY, // Admin key for ban ops\n});\n\n// Create a permanent ban\nconst permanentBan = await sdk.createBan({\n  tokenName: 'mytoken',\n  userAddress: 'eth|0x1234567890abcdef1234567890abcdef12345678',\n  reason: 'Spamming chat',\n});\nconsole.log('Permanent ban created:', permanentBan.ban.id);\n\n// Create a temporary ban (1 hour)\nconst tempBan = await sdk.createBan({\n  tokenName: 'mytoken',\n  userAddress: 'eth|0xabcdef1234567890abcdef1234567890abcdef12',\n  reason: 'Inappropriate behavior',\n  durationSeconds: BAN_DURATIONS.ONE_HOUR, // 3600 seconds\n});\nconsole.log('Temp ban expires:', tempBan.ban.expiresAt);\n\n// Remove a ban (unban user)\nconst unbanned = await sdk.removeBan({\n  tokenName: 'mytoken',\n  userAddress: 'eth|0x1234567890abcdef1234567890abcdef12345678',\n});\nconsole.log('User unbanned:', unbanned.removed);\n```\n\n## Duration Presets\n\n```typescript\nimport { BAN_DURATIONS } from '@gala-chain/launchpad-sdk';\n\n// Available presets\nBAN_DURATIONS.ONE_HOUR   // 3600 seconds (1 hour)\nBAN_DURATIONS.ONE_DAY    // 86400 seconds (24 hours)\nBAN_DURATIONS.ONE_WEEK   // 604800 seconds (7 days)\nBAN_DURATIONS.ONE_MONTH  // 2592000 seconds (30 days)\n\n// Custom duration (min: 60 sec, max: 31536000 sec / 1 year)\nconst customBan = await sdk.createBan({\n  tokenName: 'mytoken',\n  userAddress: 'eth|0x...',\n  durationSeconds: 7200, // 2 hours\n});\n```\n\n## Listing Bans\n\n```typescript\n// List all bans for a token\nconst allBans = await sdk.listBans({\n  tokenName: 'mytoken',\n  page: 1,\n  limit: 20,\n});\nconsole.log('Total bans:', allBans.meta.total);\n\nfor (const ban of allBans.bans) {\n  console.log(`- ${ban.userAddress}: ${ban.reason || 'No reason'}`);\n  console.log(`  Permanent: ${ban.isPermanent}`);\n  console.log(`  Expires: ${ban.expiresAt || 'Never'}`);\n}\n\n// Search bans by user\nconst searchResults = await sdk.listBans({\n  tokenName: 'mytoken',\n  search: '0x1234', // Searches userAddress OR fullName\n});\n\n// Filter by specific field\nconst filteredBans = await sdk.listBans({\n  tokenName: 'mytoken',\n  userAddress: '0x1234', // Filter by address only\n  name: 'John',          // Filter by display name only\n});\n```\n\n## Checking Ban Status\n\n```typescript\n// Check if specific user is banned\nconst status = await sdk.getBanStatus({\n  tokenName: 'mytoken',\n  userAddress: 'eth|0x1234567890abcdef1234567890abcdef12345678',\n});\n\nif (status.banned) {\n  console.log('User is banned!');\n  console.log('Reason:', status.ban?.reason);\n  console.log('Permanent:', status.ban?.isPermanent);\n  console.log('Expires:', status.ban?.expiresAt);\n} else {\n  console.log('User is not banned');\n}\n```\n\n## Viewing Active Users\n\n```typescript\nimport { ACTIVE_USER_TYPE } from '@gala-chain/launchpad-sdk';\n\n// Get all active viewers\nconst viewers = await sdk.getActiveUsers({\n  tokenName: 'mytoken',\n  type: ACTIVE_USER_TYPE.VIEWERS, // or 'viewers'\n});\nconsole.log('Active viewers:', viewers.total);\n\n// Get only chat participants\nconst chatters = await sdk.getActiveUsers({\n  tokenName: 'mytoken',\n  type: ACTIVE_USER_TYPE.CHAT_PARTICIPANTS, // or 'chat_participants'\n});\nconsole.log('Chat participants:', chatters.total);\n\n// Search active users\nconst searchActive = await sdk.getActiveUsers({\n  tokenName: 'mytoken',\n  search: 'john', // Search by name or address\n});\n\nfor (const user of searchActive.users) {\n  console.log(`- ${user.fullName || user.userAddress}`);\n  console.log(`  In chat: ${user.isChatParticipant}`);\n}\n```\n\n## Authentication\n\nBan operations support two authentication modes:\n\n1. **Admin API Key** (streamAdminApiKey) - Full moderation access\n2. **JWT Auth** (login()) - Token owner moderation only\n\n```typescript\n// Admin mode - can moderate any token\nconst adminSdk = createLaunchpadSDK({\n  privateKey: process.env.PRIVATE_KEY,\n  streamAdminApiKey: process.env.STREAM_ADMIN_API_KEY,\n});\n\n// Owner mode - can only moderate own tokens\nconst ownerSdk = createLaunchpadSDK({\n  privateKey: process.env.PRIVATE_KEY,\n});\nawait ownerSdk.login(); // JWT authentication required\n```\n\n## WebSocket Events\n\nBan events are broadcast to affected users via WebSocket:\n\n```typescript\n// Listen for ban events\nsdk.connectStreamWebSocket({\n  onUserBanned: (event) => {\n    console.log('User banned:', event.userAddress);\n    console.log('Reason:', event.reason);\n    console.log('Expires:', event.expiresAt);\n  },\n  onUserUnbanned: (event) => {\n    console.log('User unbanned:', event.userAddress);\n  },\n  onBanEnforcement: (event) => {\n    // Received when banned user tries to chat/react\n    console.log('Ban enforced for action:', event.action);\n    console.log('Reason:', event.reason);\n  },\n});\n```\n\n## SDK Methods Reference\n\n| Method | Description | Auth |\n|--------|-------------|------|\n| `createBan(options)` | Create a new ban | Admin/Owner |\n| `removeBan(options)` | Remove a ban (unban user) | Admin/Owner |\n| `listBans(options)` | List banned users | Admin/Owner |\n| `getBanStatus(options)` | Check if user is banned | Admin/Owner |\n| `getActiveUsers(options)` | Get active viewers/chatters | Admin/Owner |\n\n**MCP Tool Equivalents:**\n- `gala_launchpad_create_ban`\n- `gala_launchpad_remove_ban`\n- `gala_launchpad_list_bans`\n- `gala_launchpad_get_ban_status`\n- `gala_launchpad_get_active_users`\n",
-      "samplePrompts": [
-        "How do I manage user bans?",
-        "Show me how to manage user bans with the SDK",
-        "Explain the manage user bans workflow",
-        "What methods do I need for manage user bans?"
-      ]
-    },
-    "api-key-management": {
-      "key": "api-key-management",
-      "label": "Api key management",
-      "description": "Api key management operations",
-      "category": "api-keys",
-      "methods": [
-        "createApiKey",
-        "listApiKeys",
-        "getApiKey",
-        "updateApiKey",
-        "revokeApiKey",
-        "getApiKeyRoles"
-      ],
-      "mcpTools": [
-        "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"
-      ],
-      "explanation": "\n# API Key Management - SDK v5.6.0+\n\nUser-managed API keys with role-based permissions for delegating token management\nauthority to third-party services or automated systems.\n\n**CRITICAL**: Raw API keys are ONLY shown once at creation time. Store them\nsecurely immediately - they cannot be retrieved again.\n\n## Creating API Keys\n\n```typescript\nimport { createLaunchpadSDK, API_KEY_ROLE } from '@gala-chain/launchpad-sdk';\n\nconst sdk = createLaunchpadSDK({\n  privateKey: process.env.PRIVATE_KEY,\n});\n\n// MUST authenticate first\nawait sdk.login();\n\n// Create a moderator key for specific tokens\nconst result = await sdk.createApiKey({\n  role: API_KEY_ROLE.MODERATOR,\n  description: 'Chat moderation bot',\n  delegateAllTokens: false,\n  tokenNames: ['mytoken', 'othertoken'],\n  expiresAt: '2025-12-31T23:59:59Z', // Optional expiration\n});\n\n// CRITICAL: Save this immediately - shown only once!\nconsole.log('Raw Key:', result.rawKey);\n// Format: glp_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxx\nconsole.log('Key ID:', result.id);\nconsole.log('Prefix:', result.keyPrefix);\n```\n\n## Role Hierarchy\n\n```typescript\nimport { API_KEY_ROLE, API_KEY_ROLE_HIERARCHY } from '@gala-chain/launchpad-sdk';\n\n// Available roles (hierarchical)\nAPI_KEY_ROLE.MODERATOR          // Chat, comments, bans\nAPI_KEY_ROLE.TECHNICAL_PRODUCER // Simulcast, stream key, stop/start\nAPI_KEY_ROLE.MANAGER            // Moderator + Technical Producer + recordings\nAPI_KEY_ROLE.OWNER              // Full access (indistinguishable from normal auth)\n\n// Role hierarchy levels\nAPI_KEY_ROLE_HIERARCHY.MODERATOR           // 1\nAPI_KEY_ROLE_HIERARCHY.TECHNICAL_PRODUCER  // 1\nAPI_KEY_ROLE_HIERARCHY.MANAGER             // 2\nAPI_KEY_ROLE_HIERARCHY.OWNER               // 3\n\n// Check if role has sufficient permission\nimport { roleHasSufficientPermission } from '@gala-chain/launchpad-sdk';\n\nconst canManage = roleHasSufficientPermission('MANAGER', 'MODERATOR'); // true\nconst canOwn = roleHasSufficientPermission('MODERATOR', 'OWNER');      // false\n```\n\n## Token Delegation\n\n```typescript\n// Delegate all tokens (current and future)\nconst allTokensKey = await sdk.createApiKey({\n  role: API_KEY_ROLE.MODERATOR,\n  description: 'All tokens moderator',\n  delegateAllTokens: true,\n});\n\n// Delegate specific tokens only\nconst specificKey = await sdk.createApiKey({\n  role: API_KEY_ROLE.MANAGER,\n  description: 'Project manager for specific tokens',\n  delegateAllTokens: false,\n  tokenNames: ['token1', 'token2', 'token3'], // Case-insensitive\n});\n```\n\n## Listing and Getting API Keys\n\n```typescript\n// List all API keys (paginated)\nconst list = await sdk.listApiKeys({\n  page: 1,\n  limit: 20,\n});\nconsole.log('Total keys:', list.meta.total);\n\nfor (const key of list.apiKeys) {\n  console.log(`- ${key.keyPrefix}: ${key.role}`);\n  console.log(`  Description: ${key.description || 'None'}`);\n  console.log(`  Last used: ${key.lastUsedAt || 'Never'}`);\n  console.log(`  Expires: ${key.expiresAt || 'Never'}`);\n}\n\n// Get single API key by ID\nconst key = await sdk.getApiKey(123);\nconsole.log('Key details:', key);\n```\n\n## Updating API Keys\n\n```typescript\n// Update description\nconst updated = await sdk.updateApiKey(123, {\n  description: 'Updated description',\n});\n\n// Upgrade role\nawait sdk.updateApiKey(123, {\n  role: API_KEY_ROLE.MANAGER,\n});\n\n// Change token delegation\nawait sdk.updateApiKey(123, {\n  delegateAllTokens: true,\n});\n\n// Update specific token access (replaces existing)\nawait sdk.updateApiKey(123, {\n  delegateAllTokens: false,\n  tokenNames: ['newtoken1', 'newtoken2'],\n});\n\n// Update expiration (null to remove)\nawait sdk.updateApiKey(123, {\n  expiresAt: '2026-12-31T23:59:59Z',\n});\n\n// Remove expiration\nawait sdk.updateApiKey(123, {\n  expiresAt: null,\n});\n```\n\n## Revoking API Keys\n\n```typescript\n// Revoke (soft delete) an API key\nawait sdk.revokeApiKey(123);\nconsole.log('API key revoked');\n\n// Key is now unusable - attempts to use it will fail with 401\n```\n\n## Getting Available Roles\n\n```typescript\n// Get list of valid roles\nconst roles = sdk.getApiKeyRoles();\nconsole.log('Available roles:', roles);\n// ['MODERATOR', 'TECHNICAL_PRODUCER', 'MANAGER', 'OWNER']\n```\n\n## Validation Helpers\n\n```typescript\nimport {\n  isValidApiKeyRole,\n  validateCreateApiKeyOptions,\n  validateUpdateApiKeyOptions,\n} from '@gala-chain/launchpad-sdk';\n\n// Validate role string\nif (isValidApiKeyRole('MODERATOR')) {\n  console.log('Valid role');\n}\n\n// Validate creation options\nconst createErrors = validateCreateApiKeyOptions({\n  role: 'MODERATOR',\n  description: 'Test key',\n});\nif (createErrors.length > 0) {\n  console.error('Validation errors:', createErrors);\n}\n\n// Validate update options\nconst updateErrors = validateUpdateApiKeyOptions({\n  role: 'MANAGER',\n  expiresAt: '2025-12-31T23:59:59Z',\n});\n```\n\n## SDK Methods Reference\n\n| Method | Description | Auth |\n|--------|-------------|------|\n| `createApiKey(options)` | Create new API key | JWT |\n| `listApiKeys(options?)` | List API keys (paginated) | JWT |\n| `getApiKey(id)` | Get API key by ID | JWT |\n| `updateApiKey(id, options)` | Update API key | JWT |\n| `revokeApiKey(id)` | Revoke (soft delete) key | JWT |\n| `getApiKeyRoles()` | Get valid role list | None |\n\n**MCP Tool Equivalents:**\n- `gala_launchpad_create_api_key`\n- `gala_launchpad_list_api_keys`\n- `gala_launchpad_get_api_key`\n- `gala_launchpad_update_api_key`\n- `gala_launchpad_revoke_api_key`\n- `gala_launchpad_get_api_key_roles`\n",
-      "samplePrompts": [
-        "How do I manage API keys?",
-        "Show me how to manage API keys with the SDK",
-        "Explain the manage API keys workflow",
-        "What methods do I need for manage API keys?"
-      ]
-    },
-    "moderator-invites": {
-      "key": "moderator-invites",
-      "label": "Moderator invites",
-      "description": "Moderator invites operations",
-      "category": "moderators",
-      "methods": [
-        "createModeratorInvite",
-        "claimModeratorInvite",
-        "getModeratedTokens",
-        "listModeratorInvites",
-        "revokeModeratorInvite",
-        "getModeratorInviteByCode",
-        "updateModeratorInviteRole"
-      ],
-      "mcpTools": [
-        "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_update_moderator_invite_role"
-      ],
-      "explanation": "\n# Moderator Invites - SDK v5.7.0+\n\nMagic link-based moderator delegation system. Token owners can create invite\nlinks to grant stream management access to other users without needing their\nwallet address upfront.\n\n## Flow Overview\n\n1. **Owner creates invite** → Gets magic link URL\n2. **Owner shares link** (email, Slack, Discord, etc.)\n3. **Recipient clicks link** → Redirected to claim page\n4. **Recipient logs in** → Claims invite with their wallet\n5. **Recipient gains access** → Token appears in their /studio dashboard\n\n## Creating Moderator Invites\n\n```typescript\nimport { createLaunchpadSDK, MODERATOR_ROLE } from '@gala-chain/launchpad-sdk';\n\nconst sdk = createLaunchpadSDK({\n  privateKey: process.env.PRIVATE_KEY,\n});\n\n// MUST authenticate first\nawait sdk.login();\n\n// Create an invite for a moderator\nconst result = await sdk.createModeratorInvite({\n  tokenName: 'mytoken',\n  role: MODERATOR_ROLE.MODERATOR,\n  description: 'John - Friday stream moderator',\n  expiresAt: '2025-12-31T23:59:59Z', // Optional expiration\n});\n\n// Share this URL with the intended moderator\nconsole.log('Invite URL:', result.invite.inviteUrl);\nconsole.log('Invite Code:', result.invite.inviteCode);\nconsole.log('Status:', result.invite.status); // PENDING\n```\n\n## Moderator Roles\n\n```typescript\nimport { MODERATOR_ROLE } from '@gala-chain/launchpad-sdk';\n\n// Available roles (OWNER not available for invites)\nMODERATOR_ROLE.MODERATOR           // Chat, comments, bans\nMODERATOR_ROLE.TECHNICAL_PRODUCER  // Simulcast, stream key, stop/start\nMODERATOR_ROLE.MANAGER             // All of the above + recordings + stream settings\n```\n\n## Listing Invites\n\n```typescript\n// List all invites for a token (owner only)\nconst list = await sdk.listModeratorInvites({\n  tokenName: 'mytoken',\n  status: 'PENDING', // Optional filter: PENDING, CLAIMED, REVOKED, EXPIRED\n  page: 1,\n  limit: 20,\n});\n\nconsole.log('Total invites:', list.meta.totalItems);\n\nfor (const invite of list.invites) {\n  console.log(`- ID ${invite.id}: ${invite.role}`);\n  console.log(`  Status: ${invite.status}`);\n  console.log(`  Description: ${invite.description || 'None'}`);\n  console.log(`  Created: ${invite.createdAt}`);\n  console.log(`  Expires: ${invite.expiresAt || 'Never'}`);\n}\n```\n\n## Claiming Invites (Recipient Side)\n\n```typescript\n// Extract code from magic link URL\nconst inviteCode = 'abc123...'; // 64-character hex code\n\n// Recipient authenticates and claims\nawait sdk.login();\n\nconst result = await sdk.claimModeratorInvite({\n  inviteCode: inviteCode,\n});\n\nconsole.log('Claimed token:', result.token.tokenName);\nconsole.log('Your role:', result.token.role);\nconsole.log('Claimed at:', result.token.claimedAt);\n// Token now appears in /studio dashboard\n```\n\n## Previewing Invites (Public)\n\n```typescript\n// Preview invite details before logging in (public endpoint)\nconst preview = await sdk.getModeratorInviteByCode('abc123...');\n\nconsole.log('Token:', preview.tokenName);\nconsole.log('Symbol:', preview.tokenSymbol);\nconsole.log('Role offered:', preview.role);\nconsole.log('Status:', preview.status);\nconsole.log('Invited by:', preview.invitedBy.fullName);\n```\n\n## Getting Moderated Tokens (Studio Dashboard)\n\n```typescript\n// Get all tokens where you have moderator access\nawait sdk.login();\n\nconst tokens = await sdk.getModeratedTokens({\n  page: 1,\n  limit: 20,\n});\n\nfor (const token of tokens.tokens) {\n  console.log(`- ${token.tokenName} (${token.tokenSymbol})`);\n  console.log(`  Role: ${token.role}`);\n  console.log(`  Stream status: ${token.muxStreamStatus}`);\n}\n```\n\n## Revoking Invites\n\n```typescript\n// Revoke by invite ID (owner only)\nawait sdk.revokeModeratorInvite(123);\nconsole.log('Invite revoked');\n\n// If already claimed, moderator loses access immediately\n// If pending, invite can no longer be claimed\n```\n\n## SDK Methods Reference\n\n| Method | Description | Auth |\n|--------|-------------|------|\n| `createModeratorInvite(options)` | Create magic link invite | JWT (owner) |\n| `claimModeratorInvite(options)` | Claim invite with code | JWT |\n| `getModeratedTokens(options?)` | Get tokens you moderate | JWT |\n| `listModeratorInvites(options)` | List invites for token | JWT (owner) |\n| `revokeModeratorInvite(id)` | Revoke invite by ID | JWT (owner) |\n| `getModeratorInviteByCode(code)` | Preview invite details | None |\n\n**MCP Tool Equivalents:**\n- `gala_launchpad_create_moderator_invite`\n- `gala_launchpad_claim_moderator_invite`\n- `gala_launchpad_get_moderated_tokens`\n- `gala_launchpad_list_moderator_invites`\n- `gala_launchpad_revoke_moderator_invite`\n- `gala_launchpad_get_moderator_invite`\n",
-      "samplePrompts": [
-        "How do I manage moderator invites?",
-        "Show me how to manage moderator invites with the SDK",
-        "Explain the manage moderator invites workflow",
-        "What methods do I need for manage moderator invites?"
-      ]
-    },
-    "overseer-invites": {
-      "key": "overseer-invites",
-      "label": "Overseer invites",
-      "description": "Overseer invites operations",
-      "category": "overseers",
-      "methods": [
-        "createOverseerInvite",
-        "claimOverseerInvite",
-        "listOverseerInvites",
-        "getOverseerInviteByCode",
-        "revokeOverseerInvite",
-        "listOverseers",
-        "revokeOverseer",
-        "getMyOverseerStatus",
-        "getOverseerSummary"
-      ],
-      "mcpTools": [
-        "gala_launchpad_create_overseer_invite",
-        "gala_launchpad_claim_overseer_invite",
-        "gala_launchpad_list_overseer_invites",
-        "gala_launchpad_revoke_overseer_invite",
-        "gala_launchpad_list_overseers",
-        "gala_launchpad_revoke_overseer",
-        "gala_launchpad_get_my_overseer_status",
-        "gala_launchpad_get_overseer_summary"
-      ],
-      "explanation": "\n# Overseer System - SDK v5.9.0+\n\nGlobal platform oversight via magic link invites. Overseers have MANAGER-level\naccess to ALL tokens (current and future), unlike moderators who have token-scoped access.\n\n## Key Differences from Moderators\n\n| Feature | Moderator | Overseer |\n|---------|-----------|----------|\n| Scope | Per-token or blanket (owner's tokens) | ALL tokens on platform |\n| Access Level | MODERATOR, TECHNICAL_PRODUCER, or MANAGER | Always MANAGER |\n| Grant Authority | Token owner | Admin or existing Overseer |\n| Use Case | Stream management delegation | Platform-wide oversight |\n\n## Creating Overseer Invites\n\n```typescript\nimport { createLaunchpadSDK } from '@gala-chain/launchpad-sdk';\n\nconst sdk = createLaunchpadSDK({\n  privateKey: process.env.PRIVATE_KEY,\n  streamAdminApiKey: process.env.STREAM_ADMIN_API_KEY, // Admin key OR JWT auth\n});\n\n// Option 1: Using Admin API key\nconst result = await sdk.createOverseerInvite({\n  description: 'John - Platform Support Team',\n  expiresAt: '2025-12-31T23:59:59Z', // Optional\n});\n\n// Option 2: Using JWT (as existing Overseer)\nawait sdk.login();\nconst result = await sdk.createOverseerInvite({\n  description: 'Platform team member',\n});\n\nconsole.log('Share this link:', result.invite.inviteUrl);\nconsole.log('Invite Code:', result.invite.inviteCode);\n```\n\n## Claiming Overseer Invites\n\n```typescript\n// Recipient must be authenticated\nawait sdk.login();\n\n// Claim the invite\nconst claimed = await sdk.claimOverseerInvite('abc123...');\nconsole.log('Now an overseer!');\nconsole.log('Status:', claimed.invite.status); // CLAIMED\n\n// Check own status\nconst status = await sdk.getMyOverseerStatus();\nconsole.log('Is Overseer:', status.isOverseer); // true\nconsole.log('Granted at:', status.overseer?.createdAt);\n```\n\n## Listing Overseers and Invites\n\n```typescript\n// List all overseer invites (paginated)\nconst invites = await sdk.listOverseerInvites({\n  status: 'PENDING', // PENDING, CLAIMED, REVOKED, EXPIRED\n  page: 1,\n  limit: 20,\n});\n\nfor (const invite of invites.invites) {\n  console.log(`#${invite.id}: ${invite.description || 'No description'}`);\n  console.log(`  Status: ${invite.status}`);\n  console.log(`  Created by: ${invite.invitedBy.fullName || invite.invitedBy.address}`);\n}\n\n// List all active overseers\nconst overseers = await sdk.listOverseers({\n  status: 'ACTIVE', // ACTIVE or REVOKED\n  page: 1,\n  limit: 20,\n});\n\nfor (const overseer of overseers.overseers) {\n  console.log(`Overseer: ${overseer.userAddress}`);\n  console.log(`  Since: ${overseer.createdAt}`);\n}\n```\n\n## Public Invite Preview\n\n```typescript\n// Get public info about an invite (no auth required)\nconst preview = await sdk.getOverseerInviteByCode('abc123...');\n\nconsole.log('Status:', preview.status);\nconsole.log('Description:', preview.description);\nconsole.log('Invited by:', preview.invitedBy.fullName);\nconsole.log('Expires:', preview.expiresAt);\n```\n\n## Revoking Access\n\n```typescript\n// Revoke an invite by ID\nawait sdk.revokeOverseerInvite(123);\nconsole.log('Invite revoked');\n\n// Revoke an overseer by wallet address\nawait sdk.revokeOverseer('eth|1234567890abcdef...');\nconsole.log('Overseer access revoked');\n```\n\n## SDK Methods Reference\n\n| Method | Description | Auth |\n|--------|-------------|------|\n| `createOverseerInvite(options?)` | Create magic link invite | Admin API key OR JWT (Overseer) |\n| `claimOverseerInvite(code)` | Claim invite with code | JWT |\n| `listOverseerInvites(options?)` | List all overseer invites | Admin API key OR JWT (Overseer) |\n| `getOverseerInviteByCode(code)` | Preview invite details | None (public) |\n| `revokeOverseerInvite(id)` | Revoke invite by ID | Admin API key OR JWT (Overseer) |\n| `listOverseers(options?)` | List all overseers | Admin API key OR JWT (Overseer) |\n| `revokeOverseer(address)` | Revoke overseer by address | Admin API key OR JWT (Overseer) |\n| `getMyOverseerStatus()` | Check own overseer status | JWT |\n\n**MCP Tool Equivalents:**\n- `gala_launchpad_create_overseer_invite`\n- `gala_launchpad_claim_overseer_invite`\n- `gala_launchpad_list_overseer_invites`\n- `gala_launchpad_get_overseer_invite`\n- `gala_launchpad_revoke_overseer_invite`\n- `gala_launchpad_list_overseers`\n- `gala_launchpad_revoke_overseer`\n- `gala_launchpad_get_my_overseer_status`\n- `gala_launchpad_get_overseer_summary`\n",
-      "samplePrompts": [
-        "How do I manage overseer invites?",
-        "Show me how to manage overseer invites with the SDK",
-        "Explain the manage overseer invites workflow",
-        "What methods do I need for manage overseer invites?"
-      ]
-    },
-    "content-flag-management": {
-      "key": "content-flag-management",
-      "label": "Content flag management",
-      "description": "Content flag management operations",
-      "category": "content-flags",
-      "methods": [
-        "createFlag",
-        "listFlags",
-        "listGlobalFlags",
-        "dismissFlag",
-        "actionFlag",
-        "getComments",
-        "createComment",
-        "updateComment",
-        "deleteComment"
-      ],
-      "mcpTools": [
-        "gala_launchpad_create_flag",
-        "gala_launchpad_list_flags",
-        "gala_launchpad_list_global_flags",
-        "gala_launchpad_dismiss_flag",
-        "gala_launchpad_action_flag",
-        "gala_launchpad_get_comments",
-        "gala_launchpad_create_comment",
-        "gala_launchpad_update_comment",
-        "gala_launchpad_delete_comment"
-      ],
-      "explanation": "\n# Content Flag Management - SDK v5.11.0+\n\nContent moderation via flags and comments. Moderators can flag content for review,\ntake action on flags (delete content, ban users), and manage pool comments.\n\n## Content Types\n\nFlags can be created for:\n- `MESSAGE` - Chat messages\n- `COMMENT` - Pool comments\n- `STREAM` - Live streams (admin only)\n\n## Creating Content Flags\n\n```typescript\nimport { createLaunchpadSDK, CONTENT_TYPE } from '@gala-chain/launchpad-sdk';\n\nconst sdk = createLaunchpadSDK({\n  privateKey: process.env.PRIVATE_KEY,\n});\n\nawait sdk.login();\n\n// Flag a chat message\nconst flag = await sdk.createFlag({\n  tokenName: 'mytoken',\n  contentType: CONTENT_TYPE.MESSAGE,\n  contentId: 'msg-123',\n  reason: 'Spam/harassment',\n});\n\nconsole.log('Flag ID:', flag.id);\nconsole.log('Status:', flag.status); // PENDING\n```\n\n## Listing Flags\n\n```typescript\n// List all pending flags for a token\nconst flags = await sdk.listFlags({\n  tokenName: 'mytoken',\n  status: 'PENDING',\n  page: 1,\n  limit: 20,\n});\n\nfor (const flag of flags.flags) {\n  console.log(`Flag #${flag.id}: ${flag.contentType}`);\n  console.log(`  Reason: ${flag.reason}`);\n  console.log(`  Reporter: ${flag.reporterAddress}`);\n}\n```\n\n## Taking Action on Flags\n\n```typescript\n// Dismiss a flag (no action taken)\nawait sdk.dismissFlag(flagId);\n\n// Take action - delete content only\nawait sdk.actionFlag(flagId, {\n  action: 'DELETE_CONTENT',\n});\n\n// Take action - ban the user\nawait sdk.actionFlag(flagId, {\n  action: 'BAN_USER',\n  banDuration: 3600, // 1 hour ban\n});\n\n// Take action - delete content AND ban user\nawait sdk.actionFlag(flagId, {\n  action: 'DELETE_AND_BAN',\n  banDuration: 86400, // 24 hour ban\n});\n```\n\n## Managing Pool Comments with Reactions\n\nComments include a `messageId` for reactions integration and optional `reactions` data.\n\n```typescript\n// Fetch comments for a pool (with reactions data)\nconst comments = await sdk.getComments({\n  tokenName: 'mytoken',\n  page: 1,\n  limit: 20,\n});\n\nfor (const comment of comments.comments) {\n  console.log(`ID: ${comment.id}, MessageId: ${comment.messageId}`);\n  console.log(`${comment.userAddress}: ${comment.content}`);\n\n  // Check reactions on this comment\n  if (comment.reactions) {\n    console.log(`Total reactions: ${comment.reactions.totalCount}`);\n    for (const reaction of comment.reactions.reactions) {\n      console.log(`  ${reaction.reactionType}: ${reaction.count} (you reacted: ${reaction.userReacted})`);\n    }\n  }\n}\n\n// Post a comment (requires JWT auth)\nawait sdk.login();\nconst newComment = await sdk.createComment({\n  tokenName: 'mytoken',\n  content: 'Great project! Looking forward to the launch.',\n});\nconsole.log('Comment messageId:', newComment.comment.messageId);\n\n// Add a reaction to a comment using its messageId\nawait sdk.addReaction({\n  messageId: newComment.comment.messageId,\n  reaction: '👍',\n});\n\n// Remove a reaction\nawait sdk.removeReaction({\n  messageId: newComment.comment.messageId,\n  reaction: '👍',\n});\n\n// Delete a comment (moderator only)\nawait sdk.deleteComment({ commentId: comment.id });\n```\n\n## SDK Methods Reference\n\n| Method | Description | Auth |\n|--------|-------------|------|\n| `createFlag(options)` | Flag content for review | JWT |\n| `listFlags(options)` | List flags for a token | API key OR JWT (Moderator) |\n| `dismissFlag(flagId)` | Dismiss flag (no action) | API key OR JWT (Moderator) |\n| `actionFlag(flagId, options)` | Take action on flag | API key OR JWT (Moderator) |\n| `getComments(options)` | Get pool comments with reactions | None (public) |\n| `createComment(options)` | Post a comment, returns messageId | JWT |\n| `deleteComment(options)` | Delete a comment | API key OR JWT (Moderator) |\n| `addReaction(options)` | Add reaction to comment/message | JWT |\n| `removeReaction(options)` | Remove reaction from comment/message | JWT |\n\n**MCP Tool Equivalents:**\n- `gala_launchpad_create_flag`\n- `gala_launchpad_list_flags`\n- `gala_launchpad_dismiss_flag`\n- `gala_launchpad_action_flag`\n- `gala_launchpad_fetch_comments`\n- `gala_launchpad_post_comment`\n- `gala_launchpad_delete_comment`\n- `gala_launchpad_add_reaction`\n- `gala_launchpad_remove_reaction`\n",
-      "samplePrompts": [
-        "How do I manage content flags?",
-        "Show me how to manage content flags with the SDK",
-        "Explain the manage content flags workflow",
-        "What methods do I need for manage content flags?"
-      ]
-    },
-    "content-reactions": {
-      "key": "content-reactions",
-      "label": "Content reactions",
-      "description": "Content reactions operations",
-      "category": "content-reactions",
-      "methods": [
-        "addContentReaction",
-        "removeContentReaction",
-        "addReactionToChatMessage",
-        "removeReactionFromChatMessage",
-        "addReactionToComment",
-        "removeReactionFromComment"
-      ],
-      "mcpTools": [
-        "gala_launchpad_add_content_reaction",
-        "gala_launchpad_remove_content_reaction",
-        "gala_launchpad_add_reaction_to_chat_message",
-        "gala_launchpad_remove_reaction_from_chat_message",
-        "gala_launchpad_add_reaction_to_comment",
-        "gala_launchpad_remove_reaction_from_comment"
-      ],
-      "explanation": "",
-      "samplePrompts": [
-        "How do I manage content reactions?",
-        "Show me how to manage content reactions with the SDK",
-        "Explain the manage content reactions workflow",
-        "What methods do I need for manage content reactions?"
-      ]
-    },
-    "trade-history": {
-      "key": "trade-history",
-      "label": "Trade history",
-      "description": "Trade history operations",
-      "category": "trades",
-      "methods": [
-        "getTrades"
-      ],
-      "mcpTools": [
-        "gala_launchpad_get_trades"
-      ],
-      "explanation": "\n## Trade History\n\nQuery and analyze trading activity for tokens.\n\n### Basic Usage\n\n```typescript\nimport { LaunchpadSDK } from '@gala-chain/launchpad-sdk';\n\nconst sdk = new LaunchpadSDK({ environment: 'production' });\n\n// Get recent trades for a token\nconst result = await sdk.getTrades({\n  tokenName: 'anime',\n  limit: 10,\n  page: 1\n});\n\nconsole.log(`Found ${result.trades.length} trades`);\nfor (const trade of result.trades) {\n  console.log(`${trade.txnType}: ${trade.inputAmount} → ${trade.outputAmount}`);\n}\n```\n\n### Filter by Trade Type\n\n```typescript\n// Get only buy orders\nconst buyTrades = await sdk.getTrades({\n  tokenName: 'anime',\n  txnType: 'BUY',\n  limit: 50\n});\n\n// Get only sell orders\nconst sellTrades = await sdk.getTrades({\n  tokenName: 'anime',\n  txnType: 'SELL',\n  limit: 50\n});\n```\n\n### Date Range Queries\n\n```typescript\nconst oneWeekAgo = new Date(Date.now() - 7 * 24 * 60 * 60 * 1000);\nconst now = new Date();\n\nconst recentTrades = await sdk.getTrades({\n  tokenName: 'anime',\n  startDate: oneWeekAgo,\n  endDate: now,\n  limit: 50\n});\n```\n\n### Filter by User\n\n```typescript\n// Get trades for a specific wallet\nconst userTrades = await sdk.getTrades({\n  tokenName: 'anime',\n  userAddress: 'eth|0x1234...',\n  limit: 20\n});\n```\n\n### Pagination\n\n```typescript\n// Paginate through all trades\nlet page = 1;\nlet hasMore = true;\n\nwhile (hasMore) {\n  const result = await sdk.getTrades({ tokenName: 'anime', page, limit: 50 });\n  console.log(`Page ${page}: ${result.trades.length} trades`);\n\n  hasMore = result.trades.length === 50;\n  page++;\n}\n```\n\n**MCP Tool Equivalents:**\n- `gala_launchpad_get_trades`\n",
-      "samplePrompts": [
-        "How do I view trading history?",
-        "Show me how to view trading history with the SDK",
-        "Explain the view trading history workflow",
-        "What methods do I need for view trading history?"
-      ]
-    },
-    "token-ban-management": {
-      "key": "token-ban-management",
-      "label": "Token ban management",
-      "description": "Token ban management operations",
-      "category": "token-ban",
-      "methods": [
-        "banToken",
-        "unbanToken",
-        "listTokenBans",
-        "getTokenBan",
-        "isTokenBanned"
-      ],
-      "mcpTools": [
-        "gala_launchpad_ban_token",
-        "gala_launchpad_unban_token",
-        "gala_launchpad_list_token_bans",
-        "gala_launchpad_get_token_ban",
-        "gala_launchpad_is_token_banned"
-      ],
-      "explanation": "\n# Token Ban Management - SDK v6.x.0+\n\nPlatform-wide token ban operations for overseers. Banned tokens are hidden from ALL listings\nand have actions (comments, streaming, chat) blocked. This is different from user bans which\nonly affect specific users on specific tokens.\n\n**Access Control:** All methods require either:\n- streamAdminApiKey (server-to-server)\n- JWT with overseer status (authenticated overseer user)\n\n**Effects of Token Bans:**\n- Hidden from ALL pool listings (including creator's profile)\n- Comments blocked on banned tokens\n- Live streaming blocked on banned tokens\n- Chat messages blocked on banned tokens\n- Trading NOT blocked (GalaChain handles trading independently)\n\n## Banning a Token\n\n```typescript\nimport { createLaunchpadSDK } from '@gala-chain/launchpad-sdk';\n\n// Using Admin API key\nconst sdk = createLaunchpadSDK({\n  streamAdminApiKey: process.env.STREAM_ADMIN_API_KEY,\n});\n\n// Or using JWT auth (must be an overseer)\nconst sdkWithAuth = createLaunchpadSDK({\n  privateKey: process.env.PRIVATE_KEY,\n});\nawait sdkWithAuth.login({ walletAddress: 'eth|0x...' });\n\n// Ban a token with reason\nconst result = await sdk.banToken({\n  tokenName: 'scamtoken',\n  reason: 'Fraudulent project - reported by multiple users',\n});\nconsole.log('Token banned:', result.tokenName);\nconsole.log('Ban ID:', result.ban.id);\nconsole.log('Banned by:', result.ban.bannedBy);\n\n// Ban without reason (optional)\nawait sdk.banToken({ tokenName: 'problematictoken' });\n```\n\n## Unbanning a Token\n\n```typescript\n// Remove a token ban\nconst result = await sdk.unbanToken({ tokenName: 'scamtoken' });\nconsole.log('Ban removed:', result.removed); // true\nconsole.log('Token:', result.tokenName);\n\n// Token is now:\n// - Visible in pool listings again\n// - Comments re-enabled\n// - Live streaming re-enabled\n// - Chat re-enabled\n```\n\n## Checking Token Ban Status\n\n```typescript\n// Check if a specific token is banned\nconst status = await sdk.isTokenBanned({ tokenName: 'sometoken' });\n\nif (status.banned) {\n  console.log('Token is banned!');\n  console.log('Reason:', status.ban?.reason);\n  console.log('Banned by:', status.ban?.bannedBy);\n  console.log('Banned at:', status.ban?.createdAt);\n} else {\n  console.log('Token is not banned');\n}\n\n// getTokenBan is an alias - use whichever is more readable\nconst details = await sdk.getTokenBan({ tokenName: 'sometoken' });\n```\n\n## Listing All Banned Tokens\n\n```typescript\n// Get first page with default limit (20)\nconst page1 = await sdk.listTokenBans({});\nconsole.log('Total banned tokens:', page1.meta.total);\n\nfor (const ban of page1.items) {\n  console.log(`- ${ban.tokenName}: ${ban.reason || 'No reason'}`);\n  console.log(`  Banned by: ${ban.bannedBy}`);\n  console.log(`  Date: ${ban.createdAt}`);\n}\n\n// Search for specific tokens (partial match, case-insensitive)\nconst searchResults = await sdk.listTokenBans({\n  search: 'scam',\n  page: 1,\n  limit: 10,\n});\n\n// Paginate through all banned tokens\nlet page = 1;\nlet hasMore = true;\nwhile (hasMore) {\n  const results = await sdk.listTokenBans({ page, limit: 20 });\n  console.log(`Page ${page}: ${results.items.length} bans`);\n  for (const ban of results.items) {\n    console.log(`  - ${ban.tokenName}`);\n  }\n  hasMore = page < results.meta.totalPages;\n  page++;\n}\n```\n\n## Important Notes\n\n1. **Permanent Bans Only**: Token bans do not expire. They remain in effect until\n   explicitly removed by an overseer.\n\n2. **Case Normalization**: Token names are automatically normalized to lowercase\n   in all requests and responses.\n\n3. **Idempotency**: Banning an already-banned token returns a 409 Conflict error.\n   Unbanning a non-banned token returns a 404 Not Found error.\n\n4. **Trading Continues**: Token bans do NOT stop trading on GalaChain. The\n   launchpad hides visibility and blocks social features only.\n\n**MCP Tool Equivalents:**\n- `gala_launchpad_ban_token`\n- `gala_launchpad_unban_token`\n- `gala_launchpad_list_token_bans`\n- `gala_launchpad_get_token_ban`\n- `gala_launchpad_is_token_banned`\n",
-      "samplePrompts": [
-        "How do I manage token bans?",
-        "Show me how to manage token bans with the SDK",
-        "Explain the manage token bans workflow",
-        "What methods do I need for manage token bans?"
-      ]
-    },
-    "nft-collection-management": {
-      "key": "nft-collection-management",
-      "label": "Nft collection management",
-      "description": "Nft collection management operations",
-      "category": "nft",
-      "methods": [
-        "getNftCollectionClaimFee",
-        "getNftTokenClassCreateFee",
-        "estimateNftMintFee",
-        "estimateNftOperationFees",
-        "isNftCollectionAvailable",
-        "claimNftCollection",
-        "fetchNftCollections",
-        "createNftTokenClass",
-        "fetchNftTokenClasses",
-        "mintNft",
-        "fetchNftBalances"
-      ],
-      "mcpTools": [
-        "gala_launchpad_get_nft_collection_claim_fee",
-        "gala_launchpad_get_nft_token_class_create_fee",
-        "gala_launchpad_estimate_nft_mint_fee",
-        "gala_launchpad_estimate_nft_operation_fees",
-        "gala_launchpad_claim_nft_collection",
-        "gala_launchpad_fetch_nft_collections",
-        "gala_launchpad_create_nft_token_class",
-        "gala_launchpad_fetch_nft_token_classes",
-        "gala_launchpad_mint_nft",
-        "gala_launchpad_fetch_nft_balances"
-      ],
-      "explanation": "\n# NFT Collection Management - SDK v5.12.0+\n\nCreate and manage NFT collections, token classes, and mint NFTs on GalaChain.\n\n**Key Concepts:**\n- **Collection**: A named grouping for NFT token classes (claimed for 10,000 GALA)\n- **Token Class**: A specific type/rarity within a collection (created for 1,000 GALA)\n- **NFT Instance**: Individual NFT minted from a token class (dynamic fee based on quantity)\n\n## Check Collection Availability\n\n```typescript\nimport { createLaunchpadSDK } from '@gala-chain/launchpad-sdk';\n\nconst sdk = createLaunchpadSDK({ privateKey: 'your-private-key' });\n\n// Check if a collection name is available\nconst available = await sdk.isNftCollectionAvailable('MyEpicNFTs');\nconsole.log('Collection available:', available);\n\n// Get fee for claiming a collection\nconst claimFee = await sdk.getNftCollectionClaimFee();\nconsole.log('Claim fee:', claimFee); // Usually \"10000\" GALA\n```\n\n## Claim a Collection\n\n```typescript\n// Claim an available collection name\nconst result = await sdk.claimNftCollection({\n  collectionName: 'MyEpicNFTs',\n  description: 'Epic NFT collection for gaming',\n});\nconsole.log('Collection claimed:', result.collectionName);\nconsole.log('Transaction ID:', result.transactionId);\n\n// Fetch your owned collections\nconst collections = await sdk.fetchNftCollections(walletAddress);\nfor (const collection of collections) {\n  console.log(`Collection: ${collection.collectionName}`);\n  console.log(`  Status: ${collection.status}`);\n}\n```\n\n## Create Token Classes (Rarities)\n\n```typescript\n// Get fee for creating a token class\nconst classCreateFee = await sdk.getNftTokenClassCreateFee();\nconsole.log('Create fee:', classCreateFee); // Usually \"1000\" GALA\n\n// Create a token class (rarity tier)\nconst classResult = await sdk.createNftTokenClass({\n  collectionName: 'MyEpicNFTs',\n  tokenClassName: 'LegendaryWizard',\n  description: 'Ultra-rare legendary wizard NFTs',\n  maximumSupply: '100',  // Max NFTs of this type\n  data: {\n    rarity: 'legendary',\n    class: 'wizard',\n    power: '9000',\n  },\n});\nconsole.log('Token class created:', classResult.tokenClassName);\n\n// Fetch token classes for your collection\nconst classes = await sdk.fetchNftTokenClasses({\n  collectionName: 'MyEpicNFTs',\n});\nfor (const tokenClass of classes) {\n  console.log(`Class: ${tokenClass.tokenClassName}`);\n  console.log(`  Current Supply: ${tokenClass.currentSupply}/${tokenClass.maxSupply}`);\n}\n```\n\n## Estimate Mint Fees\n\n```typescript\n// Estimate fee for minting multiple NFTs\nconst mintFeeEstimate = await sdk.estimateNftMintFee({\n  collectionName: 'MyEpicNFTs',\n  tokenClassName: 'LegendaryWizard',\n  quantity: 5,\n});\nconsole.log('Estimated mint fee:', mintFeeEstimate); // Dynamic fee in GALA\n\n// Estimate multiple operations at once\nconst bundleFee = await sdk.estimateNftOperationFees({\n  operations: [\n    { type: 'claim_collection' },\n    { type: 'create_token_class', collectionName: 'MyEpicNFTs' },\n    { type: 'mint', quantity: 10 },\n  ],\n});\nconsole.log('Total bundle fee:', bundleFee.totalFee);\nfor (const op of bundleFee.breakdown) {\n  console.log(`  ${op.operationType}: ${op.fee}`);\n}\n```\n\n## Mint NFTs\n\n```typescript\n// Mint NFT instances from a token class\nconst mintResult = await sdk.mintNft({\n  collectionName: 'MyEpicNFTs',\n  tokenClassName: 'LegendaryWizard',\n  quantity: 5,\n  to: 'eth|0x...', // Recipient wallet\n  metadata: {\n    attributes: [\n      { name: 'level', value: '50' },\n      { name: 'element', value: 'fire' },\n    ],\n  },\n});\nconsole.log('Minted:', mintResult.quantityMinted);\nconsole.log('Transaction ID:', mintResult.transactionId);\n\n// Check NFT balances\nconst balances = await sdk.fetchNftBalances(walletAddress);\nfor (const balance of balances) {\n  console.log(`${balance.collectionName}/${balance.tokenClassName}: ${balance.quantity}`);\n}\n\n// Filter by collection\nconst collectionBalances = await sdk.fetchNftBalances(walletAddress, 'MyEpicNFTs');\n```\n\n## Complete Workflow\n\n```typescript\n// 1. Check availability\nconst available = await sdk.isNftCollectionAvailable('MyEpicNFTs');\nif (!available) throw new Error('Collection name taken');\n\n// 2. Claim collection (10,000 GALA)\nconst claimResult = await sdk.claimNftCollection({\n  collectionName: 'MyEpicNFTs',\n  description: 'My epic NFT collection',\n});\nconsole.log('✓ Collection claimed');\n\n// 3. Create token class (1,000 GALA)\nconst classResult = await sdk.createNftTokenClass({\n  collectionName: 'MyEpicNFTs',\n  tokenClassName: 'Legendary',\n  description: 'Legendary tier NFTs',\n  maximumSupply: '1000',\n});\nconsole.log('✓ Token class created');\n\n// 4. Estimate mint fee\nconst fee = await sdk.estimateNftMintFee({\n  collectionName: 'MyEpicNFTs',\n  tokenClassName: 'Legendary',\n  quantity: 100,\n});\nconsole.log(`✓ Mint fee: ${fee} GALA`);\n\n// 5. Mint NFTs\nconst mintResult = await sdk.mintNft({\n  collectionName: 'MyEpicNFTs',\n  tokenClassName: 'Legendary',\n  quantity: 100,\n  to: userWallet,\n});\nconsole.log('✓ Minted:', mintResult.quantityMinted);\n\n// 6. Verify ownership\nconst balances = await sdk.fetchNftBalances(userWallet, 'MyEpicNFTs');\nconsole.log('Total NFTs:', balances.reduce((sum, b) => sum + parseInt(b.quantity), 0));\n```\n\n**MCP Tool Equivalents:**\n- `gala_launchpad_get_nft_collection_claim_fee`\n- `gala_launchpad_get_nft_token_class_create_fee`\n- `gala_launchpad_estimate_nft_mint_fee`\n- `gala_launchpad_estimate_nft_operation_fees`\n- `gala_launchpad_check_nft_collection_available`\n- `gala_launchpad_claim_nft_collection`\n- `gala_launchpad_fetch_nft_collections`\n- `gala_launchpad_create_nft_token_class`\n- `gala_launchpad_fetch_nft_token_classes`\n- `gala_launchpad_mint_nft`\n- `gala_launchpad_fetch_nft_balances`\n",
-      "samplePrompts": [
-        "How do I nft collection management?",
-        "Show me how to nft collection management with the SDK",
-        "Explain the nft collection management workflow",
-        "What methods do I need for nft collection management?"
-      ]
-    }
-  },
-  "categories": {
-    "trading": {
-      "label": "Trading",
-      "topics": [
-        "buy-tokens",
-        "sell-tokens",
-        "pool-graduation",
-        "local-calculations",
-        "trading-analytics"
-      ]
-    },
-    "pools": {
-      "label": "Pools",
-      "topics": [
-        "fetch-pools",
-        "token-details",
-        "token-distribution",
-        "price-history"
-      ]
-    },
-    "balance": {
-      "label": "Balances",
-      "topics": [
-        "balances",
-        "profile-management",
-        "account-management"
-      ]
-    },
-    "utils": {
-      "label": "Utilities",
-      "topics": [
-        "token-creation",
-        "token-status",
-        "multi-wallet",
-        "error-handling",
-        "installation",
-        "spot-prices-smart-routing",
-        "liquidity-positions",
-        "utilities-and-helpers",
-        "mcp-to-sdk-mapping"
-      ]
-    },
-    "transfers": {
-      "label": "Transfers",
-      "topics": [
-        "transfers"
-      ]
-    },
-    "locks": {
-      "label": "Locks",
-      "topics": [
-        "locks"
-      ]
-    },
-    "dex": {
-      "label": "DEX Trading",
-      "topics": [
-        "dex-trading"
-      ]
-    },
-    "dex-pools": {
-      "label": "DEX Pools",
-      "topics": [
-        "advanced-dex-analysis",
-        "fetch-dex-pools",
-        "dex-token-discovery"
-      ]
-    },
-    "wallet": {
-      "label": "Wallet",
-      "topics": [
-        "utilities-system"
-      ]
-    },
-    "dex-analytics": {
-      "label": "DEX Analytics",
-      "topics": [
-        "fetch-all-dex-seasons",
-        "fetch-current-dex-season",
-        "fetch-dex-leaderboard-by-season-id",
-        "fetch-current-dex-leaderboard",
-        "fetch-dex-aggregated-volume-summary"
-      ]
-    },
-    "chat": {
-      "label": "Chat",
-      "topics": [
-        "event-subscriptions"
-      ]
-    },
-    "bridge": {
-      "label": "Bridge",
-      "topics": [
-        "bridge-operations",
-        "wrap-unwrap-operations"
-      ]
-    },
-    "referrals": {
-      "label": "Referrals",
-      "topics": [
-        "referral-system"
-      ]
-    },
-    "auth": {
-      "label": "Auth",
-      "topics": [
-        "session-auth"
-      ]
-    },
-    "streaming": {
-      "label": "Live Stream",
-      "topics": [
-        "streaming"
-      ]
-    },
-    "chat-messages": {
-      "label": "Chat Messages",
-      "topics": [
-        "stream-chat"
-      ]
-    },
-    "ban": {
-      "label": "Ban Management",
-      "topics": [
-        "ban-management"
-      ]
-    },
-    "api-keys": {
-      "label": "API Keys",
-      "topics": [
-        "api-key-management"
-      ]
-    },
-    "moderators": {
-      "label": "Moderators",
-      "topics": [
-        "moderator-invites"
-      ]
-    },
-    "overseers": {
-      "label": "Overseers",
-      "topics": [
-        "overseer-invites"
-      ]
-    },
-    "content-flags": {
-      "label": "Content Flags",
-      "topics": [
-        "content-flag-management"
-      ]
-    },
-    "content-reactions": {
-      "label": "Reactions",
-      "topics": [
-        "content-reactions"
-      ]
-    },
-    "trades": {
-      "label": "Trade History",
-      "topics": [
-        "trade-history"
-      ]
-    },
-    "token-ban": {
-      "label": "Token Ban",
-      "topics": [
-        "token-ban-management"
-      ]
-    },
-    "nft": {
-      "label": "NFT Collections",
-      "topics": [
-        "nft-collection-management"
-      ]
-    }
-  },
-  "sampleConversations": [
-    {
-      "id": "buy-tokens-demo",
-      "title": "Example: Buy tokens",
-      "topic": "buy-tokens",
-      "messages": [
-        {
-          "role": "user",
-          "content": "How do I buy tokens?"
-        },
-        {
-          "role": "assistant",
-          "content": "\n## Buying Tokens with SDK\n\n**Covers Methods:**\n- `calculateBuyAmount()`\n- `buy()`\n\n```typescript\nimport { createLaunchpadSDK } from '@gala-chain/launchpad-sdk';\n\nasync function buyTokens() {\n  // 1. Create SDK instance\n  const sdk = createLaunchpadSDK({\n    wallet: 'your-private-key-or-mnemonic'\n  });\n\n  // 2. Calculate expected amounts FIRST (REQUIRED)\n  const calculation = await sdk.calculateBuyAmount({\n    tokenName: 'dragnrkti',\n    amount: '100',      // Spending 100 GALA\n    type: 'native'      // 'native' = GALA amount, 'exact' = token amount\n  });\n\n  console.log('Expected tokens:', calculation.amount);\n  console.log('RBC Fee:', calculation.reverseBondingCurveFee);\n  console.log('Transaction fee:', calculation.transactionFee);\n\n  // 3. Execute buy with slippage protection\n  const result = await sdk.buy({\n    tokenName: 'dragnrkti',\n    amount: '100',\n    type: 'native',\n    expectedAmount: calculation.amount,  // REQUIRED: from step 2\n    maxAcceptableReverseBondingCurveFee: calculation.reverseBondingCurveFee, // RECOMMENDED\n    slippageToleranceFactor: 0.01  // 1% slippage tolerance (REQUIRED)\n  });\n\n  console.log('Transaction ID:', result.transactionId);\n  console.log('GALA spent:', result.inputAmount);\n  console.log('Tokens received:', result.outputAmount);\n  console.log('Total fees:', result.totalFees);\n}\n```\n\n**MCP Tool Equivalent:** `gala_launchpad_buy_tokens`\n"
-        }
-      ]
-    },
-    {
-      "id": "fetch-pools-demo",
-      "title": "Example: Fetch pools",
-      "topic": "fetch-pools",
-      "messages": [
-        {
-          "role": "user",
-          "content": "How do I fetch and search token pools?"
-        },
-        {
-          "role": "assistant",
-          "content": "\n## Fetching Pool Data with Advanced Methods\n\n**Covers Methods:**\n- `fetchPools()`\n- `fetchAllPools()`\n- `fetchPoolDetails()`\n- `fetchPoolDetailsForCalculation()`\n- `fetchVolumeData()`\n- `fetchTokenPrice()`\n- `fetchTokenDistribution()`\n- `fetchTokenBadges()`\n- `resolveVaultAddress()`\n- `resolveTokenClassKey()`\n\n```typescript\nimport { createLaunchpadSDK, compareAmounts } from '@gala-chain/launchpad-sdk';\n\n// 1. BASIC POOL FETCHING - With Pagination\nasync function basicPoolFetching() {\n  const sdk = createLaunchpadSDK({ wallet: 'your-private-key' });\n\n  // Fetch recent pools with pagination\n  const pools = await sdk.fetchPools({\n    type: 'recent',\n    limit: 10,\n    page: 1\n  });\n\n  console.log(`Found ${pools.total} pools, page ${pools.page} of ${pools.totalPages}`);\n  pools.pools.forEach(pool => {\n    console.log(`${pool.tokenName}: ${pool.tokenSymbol}`);\n  });\n}\n\n// 2. AUTO-PAGINATED FETCHING - Get ALL Pools\nasync function fetchAllPools() {\n  const sdk = createLaunchpadSDK({ wallet: 'your-private-key' });\n\n  // Auto-paginated - returns all pools without manual pagination\n  const allPools = await sdk.fetchAllPools({\n    type: 'recent'\n  });\n\n  console.log(`Total pools: ${allPools.pools.length}`);\n}\n\n// 3. POOL DETAILS - Complete information\nasync function getPoolDetails(tokenName) {\n  const sdk = createLaunchpadSDK({ wallet: 'your-private-key' });\n\n  const details = await sdk.fetchPoolDetails(tokenName);\n\n  console.log('Sale status:', details.saleStatus); // 'Ongoing' or 'Completed'\n  console.log('Base price:', details.basePrice);\n  console.log('Max supply:', details.maxSupply);\n  console.log('Remaining tokens:', details.sellingTokenQuantity);\n}\n\n// 4. POOL DETAILS FOR CALCULATIONS - Optimized for math\nasync function getOptimizedPoolDetails(tokenName) {\n  const sdk = createLaunchpadSDK({ wallet: 'your-private-key' });\n\n  // Returns only fields needed for bonding curve calculations\n  const poolData = await sdk.fetchPoolDetailsForCalculation(tokenName);\n\n  console.log('Current supply:', poolData.currentSupply);\n  console.log('Remaining tokens:', poolData.remainingTokens);\n  console.log('Max supply:', poolData.maxSupply);\n  console.log('Reverse bonding curve max fee:', poolData.reverseBondingCurveMaxFeeFactor);\n}\n\n// 5. VOLUME & OHLCV DATA - Historical candlestick data\nasync function getVolumeData(tokenName) {\n  const sdk = createLaunchpadSDK({ wallet: 'your-private-key' });\n\n  // Different resolutions: '1m', '5m', '15m', '1h', '4h', '1d'\n  const volumeData = await sdk.fetchVolumeData({\n    tokenName: tokenName,\n    from: new Date(Date.now() - 7 * 24 * 60 * 60 * 1000), // Last 7 days\n    to: new Date(),\n    resolution: '1h' // 1-hour candlesticks\n  });\n\n  volumeData.forEach(candle => {\n    console.log(`${candle.time}: O:${candle.open} H:${candle.high} L:${candle.low} C:${candle.close} V:${candle.volume}`);\n  });\n}\n\n// 6. SPOT PRICES - DEX tokens (GALA, SILK, MUSIC)\nasync function getDexTokenPrices() {\n  const sdk = createLaunchpadSDK({ wallet: 'your-private-key' });\n\n  // Fetch prices for multiple DEX tokens\n  const prices = await sdk.fetchTokenPrice(['GALA', 'SILK', 'MUSIC']);\n\n  console.log(`GALA: $${prices.GALA}`);\n  console.log(`SILK: $${prices.SILK}`);\n  console.log(`MUSIC: $${prices.MUSIC}`);\n}\n\n// 7. LAUNCHPAD TOKEN SPOT PRICES (via smart router)\nasync function getLaunchpadTokenPrice(tokenName) {\n  const sdk = createLaunchpadSDK({ wallet: 'your-private-key' });\n\n  // Get USD spot price for a launchpad token (anime, woohoo, etc.)\n  const price = await sdk.fetchTokenPrice({ tokenName });\n\n  console.log(`${tokenName} price: $${price.price}`);\n}\n\n// 8. RESOLVE UTILITY ADDRESSES\nasync function resolveAddresses(tokenName) {\n  const sdk = createLaunchpadSDK({ wallet: 'your-private-key' });\n\n  // Get GalaChain vault address for token\n  const vaultAddress = await sdk.resolveVaultAddress(tokenName);\n  console.log(`Vault address: ${vaultAddress}`);\n\n  // Get TokenClassKey for token\n  const tokenClassKey = await sdk.resolveTokenClassKey(tokenName);\n  console.log(`TokenClassKey: ${tokenClassKey}`);\n}\n\n// 9. COMPLETE INVESTMENT ANALYSIS WORKFLOW\nasync function analyzeToken(tokenName) {\n  const sdk = createLaunchpadSDK({ wallet: 'your-private-key' });\n\n  // Get all token data in parallel\n  const [details, volumeData, distribution, badges] = await Promise.all([\n    sdk.fetchPoolDetails(tokenName),\n    sdk.fetchVolumeData({ tokenName, resolution: '1d' }),\n    sdk.fetchTokenDistribution(tokenName),\n    sdk.fetchTokenBadges(tokenName)\n  ]);\n\n  // Analyze status\n  console.log(`Pool Status: ${details.saleStatus}`);\n  console.log(`Supply: ${details.currentSupply} / ${details.maxSupply}`);\n\n  // Analyze volume trend\n  // Note: For analytics/aggregation, we use safeParseFloat for performance. For trades, use BigNumber via SDK\n  const volumes = volumeData.map(v => safeParseFloat(v.volume, 0));\n  const avgVolume = volumes.reduce((a, b) => a + b, 0) / volumes.length;\n  console.log(`Avg daily volume: $${toBigNumberFixed(avgVolume, 2)}`);\n\n  // Analyze distribution\n  // Use compareAmounts for precise balance comparisons\n  const top5Ownership = distribution.holders\n    .sort((a, b) => compareAmounts(b.balance, a.balance) > 0 ? 1 : -1)\n    .slice(0, 5)\n    .reduce((sum, h) => sum + h.percentage, 0);\n  console.log(`Top 5 holders: ${toBigNumberFixed(top5Ownership, 2)}%`);\n\n  // Check badges\n  console.log(`Badges: ${badges.join(', ')}`);\n}\n```\n\n**MCP Tool Equivalents:**\n- `gala_launchpad_fetch_pools` - Paginated pool list\n- `gala_launchpad_fetch_all_pools` - Auto-paginated all pools\n- `gala_launchpad_fetch_pool_details` - Complete pool information\n- `gala_launchpad_fetch_pool_details_for_calculation` - Optimized for calculations\n- `gala_launchpad_fetch_volume_data` - OHLCV candlestick data\n- `gala_launchpad_fetch_token_spot_price` - DEX token prices (GALA, SILK, MUSIC)\n- `gala_launchpad_fetch_launchpad_token_spot_price` - Launchpad token USD prices\n- `gala_launchpad_fetch_token_distribution` - Token holder analysis\n- `gala_launchpad_fetch_token_badges` - Achievement badges\n- `gala_launchpad_resolve_vault_address` - Get vault address\n- `gala_launchpad_resolve_token_class_key` - Get TokenClassKey\n"
-        }
-      ]
-    },
-    {
-      "id": "balances-demo",
-      "title": "Example: Balances",
-      "topic": "balances",
-      "messages": [
-        {
-          "role": "user",
-          "content": "How do I check token balances?"
-        },
-        {
-          "role": "assistant",
-          "content": "\n## Checking Balances with SDK\n\n**Covers Methods:**\n- `fetchGalaBalance()`\n- `fetchTokenBalance()`\n- `fetchTokensHeld()`\n- `fetchTokensCreated()`\n- `fetchProfile()`\n\n```typescript\nimport { createLaunchpadSDK } from '@gala-chain/launchpad-sdk';\n\nasync function checkBalances() {\n  const sdk = createLaunchpadSDK({\n    wallet: 'your-private-key'\n  });\n\n  // Check GALA balance\n  const galaBalance = await sdk.fetchGalaBalance();\n  console.log(`GALA: ${galaBalance.balance}`);\n  console.log(`Decimals: ${galaBalance.decimals}`);\n  console.log(`Last updated: ${galaBalance.lastUpdated.toISOString()}`);\n\n  // Check specific token balance\n  const tokenBalance = await sdk.fetchTokenBalance({\n    tokenName: 'dragnrkti',\n    address: sdk.getAddress()\n  });\n\n  console.log(`Token: ${tokenBalance.quantity}`);\n  console.log(`USD value: $${tokenBalance.holdingPriceUsd}`);\n  console.log(`GALA value: ${tokenBalance.holdingPriceGala}`);\n\n  // Check all tokens held\n  const portfolio = await sdk.fetchTokensHeld({\n    address: sdk.getAddress(),\n    limit: 20\n  });\n\n  console.log(`Holding ${portfolio.total} different tokens`);\n  portfolio.tokens.forEach(token => {\n    console.log(`${token.name}: ${token.quantity}`);\n  });\n\n  // Check tokens created by this wallet\n  const createdTokens = await sdk.fetchTokensCreated({\n    address: sdk.getAddress(),\n    limit: 10\n  });\n\n  console.log(`Created ${createdTokens.total} tokens`);\n  createdTokens.tokens.forEach(token => {\n    console.log(`  ${token.symbol}: ${token.name}`);\n  });\n\n  // Get user profile\n  const profile = await sdk.fetchProfile();\n  console.log(`Profile: ${profile.fullName}`);\n\n  // Check profile of another user\n  const otherProfile = await sdk.fetchProfile('eth|0x...');\n  console.log(`Other user: ${otherProfile.fullName}`);\n}\n```\n\n**MCP Tool Equivalents:**\n- `gala_launchpad_fetch_gala_balance`\n- `gala_launchpad_fetch_token_balance`\n- `gala_launchpad_fetch_tokens_held`\n- `gala_launchpad_fetch_tokens_created`\n- `gala_launchpad_fetch_profile`\n- `gala_launchpad_fetch_available_balance`\n- `gala_launchpad_fetch_locked_tokens`\n\n### Available vs Locked Balance\n\n```typescript\n// Get available balance (excludes locked/escrowed tokens)\nconst available = await sdk.fetchAvailableBalance({\n  tokenName: 'anime',\n  address: walletAddress\n});\n\n// Get locked tokens with details\nconst locked = await sdk.fetchLockedTokens({\n  tokenName: 'anime',\n  address: walletAddress\n});\n\nconsole.log('Available:', available.quantity);\nconsole.log('Locked:', locked.lockedQuantity);\n```\n"
-        }
-      ]
-    },
-    {
-      "id": "token-creation-demo",
-      "title": "Example: Token creation",
-      "topic": "token-creation",
-      "messages": [
-        {
-          "role": "user",
-          "content": "How do I create and launch new tokens?"
-        },
-        {
-          "role": "assistant",
-          "content": "\n## Creating Tokens with SDK\n\n**Covers Methods:**\n- `isTokenNameAvailable()`\n- `isTokenSymbolAvailable()`\n- `fetchLaunchTokenFee()`\n- `uploadTokenImage()`\n- `launchToken()`\n\n```typescript\nimport { createLaunchpadSDK } from '@gala-chain/launchpad-sdk';\n\nasync function launchToken() {\n  const sdk = createLaunchpadSDK({\n    wallet: 'your-private-key'\n  });\n\n  // 1. Check if name/symbol available\n  const nameAvailable = await sdk.isTokenNameAvailable('mytoken');\n  const symbolAvailable = await sdk.isTokenSymbolAvailable('MTK');\n\n  if (!nameAvailable || !symbolAvailable) {\n    throw new Error('Name or symbol already taken');\n  }\n\n  // 2. Check launch fee\n  const launchFee = await sdk.fetchLaunchTokenFee();\n  console.log(`Launch fee: ${launchFee} GALA`);\n\n  // 3. Upload token image (Node.js only)\n  const imageUpload = await sdk.uploadTokenImage({\n    tokenName: 'mytoken',\n    imagePath: '/path/to/image.png'\n  });\n\n  // 4. Launch the token\n  const result = await sdk.launchToken({\n    tokenName: 'mytoken',\n    tokenSymbol: 'MTK',\n    tokenDescription: 'My awesome token',\n    tokenImage: imageUpload.imageUrl,\n    websiteUrl: 'https://mytoken.com',\n    twitterUrl: 'https://twitter.com/mytoken',\n    preBuyQuantity: '100'  // Optional: pre-buy with GALA\n  });\n\n  console.log('Token launched!');\n  console.log('Transaction ID:', result.transactionId);\n\n  // Get frontend URL\n  const url = sdk.getUrlByTokenName('mytoken');\n  console.log(`View at: ${url}`);\n}\n```\n\n**MCP Tool Equivalents:**\n- `gala_launchpad_check_token_name`\n- `gala_launchpad_check_token_symbol`\n- `gala_launchpad_fetch_launch_token_fee`\n- `gala_launchpad_upload_token_image`\n- `gala_launchpad_launch_token`\n- `gala_launchpad_get_url_by_token_name`\n"
-        }
-      ]
-    },
-    {
-      "id": "transfers-demo",
-      "title": "Example: Transfers",
-      "topic": "transfers",
-      "messages": [
-        {
-          "role": "user",
-          "content": "How do I transfer tokens?"
-        },
-        {
-          "role": "assistant",
-          "content": "\n## Token Transfers with SDK\n\n**Covers Methods:**\n- `transferGala()`\n- `transferToken()`\n\n```typescript\nimport { createLaunchpadSDK } from '@gala-chain/launchpad-sdk';\n\nasync function transferTokens() {\n  const sdk = createLaunchpadSDK({\n    wallet: 'your-private-key'\n  });\n\n  // Transfer GALA tokens\n  const galaTransfer = await sdk.transferGala({\n    recipientAddress: '0x1234...', // or 'eth|1234...'\n    amount: '100',\n    uniqueKey: 'galaconnect-operation-my-transfer-123'  // Optional idempotency\n  });\n\n  console.log('GALA transfer ID:', galaTransfer.transactionId);\n  console.log('Status:', galaTransfer.status);\n\n  // Transfer launchpad tokens\n  const tokenTransfer = await sdk.transferToken({\n    to: 'eth|5678...',\n    tokenName: 'dragnrkti',\n    amount: '1000',  // Token amount\n    uniqueKey: 'galaconnect-operation-token-456'\n  });\n\n  console.log('Token transfer ID:', tokenTransfer.transactionId);\n}\n```\n\n**Features:**\n- EIP-712 signatures for security\n- Supports both `0x` and `eth|` address formats\n- Optional idempotency keys prevent duplicates\n- Comprehensive validation\n\n**MCP Tool Equivalents:**\n- `gala_launchpad_transfer_gala`\n- `gala_launchpad_transfer_token`\n"
-        }
-      ]
-    },
-    {
-      "id": "locks-demo",
-      "title": "Example: Locks",
-      "topic": "locks",
-      "messages": [
-        {
-          "role": "user",
-          "content": "How do I lock and unlock tokens?"
-        },
-        {
-          "role": "assistant",
-          "content": "\n## Token Locking, Unlocking, and Burning with SDK\n\n**Covers Methods:**\n- `lockTokens()` - Lock one or more token types in a single transaction\n- `unlockTokens()` - Unlock one or more token types in a single transaction\n- `burnTokens()` - Permanently destroy tokens (IRREVERSIBLE)\n- `fetchLockedBalance()` - Query locked token balances with hold details\n\nLock, unlock, and burn tokens on GalaChain for staking, escrow, vesting, or token management.\n\n```typescript\nimport { createLaunchpadSDK } from '@gala-chain/launchpad-sdk';\n\nasync function tokenLockingAndBurning() {\n  const sdk = createLaunchpadSDK({\n    wallet: 'your-private-key'\n  });\n\n  // ============================================================================\n  // LOCK TOKENS - Single token (batch API wraps single token)\n  // ============================================================================\n\n  // Lock 1000 tokens with default options (caller is lock authority)\n  const lockResult = await sdk.lockTokens({\n    tokens: [{\n      tokenName: 'anime',\n      amount: '1000'\n    }]\n  });\n\n  console.log('Lock transaction ID:', lockResult.transactionId);\n  console.log('Locked entries:', lockResult.locked);\n\n  // ============================================================================\n  // LOCK TOKENS - Multiple tokens in one transaction (batch)\n  // ============================================================================\n\n  // Lock multiple token types atomically\n  const batchLock = await sdk.lockTokens({\n    tokens: [\n      { tokenName: 'anime', amount: '500' },\n      { tokenName: 'dragon', amount: '200' },\n      { tokenName: 'mystic', amount: '100', lockAuthority: 'eth|0x1234...' }\n    ]\n  });\n\n  console.log('Batch lock completed:', batchLock.locked.length, 'tokens locked');\n\n  // ============================================================================\n  // LOCK TOKENS - Advanced options\n  // ============================================================================\n\n  // Lock with custom lock authority (another address can unlock)\n  const escrowLock = await sdk.lockTokens({\n    tokens: [{\n      tokenName: 'anime',\n      amount: '500',\n      lockAuthority: 'eth|0x1234...',  // Escrow agent address\n      name: 'escrow-payment-001',       // Identifier for matching during unlock\n      expires: Date.now() + 30 * 24 * 60 * 60 * 1000  // Auto-release in 30 days\n    }]\n  });\n\n  console.log('Escrow lock created');\n\n  // Lock for time-based vesting\n  const vestingLock = await sdk.lockTokens({\n    tokens: [{\n      tokenName: 'anime',\n      amount: '10000',\n      name: 'vesting-q1-2025',\n      expires: new Date('2025-04-01').getTime()  // Auto-unlock on April 1st\n    }]\n  });\n\n  console.log('Vesting lock created with expiry');\n\n  // ============================================================================\n  // UNLOCK TOKENS - Release locked tokens\n  // ============================================================================\n\n  // Unlock tokens (must be called by lock authority)\n  const unlockResult = await sdk.unlockTokens({\n    tokens: [{\n      tokenName: 'anime',\n      amount: '500'\n    }]\n  });\n\n  console.log('Unlock transaction ID:', unlockResult.transactionId);\n  console.log('Unlocked entries:', unlockResult.unlocked);\n\n  // Unlock multiple tokens in one transaction\n  const batchUnlock = await sdk.unlockTokens({\n    tokens: [\n      { tokenName: 'anime', amount: '500' },\n      { tokenName: 'dragon', amount: '200', name: 'escrow-payment-001' }\n    ]\n  });\n\n  console.log('Batch unlock completed');\n\n  // ============================================================================\n  // BURN TOKENS - Permanently destroy (IRREVERSIBLE!)\n  // ============================================================================\n\n  // WARNING: Burn operations are permanent and cannot be undone!\n  const burnResult = await sdk.burnTokens({\n    tokens: [{\n      tokenName: 'anime',\n      amount: '100'\n    }]\n  });\n\n  console.log('Burn transaction ID:', burnResult.transactionId);\n  console.log('Burned:', burnResult.burned);\n\n  // Batch burn multiple token types\n  const batchBurn = await sdk.burnTokens({\n    tokens: [\n      { tokenName: 'anime', amount: '50' },\n      { tokenName: 'oldtoken', amount: '1000' }  // Clean up deprecated tokens\n    ]\n  });\n\n  console.log('Batch burn completed:', batchBurn.burned.length, 'token types burned');\n\n  // ============================================================================\n  // QUERY LOCKED TOKENS - Check lock status\n  // ============================================================================\n\n  const lockedTokens = await sdk.fetchLockedBalance({\n    tokenName: 'anime',\n    address: sdk.getAddress()\n  });\n\n  console.log('Locked quantity:', lockedTokens.lockedQuantity);\n  console.log('Active holds:', lockedTokens.holds);\n\n  // Each hold contains: lockAuthority, expires, name, quantity\n  for (const hold of lockedTokens.holds) {\n    console.log(`  - ${hold.quantity} locked by ${hold.lockAuthority}`);\n    if (hold.expires) console.log(`    Expires: ${new Date(hold.expires)}`);\n    if (hold.name) console.log(`    Name: ${hold.name}`);\n  }\n\n  // ============================================================================\n  // STAKING WORKFLOW EXAMPLE\n  // ============================================================================\n\n  async function stakingWorkflow() {\n    // Step 1: Lock tokens for staking period\n    const stake = await sdk.lockTokens({\n      tokens: [{\n        tokenName: 'anime',\n        amount: '5000',\n        name: 'staking-period-1',\n        expires: Date.now() + 90 * 24 * 60 * 60 * 1000  // 90-day staking period\n      }]\n    });\n\n    console.log('Staked 5000 tokens for 90 days');\n\n    // Step 2: After staking period expires, unlock\n    const unstake = await sdk.unlockTokens({\n      tokens: [{\n        tokenName: 'anime',\n        amount: '5000',\n        name: 'staking-period-1'\n      }]\n    });\n\n    console.log('Unstaked tokens after staking period');\n    return { stake, unstake };\n  }\n\n  // ============================================================================\n  // ESCROW WORKFLOW EXAMPLE\n  // ============================================================================\n\n  async function escrowWorkflow(buyerAddress: string, sellerAddress: string) {\n    // Step 1: Buyer locks payment in escrow (seller is lock authority)\n    const escrow = await sdk.lockTokens({\n      tokens: [{\n        tokenName: 'anime',\n        amount: '1000',\n        lockAuthority: sellerAddress,  // Seller can release upon delivery\n        name: 'order-12345'\n      }]\n    });\n\n    console.log('Escrow created: seller can release payment upon delivery');\n\n    // Step 2: Seller releases escrow after delivery (seller calls unlock)\n    // This would be executed by the seller's SDK instance\n    // const release = await sellerSdk.unlockTokens({\n    //   tokens: [{ tokenName: 'anime', amount: '1000', name: 'order-12345' }]\n    // });\n\n    return escrow;\n  }\n}\n```\n\n**Key Features:**\n- **Batch Operations**: Lock/unlock/burn multiple token types in one transaction\n- **Lock Authority**: Specify who can unlock (defaults to caller)\n- **Expiration**: Optional auto-release timestamp for time-based vesting\n- **Named Locks**: Use `name` to identify specific locks for targeted unlocks\n- **EIP-712 Signatures**: Secure blockchain transactions\n- **Error Handling**: `LockError` and `BurnError` classes with specific error types\n\n**Lock Parameters (per token in array):**\n| Parameter | Required | Description |\n|-----------|----------|-------------|\n| `tokenName` | Yes* | Token to lock (e.g., 'anime') |\n| `tokenId` | Yes* | Alternative: TokenClassKey or pipe-delimited string |\n| `amount` | Yes | Amount of tokens to lock |\n| `lockAuthority` | No | Address that can unlock (defaults to caller) |\n| `expires` | No | Timestamp in ms for auto-unlock |\n| `name` | No | Identifier for matching during unlock |\n\n*Either `tokenName` or `tokenId` required\n\n**Unlock Parameters (per token in array):**\n| Parameter | Required | Description |\n|-----------|----------|-------------|\n| `tokenName` | Yes* | Token to unlock (e.g., 'anime') |\n| `tokenId` | Yes* | Alternative: TokenClassKey or pipe-delimited string |\n| `amount` | Yes | Amount of tokens to unlock |\n| `name` | No | Lock name to match (if used during lock) |\n\n**Burn Parameters (per token in array):**\n| Parameter | Required | Description |\n|-----------|----------|-------------|\n| `tokenName` | Yes* | Token to burn (e.g., 'anime') |\n| `tokenId` | Yes* | Alternative: TokenClassKey or pipe-delimited string |\n| `amount` | Yes | Amount of tokens to burn (PERMANENT!) |\n\n**Use Cases:**\n- **Staking**: Lock tokens for rewards/governance\n- **Escrow**: Third-party controlled releases\n- **Vesting**: Time-based token releases\n- **Governance**: Lock tokens for voting power\n- **Token Retirement**: Permanently burn deprecated tokens\n- **Deflationary Mechanics**: Reduce supply via burns\n\n**MCP Tool Equivalents:**\n- `gala_launchpad_lock_tokens` (batch)\n- `gala_launchpad_unlock_tokens` (batch)\n- `gala_launchpad_burn_tokens` (batch)\n- `gala_launchpad_fetch_locked_tokens`\n"
-        }
-      ]
-    },
-    {
-      "id": "dex-trading-demo",
-      "title": "Example: Dex trading",
-      "topic": "dex-trading",
-      "messages": [
-        {
-          "role": "user",
-          "content": "How do I trade tokens on GalaSwap?"
-        },
-        {
-          "role": "assistant",
-          "content": "\n## DEX Trading with SDK - GalaSwap Integration\n\n**Covers Methods:**\n- `getSwapQuoteExactInput()`\n- `getSwapQuoteExactOutput()`\n- `executeSwap()`\n- `getSwapUserAssets()`\n- `getAllSwapUserAssets()`\n- `getSwapPoolInfo()`\n\nTrade graduated tokens on the GalaSwap DEX with real-time WebSocket monitoring:\n\n```typescript\nimport { createLaunchpadSDK } from '@gala-chain/launchpad-sdk';\n\nasync function dexTradingExample() {\n  // 1. Initialize SDK with wallet\n  const sdk = createLaunchpadSDK({\n    wallet: 'your-private-key',\n    env: 'production'\n  });\n\n  // ============================================================================\n  // QUOTES: Get pricing information (read-only operations)\n  // ============================================================================\n\n  // Quote 1: Exact input (spend known GALA amount)\n  const quoteIn = await sdk.getSwapQuoteExactInput('GALA', 'GUSDC', '100');\n  console.log('Spend 100 GALA → get ~' + quoteIn.estimatedOutput + ' GUSDC');\n  console.log('Price impact: ' + quoteIn.priceImpact + '%');\n  console.log('Fee tier: ' + quoteIn.feeTier + ' bps');\n\n  // Quote 2: Exact output (get known token amount)\n  const quoteOut = await sdk.getSwapQuoteExactOutput('GALA', 'GUSDC', '100');\n  console.log('Get exactly 100 GUSDC → need ~' + quoteOut.inputAmount + ' GALA');\n\n  // ============================================================================\n  // EXECUTE: Perform the swap with slippage protection\n  // ============================================================================\n\n  const result = await sdk.executeSwap(\n    'GALA',                       // from token\n    'GUSDC',                      // to token\n    '100',                        // input amount (100 GALA)\n    quoteIn.estimatedOutput,      // Use quote's output!\n    quoteIn.feeTier,              // Use quote's fee tier!\n    0.01                          // 1% slippage tolerance\n  );\n\n  console.log('Transaction ID: ' + result.transactionId);\n  console.log('Status: ' + result.status);\n  console.log('Received: ' + result.outputAmount + ' ' + result.toToken);\n\n  // ============================================================================\n  // PORTFOLIO: Check balances and assets\n  // ============================================================================\n\n  const assets = await sdk.getSwapUserAssets(sdk.getEthereumAddress());\n  console.log('Assets in wallet:');\n  assets.forEach(asset => {\n    console.log('  ' + asset.symbol + ': ' + asset.balance);\n  });\n\n  // ============================================================================\n  // PORTFOLIO: Get ALL assets (auto-paginated)\n  // ============================================================================\n\n  const allAssets = await sdk.getAllSwapUserAssets(sdk.getEthereumAddress());\n  console.log('Complete asset portfolio:');\n  console.log('Total assets: ' + allAssets.length);\n  allAssets.forEach(asset => {\n    console.log('  ' + asset.symbol + ': ' + asset.balance);\n  });\n\n  // ============================================================================\n  // POOL INFO: Check liquidity before trading\n  // ============================================================================\n\n  const pool = await sdk.getSwapPoolInfo('GALA', 'GUSDC');\n  console.log('GALA↔GUSDC Pool Info:');\n  console.log('  Liquidity: ' + pool.liquidity);\n  console.log('  Available fee tiers: ' + pool.feeTiers.join(', ') + ' bps');\n  console.log('  24h swaps: ' + pool.swapCount);\n}\n```\n\n**Key Architecture:**\n- **Unified WebSocket**: Uses LaunchpadSDK's unified WebSocket for transaction monitoring\n- **Environment Alignment**: STAGE/PROD URLs must match between LaunchpadSDK and GSwapService\n- **Token Formats**:\n  - **Launchpad bonding curve**: Use `tokenName` (lowercase simple symbols like 'anime', 'dragon')\n  - **DEX trading**: Use `tokenId` (pipe-delimited format like 'GALA|Unit|none|none', 'GUSDC|Unit|none|eth:0x...')\n- **Slippage Protection**: Always use quote values for execution\n- **Fee Tiers**: 500 (0.05%), 3000 (0.30%), 10000 (1.00%)\n- **Auto-Pagination**: Use `getAllSwapUserAssets()` for complete portfolio\n\n**MCP Tool Equivalents:**\n- `gala_launchpad_get_swap_quote_exact_input`\n- `gala_launchpad_get_swap_quote_exact_output`\n- `gala_launchpad_execute_swap`\n- `gala_launchpad_get_swap_user_assets`\n- `gala_launchpad_get_all_swap_user_assets`\n- `gala_launchpad_get_swap_pool_info`\n"
-        }
-      ]
-    },
-    {
-      "id": "advanced-dex-analysis-demo",
-      "title": "Example: Advanced dex analysis",
-      "topic": "advanced-dex-analysis",
-      "messages": [
-        {
-          "role": "user",
-          "content": "How do I analyze DEX trading data?"
-        },
-        {
-          "role": "assistant",
-          "content": "\n## Advanced DEX Pool Analysis with SDK\n\n**Covers Methods:**\n- `fetchCompositePoolData()`\n- `calculateDexPoolQuoteExactAmountLocal()`\n- `calculateDexPoolQuoteExactAmountExternal()`\n- `calculateDexPoolQuoteExactAmount()`\n\nThis workflow demonstrates analyzing graduated tokens using composite data and price calculations.\n\n**Use Cases:**\n- Arbitrage opportunity detection\n- Price impact analysis before large trades\n- Comparing bonding curve vs DEX pricing\n- Smart routing for best execution\n\n```typescript\nimport { createLaunchpadSDK } from '@gala-chain/launchpad-sdk';\n\nasync function advancedDexAnalysis() {\n  const sdk = createLaunchpadSDK({ environment: 'production' });\n\n  // Step 1: Get composite pool data (bonding curve + DEX if graduated)\n  const composite = await sdk.fetchCompositePoolData('anime');\n\n  if (composite.isGraduated) {\n    console.log('Token graduated to DEX!');\n    console.log('DEX Pool TVL:', composite.dexPool.tvl);\n    console.log('DEX 24h Volume:', composite.dexPool.volume1d);\n  }\n\n  // Step 2: Compare local vs external price calculations\n  const localQuote = await sdk.calculateDexPoolQuoteExactAmountLocal(\n    'GALA|Unit|none|none',\n    'anime|Unit|none|eth:0x...',\n    '100'\n  );\n\n  const externalQuote = await sdk.calculateDexPoolQuoteExactAmountExternal(\n    'GALA|Unit|none|none',\n    'anime|Unit|none|eth:0x...',\n    '100'\n  );\n\n  console.log('Local calculation:', localQuote.outputAmount);\n  console.log('External API:', externalQuote.outputAmount);\n  console.log('Price difference:',\n    Math.abs(safeParseFloat(localQuote.outputAmount, 0) - safeParseFloat(externalQuote.outputAmount, 0))\n  );\n\n  // Step 3: Use smart routing for best price\n  const bestQuote = await sdk.calculateDexPoolQuoteExactAmount(\n    'GALA|Unit|none|none',\n    'anime|Unit|none|eth:0x...',\n    '100'\n  );\n\n  console.log('Best route:', bestQuote.route); // 'local' or 'external'\n  console.log('Best price:', bestQuote.outputAmount);\n}\n```\n\n**MCP Tools:**\n- `gala_launchpad_fetch_composite_pool_data`\n- `gala_launchpad_calculate_dex_pool_quote_exact_amount_local`\n- `gala_launchpad_calculate_dex_pool_quote_exact_amount_external`\n- `gala_launchpad_calculate_dex_pool_quote_exact_amount`\n"
-        }
-      ]
-    },
-    {
-      "id": "utilities-system-demo",
-      "title": "Example: Utilities system",
-      "topic": "utilities-system",
-      "messages": [
-        {
-          "role": "user",
-          "content": "How do I access system utilities?"
-        },
-        {
-          "role": "assistant",
-          "content": "\n## SDK Configuration and Wallet Utilities\n\n**Covers Methods:**\n- `getAddress()`\n- `getConfig()`\n- `getEthereumAddress()`\n- `getUrlByTokenName()`\n- `getVersion()`\n- `getWallet()`\n- `hasWallet()`\n- `setWallet()`\n\nEssential utilities for SDK configuration, wallet management, and system information.\n\n```typescript\nimport { createLaunchpadSDK } from '@gala-chain/launchpad-sdk';\n\nasync function sdkUtilities() {\n  // ============================================================================\n  // ADDRESS MANAGEMENT - Get wallet addresses in different formats\n  // ============================================================================\n\n  const sdk = createLaunchpadSDK({ wallet: 'your-private-key' });\n\n  // Get GalaChain address (eth|0x... format)\n  const galaAddress = sdk.getAddress();\n  console.log(`GalaChain address: ${galaAddress}`); // \"eth|0x1234...\"\n\n  // Get Ethereum address (0x... format)\n  const ethAddress = sdk.getEthereumAddress();\n  console.log(`Ethereum address: ${ethAddress}`); // \"0x1234...\"\n\n  // ============================================================================\n  // WALLET MANAGEMENT - Check and update wallet\n  // ============================================================================\n\n  // Check if SDK has wallet configured\n  if (sdk.hasWallet()) {\n    console.log('Wallet configured - can execute trades');\n\n    // Get wallet instance (for advanced use)\n    const wallet = sdk.getWallet();\n    console.log(`Wallet address: ${wallet.address}`);\n  } else {\n    console.log('Read-only mode - cannot execute trades');\n  }\n\n  // Update wallet at runtime\n  sdk.setWallet('new-private-key');\n  console.log(`New address: ${sdk.getAddress()}`);\n\n  // ============================================================================\n  // CONFIGURATION ACCESS - Get SDK config\n  // ============================================================================\n\n  // Get SDK configuration\n  const config = sdk.getConfig();\n  console.log(`Base URL: ${config.baseUrl}`);\n  console.log(`Environment: ${config.env}`);\n  console.log(`Debug: ${config.debug}`);\n  console.log(`Timeout: ${config.timeout}ms`);\n\n  // ============================================================================\n  // VERSION INFORMATION - Get SDK version\n  // ============================================================================\n\n  // Get SDK version\n  const version = sdk.getVersion();\n  console.log(`SDK Version: ${version}`); // \"4.0.4-beta.0\"\n\n  // ============================================================================\n  // URL GENERATION - Get frontend URLs for tokens\n  // ============================================================================\n\n  // Generate frontend URL for token\n  const url = sdk.getUrlByTokenName('anime');\n  console.log(`Token URL: ${url}`);\n  // \"https://launchpad.gala.com/token/anime\" (production)\n  // \"https://lpad-dev1.defi.gala.com/token/anime\" (development)\n\n  // Complete workflow: Launch token + share URL\n  const launchResult = await sdk.launchToken({\n    tokenName: 'mytoken',\n    tokenSymbol: 'MTK',\n    tokenDescription: 'My awesome token'\n  });\n\n  const tokenUrl = sdk.getUrlByTokenName('mytoken');\n  console.log(`Share your token: ${tokenUrl}`);\n\n  // ============================================================================\n  // MULTI-WALLET SCENARIO - Check multiple addresses\n  // ============================================================================\n\n  async function compareWallets() {\n    const wallet1 = createLaunchpadSDK({ wallet: 'private-key-1' });\n    const wallet2 = createLaunchpadSDK({ wallet: 'private-key-2' });\n\n    console.log(`Wallet 1: ${wallet1.getAddress()}`);\n    console.log(`Wallet 2: ${wallet2.getAddress()}`);\n\n    // Compare balances\n    const balance1 = await wallet1.fetchGalaBalance();\n    const balance2 = await wallet2.fetchGalaBalance();\n\n    console.log(`Wallet 1 balance: ${balance1.balance}`);\n    console.log(`Wallet 2 balance: ${balance2.balance}`);\n  }\n\n  // ============================================================================\n  // READ-ONLY SDK - Public data without wallet\n  // ============================================================================\n\n  async function readOnlyMode() {\n    // Create SDK without wallet (read-only mode)\n    const readOnlySdk = createLaunchpadSDK();\n\n    console.log(`Has wallet: ${readOnlySdk.hasWallet()}`); // false\n\n    // Can fetch public data\n    const pools = await readOnlySdk.fetchPools({ type: 'recent', limit: 10 });\n    console.log(`Found ${pools.total} pools`);\n\n    // Cannot execute trades (will throw error)\n    try {\n      await readOnlySdk.buy({ tokenName: 'anime', amount: '100', type: 'native' });\n    } catch (error) {\n      console.error('Cannot trade without wallet');\n    }\n  }\n\n  // ============================================================================\n  // ENVIRONMENT SWITCHING - Change environments at runtime\n  // ============================================================================\n\n  async function switchEnvironments() {\n    // Production SDK\n    const prodSdk = createLaunchpadSDK({\n      wallet: 'your-private-key',\n      config: { env: 'production' }\n    });\n\n    console.log(`Prod config: ${prodSdk.getConfig().baseUrl}`);\n    console.log(`Prod URL: ${prodSdk.getUrlByTokenName('anime')}`);\n\n    // Development SDK\n    const devSdk = createLaunchpadSDK({\n      wallet: 'your-private-key',\n      config: { env: 'development' }\n    });\n\n    console.log(`Dev config: ${devSdk.getConfig().baseUrl}`);\n    console.log(`Dev URL: ${devSdk.getUrlByTokenName('anime')}`);\n  }\n}\n```\n\n**Key Methods:**\n\n| Method | Returns | Use Case |\n|--------|---------|----------|\n| `getAddress()` | GalaChain address (eth|0x...) | Trading, transfers, profile |\n| `getEthereumAddress()` | Ethereum address (0x...) | DEX trading, external systems |\n| `getConfig()` | SDK configuration object | Debug, environment info |\n| `getVersion()` | SDK version string | Compatibility checks |\n| `getUrlByTokenName()` | Frontend URL | Share token pages |\n| `getWallet()` | Wallet instance | Advanced wallet operations |\n| `hasWallet()` | Boolean | Check if trades enabled |\n| `setWallet()` | void | Update wallet at runtime |\n\n**MCP Tool Equivalents:**\n- `gala_launchpad_get_address`\n- `gala_launchpad_get_ethereum_address`\n- `gala_launchpad_get_config`\n- `gala_launchpad_get_version`\n- `gala_launchpad_get_url_by_token_name`\n"
-        }
-      ]
-    },
-    {
-      "id": "fetch-all-dex-seasons-demo",
-      "title": "Example: Fetch all dex seasons",
-      "topic": "fetch-all-dex-seasons",
-      "messages": [
-        {
-          "role": "user",
-          "content": "How do I fetch DEX leaderboard seasons?"
-        },
-        {
-          "role": "assistant",
-          "content": "\n## DEX Leaderboard Seasons Management\n\n**Covers Methods:**\n- `fetchAllDexSeasons()`\n- `fetchCurrentDexSeason()`\n\nDiscover and manage DEX leaderboard seasons for competitive trading events.\n\n```typescript\nimport { createLaunchpadSDK } from '@gala-chain/launchpad-sdk';\n\nasync function manageDexSeasons() {\n  const sdk = createLaunchpadSDK({ wallet: 'your-private-key' });\n\n  // Fetch all available seasons\n  const seasons = await sdk.fetchAllDexSeasons();\n\n  // Display season information\n  seasons.forEach(season => {\n    console.log(`Season: ${season.name} (ID: ${season.id})`);\n    console.log(`Duration: ${season.start} to ${season.end}`);\n  });\n\n  // Get current season\n  const activeSeason = await sdk.fetchCurrentDexSeason();\n  if (activeSeason) {\n    console.log(`Active: ${activeSeason.name}`);\n  } else {\n    console.log('No active season (between seasons)');\n  }\n\n  // Verify season is active\n  const now = new Date();\n  const isActive = activeSeason && now >= activeSeason.start && now <= activeSeason.end;\n  console.log(`Season active: ${isActive}`);\n}\n```\n\n**MCP Tool Equivalents:**\n- `gala_launchpad_fetch_all_dex_seasons`\n- `gala_launchpad_fetch_current_dex_season`\n"
-        }
-      ]
-    },
-    {
-      "id": "event-subscriptions-demo",
-      "title": "Example: Event subscriptions",
-      "topic": "event-subscriptions",
-      "messages": [
-        {
-          "role": "user",
-          "content": "How do I subscribe to real-time events?"
-        },
-        {
-          "role": "assistant",
-          "content": "\n## Real-Time Event Subscriptions and Monitoring\n\n**Covers Methods:**\n- `subscribeToDexLiquidityAdded()`\n- `subscribeToDexLiquidityChanged()`\n- `subscribeToDexLiquidityRemoved()`\n- `subscribeToDexPoolAdded()`\n- `subscribeToDexSwapExecuted()`\n- `subscribeToTokenCreations()`\n\nSubscribe to real-time WebSocket events for DEX trading, liquidity changes, and token launches.\n\n```typescript\nimport { createLaunchpadSDK, compareAmounts } from '@gala-chain/launchpad-sdk';\n\nasync function subscribeToEvents() {\n  const sdk = createLaunchpadSDK({ wallet: 'your-private-key' });\n\n  // ============================================================================\n  // LIQUIDITY EVENTS - Monitor position changes\n  // ============================================================================\n\n  // Subscribe to liquidity additions\n  const cleanupAdded = sdk.subscribeToDexLiquidityAdded((event) => {\n    console.log('Liquidity added!');\n    console.log(`  Pool: ${event.token0}-${event.token1}`);\n    console.log(`  Amount0: ${event.amount0}`);\n    console.log(`  Amount1: ${event.amount1}`);\n    console.log(`  Owner: ${event.owner}`);\n    console.log(`  Position ID: ${event.positionId}`);\n  });\n\n  // Subscribe to liquidity changes (compound events)\n  const cleanupChanged = sdk.subscribeToDexLiquidityChanged((event) => {\n    console.log('Liquidity changed!');\n    console.log(`  Type: ${event.type}`); // 'added', 'removed', 'modified'\n    console.log(`  Pool: ${event.token0}-${event.token1}`);\n    console.log(`  Delta: ${event.liquidityDelta}`);\n  });\n\n  // Subscribe to liquidity removals\n  const cleanupRemoved = sdk.subscribeToDexLiquidityRemoved((event) => {\n    console.log('Liquidity removed!');\n    console.log(`  Pool: ${event.token0}-${event.token1}`);\n    console.log(`  Amount0: ${event.amount0}`);\n    console.log(`  Amount1: ${event.amount1}`);\n    console.log(`  Owner: ${event.owner}`);\n    console.log(`  Fees collected: ${event.fees0}, ${event.fees1}`);\n  });\n\n  // ============================================================================\n  // POOL EVENTS - Monitor new DEX pools\n  // ============================================================================\n\n  // Subscribe to new DEX pool creation\n  const cleanupPool = sdk.subscribeToDexPoolAdded((pool) => {\n    console.log('New DEX pool created!');\n    console.log(`  Token: ${pool.tokenName}`);\n    console.log(`  Token0: ${pool.token0}`);\n    console.log(`  Token1: ${pool.token1}`);\n    console.log(`  Fee Tier: ${pool.feeTier}`);\n    console.log(`  Initial TVL: ${pool.tvl}`);\n\n    // Auto-provide liquidity to new pools\n    sdk.addSwapLiquidityByPrice({\n      token0: pool.token0,\n      token1: pool.token1,\n      fee: pool.feeTier,\n      minPrice: '0.95',\n      maxPrice: '1.05',\n      amount0Desired: '1000',\n      amount1Desired: '1000'\n    }).then(() => console.log('Liquidity provided to new pool'));\n  });\n\n  // ============================================================================\n  // SWAP EVENTS - Monitor all DEX swaps\n  // ============================================================================\n\n  // Subscribe to DEX swap executions\n  const cleanupSwap = sdk.subscribeToDexSwapExecuted((swap) => {\n    console.log('DEX swap executed!');\n    console.log(`  Pair: ${swap.tokenIn} → ${swap.tokenOut}`);\n    console.log(`  Amount In: ${swap.amountIn}`);\n    console.log(`  Amount Out: ${swap.amountOut}`);\n    console.log(`  Trader: ${swap.trader}`);\n    console.log(`  Fee Tier: ${swap.feeTier}`);\n\n    // Track volume and price impact\n    const priceImpact = calculatePriceImpact(swap.amountIn, swap.amountOut);\n    console.log(`  Price impact: ${priceImpact}%`);\n  });\n\n  // ============================================================================\n  // TOKEN CREATION EVENTS - Monitor new token launches\n  // ============================================================================\n\n  // Subscribe to new token launches\n  const cleanupToken = sdk.subscribeToTokenCreations((token) => {\n    console.log('New token launched!');\n    console.log(`  Name: ${token.tokenName}`);\n    console.log(`  Symbol: ${token.tokenSymbol}`);\n    console.log(`  Creator: ${token.creator}`);\n    console.log(`  Max Supply: ${token.maxSupply}`);\n    console.log(`  Base Price: ${token.basePrice}`);\n\n    // Auto-buy new tokens\n    sdk.buy({\n      tokenName: token.tokenName,\n      amount: '100',\n      type: 'native',\n      slippageToleranceFactor: 0.01\n    }).then(() => console.log('Auto-bought new token'));\n  });\n\n  // ============================================================================\n  // ARBITRAGE BOT EXAMPLE - Multi-event monitoring\n  // ============================================================================\n\n  async function arbitrageBot() {\n    const sdk = createLaunchpadSDK({ wallet: 'your-private-key' });\n\n    // Track all swaps for arbitrage opportunities\n    sdk.subscribeToDexSwapExecuted(async (swap) => {\n      // Check if price divergence exists\n      const poolPrice = await sdk.getSwapPoolPrice(swap.tokenIn, swap.tokenOut);\n      const externalPrice = await getExternalPrice(swap.tokenIn, swap.tokenOut);\n\n      const divergence = Math.abs(poolPrice - externalPrice) / externalPrice;\n\n      if (divergence > 0.01) {\n        // 1% arbitrage opportunity\n        console.log(`Arbitrage opportunity: ${divergence * 100}%`);\n\n        // Execute arbitrage trade\n        await sdk.executeSwap(\n          swap.tokenOut,\n          swap.tokenIn,\n          calculateArbitrageAmount(divergence),\n          '0', // min output\n          3000, // fee tier\n          0.01 // slippage\n        );\n      }\n    });\n\n    // Monitor liquidity additions for new opportunities\n    sdk.subscribeToDexLiquidityAdded(async (event) => {\n      console.log(`New liquidity in ${event.token0}-${event.token1}`);\n\n      // Check if pool has sufficient depth for arbitrage\n      const poolInfo = await sdk.getSwapPoolInfo(event.token0, event.token1);\n      // Use compareAmounts for precise liquidity threshold comparison\n      if (compareAmounts(poolInfo.liquidity, '100000') > 0) {\n        console.log('Pool has sufficient liquidity for arbitrage');\n      }\n    });\n  }\n\n  // ============================================================================\n  // LIQUIDITY PROVIDER BOT - Auto-manage positions\n  // ============================================================================\n\n  async function liquidityProviderBot() {\n    const sdk = createLaunchpadSDK({ wallet: 'your-private-key' });\n\n    // Auto-add liquidity to new pools\n    sdk.subscribeToDexPoolAdded(async (pool) => {\n      console.log(`New pool: ${pool.tokenName}`);\n\n      // Wait for some initial swaps to establish price\n      setTimeout(async () => {\n        const poolInfo = await sdk.getSwapPoolInfo(pool.token0, pool.token1);\n\n        // Add liquidity if TVL is high enough\n        // Use compareAmounts for precise liquidity threshold comparison\n        if (compareAmounts(poolInfo.liquidity, '50000') > 0) {\n          await sdk.addSwapLiquidityByPrice({\n            token0: pool.token0,\n            token1: pool.token1,\n            fee: pool.feeTier,\n            minPrice: '0.9',\n            maxPrice: '1.1',\n            amount0Desired: '10000',\n            amount1Desired: '10000'\n          });\n\n          console.log('Liquidity added to new pool');\n        }\n      }, 60000); // Wait 1 minute\n    });\n\n    // Monitor liquidity removals (potential exit signal)\n    sdk.subscribeToDexLiquidityRemoved((event) => {\n      console.log(`Large liquidity removal: ${event.amount0}, ${event.amount1}`);\n\n      // Check if we should also exit\n      if (isLargeRemoval(event)) {\n        console.log('Large removal detected - consider exiting position');\n      }\n    });\n  }\n\n  // Keep subscriptions running\n  console.log('Subscriptions active... Press Ctrl+C to stop');\n  await new Promise(() => {}); // Run forever\n\n  // Cleanup when done\n  cleanupAdded();\n  cleanupChanged();\n  cleanupRemoved();\n  cleanupPool();\n  cleanupSwap();\n  cleanupToken();\n}\n```\n\n**Event Data Structures:**\n\n**LiquidityAdded:**\n- token0, token1, feeTier\n- amount0, amount1\n- owner, positionId\n- timestamp\n\n**LiquidityRemoved:**\n- token0, token1, feeTier\n- amount0, amount1\n- fees0, fees1\n- owner, positionId\n- timestamp\n\n**DexPoolAdded:**\n- tokenName, token0, token1\n- feeTier, tvl\n- timestamp\n\n**SwapExecuted:**\n- tokenIn, tokenOut\n- amountIn, amountOut\n- trader, feeTier\n- priceImpact\n- timestamp\n\n**TokenCreation:**\n- tokenName, tokenSymbol\n- creator, maxSupply\n- basePrice\n- timestamp\n\n**Use Cases:**\n- **Arbitrage Bots**: Monitor swaps for price divergence\n- **Liquidity Management**: Auto-provide liquidity to new pools\n- **Early Bird Trading**: Buy new tokens immediately after launch\n- **Position Monitoring**: Track liquidity changes in your positions\n- **Market Analysis**: Analyze trading patterns and volumes\n\n### WebSocket Connection Lifecycle\n\n```typescript\n// Handle connection lifecycle events\nawait sdk.connectStreamWebSocket({\n  onConnect: () => {\n    console.log('WebSocket connected');\n  },\n  onDisconnect: (reason) => {\n    console.log('WebSocket disconnected:', reason);\n    // Implement reconnection logic if needed\n  },\n  onError: (error) => {\n    console.error('WebSocket error:', error);\n  }\n});\n\n// Check connection state\nif (sdk.isStreamWebSocketConnected()) {\n  console.log('Ready to send/receive messages');\n}\n```\n\n### Typing Indicators\n\n```typescript\n// Subscribe to typing indicators in chat\nawait sdk.connectStreamWebSocket({\n  onTypingIndicator: (event) => {\n    if (event.isTyping) {\n      console.log(`${event.userAddress} is typing...`);\n    } else {\n      console.log(`${event.userAddress} stopped typing`);\n    }\n  }\n});\n\n// Send typing start indicator\nawait sdk.sendTypingStart({\n  tokenName: 'anime'\n});\n\n// Later: Send typing stop indicator\nawait sdk.sendTypingStop({\n  tokenName: 'anime'\n});\n```\n\n**MCP Tool Equivalents:**\n- `gala_launchpad_subscribe_to_dex_liquidity_added`\n- `gala_launchpad_subscribe_to_dex_liquidity_changed`\n- `gala_launchpad_subscribe_to_dex_liquidity_removed`\n- `gala_launchpad_subscribe_to_dex_pool_added`\n- `gala_launchpad_subscribe_to_dex_swap_executed`\n- `gala_launchpad_subscribe_to_token_creations`\n"
-        }
-      ]
-    },
-    {
-      "id": "bridge-operations-demo",
-      "title": "Example: Bridge operations",
-      "topic": "bridge-operations",
-      "messages": [
-        {
-          "role": "user",
-          "content": "How do I bridge tokens across chains?"
-        },
-        {
-          "role": "assistant",
-          "content": "\n## Cross-Chain Bridge Operations with SDK\n\n**Covers Methods:**\n- `estimateBridgeFee()`\n- `bridgeOut()`\n- `bridgeIn()`\n- `getBridgeStatus()`\n- `getSupportedBridgeTokens()`\n- `getEthereumTransactionStatus()`\n- `getSolanaTransactionStatus()`\n- `fetchEthereumWalletTokenBalance()` / `fetchSolanaWalletTokenBalance()`\n- `fetchEthereumWalletNativeBalance()` / `fetchSolanaWalletNativeBalance()`\n- `fetchEthereumWalletAllBalances()` / `fetchSolanaWalletAllBalances()`\n- `fetchBridgeableTokensByNetwork()` / `fetchAllBridgeableTokensByNetwork()`\n- `fetchAllTokensBridgeableToEthereum()` / `fetchAllTokensBridgeableToSolana()`\n- `isTokenBridgeableToNetwork()` / `isTokenBridgeableToEthereum()` / `isTokenBridgeableToSolana()`\n- `requestSolanaDevnetAirdrop()`\n\n```typescript\nimport { createLaunchpadSDK } from '@gala-chain/launchpad-sdk';\n\nasync function bridgeOperations() {\n  // 1. Create SDK with wallet configuration\n  const sdk = createLaunchpadSDK({\n    privateKey: '0xabcd...',\n    environment: 'production',  // or 'staging' for testnet\n  });\n\n  // 2. Get supported bridge tokens\n  const supportedTokens = await sdk.getSupportedBridgeTokens('Ethereum');\n  console.log('Bridgeable to Ethereum:', supportedTokens.map(t => t.symbol));\n\n  // 3. Check if specific token is bridgeable\n  const canBridge = await sdk.isTokenBridgeableToEthereum('GALA');\n  console.log('GALA bridgeable to Ethereum:', canBridge.bridgeable);\n\n  // 4. Estimate bridge fee (calculated externally by GalaConnect API)\n  const fee = await sdk.estimateBridgeFee({\n    tokenId: 'GALA|Unit|none|none',\n    destinationChain: 'Ethereum',\n    amount: '100',\n  });\n  console.log('Bridge fee:', fee.totalFee, 'GALA');\n\n  // 5. Bridge Out: GalaChain → Ethereum\n  const bridgeOutTx = await sdk.bridgeOut({\n    tokenId: 'GALA|Unit|none|none',\n    amount: '100',\n    destinationChain: 'Ethereum',\n    recipientAddress: '0x5678...',\n  });\n  console.log('Bridge out TX:', bridgeOutTx.transactionHash);\n\n  // 6. Get bridge status\n  const status = await sdk.getBridgeStatus(bridgeOutTx.transactionHash);\n  console.log('Bridge status:', status.status);\n\n  // 7. Get Ethereum transaction status\n  const ethTxStatus = await sdk.getEthereumTransactionStatus(bridgeOutTx.transactionHash);\n  console.log('ETH TX confirmed:', ethTxStatus.confirmed);\n\n  // 8. Query external chain balances\n  const ethBalance = await sdk.fetchEthereumWalletNativeBalance();\n  const galaEthBalance = await sdk.fetchEthereumWalletTokenBalance('GALA');\n  const allEthBalances = await sdk.fetchEthereumWalletAllBalances();\n\n  // 9. Discover all bridgeable tokens\n  const allBridgeable = await sdk.fetchAllBridgeableTokensByNetwork('ETHEREUM');\n  console.log('All tokens bridgeable to Ethereum:', allBridgeable.length);\n}\n```\n\n**Supported Tokens:**\n- **Ethereum:** GALA, GWETH, GUSDC, GUSDT, GWTRX, GWBTC\n- **Solana:** GALA, GSOL\n\n**Environment Configuration:**\n- `PROD`: Ethereum Mainnet, Solana Mainnet\n- `STAGE`: Ethereum Sepolia, Solana Devnet\n\n**MCP Tool Equivalents:**\n- `gala_launchpad_bridge_estimate_fee`\n- `gala_launchpad_bridge_out`\n- `gala_launchpad_bridge_in`\n- `gala_launchpad_bridge_status`\n- `gala_launchpad_bridge_ethereum_balance`\n- `gala_launchpad_bridge_ethereum_all_balances`\n- `gala_launchpad_bridge_solana_balance`\n- `gala_launchpad_bridge_solana_all_balances`\n"
-        }
-      ]
-    },
-    {
-      "id": "referral-system-demo",
-      "title": "Example: Referral system",
-      "topic": "referral-system",
-      "messages": [
-        {
-          "role": "user",
-          "content": "How do I manage referral rewards?"
-        },
-        {
-          "role": "assistant",
-          "content": "\n# Referral System\n\nThe SDK provides methods for managing referral URLs and tracking referral activity.\n\n## Get Your Referral URL\n\n```typescript\nimport { createLaunchpadSDK } from '@gala-chain/launchpad-sdk';\n\nasync function getReferralUrl() {\n  const sdk = createLaunchpadSDK({ wallet: 'your-private-key' });\n\n  // Get your unique referral URL\n  const result = await sdk.fetchReferralUrl();\n  console.log('Share this URL:', result.referralUrl);\n}\n```\n\n## Fetch Referrals (Paginated)\n\n```typescript\nasync function fetchReferrals() {\n  const sdk = createLaunchpadSDK({ wallet: 'your-private-key' });\n\n  // Paginated referral list\n  const referrals = await sdk.fetchReferrals({\n    address: '0x...',  // Optional, defaults to SDK wallet\n    page: 1,\n    limit: 20\n  });\n\n  console.log('Total referrals:', referrals.total);\n  referrals.items.forEach(ref => {\n    console.log(`Referred: ${ref.referredAddress} on ${ref.createdAt}`);\n  });\n}\n```\n\n## Fetch All Referrals (Auto-Paginated)\n\n```typescript\nasync function fetchAllReferrals() {\n  const sdk = createLaunchpadSDK({ wallet: 'your-private-key' });\n\n  // Get ALL referrals with auto-pagination\n  const allReferrals = await sdk.fetchAllReferrals({ address: '0x...' });\n  console.log('Total referrals:', allReferrals.length);\n}\n```\n\n## Referral Summary\n\n```typescript\nasync function getReferralSummary() {\n  const sdk = createLaunchpadSDK({ wallet: 'your-private-key' });\n\n  const summary = await sdk.fetchReferralsSummary({ address: '0x...' });\n  console.log('Total referred users:', summary.totalReferrals);\n  console.log('Total rewards earned:', summary.totalRewards);\n}\n```\n\n**MCP Tool Equivalents:**\n- `gala_launchpad_fetch_referral_url`\n- `gala_launchpad_fetch_referrals`\n- `gala_launchpad_fetch_all_referrals`\n- `gala_launchpad_fetch_referrals_summary`\n"
-        }
-      ]
-    },
-    {
-      "id": "session-auth-demo",
-      "title": "Example: Session auth",
-      "topic": "session-auth",
-      "messages": [
-        {
-          "role": "user",
-          "content": "How do I manage JWT authentication?"
-        },
-        {
-          "role": "assistant",
-          "content": "\n# Session Authentication (JWT) - SDK v5.1.0+\n\nJWT-based session authentication for protected operations (streaming, chat, profile updates).\n\n## Authentication Flow\n\n```typescript\nimport { createLaunchpadSDK } from '@gala-chain/launchpad-sdk';\n\nconst sdk = createLaunchpadSDK({\n  privateKey: process.env.PRIVATE_KEY,\n  environment: 'production',\n});\n\n// 1. Login to get JWT token\nconst session = await sdk.login();\nconsole.log('Authenticated:', session.address);\nconsole.log('Token expires in:', session.expiresIn, 'seconds');\n\n// 2. Check authentication status\nif (sdk.isAuthenticated()) {\n  console.log('Session is valid');\n}\n\n// 3. Get current session info\nconst info = await sdk.getSession();\nconsole.log('Session issued at:', info.issuedAt);\nconsole.log('Session expires at:', info.expiresAt);\n\n// 4. Access token directly (for custom requests)\nconst token = sdk.getAccessToken();\nconsole.log('JWT token:', token);\n\n// 5. Refresh token before expiry\nif (sdk.shouldRefreshToken()) {\n  const refreshed = await sdk.refreshToken();\n  console.log('Token refreshed, new expiry:', refreshed.expiresIn);\n}\n\n// 6. Ensure valid token (auto-refreshes if needed)\nconst validToken = await sdk.ensureValidToken();\nconsole.log('Valid token obtained');\n\n// 7. Logout when done\nsdk.logout();\nconsole.log('Logged out');\n```\n\n## Auto-Refresh Behavior\n\nThe SDK automatically refreshes tokens when:\n- Token expires within 5 minutes (default threshold)\n- Making requests to JWT-protected endpoints\n\n```typescript\n// Manual refresh threshold check\nconst shouldRefresh = sdk.shouldRefreshToken(10 * 60 * 1000); // 10 min threshold\n\n// ensureValidToken auto-refreshes if needed\nconst token = await sdk.ensureValidToken(5 * 60 * 1000); // 5 min threshold\n```\n\n## Protected Endpoints\n\nThese operations require JWT authentication (call \\`login()\\` first):\n\n**Streaming:**\n- \\`startStream()\\` - Start live stream\n- \\`resetStreamKey()\\` - Reset RTMP key\n- \\`getRecordingDownload()\\` - Download recordings\n- \\`deleteRecording()\\` - Delete recordings\n- \\`addSimulcastTarget()\\` - Add simulcast\n- \\`removeSimulcastTarget()\\` - Remove simulcast\n\n**Chat:**\n- \\`sendChatMessage()\\` - Send chat messages\n\n**Profile:**\n- \\`updateProfile()\\` - Update user profile\n\n**Uploads:**\n- \\`uploadTokenImage()\\` - Upload token images\n- \\`uploadProfileImage()\\` - Upload profile images\n\n## Error Handling\n\n```typescript\ntry {\n  await sdk.login();\n} catch (error) {\n  if (error.message.includes('signature')) {\n    console.error('Wallet signature failed');\n  } else if (error.message.includes('network')) {\n    console.error('Network error during login');\n  }\n}\n\n// Check auth before protected operations\nif (!sdk.isAuthenticated()) {\n  await sdk.login();\n}\n\ntry {\n  await sdk.startStream('mytoken');\n} catch (error) {\n  if (error.message.includes('JWT') || error.message.includes('token')) {\n    // Re-authenticate and retry\n    await sdk.login();\n    await sdk.startStream('mytoken');\n  }\n}\n```\n\n## Session Methods Reference\n\n| Method | Description | Returns |\n|--------|-------------|---------|\n| \\`login()\\` | Authenticate with wallet signature | \\`{ accessToken, expiresIn, address }\\` |\n| \\`logout()\\` | Clear JWT token (client-side) | \\`void\\` |\n| \\`refreshToken()\\` | Get new JWT token | \\`{ accessToken, expiresIn, address }\\` |\n| \\`getSession()\\` | Get session info | \\`{ address, issuedAt, expiresAt }\\` |\n| \\`isAuthenticated()\\` | Check if token exists and valid | \\`boolean\\` |\n| \\`shouldRefreshToken(threshold?)\\` | Check if refresh needed | \\`boolean\\` |\n| \\`getAccessToken()\\` | Get raw JWT token | \\`string | null\\` |\n| \\`ensureValidToken(threshold?)\\` | Auto-refresh if needed | \\`Promise<string>\\` |\n\n## Dev Bypass (STAGE Only)\n\nFor testing in STAGE environment without JWT:\n\n```typescript\nconst sdk = createLaunchpadSDK({\n  privateKey: process.env.PRIVATE_KEY,\n  environment: 'development',\n  devBypass: true, // Skip JWT auth in STAGE\n});\n\n// Protected methods work without login() in STAGE\nawait sdk.startStream('testtoken');\n```\n\n**Note:** Dev bypass only works in STAGE/development environments.\n"
-        }
-      ]
-    },
-    {
-      "id": "streaming-demo",
-      "title": "Example: Streaming",
-      "topic": "streaming",
-      "messages": [
-        {
-          "role": "user",
-          "content": "How do I manage live streams?"
-        },
-        {
-          "role": "assistant",
-          "content": "\n# Live Streaming SDK\n\nThe SDK provides comprehensive live streaming management including stream control,\nrecordings management, and simulcast to external platforms.\n\n## Starting a Stream\n\n```typescript\nimport { createLaunchpadSDK } from '@gala-chain/launchpad-sdk';\n\nasync function manageStream() {\n  const sdk = createLaunchpadSDK({\n    wallet: 'your-private-key',\n    streamWebSocketUrl: 'wss://stream.example.com',  // Required for streaming\n    streamAdminApiKey: 'your-admin-key',  // Optional: for admin operations\n  });\n\n  // Start a stream for your token\n  const stream = await sdk.startStream('mytoken');\n  console.log('Stream Key:', stream.streamKey);\n  console.log('RTMP URL:', stream.rtmpUrl);\n  console.log('Playback URL:', stream.playbackUrl);\n  // Use stream.streamKey in OBS or other RTMP software\n\n  // Get stream info (public endpoint)\n  const info = await sdk.getStreamInfo('mytoken');\n  console.log('Status:', info.status);  // IDLE, ACTIVE, DISABLED\n  console.log('Is Live:', info.isLive);\n  console.log('Viewers:', info.viewerCount);\n\n  // Stop the stream when done\n  await sdk.stopStream('mytoken');\n  console.log('Stream stopped');\n\n  // Reset stream key if compromised\n  const newKey = await sdk.resetStreamKey('mytoken');\n  console.log('New Stream Key:', newKey.streamKey);\n}\n```\n\n## Recordings Management\n\n```typescript\nasync function manageRecordings() {\n  const sdk = createLaunchpadSDK({ wallet: 'your-private-key' });\n\n  // List recordings (paginated)\n  const recordings = await sdk.getStreamRecordings({\n    tokenName: 'mytoken',\n    page: 1,\n    limit: 20,\n  });\n  console.log('Total recordings:', recordings.total);\n\n  for (const rec of recordings.recordings) {\n    console.log('Asset ID:', rec.assetId);\n    console.log('Duration:', rec.duration, 'seconds');\n    console.log('Status:', rec.status);  // READY, PROCESSING, ERRORED\n  }\n\n  // Get download URL for a recording\n  const download = await sdk.getRecordingDownload('mytoken', 'asset-123');\n  console.log('Download URL:', download.downloadUrl);\n  console.log('Expires:', download.expiresAt);\n\n  // Delete a recording\n  await sdk.deleteRecording('mytoken', 'asset-123');\n}\n```\n\n## Simulcast Management\n\nRebroadcast your stream to external platforms (YouTube, Twitch, Facebook).\n\n```typescript\nasync function manageSimulcast() {\n  const sdk = createLaunchpadSDK({ wallet: 'your-private-key' });\n\n  // Get existing simulcast targets\n  const targets = await sdk.getSimulcastTargets('mytoken');\n  console.log('Max targets:', targets.maxTargets);\n  console.log('Current targets:', targets.targets.length);\n\n  // Add YouTube simulcast\n  const youtube = await sdk.addSimulcastTarget({\n    tokenName: 'mytoken',\n    platform: 'YOUTUBE',\n    rtmpUrl: 'rtmp://a.rtmp.youtube.com/live2',\n    streamKey: 'your-youtube-stream-key',\n    name: 'My YouTube Channel',\n  });\n  console.log('Added target:', youtube.target.targetId);\n\n  // Add Twitch simulcast\n  await sdk.addSimulcastTarget({\n    tokenName: 'mytoken',\n    platform: 'TWITCH',\n    rtmpUrl: 'rtmp://live.twitch.tv/app',\n    streamKey: 'live_123456_abcdef',\n    name: 'Twitch Stream',\n  });\n\n  // Remove a simulcast target\n  await sdk.removeSimulcastTarget('mytoken', youtube.target.targetId);\n}\n```\n\n## Admin Operations\n\nEnable/disable streaming globally or per-token (requires admin API key).\n\n```typescript\nasync function adminOperations() {\n  const sdk = createLaunchpadSDK({\n    wallet: 'your-private-key',\n    streamAdminApiKey: 'your-admin-key',\n  });\n\n  // Disable streaming for a specific token (admin-only)\n  await sdk.disableStream('mytoken');\n\n  // Re-enable streaming for a token (admin-only)\n  await sdk.enableStream('mytoken');\n\n  // Get global streaming status\n  const globalStatus = await sdk.getGlobalStreamingStatus();\n  console.log('Global streaming enabled:', globalStatus.enabled);\n\n  // Enable/disable streaming globally (maintenance mode)\n  await sdk.setGlobalStreamingEnabled(false);  // Disable all streams\n  await sdk.setGlobalStreamingEnabled(true);   // Re-enable\n}\n```\n\n**Available SDK Methods:**\n| Method | Description | Auth |\n|--------|-------------|------|\n| `startStream(tokenName)` | Start a stream | Wallet |\n| `stopStream(tokenName)` | Stop a stream | Wallet |\n| `getStreamInfo(tokenName)` | Get stream status | Public |\n| `resetStreamKey(tokenName)` | Generate new stream key | Wallet |\n| `disableStream(tokenName)` | Disable token streaming | Admin |\n| `enableStream(tokenName)` | Enable token streaming | Admin |\n| `getStreamRecordings(options)` | List recordings | Public |\n| `getRecordingDownload(tokenName, assetId)` | Get download URL | Wallet |\n| `deleteRecording(tokenName, assetId)` | Delete recording | Wallet |\n| `getSimulcastTargets(tokenName)` | List simulcast targets | Public |\n| `addSimulcastTarget(options)` | Add simulcast target | Wallet |\n| `removeSimulcastTarget(tokenName, targetId)` | Remove target | Wallet |\n| `getGlobalStreamingStatus()` | Get global status | Public |\n| `setGlobalStreamingEnabled(enabled)` | Enable/disable globally | Admin |\n| `getAvailableRoles()` | Get list of available streaming roles | Public |\n| `getStreamRole(options)` | Get user's role for a token | JWT |\n| `getTokenAccess(options)` | Check user's access to a token stream | JWT (optional) |\n\n**MCP Tool Equivalents:**\n- `gala_launchpad_start_stream`\n- `gala_launchpad_stop_stream`\n- `gala_launchpad_get_stream_info`\n- `gala_launchpad_reset_stream_key`\n- `gala_launchpad_disable_stream`\n- `gala_launchpad_enable_stream`\n- `gala_launchpad_get_stream_recordings`\n- `gala_launchpad_get_recording_download`\n- `gala_launchpad_delete_recording`\n- `gala_launchpad_get_simulcast_targets`\n- `gala_launchpad_add_simulcast_target`\n- `gala_launchpad_remove_simulcast_target`\n- `gala_launchpad_get_global_streaming_status`\n- `gala_launchpad_set_global_streaming_enabled`\n- `gala_launchpad_get_available_roles`\n- `gala_launchpad_get_stream_role`\n- `gala_launchpad_get_token_access`\n"
-        }
-      ]
-    },
-    {
-      "id": "stream-chat-demo",
-      "title": "Example: Stream chat",
-      "topic": "stream-chat",
-      "messages": [
-        {
-          "role": "user",
-          "content": "How do I handle stream chat and messaging?"
-        },
-        {
-          "role": "assistant",
-          "content": "\n# Stream Chat SDK\n\nThe SDK provides chat functionality for live streams, including REST API and\nWebSocket real-time messaging.\n\n## REST API Chat\n\n```typescript\nimport { createLaunchpadSDK } from '@gala-chain/launchpad-sdk';\n\nasync function restChat() {\n  const sdk = createLaunchpadSDK({ wallet: 'your-private-key' });\n\n  // Get chat messages (public endpoint)\n  const messages = await sdk.getChatMessages({\n    tokenName: 'mytoken',\n    page: 1,\n    limit: 50,\n  });\n\n  for (const msg of messages.messages) {\n    console.log(`[${msg.createdAt}] ${msg.user?.fullName}: ${msg.content}`);\n  }\n\n  // Send a chat message via REST\n  const sent = await sdk.sendChatMessage({\n    tokenName: 'mytoken',\n    content: 'Hello everyone!',\n  });\n  console.log('Message ID:', sent.message.messageId);\n\n  // Delete a chat message (user can delete own, admin can delete any)\n  const deleted = await sdk.deleteChatMessage({\n    tokenName: 'mytoken',\n    messageId: sent.message.messageId,\n  });\n  console.log('Message deleted:', deleted.deleted);\n\n  // Check chat status\n  const status = await sdk.getChatStatus('mytoken');\n  console.log('Chat enabled:', status.enabled);\n  if (!status.enabled) {\n    console.log('Reason:', status.reason);  // 'global' or 'token'\n  }\n}\n```\n\n## WebSocket Real-time Chat\n\nLower latency messaging with real-time updates.\n\n```typescript\nasync function webSocketChat() {\n  const sdk = createLaunchpadSDK({\n    wallet: 'your-private-key',\n    streamWebSocketUrl: 'wss://stream.example.com',\n  });\n\n  // Connect with event callbacks\n  await sdk.connectStreamWebSocket({\n    onConnect: () => console.log('Connected!'),\n    onDisconnect: (reason) => console.log('Disconnected:', reason),\n    onError: (error) => console.error('Error:', error),\n    onChatMessage: (msg) => {\n      console.log(`[${msg.tokenName}] ${msg.userAddress}: ${msg.content}`);\n    },\n    onViewerCount: (data) => {\n      console.log(`Viewers on ${data.tokenName}: ${data.count}`);\n    },\n    onStreamStatus: (status) => {\n      console.log(`Stream ${status.tokenName}: ${status.status}`);\n    },\n  });\n\n  // Authenticate (required for sending messages)\n  await sdk.authenticateStreamWebSocket();\n\n  // Subscribe to a stream's events\n  const subscribed = await sdk.subscribeToStream('mytoken');\n  console.log('Subscribed, stream status:', subscribed.status);\n\n  // Send message via WebSocket (lower latency)\n  await sdk.sendStreamChatViaWebSocket('mytoken', 'Hello via WebSocket!');\n\n  // Send emoji reaction (ephemeral, not persisted)\n  await sdk.sendStreamReaction('mytoken', '🔥', 0);\n\n  // Unsubscribe when done\n  await sdk.unsubscribeFromStream('mytoken');\n\n  // Disconnect\n  sdk.disconnectStreamWebSocket();\n}\n```\n\n## Admin Chat Operations\n\n```typescript\nasync function adminChat() {\n  const sdk = createLaunchpadSDK({\n    wallet: 'your-private-key',\n    streamAdminApiKey: 'your-admin-key',\n  });\n\n  // Disable chat for a token\n  await sdk.disableChat('mytoken');\n\n  // Re-enable chat\n  await sdk.enableChat('mytoken');\n\n  // Get global chat status\n  const globalStatus = await sdk.getGlobalChatStatus();\n  console.log('Global chat enabled:', globalStatus.enabled);\n\n  // Disable/enable chat globally\n  await sdk.setGlobalChatEnabled(false);  // Disable all chat\n  await sdk.setGlobalChatEnabled(true);   // Re-enable\n}\n```\n\n**WebSocket Events:**\n| Event | Description | Payload |\n|-------|-------------|---------|\n| `chat_message` | New chat message | `{ tokenName, messageId, content, userAddress, user? }` |\n| `viewer_count` | Viewer count update | `{ tokenName, count }` |\n| `stream_status` | Stream status change | `{ tokenName, status, isLive, playbackId }` |\n| `chat_status` | Chat enabled/disabled | `{ tokenName, enabled }` |\n\n**Available SDK Methods:**\n| Method | Description | Auth |\n|--------|-------------|------|\n| `getChatMessages(options)` | Get chat history | Public |\n| `sendChatMessage(options)` | Send via REST | Wallet |\n| `deleteChatMessage(options)` | Delete message | Wallet/Admin |\n| `getChatStatus(tokenName)` | Check chat status | Public |\n| `disableChat(tokenName)` | Disable token chat | Admin |\n| `enableChat(tokenName)` | Enable token chat | Admin |\n| `getGlobalChatStatus()` | Get global status | Public |\n| `setGlobalChatEnabled(enabled)` | Enable/disable globally | Admin |\n| `connectStreamWebSocket(callbacks)` | Connect WebSocket | None |\n| `authenticateStreamWebSocket()` | Authenticate WS | Wallet |\n| `subscribeToStream(tokenName)` | Subscribe to events | None |\n| `unsubscribeFromStream(tokenName)` | Unsubscribe | None |\n| `sendStreamChatViaWebSocket(tokenName, content)` | Send via WS | Wallet |\n| `sendStreamReaction(tokenName, emoji, streamTime)` | Send emoji reaction | Wallet |\n| `disconnectStreamWebSocket()` | Close connection | None |\n| `getEngagementStats(tokenName)` | Get viewer and chat engagement stats | Public |\n\n**MCP Tool Equivalents:**\n- `gala_launchpad_get_chat_messages`\n- `gala_launchpad_send_chat_message`\n- `gala_launchpad_delete_chat_message`\n- `gala_launchpad_get_chat_status`\n- `gala_launchpad_set_chat_enabled`\n- `gala_launchpad_get_global_chat_status`\n- `gala_launchpad_set_global_chat_enabled`\n- `gala_launchpad_connect_stream_websocket`\n- `gala_launchpad_subscribe_to_stream`\n- `gala_launchpad_send_stream_chat_websocket`\n- `gala_launchpad_send_stream_reaction`\n- `gala_launchpad_get_engagement_stats`\n"
-        }
-      ]
-    },
-    {
-      "id": "ban-management-demo",
-      "title": "Example: Ban management",
-      "topic": "ban-management",
-      "messages": [
-        {
-          "role": "user",
-          "content": "How do I manage user bans?"
-        },
-        {
-          "role": "assistant",
-          "content": "\n# Ban/Moderation Operations - SDK v5.5.0+\n\nUser ban management for stream moderation, including creating bans, removing bans,\nlisting banned users, checking ban status, and viewing active users.\n\n## Creating and Removing Bans\n\n```typescript\nimport { createLaunchpadSDK, BAN_DURATIONS } from '@gala-chain/launchpad-sdk';\n\nconst sdk = createLaunchpadSDK({\n  privateKey: process.env.PRIVATE_KEY,\n  streamAdminApiKey: process.env.STREAM_ADMIN_API_KEY, // Admin key for ban ops\n});\n\n// Create a permanent ban\nconst permanentBan = await sdk.createBan({\n  tokenName: 'mytoken',\n  userAddress: 'eth|0x1234567890abcdef1234567890abcdef12345678',\n  reason: 'Spamming chat',\n});\nconsole.log('Permanent ban created:', permanentBan.ban.id);\n\n// Create a temporary ban (1 hour)\nconst tempBan = await sdk.createBan({\n  tokenName: 'mytoken',\n  userAddress: 'eth|0xabcdef1234567890abcdef1234567890abcdef12',\n  reason: 'Inappropriate behavior',\n  durationSeconds: BAN_DURATIONS.ONE_HOUR, // 3600 seconds\n});\nconsole.log('Temp ban expires:', tempBan.ban.expiresAt);\n\n// Remove a ban (unban user)\nconst unbanned = await sdk.removeBan({\n  tokenName: 'mytoken',\n  userAddress: 'eth|0x1234567890abcdef1234567890abcdef12345678',\n});\nconsole.log('User unbanned:', unbanned.removed);\n```\n\n## Duration Presets\n\n```typescript\nimport { BAN_DURATIONS } from '@gala-chain/launchpad-sdk';\n\n// Available presets\nBAN_DURATIONS.ONE_HOUR   // 3600 seconds (1 hour)\nBAN_DURATIONS.ONE_DAY    // 86400 seconds (24 hours)\nBAN_DURATIONS.ONE_WEEK   // 604800 seconds (7 days)\nBAN_DURATIONS.ONE_MONTH  // 2592000 seconds (30 days)\n\n// Custom duration (min: 60 sec, max: 31536000 sec / 1 year)\nconst customBan = await sdk.createBan({\n  tokenName: 'mytoken',\n  userAddress: 'eth|0x...',\n  durationSeconds: 7200, // 2 hours\n});\n```\n\n## Listing Bans\n\n```typescript\n// List all bans for a token\nconst allBans = await sdk.listBans({\n  tokenName: 'mytoken',\n  page: 1,\n  limit: 20,\n});\nconsole.log('Total bans:', allBans.meta.total);\n\nfor (const ban of allBans.bans) {\n  console.log(`- ${ban.userAddress}: ${ban.reason || 'No reason'}`);\n  console.log(`  Permanent: ${ban.isPermanent}`);\n  console.log(`  Expires: ${ban.expiresAt || 'Never'}`);\n}\n\n// Search bans by user\nconst searchResults = await sdk.listBans({\n  tokenName: 'mytoken',\n  search: '0x1234', // Searches userAddress OR fullName\n});\n\n// Filter by specific field\nconst filteredBans = await sdk.listBans({\n  tokenName: 'mytoken',\n  userAddress: '0x1234', // Filter by address only\n  name: 'John',          // Filter by display name only\n});\n```\n\n## Checking Ban Status\n\n```typescript\n// Check if specific user is banned\nconst status = await sdk.getBanStatus({\n  tokenName: 'mytoken',\n  userAddress: 'eth|0x1234567890abcdef1234567890abcdef12345678',\n});\n\nif (status.banned) {\n  console.log('User is banned!');\n  console.log('Reason:', status.ban?.reason);\n  console.log('Permanent:', status.ban?.isPermanent);\n  console.log('Expires:', status.ban?.expiresAt);\n} else {\n  console.log('User is not banned');\n}\n```\n\n## Viewing Active Users\n\n```typescript\nimport { ACTIVE_USER_TYPE } from '@gala-chain/launchpad-sdk';\n\n// Get all active viewers\nconst viewers = await sdk.getActiveUsers({\n  tokenName: 'mytoken',\n  type: ACTIVE_USER_TYPE.VIEWERS, // or 'viewers'\n});\nconsole.log('Active viewers:', viewers.total);\n\n// Get only chat participants\nconst chatters = await sdk.getActiveUsers({\n  tokenName: 'mytoken',\n  type: ACTIVE_USER_TYPE.CHAT_PARTICIPANTS, // or 'chat_participants'\n});\nconsole.log('Chat participants:', chatters.total);\n\n// Search active users\nconst searchActive = await sdk.getActiveUsers({\n  tokenName: 'mytoken',\n  search: 'john', // Search by name or address\n});\n\nfor (const user of searchActive.users) {\n  console.log(`- ${user.fullName || user.userAddress}`);\n  console.log(`  In chat: ${user.isChatParticipant}`);\n}\n```\n\n## Authentication\n\nBan operations support two authentication modes:\n\n1. **Admin API Key** (streamAdminApiKey) - Full moderation access\n2. **JWT Auth** (login()) - Token owner moderation only\n\n```typescript\n// Admin mode - can moderate any token\nconst adminSdk = createLaunchpadSDK({\n  privateKey: process.env.PRIVATE_KEY,\n  streamAdminApiKey: process.env.STREAM_ADMIN_API_KEY,\n});\n\n// Owner mode - can only moderate own tokens\nconst ownerSdk = createLaunchpadSDK({\n  privateKey: process.env.PRIVATE_KEY,\n});\nawait ownerSdk.login(); // JWT authentication required\n```\n\n## WebSocket Events\n\nBan events are broadcast to affected users via WebSocket:\n\n```typescript\n// Listen for ban events\nsdk.connectStreamWebSocket({\n  onUserBanned: (event) => {\n    console.log('User banned:', event.userAddress);\n    console.log('Reason:', event.reason);\n    console.log('Expires:', event.expiresAt);\n  },\n  onUserUnbanned: (event) => {\n    console.log('User unbanned:', event.userAddress);\n  },\n  onBanEnforcement: (event) => {\n    // Received when banned user tries to chat/react\n    console.log('Ban enforced for action:', event.action);\n    console.log('Reason:', event.reason);\n  },\n});\n```\n\n## SDK Methods Reference\n\n| Method | Description | Auth |\n|--------|-------------|------|\n| `createBan(options)` | Create a new ban | Admin/Owner |\n| `removeBan(options)` | Remove a ban (unban user) | Admin/Owner |\n| `listBans(options)` | List banned users | Admin/Owner |\n| `getBanStatus(options)` | Check if user is banned | Admin/Owner |\n| `getActiveUsers(options)` | Get active viewers/chatters | Admin/Owner |\n\n**MCP Tool Equivalents:**\n- `gala_launchpad_create_ban`\n- `gala_launchpad_remove_ban`\n- `gala_launchpad_list_bans`\n- `gala_launchpad_get_ban_status`\n- `gala_launchpad_get_active_users`\n"
-        }
-      ]
-    },
-    {
-      "id": "api-key-management-demo",
-      "title": "Example: Api key management",
-      "topic": "api-key-management",
-      "messages": [
-        {
-          "role": "user",
-          "content": "How do I manage API keys?"
-        },
-        {
-          "role": "assistant",
-          "content": "\n# API Key Management - SDK v5.6.0+\n\nUser-managed API keys with role-based permissions for delegating token management\nauthority to third-party services or automated systems.\n\n**CRITICAL**: Raw API keys are ONLY shown once at creation time. Store them\nsecurely immediately - they cannot be retrieved again.\n\n## Creating API Keys\n\n```typescript\nimport { createLaunchpadSDK, API_KEY_ROLE } from '@gala-chain/launchpad-sdk';\n\nconst sdk = createLaunchpadSDK({\n  privateKey: process.env.PRIVATE_KEY,\n});\n\n// MUST authenticate first\nawait sdk.login();\n\n// Create a moderator key for specific tokens\nconst result = await sdk.createApiKey({\n  role: API_KEY_ROLE.MODERATOR,\n  description: 'Chat moderation bot',\n  delegateAllTokens: false,\n  tokenNames: ['mytoken', 'othertoken'],\n  expiresAt: '2025-12-31T23:59:59Z', // Optional expiration\n});\n\n// CRITICAL: Save this immediately - shown only once!\nconsole.log('Raw Key:', result.rawKey);\n// Format: glp_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxx\nconsole.log('Key ID:', result.id);\nconsole.log('Prefix:', result.keyPrefix);\n```\n\n## Role Hierarchy\n\n```typescript\nimport { API_KEY_ROLE, API_KEY_ROLE_HIERARCHY } from '@gala-chain/launchpad-sdk';\n\n// Available roles (hierarchical)\nAPI_KEY_ROLE.MODERATOR          // Chat, comments, bans\nAPI_KEY_ROLE.TECHNICAL_PRODUCER // Simulcast, stream key, stop/start\nAPI_KEY_ROLE.MANAGER            // Moderator + Technical Producer + recordings\nAPI_KEY_ROLE.OWNER              // Full access (indistinguishable from normal auth)\n\n// Role hierarchy levels\nAPI_KEY_ROLE_HIERARCHY.MODERATOR           // 1\nAPI_KEY_ROLE_HIERARCHY.TECHNICAL_PRODUCER  // 1\nAPI_KEY_ROLE_HIERARCHY.MANAGER             // 2\nAPI_KEY_ROLE_HIERARCHY.OWNER               // 3\n\n// Check if role has sufficient permission\nimport { roleHasSufficientPermission } from '@gala-chain/launchpad-sdk';\n\nconst canManage = roleHasSufficientPermission('MANAGER', 'MODERATOR'); // true\nconst canOwn = roleHasSufficientPermission('MODERATOR', 'OWNER');      // false\n```\n\n## Token Delegation\n\n```typescript\n// Delegate all tokens (current and future)\nconst allTokensKey = await sdk.createApiKey({\n  role: API_KEY_ROLE.MODERATOR,\n  description: 'All tokens moderator',\n  delegateAllTokens: true,\n});\n\n// Delegate specific tokens only\nconst specificKey = await sdk.createApiKey({\n  role: API_KEY_ROLE.MANAGER,\n  description: 'Project manager for specific tokens',\n  delegateAllTokens: false,\n  tokenNames: ['token1', 'token2', 'token3'], // Case-insensitive\n});\n```\n\n## Listing and Getting API Keys\n\n```typescript\n// List all API keys (paginated)\nconst list = await sdk.listApiKeys({\n  page: 1,\n  limit: 20,\n});\nconsole.log('Total keys:', list.meta.total);\n\nfor (const key of list.apiKeys) {\n  console.log(`- ${key.keyPrefix}: ${key.role}`);\n  console.log(`  Description: ${key.description || 'None'}`);\n  console.log(`  Last used: ${key.lastUsedAt || 'Never'}`);\n  console.log(`  Expires: ${key.expiresAt || 'Never'}`);\n}\n\n// Get single API key by ID\nconst key = await sdk.getApiKey(123);\nconsole.log('Key details:', key);\n```\n\n## Updating API Keys\n\n```typescript\n// Update description\nconst updated = await sdk.updateApiKey(123, {\n  description: 'Updated description',\n});\n\n// Upgrade role\nawait sdk.updateApiKey(123, {\n  role: API_KEY_ROLE.MANAGER,\n});\n\n// Change token delegation\nawait sdk.updateApiKey(123, {\n  delegateAllTokens: true,\n});\n\n// Update specific token access (replaces existing)\nawait sdk.updateApiKey(123, {\n  delegateAllTokens: false,\n  tokenNames: ['newtoken1', 'newtoken2'],\n});\n\n// Update expiration (null to remove)\nawait sdk.updateApiKey(123, {\n  expiresAt: '2026-12-31T23:59:59Z',\n});\n\n// Remove expiration\nawait sdk.updateApiKey(123, {\n  expiresAt: null,\n});\n```\n\n## Revoking API Keys\n\n```typescript\n// Revoke (soft delete) an API key\nawait sdk.revokeApiKey(123);\nconsole.log('API key revoked');\n\n// Key is now unusable - attempts to use it will fail with 401\n```\n\n## Getting Available Roles\n\n```typescript\n// Get list of valid roles\nconst roles = sdk.getApiKeyRoles();\nconsole.log('Available roles:', roles);\n// ['MODERATOR', 'TECHNICAL_PRODUCER', 'MANAGER', 'OWNER']\n```\n\n## Validation Helpers\n\n```typescript\nimport {\n  isValidApiKeyRole,\n  validateCreateApiKeyOptions,\n  validateUpdateApiKeyOptions,\n} from '@gala-chain/launchpad-sdk';\n\n// Validate role string\nif (isValidApiKeyRole('MODERATOR')) {\n  console.log('Valid role');\n}\n\n// Validate creation options\nconst createErrors = validateCreateApiKeyOptions({\n  role: 'MODERATOR',\n  description: 'Test key',\n});\nif (createErrors.length > 0) {\n  console.error('Validation errors:', createErrors);\n}\n\n// Validate update options\nconst updateErrors = validateUpdateApiKeyOptions({\n  role: 'MANAGER',\n  expiresAt: '2025-12-31T23:59:59Z',\n});\n```\n\n## SDK Methods Reference\n\n| Method | Description | Auth |\n|--------|-------------|------|\n| `createApiKey(options)` | Create new API key | JWT |\n| `listApiKeys(options?)` | List API keys (paginated) | JWT |\n| `getApiKey(id)` | Get API key by ID | JWT |\n| `updateApiKey(id, options)` | Update API key | JWT |\n| `revokeApiKey(id)` | Revoke (soft delete) key | JWT |\n| `getApiKeyRoles()` | Get valid role list | None |\n\n**MCP Tool Equivalents:**\n- `gala_launchpad_create_api_key`\n- `gala_launchpad_list_api_keys`\n- `gala_launchpad_get_api_key`\n- `gala_launchpad_update_api_key`\n- `gala_launchpad_revoke_api_key`\n- `gala_launchpad_get_api_key_roles`\n"
-        }
-      ]
-    },
-    {
-      "id": "moderator-invites-demo",
-      "title": "Example: Moderator invites",
-      "topic": "moderator-invites",
-      "messages": [
-        {
-          "role": "user",
-          "content": "How do I manage moderator invites?"
-        },
-        {
-          "role": "assistant",
-          "content": "\n# Moderator Invites - SDK v5.7.0+\n\nMagic link-based moderator delegation system. Token owners can create invite\nlinks to grant stream management access to other users without needing their\nwallet address upfront.\n\n## Flow Overview\n\n1. **Owner creates invite** → Gets magic link URL\n2. **Owner shares link** (email, Slack, Discord, etc.)\n3. **Recipient clicks link** → Redirected to claim page\n4. **Recipient logs in** → Claims invite with their wallet\n5. **Recipient gains access** → Token appears in their /studio dashboard\n\n## Creating Moderator Invites\n\n```typescript\nimport { createLaunchpadSDK, MODERATOR_ROLE } from '@gala-chain/launchpad-sdk';\n\nconst sdk = createLaunchpadSDK({\n  privateKey: process.env.PRIVATE_KEY,\n});\n\n// MUST authenticate first\nawait sdk.login();\n\n// Create an invite for a moderator\nconst result = await sdk.createModeratorInvite({\n  tokenName: 'mytoken',\n  role: MODERATOR_ROLE.MODERATOR,\n  description: 'John - Friday stream moderator',\n  expiresAt: '2025-12-31T23:59:59Z', // Optional expiration\n});\n\n// Share this URL with the intended moderator\nconsole.log('Invite URL:', result.invite.inviteUrl);\nconsole.log('Invite Code:', result.invite.inviteCode);\nconsole.log('Status:', result.invite.status); // PENDING\n```\n\n## Moderator Roles\n\n```typescript\nimport { MODERATOR_ROLE } from '@gala-chain/launchpad-sdk';\n\n// Available roles (OWNER not available for invites)\nMODERATOR_ROLE.MODERATOR           // Chat, comments, bans\nMODERATOR_ROLE.TECHNICAL_PRODUCER  // Simulcast, stream key, stop/start\nMODERATOR_ROLE.MANAGER             // All of the above + recordings + stream settings\n```\n\n## Listing Invites\n\n```typescript\n// List all invites for a token (owner only)\nconst list = await sdk.listModeratorInvites({\n  tokenName: 'mytoken',\n  status: 'PENDING', // Optional filter: PENDING, CLAIMED, REVOKED, EXPIRED\n  page: 1,\n  limit: 20,\n});\n\nconsole.log('Total invites:', list.meta.totalItems);\n\nfor (const invite of list.invites) {\n  console.log(`- ID ${invite.id}: ${invite.role}`);\n  console.log(`  Status: ${invite.status}`);\n  console.log(`  Description: ${invite.description || 'None'}`);\n  console.log(`  Created: ${invite.createdAt}`);\n  console.log(`  Expires: ${invite.expiresAt || 'Never'}`);\n}\n```\n\n## Claiming Invites (Recipient Side)\n\n```typescript\n// Extract code from magic link URL\nconst inviteCode = 'abc123...'; // 64-character hex code\n\n// Recipient authenticates and claims\nawait sdk.login();\n\nconst result = await sdk.claimModeratorInvite({\n  inviteCode: inviteCode,\n});\n\nconsole.log('Claimed token:', result.token.tokenName);\nconsole.log('Your role:', result.token.role);\nconsole.log('Claimed at:', result.token.claimedAt);\n// Token now appears in /studio dashboard\n```\n\n## Previewing Invites (Public)\n\n```typescript\n// Preview invite details before logging in (public endpoint)\nconst preview = await sdk.getModeratorInviteByCode('abc123...');\n\nconsole.log('Token:', preview.tokenName);\nconsole.log('Symbol:', preview.tokenSymbol);\nconsole.log('Role offered:', preview.role);\nconsole.log('Status:', preview.status);\nconsole.log('Invited by:', preview.invitedBy.fullName);\n```\n\n## Getting Moderated Tokens (Studio Dashboard)\n\n```typescript\n// Get all tokens where you have moderator access\nawait sdk.login();\n\nconst tokens = await sdk.getModeratedTokens({\n  page: 1,\n  limit: 20,\n});\n\nfor (const token of tokens.tokens) {\n  console.log(`- ${token.tokenName} (${token.tokenSymbol})`);\n  console.log(`  Role: ${token.role}`);\n  console.log(`  Stream status: ${token.muxStreamStatus}`);\n}\n```\n\n## Revoking Invites\n\n```typescript\n// Revoke by invite ID (owner only)\nawait sdk.revokeModeratorInvite(123);\nconsole.log('Invite revoked');\n\n// If already claimed, moderator loses access immediately\n// If pending, invite can no longer be claimed\n```\n\n## SDK Methods Reference\n\n| Method | Description | Auth |\n|--------|-------------|------|\n| `createModeratorInvite(options)` | Create magic link invite | JWT (owner) |\n| `claimModeratorInvite(options)` | Claim invite with code | JWT |\n| `getModeratedTokens(options?)` | Get tokens you moderate | JWT |\n| `listModeratorInvites(options)` | List invites for token | JWT (owner) |\n| `revokeModeratorInvite(id)` | Revoke invite by ID | JWT (owner) |\n| `getModeratorInviteByCode(code)` | Preview invite details | None |\n\n**MCP Tool Equivalents:**\n- `gala_launchpad_create_moderator_invite`\n- `gala_launchpad_claim_moderator_invite`\n- `gala_launchpad_get_moderated_tokens`\n- `gala_launchpad_list_moderator_invites`\n- `gala_launchpad_revoke_moderator_invite`\n- `gala_launchpad_get_moderator_invite`\n"
-        }
-      ]
-    },
-    {
-      "id": "overseer-invites-demo",
-      "title": "Example: Overseer invites",
-      "topic": "overseer-invites",
-      "messages": [
-        {
-          "role": "user",
-          "content": "How do I manage overseer invites?"
-        },
-        {
-          "role": "assistant",
-          "content": "\n# Overseer System - SDK v5.9.0+\n\nGlobal platform oversight via magic link invites. Overseers have MANAGER-level\naccess to ALL tokens (current and future), unlike moderators who have token-scoped access.\n\n## Key Differences from Moderators\n\n| Feature | Moderator | Overseer |\n|---------|-----------|----------|\n| Scope | Per-token or blanket (owner's tokens) | ALL tokens on platform |\n| Access Level | MODERATOR, TECHNICAL_PRODUCER, or MANAGER | Always MANAGER |\n| Grant Authority | Token owner | Admin or existing Overseer |\n| Use Case | Stream management delegation | Platform-wide oversight |\n\n## Creating Overseer Invites\n\n```typescript\nimport { createLaunchpadSDK } from '@gala-chain/launchpad-sdk';\n\nconst sdk = createLaunchpadSDK({\n  privateKey: process.env.PRIVATE_KEY,\n  streamAdminApiKey: process.env.STREAM_ADMIN_API_KEY, // Admin key OR JWT auth\n});\n\n// Option 1: Using Admin API key\nconst result = await sdk.createOverseerInvite({\n  description: 'John - Platform Support Team',\n  expiresAt: '2025-12-31T23:59:59Z', // Optional\n});\n\n// Option 2: Using JWT (as existing Overseer)\nawait sdk.login();\nconst result = await sdk.createOverseerInvite({\n  description: 'Platform team member',\n});\n\nconsole.log('Share this link:', result.invite.inviteUrl);\nconsole.log('Invite Code:', result.invite.inviteCode);\n```\n\n## Claiming Overseer Invites\n\n```typescript\n// Recipient must be authenticated\nawait sdk.login();\n\n// Claim the invite\nconst claimed = await sdk.claimOverseerInvite('abc123...');\nconsole.log('Now an overseer!');\nconsole.log('Status:', claimed.invite.status); // CLAIMED\n\n// Check own status\nconst status = await sdk.getMyOverseerStatus();\nconsole.log('Is Overseer:', status.isOverseer); // true\nconsole.log('Granted at:', status.overseer?.createdAt);\n```\n\n## Listing Overseers and Invites\n\n```typescript\n// List all overseer invites (paginated)\nconst invites = await sdk.listOverseerInvites({\n  status: 'PENDING', // PENDING, CLAIMED, REVOKED, EXPIRED\n  page: 1,\n  limit: 20,\n});\n\nfor (const invite of invites.invites) {\n  console.log(`#${invite.id}: ${invite.description || 'No description'}`);\n  console.log(`  Status: ${invite.status}`);\n  console.log(`  Created by: ${invite.invitedBy.fullName || invite.invitedBy.address}`);\n}\n\n// List all active overseers\nconst overseers = await sdk.listOverseers({\n  status: 'ACTIVE', // ACTIVE or REVOKED\n  page: 1,\n  limit: 20,\n});\n\nfor (const overseer of overseers.overseers) {\n  console.log(`Overseer: ${overseer.userAddress}`);\n  console.log(`  Since: ${overseer.createdAt}`);\n}\n```\n\n## Public Invite Preview\n\n```typescript\n// Get public info about an invite (no auth required)\nconst preview = await sdk.getOverseerInviteByCode('abc123...');\n\nconsole.log('Status:', preview.status);\nconsole.log('Description:', preview.description);\nconsole.log('Invited by:', preview.invitedBy.fullName);\nconsole.log('Expires:', preview.expiresAt);\n```\n\n## Revoking Access\n\n```typescript\n// Revoke an invite by ID\nawait sdk.revokeOverseerInvite(123);\nconsole.log('Invite revoked');\n\n// Revoke an overseer by wallet address\nawait sdk.revokeOverseer('eth|1234567890abcdef...');\nconsole.log('Overseer access revoked');\n```\n\n## SDK Methods Reference\n\n| Method | Description | Auth |\n|--------|-------------|------|\n| `createOverseerInvite(options?)` | Create magic link invite | Admin API key OR JWT (Overseer) |\n| `claimOverseerInvite(code)` | Claim invite with code | JWT |\n| `listOverseerInvites(options?)` | List all overseer invites | Admin API key OR JWT (Overseer) |\n| `getOverseerInviteByCode(code)` | Preview invite details | None (public) |\n| `revokeOverseerInvite(id)` | Revoke invite by ID | Admin API key OR JWT (Overseer) |\n| `listOverseers(options?)` | List all overseers | Admin API key OR JWT (Overseer) |\n| `revokeOverseer(address)` | Revoke overseer by address | Admin API key OR JWT (Overseer) |\n| `getMyOverseerStatus()` | Check own overseer status | JWT |\n\n**MCP Tool Equivalents:**\n- `gala_launchpad_create_overseer_invite`\n- `gala_launchpad_claim_overseer_invite`\n- `gala_launchpad_list_overseer_invites`\n- `gala_launchpad_get_overseer_invite`\n- `gala_launchpad_revoke_overseer_invite`\n- `gala_launchpad_list_overseers`\n- `gala_launchpad_revoke_overseer`\n- `gala_launchpad_get_my_overseer_status`\n- `gala_launchpad_get_overseer_summary`\n"
-        }
-      ]
-    },
-    {
-      "id": "content-flag-management-demo",
-      "title": "Example: Content flag management",
-      "topic": "content-flag-management",
-      "messages": [
-        {
-          "role": "user",
-          "content": "How do I manage content flags?"
-        },
-        {
-          "role": "assistant",
-          "content": "\n# Content Flag Management - SDK v5.11.0+\n\nContent moderation via flags and comments. Moderators can flag content for review,\ntake action on flags (delete content, ban users), and manage pool comments.\n\n## Content Types\n\nFlags can be created for:\n- `MESSAGE` - Chat messages\n- `COMMENT` - Pool comments\n- `STREAM` - Live streams (admin only)\n\n## Creating Content Flags\n\n```typescript\nimport { createLaunchpadSDK, CONTENT_TYPE } from '@gala-chain/launchpad-sdk';\n\nconst sdk = createLaunchpadSDK({\n  privateKey: process.env.PRIVATE_KEY,\n});\n\nawait sdk.login();\n\n// Flag a chat message\nconst flag = await sdk.createFlag({\n  tokenName: 'mytoken',\n  contentType: CONTENT_TYPE.MESSAGE,\n  contentId: 'msg-123',\n  reason: 'Spam/harassment',\n});\n\nconsole.log('Flag ID:', flag.id);\nconsole.log('Status:', flag.status); // PENDING\n```\n\n## Listing Flags\n\n```typescript\n// List all pending flags for a token\nconst flags = await sdk.listFlags({\n  tokenName: 'mytoken',\n  status: 'PENDING',\n  page: 1,\n  limit: 20,\n});\n\nfor (const flag of flags.flags) {\n  console.log(`Flag #${flag.id}: ${flag.contentType}`);\n  console.log(`  Reason: ${flag.reason}`);\n  console.log(`  Reporter: ${flag.reporterAddress}`);\n}\n```\n\n## Taking Action on Flags\n\n```typescript\n// Dismiss a flag (no action taken)\nawait sdk.dismissFlag(flagId);\n\n// Take action - delete content only\nawait sdk.actionFlag(flagId, {\n  action: 'DELETE_CONTENT',\n});\n\n// Take action - ban the user\nawait sdk.actionFlag(flagId, {\n  action: 'BAN_USER',\n  banDuration: 3600, // 1 hour ban\n});\n\n// Take action - delete content AND ban user\nawait sdk.actionFlag(flagId, {\n  action: 'DELETE_AND_BAN',\n  banDuration: 86400, // 24 hour ban\n});\n```\n\n## Managing Pool Comments with Reactions\n\nComments include a `messageId` for reactions integration and optional `reactions` data.\n\n```typescript\n// Fetch comments for a pool (with reactions data)\nconst comments = await sdk.getComments({\n  tokenName: 'mytoken',\n  page: 1,\n  limit: 20,\n});\n\nfor (const comment of comments.comments) {\n  console.log(`ID: ${comment.id}, MessageId: ${comment.messageId}`);\n  console.log(`${comment.userAddress}: ${comment.content}`);\n\n  // Check reactions on this comment\n  if (comment.reactions) {\n    console.log(`Total reactions: ${comment.reactions.totalCount}`);\n    for (const reaction of comment.reactions.reactions) {\n      console.log(`  ${reaction.reactionType}: ${reaction.count} (you reacted: ${reaction.userReacted})`);\n    }\n  }\n}\n\n// Post a comment (requires JWT auth)\nawait sdk.login();\nconst newComment = await sdk.createComment({\n  tokenName: 'mytoken',\n  content: 'Great project! Looking forward to the launch.',\n});\nconsole.log('Comment messageId:', newComment.comment.messageId);\n\n// Add a reaction to a comment using its messageId\nawait sdk.addReaction({\n  messageId: newComment.comment.messageId,\n  reaction: '👍',\n});\n\n// Remove a reaction\nawait sdk.removeReaction({\n  messageId: newComment.comment.messageId,\n  reaction: '👍',\n});\n\n// Delete a comment (moderator only)\nawait sdk.deleteComment({ commentId: comment.id });\n```\n\n## SDK Methods Reference\n\n| Method | Description | Auth |\n|--------|-------------|------|\n| `createFlag(options)` | Flag content for review | JWT |\n| `listFlags(options)` | List flags for a token | API key OR JWT (Moderator) |\n| `dismissFlag(flagId)` | Dismiss flag (no action) | API key OR JWT (Moderator) |\n| `actionFlag(flagId, options)` | Take action on flag | API key OR JWT (Moderator) |\n| `getComments(options)` | Get pool comments with reactions | None (public) |\n| `createComment(options)` | Post a comment, returns messageId | JWT |\n| `deleteComment(options)` | Delete a comment | API key OR JWT (Moderator) |\n| `addReaction(options)` | Add reaction to comment/message | JWT |\n| `removeReaction(options)` | Remove reaction from comment/message | JWT |\n\n**MCP Tool Equivalents:**\n- `gala_launchpad_create_flag`\n- `gala_launchpad_list_flags`\n- `gala_launchpad_dismiss_flag`\n- `gala_launchpad_action_flag`\n- `gala_launchpad_fetch_comments`\n- `gala_launchpad_post_comment`\n- `gala_launchpad_delete_comment`\n- `gala_launchpad_add_reaction`\n- `gala_launchpad_remove_reaction`\n"
-        }
-      ]
-    },
-    {
-      "id": "content-reactions-demo",
-      "title": "Example: Content reactions",
-      "topic": "content-reactions",
-      "messages": [
-        {
-          "role": "user",
-          "content": "How do I manage content reactions?"
-        },
-        {
-          "role": "assistant",
-          "content": "Learn about Content reactions"
-        }
-      ]
-    },
-    {
-      "id": "trade-history-demo",
-      "title": "Example: Trade history",
-      "topic": "trade-history",
-      "messages": [
-        {
-          "role": "user",
-          "content": "How do I view trading history?"
-        },
-        {
-          "role": "assistant",
-          "content": "\n## Trade History\n\nQuery and analyze trading activity for tokens.\n\n### Basic Usage\n\n```typescript\nimport { LaunchpadSDK } from '@gala-chain/launchpad-sdk';\n\nconst sdk = new LaunchpadSDK({ environment: 'production' });\n\n// Get recent trades for a token\nconst result = await sdk.getTrades({\n  tokenName: 'anime',\n  limit: 10,\n  page: 1\n});\n\nconsole.log(`Found ${result.trades.length} trades`);\nfor (const trade of result.trades) {\n  console.log(`${trade.txnType}: ${trade.inputAmount} → ${trade.outputAmount}`);\n}\n```\n\n### Filter by Trade Type\n\n```typescript\n// Get only buy orders\nconst buyTrades = await sdk.getTrades({\n  tokenName: 'anime',\n  txnType: 'BUY',\n  limit: 50\n});\n\n// Get only sell orders\nconst sellTrades = await sdk.getTrades({\n  tokenName: 'anime',\n  txnType: 'SELL',\n  limit: 50\n});\n```\n\n### Date Range Queries\n\n```typescript\nconst oneWeekAgo = new Date(Date.now() - 7 * 24 * 60 * 60 * 1000);\nconst now = new Date();\n\nconst recentTrades = await sdk.getTrades({\n  tokenName: 'anime',\n  startDate: oneWeekAgo,\n  endDate: now,\n  limit: 50\n});\n```\n\n### Filter by User\n\n```typescript\n// Get trades for a specific wallet\nconst userTrades = await sdk.getTrades({\n  tokenName: 'anime',\n  userAddress: 'eth|0x1234...',\n  limit: 20\n});\n```\n\n### Pagination\n\n```typescript\n// Paginate through all trades\nlet page = 1;\nlet hasMore = true;\n\nwhile (hasMore) {\n  const result = await sdk.getTrades({ tokenName: 'anime', page, limit: 50 });\n  console.log(`Page ${page}: ${result.trades.length} trades`);\n\n  hasMore = result.trades.length === 50;\n  page++;\n}\n```\n\n**MCP Tool Equivalents:**\n- `gala_launchpad_get_trades`\n"
-        }
-      ]
-    },
-    {
-      "id": "token-ban-management-demo",
-      "title": "Example: Token ban management",
-      "topic": "token-ban-management",
-      "messages": [
-        {
-          "role": "user",
-          "content": "How do I manage token bans?"
-        },
-        {
-          "role": "assistant",
-          "content": "\n# Token Ban Management - SDK v6.x.0+\n\nPlatform-wide token ban operations for overseers. Banned tokens are hidden from ALL listings\nand have actions (comments, streaming, chat) blocked. This is different from user bans which\nonly affect specific users on specific tokens.\n\n**Access Control:** All methods require either:\n- streamAdminApiKey (server-to-server)\n- JWT with overseer status (authenticated overseer user)\n\n**Effects of Token Bans:**\n- Hidden from ALL pool listings (including creator's profile)\n- Comments blocked on banned tokens\n- Live streaming blocked on banned tokens\n- Chat messages blocked on banned tokens\n- Trading NOT blocked (GalaChain handles trading independently)\n\n## Banning a Token\n\n```typescript\nimport { createLaunchpadSDK } from '@gala-chain/launchpad-sdk';\n\n// Using Admin API key\nconst sdk = createLaunchpadSDK({\n  streamAdminApiKey: process.env.STREAM_ADMIN_API_KEY,\n});\n\n// Or using JWT auth (must be an overseer)\nconst sdkWithAuth = createLaunchpadSDK({\n  privateKey: process.env.PRIVATE_KEY,\n});\nawait sdkWithAuth.login({ walletAddress: 'eth|0x...' });\n\n// Ban a token with reason\nconst result = await sdk.banToken({\n  tokenName: 'scamtoken',\n  reason: 'Fraudulent project - reported by multiple users',\n});\nconsole.log('Token banned:', result.tokenName);\nconsole.log('Ban ID:', result.ban.id);\nconsole.log('Banned by:', result.ban.bannedBy);\n\n// Ban without reason (optional)\nawait sdk.banToken({ tokenName: 'problematictoken' });\n```\n\n## Unbanning a Token\n\n```typescript\n// Remove a token ban\nconst result = await sdk.unbanToken({ tokenName: 'scamtoken' });\nconsole.log('Ban removed:', result.removed); // true\nconsole.log('Token:', result.tokenName);\n\n// Token is now:\n// - Visible in pool listings again\n// - Comments re-enabled\n// - Live streaming re-enabled\n// - Chat re-enabled\n```\n\n## Checking Token Ban Status\n\n```typescript\n// Check if a specific token is banned\nconst status = await sdk.isTokenBanned({ tokenName: 'sometoken' });\n\nif (status.banned) {\n  console.log('Token is banned!');\n  console.log('Reason:', status.ban?.reason);\n  console.log('Banned by:', status.ban?.bannedBy);\n  console.log('Banned at:', status.ban?.createdAt);\n} else {\n  console.log('Token is not banned');\n}\n\n// getTokenBan is an alias - use whichever is more readable\nconst details = await sdk.getTokenBan({ tokenName: 'sometoken' });\n```\n\n## Listing All Banned Tokens\n\n```typescript\n// Get first page with default limit (20)\nconst page1 = await sdk.listTokenBans({});\nconsole.log('Total banned tokens:', page1.meta.total);\n\nfor (const ban of page1.items) {\n  console.log(`- ${ban.tokenName}: ${ban.reason || 'No reason'}`);\n  console.log(`  Banned by: ${ban.bannedBy}`);\n  console.log(`  Date: ${ban.createdAt}`);\n}\n\n// Search for specific tokens (partial match, case-insensitive)\nconst searchResults = await sdk.listTokenBans({\n  search: 'scam',\n  page: 1,\n  limit: 10,\n});\n\n// Paginate through all banned tokens\nlet page = 1;\nlet hasMore = true;\nwhile (hasMore) {\n  const results = await sdk.listTokenBans({ page, limit: 20 });\n  console.log(`Page ${page}: ${results.items.length} bans`);\n  for (const ban of results.items) {\n    console.log(`  - ${ban.tokenName}`);\n  }\n  hasMore = page < results.meta.totalPages;\n  page++;\n}\n```\n\n## Important Notes\n\n1. **Permanent Bans Only**: Token bans do not expire. They remain in effect until\n   explicitly removed by an overseer.\n\n2. **Case Normalization**: Token names are automatically normalized to lowercase\n   in all requests and responses.\n\n3. **Idempotency**: Banning an already-banned token returns a 409 Conflict error.\n   Unbanning a non-banned token returns a 404 Not Found error.\n\n4. **Trading Continues**: Token bans do NOT stop trading on GalaChain. The\n   launchpad hides visibility and blocks social features only.\n\n**MCP Tool Equivalents:**\n- `gala_launchpad_ban_token`\n- `gala_launchpad_unban_token`\n- `gala_launchpad_list_token_bans`\n- `gala_launchpad_get_token_ban`\n- `gala_launchpad_is_token_banned`\n"
-        }
-      ]
-    },
-    {
-      "id": "nft-collection-management-demo",
-      "title": "Example: Nft collection management",
-      "topic": "nft-collection-management",
-      "messages": [
-        {
-          "role": "user",
-          "content": "How do I nft collection management?"
-        },
-        {
-          "role": "assistant",
-          "content": "\n# NFT Collection Management - SDK v5.12.0+\n\nCreate and manage NFT collections, token classes, and mint NFTs on GalaChain.\n\n**Key Concepts:**\n- **Collection**: A named grouping for NFT token classes (claimed for 10,000 GALA)\n- **Token Class**: A specific type/rarity within a collection (created for 1,000 GALA)\n- **NFT Instance**: Individual NFT minted from a token class (dynamic fee based on quantity)\n\n## Check Collection Availability\n\n```typescript\nimport { createLaunchpadSDK } from '@gala-chain/launchpad-sdk';\n\nconst sdk = createLaunchpadSDK({ privateKey: 'your-private-key' });\n\n// Check if a collection name is available\nconst available = await sdk.isNftCollectionAvailable('MyEpicNFTs');\nconsole.log('Collection available:', available);\n\n// Get fee for claiming a collection\nconst claimFee = await sdk.getNftCollectionClaimFee();\nconsole.log('Claim fee:', claimFee); // Usually \"10000\" GALA\n```\n\n## Claim a Collection\n\n```typescript\n// Claim an available collection name\nconst result = await sdk.claimNftCollection({\n  collectionName: 'MyEpicNFTs',\n  description: 'Epic NFT collection for gaming',\n});\nconsole.log('Collection claimed:', result.collectionName);\nconsole.log('Transaction ID:', result.transactionId);\n\n// Fetch your owned collections\nconst collections = await sdk.fetchNftCollections(walletAddress);\nfor (const collection of collections) {\n  console.log(`Collection: ${collection.collectionName}`);\n  console.log(`  Status: ${collection.status}`);\n}\n```\n\n## Create Token Classes (Rarities)\n\n```typescript\n// Get fee for creating a token class\nconst classCreateFee = await sdk.getNftTokenClassCreateFee();\nconsole.log('Create fee:', classCreateFee); // Usually \"1000\" GALA\n\n// Create a token class (rarity tier)\nconst classResult = await sdk.createNftTokenClass({\n  collectionName: 'MyEpicNFTs',\n  tokenClassName: 'LegendaryWizard',\n  description: 'Ultra-rare legendary wizard NFTs',\n  maximumSupply: '100',  // Max NFTs of this type\n  data: {\n    rarity: 'legendary',\n    class: 'wizard',\n    power: '9000',\n  },\n});\nconsole.log('Token class created:', classResult.tokenClassName);\n\n// Fetch token classes for your collection\nconst classes = await sdk.fetchNftTokenClasses({\n  collectionName: 'MyEpicNFTs',\n});\nfor (const tokenClass of classes) {\n  console.log(`Class: ${tokenClass.tokenClassName}`);\n  console.log(`  Current Supply: ${tokenClass.currentSupply}/${tokenClass.maxSupply}`);\n}\n```\n\n## Estimate Mint Fees\n\n```typescript\n// Estimate fee for minting multiple NFTs\nconst mintFeeEstimate = await sdk.estimateNftMintFee({\n  collectionName: 'MyEpicNFTs',\n  tokenClassName: 'LegendaryWizard',\n  quantity: 5,\n});\nconsole.log('Estimated mint fee:', mintFeeEstimate); // Dynamic fee in GALA\n\n// Estimate multiple operations at once\nconst bundleFee = await sdk.estimateNftOperationFees({\n  operations: [\n    { type: 'claim_collection' },\n    { type: 'create_token_class', collectionName: 'MyEpicNFTs' },\n    { type: 'mint', quantity: 10 },\n  ],\n});\nconsole.log('Total bundle fee:', bundleFee.totalFee);\nfor (const op of bundleFee.breakdown) {\n  console.log(`  ${op.operationType}: ${op.fee}`);\n}\n```\n\n## Mint NFTs\n\n```typescript\n// Mint NFT instances from a token class\nconst mintResult = await sdk.mintNft({\n  collectionName: 'MyEpicNFTs',\n  tokenClassName: 'LegendaryWizard',\n  quantity: 5,\n  to: 'eth|0x...', // Recipient wallet\n  metadata: {\n    attributes: [\n      { name: 'level', value: '50' },\n      { name: 'element', value: 'fire' },\n    ],\n  },\n});\nconsole.log('Minted:', mintResult.quantityMinted);\nconsole.log('Transaction ID:', mintResult.transactionId);\n\n// Check NFT balances\nconst balances = await sdk.fetchNftBalances(walletAddress);\nfor (const balance of balances) {\n  console.log(`${balance.collectionName}/${balance.tokenClassName}: ${balance.quantity}`);\n}\n\n// Filter by collection\nconst collectionBalances = await sdk.fetchNftBalances(walletAddress, 'MyEpicNFTs');\n```\n\n## Complete Workflow\n\n```typescript\n// 1. Check availability\nconst available = await sdk.isNftCollectionAvailable('MyEpicNFTs');\nif (!available) throw new Error('Collection name taken');\n\n// 2. Claim collection (10,000 GALA)\nconst claimResult = await sdk.claimNftCollection({\n  collectionName: 'MyEpicNFTs',\n  description: 'My epic NFT collection',\n});\nconsole.log('✓ Collection claimed');\n\n// 3. Create token class (1,000 GALA)\nconst classResult = await sdk.createNftTokenClass({\n  collectionName: 'MyEpicNFTs',\n  tokenClassName: 'Legendary',\n  description: 'Legendary tier NFTs',\n  maximumSupply: '1000',\n});\nconsole.log('✓ Token class created');\n\n// 4. Estimate mint fee\nconst fee = await sdk.estimateNftMintFee({\n  collectionName: 'MyEpicNFTs',\n  tokenClassName: 'Legendary',\n  quantity: 100,\n});\nconsole.log(`✓ Mint fee: ${fee} GALA`);\n\n// 5. Mint NFTs\nconst mintResult = await sdk.mintNft({\n  collectionName: 'MyEpicNFTs',\n  tokenClassName: 'Legendary',\n  quantity: 100,\n  to: userWallet,\n});\nconsole.log('✓ Minted:', mintResult.quantityMinted);\n\n// 6. Verify ownership\nconst balances = await sdk.fetchNftBalances(userWallet, 'MyEpicNFTs');\nconsole.log('Total NFTs:', balances.reduce((sum, b) => sum + parseInt(b.quantity), 0));\n```\n\n**MCP Tool Equivalents:**\n- `gala_launchpad_get_nft_collection_claim_fee`\n- `gala_launchpad_get_nft_token_class_create_fee`\n- `gala_launchpad_estimate_nft_mint_fee`\n- `gala_launchpad_estimate_nft_operation_fees`\n- `gala_launchpad_check_nft_collection_available`\n- `gala_launchpad_claim_nft_collection`\n- `gala_launchpad_fetch_nft_collections`\n- `gala_launchpad_create_nft_token_class`\n- `gala_launchpad_fetch_nft_token_classes`\n- `gala_launchpad_mint_nft`\n- `gala_launchpad_fetch_nft_balances`\n"
-        }
-      ]
-    }
-  ],
-  "demoConversations": [
-    {
-      "topicKey": "api-key-management",
-      "label": "Api key management",
-      "category": "api-keys",
-      "description": "API key management",
-      "methodCount": 6,
-      "exchanges": [
-        {
-          "userQuestion": "How do I manage API keys?",
-          "assistantResponse": "\n# API Key Management - SDK v5.6.0+\n\nUser-managed API keys with role-based permissions for delegating token management\nauthority to third-party services or automated systems.\n\n**CRITICAL**: Raw API keys are ONLY shown once at creation time. Store them\nsecurely immediately - they cannot be retrieved again.\n\n## Creating API Keys\n\n```typescript\nimport { createLaunchpadSDK, API_KEY_ROLE } from '@gala-chain/launchpad-sdk';\n\nconst sdk = createLaunchpadSDK({\n  privateKey: process.env.PRIVATE_KEY,\n});\n\n// MUST authenticate first\nawait sdk.login();\n\n// Create a moderator key for specific tokens\nconst result = await sdk.createApiKey({\n  role: API_KEY_ROLE.MODERATOR,\n  description: 'Chat moderation bot',\n  delegateAllTokens: false,\n  tokenNames: ['mytoken', 'othertoken'],\n  expiresAt: '2025-12-31T23:59:59Z', // Optional expiration\n});\n\n// CRITICAL: Save this immediately - shown only once!\nconsole.log('Raw Key:', result.rawKey);\n// Format: glp_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxx\nconsole.log('Key ID:', result.id);\nconsole.log('Prefix:', result.keyPrefix);\n```\n\n## Role Hierarchy\n\n```typescript\nimport { API_KEY_ROLE, API_KEY_ROLE_HIERARCHY } from '@gala-chain/launchpad-sdk';\n\n// Available roles (hierarchical)\nAPI_KEY_ROLE.MODERATOR          // Chat, comments, bans\nAPI_KEY_ROLE.TECHNICAL_PRODUCER // Simulcast, stream key, stop/start\nAPI_KEY_ROLE.MANAGER            // Moderator + Technical Producer + recordings\nAPI_KEY_ROLE.OWNER              // Full access (indistinguishable from normal auth)\n\n// Role hierarchy levels\nAPI_KEY_ROLE_HIERARCHY.MODERATOR           // 1\nAPI_KEY_ROLE_HIERARCHY.TECHNICAL_PRODUCER  // 1\nAPI_KEY_ROLE_HIERARCHY.MANAGER             // 2\nAPI_KEY_ROLE_HIERARCHY.OWNER               // 3\n\n// Check if role has sufficient permission\nimport { roleHasSufficientPermission } from '@gala-chain/launchpad-sdk';\n\nconst canManage = roleHasSufficientPermission('MANAGER', 'MODERATOR'); // true\nconst canOwn = roleHasSufficientPermission('MODERATOR', 'OWNER');      // false\n```\n\n## Token Delegation\n\n```typescript\n// Delegate all tokens (current and future)\nconst allTokensKey = await sdk.createApiKey({\n  role: API_KEY_ROLE.MODERATOR,\n  description: 'All tokens moderator',\n  delegateAllTokens: true,\n});\n\n// Delegate specific tokens only\nconst specificKey = await sdk.createApiKey({\n  role: API_KEY_ROLE.MANAGER,\n  description: 'Project manager for specific tokens',\n  delegateAllTokens: false,\n  tokenNames: ['token1', 'token2', 'token3'], // Case-insensitive\n});\n```\n\n## Listing and Getting API Keys\n\n```typescript\n// List all API keys (paginated)\nconst list = await sdk.listApiKeys({\n  page: 1,\n  limit: 20,\n});\nconsole.log('Total keys:', list.meta.total);\n\nfor (const key of list.apiKeys) {\n  console.log(`- ${key.keyPrefix}: ${key.role}`);\n  console.log(`  Description: ${key.description || 'None'}`);\n  console.log(`  Last used: ${key.lastUsedAt || 'Never'}`);\n  console.log(`  Expires: ${key.expiresAt || 'Never'}`);\n}\n\n// Get single API key by ID\nconst key = await sdk.getApiKey(123);\nconsole.log('Key details:', key);\n```\n\n## Updating API Keys\n\n```typescript\n// Update description\nconst updated = await sdk.updateApiKey(123, {\n  description: 'Updated description',\n});\n\n// Upgrade role\nawait sdk.updateApiKey(123, {\n  role: API_KEY_ROLE.MANAGER,\n});\n\n// Change token delegation\nawait sdk.updateApiKey(123, {\n  delegateAllTokens: true,\n});\n\n// Update specific token access (replaces existing)\nawait sdk.updateApiKey(123, {\n  delegateAllTokens: false,\n  tokenNames: ['newtoken1', 'newtoken2'],\n});\n\n// Update expiration (null to remove)\nawait sdk.updateApiKey(123, {\n  expiresAt: '2026-12-31T23:59:59Z',\n});\n\n// Remove expiration\nawait sdk.updateApiKey(123, {\n  expiresAt: null,\n});\n```\n\n## Revoking API Keys\n\n```typescript\n// Revoke (soft delete) an API key\nawait sdk.revokeApiKey(123);\nconsole.log('API key revoked');\n\n// Key is now unusable - attempts to use it will fail with 401\n```\n\n## Getting Available Roles\n\n```typescript\n// Get list of valid roles\nconst roles = sdk.getApiKeyRoles();\nconsole.log('Available roles:', roles);\n// ['MODERATOR', 'TECHNICAL_PRODUCER', 'MANAGER', 'OWNER']\n```\n\n## Validation Helpers\n\n```typescript\nimport {\n  isValidApiKeyRole,\n  validateCreateApiKeyOptions,\n  validateUpdateApiKeyOptions,\n} from '@gala-chain/launchpad-sdk';\n\n// Validate role string\nif (isValidApiKeyRole('MODERATOR')) {\n  console.log('Valid role');\n}\n\n// Validate creation options\nconst createErrors = validateCreateApiKeyOptions({\n  role: 'MODERATOR',\n  description: 'Test key',\n});\nif (createErrors.length > 0) {\n  console.error('Validation errors:', createErrors);\n}\n\n// Validate update options\nconst updateErrors = validateUpdateApiKeyOptions({\n  role: 'MANAGER',\n  expiresAt: '2025-12-31T23:59:59Z',\n});\n```\n\n## SDK Methods Reference\n\n| Method | Description | Auth |\n|--------|-------------|------|\n| `createApiKey(options)` | Create new API key | JWT |\n| `listApiKeys(options?)` | List API keys (paginated) | JWT |\n| `getApiKey(id)` | Get API key by ID | JWT |\n| `updateApiKey(id, options)` | Update API key | JWT |\n| `revokeApiKey(id)` | Revoke (soft delete) key | JWT |\n| `getApiKeyRoles()` | Get valid role list | None |\n\n**MCP Tool Equivalents:**\n- `gala_launchpad_create_api_key`\n- `gala_launchpad_list_api_keys`\n- `gala_launchpad_get_api_key`\n- `gala_launchpad_update_api_key`\n- `gala_launchpad_revoke_api_key`\n- `gala_launchpad_get_api_key_roles`\n"
-        },
-        {
-          "userQuestion": "What parameters does createApiKey() accept?",
-          "assistantResponse": "The primary methods for Api key management are `createApiKey()`, `listApiKeys()`, `getApiKey()`. Each method accepts configuration options as a single object parameter.\n\n**Common Parameters:**\n- `tokenName`: The token identifier (e.g., 'dragnrkti')\n- `amount`: Quantity as a string (for precision)\n- Wallet/auth options when transactions are involved\n\nCheck the SDK documentation or use TypeScript intellisense for the complete parameter interface."
-        },
-        {
-          "userQuestion": "What are best practices for manage API keys?",
-          "assistantResponse": "1. **Use TypeScript**: Get full type safety and intellisense.\n2. **Handle errors**: Always wrap SDK calls in try-catch blocks.\n3. **Validate inputs**: Check parameters before making API calls.\n4. **Cache when appropriate**: Reduce API calls for static data."
-        },
-        {
-          "userQuestion": "What errors should I handle when manage API keys?",
-          "assistantResponse": "**General Error Handling:**\n\n```typescript\ntry {\n  const result = await sdk.apikeymanagement(...);\n} catch (error) {\n  if (error instanceof Error) {\n    console.error('Operation failed:', error.message);\n    // Handle specific error types\n  }\n}\n```\n\n**Common Issues:**\n- Network timeouts - implement retry logic\n- Invalid parameters - validate before calling\n- Authentication errors - ensure valid session"
-        },
-        {
-          "userQuestion": "Can you walk me through a complete manage API keys example?",
-          "assistantResponse": "**Complete Workflow: Api key management**\n\nHere's the typical flow: `createApiKey()` → `listApiKeys()` → `getApiKey()`\n\n**Step-by-Step:**\n1. **Setup**: Initialize SDK with your configuration\n2. **Validate**: Check prerequisites (balances, permissions)\n3. **Calculate**: Use calculation methods to preview results\n4. **Execute**: Perform the main operation\n5. **Verify**: Confirm the operation succeeded\n\n**Pro Tip:** The SDK methods are designed to be called in sequence. Each step provides data needed for the next."
-        },
-        {
-          "userQuestion": "What other methods are available for Api key management?",
-          "assistantResponse": "**Additional Methods:**\n\n- `updateApiKey()`\n- `revokeApiKey()`\n- `getApiKeyRoles()`\n\n**Total methods in this topic:** 6\n\nEach method serves a specific purpose in the workflow. Use TypeScript intellisense or the SDK documentation to explore parameter options for each method."
-        },
-        {
-          "userQuestion": "When would I actually use manage API keys in a real application?",
-          "assistantResponse": "**Real-World Use Cases:**\n\n1. **Backend Services**: Server-to-server authentication\n2. **Rate Limiting**: Separate keys for different services\n3. **Access Control**: Role-based permissions per key\n4. **Key Rotation**: Regular security key updates"
-        },
-        {
-          "userQuestion": "What should I learn next after manage API keys?",
-          "assistantResponse": "**Related Topics:**\n\n- **Session auth**: `explainSdkUsage({ topic: 'session-auth' })`\n- **Profile management**: `explainSdkUsage({ topic: 'profile-management' })`\n\n**Learning Path:** Start with the basics, then explore related topics to build a complete understanding of the SDK capabilities."
-        }
-      ]
-    },
-    {
-      "topicKey": "session-auth",
-      "label": "Session auth",
-      "category": "auth",
-      "description": "JWT session authentication",
-      "methodCount": 8,
-      "exchanges": [
-        {
-          "userQuestion": "How do I manage JWT authentication?",
-          "assistantResponse": "\n# Session Authentication (JWT) - SDK v5.1.0+\n\nJWT-based session authentication for protected operations (streaming, chat, profile updates).\n\n## Authentication Flow\n\n```typescript\nimport { createLaunchpadSDK } from '@gala-chain/launchpad-sdk';\n\nconst sdk = createLaunchpadSDK({\n  privateKey: process.env.PRIVATE_KEY,\n  environment: 'production',\n});\n\n// 1. Login to get JWT token\nconst session = await sdk.login();\nconsole.log('Authenticated:', session.address);\nconsole.log('Token expires in:', session.expiresIn, 'seconds');\n\n// 2. Check authentication status\nif (sdk.isAuthenticated()) {\n  console.log('Session is valid');\n}\n\n// 3. Get current session info\nconst info = await sdk.getSession();\nconsole.log('Session issued at:', info.issuedAt);\nconsole.log('Session expires at:', info.expiresAt);\n\n// 4. Access token directly (for custom requests)\nconst token = sdk.getAccessToken();\nconsole.log('JWT token:', token);\n\n// 5. Refresh token before expiry\nif (sdk.shouldRefreshToken()) {\n  const refreshed = await sdk.refreshToken();\n  console.log('Token refreshed, new expiry:', refreshed.expiresIn);\n}\n\n// 6. Ensure valid token (auto-refreshes if needed)\nconst validToken = await sdk.ensureValidToken();\nconsole.log('Valid token obtained');\n\n// 7. Logout when done\nsdk.logout();\nconsole.log('Logged out');\n```\n\n## Auto-Refresh Behavior\n\nThe SDK automatically refreshes tokens when:\n- Token expires within 5 minutes (default threshold)\n- Making requests to JWT-protected endpoints\n\n```typescript\n// Manual refresh threshold check\nconst shouldRefresh = sdk.shouldRefreshToken(10 * 60 * 1000); // 10 min threshold\n\n// ensureValidToken auto-refreshes if needed\nconst token = await sdk.ensureValidToken(5 * 60 * 1000); // 5 min threshold\n```\n\n## Protected Endpoints\n\nThese operations require JWT authentication (call \\`login()\\` first):\n\n**Streaming:**\n- \\`startStream()\\` - Start live stream\n- \\`resetStreamKey()\\` - Reset RTMP key\n- \\`getRecordingDownload()\\` - Download recordings\n- \\`deleteRecording()\\` - Delete recordings\n- \\`addSimulcastTarget()\\` - Add simulcast\n- \\`removeSimulcastTarget()\\` - Remove simulcast\n\n**Chat:**\n- \\`sendChatMessage()\\` - Send chat messages\n\n**Profile:**\n- \\`updateProfile()\\` - Update user profile\n\n**Uploads:**\n- \\`uploadTokenImage()\\` - Upload token images\n- \\`uploadProfileImage()\\` - Upload profile images\n\n## Error Handling\n\n```typescript\ntry {\n  await sdk.login();\n} catch (error) {\n  if (error.message.includes('signature')) {\n    console.error('Wallet signature failed');\n  } else if (error.message.includes('network')) {\n    console.error('Network error during login');\n  }\n}\n\n// Check auth before protected operations\nif (!sdk.isAuthenticated()) {\n  await sdk.login();\n}\n\ntry {\n  await sdk.startStream('mytoken');\n} catch (error) {\n  if (error.message.includes('JWT') || error.message.includes('token')) {\n    // Re-authenticate and retry\n    await sdk.login();\n    await sdk.startStream('mytoken');\n  }\n}\n```\n\n## Session Methods Reference\n\n| Method | Description | Returns |\n|--------|-------------|---------|\n| \\`login()\\` | Authenticate with wallet signature | \\`{ accessToken, expiresIn, address }\\` |\n| \\`logout()\\` | Clear JWT token (client-side) | \\`void\\` |\n| \\`refreshToken()\\` | Get new JWT token | \\`{ accessToken, expiresIn, address }\\` |\n| \\`getSession()\\` | Get session info | \\`{ address, issuedAt, expiresAt }\\` |\n| \\`isAuthenticated()\\` | Check if token exists and valid | \\`boolean\\` |\n| \\`shouldRefreshToken(threshold?)\\` | Check if refresh needed | \\`boolean\\` |\n| \\`getAccessToken()\\` | Get raw JWT token | \\`string | null\\` |\n| \\`ensureValidToken(threshold?)\\` | Auto-refresh if needed | \\`Promise<string>\\` |\n\n## Dev Bypass (STAGE Only)\n\nFor testing in STAGE environment without JWT:\n\n```typescript\nconst sdk = createLaunchpadSDK({\n  privateKey: process.env.PRIVATE_KEY,\n  environment: 'development',\n  devBypass: true, // Skip JWT auth in STAGE\n});\n\n// Protected methods work without login() in STAGE\nawait sdk.startStream('testtoken');\n```\n\n**Note:** Dev bypass only works in STAGE/development environments.\n"
-        },
-        {
-          "userQuestion": "What parameters does login() accept?",
-          "assistantResponse": "The primary methods for Session auth are `login()`, `logout()`, `refreshToken()`. Each method accepts configuration options as a single object parameter.\n\n**Common Parameters:**\n- `tokenName`: The token identifier (e.g., 'dragnrkti')\n- `amount`: Quantity as a string (for precision)\n- Wallet/auth options when transactions are involved\n\nCheck the SDK documentation or use TypeScript intellisense for the complete parameter interface."
-        },
-        {
-          "userQuestion": "What are best practices for manage JWT authentication?",
-          "assistantResponse": "1. **Refresh tokens proactively**: Use `shouldRefreshToken()` to check before expiration.\n2. **Handle logout gracefully**: Clear local state when session ends.\n3. **Secure token storage**: Never expose tokens in client-side code."
-        },
-        {
-          "userQuestion": "What errors should I handle when manage JWT authentication?",
-          "assistantResponse": "**Common Errors:**\n- `TokenExpired`: JWT expired - call `refreshToken()`\n- `InvalidSignature`: Wallet signature failed\n- `SessionNotFound`: Not logged in - call `login()` first\n\n**Pattern:** Use `ensureValidToken()` before authenticated calls."
-        },
-        {
-          "userQuestion": "Can you walk me through a complete manage JWT authentication example?",
-          "assistantResponse": "**Complete Workflow: Session auth**\n\nHere's the typical flow: `login()` → `logout()` → `refreshToken()`\n\n**Step-by-Step:**\n1. **Setup**: Initialize SDK with your configuration\n2. **Validate**: Check prerequisites (balances, permissions)\n3. **Calculate**: Use calculation methods to preview results\n4. **Execute**: Perform the main operation\n5. **Verify**: Confirm the operation succeeded\n\n**Pro Tip:** The SDK methods are designed to be called in sequence. Each step provides data needed for the next."
-        },
-        {
-          "userQuestion": "What edge cases should I know about for manage JWT authentication?",
-          "assistantResponse": "**Edge Cases:**\n1. **Token refresh race**: Multiple tabs can cause refresh conflicts\n2. **Wallet switching**: Changing wallets requires new login\n3. **Session persistence**: Tokens stored in memory by default\n\n**Gotcha:** `shouldRefreshToken()` checks remaining time - refresh before expiration!"
-        },
-        {
-          "userQuestion": "What other methods are available for Session auth?",
-          "assistantResponse": "**Additional Methods:**\n\n- `getSession()`\n- `isAuthenticated()`\n- `shouldRefreshToken()`\n- `getAccessToken()`\n\n**Total methods in this topic:** 8\n\nEach method serves a specific purpose in the workflow. Use TypeScript intellisense or the SDK documentation to explore parameter options for each method."
-        },
-        {
-          "userQuestion": "When would I actually use manage JWT authentication in a real application?",
-          "assistantResponse": "**Real-World Use Cases:**\n\n1. **Web Apps**: Authenticate users for full SDK access\n2. **Bot Authentication**: Automated services needing auth\n3. **Multi-Tenant Apps**: Per-user session management\n4. **Mobile Apps**: Persistent authenticated sessions"
-        },
-        {
-          "userQuestion": "What should I learn next after manage JWT authentication?",
-          "assistantResponse": "**Related Topics:**\n\n- **Api key management**: `explainSdkUsage({ topic: 'api-key-management' })`\n- **Profile management**: `explainSdkUsage({ topic: 'profile-management' })`\n- **Streaming**: `explainSdkUsage({ topic: 'streaming' })`\n\n**Learning Path:** Start with the basics, then explore related topics to build a complete understanding of the SDK capabilities."
-        }
-      ]
-    },
-    {
-      "topicKey": "account-management",
-      "label": "Account management",
-      "category": "balance",
-      "description": "Balance queries and portfolio management",
-      "methodCount": 1,
-      "exchanges": [
-        {
-          "userQuestion": "How do I manage your account?",
-          "assistantResponse": "\n# Account Management\n\nThe SDK provides methods for account registration and management.\n\n## Register Account\n\nRegister an account for trading on Gala. This should be called before the first purchase\nto ensure the wallet is ready for trading operations.\n\n```typescript\nimport { createLaunchpadSDK } from '@gala-chain/launchpad-sdk';\n\nasync function registerAccount() {\n  const sdk = createLaunchpadSDK({ wallet: 'your-private-key' });\n\n  // Register the SDK wallet\n  const result = await sdk.registerAccount();\n  console.log('Account exists:', result.exists);\n  console.log('Wallet alias:', result.walletAlias);\n\n  // Register a specific address\n  const otherResult = await sdk.registerAccount({\n    address: '0x1234...'  // Supports eth|, 0x, or client| formats\n  });\n  console.log('Other account exists:', otherResult.exists);\n}\n```\n\n**Response Structure:**\n```typescript\ninterface RegisterAccountResult {\n  exists: boolean;       // Whether account is registered\n  walletAlias: string;   // Normalized wallet alias (client|...)\n}\n```\n\n**MCP Tool Equivalents:**\n- `gala_launchpad_register_account`\n"
-        },
-        {
-          "userQuestion": "What parameters does registerAccount() accept?",
-          "assistantResponse": "The primary methods for Account management are `registerAccount()`. Each method accepts configuration options as a single object parameter.\n\n**Common Parameters:**\n- `tokenName`: The token identifier (e.g., 'dragnrkti')\n- `amount`: Quantity as a string (for precision)\n- Wallet/auth options when transactions are involved\n\nCheck the SDK documentation or use TypeScript intellisense for the complete parameter interface."
-        },
-        {
-          "userQuestion": "What are best practices for manage your account?",
-          "assistantResponse": "1. **Use TypeScript**: Get full type safety and intellisense.\n2. **Handle errors**: Always wrap SDK calls in try-catch blocks.\n3. **Validate inputs**: Check parameters before making API calls.\n4. **Cache when appropriate**: Reduce API calls for static data."
-        },
-        {
-          "userQuestion": "What should I learn next after manage your account?",
-          "assistantResponse": "**Related Topics:**\n\n- Check the SDK documentation for related functionality\n\n**Learning Path:** Start with the basics, then explore related topics to build a complete understanding of the SDK capabilities."
-        },
-        {
-          "userQuestion": "Any final tips for manage your account?",
-          "assistantResponse": "**Quick Tips:**\n\n1. **Start Simple**: Begin with the basic use case before exploring advanced features\n2. **Use TypeScript**: The SDK has full TypeScript support for better autocomplete and type safety\n3. **Check the Demos**: The examples/ directory has working demos for most SDK features\n4. **Read Error Messages**: SDK errors include helpful context for troubleshooting\n\nYou're ready to start building with this feature!"
-        }
-      ]
-    },
-    {
-      "topicKey": "balances",
-      "label": "Balances",
-      "category": "balance",
-      "description": "Balance queries and portfolio management",
-      "methodCount": 5,
-      "exchanges": [
-        {
-          "userQuestion": "How do I check token balances?",
-          "assistantResponse": "\n## Checking Balances with SDK\n\n**Covers Methods:**\n- `fetchGalaBalance()`\n- `fetchTokenBalance()`\n- `fetchTokensHeld()`\n- `fetchTokensCreated()`\n- `fetchProfile()`\n\n```typescript\nimport { createLaunchpadSDK } from '@gala-chain/launchpad-sdk';\n\nasync function checkBalances() {\n  const sdk = createLaunchpadSDK({\n    wallet: 'your-private-key'\n  });\n\n  // Check GALA balance\n  const galaBalance = await sdk.fetchGalaBalance();\n  console.log(`GALA: ${galaBalance.balance}`);\n  console.log(`Decimals: ${galaBalance.decimals}`);\n  console.log(`Last updated: ${galaBalance.lastUpdated.toISOString()}`);\n\n  // Check specific token balance\n  const tokenBalance = await sdk.fetchTokenBalance({\n    tokenName: 'dragnrkti',\n    address: sdk.getAddress()\n  });\n\n  console.log(`Token: ${tokenBalance.quantity}`);\n  console.log(`USD value: $${tokenBalance.holdingPriceUsd}`);\n  console.log(`GALA value: ${tokenBalance.holdingPriceGala}`);\n\n  // Check all tokens held\n  const portfolio = await sdk.fetchTokensHeld({\n    address: sdk.getAddress(),\n    limit: 20\n  });\n\n  console.log(`Holding ${portfolio.total} different tokens`);\n  portfolio.tokens.forEach(token => {\n    console.log(`${token.name}: ${token.quantity}`);\n  });\n\n  // Check tokens created by this wallet\n  const createdTokens = await sdk.fetchTokensCreated({\n    address: sdk.getAddress(),\n    limit: 10\n  });\n\n  console.log(`Created ${createdTokens.total} tokens`);\n  createdTokens.tokens.forEach(token => {\n    console.log(`  ${token.symbol}: ${token.name}`);\n  });\n\n  // Get user profile\n  const profile = await sdk.fetchProfile();\n  console.log(`Profile: ${profile.fullName}`);\n\n  // Check profile of another user\n  const otherProfile = await sdk.fetchProfile('eth|0x...');\n  console.log(`Other user: ${otherProfile.fullName}`);\n}\n```\n\n**MCP Tool Equivalents:**\n- `gala_launchpad_fetch_gala_balance`\n- `gala_launchpad_fetch_token_balance`\n- `gala_launchpad_fetch_tokens_held`\n- `gala_launchpad_fetch_tokens_created`\n- `gala_launchpad_fetch_profile`\n- `gala_launchpad_fetch_available_balance`\n- `gala_launchpad_fetch_locked_tokens`\n\n### Available vs Locked Balance\n\n```typescript\n// Get available balance (excludes locked/escrowed tokens)\nconst available = await sdk.fetchAvailableBalance({\n  tokenName: 'anime',\n  address: walletAddress\n});\n\n// Get locked tokens with details\nconst locked = await sdk.fetchLockedTokens({\n  tokenName: 'anime',\n  address: walletAddress\n});\n\nconsole.log('Available:', available.quantity);\nconsole.log('Locked:', locked.lockedQuantity);\n```\n"
-        },
-        {
-          "userQuestion": "What parameters does fetchGalaBalance() accept?",
-          "assistantResponse": "The primary methods for Balances are `fetchGalaBalance()`, `fetchTokenBalance()`, `fetchTokensHeld()`. Each method accepts configuration options as a single object parameter.\n\n**Common Parameters:**\n- `tokenName`: The token identifier (e.g., 'dragnrkti')\n- `amount`: Quantity as a string (for precision)\n- Wallet/auth options when transactions are involved\n\nCheck the SDK documentation or use TypeScript intellisense for the complete parameter interface."
-        },
-        {
-          "userQuestion": "What are best practices for check token balances?",
-          "assistantResponse": "1. **Use TypeScript**: Get full type safety and intellisense.\n2. **Handle errors**: Always wrap SDK calls in try-catch blocks.\n3. **Validate inputs**: Check parameters before making API calls.\n4. **Cache when appropriate**: Reduce API calls for static data."
-        },
-        {
-          "userQuestion": "Can you walk me through a complete check token balances example?",
-          "assistantResponse": "**Complete Workflow: Balances**\n\nHere's the typical flow: `fetchGalaBalance()` → `fetchTokenBalance()` → `fetchTokensHeld()`\n\n**Step-by-Step:**\n1. **Setup**: Initialize SDK with your configuration\n2. **Validate**: Check prerequisites (balances, permissions)\n3. **Calculate**: Use calculation methods to preview results\n4. **Execute**: Perform the main operation\n5. **Verify**: Confirm the operation succeeded\n\n**Pro Tip:** The SDK methods are designed to be called in sequence. Each step provides data needed for the next."
-        },
-        {
-          "userQuestion": "What other methods are available for Balances?",
-          "assistantResponse": "**Additional Methods:**\n\n- `fetchTokensCreated()`\n- `fetchAvailableBalance()`\n\n**Total methods in this topic:** 5\n\nEach method serves a specific purpose in the workflow. Use TypeScript intellisense or the SDK documentation to explore parameter options for each method."
-        },
-        {
-          "userQuestion": "What should I learn next after check token balances?",
-          "assistantResponse": "**Related Topics:**\n\n- **Transfers**: `explainSdkUsage({ topic: 'transfers' })`\n- **Locks**: `explainSdkUsage({ topic: 'locks' })`\n- **Fetch pools**: `explainSdkUsage({ topic: 'fetch-pools' })`\n\n**Learning Path:** Start with the basics, then explore related topics to build a complete understanding of the SDK capabilities."
-        }
-      ]
-    },
-    {
-      "topicKey": "profile-management",
-      "label": "Profile management",
-      "category": "balance",
-      "description": "Balance queries and portfolio management",
-      "methodCount": 4,
-      "exchanges": [
-        {
-          "userQuestion": "How do I manage user profiles?",
-          "assistantResponse": "\n## User Profile Management with SDK\n\n**Covers Methods:**\n- `fetchProfile()`\n- `updateProfile()`\n- `uploadProfileImage()`\n\n```typescript\nimport { createLaunchpadSDK } from '@gala-chain/launchpad-sdk';\n\nasync function manageUserProfiles() {\n  const sdk = createLaunchpadSDK({\n    wallet: 'your-private-key-or-mnemonic'\n  });\n\n  // Fetch current user profile\n  const myProfile = await sdk.fetchProfile();\n  console.log(`Name: ${myProfile.fullName}`);\n  console.log(`Avatar: ${myProfile.profileImage}`);\n\n  // Fetch another user's profile\n  const other = await sdk.fetchProfile('eth|0x...');\n  console.log(`Other user: ${other.fullName}`);\n\n  // Update profile\n  const updated = await sdk.updateProfile({\n    fullName: 'Satoshi Nakamoto',\n    profileImage: 'https://example.com/avatar.png',\n    address: sdk.getAddress()\n  });\n\n  console.log(`Updated: ${updated.fullName}`);\n\n  // Upload profile image (Node.js only)\n  const imgResult = await sdk.uploadProfileImage({\n    imagePath: '/path/to/avatar.png'\n  });\n\n  // Update with uploaded image\n  await sdk.updateProfile({\n    fullName: 'My Name',\n    profileImage: imgResult.imageUrl,\n    address: sdk.getAddress()\n  });\n\n  // Complete workflow: Update profile, then launch token\n  async function createTokenWithProfile() {\n    const avatar = await sdk.uploadProfileImage({\n      imagePath: '/path/to/pic.png'\n    });\n\n    await sdk.updateProfile({\n      fullName: 'Token Creator',\n      profileImage: avatar.imageUrl,\n      address: sdk.getAddress()\n    });\n\n    const logo = await sdk.uploadTokenImage({\n      tokenName: 'mytoken',\n      imagePath: '/path/to/logo.png'\n    });\n\n    const result = await sdk.launchToken({\n      tokenName: 'mytoken',\n      tokenSymbol: 'MTK',\n      tokenDescription: 'Awesome token',\n      tokenImage: logo.imageUrl,\n      websiteUrl: 'https://mytoken.com'\n    });\n\n    return result;\n  }\n\n  // Batch profile fetching\n  const addresses = ['eth|0xaddress1', 'eth|0xaddress2'];\n  const profiles = await Promise.all(\n    addresses.map(addr => sdk.fetchProfile(addr).catch(() => null))\n  );\n\n  console.log('Profiles:', profiles.filter(p => p).map(p => p.fullName));\n}\n```\n\n**Profile Methods:**\n- `fetchProfile(address?)` - Get user profile\n- `updateProfile(data)` - Update profile info\n- `uploadProfileImage(options)` - Upload avatar (Node.js)\n- `getManagedTokens()` - Get tokens you manage (creator, moderator, manager, technical producer)\n\n**Profile Fields:**\n- `fullName` - Display name (max 100 chars)\n- `profileImage` - Avatar image URL\n- `address` - Wallet address\n- `createdAt` - Creation date\n- `updatedAt` - Update timestamp\n\n**Use Cases:**\n- Display user profiles\n- Allow profile customization\n- Manage profile images\n- Token creator attribution\n- Multi-wallet profiles\n\n**MCP Tool Equivalents:**\n- `gala_launchpad_fetch_profile`\n- `gala_launchpad_update_profile`\n- `gala_launchpad_upload_profile_image`\n- `gala_launchpad_get_managed_tokens`\n"
-        },
-        {
-          "userQuestion": "What parameters does fetchProfile() accept?",
-          "assistantResponse": "The primary methods for Profile management are `fetchProfile()`, `updateProfile()`, `uploadProfileImage()`. Each method accepts configuration options as a single object parameter.\n\n**Common Parameters:**\n- `tokenName`: The token identifier (e.g., 'dragnrkti')\n- `amount`: Quantity as a string (for precision)\n- Wallet/auth options when transactions are involved\n\nCheck the SDK documentation or use TypeScript intellisense for the complete parameter interface."
-        },
-        {
-          "userQuestion": "What are best practices for manage user profiles?",
-          "assistantResponse": "1. **Use TypeScript**: Get full type safety and intellisense.\n2. **Handle errors**: Always wrap SDK calls in try-catch blocks.\n3. **Validate inputs**: Check parameters before making API calls.\n4. **Cache when appropriate**: Reduce API calls for static data."
-        },
-        {
-          "userQuestion": "Can you walk me through a complete manage user profiles example?",
-          "assistantResponse": "**Complete Workflow: Profile management**\n\nHere's the typical flow: `fetchProfile()` → `updateProfile()` → `uploadProfileImage()`\n\n**Step-by-Step:**\n1. **Setup**: Initialize SDK with your configuration\n2. **Validate**: Check prerequisites (balances, permissions)\n3. **Calculate**: Use calculation methods to preview results\n4. **Execute**: Perform the main operation\n5. **Verify**: Confirm the operation succeeded\n\n**Pro Tip:** The SDK methods are designed to be called in sequence. Each step provides data needed for the next."
-        },
-        {
-          "userQuestion": "What should I learn next after manage user profiles?",
-          "assistantResponse": "**Related Topics:**\n\n- **Session auth**: `explainSdkUsage({ topic: 'session-auth' })`\n- **Balances**: `explainSdkUsage({ topic: 'balances' })`\n- **Referral system**: `explainSdkUsage({ topic: 'referral-system' })`\n\n**Learning Path:** Start with the basics, then explore related topics to build a complete understanding of the SDK capabilities."
-        }
-      ]
-    },
-    {
-      "topicKey": "ban-management",
-      "label": "Ban management",
-      "category": "ban",
-      "description": "User bans and moderation",
-      "methodCount": 5,
-      "exchanges": [
-        {
-          "userQuestion": "How do I manage user bans?",
-          "assistantResponse": "\n# Ban/Moderation Operations - SDK v5.5.0+\n\nUser ban management for stream moderation, including creating bans, removing bans,\nlisting banned users, checking ban status, and viewing active users.\n\n## Creating and Removing Bans\n\n```typescript\nimport { createLaunchpadSDK, BAN_DURATIONS } from '@gala-chain/launchpad-sdk';\n\nconst sdk = createLaunchpadSDK({\n  privateKey: process.env.PRIVATE_KEY,\n  streamAdminApiKey: process.env.STREAM_ADMIN_API_KEY, // Admin key for ban ops\n});\n\n// Create a permanent ban\nconst permanentBan = await sdk.createBan({\n  tokenName: 'mytoken',\n  userAddress: 'eth|0x1234567890abcdef1234567890abcdef12345678',\n  reason: 'Spamming chat',\n});\nconsole.log('Permanent ban created:', permanentBan.ban.id);\n\n// Create a temporary ban (1 hour)\nconst tempBan = await sdk.createBan({\n  tokenName: 'mytoken',\n  userAddress: 'eth|0xabcdef1234567890abcdef1234567890abcdef12',\n  reason: 'Inappropriate behavior',\n  durationSeconds: BAN_DURATIONS.ONE_HOUR, // 3600 seconds\n});\nconsole.log('Temp ban expires:', tempBan.ban.expiresAt);\n\n// Remove a ban (unban user)\nconst unbanned = await sdk.removeBan({\n  tokenName: 'mytoken',\n  userAddress: 'eth|0x1234567890abcdef1234567890abcdef12345678',\n});\nconsole.log('User unbanned:', unbanned.removed);\n```\n\n## Duration Presets\n\n```typescript\nimport { BAN_DURATIONS } from '@gala-chain/launchpad-sdk';\n\n// Available presets\nBAN_DURATIONS.ONE_HOUR   // 3600 seconds (1 hour)\nBAN_DURATIONS.ONE_DAY    // 86400 seconds (24 hours)\nBAN_DURATIONS.ONE_WEEK   // 604800 seconds (7 days)\nBAN_DURATIONS.ONE_MONTH  // 2592000 seconds (30 days)\n\n// Custom duration (min: 60 sec, max: 31536000 sec / 1 year)\nconst customBan = await sdk.createBan({\n  tokenName: 'mytoken',\n  userAddress: 'eth|0x...',\n  durationSeconds: 7200, // 2 hours\n});\n```\n\n## Listing Bans\n\n```typescript\n// List all bans for a token\nconst allBans = await sdk.listBans({\n  tokenName: 'mytoken',\n  page: 1,\n  limit: 20,\n});\nconsole.log('Total bans:', allBans.meta.total);\n\nfor (const ban of allBans.bans) {\n  console.log(`- ${ban.userAddress}: ${ban.reason || 'No reason'}`);\n  console.log(`  Permanent: ${ban.isPermanent}`);\n  console.log(`  Expires: ${ban.expiresAt || 'Never'}`);\n}\n\n// Search bans by user\nconst searchResults = await sdk.listBans({\n  tokenName: 'mytoken',\n  search: '0x1234', // Searches userAddress OR fullName\n});\n\n// Filter by specific field\nconst filteredBans = await sdk.listBans({\n  tokenName: 'mytoken',\n  userAddress: '0x1234', // Filter by address only\n  name: 'John',          // Filter by display name only\n});\n```\n\n## Checking Ban Status\n\n```typescript\n// Check if specific user is banned\nconst status = await sdk.getBanStatus({\n  tokenName: 'mytoken',\n  userAddress: 'eth|0x1234567890abcdef1234567890abcdef12345678',\n});\n\nif (status.banned) {\n  console.log('User is banned!');\n  console.log('Reason:', status.ban?.reason);\n  console.log('Permanent:', status.ban?.isPermanent);\n  console.log('Expires:', status.ban?.expiresAt);\n} else {\n  console.log('User is not banned');\n}\n```\n\n## Viewing Active Users\n\n```typescript\nimport { ACTIVE_USER_TYPE } from '@gala-chain/launchpad-sdk';\n\n// Get all active viewers\nconst viewers = await sdk.getActiveUsers({\n  tokenName: 'mytoken',\n  type: ACTIVE_USER_TYPE.VIEWERS, // or 'viewers'\n});\nconsole.log('Active viewers:', viewers.total);\n\n// Get only chat participants\nconst chatters = await sdk.getActiveUsers({\n  tokenName: 'mytoken',\n  type: ACTIVE_USER_TYPE.CHAT_PARTICIPANTS, // or 'chat_participants'\n});\nconsole.log('Chat participants:', chatters.total);\n\n// Search active users\nconst searchActive = await sdk.getActiveUsers({\n  tokenName: 'mytoken',\n  search: 'john', // Search by name or address\n});\n\nfor (const user of searchActive.users) {\n  console.log(`- ${user.fullName || user.userAddress}`);\n  console.log(`  In chat: ${user.isChatParticipant}`);\n}\n```\n\n## Authentication\n\nBan operations support two authentication modes:\n\n1. **Admin API Key** (streamAdminApiKey) - Full moderation access\n2. **JWT Auth** (login()) - Token owner moderation only\n\n```typescript\n// Admin mode - can moderate any token\nconst adminSdk = createLaunchpadSDK({\n  privateKey: process.env.PRIVATE_KEY,\n  streamAdminApiKey: process.env.STREAM_ADMIN_API_KEY,\n});\n\n// Owner mode - can only moderate own tokens\nconst ownerSdk = createLaunchpadSDK({\n  privateKey: process.env.PRIVATE_KEY,\n});\nawait ownerSdk.login(); // JWT authentication required\n```\n\n## WebSocket Events\n\nBan events are broadcast to affected users via WebSocket:\n\n```typescript\n// Listen for ban events\nsdk.connectStreamWebSocket({\n  onUserBanned: (event) => {\n    console.log('User banned:', event.userAddress);\n    console.log('Reason:', event.reason);\n    console.log('Expires:', event.expiresAt);\n  },\n  onUserUnbanned: (event) => {\n    console.log('User unbanned:', event.userAddress);\n  },\n  onBanEnforcement: (event) => {\n    // Received when banned user tries to chat/react\n    console.log('Ban enforced for action:', event.action);\n    console.log('Reason:', event.reason);\n  },\n});\n```\n\n## SDK Methods Reference\n\n| Method | Description | Auth |\n|--------|-------------|------|\n| `createBan(options)` | Create a new ban | Admin/Owner |\n| `removeBan(options)` | Remove a ban (unban user) | Admin/Owner |\n| `listBans(options)` | List banned users | Admin/Owner |\n| `getBanStatus(options)` | Check if user is banned | Admin/Owner |\n| `getActiveUsers(options)` | Get active viewers/chatters | Admin/Owner |\n\n**MCP Tool Equivalents:**\n- `gala_launchpad_create_ban`\n- `gala_launchpad_remove_ban`\n- `gala_launchpad_list_bans`\n- `gala_launchpad_get_ban_status`\n- `gala_launchpad_get_active_users`\n"
-        },
-        {
-          "userQuestion": "What parameters does createBan() accept?",
-          "assistantResponse": "The primary methods for Ban management are `createBan()`, `removeBan()`, `listBans()`. Each method accepts configuration options as a single object parameter.\n\n**Common Parameters:**\n- `tokenName`: The token identifier (e.g., 'dragnrkti')\n- `amount`: Quantity as a string (for precision)\n- Wallet/auth options when transactions are involved\n\nCheck the SDK documentation or use TypeScript intellisense for the complete parameter interface."
-        },
-        {
-          "userQuestion": "What are best practices for manage user bans?",
-          "assistantResponse": "1. **Use TypeScript**: Get full type safety and intellisense.\n2. **Handle errors**: Always wrap SDK calls in try-catch blocks.\n3. **Validate inputs**: Check parameters before making API calls.\n4. **Cache when appropriate**: Reduce API calls for static data."
-        },
-        {
-          "userQuestion": "What errors should I handle when manage user bans?",
-          "assistantResponse": "**General Error Handling:**\n\n```typescript\ntry {\n  const result = await sdk.banmanagement(...);\n} catch (error) {\n  if (error instanceof Error) {\n    console.error('Operation failed:', error.message);\n    // Handle specific error types\n  }\n}\n```\n\n**Common Issues:**\n- Network timeouts - implement retry logic\n- Invalid parameters - validate before calling\n- Authentication errors - ensure valid session"
-        },
-        {
-          "userQuestion": "Can you walk me through a complete manage user bans example?",
-          "assistantResponse": "**Complete Workflow: Ban management**\n\nHere's the typical flow: `createBan()` → `removeBan()` → `listBans()`\n\n**Step-by-Step:**\n1. **Setup**: Initialize SDK with your configuration\n2. **Validate**: Check prerequisites (balances, permissions)\n3. **Calculate**: Use calculation methods to preview results\n4. **Execute**: Perform the main operation\n5. **Verify**: Confirm the operation succeeded\n\n**Pro Tip:** The SDK methods are designed to be called in sequence. Each step provides data needed for the next."
-        },
-        {
-          "userQuestion": "What other methods are available for Ban management?",
-          "assistantResponse": "**Additional Methods:**\n\n- `getBanStatus()`\n- `getActiveUsers()`\n\n**Total methods in this topic:** 5\n\nEach method serves a specific purpose in the workflow. Use TypeScript intellisense or the SDK documentation to explore parameter options for each method."
-        },
-        {
-          "userQuestion": "What should I learn next after manage user bans?",
-          "assistantResponse": "**Related Topics:**\n\n- **Moderator invites**: `explainSdkUsage({ topic: 'moderator-invites' })`\n- **Stream chat**: `explainSdkUsage({ topic: 'stream-chat' })`\n- **Content flag management**: `explainSdkUsage({ topic: 'content-flag-management' })`\n\n**Learning Path:** Start with the basics, then explore related topics to build a complete understanding of the SDK capabilities."
-        }
-      ]
-    },
-    {
-      "topicKey": "bridge-operations",
-      "label": "Bridge operations",
-      "category": "bridge",
-      "description": "Cross-chain bridging operations",
-      "methodCount": 21,
-      "exchanges": [
-        {
-          "userQuestion": "How do I bridge tokens across chains?",
-          "assistantResponse": "\n## Cross-Chain Bridge Operations with SDK\n\n**Covers Methods:**\n- `estimateBridgeFee()`\n- `bridgeOut()`\n- `bridgeIn()`\n- `getBridgeStatus()`\n- `getSupportedBridgeTokens()`\n- `getEthereumTransactionStatus()`\n- `getSolanaTransactionStatus()`\n- `fetchEthereumWalletTokenBalance()` / `fetchSolanaWalletTokenBalance()`\n- `fetchEthereumWalletNativeBalance()` / `fetchSolanaWalletNativeBalance()`\n- `fetchEthereumWalletAllBalances()` / `fetchSolanaWalletAllBalances()`\n- `fetchBridgeableTokensByNetwork()` / `fetchAllBridgeableTokensByNetwork()`\n- `fetchAllTokensBridgeableToEthereum()` / `fetchAllTokensBridgeableToSolana()`\n- `isTokenBridgeableToNetwork()` / `isTokenBridgeableToEthereum()` / `isTokenBridgeableToSolana()`\n- `requestSolanaDevnetAirdrop()`\n\n```typescript\nimport { createLaunchpadSDK } from '@gala-chain/launchpad-sdk';\n\nasync function bridgeOperations() {\n  // 1. Create SDK with wallet configuration\n  const sdk = createLaunchpadSDK({\n    privateKey: '0xabcd...',\n    environment: 'production',  // or 'staging' for testnet\n  });\n\n  // 2. Get supported bridge tokens\n  const supportedTokens = await sdk.getSupportedBridgeTokens('Ethereum');\n  console.log('Bridgeable to Ethereum:', supportedTokens.map(t => t.symbol));\n\n  // 3. Check if specific token is bridgeable\n  const canBridge = await sdk.isTokenBridgeableToEthereum('GALA');\n  console.log('GALA bridgeable to Ethereum:', canBridge.bridgeable);\n\n  // 4. Estimate bridge fee (calculated externally by GalaConnect API)\n  const fee = await sdk.estimateBridgeFee({\n    tokenId: 'GALA|Unit|none|none',\n    destinationChain: 'Ethereum',\n    amount: '100',\n  });\n  console.log('Bridge fee:', fee.totalFee, 'GALA');\n\n  // 5. Bridge Out: GalaChain → Ethereum\n  const bridgeOutTx = await sdk.bridgeOut({\n    tokenId: 'GALA|Unit|none|none',\n    amount: '100',\n    destinationChain: 'Ethereum',\n    recipientAddress: '0x5678...',\n  });\n  console.log('Bridge out TX:', bridgeOutTx.transactionHash);\n\n  // 6. Get bridge status\n  const status = await sdk.getBridgeStatus(bridgeOutTx.transactionHash);\n  console.log('Bridge status:', status.status);\n\n  // 7. Get Ethereum transaction status\n  const ethTxStatus = await sdk.getEthereumTransactionStatus(bridgeOutTx.transactionHash);\n  console.log('ETH TX confirmed:', ethTxStatus.confirmed);\n\n  // 8. Query external chain balances\n  const ethBalance = await sdk.fetchEthereumWalletNativeBalance();\n  const galaEthBalance = await sdk.fetchEthereumWalletTokenBalance('GALA');\n  const allEthBalances = await sdk.fetchEthereumWalletAllBalances();\n\n  // 9. Discover all bridgeable tokens\n  const allBridgeable = await sdk.fetchAllBridgeableTokensByNetwork('ETHEREUM');\n  console.log('All tokens bridgeable to Ethereum:', allBridgeable.length);\n}\n```\n\n**Supported Tokens:**\n- **Ethereum:** GALA, GWETH, GUSDC, GUSDT, GWTRX, GWBTC\n- **Solana:** GALA, GSOL\n\n**Environment Configuration:**\n- `PROD`: Ethereum Mainnet, Solana Mainnet\n- `STAGE`: Ethereum Sepolia, Solana Devnet\n\n**MCP Tool Equivalents:**\n- `gala_launchpad_bridge_estimate_fee`\n- `gala_launchpad_bridge_out`\n- `gala_launchpad_bridge_in`\n- `gala_launchpad_bridge_status`\n- `gala_launchpad_bridge_ethereum_balance`\n- `gala_launchpad_bridge_ethereum_all_balances`\n- `gala_launchpad_bridge_solana_balance`\n- `gala_launchpad_bridge_solana_all_balances`\n"
-        },
-        {
-          "userQuestion": "What parameters does estimateBridgeFee() accept?",
-          "assistantResponse": "The primary methods for Bridge operations are `estimateBridgeFee()`, `bridgeOut()`, `bridgeIn()`. Each method accepts configuration options as a single object parameter.\n\n**Common Parameters:**\n- `tokenName`: The token identifier (e.g., 'dragnrkti')\n- `amount`: Quantity as a string (for precision)\n- Wallet/auth options when transactions are involved\n\nCheck the SDK documentation or use TypeScript intellisense for the complete parameter interface."
-        },
-        {
-          "userQuestion": "What are best practices for bridge tokens across chains?",
-          "assistantResponse": "1. **Estimate fees first**: Always call `estimateBridgeFee()` before bridging.\n2. **Track status**: Use `getBridgeStatus()` to monitor cross-chain transfers.\n3. **Verify network**: Ensure you're bridging to the correct destination network."
-        },
-        {
-          "userQuestion": "What errors should I handle when bridge tokens across chains?",
-          "assistantResponse": "**Common Errors:**\n- `InsufficientFee`: Bridge fee not covered - estimate first\n- `InvalidDestinationAddress`: Wrong format for target chain\n- `NetworkTimeout`: Cross-chain operations can take time\n\n**Tip:** Always poll `getBridgeStatus()` until completion."
-        },
-        {
-          "userQuestion": "Can you walk me through a complete bridge tokens across chains example?",
-          "assistantResponse": "**Complete Workflow: Bridge operations**\n\nHere's the typical flow: `estimateBridgeFee()` → `bridgeOut()` → `bridgeIn()`\n\n**Step-by-Step:**\n1. **Setup**: Initialize SDK with your configuration\n2. **Validate**: Check prerequisites (balances, permissions)\n3. **Calculate**: Use calculation methods to preview results\n4. **Execute**: Perform the main operation\n5. **Verify**: Confirm the operation succeeded\n\n**Pro Tip:** The SDK methods are designed to be called in sequence. Each step provides data needed for the next."
-        },
-        {
-          "userQuestion": "What edge cases should I know about for bridge tokens across chains?",
-          "assistantResponse": "**Edge Cases:**\n1. **Network delays**: Solana is faster than Ethereum bridging\n2. **Token decimals**: Different chains may have different decimal precision\n3. **Gas spikes**: Ethereum fees can vary significantly\n\n**Gotcha:** Bridge transactions can take 10-30+ minutes depending on network congestion."
-        },
-        {
-          "userQuestion": "What other methods are available for Bridge operations?",
-          "assistantResponse": "**Additional Methods:**\n\n- `getBridgeStatus()`\n- `fetchEthereumWalletTokenBalance()`\n- `fetchEthereumWalletNativeBalance()`\n- `fetchEthereumWalletAllBalances()`\n\n**Total methods in this topic:** 21\n\nEach method serves a specific purpose in the workflow. Use TypeScript intellisense or the SDK documentation to explore parameter options for each method."
-        },
-        {
-          "userQuestion": "When would I actually use bridge tokens across chains in a real application?",
-          "assistantResponse": "**Real-World Use Cases:**\n\n1. **Cross-Chain Arbitrage**: Move tokens to chains with better prices\n2. **DeFi Access**: Bridge to Ethereum for wider DeFi ecosystem\n3. **Gas Optimization**: Bridge to chains with lower fees\n4. **Liquidity Aggregation**: Consolidate holdings from multiple chains"
-        },
-        {
-          "userQuestion": "What should I learn next after bridge tokens across chains?",
-          "assistantResponse": "**Related Topics:**\n\n- **Wrap unwrap operations**: `explainSdkUsage({ topic: 'wrap-unwrap-operations' })`\n- **Transfers**: `explainSdkUsage({ topic: 'transfers' })`\n- **Balances**: `explainSdkUsage({ topic: 'balances' })`\n\n**Learning Path:** Start with the basics, then explore related topics to build a complete understanding of the SDK capabilities."
-        },
-        {
-          "userQuestion": "Are there any advanced patterns for this topic?",
-          "assistantResponse": "**Advanced Patterns:**\n\n1. **Batching**: Combine multiple operations for efficiency\n2. **Caching**: Cache frequently-accessed data locally\n3. **Event-Driven**: Use subscriptions for real-time updates\n4. **Error Recovery**: Implement retry logic with exponential backoff\n5. **Monitoring**: Track operation success rates and latencies\n\n**Performance Tip:** For high-volume operations, consider using the local calculation methods where available to reduce network calls."
-        }
-      ]
-    },
-    {
-      "topicKey": "wrap-unwrap-operations",
-      "label": "Wrap unwrap operations",
-      "category": "bridge",
-      "description": "Cross-chain bridging operations",
-      "methodCount": 10,
-      "exchanges": [
-        {
-          "userQuestion": "How do I wrap and unwrap tokens?",
-          "assistantResponse": "\n# Wrap/Unwrap Operations (Cross-Channel GalaChain Bridge)\n\nThe SDK provides methods for wrapping and unwrapping tokens between GalaChain channels.\nThis is an **internal GalaChain cross-channel bridge**, NOT external bridging to Ethereum/Solana.\n\n**Key Concept:**\n- **Wrap**: Move token from native channel → asset channel (e.g., MUSIC → GMUSIC)\n- **Unwrap**: Move token from asset channel → native channel (e.g., GMUSIC → MUSIC)\n\n## Wrap Token\n\n```typescript\nimport { createLaunchpadSDK } from '@gala-chain/launchpad-sdk';\n\nasync function wrapToken() {\n  const sdk = createLaunchpadSDK({ wallet: 'your-private-key' });\n\n  // Wrap MUSIC to GMUSIC (music channel → asset channel)\n  const result = await sdk.wrapToken({\n    tokenId: 'MUSIC',  // or '$MUSIC|Unit|none|none'\n    amount: '100',\n    recipient: '0x...',  // Optional, defaults to sender\n    memo: 'Wrapping for DEX trading'  // Optional\n  });\n\n  console.log('Wrap transaction:', result.transactionId);\n}\n```\n\n## Unwrap Token\n\n```typescript\nasync function unwrapToken() {\n  const sdk = createLaunchpadSDK({ wallet: 'your-private-key' });\n\n  // Unwrap GMUSIC back to MUSIC (asset channel → music channel)\n  const result = await sdk.unwrapToken({\n    tokenId: 'GMUSIC',  // or '$GMUSIC|Unit|none|none'\n    amount: '50',\n    recipient: '0x...',  // Optional\n    memo: 'Unwrapping after trading'  // Optional\n  });\n\n  console.log('Unwrap transaction:', result.transactionId);\n}\n```\n\n## Fee Estimation\n\n```typescript\nasync function estimateFees() {\n  const sdk = createLaunchpadSDK({ wallet: 'your-private-key' });\n\n  // Estimate wrap fee (uses cross_channel_authorization)\n  const wrapFee = await sdk.estimateWrapFee('MUSIC', '100');\n  console.log('Wrap fee:', wrapFee);\n\n  // Estimate unwrap fee (uses automatic authorization)\n  const unwrapFee = await sdk.estimateUnwrapFee('GMUSIC', '100');\n  console.log('Unwrap fee:', unwrapFee);\n}\n```\n\n## Transaction Status\n\n```typescript\nasync function checkStatus() {\n  const sdk = createLaunchpadSDK({ wallet: 'your-private-key' });\n\n  const status = await sdk.getWrapStatus('transaction-id-here');\n  console.log('Status:', status.status);  // pending, processing, completed, failed\n}\n```\n\n## Wrappable Token Discovery\n\n```typescript\nasync function discoverWrappableTokens() {\n  const sdk = createLaunchpadSDK({ wallet: 'your-private-key' });\n\n  // Paginated fetch\n  const tokens = await sdk.fetchWrappableTokens({ limit: 100 });\n\n  // Auto-paginated (all tokens)\n  const allTokens = await sdk.fetchAllWrappableTokens();\n\n  // Get specific wrappable token\n  const token = await sdk.getWrappableToken('$MUSIC|Unit|none|none');\n\n  // Get wrap counterpart (MUSIC → GMUSIC or vice versa)\n  const counterpart = await sdk.getWrapCounterpart('$MUSIC|Unit|none|none');\n\n  // Check if token is wrappable\n  const isWrappable = await sdk.isTokenWrappable('$MUSIC|Unit|none|none');\n  console.log('Is wrappable:', isWrappable.isWrappable);\n}\n```\n\n**MCP Tool Equivalents:**\n- `gala_launchpad_wrap_token`\n- `gala_launchpad_unwrap_token`\n- `gala_launchpad_estimate_wrap_fee`\n- `gala_launchpad_estimate_unwrap_fee`\n- `gala_launchpad_get_wrap_status`\n- `gala_launchpad_fetch_wrappable_tokens`\n- `gala_launchpad_fetch_all_wrappable_tokens`\n- `gala_launchpad_get_wrappable_token`\n- `gala_launchpad_get_wrap_counterpart`\n- `gala_launchpad_is_token_wrappable`\n"
-        },
-        {
-          "userQuestion": "What parameters does wrapToken() accept?",
-          "assistantResponse": "The primary methods for Wrap unwrap operations are `wrapToken()`, `unwrapToken()`, `estimateWrapFee()`. Each method accepts configuration options as a single object parameter.\n\n**Common Parameters:**\n- `tokenName`: The token identifier (e.g., 'dragnrkti')\n- `amount`: Quantity as a string (for precision)\n- Wallet/auth options when transactions are involved\n\nCheck the SDK documentation or use TypeScript intellisense for the complete parameter interface."
-        },
-        {
-          "userQuestion": "What are best practices for wrap and unwrap tokens?",
-          "assistantResponse": "1. **Use TypeScript**: Get full type safety and intellisense.\n2. **Handle errors**: Always wrap SDK calls in try-catch blocks.\n3. **Validate inputs**: Check parameters before making API calls.\n4. **Cache when appropriate**: Reduce API calls for static data."
-        },
-        {
-          "userQuestion": "What errors should I handle when wrap and unwrap tokens?",
-          "assistantResponse": "**General Error Handling:**\n\n```typescript\ntry {\n  const result = await sdk.wrapunwrapoperations(...);\n} catch (error) {\n  if (error instanceof Error) {\n    console.error('Operation failed:', error.message);\n    // Handle specific error types\n  }\n}\n```\n\n**Common Issues:**\n- Network timeouts - implement retry logic\n- Invalid parameters - validate before calling\n- Authentication errors - ensure valid session"
-        },
-        {
-          "userQuestion": "Can you walk me through a complete wrap and unwrap tokens example?",
-          "assistantResponse": "**Complete Workflow: Wrap unwrap operations**\n\nHere's the typical flow: `wrapToken()` → `unwrapToken()` → `estimateWrapFee()`\n\n**Step-by-Step:**\n1. **Setup**: Initialize SDK with your configuration\n2. **Validate**: Check prerequisites (balances, permissions)\n3. **Calculate**: Use calculation methods to preview results\n4. **Execute**: Perform the main operation\n5. **Verify**: Confirm the operation succeeded\n\n**Pro Tip:** The SDK methods are designed to be called in sequence. Each step provides data needed for the next."
-        },
-        {
-          "userQuestion": "What other methods are available for Wrap unwrap operations?",
-          "assistantResponse": "**Additional Methods:**\n\n- `estimateUnwrapFee()`\n- `getWrapStatus()`\n- `fetchWrappableTokens()`\n- `fetchAllWrappableTokens()`\n\n**Total methods in this topic:** 10\n\nEach method serves a specific purpose in the workflow. Use TypeScript intellisense or the SDK documentation to explore parameter options for each method."
-        },
-        {
-          "userQuestion": "What should I learn next after wrap and unwrap tokens?",
-          "assistantResponse": "**Related Topics:**\n\n- **Bridge operations**: `explainSdkUsage({ topic: 'bridge-operations' })`\n- **Dex trading**: `explainSdkUsage({ topic: 'dex-trading' })`\n- **Transfers**: `explainSdkUsage({ topic: 'transfers' })`\n\n**Learning Path:** Start with the basics, then explore related topics to build a complete understanding of the SDK capabilities."
-        },
-        {
-          "userQuestion": "Are there any advanced patterns for this topic?",
-          "assistantResponse": "**Advanced Patterns:**\n\n1. **Batching**: Combine multiple operations for efficiency\n2. **Caching**: Cache frequently-accessed data locally\n3. **Event-Driven**: Use subscriptions for real-time updates\n4. **Error Recovery**: Implement retry logic with exponential backoff\n5. **Monitoring**: Track operation success rates and latencies\n\n**Performance Tip:** For high-volume operations, consider using the local calculation methods where available to reduce network calls."
-        }
-      ]
-    },
-    {
-      "topicKey": "event-subscriptions",
-      "label": "Event subscriptions",
-      "category": "chat",
-      "description": "Stream chat and messaging",
-      "methodCount": 33,
-      "exchanges": [
-        {
-          "userQuestion": "How do I subscribe to real-time events?",
-          "assistantResponse": "\n## Real-Time Event Subscriptions and Monitoring\n\n**Covers Methods:**\n- `subscribeToDexLiquidityAdded()`\n- `subscribeToDexLiquidityChanged()`\n- `subscribeToDexLiquidityRemoved()`\n- `subscribeToDexPoolAdded()`\n- `subscribeToDexSwapExecuted()`\n- `subscribeToTokenCreations()`\n\nSubscribe to real-time WebSocket events for DEX trading, liquidity changes, and token launches.\n\n```typescript\nimport { createLaunchpadSDK, compareAmounts } from '@gala-chain/launchpad-sdk';\n\nasync function subscribeToEvents() {\n  const sdk = createLaunchpadSDK({ wallet: 'your-private-key' });\n\n  // ============================================================================\n  // LIQUIDITY EVENTS - Monitor position changes\n  // ============================================================================\n\n  // Subscribe to liquidity additions\n  const cleanupAdded = sdk.subscribeToDexLiquidityAdded((event) => {\n    console.log('Liquidity added!');\n    console.log(`  Pool: ${event.token0}-${event.token1}`);\n    console.log(`  Amount0: ${event.amount0}`);\n    console.log(`  Amount1: ${event.amount1}`);\n    console.log(`  Owner: ${event.owner}`);\n    console.log(`  Position ID: ${event.positionId}`);\n  });\n\n  // Subscribe to liquidity changes (compound events)\n  const cleanupChanged = sdk.subscribeToDexLiquidityChanged((event) => {\n    console.log('Liquidity changed!');\n    console.log(`  Type: ${event.type}`); // 'added', 'removed', 'modified'\n    console.log(`  Pool: ${event.token0}-${event.token1}`);\n    console.log(`  Delta: ${event.liquidityDelta}`);\n  });\n\n  // Subscribe to liquidity removals\n  const cleanupRemoved = sdk.subscribeToDexLiquidityRemoved((event) => {\n    console.log('Liquidity removed!');\n    console.log(`  Pool: ${event.token0}-${event.token1}`);\n    console.log(`  Amount0: ${event.amount0}`);\n    console.log(`  Amount1: ${event.amount1}`);\n    console.log(`  Owner: ${event.owner}`);\n    console.log(`  Fees collected: ${event.fees0}, ${event.fees1}`);\n  });\n\n  // ============================================================================\n  // POOL EVENTS - Monitor new DEX pools\n  // ============================================================================\n\n  // Subscribe to new DEX pool creation\n  const cleanupPool = sdk.subscribeToDexPoolAdded((pool) => {\n    console.log('New DEX pool created!');\n    console.log(`  Token: ${pool.tokenName}`);\n    console.log(`  Token0: ${pool.token0}`);\n    console.log(`  Token1: ${pool.token1}`);\n    console.log(`  Fee Tier: ${pool.feeTier}`);\n    console.log(`  Initial TVL: ${pool.tvl}`);\n\n    // Auto-provide liquidity to new pools\n    sdk.addSwapLiquidityByPrice({\n      token0: pool.token0,\n      token1: pool.token1,\n      fee: pool.feeTier,\n      minPrice: '0.95',\n      maxPrice: '1.05',\n      amount0Desired: '1000',\n      amount1Desired: '1000'\n    }).then(() => console.log('Liquidity provided to new pool'));\n  });\n\n  // ============================================================================\n  // SWAP EVENTS - Monitor all DEX swaps\n  // ============================================================================\n\n  // Subscribe to DEX swap executions\n  const cleanupSwap = sdk.subscribeToDexSwapExecuted((swap) => {\n    console.log('DEX swap executed!');\n    console.log(`  Pair: ${swap.tokenIn} → ${swap.tokenOut}`);\n    console.log(`  Amount In: ${swap.amountIn}`);\n    console.log(`  Amount Out: ${swap.amountOut}`);\n    console.log(`  Trader: ${swap.trader}`);\n    console.log(`  Fee Tier: ${swap.feeTier}`);\n\n    // Track volume and price impact\n    const priceImpact = calculatePriceImpact(swap.amountIn, swap.amountOut);\n    console.log(`  Price impact: ${priceImpact}%`);\n  });\n\n  // ============================================================================\n  // TOKEN CREATION EVENTS - Monitor new token launches\n  // ============================================================================\n\n  // Subscribe to new token launches\n  const cleanupToken = sdk.subscribeToTokenCreations((token) => {\n    console.log('New token launched!');\n    console.log(`  Name: ${token.tokenName}`);\n    console.log(`  Symbol: ${token.tokenSymbol}`);\n    console.log(`  Creator: ${token.creator}`);\n    console.log(`  Max Supply: ${token.maxSupply}`);\n    console.log(`  Base Price: ${token.basePrice}`);\n\n    // Auto-buy new tokens\n    sdk.buy({\n      tokenName: token.tokenName,\n      amount: '100',\n      type: 'native',\n      slippageToleranceFactor: 0.01\n    }).then(() => console.log('Auto-bought new token'));\n  });\n\n  // ============================================================================\n  // ARBITRAGE BOT EXAMPLE - Multi-event monitoring\n  // ============================================================================\n\n  async function arbitrageBot() {\n    const sdk = createLaunchpadSDK({ wallet: 'your-private-key' });\n\n    // Track all swaps for arbitrage opportunities\n    sdk.subscribeToDexSwapExecuted(async (swap) => {\n      // Check if price divergence exists\n      const poolPrice = await sdk.getSwapPoolPrice(swap.tokenIn, swap.tokenOut);\n      const externalPrice = await getExternalPrice(swap.tokenIn, swap.tokenOut);\n\n      const divergence = Math.abs(poolPrice - externalPrice) / externalPrice;\n\n      if (divergence > 0.01) {\n        // 1% arbitrage opportunity\n        console.log(`Arbitrage opportunity: ${divergence * 100}%`);\n\n        // Execute arbitrage trade\n        await sdk.executeSwap(\n          swap.tokenOut,\n          swap.tokenIn,\n          calculateArbitrageAmount(divergence),\n          '0', // min output\n          3000, // fee tier\n          0.01 // slippage\n        );\n      }\n    });\n\n    // Monitor liquidity additions for new opportunities\n    sdk.subscribeToDexLiquidityAdded(async (event) => {\n      console.log(`New liquidity in ${event.token0}-${event.token1}`);\n\n      // Check if pool has sufficient depth for arbitrage\n      const poolInfo = await sdk.getSwapPoolInfo(event.token0, event.token1);\n      // Use compareAmounts for precise liquidity threshold comparison\n      if (compareAmounts(poolInfo.liquidity, '100000') > 0) {\n        console.log('Pool has sufficient liquidity for arbitrage');\n      }\n    });\n  }\n\n  // ============================================================================\n  // LIQUIDITY PROVIDER BOT - Auto-manage positions\n  // ============================================================================\n\n  async function liquidityProviderBot() {\n    const sdk = createLaunchpadSDK({ wallet: 'your-private-key' });\n\n    // Auto-add liquidity to new pools\n    sdk.subscribeToDexPoolAdded(async (pool) => {\n      console.log(`New pool: ${pool.tokenName}`);\n\n      // Wait for some initial swaps to establish price\n      setTimeout(async () => {\n        const poolInfo = await sdk.getSwapPoolInfo(pool.token0, pool.token1);\n\n        // Add liquidity if TVL is high enough\n        // Use compareAmounts for precise liquidity threshold comparison\n        if (compareAmounts(poolInfo.liquidity, '50000') > 0) {\n          await sdk.addSwapLiquidityByPrice({\n            token0: pool.token0,\n            token1: pool.token1,\n            fee: pool.feeTier,\n            minPrice: '0.9',\n            maxPrice: '1.1',\n            amount0Desired: '10000',\n            amount1Desired: '10000'\n          });\n\n          console.log('Liquidity added to new pool');\n        }\n      }, 60000); // Wait 1 minute\n    });\n\n    // Monitor liquidity removals (potential exit signal)\n    sdk.subscribeToDexLiquidityRemoved((event) => {\n      console.log(`Large liquidity removal: ${event.amount0}, ${event.amount1}`);\n\n      // Check if we should also exit\n      if (isLargeRemoval(event)) {\n        console.log('Large removal detected - consider exiting position');\n      }\n    });\n  }\n\n  // Keep subscriptions running\n  console.log('Subscriptions active... Press Ctrl+C to stop');\n  await new Promise(() => {}); // Run forever\n\n  // Cleanup when done\n  cleanupAdded();\n  cleanupChanged();\n  cleanupRemoved();\n  cleanupPool();\n  cleanupSwap();\n  cleanupToken();\n}\n```\n\n**Event Data Structures:**\n\n**LiquidityAdded:**\n- token0, token1, feeTier\n- amount0, amount1\n- owner, positionId\n- timestamp\n\n**LiquidityRemoved:**\n- token0, token1, feeTier\n- amount0, amount1\n- fees0, fees1\n- owner, positionId\n- timestamp\n\n**DexPoolAdded:**\n- tokenName, token0, token1\n- feeTier, tvl\n- timestamp\n\n**SwapExecuted:**\n- tokenIn, tokenOut\n- amountIn, amountOut\n- trader, feeTier\n- priceImpact\n- timestamp\n\n**TokenCreation:**\n- tokenName, tokenSymbol\n- creator, maxSupply\n- basePrice\n- timestamp\n\n**Use Cases:**\n- **Arbitrage Bots**: Monitor swaps for price divergence\n- **Liquidity Management**: Auto-provide liquidity to new pools\n- **Early Bird Trading**: Buy new tokens immediately after launch\n- **Position Monitoring**: Track liquidity changes in your positions\n- **Market Analysis**: Analyze trading patterns and volumes\n\n### WebSocket Connection Lifecycle\n\n```typescript\n// Handle connection lifecycle events\nawait sdk.connectStreamWebSocket({\n  onConnect: () => {\n    console.log('WebSocket connected');\n  },\n  onDisconnect: (reason) => {\n    console.log('WebSocket disconnected:', reason);\n    // Implement reconnection logic if needed\n  },\n  onError: (error) => {\n    console.error('WebSocket error:', error);\n  }\n});\n\n// Check connection state\nif (sdk.isStreamWebSocketConnected()) {\n  console.log('Ready to send/receive messages');\n}\n```\n\n### Typing Indicators\n\n```typescript\n// Subscribe to typing indicators in chat\nawait sdk.connectStreamWebSocket({\n  onTypingIndicator: (event) => {\n    if (event.isTyping) {\n      console.log(`${event.userAddress} is typing...`);\n    } else {\n      console.log(`${event.userAddress} stopped typing`);\n    }\n  }\n});\n\n// Send typing start indicator\nawait sdk.sendTypingStart({\n  tokenName: 'anime'\n});\n\n// Later: Send typing stop indicator\nawait sdk.sendTypingStop({\n  tokenName: 'anime'\n});\n```\n\n**MCP Tool Equivalents:**\n- `gala_launchpad_subscribe_to_dex_liquidity_added`\n- `gala_launchpad_subscribe_to_dex_liquidity_changed`\n- `gala_launchpad_subscribe_to_dex_liquidity_removed`\n- `gala_launchpad_subscribe_to_dex_pool_added`\n- `gala_launchpad_subscribe_to_dex_swap_executed`\n- `gala_launchpad_subscribe_to_token_creations`\n"
-        },
-        {
-          "userQuestion": "What parameters does subscribeToStream() accept?",
-          "assistantResponse": "The primary methods for Event subscriptions are `subscribeToStream()`, `unsubscribeFromStream()`, `onStreamStatusChanged()`. Each method accepts configuration options as a single object parameter.\n\n**Common Parameters:**\n- `tokenName`: The token identifier (e.g., 'dragnrkti')\n- `amount`: Quantity as a string (for precision)\n- Wallet/auth options when transactions are involved\n\nCheck the SDK documentation or use TypeScript intellisense for the complete parameter interface."
-        },
-        {
-          "userQuestion": "What are best practices for subscribe to real-time events?",
-          "assistantResponse": "1. **Use TypeScript**: Get full type safety and intellisense.\n2. **Handle errors**: Always wrap SDK calls in try-catch blocks.\n3. **Validate inputs**: Check parameters before making API calls.\n4. **Cache when appropriate**: Reduce API calls for static data."
-        },
-        {
-          "userQuestion": "Can you walk me through a complete subscribe to real-time events example?",
-          "assistantResponse": "**Complete Workflow: Event subscriptions**\n\nHere's the typical flow: `subscribeToStream()` → `unsubscribeFromStream()` → `onStreamStatusChanged()`\n\n**Step-by-Step:**\n1. **Setup**: Initialize SDK with your configuration\n2. **Validate**: Check prerequisites (balances, permissions)\n3. **Calculate**: Use calculation methods to preview results\n4. **Execute**: Perform the main operation\n5. **Verify**: Confirm the operation succeeded\n\n**Pro Tip:** The SDK methods are designed to be called in sequence. Each step provides data needed for the next."
-        },
-        {
-          "userQuestion": "What other methods are available for Event subscriptions?",
-          "assistantResponse": "**Additional Methods:**\n\n- `onUserBanned()`\n- `onUserUnbanned()`\n- `onBanEnforcement()`\n- `onContentFlagged()`\n\n**Total methods in this topic:** 33\n\nEach method serves a specific purpose in the workflow. Use TypeScript intellisense or the SDK documentation to explore parameter options for each method."
-        },
-        {
-          "userQuestion": "What should I learn next after subscribe to real-time events?",
-          "assistantResponse": "**Related Topics:**\n\n- **Streaming**: `explainSdkUsage({ topic: 'streaming' })`\n- **Dex trading**: `explainSdkUsage({ topic: 'dex-trading' })`\n- **Token status**: `explainSdkUsage({ topic: 'token-status' })`\n\n**Learning Path:** Start with the basics, then explore related topics to build a complete understanding of the SDK capabilities."
-        },
-        {
-          "userQuestion": "Are there any advanced patterns for this topic?",
-          "assistantResponse": "**Advanced Patterns:**\n\n1. **Batching**: Combine multiple operations for efficiency\n2. **Caching**: Cache frequently-accessed data locally\n3. **Event-Driven**: Use subscriptions for real-time updates\n4. **Error Recovery**: Implement retry logic with exponential backoff\n5. **Monitoring**: Track operation success rates and latencies\n\n**Performance Tip:** For high-volume operations, consider using the local calculation methods where available to reduce network calls."
-        }
-      ]
-    },
-    {
-      "topicKey": "stream-chat",
-      "label": "Stream chat",
-      "category": "chat-messages",
-      "description": "Stream chat message operations",
-      "methodCount": 18,
-      "exchanges": [
-        {
-          "userQuestion": "How do I handle stream chat and messaging?",
-          "assistantResponse": "\n# Stream Chat SDK\n\nThe SDK provides chat functionality for live streams, including REST API and\nWebSocket real-time messaging.\n\n## REST API Chat\n\n```typescript\nimport { createLaunchpadSDK } from '@gala-chain/launchpad-sdk';\n\nasync function restChat() {\n  const sdk = createLaunchpadSDK({ wallet: 'your-private-key' });\n\n  // Get chat messages (public endpoint)\n  const messages = await sdk.getChatMessages({\n    tokenName: 'mytoken',\n    page: 1,\n    limit: 50,\n  });\n\n  for (const msg of messages.messages) {\n    console.log(`[${msg.createdAt}] ${msg.user?.fullName}: ${msg.content}`);\n  }\n\n  // Send a chat message via REST\n  const sent = await sdk.sendChatMessage({\n    tokenName: 'mytoken',\n    content: 'Hello everyone!',\n  });\n  console.log('Message ID:', sent.message.messageId);\n\n  // Delete a chat message (user can delete own, admin can delete any)\n  const deleted = await sdk.deleteChatMessage({\n    tokenName: 'mytoken',\n    messageId: sent.message.messageId,\n  });\n  console.log('Message deleted:', deleted.deleted);\n\n  // Check chat status\n  const status = await sdk.getChatStatus('mytoken');\n  console.log('Chat enabled:', status.enabled);\n  if (!status.enabled) {\n    console.log('Reason:', status.reason);  // 'global' or 'token'\n  }\n}\n```\n\n## WebSocket Real-time Chat\n\nLower latency messaging with real-time updates.\n\n```typescript\nasync function webSocketChat() {\n  const sdk = createLaunchpadSDK({\n    wallet: 'your-private-key',\n    streamWebSocketUrl: 'wss://stream.example.com',\n  });\n\n  // Connect with event callbacks\n  await sdk.connectStreamWebSocket({\n    onConnect: () => console.log('Connected!'),\n    onDisconnect: (reason) => console.log('Disconnected:', reason),\n    onError: (error) => console.error('Error:', error),\n    onChatMessage: (msg) => {\n      console.log(`[${msg.tokenName}] ${msg.userAddress}: ${msg.content}`);\n    },\n    onViewerCount: (data) => {\n      console.log(`Viewers on ${data.tokenName}: ${data.count}`);\n    },\n    onStreamStatus: (status) => {\n      console.log(`Stream ${status.tokenName}: ${status.status}`);\n    },\n  });\n\n  // Authenticate (required for sending messages)\n  await sdk.authenticateStreamWebSocket();\n\n  // Subscribe to a stream's events\n  const subscribed = await sdk.subscribeToStream('mytoken');\n  console.log('Subscribed, stream status:', subscribed.status);\n\n  // Send message via WebSocket (lower latency)\n  await sdk.sendStreamChatViaWebSocket('mytoken', 'Hello via WebSocket!');\n\n  // Send emoji reaction (ephemeral, not persisted)\n  await sdk.sendStreamReaction('mytoken', '🔥', 0);\n\n  // Unsubscribe when done\n  await sdk.unsubscribeFromStream('mytoken');\n\n  // Disconnect\n  sdk.disconnectStreamWebSocket();\n}\n```\n\n## Admin Chat Operations\n\n```typescript\nasync function adminChat() {\n  const sdk = createLaunchpadSDK({\n    wallet: 'your-private-key',\n    streamAdminApiKey: 'your-admin-key',\n  });\n\n  // Disable chat for a token\n  await sdk.disableChat('mytoken');\n\n  // Re-enable chat\n  await sdk.enableChat('mytoken');\n\n  // Get global chat status\n  const globalStatus = await sdk.getGlobalChatStatus();\n  console.log('Global chat enabled:', globalStatus.enabled);\n\n  // Disable/enable chat globally\n  await sdk.setGlobalChatEnabled(false);  // Disable all chat\n  await sdk.setGlobalChatEnabled(true);   // Re-enable\n}\n```\n\n**WebSocket Events:**\n| Event | Description | Payload |\n|-------|-------------|---------|\n| `chat_message` | New chat message | `{ tokenName, messageId, content, userAddress, user? }` |\n| `viewer_count` | Viewer count update | `{ tokenName, count }` |\n| `stream_status` | Stream status change | `{ tokenName, status, isLive, playbackId }` |\n| `chat_status` | Chat enabled/disabled | `{ tokenName, enabled }` |\n\n**Available SDK Methods:**\n| Method | Description | Auth |\n|--------|-------------|------|\n| `getChatMessages(options)` | Get chat history | Public |\n| `sendChatMessage(options)` | Send via REST | Wallet |\n| `deleteChatMessage(options)` | Delete message | Wallet/Admin |\n| `getChatStatus(tokenName)` | Check chat status | Public |\n| `disableChat(tokenName)` | Disable token chat | Admin |\n| `enableChat(tokenName)` | Enable token chat | Admin |\n| `getGlobalChatStatus()` | Get global status | Public |\n| `setGlobalChatEnabled(enabled)` | Enable/disable globally | Admin |\n| `connectStreamWebSocket(callbacks)` | Connect WebSocket | None |\n| `authenticateStreamWebSocket()` | Authenticate WS | Wallet |\n| `subscribeToStream(tokenName)` | Subscribe to events | None |\n| `unsubscribeFromStream(tokenName)` | Unsubscribe | None |\n| `sendStreamChatViaWebSocket(tokenName, content)` | Send via WS | Wallet |\n| `sendStreamReaction(tokenName, emoji, streamTime)` | Send emoji reaction | Wallet |\n| `disconnectStreamWebSocket()` | Close connection | None |\n| `getEngagementStats(tokenName)` | Get viewer and chat engagement stats | Public |\n\n**MCP Tool Equivalents:**\n- `gala_launchpad_get_chat_messages`\n- `gala_launchpad_send_chat_message`\n- `gala_launchpad_delete_chat_message`\n- `gala_launchpad_get_chat_status`\n- `gala_launchpad_set_chat_enabled`\n- `gala_launchpad_get_global_chat_status`\n- `gala_launchpad_set_global_chat_enabled`\n- `gala_launchpad_connect_stream_websocket`\n- `gala_launchpad_subscribe_to_stream`\n- `gala_launchpad_send_stream_chat_websocket`\n- `gala_launchpad_send_stream_reaction`\n- `gala_launchpad_get_engagement_stats`\n"
-        },
-        {
-          "userQuestion": "What parameters does getChatMessages() accept?",
-          "assistantResponse": "The primary methods for Stream chat are `getChatMessages()`, `sendChatMessage()`, `updateChatMessage()`. Each method accepts configuration options as a single object parameter.\n\n**Common Parameters:**\n- `tokenName`: The token identifier (e.g., 'dragnrkti')\n- `amount`: Quantity as a string (for precision)\n- Wallet/auth options when transactions are involved\n\nCheck the SDK documentation or use TypeScript intellisense for the complete parameter interface."
-        },
-        {
-          "userQuestion": "What are best practices for handle stream chat and messaging?",
-          "assistantResponse": "1. **Use TypeScript**: Get full type safety and intellisense.\n2. **Handle errors**: Always wrap SDK calls in try-catch blocks.\n3. **Validate inputs**: Check parameters before making API calls.\n4. **Cache when appropriate**: Reduce API calls for static data."
-        },
-        {
-          "userQuestion": "What errors should I handle when handle stream chat and messaging?",
-          "assistantResponse": "**General Error Handling:**\n\n```typescript\ntry {\n  const result = await sdk.streamchat(...);\n} catch (error) {\n  if (error instanceof Error) {\n    console.error('Operation failed:', error.message);\n    // Handle specific error types\n  }\n}\n```\n\n**Common Issues:**\n- Network timeouts - implement retry logic\n- Invalid parameters - validate before calling\n- Authentication errors - ensure valid session"
-        },
-        {
-          "userQuestion": "Can you walk me through a complete handle stream chat and messaging example?",
-          "assistantResponse": "**Complete Workflow: Stream chat**\n\nHere's the typical flow: `getChatMessages()` → `sendChatMessage()` → `updateChatMessage()`\n\n**Step-by-Step:**\n1. **Setup**: Initialize SDK with your configuration\n2. **Validate**: Check prerequisites (balances, permissions)\n3. **Calculate**: Use calculation methods to preview results\n4. **Execute**: Perform the main operation\n5. **Verify**: Confirm the operation succeeded\n\n**Pro Tip:** The SDK methods are designed to be called in sequence. Each step provides data needed for the next."
-        },
-        {
-          "userQuestion": "What other methods are available for Stream chat?",
-          "assistantResponse": "**Additional Methods:**\n\n- `deleteChatMessage()`\n- `getChatStatus()`\n- `disableChat()`\n- `enableChat()`\n\n**Total methods in this topic:** 18\n\nEach method serves a specific purpose in the workflow. Use TypeScript intellisense or the SDK documentation to explore parameter options for each method."
-        },
-        {
-          "userQuestion": "What should I learn next after handle stream chat and messaging?",
-          "assistantResponse": "**Related Topics:**\n\n- **Streaming**: `explainSdkUsage({ topic: 'streaming' })`\n- **Content reactions**: `explainSdkUsage({ topic: 'content-reactions' })`\n- **Ban management**: `explainSdkUsage({ topic: 'ban-management' })`\n\n**Learning Path:** Start with the basics, then explore related topics to build a complete understanding of the SDK capabilities."
-        },
-        {
-          "userQuestion": "Are there any advanced patterns for this topic?",
-          "assistantResponse": "**Advanced Patterns:**\n\n1. **Batching**: Combine multiple operations for efficiency\n2. **Caching**: Cache frequently-accessed data locally\n3. **Event-Driven**: Use subscriptions for real-time updates\n4. **Error Recovery**: Implement retry logic with exponential backoff\n5. **Monitoring**: Track operation success rates and latencies\n\n**Performance Tip:** For high-volume operations, consider using the local calculation methods where available to reduce network calls."
-        }
-      ]
-    },
-    {
-      "topicKey": "content-flag-management",
-      "label": "Content flag management",
-      "category": "content-flags",
-      "description": "Report and moderate content",
-      "methodCount": 9,
-      "exchanges": [
-        {
-          "userQuestion": "How do I manage content flags?",
-          "assistantResponse": "\n# Content Flag Management - SDK v5.11.0+\n\nContent moderation via flags and comments. Moderators can flag content for review,\ntake action on flags (delete content, ban users), and manage pool comments.\n\n## Content Types\n\nFlags can be created for:\n- `MESSAGE` - Chat messages\n- `COMMENT` - Pool comments\n- `STREAM` - Live streams (admin only)\n\n## Creating Content Flags\n\n```typescript\nimport { createLaunchpadSDK, CONTENT_TYPE } from '@gala-chain/launchpad-sdk';\n\nconst sdk = createLaunchpadSDK({\n  privateKey: process.env.PRIVATE_KEY,\n});\n\nawait sdk.login();\n\n// Flag a chat message\nconst flag = await sdk.createFlag({\n  tokenName: 'mytoken',\n  contentType: CONTENT_TYPE.MESSAGE,\n  contentId: 'msg-123',\n  reason: 'Spam/harassment',\n});\n\nconsole.log('Flag ID:', flag.id);\nconsole.log('Status:', flag.status); // PENDING\n```\n\n## Listing Flags\n\n```typescript\n// List all pending flags for a token\nconst flags = await sdk.listFlags({\n  tokenName: 'mytoken',\n  status: 'PENDING',\n  page: 1,\n  limit: 20,\n});\n\nfor (const flag of flags.flags) {\n  console.log(`Flag #${flag.id}: ${flag.contentType}`);\n  console.log(`  Reason: ${flag.reason}`);\n  console.log(`  Reporter: ${flag.reporterAddress}`);\n}\n```\n\n## Taking Action on Flags\n\n```typescript\n// Dismiss a flag (no action taken)\nawait sdk.dismissFlag(flagId);\n\n// Take action - delete content only\nawait sdk.actionFlag(flagId, {\n  action: 'DELETE_CONTENT',\n});\n\n// Take action - ban the user\nawait sdk.actionFlag(flagId, {\n  action: 'BAN_USER',\n  banDuration: 3600, // 1 hour ban\n});\n\n// Take action - delete content AND ban user\nawait sdk.actionFlag(flagId, {\n  action: 'DELETE_AND_BAN',\n  banDuration: 86400, // 24 hour ban\n});\n```\n\n## Managing Pool Comments with Reactions\n\nComments include a `messageId` for reactions integration and optional `reactions` data.\n\n```typescript\n// Fetch comments for a pool (with reactions data)\nconst comments = await sdk.getComments({\n  tokenName: 'mytoken',\n  page: 1,\n  limit: 20,\n});\n\nfor (const comment of comments.comments) {\n  console.log(`ID: ${comment.id}, MessageId: ${comment.messageId}`);\n  console.log(`${comment.userAddress}: ${comment.content}`);\n\n  // Check reactions on this comment\n  if (comment.reactions) {\n    console.log(`Total reactions: ${comment.reactions.totalCount}`);\n    for (const reaction of comment.reactions.reactions) {\n      console.log(`  ${reaction.reactionType}: ${reaction.count} (you reacted: ${reaction.userReacted})`);\n    }\n  }\n}\n\n// Post a comment (requires JWT auth)\nawait sdk.login();\nconst newComment = await sdk.createComment({\n  tokenName: 'mytoken',\n  content: 'Great project! Looking forward to the launch.',\n});\nconsole.log('Comment messageId:', newComment.comment.messageId);\n\n// Add a reaction to a comment using its messageId\nawait sdk.addReaction({\n  messageId: newComment.comment.messageId,\n  reaction: '👍',\n});\n\n// Remove a reaction\nawait sdk.removeReaction({\n  messageId: newComment.comment.messageId,\n  reaction: '👍',\n});\n\n// Delete a comment (moderator only)\nawait sdk.deleteComment({ commentId: comment.id });\n```\n\n## SDK Methods Reference\n\n| Method | Description | Auth |\n|--------|-------------|------|\n| `createFlag(options)` | Flag content for review | JWT |\n| `listFlags(options)` | List flags for a token | API key OR JWT (Moderator) |\n| `dismissFlag(flagId)` | Dismiss flag (no action) | API key OR JWT (Moderator) |\n| `actionFlag(flagId, options)` | Take action on flag | API key OR JWT (Moderator) |\n| `getComments(options)` | Get pool comments with reactions | None (public) |\n| `createComment(options)` | Post a comment, returns messageId | JWT |\n| `deleteComment(options)` | Delete a comment | API key OR JWT (Moderator) |\n| `addReaction(options)` | Add reaction to comment/message | JWT |\n| `removeReaction(options)` | Remove reaction from comment/message | JWT |\n\n**MCP Tool Equivalents:**\n- `gala_launchpad_create_flag`\n- `gala_launchpad_list_flags`\n- `gala_launchpad_dismiss_flag`\n- `gala_launchpad_action_flag`\n- `gala_launchpad_fetch_comments`\n- `gala_launchpad_post_comment`\n- `gala_launchpad_delete_comment`\n- `gala_launchpad_add_reaction`\n- `gala_launchpad_remove_reaction`\n"
-        },
-        {
-          "userQuestion": "What parameters does createFlag() accept?",
-          "assistantResponse": "The primary methods for Content flag management are `createFlag()`, `listFlags()`, `listGlobalFlags()`. Each method accepts configuration options as a single object parameter.\n\n**Common Parameters:**\n- `tokenName`: The token identifier (e.g., 'dragnrkti')\n- `amount`: Quantity as a string (for precision)\n- Wallet/auth options when transactions are involved\n\nCheck the SDK documentation or use TypeScript intellisense for the complete parameter interface."
-        },
-        {
-          "userQuestion": "What are best practices for manage content flags?",
-          "assistantResponse": "1. **Use TypeScript**: Get full type safety and intellisense.\n2. **Handle errors**: Always wrap SDK calls in try-catch blocks.\n3. **Validate inputs**: Check parameters before making API calls.\n4. **Cache when appropriate**: Reduce API calls for static data."
-        },
-        {
-          "userQuestion": "What errors should I handle when manage content flags?",
-          "assistantResponse": "**General Error Handling:**\n\n```typescript\ntry {\n  const result = await sdk.contentflagmanagement(...);\n} catch (error) {\n  if (error instanceof Error) {\n    console.error('Operation failed:', error.message);\n    // Handle specific error types\n  }\n}\n```\n\n**Common Issues:**\n- Network timeouts - implement retry logic\n- Invalid parameters - validate before calling\n- Authentication errors - ensure valid session"
-        },
-        {
-          "userQuestion": "Can you walk me through a complete manage content flags example?",
-          "assistantResponse": "**Complete Workflow: Content flag management**\n\nHere's the typical flow: `createFlag()` → `listFlags()` → `listGlobalFlags()`\n\n**Step-by-Step:**\n1. **Setup**: Initialize SDK with your configuration\n2. **Validate**: Check prerequisites (balances, permissions)\n3. **Calculate**: Use calculation methods to preview results\n4. **Execute**: Perform the main operation\n5. **Verify**: Confirm the operation succeeded\n\n**Pro Tip:** The SDK methods are designed to be called in sequence. Each step provides data needed for the next."
-        },
-        {
-          "userQuestion": "What other methods are available for Content flag management?",
-          "assistantResponse": "**Additional Methods:**\n\n- `dismissFlag()`\n- `actionFlag()`\n- `getComments()`\n- `createComment()`\n\n**Total methods in this topic:** 9\n\nEach method serves a specific purpose in the workflow. Use TypeScript intellisense or the SDK documentation to explore parameter options for each method."
-        },
-        {
-          "userQuestion": "What should I learn next after manage content flags?",
-          "assistantResponse": "**Related Topics:**\n\n- **Ban management**: `explainSdkUsage({ topic: 'ban-management' })`\n- **Moderator invites**: `explainSdkUsage({ topic: 'moderator-invites' })`\n- **Overseer invites**: `explainSdkUsage({ topic: 'overseer-invites' })`\n\n**Learning Path:** Start with the basics, then explore related topics to build a complete understanding of the SDK capabilities."
-        }
-      ]
-    },
-    {
-      "topicKey": "content-reactions",
-      "label": "Content reactions",
-      "category": "content-reactions",
-      "description": "Content reactions on messages and comments",
-      "methodCount": 6,
-      "exchanges": [
-        {
-          "userQuestion": "How do I manage content reactions?",
-          "assistantResponse": "Learn about Content reactions with the SDK. This topic covers various methods for manage content reactions."
-        },
-        {
-          "userQuestion": "What parameters does addContentReaction() accept?",
-          "assistantResponse": "The primary methods for Content reactions are `addContentReaction()`, `removeContentReaction()`, `addReactionToChatMessage()`. Each method accepts configuration options as a single object parameter.\n\n**Common Parameters:**\n- `tokenName`: The token identifier (e.g., 'dragnrkti')\n- `amount`: Quantity as a string (for precision)\n- Wallet/auth options when transactions are involved\n\nCheck the SDK documentation or use TypeScript intellisense for the complete parameter interface."
-        },
-        {
-          "userQuestion": "What are best practices for manage content reactions?",
-          "assistantResponse": "1. **Use TypeScript**: Get full type safety and intellisense.\n2. **Handle errors**: Always wrap SDK calls in try-catch blocks.\n3. **Validate inputs**: Check parameters before making API calls.\n4. **Cache when appropriate**: Reduce API calls for static data."
-        },
-        {
-          "userQuestion": "Can you walk me through a complete manage content reactions example?",
-          "assistantResponse": "**Complete Workflow: Content reactions**\n\nHere's the typical flow: `addContentReaction()` → `removeContentReaction()` → `addReactionToChatMessage()`\n\n**Step-by-Step:**\n1. **Setup**: Initialize SDK with your configuration\n2. **Validate**: Check prerequisites (balances, permissions)\n3. **Calculate**: Use calculation methods to preview results\n4. **Execute**: Perform the main operation\n5. **Verify**: Confirm the operation succeeded\n\n**Pro Tip:** The SDK methods are designed to be called in sequence. Each step provides data needed for the next."
-        },
-        {
-          "userQuestion": "What other methods are available for Content reactions?",
-          "assistantResponse": "**Additional Methods:**\n\n- `removeReactionFromChatMessage()`\n- `addReactionToComment()`\n- `removeReactionFromComment()`\n\n**Total methods in this topic:** 6\n\nEach method serves a specific purpose in the workflow. Use TypeScript intellisense or the SDK documentation to explore parameter options for each method."
-        },
-        {
-          "userQuestion": "What should I learn next after manage content reactions?",
-          "assistantResponse": "**Related Topics:**\n\n- **Stream chat**: `explainSdkUsage({ topic: 'stream-chat' })`\n- **Content flag management**: `explainSdkUsage({ topic: 'content-flag-management' })`\n\n**Learning Path:** Start with the basics, then explore related topics to build a complete understanding of the SDK capabilities."
-        }
-      ]
-    },
-    {
-      "topicKey": "dex-trading",
-      "label": "Dex trading",
-      "category": "dex",
-      "description": "GalaSwap quotes, swaps, and user assets",
-      "methodCount": 6,
-      "exchanges": [
-        {
-          "userQuestion": "How do I trade tokens on GalaSwap?",
-          "assistantResponse": "\n## DEX Trading with SDK - GalaSwap Integration\n\n**Covers Methods:**\n- `getSwapQuoteExactInput()`\n- `getSwapQuoteExactOutput()`\n- `executeSwap()`\n- `getSwapUserAssets()`\n- `getAllSwapUserAssets()`\n- `getSwapPoolInfo()`\n\nTrade graduated tokens on the GalaSwap DEX with real-time WebSocket monitoring:\n\n```typescript\nimport { createLaunchpadSDK } from '@gala-chain/launchpad-sdk';\n\nasync function dexTradingExample() {\n  // 1. Initialize SDK with wallet\n  const sdk = createLaunchpadSDK({\n    wallet: 'your-private-key',\n    env: 'production'\n  });\n\n  // ============================================================================\n  // QUOTES: Get pricing information (read-only operations)\n  // ============================================================================\n\n  // Quote 1: Exact input (spend known GALA amount)\n  const quoteIn = await sdk.getSwapQuoteExactInput('GALA', 'GUSDC', '100');\n  console.log('Spend 100 GALA → get ~' + quoteIn.estimatedOutput + ' GUSDC');\n  console.log('Price impact: ' + quoteIn.priceImpact + '%');\n  console.log('Fee tier: ' + quoteIn.feeTier + ' bps');\n\n  // Quote 2: Exact output (get known token amount)\n  const quoteOut = await sdk.getSwapQuoteExactOutput('GALA', 'GUSDC', '100');\n  console.log('Get exactly 100 GUSDC → need ~' + quoteOut.inputAmount + ' GALA');\n\n  // ============================================================================\n  // EXECUTE: Perform the swap with slippage protection\n  // ============================================================================\n\n  const result = await sdk.executeSwap(\n    'GALA',                       // from token\n    'GUSDC',                      // to token\n    '100',                        // input amount (100 GALA)\n    quoteIn.estimatedOutput,      // Use quote's output!\n    quoteIn.feeTier,              // Use quote's fee tier!\n    0.01                          // 1% slippage tolerance\n  );\n\n  console.log('Transaction ID: ' + result.transactionId);\n  console.log('Status: ' + result.status);\n  console.log('Received: ' + result.outputAmount + ' ' + result.toToken);\n\n  // ============================================================================\n  // PORTFOLIO: Check balances and assets\n  // ============================================================================\n\n  const assets = await sdk.getSwapUserAssets(sdk.getEthereumAddress());\n  console.log('Assets in wallet:');\n  assets.forEach(asset => {\n    console.log('  ' + asset.symbol + ': ' + asset.balance);\n  });\n\n  // ============================================================================\n  // PORTFOLIO: Get ALL assets (auto-paginated)\n  // ============================================================================\n\n  const allAssets = await sdk.getAllSwapUserAssets(sdk.getEthereumAddress());\n  console.log('Complete asset portfolio:');\n  console.log('Total assets: ' + allAssets.length);\n  allAssets.forEach(asset => {\n    console.log('  ' + asset.symbol + ': ' + asset.balance);\n  });\n\n  // ============================================================================\n  // POOL INFO: Check liquidity before trading\n  // ============================================================================\n\n  const pool = await sdk.getSwapPoolInfo('GALA', 'GUSDC');\n  console.log('GALA↔GUSDC Pool Info:');\n  console.log('  Liquidity: ' + pool.liquidity);\n  console.log('  Available fee tiers: ' + pool.feeTiers.join(', ') + ' bps');\n  console.log('  24h swaps: ' + pool.swapCount);\n}\n```\n\n**Key Architecture:**\n- **Unified WebSocket**: Uses LaunchpadSDK's unified WebSocket for transaction monitoring\n- **Environment Alignment**: STAGE/PROD URLs must match between LaunchpadSDK and GSwapService\n- **Token Formats**:\n  - **Launchpad bonding curve**: Use `tokenName` (lowercase simple symbols like 'anime', 'dragon')\n  - **DEX trading**: Use `tokenId` (pipe-delimited format like 'GALA|Unit|none|none', 'GUSDC|Unit|none|eth:0x...')\n- **Slippage Protection**: Always use quote values for execution\n- **Fee Tiers**: 500 (0.05%), 3000 (0.30%), 10000 (1.00%)\n- **Auto-Pagination**: Use `getAllSwapUserAssets()` for complete portfolio\n\n**MCP Tool Equivalents:**\n- `gala_launchpad_get_swap_quote_exact_input`\n- `gala_launchpad_get_swap_quote_exact_output`\n- `gala_launchpad_execute_swap`\n- `gala_launchpad_get_swap_user_assets`\n- `gala_launchpad_get_all_swap_user_assets`\n- `gala_launchpad_get_swap_pool_info`\n"
-        },
-        {
-          "userQuestion": "What parameters does getSwapQuoteExactInput() accept?",
-          "assistantResponse": "The primary methods for Dex trading are `getSwapQuoteExactInput()`, `getSwapQuoteExactOutput()`, `executeSwap()`. Each method accepts configuration options as a single object parameter.\n\n**Common Parameters:**\n- `tokenName`: The token identifier (e.g., 'dragnrkti')\n- `amount`: Quantity as a string (for precision)\n- Wallet/auth options when transactions are involved\n\nCheck the SDK documentation or use TypeScript intellisense for the complete parameter interface."
-        },
-        {
-          "userQuestion": "What are best practices for trade tokens on GalaSwap?",
-          "assistantResponse": "1. **Get quotes first**: Always call `getSwapQuoteExactInput()` or `getSwapQuoteExactOutput()` before executing.\n2. **Check slippage**: DEX trades can have significant slippage on large orders.\n3. **Monitor gas**: DEX operations may require more gas for complex routes."
-        },
-        {
-          "userQuestion": "What errors should I handle when trade tokens on GalaSwap?",
-          "assistantResponse": "**Common Errors:**\n- `InsufficientLiquidity`: Not enough liquidity in pool for your trade size\n- `PriceImpactTooHigh`: Large orders cause significant slippage\n- `InvalidFeeTier`: Use 500, 3000, or 10000 for fee tier\n\n**Best Practice:** Start with smaller amounts and check price impact."
-        },
-        {
-          "userQuestion": "Can you walk me through a complete trade tokens on GalaSwap example?",
-          "assistantResponse": "**Complete Workflow: Dex trading**\n\nHere's the typical flow: `getSwapQuoteExactInput()` → `getSwapQuoteExactOutput()` → `executeSwap()`\n\n**Step-by-Step:**\n1. **Setup**: Initialize SDK with your configuration\n2. **Validate**: Check prerequisites (balances, permissions)\n3. **Calculate**: Use calculation methods to preview results\n4. **Execute**: Perform the main operation\n5. **Verify**: Confirm the operation succeeded\n\n**Pro Tip:** The SDK methods are designed to be called in sequence. Each step provides data needed for the next."
-        },
-        {
-          "userQuestion": "What edge cases should I know about for trade tokens on GalaSwap?",
-          "assistantResponse": "**Edge Cases:**\n1. **Multi-hop routes**: Some token pairs require routing through GALA\n2. **Fee tiers**: Different pools may have different fees (500, 3000, 10000 bps)\n3. **Minimum output**: Set reasonable minimums to avoid dust trades\n\n**Gotcha:** Price quotes are valid for a limited time - execute promptly!"
-        },
-        {
-          "userQuestion": "What other methods are available for Dex trading?",
-          "assistantResponse": "**Additional Methods:**\n\n- `getSwapUserAssets()`\n- `getAllSwapUserAssets()`\n- `getSwapPoolInfo()`\n\n**Total methods in this topic:** 6\n\nEach method serves a specific purpose in the workflow. Use TypeScript intellisense or the SDK documentation to explore parameter options for each method."
-        },
-        {
-          "userQuestion": "When would I actually use trade tokens on GalaSwap in a real application?",
-          "assistantResponse": "**Real-World Use Cases:**\n\n1. **Token Swaps**: Exchange between any supported tokens\n2. **Graduated Token Trading**: Trade tokens after bonding curve completion\n3. **Stablecoin Conversion**: Swap volatile tokens for GUSDC\n4. **Portfolio Diversification**: Spread holdings across multiple assets"
-        },
-        {
-          "userQuestion": "What should I learn next after trade tokens on GalaSwap?",
-          "assistantResponse": "**Related Topics:**\n\n- **Liquidity positions**: `explainSdkUsage({ topic: 'liquidity-positions' })`\n- **Fetch dex pools**: `explainSdkUsage({ topic: 'fetch-dex-pools' })`\n- **Advanced dex analysis**: `explainSdkUsage({ topic: 'advanced-dex-analysis' })`\n\n**Learning Path:** Start with the basics, then explore related topics to build a complete understanding of the SDK capabilities."
-        }
-      ]
-    },
-    {
-      "topicKey": "fetch-all-dex-seasons",
-      "label": "Fetch all dex seasons",
-      "category": "dex-analytics",
-      "description": "Leaderboards and volume metrics",
-      "methodCount": 1,
-      "exchanges": [
-        {
-          "userQuestion": "How do I fetch DEX leaderboard seasons?",
-          "assistantResponse": "\n## DEX Leaderboard Seasons Management\n\n**Covers Methods:**\n- `fetchAllDexSeasons()`\n- `fetchCurrentDexSeason()`\n\nDiscover and manage DEX leaderboard seasons for competitive trading events.\n\n```typescript\nimport { createLaunchpadSDK } from '@gala-chain/launchpad-sdk';\n\nasync function manageDexSeasons() {\n  const sdk = createLaunchpadSDK({ wallet: 'your-private-key' });\n\n  // Fetch all available seasons\n  const seasons = await sdk.fetchAllDexSeasons();\n\n  // Display season information\n  seasons.forEach(season => {\n    console.log(`Season: ${season.name} (ID: ${season.id})`);\n    console.log(`Duration: ${season.start} to ${season.end}`);\n  });\n\n  // Get current season\n  const activeSeason = await sdk.fetchCurrentDexSeason();\n  if (activeSeason) {\n    console.log(`Active: ${activeSeason.name}`);\n  } else {\n    console.log('No active season (between seasons)');\n  }\n\n  // Verify season is active\n  const now = new Date();\n  const isActive = activeSeason && now >= activeSeason.start && now <= activeSeason.end;\n  console.log(`Season active: ${isActive}`);\n}\n```\n\n**MCP Tool Equivalents:**\n- `gala_launchpad_fetch_all_dex_seasons`\n- `gala_launchpad_fetch_current_dex_season`\n"
-        },
-        {
-          "userQuestion": "What parameters does fetchAllDexSeasons() accept?",
-          "assistantResponse": "The primary methods for Fetch all dex seasons are `fetchAllDexSeasons()`. Each method accepts configuration options as a single object parameter.\n\n**Common Parameters:**\n- `tokenName`: The token identifier (e.g., 'dragnrkti')\n- `amount`: Quantity as a string (for precision)\n- Wallet/auth options when transactions are involved\n\nCheck the SDK documentation or use TypeScript intellisense for the complete parameter interface."
-        },
-        {
-          "userQuestion": "What are best practices for fetch DEX leaderboard seasons?",
-          "assistantResponse": "1. **Use TypeScript**: Get full type safety and intellisense.\n2. **Handle errors**: Always wrap SDK calls in try-catch blocks.\n3. **Validate inputs**: Check parameters before making API calls.\n4. **Cache when appropriate**: Reduce API calls for static data."
-        },
-        {
-          "userQuestion": "What should I learn next after fetch DEX leaderboard seasons?",
-          "assistantResponse": "**Related Topics:**\n\n- Check the SDK documentation for related functionality\n\n**Learning Path:** Start with the basics, then explore related topics to build a complete understanding of the SDK capabilities."
-        },
-        {
-          "userQuestion": "Any final tips for fetch DEX leaderboard seasons?",
-          "assistantResponse": "**Quick Tips:**\n\n1. **Start Simple**: Begin with the basic use case before exploring advanced features\n2. **Use TypeScript**: The SDK has full TypeScript support for better autocomplete and type safety\n3. **Check the Demos**: The examples/ directory has working demos for most SDK features\n4. **Read Error Messages**: SDK errors include helpful context for troubleshooting\n\nYou're ready to start building with this feature!"
-        }
-      ]
-    },
-    {
-      "topicKey": "fetch-current-dex-leaderboard",
-      "label": "Fetch current dex leaderboard",
-      "category": "dex-analytics",
-      "description": "Leaderboards and volume metrics",
-      "methodCount": 1,
-      "exchanges": [
-        {
-          "userQuestion": "How do I view current DEX leaderboard?",
-          "assistantResponse": "Learn about Fetch current dex leaderboard with the SDK. This topic covers various methods for view current DEX leaderboard."
-        },
-        {
-          "userQuestion": "What parameters does fetchCurrentDexLeaderboard() accept?",
-          "assistantResponse": "The primary methods for Fetch current dex leaderboard are `fetchCurrentDexLeaderboard()`. Each method accepts configuration options as a single object parameter.\n\n**Common Parameters:**\n- `tokenName`: The token identifier (e.g., 'dragnrkti')\n- `amount`: Quantity as a string (for precision)\n- Wallet/auth options when transactions are involved\n\nCheck the SDK documentation or use TypeScript intellisense for the complete parameter interface."
-        },
-        {
-          "userQuestion": "What are best practices for view current DEX leaderboard?",
-          "assistantResponse": "1. **Use TypeScript**: Get full type safety and intellisense.\n2. **Handle errors**: Always wrap SDK calls in try-catch blocks.\n3. **Validate inputs**: Check parameters before making API calls.\n4. **Cache when appropriate**: Reduce API calls for static data."
-        },
-        {
-          "userQuestion": "What should I learn next after view current DEX leaderboard?",
-          "assistantResponse": "**Related Topics:**\n\n- Check the SDK documentation for related functionality\n\n**Learning Path:** Start with the basics, then explore related topics to build a complete understanding of the SDK capabilities."
-        },
-        {
-          "userQuestion": "Any final tips for view current DEX leaderboard?",
-          "assistantResponse": "**Quick Tips:**\n\n1. **Start Simple**: Begin with the basic use case before exploring advanced features\n2. **Use TypeScript**: The SDK has full TypeScript support for better autocomplete and type safety\n3. **Check the Demos**: The examples/ directory has working demos for most SDK features\n4. **Read Error Messages**: SDK errors include helpful context for troubleshooting\n\nYou're ready to start building with this feature!"
-        }
-      ]
-    },
-    {
-      "topicKey": "fetch-current-dex-season",
-      "label": "Fetch current dex season",
-      "category": "dex-analytics",
-      "description": "Leaderboards and volume metrics",
-      "methodCount": 1,
-      "exchanges": [
-        {
-          "userQuestion": "How do I get current DEX season info?",
-          "assistantResponse": "\n## Fetch Current DEX Season\n\n**Covers Methods:**\n- `fetchCurrentDexSeason()`\n\nGet the currently active DEX leaderboard season for competitive trading.\n\n```typescript\nimport { createLaunchpadSDK } from '@gala-chain/launchpad-sdk';\n\nasync function getCurrentSeason() {\n  const sdk = createLaunchpadSDK({ wallet: 'your-private-key' });\n\n  // Fetch the current active season\n  const currentSeason = await sdk.fetchCurrentDexSeason();\n\n  if (currentSeason) {\n    console.log('Current DEX Season:');\n    console.log(`  Season ID: ${currentSeason.id}`);\n    console.log(`  Name: ${currentSeason.name}`);\n    console.log(`  Start: ${currentSeason.start.toISOString()}`);\n    console.log(`  End: ${currentSeason.end.toISOString()}`);\n\n    // Check if season is currently active\n    const now = new Date();\n    const isActive = now >= currentSeason.start && now <= currentSeason.end;\n\n    console.log(`  Active: ${isActive}`);\n\n    // Calculate time remaining\n    const timeRemaining = currentSeason.end.getTime() - now.getTime();\n    const daysRemaining = Math.floor(timeRemaining / (1000 * 60 * 60 * 24));\n\n    console.log(`  Days remaining: ${daysRemaining}`);\n\n    // Fetch leaderboard for current season\n    const leaderboard = await sdk.fetchDexLeaderboardBySeasonId(currentSeason.id);\n    console.log(`  Total participants: ${leaderboard.entries.length}`);\n\n    // Show top 3 players\n    leaderboard.entries.slice(0, 3).forEach((entry, index) => {\n      console.log(`  #${index + 1}: ${entry.wallet} - ${entry.totalXp} XP`);\n    });\n  } else {\n    console.log('No active season (between seasons)');\n\n    // Fetch all seasons to see when next one starts\n    const allSeasons = await sdk.fetchAllDexSeasons();\n    const futureSeason = allSeasons.find(s => s.start > new Date());\n\n    if (futureSeason) {\n      console.log(`Next season starts: ${futureSeason.start.toISOString()}`);\n    }\n  }\n}\n\n// Complete workflow: Check season + participate\nasync function participateInSeason() {\n  const sdk = createLaunchpadSDK({ wallet: 'your-private-key' });\n\n  const season = await sdk.fetchCurrentDexSeason();\n\n  if (season) {\n    console.log(`Active season: ${season.name}`);\n\n    // Execute trades to earn XP\n    const quote = await sdk.getSwapQuoteExactInput('GALA', 'GUSDC', '100');\n    const swap = await sdk.executeSwap(\n      'GALA',\n      'GUSDC',\n      '100',\n      quote.estimatedOutput,\n      quote.feeTier,\n      0.01\n    );\n\n    console.log('Trade executed - XP earned!');\n\n    // Check updated leaderboard position\n    const leaderboard = await sdk.fetchCurrentDexLeaderboard();\n    const myPosition = leaderboard?.entries.find(\n      e => e.wallet === sdk.getAddress()\n    );\n\n    if (myPosition) {\n      console.log(`Current rank: #${myPosition.rank}`);\n      console.log(`Total XP: ${myPosition.totalXp}`);\n    }\n  } else {\n    console.log('No active season - trades won't earn XP');\n  }\n}\n```\n\n**Use Cases:**\n- Check if competitive trading is active\n- Display season information in UI\n- Calculate time remaining in season\n- Auto-participate in seasonal trading\n- Track seasonal leaderboard position\n\n**Related Methods:**\n- `fetchAllDexSeasons()` - Get all seasons (past, current, future)\n- `fetchDexLeaderboardBySeasonId()` - Get leaderboard for specific season\n- `fetchCurrentDexLeaderboard()` - Get current season leaderboard (convenience)\n\n**MCP Tool Equivalent:** `gala_launchpad_fetch_current_dex_season`\n"
-        },
-        {
-          "userQuestion": "What parameters does fetchCurrentDexSeason() accept?",
-          "assistantResponse": "The primary methods for Fetch current dex season are `fetchCurrentDexSeason()`. Each method accepts configuration options as a single object parameter.\n\n**Common Parameters:**\n- `tokenName`: The token identifier (e.g., 'dragnrkti')\n- `amount`: Quantity as a string (for precision)\n- Wallet/auth options when transactions are involved\n\nCheck the SDK documentation or use TypeScript intellisense for the complete parameter interface."
-        },
-        {
-          "userQuestion": "What are best practices for get current DEX season info?",
-          "assistantResponse": "1. **Use TypeScript**: Get full type safety and intellisense.\n2. **Handle errors**: Always wrap SDK calls in try-catch blocks.\n3. **Validate inputs**: Check parameters before making API calls.\n4. **Cache when appropriate**: Reduce API calls for static data."
-        },
-        {
-          "userQuestion": "What should I learn next after get current DEX season info?",
-          "assistantResponse": "**Related Topics:**\n\n- Check the SDK documentation for related functionality\n\n**Learning Path:** Start with the basics, then explore related topics to build a complete understanding of the SDK capabilities."
-        },
-        {
-          "userQuestion": "Any final tips for get current DEX season info?",
-          "assistantResponse": "**Quick Tips:**\n\n1. **Start Simple**: Begin with the basic use case before exploring advanced features\n2. **Use TypeScript**: The SDK has full TypeScript support for better autocomplete and type safety\n3. **Check the Demos**: The examples/ directory has working demos for most SDK features\n4. **Read Error Messages**: SDK errors include helpful context for troubleshooting\n\nYou're ready to start building with this feature!"
-        }
-      ]
-    },
-    {
-      "topicKey": "fetch-dex-aggregated-volume-summary",
-      "label": "Fetch dex aggregated volume summary",
-      "category": "dex-analytics",
-      "description": "Leaderboards and volume metrics",
-      "methodCount": 1,
-      "exchanges": [
-        {
-          "userQuestion": "How do I analyze DEX volume metrics?",
-          "assistantResponse": "\n## DEX Aggregated Volume Summary and Trends\n\n**Covers Methods:**\n- `fetchDexAggregatedVolumeSummary()`\n\nAnalyze DEX trading volume trends across different time periods.\n\n```typescript\nimport { createLaunchpadSDK } from '@gala-chain/launchpad-sdk';\n\nasync function analyzeVolumeTrends() {\n  const sdk = createLaunchpadSDK({ wallet: 'your-private-key' });\n\n  // Get volume summary with trend metrics\n  const summary = await sdk.fetchDexAggregatedVolumeSummary();\n\n  // Display volumes\n  console.log(`1-Day Volume: $${summary.volume1d.toLocaleString()}`);\n  console.log(`7-Day Volume: $${summary.volume7d.toLocaleString()}`);\n  console.log(`30-Day Volume: $${summary.volume30d.toLocaleString()}`);\n\n  // Analyze trends\n  const trend1d = summary.volume1dDelta > 0 ? '📈 UP' : '📉 DOWN';\n  const trend7d = summary.volume7dDelta > 0 ? '📈 UP' : '📉 DOWN';\n  const trend30d = summary.volume30dDelta > 0 ? '📈 UP' : '📉 DOWN';\n\n  console.log(`1-Day Trend: ${trend1d} (${toBigNumberFixed(summary.volume1dDelta * 100, 2)}%)`);\n  console.log(`7-Day Trend: ${trend7d} (${toBigNumberFixed(summary.volume7dDelta * 100, 2)}%)`);\n  console.log(`30-Day Trend: ${trend30d} (${toBigNumberFixed(summary.volume30dDelta * 100, 2)}%)`);\n\n  // Growth analysis\n  if (summary.volume30dDelta > 0.1) {\n    console.log('Strong growth - Platform adoption increasing');\n  } else if (summary.volume30dDelta < -0.1) {\n    console.log('Declining volume - Platform may be slowing');\n  }\n}\n```\n\n**MCP Tool Equivalent:** `gala_launchpad_fetch_dex_aggregated_volume_summary`\n"
-        },
-        {
-          "userQuestion": "What parameters does fetchDexAggregatedVolumeSummary() accept?",
-          "assistantResponse": "The primary methods for Fetch dex aggregated volume summary are `fetchDexAggregatedVolumeSummary()`. Each method accepts configuration options as a single object parameter.\n\n**Common Parameters:**\n- `tokenName`: The token identifier (e.g., 'dragnrkti')\n- `amount`: Quantity as a string (for precision)\n- Wallet/auth options when transactions are involved\n\nCheck the SDK documentation or use TypeScript intellisense for the complete parameter interface."
-        },
-        {
-          "userQuestion": "What are best practices for analyze DEX volume metrics?",
-          "assistantResponse": "1. **Use TypeScript**: Get full type safety and intellisense.\n2. **Handle errors**: Always wrap SDK calls in try-catch blocks.\n3. **Validate inputs**: Check parameters before making API calls.\n4. **Cache when appropriate**: Reduce API calls for static data."
-        },
-        {
-          "userQuestion": "What should I learn next after analyze DEX volume metrics?",
-          "assistantResponse": "**Related Topics:**\n\n- Check the SDK documentation for related functionality\n\n**Learning Path:** Start with the basics, then explore related topics to build a complete understanding of the SDK capabilities."
-        },
-        {
-          "userQuestion": "Any final tips for analyze DEX volume metrics?",
-          "assistantResponse": "**Quick Tips:**\n\n1. **Start Simple**: Begin with the basic use case before exploring advanced features\n2. **Use TypeScript**: The SDK has full TypeScript support for better autocomplete and type safety\n3. **Check the Demos**: The examples/ directory has working demos for most SDK features\n4. **Read Error Messages**: SDK errors include helpful context for troubleshooting\n\nYou're ready to start building with this feature!"
-        }
-      ]
-    },
-    {
-      "topicKey": "fetch-dex-leaderboard-by-season-id",
-      "label": "Fetch dex leaderboard by season id",
-      "category": "dex-analytics",
-      "description": "Leaderboards and volume metrics",
-      "methodCount": 1,
-      "exchanges": [
-        {
-          "userQuestion": "How do I view DEX leaderboard rankings?",
-          "assistantResponse": "\n## DEX Leaderboard Rankings by Season\n\n**Covers Methods:**\n- `fetchDexLeaderboardBySeasonId()`\n- `fetchCurrentDexLeaderboard()`\n\nQuery leaderboard rankings for competitive DEX trading seasons.\n\n```typescript\nimport { createLaunchpadSDK } from '@gala-chain/launchpad-sdk';\n\nasync function viewLeaderboards() {\n  const sdk = createLaunchpadSDK({ wallet: 'your-private-key' });\n\n  // Option 1: Fetch leaderboard for specific season\n  const leaderboard = await sdk.fetchDexLeaderboardBySeasonId(4);\n\n  // Display top 10 ranked players\n  console.log(`Season ${leaderboard.seasonId} - Top 10 Players:`);\n  leaderboard.entries.slice(0, 10).forEach(entry => {\n    console.log(`  ${entry.rank}. ${entry.wallet}`);\n    console.log(`     XP: ${entry.totalXp} (Liquidity: ${entry.liquidityXp}, Trading: ${entry.tradingXp})`);\n  });\n\n  // Analyze mastery titles\n  const topPlayer = leaderboard.entries[0];\n  topPlayer.masteryTitles.forEach(title => {\n    console.log(`  🏆 ${title.name} (Type: ${title.type}, Tier: ${title.order})`);\n  });\n\n  // Option 2: Get current leaderboard (convenience method)\n  const currentBoard = await sdk.fetchCurrentDexLeaderboard();\n\n  if (currentBoard) {\n    console.log(`Season ${currentBoard.seasonId} is active`);\n    console.log(`Total participants: ${currentBoard.entries.length}`);\n\n    // Top 3 performers\n    const topThree = currentBoard.entries.slice(0, 3);\n    topThree.forEach(entry => {\n      console.log(`  #${entry.rank}: ${entry.totalXp} XP`);\n    });\n  }\n}\n```\n\n**MCP Tool Equivalents:**\n- `gala_launchpad_fetch_dex_leaderboard_by_season_id`\n- `gala_launchpad_fetch_current_dex_leaderboard`\n"
-        },
-        {
-          "userQuestion": "What parameters does fetchDexLeaderboardBySeasonId() accept?",
-          "assistantResponse": "The primary methods for Fetch dex leaderboard by season id are `fetchDexLeaderboardBySeasonId()`. Each method accepts configuration options as a single object parameter.\n\n**Common Parameters:**\n- `tokenName`: The token identifier (e.g., 'dragnrkti')\n- `amount`: Quantity as a string (for precision)\n- Wallet/auth options when transactions are involved\n\nCheck the SDK documentation or use TypeScript intellisense for the complete parameter interface."
-        },
-        {
-          "userQuestion": "What are best practices for view DEX leaderboard rankings?",
-          "assistantResponse": "1. **Use TypeScript**: Get full type safety and intellisense.\n2. **Handle errors**: Always wrap SDK calls in try-catch blocks.\n3. **Validate inputs**: Check parameters before making API calls.\n4. **Cache when appropriate**: Reduce API calls for static data."
-        },
-        {
-          "userQuestion": "What should I learn next after view DEX leaderboard rankings?",
-          "assistantResponse": "**Related Topics:**\n\n- Check the SDK documentation for related functionality\n\n**Learning Path:** Start with the basics, then explore related topics to build a complete understanding of the SDK capabilities."
-        },
-        {
-          "userQuestion": "Any final tips for view DEX leaderboard rankings?",
-          "assistantResponse": "**Quick Tips:**\n\n1. **Start Simple**: Begin with the basic use case before exploring advanced features\n2. **Use TypeScript**: The SDK has full TypeScript support for better autocomplete and type safety\n3. **Check the Demos**: The examples/ directory has working demos for most SDK features\n4. **Read Error Messages**: SDK errors include helpful context for troubleshooting\n\nYou're ready to start building with this feature!"
-        }
-      ]
-    },
-    {
-      "topicKey": "advanced-dex-analysis",
-      "label": "Advanced dex analysis",
-      "category": "dex-pools",
-      "description": "DEX pool discovery and information",
-      "methodCount": 4,
-      "exchanges": [
-        {
-          "userQuestion": "How do I analyze DEX trading data?",
-          "assistantResponse": "\n## Advanced DEX Pool Analysis with SDK\n\n**Covers Methods:**\n- `fetchCompositePoolData()`\n- `calculateDexPoolQuoteExactAmountLocal()`\n- `calculateDexPoolQuoteExactAmountExternal()`\n- `calculateDexPoolQuoteExactAmount()`\n\nThis workflow demonstrates analyzing graduated tokens using composite data and price calculations.\n\n**Use Cases:**\n- Arbitrage opportunity detection\n- Price impact analysis before large trades\n- Comparing bonding curve vs DEX pricing\n- Smart routing for best execution\n\n```typescript\nimport { createLaunchpadSDK } from '@gala-chain/launchpad-sdk';\n\nasync function advancedDexAnalysis() {\n  const sdk = createLaunchpadSDK({ environment: 'production' });\n\n  // Step 1: Get composite pool data (bonding curve + DEX if graduated)\n  const composite = await sdk.fetchCompositePoolData('anime');\n\n  if (composite.isGraduated) {\n    console.log('Token graduated to DEX!');\n    console.log('DEX Pool TVL:', composite.dexPool.tvl);\n    console.log('DEX 24h Volume:', composite.dexPool.volume1d);\n  }\n\n  // Step 2: Compare local vs external price calculations\n  const localQuote = await sdk.calculateDexPoolQuoteExactAmountLocal(\n    'GALA|Unit|none|none',\n    'anime|Unit|none|eth:0x...',\n    '100'\n  );\n\n  const externalQuote = await sdk.calculateDexPoolQuoteExactAmountExternal(\n    'GALA|Unit|none|none',\n    'anime|Unit|none|eth:0x...',\n    '100'\n  );\n\n  console.log('Local calculation:', localQuote.outputAmount);\n  console.log('External API:', externalQuote.outputAmount);\n  console.log('Price difference:',\n    Math.abs(safeParseFloat(localQuote.outputAmount, 0) - safeParseFloat(externalQuote.outputAmount, 0))\n  );\n\n  // Step 3: Use smart routing for best price\n  const bestQuote = await sdk.calculateDexPoolQuoteExactAmount(\n    'GALA|Unit|none|none',\n    'anime|Unit|none|eth:0x...',\n    '100'\n  );\n\n  console.log('Best route:', bestQuote.route); // 'local' or 'external'\n  console.log('Best price:', bestQuote.outputAmount);\n}\n```\n\n**MCP Tools:**\n- `gala_launchpad_fetch_composite_pool_data`\n- `gala_launchpad_calculate_dex_pool_quote_exact_amount_local`\n- `gala_launchpad_calculate_dex_pool_quote_exact_amount_external`\n- `gala_launchpad_calculate_dex_pool_quote_exact_amount`\n"
-        },
-        {
-          "userQuestion": "What parameters does fetchCompositePoolData() accept?",
-          "assistantResponse": "The primary methods for Advanced dex analysis are `fetchCompositePoolData()`, `calculateDexPoolQuoteExactAmountLocal()`, `calculateDexPoolQuoteExactAmountExternal()`. Each method accepts configuration options as a single object parameter.\n\n**Common Parameters:**\n- `tokenName`: The token identifier (e.g., 'dragnrkti')\n- `amount`: Quantity as a string (for precision)\n- Wallet/auth options when transactions are involved\n\nCheck the SDK documentation or use TypeScript intellisense for the complete parameter interface."
-        },
-        {
-          "userQuestion": "What are best practices for analyze DEX trading data?",
-          "assistantResponse": "1. **Use TypeScript**: Get full type safety and intellisense.\n2. **Handle errors**: Always wrap SDK calls in try-catch blocks.\n3. **Validate inputs**: Check parameters before making API calls.\n4. **Cache when appropriate**: Reduce API calls for static data."
-        },
-        {
-          "userQuestion": "Can you walk me through a complete analyze DEX trading data example?",
-          "assistantResponse": "**Complete Workflow: Advanced dex analysis**\n\nHere's the typical flow: `fetchCompositePoolData()` → `calculateDexPoolQuoteExactAmountLocal()` → `calculateDexPoolQuoteExactAmountExternal()`\n\n**Step-by-Step:**\n1. **Setup**: Initialize SDK with your configuration\n2. **Validate**: Check prerequisites (balances, permissions)\n3. **Calculate**: Use calculation methods to preview results\n4. **Execute**: Perform the main operation\n5. **Verify**: Confirm the operation succeeded\n\n**Pro Tip:** The SDK methods are designed to be called in sequence. Each step provides data needed for the next."
-        },
-        {
-          "userQuestion": "What should I learn next after analyze DEX trading data?",
-          "assistantResponse": "**Related Topics:**\n\n- **Dex trading**: `explainSdkUsage({ topic: 'dex-trading' })`\n- **Liquidity positions**: `explainSdkUsage({ topic: 'liquidity-positions' })`\n- **Fetch dex pools**: `explainSdkUsage({ topic: 'fetch-dex-pools' })`\n\n**Learning Path:** Start with the basics, then explore related topics to build a complete understanding of the SDK capabilities."
-        }
-      ]
-    },
-    {
-      "topicKey": "dex-token-discovery",
-      "label": "Dex token discovery",
-      "category": "dex-pools",
-      "description": "DEX pool discovery and information",
-      "methodCount": 2,
-      "exchanges": [
-        {
-          "userQuestion": "How do I discover tokens on DEX?",
-          "assistantResponse": "\n## DEX Token Discovery with SDK\n\n**Covers Methods:**\n- `fetchAvailableDexTokens()`\n- `fetchAllAvailableDexTokens()`\n\nDiscover all tokens available for trading on GalaSwap DEX with rich metadata.\n\n```typescript\nimport { createLaunchpadSDK } from '@gala-chain/launchpad-sdk';\n\nasync function discoverDexTokens() {\n  const sdk = createLaunchpadSDK({ wallet: 'your-private-key' });\n\n  // Option 1: Paginated token discovery\n  const tokens = await sdk.fetchAvailableDexTokens({\n    search: 'GALA',  // Optional search filter\n    page: 1,\n    limit: 20\n  });\n\n  console.log(`Found ${tokens.total} tokens, page ${tokens.page} of ${tokens.totalPages}`);\n  tokens.items.forEach(token => {\n    console.log(`${token.symbol}: ${token.name} (decimals: ${token.decimals})`);\n  });\n\n  // Option 2: Fetch ALL tokens (auto-pagination)\n  const allTokens = await sdk.fetchAllAvailableDexTokens();\n  console.log(`Total DEX tokens: ${allTokens.length}`);\n\n  // Option 3: Search for specific tokens\n  const searchResults = await sdk.fetchAllAvailableDexTokens({ search: 'USD' });\n  console.log('USD-related tokens:', searchResults.map(t => t.symbol));\n}\n```\n\n**Token Metadata Includes:**\n- Symbol and full name\n- Decimal precision\n- Token class key (collection, category, type, additionalKey)\n- Verification status\n- Trading availability\n\n**MCP Tool Equivalents:**\n- `gala_launchpad_fetch_available_dex_tokens`\n- `gala_launchpad_fetch_all_available_dex_tokens`\n"
-        },
-        {
-          "userQuestion": "What parameters does fetchAvailableDexTokens() accept?",
-          "assistantResponse": "The primary methods for Dex token discovery are `fetchAvailableDexTokens()`, `fetchAllAvailableDexTokens()`. Each method accepts configuration options as a single object parameter.\n\n**Common Parameters:**\n- `tokenName`: The token identifier (e.g., 'dragnrkti')\n- `amount`: Quantity as a string (for precision)\n- Wallet/auth options when transactions are involved\n\nCheck the SDK documentation or use TypeScript intellisense for the complete parameter interface."
-        },
-        {
-          "userQuestion": "What are best practices for discover tokens on DEX?",
-          "assistantResponse": "1. **Use TypeScript**: Get full type safety and intellisense.\n2. **Handle errors**: Always wrap SDK calls in try-catch blocks.\n3. **Validate inputs**: Check parameters before making API calls.\n4. **Cache when appropriate**: Reduce API calls for static data."
-        },
-        {
-          "userQuestion": "What should I learn next after discover tokens on DEX?",
-          "assistantResponse": "**Related Topics:**\n\n- **Fetch dex pools**: `explainSdkUsage({ topic: 'fetch-dex-pools' })`\n- **Dex trading**: `explainSdkUsage({ topic: 'dex-trading' })`\n- **Token details**: `explainSdkUsage({ topic: 'token-details' })`\n\n**Learning Path:** Start with the basics, then explore related topics to build a complete understanding of the SDK capabilities."
-        },
-        {
-          "userQuestion": "Any final tips for discover tokens on DEX?",
-          "assistantResponse": "**Quick Tips:**\n\n1. **Start Simple**: Begin with the basic use case before exploring advanced features\n2. **Use TypeScript**: The SDK has full TypeScript support for better autocomplete and type safety\n3. **Check the Demos**: The examples/ directory has working demos for most SDK features\n4. **Read Error Messages**: SDK errors include helpful context for troubleshooting\n\nYou're ready to start building with this feature!"
-        }
-      ]
-    },
-    {
-      "topicKey": "fetch-dex-pools",
-      "label": "Fetch dex pools",
-      "category": "dex-pools",
-      "description": "DEX pool discovery and information",
-      "methodCount": 2,
-      "exchanges": [
-        {
-          "userQuestion": "How do I fetch dex pools?",
-          "assistantResponse": "\n## Fetch DEX Pools with Pagination\n\n**Covers Methods:**\n- `fetchDexPools()`\n- `fetchAllDexPools()`\n\nDiscover and query liquidity pools on GalaSwap with advanced filtering and pagination.\n\n```typescript\nimport { createLaunchpadSDK } from '@gala-chain/launchpad-sdk';\n\nasync function queryDexPools() {\n  const sdk = createLaunchpadSDK({ wallet: 'your-private-key' });\n\n  // Option 1: Fetch pools with pagination\n  const pools = await sdk.fetchDexPools({\n    search: 'GALA',\n    sortBy: 'tvl',      // Sort by: tvl, volume30d, volume1d\n    limit: 20,\n    page: 1\n  });\n\n  console.log(`Found ${pools.total} pools, page ${pools.page} of ${pools.totalPages}`);\n  pools.pools.forEach(pool => {\n    console.log(`${pool.tokenName}: TVL ${pool.tvl}, 24h Volume: ${pool.volume1d}`);\n  });\n\n  // Option 2: Fetch ALL pools automatically (handles pagination)\n  const allPools = await sdk.fetchAllDexPools({\n    sortBy: 'tvl'\n  });\n\n  console.log(`Total pools: ${allPools.pools.length}`);\n\n  // Analyze pool metrics\n  const avgTvl = allPools.pools.reduce((sum, p) => sum + safeParseFloat(p.tvl, 0), 0) / allPools.pools.length;\n  console.log(`Average TVL: $${toBigNumberFixed(avgTvl, 2)}`);\n}\n```\n\n**Key Features:**\n- **Sorting**: TVL (total value locked), volume30d (30-day volume), volume1d (24-hour volume)\n- **Pool Metrics**: Token prices, fee tiers, liquidity, 24h/30d volume, APR\n- **Auto-Pagination**: `fetchAllDexPools()` handles pagination automatically\n- **Search**: Filter by token name or pair\n\n**MCP Tool Equivalents:**\n- `gala_launchpad_fetch_dex_pools`\n- `gala_launchpad_fetch_all_dex_pools`\n"
-        },
-        {
-          "userQuestion": "What parameters does fetchDexPools() accept?",
-          "assistantResponse": "The primary methods for Fetch dex pools are `fetchDexPools()`, `fetchAllDexPools()`. Each method accepts configuration options as a single object parameter.\n\n**Common Parameters:**\n- `tokenName`: The token identifier (e.g., 'dragnrkti')\n- `amount`: Quantity as a string (for precision)\n- Wallet/auth options when transactions are involved\n\nCheck the SDK documentation or use TypeScript intellisense for the complete parameter interface."
-        },
-        {
-          "userQuestion": "What are best practices for fetch dex pools?",
-          "assistantResponse": "1. **Use TypeScript**: Get full type safety and intellisense.\n2. **Handle errors**: Always wrap SDK calls in try-catch blocks.\n3. **Validate inputs**: Check parameters before making API calls.\n4. **Cache when appropriate**: Reduce API calls for static data."
-        },
-        {
-          "userQuestion": "What should I learn next after fetch dex pools?",
-          "assistantResponse": "**Related Topics:**\n\n- **Dex trading**: `explainSdkUsage({ topic: 'dex-trading' })`\n- **Liquidity positions**: `explainSdkUsage({ topic: 'liquidity-positions' })`\n- **Dex token discovery**: `explainSdkUsage({ topic: 'dex-token-discovery' })`\n\n**Learning Path:** Start with the basics, then explore related topics to build a complete understanding of the SDK capabilities."
-        },
-        {
-          "userQuestion": "Any final tips for fetch dex pools?",
-          "assistantResponse": "**Quick Tips:**\n\n1. **Start Simple**: Begin with the basic use case before exploring advanced features\n2. **Use TypeScript**: The SDK has full TypeScript support for better autocomplete and type safety\n3. **Check the Demos**: The examples/ directory has working demos for most SDK features\n4. **Read Error Messages**: SDK errors include helpful context for troubleshooting\n\nYou're ready to start building with this feature!"
-        }
-      ]
-    },
-    {
-      "topicKey": "locks",
-      "label": "Locks",
-      "category": "locks",
-      "description": "Token lock and unlock operations",
-      "methodCount": 4,
-      "exchanges": [
-        {
-          "userQuestion": "How do I lock and unlock tokens?",
-          "assistantResponse": "\n## Token Locking, Unlocking, and Burning with SDK\n\n**Covers Methods:**\n- `lockTokens()` - Lock one or more token types in a single transaction\n- `unlockTokens()` - Unlock one or more token types in a single transaction\n- `burnTokens()` - Permanently destroy tokens (IRREVERSIBLE)\n- `fetchLockedBalance()` - Query locked token balances with hold details\n\nLock, unlock, and burn tokens on GalaChain for staking, escrow, vesting, or token management.\n\n```typescript\nimport { createLaunchpadSDK } from '@gala-chain/launchpad-sdk';\n\nasync function tokenLockingAndBurning() {\n  const sdk = createLaunchpadSDK({\n    wallet: 'your-private-key'\n  });\n\n  // ============================================================================\n  // LOCK TOKENS - Single token (batch API wraps single token)\n  // ============================================================================\n\n  // Lock 1000 tokens with default options (caller is lock authority)\n  const lockResult = await sdk.lockTokens({\n    tokens: [{\n      tokenName: 'anime',\n      amount: '1000'\n    }]\n  });\n\n  console.log('Lock transaction ID:', lockResult.transactionId);\n  console.log('Locked entries:', lockResult.locked);\n\n  // ============================================================================\n  // LOCK TOKENS - Multiple tokens in one transaction (batch)\n  // ============================================================================\n\n  // Lock multiple token types atomically\n  const batchLock = await sdk.lockTokens({\n    tokens: [\n      { tokenName: 'anime', amount: '500' },\n      { tokenName: 'dragon', amount: '200' },\n      { tokenName: 'mystic', amount: '100', lockAuthority: 'eth|0x1234...' }\n    ]\n  });\n\n  console.log('Batch lock completed:', batchLock.locked.length, 'tokens locked');\n\n  // ============================================================================\n  // LOCK TOKENS - Advanced options\n  // ============================================================================\n\n  // Lock with custom lock authority (another address can unlock)\n  const escrowLock = await sdk.lockTokens({\n    tokens: [{\n      tokenName: 'anime',\n      amount: '500',\n      lockAuthority: 'eth|0x1234...',  // Escrow agent address\n      name: 'escrow-payment-001',       // Identifier for matching during unlock\n      expires: Date.now() + 30 * 24 * 60 * 60 * 1000  // Auto-release in 30 days\n    }]\n  });\n\n  console.log('Escrow lock created');\n\n  // Lock for time-based vesting\n  const vestingLock = await sdk.lockTokens({\n    tokens: [{\n      tokenName: 'anime',\n      amount: '10000',\n      name: 'vesting-q1-2025',\n      expires: new Date('2025-04-01').getTime()  // Auto-unlock on April 1st\n    }]\n  });\n\n  console.log('Vesting lock created with expiry');\n\n  // ============================================================================\n  // UNLOCK TOKENS - Release locked tokens\n  // ============================================================================\n\n  // Unlock tokens (must be called by lock authority)\n  const unlockResult = await sdk.unlockTokens({\n    tokens: [{\n      tokenName: 'anime',\n      amount: '500'\n    }]\n  });\n\n  console.log('Unlock transaction ID:', unlockResult.transactionId);\n  console.log('Unlocked entries:', unlockResult.unlocked);\n\n  // Unlock multiple tokens in one transaction\n  const batchUnlock = await sdk.unlockTokens({\n    tokens: [\n      { tokenName: 'anime', amount: '500' },\n      { tokenName: 'dragon', amount: '200', name: 'escrow-payment-001' }\n    ]\n  });\n\n  console.log('Batch unlock completed');\n\n  // ============================================================================\n  // BURN TOKENS - Permanently destroy (IRREVERSIBLE!)\n  // ============================================================================\n\n  // WARNING: Burn operations are permanent and cannot be undone!\n  const burnResult = await sdk.burnTokens({\n    tokens: [{\n      tokenName: 'anime',\n      amount: '100'\n    }]\n  });\n\n  console.log('Burn transaction ID:', burnResult.transactionId);\n  console.log('Burned:', burnResult.burned);\n\n  // Batch burn multiple token types\n  const batchBurn = await sdk.burnTokens({\n    tokens: [\n      { tokenName: 'anime', amount: '50' },\n      { tokenName: 'oldtoken', amount: '1000' }  // Clean up deprecated tokens\n    ]\n  });\n\n  console.log('Batch burn completed:', batchBurn.burned.length, 'token types burned');\n\n  // ============================================================================\n  // QUERY LOCKED TOKENS - Check lock status\n  // ============================================================================\n\n  const lockedTokens = await sdk.fetchLockedBalance({\n    tokenName: 'anime',\n    address: sdk.getAddress()\n  });\n\n  console.log('Locked quantity:', lockedTokens.lockedQuantity);\n  console.log('Active holds:', lockedTokens.holds);\n\n  // Each hold contains: lockAuthority, expires, name, quantity\n  for (const hold of lockedTokens.holds) {\n    console.log(`  - ${hold.quantity} locked by ${hold.lockAuthority}`);\n    if (hold.expires) console.log(`    Expires: ${new Date(hold.expires)}`);\n    if (hold.name) console.log(`    Name: ${hold.name}`);\n  }\n\n  // ============================================================================\n  // STAKING WORKFLOW EXAMPLE\n  // ============================================================================\n\n  async function stakingWorkflow() {\n    // Step 1: Lock tokens for staking period\n    const stake = await sdk.lockTokens({\n      tokens: [{\n        tokenName: 'anime',\n        amount: '5000',\n        name: 'staking-period-1',\n        expires: Date.now() + 90 * 24 * 60 * 60 * 1000  // 90-day staking period\n      }]\n    });\n\n    console.log('Staked 5000 tokens for 90 days');\n\n    // Step 2: After staking period expires, unlock\n    const unstake = await sdk.unlockTokens({\n      tokens: [{\n        tokenName: 'anime',\n        amount: '5000',\n        name: 'staking-period-1'\n      }]\n    });\n\n    console.log('Unstaked tokens after staking period');\n    return { stake, unstake };\n  }\n\n  // ============================================================================\n  // ESCROW WORKFLOW EXAMPLE\n  // ============================================================================\n\n  async function escrowWorkflow(buyerAddress: string, sellerAddress: string) {\n    // Step 1: Buyer locks payment in escrow (seller is lock authority)\n    const escrow = await sdk.lockTokens({\n      tokens: [{\n        tokenName: 'anime',\n        amount: '1000',\n        lockAuthority: sellerAddress,  // Seller can release upon delivery\n        name: 'order-12345'\n      }]\n    });\n\n    console.log('Escrow created: seller can release payment upon delivery');\n\n    // Step 2: Seller releases escrow after delivery (seller calls unlock)\n    // This would be executed by the seller's SDK instance\n    // const release = await sellerSdk.unlockTokens({\n    //   tokens: [{ tokenName: 'anime', amount: '1000', name: 'order-12345' }]\n    // });\n\n    return escrow;\n  }\n}\n```\n\n**Key Features:**\n- **Batch Operations**: Lock/unlock/burn multiple token types in one transaction\n- **Lock Authority**: Specify who can unlock (defaults to caller)\n- **Expiration**: Optional auto-release timestamp for time-based vesting\n- **Named Locks**: Use `name` to identify specific locks for targeted unlocks\n- **EIP-712 Signatures**: Secure blockchain transactions\n- **Error Handling**: `LockError` and `BurnError` classes with specific error types\n\n**Lock Parameters (per token in array):**\n| Parameter | Required | Description |\n|-----------|----------|-------------|\n| `tokenName` | Yes* | Token to lock (e.g., 'anime') |\n| `tokenId` | Yes* | Alternative: TokenClassKey or pipe-delimited string |\n| `amount` | Yes | Amount of tokens to lock |\n| `lockAuthority` | No | Address that can unlock (defaults to caller) |\n| `expires` | No | Timestamp in ms for auto-unlock |\n| `name` | No | Identifier for matching during unlock |\n\n*Either `tokenName` or `tokenId` required\n\n**Unlock Parameters (per token in array):**\n| Parameter | Required | Description |\n|-----------|----------|-------------|\n| `tokenName` | Yes* | Token to unlock (e.g., 'anime') |\n| `tokenId` | Yes* | Alternative: TokenClassKey or pipe-delimited string |\n| `amount` | Yes | Amount of tokens to unlock |\n| `name` | No | Lock name to match (if used during lock) |\n\n**Burn Parameters (per token in array):**\n| Parameter | Required | Description |\n|-----------|----------|-------------|\n| `tokenName` | Yes* | Token to burn (e.g., 'anime') |\n| `tokenId` | Yes* | Alternative: TokenClassKey or pipe-delimited string |\n| `amount` | Yes | Amount of tokens to burn (PERMANENT!) |\n\n**Use Cases:**\n- **Staking**: Lock tokens for rewards/governance\n- **Escrow**: Third-party controlled releases\n- **Vesting**: Time-based token releases\n- **Governance**: Lock tokens for voting power\n- **Token Retirement**: Permanently burn deprecated tokens\n- **Deflationary Mechanics**: Reduce supply via burns\n\n**MCP Tool Equivalents:**\n- `gala_launchpad_lock_tokens` (batch)\n- `gala_launchpad_unlock_tokens` (batch)\n- `gala_launchpad_burn_tokens` (batch)\n- `gala_launchpad_fetch_locked_tokens`\n"
-        },
-        {
-          "userQuestion": "What parameters does lockTokens() accept?",
-          "assistantResponse": "The primary methods for Locks are `lockTokens()`, `unlockTokens()`, `burnTokens()`. Each method accepts configuration options as a single object parameter.\n\n**Common Parameters:**\n- `tokenName`: The token identifier (e.g., 'dragnrkti')\n- `amount`: Quantity as a string (for precision)\n- Wallet/auth options when transactions are involved\n\nCheck the SDK documentation or use TypeScript intellisense for the complete parameter interface."
-        },
-        {
-          "userQuestion": "What are best practices for lock and unlock tokens?",
-          "assistantResponse": "1. **Use TypeScript**: Get full type safety and intellisense.\n2. **Handle errors**: Always wrap SDK calls in try-catch blocks.\n3. **Validate inputs**: Check parameters before making API calls.\n4. **Cache when appropriate**: Reduce API calls for static data."
-        },
-        {
-          "userQuestion": "What errors should I handle when lock and unlock tokens?",
-          "assistantResponse": "**Common Errors:**\n- `InsufficientUnlockedBalance`: Can't lock more than available\n- `LockNotFound`: No lock exists to unlock\n- `UnauthorizedUnlock`: Only lock authority can unlock\n\n**Remember:** Burns are irreversible!"
-        },
-        {
-          "userQuestion": "Can you walk me through a complete lock and unlock tokens example?",
-          "assistantResponse": "**Complete Workflow: Locks**\n\nHere's the typical flow: `lockTokens()` → `unlockTokens()` → `burnTokens()`\n\n**Step-by-Step:**\n1. **Setup**: Initialize SDK with your configuration\n2. **Validate**: Check prerequisites (balances, permissions)\n3. **Calculate**: Use calculation methods to preview results\n4. **Execute**: Perform the main operation\n5. **Verify**: Confirm the operation succeeded\n\n**Pro Tip:** The SDK methods are designed to be called in sequence. Each step provides data needed for the next."
-        },
-        {
-          "userQuestion": "What should I learn next after lock and unlock tokens?",
-          "assistantResponse": "**Related Topics:**\n\n- **Transfers**: `explainSdkUsage({ topic: 'transfers' })`\n- **Balances**: `explainSdkUsage({ topic: 'balances' })`\n- **Burns**: `explainSdkUsage({ topic: 'burns' })`\n\n**Learning Path:** Start with the basics, then explore related topics to build a complete understanding of the SDK capabilities."
-        }
-      ]
-    },
-    {
-      "topicKey": "moderator-invites",
-      "label": "Moderator invites",
-      "category": "moderators",
-      "description": "Moderator invites and access",
-      "methodCount": 7,
-      "exchanges": [
-        {
-          "userQuestion": "How do I manage moderator invites?",
-          "assistantResponse": "\n# Moderator Invites - SDK v5.7.0+\n\nMagic link-based moderator delegation system. Token owners can create invite\nlinks to grant stream management access to other users without needing their\nwallet address upfront.\n\n## Flow Overview\n\n1. **Owner creates invite** → Gets magic link URL\n2. **Owner shares link** (email, Slack, Discord, etc.)\n3. **Recipient clicks link** → Redirected to claim page\n4. **Recipient logs in** → Claims invite with their wallet\n5. **Recipient gains access** → Token appears in their /studio dashboard\n\n## Creating Moderator Invites\n\n```typescript\nimport { createLaunchpadSDK, MODERATOR_ROLE } from '@gala-chain/launchpad-sdk';\n\nconst sdk = createLaunchpadSDK({\n  privateKey: process.env.PRIVATE_KEY,\n});\n\n// MUST authenticate first\nawait sdk.login();\n\n// Create an invite for a moderator\nconst result = await sdk.createModeratorInvite({\n  tokenName: 'mytoken',\n  role: MODERATOR_ROLE.MODERATOR,\n  description: 'John - Friday stream moderator',\n  expiresAt: '2025-12-31T23:59:59Z', // Optional expiration\n});\n\n// Share this URL with the intended moderator\nconsole.log('Invite URL:', result.invite.inviteUrl);\nconsole.log('Invite Code:', result.invite.inviteCode);\nconsole.log('Status:', result.invite.status); // PENDING\n```\n\n## Moderator Roles\n\n```typescript\nimport { MODERATOR_ROLE } from '@gala-chain/launchpad-sdk';\n\n// Available roles (OWNER not available for invites)\nMODERATOR_ROLE.MODERATOR           // Chat, comments, bans\nMODERATOR_ROLE.TECHNICAL_PRODUCER  // Simulcast, stream key, stop/start\nMODERATOR_ROLE.MANAGER             // All of the above + recordings + stream settings\n```\n\n## Listing Invites\n\n```typescript\n// List all invites for a token (owner only)\nconst list = await sdk.listModeratorInvites({\n  tokenName: 'mytoken',\n  status: 'PENDING', // Optional filter: PENDING, CLAIMED, REVOKED, EXPIRED\n  page: 1,\n  limit: 20,\n});\n\nconsole.log('Total invites:', list.meta.totalItems);\n\nfor (const invite of list.invites) {\n  console.log(`- ID ${invite.id}: ${invite.role}`);\n  console.log(`  Status: ${invite.status}`);\n  console.log(`  Description: ${invite.description || 'None'}`);\n  console.log(`  Created: ${invite.createdAt}`);\n  console.log(`  Expires: ${invite.expiresAt || 'Never'}`);\n}\n```\n\n## Claiming Invites (Recipient Side)\n\n```typescript\n// Extract code from magic link URL\nconst inviteCode = 'abc123...'; // 64-character hex code\n\n// Recipient authenticates and claims\nawait sdk.login();\n\nconst result = await sdk.claimModeratorInvite({\n  inviteCode: inviteCode,\n});\n\nconsole.log('Claimed token:', result.token.tokenName);\nconsole.log('Your role:', result.token.role);\nconsole.log('Claimed at:', result.token.claimedAt);\n// Token now appears in /studio dashboard\n```\n\n## Previewing Invites (Public)\n\n```typescript\n// Preview invite details before logging in (public endpoint)\nconst preview = await sdk.getModeratorInviteByCode('abc123...');\n\nconsole.log('Token:', preview.tokenName);\nconsole.log('Symbol:', preview.tokenSymbol);\nconsole.log('Role offered:', preview.role);\nconsole.log('Status:', preview.status);\nconsole.log('Invited by:', preview.invitedBy.fullName);\n```\n\n## Getting Moderated Tokens (Studio Dashboard)\n\n```typescript\n// Get all tokens where you have moderator access\nawait sdk.login();\n\nconst tokens = await sdk.getModeratedTokens({\n  page: 1,\n  limit: 20,\n});\n\nfor (const token of tokens.tokens) {\n  console.log(`- ${token.tokenName} (${token.tokenSymbol})`);\n  console.log(`  Role: ${token.role}`);\n  console.log(`  Stream status: ${token.muxStreamStatus}`);\n}\n```\n\n## Revoking Invites\n\n```typescript\n// Revoke by invite ID (owner only)\nawait sdk.revokeModeratorInvite(123);\nconsole.log('Invite revoked');\n\n// If already claimed, moderator loses access immediately\n// If pending, invite can no longer be claimed\n```\n\n## SDK Methods Reference\n\n| Method | Description | Auth |\n|--------|-------------|------|\n| `createModeratorInvite(options)` | Create magic link invite | JWT (owner) |\n| `claimModeratorInvite(options)` | Claim invite with code | JWT |\n| `getModeratedTokens(options?)` | Get tokens you moderate | JWT |\n| `listModeratorInvites(options)` | List invites for token | JWT (owner) |\n| `revokeModeratorInvite(id)` | Revoke invite by ID | JWT (owner) |\n| `getModeratorInviteByCode(code)` | Preview invite details | None |\n\n**MCP Tool Equivalents:**\n- `gala_launchpad_create_moderator_invite`\n- `gala_launchpad_claim_moderator_invite`\n- `gala_launchpad_get_moderated_tokens`\n- `gala_launchpad_list_moderator_invites`\n- `gala_launchpad_revoke_moderator_invite`\n- `gala_launchpad_get_moderator_invite`\n"
-        },
-        {
-          "userQuestion": "What parameters does createModeratorInvite() accept?",
-          "assistantResponse": "The primary methods for Moderator invites are `createModeratorInvite()`, `claimModeratorInvite()`, `getModeratedTokens()`. Each method accepts configuration options as a single object parameter.\n\n**Common Parameters:**\n- `tokenName`: The token identifier (e.g., 'dragnrkti')\n- `amount`: Quantity as a string (for precision)\n- Wallet/auth options when transactions are involved\n\nCheck the SDK documentation or use TypeScript intellisense for the complete parameter interface."
-        },
-        {
-          "userQuestion": "What are best practices for manage moderator invites?",
-          "assistantResponse": "1. **Use TypeScript**: Get full type safety and intellisense.\n2. **Handle errors**: Always wrap SDK calls in try-catch blocks.\n3. **Validate inputs**: Check parameters before making API calls.\n4. **Cache when appropriate**: Reduce API calls for static data."
-        },
-        {
-          "userQuestion": "What errors should I handle when manage moderator invites?",
-          "assistantResponse": "**General Error Handling:**\n\n```typescript\ntry {\n  const result = await sdk.moderatorinvites(...);\n} catch (error) {\n  if (error instanceof Error) {\n    console.error('Operation failed:', error.message);\n    // Handle specific error types\n  }\n}\n```\n\n**Common Issues:**\n- Network timeouts - implement retry logic\n- Invalid parameters - validate before calling\n- Authentication errors - ensure valid session"
-        },
-        {
-          "userQuestion": "Can you walk me through a complete manage moderator invites example?",
-          "assistantResponse": "**Complete Workflow: Moderator invites**\n\nHere's the typical flow: `createModeratorInvite()` → `claimModeratorInvite()` → `getModeratedTokens()`\n\n**Step-by-Step:**\n1. **Setup**: Initialize SDK with your configuration\n2. **Validate**: Check prerequisites (balances, permissions)\n3. **Calculate**: Use calculation methods to preview results\n4. **Execute**: Perform the main operation\n5. **Verify**: Confirm the operation succeeded\n\n**Pro Tip:** The SDK methods are designed to be called in sequence. Each step provides data needed for the next."
-        },
-        {
-          "userQuestion": "What other methods are available for Moderator invites?",
-          "assistantResponse": "**Additional Methods:**\n\n- `listModeratorInvites()`\n- `revokeModeratorInvite()`\n- `getModeratorInviteByCode()`\n- `updateModeratorInviteRole()`\n\n**Total methods in this topic:** 7\n\nEach method serves a specific purpose in the workflow. Use TypeScript intellisense or the SDK documentation to explore parameter options for each method."
-        },
-        {
-          "userQuestion": "When would I actually use manage moderator invites in a real application?",
-          "assistantResponse": "**Real-World Use Cases:**\n\n1. **Community Moderation**: Delegate chat moderation to trusted members\n2. **Technical Teams**: Give stream control to production staff\n3. **Multi-Admin Setup**: Multiple managers for large communities\n4. **Temporary Access**: Time-limited invites for events"
-        },
-        {
-          "userQuestion": "What should I learn next after manage moderator invites?",
-          "assistantResponse": "**Related Topics:**\n\n- **Overseer invites**: `explainSdkUsage({ topic: 'overseer-invites' })`\n- **Ban management**: `explainSdkUsage({ topic: 'ban-management' })`\n- **Streaming**: `explainSdkUsage({ topic: 'streaming' })`\n\n**Learning Path:** Start with the basics, then explore related topics to build a complete understanding of the SDK capabilities."
-        }
-      ]
-    },
-    {
-      "topicKey": "nft-collection-management",
-      "label": "Nft collection management",
-      "category": "nft",
-      "description": "NFT collection management and operations",
-      "methodCount": 11,
-      "exchanges": [
-        {
-          "userQuestion": "How do I nft collection management?",
-          "assistantResponse": "\n# NFT Collection Management - SDK v5.12.0+\n\nCreate and manage NFT collections, token classes, and mint NFTs on GalaChain.\n\n**Key Concepts:**\n- **Collection**: A named grouping for NFT token classes (claimed for 10,000 GALA)\n- **Token Class**: A specific type/rarity within a collection (created for 1,000 GALA)\n- **NFT Instance**: Individual NFT minted from a token class (dynamic fee based on quantity)\n\n## Check Collection Availability\n\n```typescript\nimport { createLaunchpadSDK } from '@gala-chain/launchpad-sdk';\n\nconst sdk = createLaunchpadSDK({ privateKey: 'your-private-key' });\n\n// Check if a collection name is available\nconst available = await sdk.isNftCollectionAvailable('MyEpicNFTs');\nconsole.log('Collection available:', available);\n\n// Get fee for claiming a collection\nconst claimFee = await sdk.getNftCollectionClaimFee();\nconsole.log('Claim fee:', claimFee); // Usually \"10000\" GALA\n```\n\n## Claim a Collection\n\n```typescript\n// Claim an available collection name\nconst result = await sdk.claimNftCollection({\n  collectionName: 'MyEpicNFTs',\n  description: 'Epic NFT collection for gaming',\n});\nconsole.log('Collection claimed:', result.collectionName);\nconsole.log('Transaction ID:', result.transactionId);\n\n// Fetch your owned collections\nconst collections = await sdk.fetchNftCollections(walletAddress);\nfor (const collection of collections) {\n  console.log(`Collection: ${collection.collectionName}`);\n  console.log(`  Status: ${collection.status}`);\n}\n```\n\n## Create Token Classes (Rarities)\n\n```typescript\n// Get fee for creating a token class\nconst classCreateFee = await sdk.getNftTokenClassCreateFee();\nconsole.log('Create fee:', classCreateFee); // Usually \"1000\" GALA\n\n// Create a token class (rarity tier)\nconst classResult = await sdk.createNftTokenClass({\n  collectionName: 'MyEpicNFTs',\n  tokenClassName: 'LegendaryWizard',\n  description: 'Ultra-rare legendary wizard NFTs',\n  maximumSupply: '100',  // Max NFTs of this type\n  data: {\n    rarity: 'legendary',\n    class: 'wizard',\n    power: '9000',\n  },\n});\nconsole.log('Token class created:', classResult.tokenClassName);\n\n// Fetch token classes for your collection\nconst classes = await sdk.fetchNftTokenClasses({\n  collectionName: 'MyEpicNFTs',\n});\nfor (const tokenClass of classes) {\n  console.log(`Class: ${tokenClass.tokenClassName}`);\n  console.log(`  Current Supply: ${tokenClass.currentSupply}/${tokenClass.maxSupply}`);\n}\n```\n\n## Estimate Mint Fees\n\n```typescript\n// Estimate fee for minting multiple NFTs\nconst mintFeeEstimate = await sdk.estimateNftMintFee({\n  collectionName: 'MyEpicNFTs',\n  tokenClassName: 'LegendaryWizard',\n  quantity: 5,\n});\nconsole.log('Estimated mint fee:', mintFeeEstimate); // Dynamic fee in GALA\n\n// Estimate multiple operations at once\nconst bundleFee = await sdk.estimateNftOperationFees({\n  operations: [\n    { type: 'claim_collection' },\n    { type: 'create_token_class', collectionName: 'MyEpicNFTs' },\n    { type: 'mint', quantity: 10 },\n  ],\n});\nconsole.log('Total bundle fee:', bundleFee.totalFee);\nfor (const op of bundleFee.breakdown) {\n  console.log(`  ${op.operationType}: ${op.fee}`);\n}\n```\n\n## Mint NFTs\n\n```typescript\n// Mint NFT instances from a token class\nconst mintResult = await sdk.mintNft({\n  collectionName: 'MyEpicNFTs',\n  tokenClassName: 'LegendaryWizard',\n  quantity: 5,\n  to: 'eth|0x...', // Recipient wallet\n  metadata: {\n    attributes: [\n      { name: 'level', value: '50' },\n      { name: 'element', value: 'fire' },\n    ],\n  },\n});\nconsole.log('Minted:', mintResult.quantityMinted);\nconsole.log('Transaction ID:', mintResult.transactionId);\n\n// Check NFT balances\nconst balances = await sdk.fetchNftBalances(walletAddress);\nfor (const balance of balances) {\n  console.log(`${balance.collectionName}/${balance.tokenClassName}: ${balance.quantity}`);\n}\n\n// Filter by collection\nconst collectionBalances = await sdk.fetchNftBalances(walletAddress, 'MyEpicNFTs');\n```\n\n## Complete Workflow\n\n```typescript\n// 1. Check availability\nconst available = await sdk.isNftCollectionAvailable('MyEpicNFTs');\nif (!available) throw new Error('Collection name taken');\n\n// 2. Claim collection (10,000 GALA)\nconst claimResult = await sdk.claimNftCollection({\n  collectionName: 'MyEpicNFTs',\n  description: 'My epic NFT collection',\n});\nconsole.log('✓ Collection claimed');\n\n// 3. Create token class (1,000 GALA)\nconst classResult = await sdk.createNftTokenClass({\n  collectionName: 'MyEpicNFTs',\n  tokenClassName: 'Legendary',\n  description: 'Legendary tier NFTs',\n  maximumSupply: '1000',\n});\nconsole.log('✓ Token class created');\n\n// 4. Estimate mint fee\nconst fee = await sdk.estimateNftMintFee({\n  collectionName: 'MyEpicNFTs',\n  tokenClassName: 'Legendary',\n  quantity: 100,\n});\nconsole.log(`✓ Mint fee: ${fee} GALA`);\n\n// 5. Mint NFTs\nconst mintResult = await sdk.mintNft({\n  collectionName: 'MyEpicNFTs',\n  tokenClassName: 'Legendary',\n  quantity: 100,\n  to: userWallet,\n});\nconsole.log('✓ Minted:', mintResult.quantityMinted);\n\n// 6. Verify ownership\nconst balances = await sdk.fetchNftBalances(userWallet, 'MyEpicNFTs');\nconsole.log('Total NFTs:', balances.reduce((sum, b) => sum + parseInt(b.quantity), 0));\n```\n\n**MCP Tool Equivalents:**\n- `gala_launchpad_get_nft_collection_claim_fee`\n- `gala_launchpad_get_nft_token_class_create_fee`\n- `gala_launchpad_estimate_nft_mint_fee`\n- `gala_launchpad_estimate_nft_operation_fees`\n- `gala_launchpad_check_nft_collection_available`\n- `gala_launchpad_claim_nft_collection`\n- `gala_launchpad_fetch_nft_collections`\n- `gala_launchpad_create_nft_token_class`\n- `gala_launchpad_fetch_nft_token_classes`\n- `gala_launchpad_mint_nft`\n- `gala_launchpad_fetch_nft_balances`\n"
-        },
-        {
-          "userQuestion": "What parameters does getNftCollectionClaimFee() accept?",
-          "assistantResponse": "The primary methods for Nft collection management are `getNftCollectionClaimFee()`, `getNftTokenClassCreateFee()`, `estimateNftMintFee()`. Each method accepts configuration options as a single object parameter.\n\n**Common Parameters:**\n- `tokenName`: The token identifier (e.g., 'dragnrkti')\n- `amount`: Quantity as a string (for precision)\n- Wallet/auth options when transactions are involved\n\nCheck the SDK documentation or use TypeScript intellisense for the complete parameter interface."
-        },
-        {
-          "userQuestion": "What are best practices for nft collection management?",
-          "assistantResponse": "1. **Use TypeScript**: Get full type safety and intellisense.\n2. **Handle errors**: Always wrap SDK calls in try-catch blocks.\n3. **Validate inputs**: Check parameters before making API calls.\n4. **Cache when appropriate**: Reduce API calls for static data."
-        },
-        {
-          "userQuestion": "Can you walk me through a complete nft collection management example?",
-          "assistantResponse": "**Complete Workflow: Nft collection management**\n\nHere's the typical flow: `getNftCollectionClaimFee()` → `getNftTokenClassCreateFee()` → `estimateNftMintFee()`\n\n**Step-by-Step:**\n1. **Setup**: Initialize SDK with your configuration\n2. **Validate**: Check prerequisites (balances, permissions)\n3. **Calculate**: Use calculation methods to preview results\n4. **Execute**: Perform the main operation\n5. **Verify**: Confirm the operation succeeded\n\n**Pro Tip:** The SDK methods are designed to be called in sequence. Each step provides data needed for the next."
-        },
-        {
-          "userQuestion": "What other methods are available for Nft collection management?",
-          "assistantResponse": "**Additional Methods:**\n\n- `estimateNftOperationFees()`\n- `isNftCollectionAvailable()`\n- `claimNftCollection()`\n- `fetchNftCollections()`\n\n**Total methods in this topic:** 11\n\nEach method serves a specific purpose in the workflow. Use TypeScript intellisense or the SDK documentation to explore parameter options for each method."
-        },
-        {
-          "userQuestion": "What should I learn next after nft collection management?",
-          "assistantResponse": "**Related Topics:**\n\n- Check the SDK documentation for related functionality\n\n**Learning Path:** Start with the basics, then explore related topics to build a complete understanding of the SDK capabilities."
-        },
-        {
-          "userQuestion": "Are there any advanced patterns for this topic?",
-          "assistantResponse": "**Advanced Patterns:**\n\n1. **Batching**: Combine multiple operations for efficiency\n2. **Caching**: Cache frequently-accessed data locally\n3. **Event-Driven**: Use subscriptions for real-time updates\n4. **Error Recovery**: Implement retry logic with exponential backoff\n5. **Monitoring**: Track operation success rates and latencies\n\n**Performance Tip:** For high-volume operations, consider using the local calculation methods where available to reduce network calls."
-        }
-      ]
-    },
-    {
-      "topicKey": "overseer-invites",
-      "label": "Overseer invites",
-      "category": "overseers",
-      "description": "Global platform oversight",
-      "methodCount": 9,
-      "exchanges": [
-        {
-          "userQuestion": "How do I manage overseer invites?",
-          "assistantResponse": "\n# Overseer System - SDK v5.9.0+\n\nGlobal platform oversight via magic link invites. Overseers have MANAGER-level\naccess to ALL tokens (current and future), unlike moderators who have token-scoped access.\n\n## Key Differences from Moderators\n\n| Feature | Moderator | Overseer |\n|---------|-----------|----------|\n| Scope | Per-token or blanket (owner's tokens) | ALL tokens on platform |\n| Access Level | MODERATOR, TECHNICAL_PRODUCER, or MANAGER | Always MANAGER |\n| Grant Authority | Token owner | Admin or existing Overseer |\n| Use Case | Stream management delegation | Platform-wide oversight |\n\n## Creating Overseer Invites\n\n```typescript\nimport { createLaunchpadSDK } from '@gala-chain/launchpad-sdk';\n\nconst sdk = createLaunchpadSDK({\n  privateKey: process.env.PRIVATE_KEY,\n  streamAdminApiKey: process.env.STREAM_ADMIN_API_KEY, // Admin key OR JWT auth\n});\n\n// Option 1: Using Admin API key\nconst result = await sdk.createOverseerInvite({\n  description: 'John - Platform Support Team',\n  expiresAt: '2025-12-31T23:59:59Z', // Optional\n});\n\n// Option 2: Using JWT (as existing Overseer)\nawait sdk.login();\nconst result = await sdk.createOverseerInvite({\n  description: 'Platform team member',\n});\n\nconsole.log('Share this link:', result.invite.inviteUrl);\nconsole.log('Invite Code:', result.invite.inviteCode);\n```\n\n## Claiming Overseer Invites\n\n```typescript\n// Recipient must be authenticated\nawait sdk.login();\n\n// Claim the invite\nconst claimed = await sdk.claimOverseerInvite('abc123...');\nconsole.log('Now an overseer!');\nconsole.log('Status:', claimed.invite.status); // CLAIMED\n\n// Check own status\nconst status = await sdk.getMyOverseerStatus();\nconsole.log('Is Overseer:', status.isOverseer); // true\nconsole.log('Granted at:', status.overseer?.createdAt);\n```\n\n## Listing Overseers and Invites\n\n```typescript\n// List all overseer invites (paginated)\nconst invites = await sdk.listOverseerInvites({\n  status: 'PENDING', // PENDING, CLAIMED, REVOKED, EXPIRED\n  page: 1,\n  limit: 20,\n});\n\nfor (const invite of invites.invites) {\n  console.log(`#${invite.id}: ${invite.description || 'No description'}`);\n  console.log(`  Status: ${invite.status}`);\n  console.log(`  Created by: ${invite.invitedBy.fullName || invite.invitedBy.address}`);\n}\n\n// List all active overseers\nconst overseers = await sdk.listOverseers({\n  status: 'ACTIVE', // ACTIVE or REVOKED\n  page: 1,\n  limit: 20,\n});\n\nfor (const overseer of overseers.overseers) {\n  console.log(`Overseer: ${overseer.userAddress}`);\n  console.log(`  Since: ${overseer.createdAt}`);\n}\n```\n\n## Public Invite Preview\n\n```typescript\n// Get public info about an invite (no auth required)\nconst preview = await sdk.getOverseerInviteByCode('abc123...');\n\nconsole.log('Status:', preview.status);\nconsole.log('Description:', preview.description);\nconsole.log('Invited by:', preview.invitedBy.fullName);\nconsole.log('Expires:', preview.expiresAt);\n```\n\n## Revoking Access\n\n```typescript\n// Revoke an invite by ID\nawait sdk.revokeOverseerInvite(123);\nconsole.log('Invite revoked');\n\n// Revoke an overseer by wallet address\nawait sdk.revokeOverseer('eth|1234567890abcdef...');\nconsole.log('Overseer access revoked');\n```\n\n## SDK Methods Reference\n\n| Method | Description | Auth |\n|--------|-------------|------|\n| `createOverseerInvite(options?)` | Create magic link invite | Admin API key OR JWT (Overseer) |\n| `claimOverseerInvite(code)` | Claim invite with code | JWT |\n| `listOverseerInvites(options?)` | List all overseer invites | Admin API key OR JWT (Overseer) |\n| `getOverseerInviteByCode(code)` | Preview invite details | None (public) |\n| `revokeOverseerInvite(id)` | Revoke invite by ID | Admin API key OR JWT (Overseer) |\n| `listOverseers(options?)` | List all overseers | Admin API key OR JWT (Overseer) |\n| `revokeOverseer(address)` | Revoke overseer by address | Admin API key OR JWT (Overseer) |\n| `getMyOverseerStatus()` | Check own overseer status | JWT |\n\n**MCP Tool Equivalents:**\n- `gala_launchpad_create_overseer_invite`\n- `gala_launchpad_claim_overseer_invite`\n- `gala_launchpad_list_overseer_invites`\n- `gala_launchpad_get_overseer_invite`\n- `gala_launchpad_revoke_overseer_invite`\n- `gala_launchpad_list_overseers`\n- `gala_launchpad_revoke_overseer`\n- `gala_launchpad_get_my_overseer_status`\n- `gala_launchpad_get_overseer_summary`\n"
-        },
-        {
-          "userQuestion": "What parameters does createOverseerInvite() accept?",
-          "assistantResponse": "The primary methods for Overseer invites are `createOverseerInvite()`, `claimOverseerInvite()`, `listOverseerInvites()`. Each method accepts configuration options as a single object parameter.\n\n**Common Parameters:**\n- `tokenName`: The token identifier (e.g., 'dragnrkti')\n- `amount`: Quantity as a string (for precision)\n- Wallet/auth options when transactions are involved\n\nCheck the SDK documentation or use TypeScript intellisense for the complete parameter interface."
-        },
-        {
-          "userQuestion": "What are best practices for manage overseer invites?",
-          "assistantResponse": "1. **Use TypeScript**: Get full type safety and intellisense.\n2. **Handle errors**: Always wrap SDK calls in try-catch blocks.\n3. **Validate inputs**: Check parameters before making API calls.\n4. **Cache when appropriate**: Reduce API calls for static data."
-        },
-        {
-          "userQuestion": "What errors should I handle when manage overseer invites?",
-          "assistantResponse": "**General Error Handling:**\n\n```typescript\ntry {\n  const result = await sdk.overseerinvites(...);\n} catch (error) {\n  if (error instanceof Error) {\n    console.error('Operation failed:', error.message);\n    // Handle specific error types\n  }\n}\n```\n\n**Common Issues:**\n- Network timeouts - implement retry logic\n- Invalid parameters - validate before calling\n- Authentication errors - ensure valid session"
-        },
-        {
-          "userQuestion": "Can you walk me through a complete manage overseer invites example?",
-          "assistantResponse": "**Complete Workflow: Overseer invites**\n\nHere's the typical flow: `createOverseerInvite()` → `claimOverseerInvite()` → `listOverseerInvites()`\n\n**Step-by-Step:**\n1. **Setup**: Initialize SDK with your configuration\n2. **Validate**: Check prerequisites (balances, permissions)\n3. **Calculate**: Use calculation methods to preview results\n4. **Execute**: Perform the main operation\n5. **Verify**: Confirm the operation succeeded\n\n**Pro Tip:** The SDK methods are designed to be called in sequence. Each step provides data needed for the next."
-        },
-        {
-          "userQuestion": "What other methods are available for Overseer invites?",
-          "assistantResponse": "**Additional Methods:**\n\n- `getOverseerInviteByCode()`\n- `revokeOverseerInvite()`\n- `listOverseers()`\n- `revokeOverseer()`\n\n**Total methods in this topic:** 9\n\nEach method serves a specific purpose in the workflow. Use TypeScript intellisense or the SDK documentation to explore parameter options for each method."
-        },
-        {
-          "userQuestion": "What should I learn next after manage overseer invites?",
-          "assistantResponse": "**Related Topics:**\n\n- **Moderator invites**: `explainSdkUsage({ topic: 'moderator-invites' })`\n- **Token ban management**: `explainSdkUsage({ topic: 'token-ban-management' })`\n- **Content flag management**: `explainSdkUsage({ topic: 'content-flag-management' })`\n\n**Learning Path:** Start with the basics, then explore related topics to build a complete understanding of the SDK capabilities."
-        }
-      ]
-    },
-    {
-      "topicKey": "fetch-pools",
-      "label": "Fetch pools",
-      "category": "pools",
-      "description": "Pool management, pricing, and token availability",
-      "methodCount": 10,
-      "exchanges": [
-        {
-          "userQuestion": "How do I fetch and search token pools?",
-          "assistantResponse": "\n## Fetching Pool Data with Advanced Methods\n\n**Covers Methods:**\n- `fetchPools()`\n- `fetchAllPools()`\n- `fetchPoolDetails()`\n- `fetchPoolDetailsForCalculation()`\n- `fetchVolumeData()`\n- `fetchTokenPrice()`\n- `fetchTokenDistribution()`\n- `fetchTokenBadges()`\n- `resolveVaultAddress()`\n- `resolveTokenClassKey()`\n\n```typescript\nimport { createLaunchpadSDK, compareAmounts } from '@gala-chain/launchpad-sdk';\n\n// 1. BASIC POOL FETCHING - With Pagination\nasync function basicPoolFetching() {\n  const sdk = createLaunchpadSDK({ wallet: 'your-private-key' });\n\n  // Fetch recent pools with pagination\n  const pools = await sdk.fetchPools({\n    type: 'recent',\n    limit: 10,\n    page: 1\n  });\n\n  console.log(`Found ${pools.total} pools, page ${pools.page} of ${pools.totalPages}`);\n  pools.pools.forEach(pool => {\n    console.log(`${pool.tokenName}: ${pool.tokenSymbol}`);\n  });\n}\n\n// 2. AUTO-PAGINATED FETCHING - Get ALL Pools\nasync function fetchAllPools() {\n  const sdk = createLaunchpadSDK({ wallet: 'your-private-key' });\n\n  // Auto-paginated - returns all pools without manual pagination\n  const allPools = await sdk.fetchAllPools({\n    type: 'recent'\n  });\n\n  console.log(`Total pools: ${allPools.pools.length}`);\n}\n\n// 3. POOL DETAILS - Complete information\nasync function getPoolDetails(tokenName) {\n  const sdk = createLaunchpadSDK({ wallet: 'your-private-key' });\n\n  const details = await sdk.fetchPoolDetails(tokenName);\n\n  console.log('Sale status:', details.saleStatus); // 'Ongoing' or 'Completed'\n  console.log('Base price:', details.basePrice);\n  console.log('Max supply:', details.maxSupply);\n  console.log('Remaining tokens:', details.sellingTokenQuantity);\n}\n\n// 4. POOL DETAILS FOR CALCULATIONS - Optimized for math\nasync function getOptimizedPoolDetails(tokenName) {\n  const sdk = createLaunchpadSDK({ wallet: 'your-private-key' });\n\n  // Returns only fields needed for bonding curve calculations\n  const poolData = await sdk.fetchPoolDetailsForCalculation(tokenName);\n\n  console.log('Current supply:', poolData.currentSupply);\n  console.log('Remaining tokens:', poolData.remainingTokens);\n  console.log('Max supply:', poolData.maxSupply);\n  console.log('Reverse bonding curve max fee:', poolData.reverseBondingCurveMaxFeeFactor);\n}\n\n// 5. VOLUME & OHLCV DATA - Historical candlestick data\nasync function getVolumeData(tokenName) {\n  const sdk = createLaunchpadSDK({ wallet: 'your-private-key' });\n\n  // Different resolutions: '1m', '5m', '15m', '1h', '4h', '1d'\n  const volumeData = await sdk.fetchVolumeData({\n    tokenName: tokenName,\n    from: new Date(Date.now() - 7 * 24 * 60 * 60 * 1000), // Last 7 days\n    to: new Date(),\n    resolution: '1h' // 1-hour candlesticks\n  });\n\n  volumeData.forEach(candle => {\n    console.log(`${candle.time}: O:${candle.open} H:${candle.high} L:${candle.low} C:${candle.close} V:${candle.volume}`);\n  });\n}\n\n// 6. SPOT PRICES - DEX tokens (GALA, SILK, MUSIC)\nasync function getDexTokenPrices() {\n  const sdk = createLaunchpadSDK({ wallet: 'your-private-key' });\n\n  // Fetch prices for multiple DEX tokens\n  const prices = await sdk.fetchTokenPrice(['GALA', 'SILK', 'MUSIC']);\n\n  console.log(`GALA: $${prices.GALA}`);\n  console.log(`SILK: $${prices.SILK}`);\n  console.log(`MUSIC: $${prices.MUSIC}`);\n}\n\n// 7. LAUNCHPAD TOKEN SPOT PRICES (via smart router)\nasync function getLaunchpadTokenPrice(tokenName) {\n  const sdk = createLaunchpadSDK({ wallet: 'your-private-key' });\n\n  // Get USD spot price for a launchpad token (anime, woohoo, etc.)\n  const price = await sdk.fetchTokenPrice({ tokenName });\n\n  console.log(`${tokenName} price: $${price.price}`);\n}\n\n// 8. RESOLVE UTILITY ADDRESSES\nasync function resolveAddresses(tokenName) {\n  const sdk = createLaunchpadSDK({ wallet: 'your-private-key' });\n\n  // Get GalaChain vault address for token\n  const vaultAddress = await sdk.resolveVaultAddress(tokenName);\n  console.log(`Vault address: ${vaultAddress}`);\n\n  // Get TokenClassKey for token\n  const tokenClassKey = await sdk.resolveTokenClassKey(tokenName);\n  console.log(`TokenClassKey: ${tokenClassKey}`);\n}\n\n// 9. COMPLETE INVESTMENT ANALYSIS WORKFLOW\nasync function analyzeToken(tokenName) {\n  const sdk = createLaunchpadSDK({ wallet: 'your-private-key' });\n\n  // Get all token data in parallel\n  const [details, volumeData, distribution, badges] = await Promise.all([\n    sdk.fetchPoolDetails(tokenName),\n    sdk.fetchVolumeData({ tokenName, resolution: '1d' }),\n    sdk.fetchTokenDistribution(tokenName),\n    sdk.fetchTokenBadges(tokenName)\n  ]);\n\n  // Analyze status\n  console.log(`Pool Status: ${details.saleStatus}`);\n  console.log(`Supply: ${details.currentSupply} / ${details.maxSupply}`);\n\n  // Analyze volume trend\n  // Note: For analytics/aggregation, we use safeParseFloat for performance. For trades, use BigNumber via SDK\n  const volumes = volumeData.map(v => safeParseFloat(v.volume, 0));\n  const avgVolume = volumes.reduce((a, b) => a + b, 0) / volumes.length;\n  console.log(`Avg daily volume: $${toBigNumberFixed(avgVolume, 2)}`);\n\n  // Analyze distribution\n  // Use compareAmounts for precise balance comparisons\n  const top5Ownership = distribution.holders\n    .sort((a, b) => compareAmounts(b.balance, a.balance) > 0 ? 1 : -1)\n    .slice(0, 5)\n    .reduce((sum, h) => sum + h.percentage, 0);\n  console.log(`Top 5 holders: ${toBigNumberFixed(top5Ownership, 2)}%`);\n\n  // Check badges\n  console.log(`Badges: ${badges.join(', ')}`);\n}\n```\n\n**MCP Tool Equivalents:**\n- `gala_launchpad_fetch_pools` - Paginated pool list\n- `gala_launchpad_fetch_all_pools` - Auto-paginated all pools\n- `gala_launchpad_fetch_pool_details` - Complete pool information\n- `gala_launchpad_fetch_pool_details_for_calculation` - Optimized for calculations\n- `gala_launchpad_fetch_volume_data` - OHLCV candlestick data\n- `gala_launchpad_fetch_token_spot_price` - DEX token prices (GALA, SILK, MUSIC)\n- `gala_launchpad_fetch_launchpad_token_spot_price` - Launchpad token USD prices\n- `gala_launchpad_fetch_token_distribution` - Token holder analysis\n- `gala_launchpad_fetch_token_badges` - Achievement badges\n- `gala_launchpad_resolve_vault_address` - Get vault address\n- `gala_launchpad_resolve_token_class_key` - Get TokenClassKey\n"
-        },
-        {
-          "userQuestion": "What parameters does fetchPools() accept?",
-          "assistantResponse": "The primary methods for Fetch pools are `fetchPools()`, `fetchAllPools()`, `fetchPoolDetails()`. Each method accepts configuration options as a single object parameter.\n\n**Common Parameters:**\n- `tokenName`: The token identifier (e.g., 'dragnrkti')\n- `amount`: Quantity as a string (for precision)\n- Wallet/auth options when transactions are involved\n\nCheck the SDK documentation or use TypeScript intellisense for the complete parameter interface."
-        },
-        {
-          "userQuestion": "What are best practices for fetch and search token pools?",
-          "assistantResponse": "1. **Use TypeScript**: Get full type safety and intellisense.\n2. **Handle errors**: Always wrap SDK calls in try-catch blocks.\n3. **Validate inputs**: Check parameters before making API calls.\n4. **Cache when appropriate**: Reduce API calls for static data."
-        },
-        {
-          "userQuestion": "Can you walk me through a complete fetch and search token pools example?",
-          "assistantResponse": "**Complete Workflow: Fetch pools**\n\nHere's the typical flow: `fetchPools()` → `fetchAllPools()` → `fetchPoolDetails()`\n\n**Step-by-Step:**\n1. **Setup**: Initialize SDK with your configuration\n2. **Validate**: Check prerequisites (balances, permissions)\n3. **Calculate**: Use calculation methods to preview results\n4. **Execute**: Perform the main operation\n5. **Verify**: Confirm the operation succeeded\n\n**Pro Tip:** The SDK methods are designed to be called in sequence. Each step provides data needed for the next."
-        },
-        {
-          "userQuestion": "What other methods are available for Fetch pools?",
-          "assistantResponse": "**Additional Methods:**\n\n- `fetchPoolDetailsForCalculation()`\n- `fetchVolumeData()`\n- `fetchTokenPrice()`\n- `fetchTokenDistribution()`\n\n**Total methods in this topic:** 10\n\nEach method serves a specific purpose in the workflow. Use TypeScript intellisense or the SDK documentation to explore parameter options for each method."
-        },
-        {
-          "userQuestion": "What should I learn next after fetch and search token pools?",
-          "assistantResponse": "**Related Topics:**\n\n- **Token details**: `explainSdkUsage({ topic: 'token-details' })`\n- **Token distribution**: `explainSdkUsage({ topic: 'token-distribution' })`\n- **Price history**: `explainSdkUsage({ topic: 'price-history' })`\n\n**Learning Path:** Start with the basics, then explore related topics to build a complete understanding of the SDK capabilities."
-        },
-        {
-          "userQuestion": "Are there any advanced patterns for this topic?",
-          "assistantResponse": "**Advanced Patterns:**\n\n1. **Batching**: Combine multiple operations for efficiency\n2. **Caching**: Cache frequently-accessed data locally\n3. **Event-Driven**: Use subscriptions for real-time updates\n4. **Error Recovery**: Implement retry logic with exponential backoff\n5. **Monitoring**: Track operation success rates and latencies\n\n**Performance Tip:** For high-volume operations, consider using the local calculation methods where available to reduce network calls."
-        }
-      ]
-    },
-    {
-      "topicKey": "price-history",
-      "label": "Price history",
-      "category": "pools",
-      "description": "Pool management, pricing, and token availability",
-      "methodCount": 2,
-      "exchanges": [
-        {
-          "userQuestion": "How do I view token price history?",
-          "assistantResponse": "\n## Historical Price Analysis with SDK\n\n**Covers Methods:**\n- `fetchPriceHistory()`\n- `fetchAllPriceHistory()`\n\n```typescript\nimport { createLaunchpadSDK } from '@gala-chain/launchpad-sdk';\n\nasync function analyzePriceHistory() {\n  const sdk = createLaunchpadSDK({\n    wallet: 'your-private-key-or-mnemonic'\n  });\n\n  // Paginated price history\n  const history = await sdk.fetchPriceHistory({\n    tokenId: 'GUSDC|Unit|none|eth:0x...',\n    from: new Date('2025-01-01'),\n    to: new Date('2025-01-31'),\n    sortOrder: 'DESC',\n    page: 1,\n    limit: 50\n  });\n\n  console.log(`Found ${history.snapshots.length} snapshots`);\n  console.log(`Total available: ${history.total} (page ${history.page} of ${history.totalPages})`);\n\n  // Auto-paginated complete history\n  const allHistory = await sdk.fetchAllPriceHistory({\n    tokenId: 'GWETH|Unit|none|none',\n    from: new Date('2024-01-01'),\n    sortOrder: 'ASC'\n  });\n\n  // Price analysis - Convert strings to numbers for statistical calculations\n  // Note: For precise trading amounts, use compareAmounts() from SDK instead\n  const prices = allHistory.snapshots.map(s => safeParseNumber(s.price, 0));\n  const avg = prices.reduce((a, b) => a + b, 0) / prices.length;\n  const variance = prices.reduce((sum, p) => sum + Math.pow(p - avg, 2), 0) / prices.length;\n  const volatility = Math.sqrt(variance);\n\n  console.log(`Average: $${toBigNumberFixed(avg, 4)}, Volatility: $${toBigNumberFixed(volatility, 4)}`);\n\n  // Data export (CSV)\n  const csv = ['timestamp,price'].concat(\n    allHistory.snapshots.map(s => `${s.timestamp.toISOString()},${s.price}`)\n  ).join('\\n');\n\n  console.log('CSV export:', csv.split('\\n').slice(0, 3).join('\\n'));\n}\n```\n\n**Key Methods:**\n- `fetchPriceHistory()` - Paginated historical prices (max 50 per page)\n- `fetchAllPriceHistory()` - Auto-paginated complete history (all snapshots)\n\n**Response Fields:**\n- `price` - Token price as decimal string\n- `timestamp` - ISO 8601 timestamp\n- `tokenId` - Token identifier (pipe-delimited)\n\n**Use Cases:**\n- Technical analysis and charting\n- Volatility assessment\n- Price trend identification\n- Data export for analytics\n- Backtesting strategies\n\n**Token ID Formats:**\n- String: `GUSDC|Unit|none|eth:0x...`\n- Object: `{ collection, category, type, additionalKey }`\n\n**MCP Tool Equivalents:**\n- `gala_launchpad_fetch_price_history` - Paginated\n- `gala_launchpad_fetch_all_price_history` - Auto-paginated\n"
-        },
-        {
-          "userQuestion": "What parameters does fetchPriceHistory() accept?",
-          "assistantResponse": "The primary methods for Price history are `fetchPriceHistory()`, `fetchAllPriceHistory()`. Each method accepts configuration options as a single object parameter.\n\n**Common Parameters:**\n- `tokenName`: The token identifier (e.g., 'dragnrkti')\n- `amount`: Quantity as a string (for precision)\n- Wallet/auth options when transactions are involved\n\nCheck the SDK documentation or use TypeScript intellisense for the complete parameter interface."
-        },
-        {
-          "userQuestion": "What are best practices for view token price history?",
-          "assistantResponse": "1. **Use TypeScript**: Get full type safety and intellisense.\n2. **Handle errors**: Always wrap SDK calls in try-catch blocks.\n3. **Validate inputs**: Check parameters before making API calls.\n4. **Cache when appropriate**: Reduce API calls for static data."
-        },
-        {
-          "userQuestion": "What should I learn next after view token price history?",
-          "assistantResponse": "**Related Topics:**\n\n- **Fetch pools**: `explainSdkUsage({ topic: 'fetch-pools' })`\n- **Token details**: `explainSdkUsage({ topic: 'token-details' })`\n- **Trading analytics**: `explainSdkUsage({ topic: 'trading-analytics' })`\n\n**Learning Path:** Start with the basics, then explore related topics to build a complete understanding of the SDK capabilities."
-        },
-        {
-          "userQuestion": "Any final tips for view token price history?",
-          "assistantResponse": "**Quick Tips:**\n\n1. **Start Simple**: Begin with the basic use case before exploring advanced features\n2. **Use TypeScript**: The SDK has full TypeScript support for better autocomplete and type safety\n3. **Check the Demos**: The examples/ directory has working demos for most SDK features\n4. **Read Error Messages**: SDK errors include helpful context for troubleshooting\n\nYou're ready to start building with this feature!"
-        }
-      ]
-    },
-    {
-      "topicKey": "token-details",
-      "label": "Token details",
-      "category": "pools",
-      "description": "Pool management, pricing, and token availability",
-      "methodCount": 1,
-      "exchanges": [
-        {
-          "userQuestion": "How do I get token details and information?",
-          "assistantResponse": "\n## Token Details and Metadata with SDK\n\n**Covers Methods:**\n- `fetchTokenDetails()`\n\n```typescript\nimport { createLaunchpadSDK } from '@gala-chain/launchpad-sdk';\n\nasync function analyzeTokenDetails() {\n  const sdk = createLaunchpadSDK({\n    wallet: 'your-private-key-or-mnemonic'\n  });\n\n  // Fetch token metadata\n  const details = await sdk.fetchTokenDetails('GUSDC|Unit|none|eth:0x...');\n\n  console.log('Token Information:');\n  console.log(`  Name: ${details.name}`);\n  console.log(`  Symbol: ${details.symbol}`);\n  console.log(`  Decimals: ${details.decimals}`);\n  console.log(`  Verified: ${details.verified}`);\n  console.log(`  Trading: ${details.tradingEnabled}`);\n  console.log(`  Network: ${details.network}`);\n  console.log(`  Image: ${details.image}`);\n\n  // Pre-trading validation\n  async function validateBeforeTrade(tokenId: string) {\n    const token = await sdk.fetchTokenDetails(tokenId);\n\n    if (!token.verified) {\n      console.warn(`⚠️  ${token.symbol} is NOT verified`);\n    }\n\n    if (!token.tradingEnabled) {\n      throw new Error(`Trading disabled for ${token.symbol}`);\n    }\n\n    if (token.network !== 'ethereum') {\n      throw new Error(`Wrong network: got ${token.network}`);\n    }\n\n    return token;\n  }\n\n  // Batch token comparison\n  const tokens = ['GALA|Unit|none|none', 'GUSDC|Unit|none|eth:0x...'];\n  const details_list = await Promise.all(\n    tokens.map(id => sdk.fetchTokenDetails(id).catch(() => null))\n  );\n\n  const verified = details_list.filter(t => t?.verified).length;\n  console.log(`Verified tokens: ${verified}/${tokens.length}`);\n}\n```\n\n**Response Fields:**\n- `symbol` - Token symbol (e.g., 'GUSDC')\n- `name` - Full token name\n- `decimals` - Decimal places\n- `verified` - Verification status\n- `tradingEnabled` - Trading availability\n- `network` - Network name (e.g., 'ethereum')\n- `contractAddress` - Smart contract address\n- `image` - Token image URL\n- `chainId` - Blockchain chain ID\n\n**Use Cases:**\n- Pre-trading validation and safety checks\n- Display token metadata in UI\n- Verify token authenticity\n- Network compatibility checking\n\n**Token ID Formats:**\n- String: `GUSDC|Unit|none|eth:0x...`\n- Object: `{ collection, category, type, additionalKey }`\n\n**MCP Tool Equivalent:** `gala_launchpad_fetch_token_details`\n"
-        },
-        {
-          "userQuestion": "What parameters does fetchTokenDetails() accept?",
-          "assistantResponse": "The primary methods for Token details are `fetchTokenDetails()`. Each method accepts configuration options as a single object parameter.\n\n**Common Parameters:**\n- `tokenName`: The token identifier (e.g., 'dragnrkti')\n- `amount`: Quantity as a string (for precision)\n- Wallet/auth options when transactions are involved\n\nCheck the SDK documentation or use TypeScript intellisense for the complete parameter interface."
-        },
-        {
-          "userQuestion": "What are best practices for get token details and information?",
-          "assistantResponse": "1. **Use TypeScript**: Get full type safety and intellisense.\n2. **Handle errors**: Always wrap SDK calls in try-catch blocks.\n3. **Validate inputs**: Check parameters before making API calls.\n4. **Cache when appropriate**: Reduce API calls for static data."
-        },
-        {
-          "userQuestion": "What should I learn next after get token details and information?",
-          "assistantResponse": "**Related Topics:**\n\n- **Fetch pools**: `explainSdkUsage({ topic: 'fetch-pools' })`\n- **Token distribution**: `explainSdkUsage({ topic: 'token-distribution' })`\n- **Price history**: `explainSdkUsage({ topic: 'price-history' })`\n\n**Learning Path:** Start with the basics, then explore related topics to build a complete understanding of the SDK capabilities."
-        },
-        {
-          "userQuestion": "Any final tips for get token details and information?",
-          "assistantResponse": "**Quick Tips:**\n\n1. **Start Simple**: Begin with the basic use case before exploring advanced features\n2. **Use TypeScript**: The SDK has full TypeScript support for better autocomplete and type safety\n3. **Check the Demos**: The examples/ directory has working demos for most SDK features\n4. **Read Error Messages**: SDK errors include helpful context for troubleshooting\n\nYou're ready to start building with this feature!"
-        }
-      ]
-    },
-    {
-      "topicKey": "token-distribution",
-      "label": "Token distribution",
-      "category": "pools",
-      "description": "Pool management, pricing, and token availability",
-      "methodCount": 2,
-      "exchanges": [
-        {
-          "userQuestion": "How do I analyze token distribution?",
-          "assistantResponse": "\n## Token Holder Distribution with SDK\n\n**Covers Methods:**\n- `fetchTokenDistribution()`\n- `fetchUserHolderContext()`\n\n```typescript\nimport { createLaunchpadSDK, compareAmounts } from '@gala-chain/launchpad-sdk';\n\nasync function analyzeTokenDistribution() {\n  const sdk = createLaunchpadSDK({\n    wallet: 'your-private-key-or-mnemonic'\n  });\n\n  // Fetch complete token distribution (all holders, non-paginated)\n  const distribution = await sdk.fetchTokenDistribution('anime');\n\n  console.log(`Total holders: ${distribution.totalHolders}`);\n  console.log(`Total supply: ${distribution.totalSupply}`);\n  console.log(`Last updated: ${distribution.lastUpdated.toISOString()}`);\n\n  // Analyze top holders\n  // Use compareAmounts for precise balance sorting with large numbers\n  distribution.holders\n    .sort((a, b) => compareAmounts(b.balance, a.balance) > 0 ? 1 : -1)\n    .slice(0, 5)\n    .forEach((holder, index) => {\n      console.log(`#${index + 1}: ${holder.address}`);\n      console.log(`  Balance: ${holder.balance}`);\n      console.log(`  Ownership: ${toBigNumberFixed(holder.percentage, 2)}%`);\n    });\n\n  // Check concentration risk (e.g., top 5 holders own >80%)\n  const top5Ownership = distribution.holders\n    .sort((a, b) => compareAmounts(b.balance, a.balance) > 0 ? 1 : -1)\n    .slice(0, 5)\n    .reduce((sum, holder) => sum + holder.percentage, 0);\n\n  console.log(`Top 5 holders control: ${toBigNumberFixed(top5Ownership, 2)}%`);\n\n  // Find specific holder\n  const myAddress = sdk.getAddress();\n  const myHolding = distribution.holders.find(h => h.address === myAddress);\n\n  if (myHolding) {\n    console.log(`Your ownership: ${toBigNumberFixed(myHolding.percentage, 4)}%`);\n    console.log(`Your balance: ${myHolding.balance}`);\n  }\n\n  // Calculate concentration metrics\n  const giniCoefficient = calculateGini(distribution.holders);\n  console.log(`Gini coefficient: ${toBigNumberFixed(giniCoefficient, 4)}`);\n\n  // Count whales (holders with >5%)\n  const whales = distribution.holders.filter(h => h.percentage > 5);\n  console.log(`Whales (>5%): ${whales.length}`);\n}\n\n// Helper: Calculate Gini coefficient for wealth distribution\nfunction calculateGini(holders: Array<{balance: string}>) {\n  const balances = holders.map(h => safeParseFloat(h.balance, 0)).sort((a, b) => a - b);\n  const n = balances.length;\n  const sum = balances.reduce((a, b) => a + b, 0);\n\n  let numerator = 0;\n  for (let i = 0; i < n; i++) {\n    numerator += (2 * (i + 1) - n - 1) * balances[i];\n  }\n\n  return numerator / (n * sum);\n}\n```\n\n**Key Characteristics:**\n- **Non-Paginated**: Returns ALL token holders in single response (no pagination)\n- **Complete Distribution**: Full holder list with addresses, balances, and ownership percentages\n- **BigNumber Precision**: Uses BigNumber.js for accurate percentage calculations\n- **Total Supply**: Computed from holder balances (sum of all holdings)\n- **Service Account Included**: Vault/service accounts appear in holder list\n\n**Use Cases:**\n- Analyze token concentration risk\n- Identify whale holders\n- Track ownership changes over time\n- Generate holder reports\n- Calculate distribution metrics (Gini coefficient, etc.)\n\n**MCP Tool Equivalent:** `gala_launchpad_fetch_token_distribution`\n\n---\n\n## User Holder Context (Single User Lookup)\n\n**Covers Methods:**\n- `fetchUserHolderContext()`\n\nUse this when you need holder info for a **specific user** rather than the full holder list.\nPerfect for user cards in comments/chat.\n\n```typescript\nimport { createLaunchpadSDK } from '@gala-chain/launchpad-sdk';\n\nasync function getUserCard() {\n  const sdk = createLaunchpadSDK({ wallet: 'your-private-key' });\n\n  // Fetch single user's holder context for a token\n  const holderContext = await sdk.fetchUserHolderContext('anime', 'eth|abc123...');\n\n  // Response shape:\n  // {\n  //   tokenName: 'anime',\n  //   userAddress: 'abc123...',\n  //   quantity: '25000' | null,      // null if not a holder\n  //   percentage: 2.5 | null,         // null if not a holder\n  //   rank: 3 | null,                 // 1-indexed rank (null if not a holder)\n  //   holderTier: { tier: 3, tierName: 'Major Holder' } | null,\n  //   isCreator: false\n  // }\n\n  if (holderContext.quantity !== null) {\n    console.log(`Rank: #${holderContext.rank}`);\n    console.log(`Holder Tier: ${holderContext.holderTier?.tierName}`);\n    console.log(`Owns: ${holderContext.percentage ? toBigNumberFixed(holderContext.percentage, 4) : 'N/A'}%`);\n  } else {\n    console.log('User is not a holder of this token');\n  }\n\n  if (holderContext.isCreator) {\n    console.log('This user created the token!');\n  }\n}\n```\n\n**Holder Tiers (based on % of max supply):**\n| Tier | Name | Min % |\n|------|------|-------|\n| 5 | Whale | 5% |\n| 4 | Top Holder | 1% |\n| 3 | Major Holder | 0.1% |\n| 2 | Strong Holder | 0.01% |\n| 1 | Holder | 0.001% |\n\n**MCP Tool Equivalent:** `gala_launchpad_fetch_user_holder_context`\n"
-        },
-        {
-          "userQuestion": "What parameters does fetchTokenDistribution() accept?",
-          "assistantResponse": "The primary methods for Token distribution are `fetchTokenDistribution()`, `fetchUserHolderContext()`. Each method accepts configuration options as a single object parameter.\n\n**Common Parameters:**\n- `tokenName`: The token identifier (e.g., 'dragnrkti')\n- `amount`: Quantity as a string (for precision)\n- Wallet/auth options when transactions are involved\n\nCheck the SDK documentation or use TypeScript intellisense for the complete parameter interface."
-        },
-        {
-          "userQuestion": "What are best practices for analyze token distribution?",
-          "assistantResponse": "1. **Use TypeScript**: Get full type safety and intellisense.\n2. **Handle errors**: Always wrap SDK calls in try-catch blocks.\n3. **Validate inputs**: Check parameters before making API calls.\n4. **Cache when appropriate**: Reduce API calls for static data."
-        },
-        {
-          "userQuestion": "What should I learn next after analyze token distribution?",
-          "assistantResponse": "**Related Topics:**\n\n- Check the SDK documentation for related functionality\n\n**Learning Path:** Start with the basics, then explore related topics to build a complete understanding of the SDK capabilities."
-        },
-        {
-          "userQuestion": "Any final tips for analyze token distribution?",
-          "assistantResponse": "**Quick Tips:**\n\n1. **Start Simple**: Begin with the basic use case before exploring advanced features\n2. **Use TypeScript**: The SDK has full TypeScript support for better autocomplete and type safety\n3. **Check the Demos**: The examples/ directory has working demos for most SDK features\n4. **Read Error Messages**: SDK errors include helpful context for troubleshooting\n\nYou're ready to start building with this feature!"
-        }
-      ]
-    },
-    {
-      "topicKey": "referral-system",
-      "label": "Referral system",
-      "category": "referrals",
-      "description": "Referral program and rewards tracking",
-      "methodCount": 4,
-      "exchanges": [
-        {
-          "userQuestion": "How do I manage referral rewards?",
-          "assistantResponse": "\n# Referral System\n\nThe SDK provides methods for managing referral URLs and tracking referral activity.\n\n## Get Your Referral URL\n\n```typescript\nimport { createLaunchpadSDK } from '@gala-chain/launchpad-sdk';\n\nasync function getReferralUrl() {\n  const sdk = createLaunchpadSDK({ wallet: 'your-private-key' });\n\n  // Get your unique referral URL\n  const result = await sdk.fetchReferralUrl();\n  console.log('Share this URL:', result.referralUrl);\n}\n```\n\n## Fetch Referrals (Paginated)\n\n```typescript\nasync function fetchReferrals() {\n  const sdk = createLaunchpadSDK({ wallet: 'your-private-key' });\n\n  // Paginated referral list\n  const referrals = await sdk.fetchReferrals({\n    address: '0x...',  // Optional, defaults to SDK wallet\n    page: 1,\n    limit: 20\n  });\n\n  console.log('Total referrals:', referrals.total);\n  referrals.items.forEach(ref => {\n    console.log(`Referred: ${ref.referredAddress} on ${ref.createdAt}`);\n  });\n}\n```\n\n## Fetch All Referrals (Auto-Paginated)\n\n```typescript\nasync function fetchAllReferrals() {\n  const sdk = createLaunchpadSDK({ wallet: 'your-private-key' });\n\n  // Get ALL referrals with auto-pagination\n  const allReferrals = await sdk.fetchAllReferrals({ address: '0x...' });\n  console.log('Total referrals:', allReferrals.length);\n}\n```\n\n## Referral Summary\n\n```typescript\nasync function getReferralSummary() {\n  const sdk = createLaunchpadSDK({ wallet: 'your-private-key' });\n\n  const summary = await sdk.fetchReferralsSummary({ address: '0x...' });\n  console.log('Total referred users:', summary.totalReferrals);\n  console.log('Total rewards earned:', summary.totalRewards);\n}\n```\n\n**MCP Tool Equivalents:**\n- `gala_launchpad_fetch_referral_url`\n- `gala_launchpad_fetch_referrals`\n- `gala_launchpad_fetch_all_referrals`\n- `gala_launchpad_fetch_referrals_summary`\n"
-        },
-        {
-          "userQuestion": "What parameters does fetchReferralUrl() accept?",
-          "assistantResponse": "The primary methods for Referral system are `fetchReferralUrl()`, `fetchReferrals()`, `fetchAllReferrals()`. Each method accepts configuration options as a single object parameter.\n\n**Common Parameters:**\n- `tokenName`: The token identifier (e.g., 'dragnrkti')\n- `amount`: Quantity as a string (for precision)\n- Wallet/auth options when transactions are involved\n\nCheck the SDK documentation or use TypeScript intellisense for the complete parameter interface."
-        },
-        {
-          "userQuestion": "What are best practices for manage referral rewards?",
-          "assistantResponse": "1. **Use TypeScript**: Get full type safety and intellisense.\n2. **Handle errors**: Always wrap SDK calls in try-catch blocks.\n3. **Validate inputs**: Check parameters before making API calls.\n4. **Cache when appropriate**: Reduce API calls for static data."
-        },
-        {
-          "userQuestion": "Can you walk me through a complete manage referral rewards example?",
-          "assistantResponse": "**Complete Workflow: Referral system**\n\nHere's the typical flow: `fetchReferralUrl()` → `fetchReferrals()` → `fetchAllReferrals()`\n\n**Step-by-Step:**\n1. **Setup**: Initialize SDK with your configuration\n2. **Validate**: Check prerequisites (balances, permissions)\n3. **Calculate**: Use calculation methods to preview results\n4. **Execute**: Perform the main operation\n5. **Verify**: Confirm the operation succeeded\n\n**Pro Tip:** The SDK methods are designed to be called in sequence. Each step provides data needed for the next."
-        },
-        {
-          "userQuestion": "What should I learn next after manage referral rewards?",
-          "assistantResponse": "**Related Topics:**\n\n- **Profile management**: `explainSdkUsage({ topic: 'profile-management' })`\n- **Balances**: `explainSdkUsage({ topic: 'balances' })`\n\n**Learning Path:** Start with the basics, then explore related topics to build a complete understanding of the SDK capabilities."
-        }
-      ]
-    },
-    {
-      "topicKey": "streaming",
-      "label": "Streaming",
-      "category": "streaming",
-      "description": "Live streaming management",
-      "methodCount": 17,
-      "exchanges": [
-        {
-          "userQuestion": "How do I manage live streams?",
-          "assistantResponse": "\n# Live Streaming SDK\n\nThe SDK provides comprehensive live streaming management including stream control,\nrecordings management, and simulcast to external platforms.\n\n## Starting a Stream\n\n```typescript\nimport { createLaunchpadSDK } from '@gala-chain/launchpad-sdk';\n\nasync function manageStream() {\n  const sdk = createLaunchpadSDK({\n    wallet: 'your-private-key',\n    streamWebSocketUrl: 'wss://stream.example.com',  // Required for streaming\n    streamAdminApiKey: 'your-admin-key',  // Optional: for admin operations\n  });\n\n  // Start a stream for your token\n  const stream = await sdk.startStream('mytoken');\n  console.log('Stream Key:', stream.streamKey);\n  console.log('RTMP URL:', stream.rtmpUrl);\n  console.log('Playback URL:', stream.playbackUrl);\n  // Use stream.streamKey in OBS or other RTMP software\n\n  // Get stream info (public endpoint)\n  const info = await sdk.getStreamInfo('mytoken');\n  console.log('Status:', info.status);  // IDLE, ACTIVE, DISABLED\n  console.log('Is Live:', info.isLive);\n  console.log('Viewers:', info.viewerCount);\n\n  // Stop the stream when done\n  await sdk.stopStream('mytoken');\n  console.log('Stream stopped');\n\n  // Reset stream key if compromised\n  const newKey = await sdk.resetStreamKey('mytoken');\n  console.log('New Stream Key:', newKey.streamKey);\n}\n```\n\n## Recordings Management\n\n```typescript\nasync function manageRecordings() {\n  const sdk = createLaunchpadSDK({ wallet: 'your-private-key' });\n\n  // List recordings (paginated)\n  const recordings = await sdk.getStreamRecordings({\n    tokenName: 'mytoken',\n    page: 1,\n    limit: 20,\n  });\n  console.log('Total recordings:', recordings.total);\n\n  for (const rec of recordings.recordings) {\n    console.log('Asset ID:', rec.assetId);\n    console.log('Duration:', rec.duration, 'seconds');\n    console.log('Status:', rec.status);  // READY, PROCESSING, ERRORED\n  }\n\n  // Get download URL for a recording\n  const download = await sdk.getRecordingDownload('mytoken', 'asset-123');\n  console.log('Download URL:', download.downloadUrl);\n  console.log('Expires:', download.expiresAt);\n\n  // Delete a recording\n  await sdk.deleteRecording('mytoken', 'asset-123');\n}\n```\n\n## Simulcast Management\n\nRebroadcast your stream to external platforms (YouTube, Twitch, Facebook).\n\n```typescript\nasync function manageSimulcast() {\n  const sdk = createLaunchpadSDK({ wallet: 'your-private-key' });\n\n  // Get existing simulcast targets\n  const targets = await sdk.getSimulcastTargets('mytoken');\n  console.log('Max targets:', targets.maxTargets);\n  console.log('Current targets:', targets.targets.length);\n\n  // Add YouTube simulcast\n  const youtube = await sdk.addSimulcastTarget({\n    tokenName: 'mytoken',\n    platform: 'YOUTUBE',\n    rtmpUrl: 'rtmp://a.rtmp.youtube.com/live2',\n    streamKey: 'your-youtube-stream-key',\n    name: 'My YouTube Channel',\n  });\n  console.log('Added target:', youtube.target.targetId);\n\n  // Add Twitch simulcast\n  await sdk.addSimulcastTarget({\n    tokenName: 'mytoken',\n    platform: 'TWITCH',\n    rtmpUrl: 'rtmp://live.twitch.tv/app',\n    streamKey: 'live_123456_abcdef',\n    name: 'Twitch Stream',\n  });\n\n  // Remove a simulcast target\n  await sdk.removeSimulcastTarget('mytoken', youtube.target.targetId);\n}\n```\n\n## Admin Operations\n\nEnable/disable streaming globally or per-token (requires admin API key).\n\n```typescript\nasync function adminOperations() {\n  const sdk = createLaunchpadSDK({\n    wallet: 'your-private-key',\n    streamAdminApiKey: 'your-admin-key',\n  });\n\n  // Disable streaming for a specific token (admin-only)\n  await sdk.disableStream('mytoken');\n\n  // Re-enable streaming for a token (admin-only)\n  await sdk.enableStream('mytoken');\n\n  // Get global streaming status\n  const globalStatus = await sdk.getGlobalStreamingStatus();\n  console.log('Global streaming enabled:', globalStatus.enabled);\n\n  // Enable/disable streaming globally (maintenance mode)\n  await sdk.setGlobalStreamingEnabled(false);  // Disable all streams\n  await sdk.setGlobalStreamingEnabled(true);   // Re-enable\n}\n```\n\n**Available SDK Methods:**\n| Method | Description | Auth |\n|--------|-------------|------|\n| `startStream(tokenName)` | Start a stream | Wallet |\n| `stopStream(tokenName)` | Stop a stream | Wallet |\n| `getStreamInfo(tokenName)` | Get stream status | Public |\n| `resetStreamKey(tokenName)` | Generate new stream key | Wallet |\n| `disableStream(tokenName)` | Disable token streaming | Admin |\n| `enableStream(tokenName)` | Enable token streaming | Admin |\n| `getStreamRecordings(options)` | List recordings | Public |\n| `getRecordingDownload(tokenName, assetId)` | Get download URL | Wallet |\n| `deleteRecording(tokenName, assetId)` | Delete recording | Wallet |\n| `getSimulcastTargets(tokenName)` | List simulcast targets | Public |\n| `addSimulcastTarget(options)` | Add simulcast target | Wallet |\n| `removeSimulcastTarget(tokenName, targetId)` | Remove target | Wallet |\n| `getGlobalStreamingStatus()` | Get global status | Public |\n| `setGlobalStreamingEnabled(enabled)` | Enable/disable globally | Admin |\n| `getAvailableRoles()` | Get list of available streaming roles | Public |\n| `getStreamRole(options)` | Get user's role for a token | JWT |\n| `getTokenAccess(options)` | Check user's access to a token stream | JWT (optional) |\n\n**MCP Tool Equivalents:**\n- `gala_launchpad_start_stream`\n- `gala_launchpad_stop_stream`\n- `gala_launchpad_get_stream_info`\n- `gala_launchpad_reset_stream_key`\n- `gala_launchpad_disable_stream`\n- `gala_launchpad_enable_stream`\n- `gala_launchpad_get_stream_recordings`\n- `gala_launchpad_get_recording_download`\n- `gala_launchpad_delete_recording`\n- `gala_launchpad_get_simulcast_targets`\n- `gala_launchpad_add_simulcast_target`\n- `gala_launchpad_remove_simulcast_target`\n- `gala_launchpad_get_global_streaming_status`\n- `gala_launchpad_set_global_streaming_enabled`\n- `gala_launchpad_get_available_roles`\n- `gala_launchpad_get_stream_role`\n- `gala_launchpad_get_token_access`\n"
-        },
-        {
-          "userQuestion": "What parameters does startStream() accept?",
-          "assistantResponse": "The primary methods for Streaming are `startStream()`, `stopStream()`, `getStreamInfo()`. Each method accepts configuration options as a single object parameter.\n\n**Common Parameters:**\n- `tokenName`: The token identifier (e.g., 'dragnrkti')\n- `amount`: Quantity as a string (for precision)\n- Wallet/auth options when transactions are involved\n\nCheck the SDK documentation or use TypeScript intellisense for the complete parameter interface."
-        },
-        {
-          "userQuestion": "What are best practices for manage live streams?",
-          "assistantResponse": "1. **Check stream status first**: Use `getStreamInfo()` before starting.\n2. **Handle WebSocket reconnection**: Implement reconnection logic for dropped connections.\n3. **Moderate in real-time**: Use chat moderation tools to maintain community standards."
-        },
-        {
-          "userQuestion": "What errors should I handle when manage live streams?",
-          "assistantResponse": "**Common Errors:**\n- `StreamAlreadyActive`: Stream already running\n- `UnauthorizedAccess`: Need proper role permissions\n- `WebSocketDisconnected`: Handle reconnection gracefully\n\n**Tip:** Check stream status before starting operations."
-        },
-        {
-          "userQuestion": "Can you walk me through a complete manage live streams example?",
-          "assistantResponse": "**Complete Workflow: Streaming**\n\nHere's the typical flow: `startStream()` → `stopStream()` → `getStreamInfo()`\n\n**Step-by-Step:**\n1. **Setup**: Initialize SDK with your configuration\n2. **Validate**: Check prerequisites (balances, permissions)\n3. **Calculate**: Use calculation methods to preview results\n4. **Execute**: Perform the main operation\n5. **Verify**: Confirm the operation succeeded\n\n**Pro Tip:** The SDK methods are designed to be called in sequence. Each step provides data needed for the next."
-        },
-        {
-          "userQuestion": "What edge cases should I know about for manage live streams?",
-          "assistantResponse": "**Edge Cases:**\n1. **Concurrent streams**: Only one active stream per token\n2. **Recording availability**: Recordings take time to process\n3. **Simulcast limits**: Check target platform requirements\n\n**Gotcha:** Stream key changes invalidate existing OBS/streaming software configs."
-        },
-        {
-          "userQuestion": "What other methods are available for Streaming?",
-          "assistantResponse": "**Additional Methods:**\n\n- `disableStream()`\n- `enableStream()`\n- `resetStreamKey()`\n- `getStreamRecordings()`\n\n**Total methods in this topic:** 17\n\nEach method serves a specific purpose in the workflow. Use TypeScript intellisense or the SDK documentation to explore parameter options for each method."
-        },
-        {
-          "userQuestion": "When would I actually use manage live streams in a real application?",
-          "assistantResponse": "**Real-World Use Cases:**\n\n1. **Token Launches**: Live-stream new token announcements\n2. **AMAs**: Host ask-me-anything sessions with community\n3. **Trading Commentary**: Stream market analysis and trades\n4. **Educational Content**: Teach about your project/token"
-        },
-        {
-          "userQuestion": "What should I learn next after manage live streams?",
-          "assistantResponse": "**Related Topics:**\n\n- **Stream chat**: `explainSdkUsage({ topic: 'stream-chat' })`\n- **Ban management**: `explainSdkUsage({ topic: 'ban-management' })`\n- **Moderator invites**: `explainSdkUsage({ topic: 'moderator-invites' })`\n\n**Learning Path:** Start with the basics, then explore related topics to build a complete understanding of the SDK capabilities."
-        },
-        {
-          "userQuestion": "Are there any advanced patterns for this topic?",
-          "assistantResponse": "**Advanced Patterns:**\n\n1. **Batching**: Combine multiple operations for efficiency\n2. **Caching**: Cache frequently-accessed data locally\n3. **Event-Driven**: Use subscriptions for real-time updates\n4. **Error Recovery**: Implement retry logic with exponential backoff\n5. **Monitoring**: Track operation success rates and latencies\n\n**Performance Tip:** For high-volume operations, consider using the local calculation methods where available to reduce network calls."
-        }
-      ]
-    },
-    {
-      "topicKey": "token-ban-management",
-      "label": "Token ban management",
-      "category": "token-ban",
-      "description": "Platform-wide token bans",
-      "methodCount": 5,
-      "exchanges": [
-        {
-          "userQuestion": "How do I manage token bans?",
-          "assistantResponse": "\n# Token Ban Management - SDK v6.x.0+\n\nPlatform-wide token ban operations for overseers. Banned tokens are hidden from ALL listings\nand have actions (comments, streaming, chat) blocked. This is different from user bans which\nonly affect specific users on specific tokens.\n\n**Access Control:** All methods require either:\n- streamAdminApiKey (server-to-server)\n- JWT with overseer status (authenticated overseer user)\n\n**Effects of Token Bans:**\n- Hidden from ALL pool listings (including creator's profile)\n- Comments blocked on banned tokens\n- Live streaming blocked on banned tokens\n- Chat messages blocked on banned tokens\n- Trading NOT blocked (GalaChain handles trading independently)\n\n## Banning a Token\n\n```typescript\nimport { createLaunchpadSDK } from '@gala-chain/launchpad-sdk';\n\n// Using Admin API key\nconst sdk = createLaunchpadSDK({\n  streamAdminApiKey: process.env.STREAM_ADMIN_API_KEY,\n});\n\n// Or using JWT auth (must be an overseer)\nconst sdkWithAuth = createLaunchpadSDK({\n  privateKey: process.env.PRIVATE_KEY,\n});\nawait sdkWithAuth.login({ walletAddress: 'eth|0x...' });\n\n// Ban a token with reason\nconst result = await sdk.banToken({\n  tokenName: 'scamtoken',\n  reason: 'Fraudulent project - reported by multiple users',\n});\nconsole.log('Token banned:', result.tokenName);\nconsole.log('Ban ID:', result.ban.id);\nconsole.log('Banned by:', result.ban.bannedBy);\n\n// Ban without reason (optional)\nawait sdk.banToken({ tokenName: 'problematictoken' });\n```\n\n## Unbanning a Token\n\n```typescript\n// Remove a token ban\nconst result = await sdk.unbanToken({ tokenName: 'scamtoken' });\nconsole.log('Ban removed:', result.removed); // true\nconsole.log('Token:', result.tokenName);\n\n// Token is now:\n// - Visible in pool listings again\n// - Comments re-enabled\n// - Live streaming re-enabled\n// - Chat re-enabled\n```\n\n## Checking Token Ban Status\n\n```typescript\n// Check if a specific token is banned\nconst status = await sdk.isTokenBanned({ tokenName: 'sometoken' });\n\nif (status.banned) {\n  console.log('Token is banned!');\n  console.log('Reason:', status.ban?.reason);\n  console.log('Banned by:', status.ban?.bannedBy);\n  console.log('Banned at:', status.ban?.createdAt);\n} else {\n  console.log('Token is not banned');\n}\n\n// getTokenBan is an alias - use whichever is more readable\nconst details = await sdk.getTokenBan({ tokenName: 'sometoken' });\n```\n\n## Listing All Banned Tokens\n\n```typescript\n// Get first page with default limit (20)\nconst page1 = await sdk.listTokenBans({});\nconsole.log('Total banned tokens:', page1.meta.total);\n\nfor (const ban of page1.items) {\n  console.log(`- ${ban.tokenName}: ${ban.reason || 'No reason'}`);\n  console.log(`  Banned by: ${ban.bannedBy}`);\n  console.log(`  Date: ${ban.createdAt}`);\n}\n\n// Search for specific tokens (partial match, case-insensitive)\nconst searchResults = await sdk.listTokenBans({\n  search: 'scam',\n  page: 1,\n  limit: 10,\n});\n\n// Paginate through all banned tokens\nlet page = 1;\nlet hasMore = true;\nwhile (hasMore) {\n  const results = await sdk.listTokenBans({ page, limit: 20 });\n  console.log(`Page ${page}: ${results.items.length} bans`);\n  for (const ban of results.items) {\n    console.log(`  - ${ban.tokenName}`);\n  }\n  hasMore = page < results.meta.totalPages;\n  page++;\n}\n```\n\n## Important Notes\n\n1. **Permanent Bans Only**: Token bans do not expire. They remain in effect until\n   explicitly removed by an overseer.\n\n2. **Case Normalization**: Token names are automatically normalized to lowercase\n   in all requests and responses.\n\n3. **Idempotency**: Banning an already-banned token returns a 409 Conflict error.\n   Unbanning a non-banned token returns a 404 Not Found error.\n\n4. **Trading Continues**: Token bans do NOT stop trading on GalaChain. The\n   launchpad hides visibility and blocks social features only.\n\n**MCP Tool Equivalents:**\n- `gala_launchpad_ban_token`\n- `gala_launchpad_unban_token`\n- `gala_launchpad_list_token_bans`\n- `gala_launchpad_get_token_ban`\n- `gala_launchpad_is_token_banned`\n"
-        },
-        {
-          "userQuestion": "What parameters does banToken() accept?",
-          "assistantResponse": "The primary methods for Token ban management are `banToken()`, `unbanToken()`, `listTokenBans()`. Each method accepts configuration options as a single object parameter.\n\n**Common Parameters:**\n- `tokenName`: The token identifier (e.g., 'dragnrkti')\n- `amount`: Quantity as a string (for precision)\n- Wallet/auth options when transactions are involved\n\nCheck the SDK documentation or use TypeScript intellisense for the complete parameter interface."
-        },
-        {
-          "userQuestion": "What are best practices for manage token bans?",
-          "assistantResponse": "1. **Use TypeScript**: Get full type safety and intellisense.\n2. **Handle errors**: Always wrap SDK calls in try-catch blocks.\n3. **Validate inputs**: Check parameters before making API calls.\n4. **Cache when appropriate**: Reduce API calls for static data."
-        },
-        {
-          "userQuestion": "Can you walk me through a complete manage token bans example?",
-          "assistantResponse": "**Complete Workflow: Token ban management**\n\nHere's the typical flow: `banToken()` → `unbanToken()` → `listTokenBans()`\n\n**Step-by-Step:**\n1. **Setup**: Initialize SDK with your configuration\n2. **Validate**: Check prerequisites (balances, permissions)\n3. **Calculate**: Use calculation methods to preview results\n4. **Execute**: Perform the main operation\n5. **Verify**: Confirm the operation succeeded\n\n**Pro Tip:** The SDK methods are designed to be called in sequence. Each step provides data needed for the next."
-        },
-        {
-          "userQuestion": "What other methods are available for Token ban management?",
-          "assistantResponse": "**Additional Methods:**\n\n- `getTokenBan()`\n- `isTokenBanned()`\n\n**Total methods in this topic:** 5\n\nEach method serves a specific purpose in the workflow. Use TypeScript intellisense or the SDK documentation to explore parameter options for each method."
-        },
-        {
-          "userQuestion": "What should I learn next after manage token bans?",
-          "assistantResponse": "**Related Topics:**\n\n- **Overseer invites**: `explainSdkUsage({ topic: 'overseer-invites' })`\n- **Content flag management**: `explainSdkUsage({ topic: 'content-flag-management' })`\n\n**Learning Path:** Start with the basics, then explore related topics to build a complete understanding of the SDK capabilities."
-        }
-      ]
-    },
-    {
-      "topicKey": "trade-history",
-      "label": "Trade history",
-      "category": "trades",
-      "description": "View and analyze trading history",
-      "methodCount": 1,
-      "exchanges": [
-        {
-          "userQuestion": "How do I view trading history?",
-          "assistantResponse": "\n## Trade History\n\nQuery and analyze trading activity for tokens.\n\n### Basic Usage\n\n```typescript\nimport { LaunchpadSDK } from '@gala-chain/launchpad-sdk';\n\nconst sdk = new LaunchpadSDK({ environment: 'production' });\n\n// Get recent trades for a token\nconst result = await sdk.getTrades({\n  tokenName: 'anime',\n  limit: 10,\n  page: 1\n});\n\nconsole.log(`Found ${result.trades.length} trades`);\nfor (const trade of result.trades) {\n  console.log(`${trade.txnType}: ${trade.inputAmount} → ${trade.outputAmount}`);\n}\n```\n\n### Filter by Trade Type\n\n```typescript\n// Get only buy orders\nconst buyTrades = await sdk.getTrades({\n  tokenName: 'anime',\n  txnType: 'BUY',\n  limit: 50\n});\n\n// Get only sell orders\nconst sellTrades = await sdk.getTrades({\n  tokenName: 'anime',\n  txnType: 'SELL',\n  limit: 50\n});\n```\n\n### Date Range Queries\n\n```typescript\nconst oneWeekAgo = new Date(Date.now() - 7 * 24 * 60 * 60 * 1000);\nconst now = new Date();\n\nconst recentTrades = await sdk.getTrades({\n  tokenName: 'anime',\n  startDate: oneWeekAgo,\n  endDate: now,\n  limit: 50\n});\n```\n\n### Filter by User\n\n```typescript\n// Get trades for a specific wallet\nconst userTrades = await sdk.getTrades({\n  tokenName: 'anime',\n  userAddress: 'eth|0x1234...',\n  limit: 20\n});\n```\n\n### Pagination\n\n```typescript\n// Paginate through all trades\nlet page = 1;\nlet hasMore = true;\n\nwhile (hasMore) {\n  const result = await sdk.getTrades({ tokenName: 'anime', page, limit: 50 });\n  console.log(`Page ${page}: ${result.trades.length} trades`);\n\n  hasMore = result.trades.length === 50;\n  page++;\n}\n```\n\n**MCP Tool Equivalents:**\n- `gala_launchpad_get_trades`\n"
-        },
-        {
-          "userQuestion": "What parameters does getTrades() accept?",
-          "assistantResponse": "The primary methods for Trade history are `getTrades()`. Each method accepts configuration options as a single object parameter.\n\n**Common Parameters:**\n- `tokenName`: The token identifier (e.g., 'dragnrkti')\n- `amount`: Quantity as a string (for precision)\n- Wallet/auth options when transactions are involved\n\nCheck the SDK documentation or use TypeScript intellisense for the complete parameter interface."
-        },
-        {
-          "userQuestion": "What are best practices for view trading history?",
-          "assistantResponse": "1. **Use TypeScript**: Get full type safety and intellisense.\n2. **Handle errors**: Always wrap SDK calls in try-catch blocks.\n3. **Validate inputs**: Check parameters before making API calls.\n4. **Cache when appropriate**: Reduce API calls for static data."
-        },
-        {
-          "userQuestion": "What should I learn next after view trading history?",
-          "assistantResponse": "**Related Topics:**\n\n- **Trading analytics**: `explainSdkUsage({ topic: 'trading-analytics' })`\n- **Dex trading**: `explainSdkUsage({ topic: 'dex-trading' })`\n- **Buy tokens**: `explainSdkUsage({ topic: 'buy-tokens' })`\n\n**Learning Path:** Start with the basics, then explore related topics to build a complete understanding of the SDK capabilities."
-        },
-        {
-          "userQuestion": "Any final tips for view trading history?",
-          "assistantResponse": "**Quick Tips:**\n\n1. **Start Simple**: Begin with the basic use case before exploring advanced features\n2. **Use TypeScript**: The SDK has full TypeScript support for better autocomplete and type safety\n3. **Check the Demos**: The examples/ directory has working demos for most SDK features\n4. **Read Error Messages**: SDK errors include helpful context for troubleshooting\n\nYou're ready to start building with this feature!"
-        }
-      ]
-    },
-    {
-      "topicKey": "buy-tokens",
-      "label": "Buy tokens",
-      "category": "trading",
-      "description": "Buy, sell, and calculate token amounts",
-      "methodCount": 2,
-      "exchanges": [
-        {
-          "userQuestion": "How do I buy tokens?",
-          "assistantResponse": "\n## Buying Tokens with SDK\n\n**Covers Methods:**\n- `calculateBuyAmount()`\n- `buy()`\n\n```typescript\nimport { createLaunchpadSDK } from '@gala-chain/launchpad-sdk';\n\nasync function buyTokens() {\n  // 1. Create SDK instance\n  const sdk = createLaunchpadSDK({\n    wallet: 'your-private-key-or-mnemonic'\n  });\n\n  // 2. Calculate expected amounts FIRST (REQUIRED)\n  const calculation = await sdk.calculateBuyAmount({\n    tokenName: 'dragnrkti',\n    amount: '100',      // Spending 100 GALA\n    type: 'native'      // 'native' = GALA amount, 'exact' = token amount\n  });\n\n  console.log('Expected tokens:', calculation.amount);\n  console.log('RBC Fee:', calculation.reverseBondingCurveFee);\n  console.log('Transaction fee:', calculation.transactionFee);\n\n  // 3. Execute buy with slippage protection\n  const result = await sdk.buy({\n    tokenName: 'dragnrkti',\n    amount: '100',\n    type: 'native',\n    expectedAmount: calculation.amount,  // REQUIRED: from step 2\n    maxAcceptableReverseBondingCurveFee: calculation.reverseBondingCurveFee, // RECOMMENDED\n    slippageToleranceFactor: 0.01  // 1% slippage tolerance (REQUIRED)\n  });\n\n  console.log('Transaction ID:', result.transactionId);\n  console.log('GALA spent:', result.inputAmount);\n  console.log('Tokens received:', result.outputAmount);\n  console.log('Total fees:', result.totalFees);\n}\n```\n\n**MCP Tool Equivalent:** `gala_launchpad_buy_tokens`\n"
-        },
-        {
-          "userQuestion": "What parameters does calculateBuyAmount() accept?",
-          "assistantResponse": "The primary methods for Buy tokens are `calculateBuyAmount()`, `buy()`. Each method accepts configuration options as a single object parameter.\n\n**Common Parameters:**\n- `tokenName`: The token identifier (e.g., 'dragnrkti')\n- `amount`: Quantity as a string (for precision)\n- Wallet/auth options when transactions are involved\n\nCheck the SDK documentation or use TypeScript intellisense for the complete parameter interface."
-        },
-        {
-          "userQuestion": "What are best practices for buy tokens?",
-          "assistantResponse": "1. **Always calculate first**: Call `calculateBuyAmount()` before `buy()` to get expected amounts and fees.\n2. **Set slippage tolerance**: Use `slippageToleranceFactor` (e.g., 0.01 for 1%) to protect against price movements.\n3. **Handle errors gracefully**: Wrap in try-catch and provide user-friendly error messages."
-        },
-        {
-          "userQuestion": "What errors should I handle when buy tokens?",
-          "assistantResponse": "**Common Errors:**\n- `InsufficientBalance`: Not enough GALA - check balance first with `fetchGalaBalance()`\n- `SlippageExceeded`: Price moved - increase slippage tolerance or retry\n- `PoolNotFound`: Token not on bonding curve - check with `fetchPoolDetails()`\n\n**Error Handling Pattern:**\n```typescript\ntry {\n  const result = await sdk.buy({ tokenName, amount, type: 'native', ... });\n} catch (error) {\n  if (error.message.includes('insufficient')) {\n    // Handle balance issue\n  } else if (error.message.includes('slippage')) {\n    // Retry with higher tolerance\n  }\n}\n```"
-        },
-        {
-          "userQuestion": "What edge cases should I know about for buy tokens?",
-          "assistantResponse": "**Edge Cases to Watch:**\n1. **Graduated tokens**: Bonding curve methods don't work for graduated tokens - use DEX trading instead\n2. **Minimum amounts**: Very small purchases may fail due to fee minimums\n3. **RBC fees**: Reverse bonding curve fees vary based on pool state\n\n**Gotcha:** `calculateBuyAmount` returns the fee breakdown - always pass `reverseBondingCurveFee` to the `buy()` call!"
-        },
-        {
-          "userQuestion": "When would I actually use buy tokens in a real application?",
-          "assistantResponse": "**Real-World Use Cases:**\n\n1. **Trading Bot**: Automate token purchases based on price signals\n2. **DCA Strategy**: Schedule regular purchases at intervals\n3. **Portfolio Rebalancing**: Buy tokens to maintain target allocations\n4. **Arbitrage**: Buy when price is favorable vs other markets"
-        },
-        {
-          "userQuestion": "What should I learn next after buy tokens?",
-          "assistantResponse": "**Related Topics:**\n\n- **Sell tokens**: `explainSdkUsage({ topic: 'sell-tokens' })`\n- **Pool graduation**: `explainSdkUsage({ topic: 'pool-graduation' })`\n- **Balances**: `explainSdkUsage({ topic: 'balances' })`\n- **Dex trading**: `explainSdkUsage({ topic: 'dex-trading' })`\n\n**Learning Path:** Start with the basics, then explore related topics to build a complete understanding of the SDK capabilities."
-        }
-      ]
-    },
-    {
-      "topicKey": "local-calculations",
-      "label": "Local calculations",
-      "category": "trading",
-      "description": "Buy, sell, and calculate token amounts",
-      "methodCount": 5,
-      "exchanges": [
-        {
-          "userQuestion": "How do I perform local calculations?",
-          "assistantResponse": "\n## Local Bonding Curve Calculations with SDK\n\n**Covers Methods:**\n- `calculateBuyAmountLocal()`\n- `calculateSellAmountLocal()`\n- `calculateBuyAmountExternal()`\n- `calculateSellAmountExternal()`\n\n```typescript\nimport { createLaunchpadSDK, compareAmounts } from '@gala-chain/launchpad-sdk';\n\nasync function localCalculationsExample() {\n  const sdk = createLaunchpadSDK({\n    wallet: 'your-private-key'\n  });\n\n  // ============================================================================\n  // LOCAL CALCULATIONS - Instant quotes without network calls\n  // ============================================================================\n\n  // 1. Buy calculation (local, instant)\n  const localBuy = await sdk.calculateBuyAmountLocal({\n    tokenName: 'dragnrkti',\n    amount: '100',      // Spending 100 GALA\n    type: 'native'      // 'native' = GALA amount, 'exact' = token amount\n  });\n\n  console.log('LOCAL Buy Quote (instant):');\n  console.log('  Tokens received:', localBuy.amount);\n  console.log('  Transaction fee:', localBuy.transactionFee);\n  console.log('  RBC Fee:', localBuy.reverseBondingCurveFee); // Always \"0\" for buys\n  console.log('  Gas fee:', localBuy.gasFee);\n\n  // 2. Sell calculation (local, requires pool details)\n  const poolDetails = await sdk.fetchPoolDetails('dragnrkti');\n\n  const localSell = await sdk.calculateSellAmountLocal({\n    tokenName: 'dragnrkti',\n    amount: '1000',     // Selling 1000 tokens\n    type: 'exact',\n    // Required parameters from pool details:\n    maxSupply: poolDetails.maxSupply.toString(),\n    minFeePortion: poolDetails.reverseBondingCurveMinFeeFactor || 0,\n    maxFeePortion: poolDetails.reverseBondingCurveMaxFeeFactor || 0\n  });\n\n  console.log('LOCAL Sell Quote (instant):');\n  console.log('  GALA received:', localSell.amount);\n  console.log('  RBC Fee:', localSell.reverseBondingCurveFee);\n  console.log('  Transaction fee:', localSell.transactionFee);\n\n  // ============================================================================\n  // EXTERNAL CALCULATIONS - Real-time network queries (explicit)\n  // ============================================================================\n\n  // 3. External buy (explicit network call)\n  const externalBuy = await sdk.calculateBuyAmountExternal({\n    tokenName: 'dragnrkti',\n    amount: '100',\n    type: 'native'\n  });\n\n  console.log('EXTERNAL Buy Quote (network):');\n  console.log('  Tokens received:', externalBuy.amount);\n\n  // 4. External sell (explicit network call)\n  const externalSell = await sdk.calculateSellAmountExternal({\n    tokenName: 'dragnrkti',\n    amount: '1000',\n    type: 'exact'\n  });\n\n  console.log('EXTERNAL Sell Quote (network):');\n  console.log('  GALA received:', externalSell.amount);\n\n  // ============================================================================\n  // A/B COMPARISON - Verify local accuracy\n  // ============================================================================\n\n  // Use compareAmounts for precise quote comparison\n  const buyComparison = compareAmounts(localBuy.amount, externalBuy.amount);\n  const buyDiff = Math.abs(safeParseNumber(localBuy.amount, 0) - safeParseNumber(externalBuy.amount, 0));\n  const buyPct = (buyDiff / safeParseNumber(externalBuy.amount, 1)) * 100;\n\n  console.log('Local vs External Accuracy:');\n  console.log(`  Buy difference: ${toBigNumberFixed(buyPct, 4)}% (should be <0.01%)`);\n\n  // ============================================================================\n  // PERFORMANCE BENEFIT - Local is instant\n  // ============================================================================\n\n  console.time('Local calculation');\n  await sdk.calculateBuyAmountLocal({ tokenName: 'dragnrkti', amount: '100', type: 'native' });\n  console.timeEnd('Local calculation');  // ~0ms (instant)\n\n  console.time('External calculation');\n  await sdk.calculateBuyAmountExternal({ tokenName: 'dragnrkti', amount: '100', type: 'native' });\n  console.timeEnd('External calculation');  // ~200-500ms (network roundtrip)\n}\n```\n\n**Benefits of Local Calculations:**\n- ✅ Instant quotes (no network delay)\n- ✅ Offline support (no internet required)\n- ✅ No API rate limits\n- ✅ Perfect accuracy (<0.01% difference)\n- ✅ Reduced server load\n\n**When to Use:**\n- Local: Price discovery, UI updates, offline scenarios\n- External: Production trades (always verify before executing)\n\n**MCP Tool Equivalents:**\n- `gala_launchpad_calculate_buy_amount_local`\n- `gala_launchpad_calculate_buy_amount_external`\n- `gala_launchpad_calculate_sell_amount_local`\n- `gala_launchpad_calculate_sell_amount_external`\n"
-        },
-        {
-          "userQuestion": "What parameters does calculateBuyAmountLocal() accept?",
-          "assistantResponse": "The primary methods for Local calculations are `calculateBuyAmountLocal()`, `calculateSellAmountLocal()`, `calculateBuyAmountExternal()`. Each method accepts configuration options as a single object parameter.\n\n**Common Parameters:**\n- `tokenName`: The token identifier (e.g., 'dragnrkti')\n- `amount`: Quantity as a string (for precision)\n- Wallet/auth options when transactions are involved\n\nCheck the SDK documentation or use TypeScript intellisense for the complete parameter interface."
-        },
-        {
-          "userQuestion": "What are best practices for perform local calculations?",
-          "assistantResponse": "1. **Use TypeScript**: Get full type safety and intellisense.\n2. **Handle errors**: Always wrap SDK calls in try-catch blocks.\n3. **Validate inputs**: Check parameters before making API calls.\n4. **Cache when appropriate**: Reduce API calls for static data."
-        },
-        {
-          "userQuestion": "Can you walk me through a complete perform local calculations example?",
-          "assistantResponse": "**Complete Workflow: Local calculations**\n\nHere's the typical flow: `calculateBuyAmountLocal()` → `calculateSellAmountLocal()` → `calculateBuyAmountExternal()`\n\n**Step-by-Step:**\n1. **Setup**: Initialize SDK with your configuration\n2. **Validate**: Check prerequisites (balances, permissions)\n3. **Calculate**: Use calculation methods to preview results\n4. **Execute**: Perform the main operation\n5. **Verify**: Confirm the operation succeeded\n\n**Pro Tip:** The SDK methods are designed to be called in sequence. Each step provides data needed for the next."
-        },
-        {
-          "userQuestion": "What other methods are available for Local calculations?",
-          "assistantResponse": "**Additional Methods:**\n\n- `calculateSellAmountExternal()`\n- `calculateInitialBuyAmount()`\n\n**Total methods in this topic:** 5\n\nEach method serves a specific purpose in the workflow. Use TypeScript intellisense or the SDK documentation to explore parameter options for each method."
-        },
-        {
-          "userQuestion": "What should I learn next after perform local calculations?",
-          "assistantResponse": "**Related Topics:**\n\n- **Buy tokens**: `explainSdkUsage({ topic: 'buy-tokens' })`\n- **Sell tokens**: `explainSdkUsage({ topic: 'sell-tokens' })`\n- **Dex trading**: `explainSdkUsage({ topic: 'dex-trading' })`\n\n**Learning Path:** Start with the basics, then explore related topics to build a complete understanding of the SDK capabilities."
-        }
-      ]
-    },
-    {
-      "topicKey": "pool-graduation",
-      "label": "Pool graduation",
-      "category": "trading",
-      "description": "Buy, sell, and calculate token amounts",
-      "methodCount": 2,
-      "exchanges": [
-        {
-          "userQuestion": "How do I graduate token pools?",
-          "assistantResponse": "\n## Pool Graduation with SDK\n\n**Covers Methods:**\n- `calculateBuyAmountForGraduation()`\n- `graduateToken()`\n\n```typescript\nimport { createLaunchpadSDK, compareAmounts } from '@gala-chain/launchpad-sdk';\n\nasync function graduatePool() {\n  const sdk = createLaunchpadSDK({\n    wallet: 'your-private-key'\n  });\n\n  // Option 1: Calculate graduation cost first (recommended)\n  const calculation = await sdk.calculateBuyAmountForGraduation('dragnrkti');\n\n  console.log('GALA cost to graduate:', calculation.amount);\n  console.log('RBC Fee:', calculation.reverseBondingCurveFee);\n  console.log('Transaction fee:', calculation.transactionFee);\n\n  // Check if you have enough balance\n  const balance = await sdk.fetchGalaBalance();\n  // Use compareAmounts() instead of parseFloat for precision with currency amounts\n  if (compareAmounts(balance.balance, calculation.amount) < 0) {\n    throw new Error('Insufficient GALA balance');\n  }\n\n  // Option 2: One-step graduation (convenience method)\n  const result = await sdk.graduateToken({\n    tokenName: 'dragnrkti',\n    slippageToleranceFactor: 0.01  // Optional: defaults to SDK config\n  });\n\n  console.log('Pool graduated!');\n  console.log('Transaction ID:', result.transactionId);\n  console.log('Total GALA spent:', result.inputAmount);\n  console.log('Tokens received:', result.outputAmount);\n}\n```\n\n**MCP Tool Equivalents:**\n- `gala_launchpad_calculate_buy_amount_for_graduation`\n- `gala_launchpad_graduate_token`\n"
-        },
-        {
-          "userQuestion": "What parameters does calculateBuyAmountForGraduation() accept?",
-          "assistantResponse": "The primary methods for Pool graduation are `calculateBuyAmountForGraduation()`, `graduateToken()`. Each method accepts configuration options as a single object parameter.\n\n**Common Parameters:**\n- `tokenName`: The token identifier (e.g., 'dragnrkti')\n- `amount`: Quantity as a string (for precision)\n- Wallet/auth options when transactions are involved\n\nCheck the SDK documentation or use TypeScript intellisense for the complete parameter interface."
-        },
-        {
-          "userQuestion": "What are best practices for graduate token pools?",
-          "assistantResponse": "1. **Use TypeScript**: Get full type safety and intellisense.\n2. **Handle errors**: Always wrap SDK calls in try-catch blocks.\n3. **Validate inputs**: Check parameters before making API calls.\n4. **Cache when appropriate**: Reduce API calls for static data."
-        },
-        {
-          "userQuestion": "What errors should I handle when graduate token pools?",
-          "assistantResponse": "**General Error Handling:**\n\n```typescript\ntry {\n  const result = await sdk.poolgraduation(...);\n} catch (error) {\n  if (error instanceof Error) {\n    console.error('Operation failed:', error.message);\n    // Handle specific error types\n  }\n}\n```\n\n**Common Issues:**\n- Network timeouts - implement retry logic\n- Invalid parameters - validate before calling\n- Authentication errors - ensure valid session"
-        },
-        {
-          "userQuestion": "What should I learn next after graduate token pools?",
-          "assistantResponse": "**Related Topics:**\n\n- **Buy tokens**: `explainSdkUsage({ topic: 'buy-tokens' })`\n- **Dex trading**: `explainSdkUsage({ topic: 'dex-trading' })`\n- **Token status**: `explainSdkUsage({ topic: 'token-status' })`\n\n**Learning Path:** Start with the basics, then explore related topics to build a complete understanding of the SDK capabilities."
-        }
-      ]
-    },
-    {
-      "topicKey": "sell-tokens",
-      "label": "Sell tokens",
-      "category": "trading",
-      "description": "Buy, sell, and calculate token amounts",
-      "methodCount": 2,
-      "exchanges": [
-        {
-          "userQuestion": "How do I sell tokens?",
-          "assistantResponse": "\n## Selling Tokens with SDK\n\n**Covers Methods:**\n- `calculateSellAmount()`\n- `sell()`\n\n```typescript\nimport { createLaunchpadSDK } from '@gala-chain/launchpad-sdk';\n\nasync function sellTokens() {\n  // 1. Create SDK instance\n  const sdk = createLaunchpadSDK({\n    wallet: 'your-private-key'\n  });\n\n  // 2. Calculate expected GALA FIRST (REQUIRED)\n  const calculation = await sdk.calculateSellAmount({\n    tokenName: 'dragnrkti',\n    amount: '1000',     // Selling 1000 tokens\n    type: 'exact'       // 'exact' = exact tokens, 'native' = target GALA amount\n  });\n\n  console.log('Expected GALA:', calculation.amount);\n  console.log('RBC Fee:', calculation.reverseBondingCurveFee);\n\n  // 3. Execute sell with slippage protection\n  const result = await sdk.sell({\n    tokenName: 'dragnrkti',\n    amount: '1000',\n    type: 'exact',\n    expectedAmount: calculation.amount,  // REQUIRED: from step 2\n    maxAcceptableReverseBondingCurveFee: calculation.reverseBondingCurveFee, // RECOMMENDED\n    slippageToleranceFactor: 0.01  // 1% slippage\n  });\n\n  console.log('Tokens sold:', result.inputAmount);\n  console.log('GALA received:', result.outputAmount);\n}\n```\n\n**MCP Tool Equivalent:** `gala_launchpad_sell_tokens`\n"
-        },
-        {
-          "userQuestion": "What parameters does calculateSellAmount() accept?",
-          "assistantResponse": "The primary methods for Sell tokens are `calculateSellAmount()`, `sell()`. Each method accepts configuration options as a single object parameter.\n\n**Common Parameters:**\n- `tokenName`: The token identifier (e.g., 'dragnrkti')\n- `amount`: Quantity as a string (for precision)\n- Wallet/auth options when transactions are involved\n\nCheck the SDK documentation or use TypeScript intellisense for the complete parameter interface."
-        },
-        {
-          "userQuestion": "What are best practices for sell tokens?",
-          "assistantResponse": "1. **Calculate before selling**: Use `calculateSellAmount()` to preview the GALA you'll receive.\n2. **Consider fees**: RBC fees affect your final amount.\n3. **Verify token balance**: Check you have enough tokens before attempting to sell."
-        },
-        {
-          "userQuestion": "What errors should I handle when sell tokens?",
-          "assistantResponse": "**Common Errors:**\n- `InsufficientTokenBalance`: Not enough tokens to sell\n- `SlippageExceeded`: Price moved during transaction\n- `TokenLocked`: Some tokens may be locked - check with `fetchLockedBalance()`\n\n**Tip:** Always verify your available (unlocked) balance before selling."
-        },
-        {
-          "userQuestion": "What edge cases should I know about for sell tokens?",
-          "assistantResponse": "**Edge Cases:**\n1. **Partial sells**: You can sell any amount up to your balance\n2. **Graduated tokens**: Use DEX trading, not bonding curve\n3. **Fee calculation**: RBC fee percentage changes based on supply\n\n**Gotcha:** Selling large amounts can have significant price impact on smaller pools."
-        },
-        {
-          "userQuestion": "When would I actually use sell tokens in a real application?",
-          "assistantResponse": "**Real-World Use Cases:**\n\n1. **Profit Taking**: Sell portion of holdings at target prices\n2. **Stop Loss**: Automated selling when price drops below threshold\n3. **Portfolio Rebalancing**: Sell to maintain allocation percentages\n4. **Liquidity Provision**: Sell to provide capital for other investments"
-        },
-        {
-          "userQuestion": "What should I learn next after sell tokens?",
-          "assistantResponse": "**Related Topics:**\n\n- **Buy tokens**: `explainSdkUsage({ topic: 'buy-tokens' })`\n- **Balances**: `explainSdkUsage({ topic: 'balances' })`\n- **Transfers**: `explainSdkUsage({ topic: 'transfers' })`\n- **Dex trading**: `explainSdkUsage({ topic: 'dex-trading' })`\n\n**Learning Path:** Start with the basics, then explore related topics to build a complete understanding of the SDK capabilities."
-        }
-      ]
-    },
-    {
-      "topicKey": "trading-analytics",
-      "label": "Trading analytics",
-      "category": "trading",
-      "description": "Buy, sell, and calculate token amounts",
-      "methodCount": 2,
-      "exchanges": [
-        {
-          "userQuestion": "How do I analyze trading data?",
-          "assistantResponse": "\n## Trading History and Analytics\n\n**Covers Methods:**\n- `fetchTrades()` - Legacy trade fetching by token\n- `getV1Trades()` - Flexible trade queries with tokenName/userAddress filters\n\nAnalyze individual trades for technical analysis and bot development.\n\n**Use Cases:**\n- Track recent trading activity\n- Calculate average trade size\n- Identify whale transactions\n- Build trading bots with historical data\n- Query a user's trading history across all tokens\n\n```typescript\nimport { createLaunchpadSDK } from '@gala-chain/launchpad-sdk';\n\nasync function tradingAnalytics() {\n  const sdk = createLaunchpadSDK({ environment: 'production' });\n\n  // Fetch recent trades for a token (legacy method)\n  const trades = await sdk.fetchTrades('anime', {\n    limit: 100,\n    page: 1\n  });\n\n  console.log(`Analyzing ${trades.total} trades`);\n\n  // Calculate analytics\n  const totalVolume = trades.trades.reduce((sum, t) => sum + safeParseFloat(t.galaAmount, 0), 0);\n  const averageTradeSize = totalVolume / trades.trades.length;\n  const whaleTrades = trades.trades.filter(t => safeParseFloat(t.galaAmount, 0) > 1000);\n\n  console.log(`Total volume: ${totalVolume} GALA`);\n  console.log(`Average trade size: ${averageTradeSize} GALA`);\n  console.log(`Whale trades (>1000 GALA): ${whaleTrades.length}`);\n\n  // Most recent trades\n  trades.trades.slice(0, 10).forEach(trade => {\n    console.log(`${trade.type}: ${trade.galaAmount} GALA at ${trade.timestamp}`);\n  });\n}\n\n// V1 Trades API - Flexible queries with filters\nasync function queryTradesV1() {\n  const sdk = createLaunchpadSDK({ environment: 'production' });\n\n  // Query all trades for a specific token\n  const { trades, meta } = await sdk.getV1Trades({ tokenName: 'anime' });\n  console.log(`Found ${meta.totalItems} trades for anime`);\n\n  // Query all trades by a specific user\n  const userTrades = await sdk.getV1Trades({\n    userAddress: 'eth|1234567890abcdef...'\n  });\n  console.log(`User has ${userTrades.meta.totalItems} trades across all tokens`);\n\n  // Query a user's trades on a specific token with pagination\n  const filteredTrades = await sdk.getV1Trades({\n    tokenName: 'anime',\n    userAddress: 'eth|1234567890abcdef...',\n    page: 2,\n    limit: 20\n  });\n  console.log(`Page ${filteredTrades.meta.currentPage} of ${filteredTrades.meta.totalPages}`);\n\n  // Analyze trade types\n  filteredTrades.trades.forEach(trade => {\n    console.log(`${trade.txnType}: ${trade.inputAmount} -> ${trade.outputAmount}`);\n  });\n}\n```\n\n**Related Topics:**\n- See `fetch-pools` for volume data analysis\n- See `dex-trading` for executing trades\n\n**MCP Tools:**\n- `gala_launchpad_fetch_trades` - Legacy trade fetching\n- `gala_launchpad_get_v1_trades` - Flexible trade queries with filters\n"
-        },
-        {
-          "userQuestion": "What parameters does fetchTrades() accept?",
-          "assistantResponse": "The primary methods for Trading analytics are `fetchTrades()`, `getTrades()`. Each method accepts configuration options as a single object parameter.\n\n**Common Parameters:**\n- `tokenName`: The token identifier (e.g., 'dragnrkti')\n- `amount`: Quantity as a string (for precision)\n- Wallet/auth options when transactions are involved\n\nCheck the SDK documentation or use TypeScript intellisense for the complete parameter interface."
-        },
-        {
-          "userQuestion": "What are best practices for analyze trading data?",
-          "assistantResponse": "1. **Use TypeScript**: Get full type safety and intellisense.\n2. **Handle errors**: Always wrap SDK calls in try-catch blocks.\n3. **Validate inputs**: Check parameters before making API calls.\n4. **Cache when appropriate**: Reduce API calls for static data."
-        },
-        {
-          "userQuestion": "What should I learn next after analyze trading data?",
-          "assistantResponse": "**Related Topics:**\n\n- **Trade history**: `explainSdkUsage({ topic: 'trade-history' })`\n- **Price history**: `explainSdkUsage({ topic: 'price-history' })`\n- **Fetch pools**: `explainSdkUsage({ topic: 'fetch-pools' })`\n\n**Learning Path:** Start with the basics, then explore related topics to build a complete understanding of the SDK capabilities."
-        },
-        {
-          "userQuestion": "Any final tips for analyze trading data?",
-          "assistantResponse": "**Quick Tips:**\n\n1. **Start Simple**: Begin with the basic use case before exploring advanced features\n2. **Use TypeScript**: The SDK has full TypeScript support for better autocomplete and type safety\n3. **Check the Demos**: The examples/ directory has working demos for most SDK features\n4. **Read Error Messages**: SDK errors include helpful context for troubleshooting\n\nYou're ready to start building with this feature!"
-        }
-      ]
-    },
-    {
-      "topicKey": "transfers",
-      "label": "Transfers",
-      "category": "transfers",
-      "description": "GALA and token transfers",
-      "methodCount": 2,
-      "exchanges": [
-        {
-          "userQuestion": "How do I transfer tokens?",
-          "assistantResponse": "\n## Token Transfers with SDK\n\n**Covers Methods:**\n- `transferGala()`\n- `transferToken()`\n\n```typescript\nimport { createLaunchpadSDK } from '@gala-chain/launchpad-sdk';\n\nasync function transferTokens() {\n  const sdk = createLaunchpadSDK({\n    wallet: 'your-private-key'\n  });\n\n  // Transfer GALA tokens\n  const galaTransfer = await sdk.transferGala({\n    recipientAddress: '0x1234...', // or 'eth|1234...'\n    amount: '100',\n    uniqueKey: 'galaconnect-operation-my-transfer-123'  // Optional idempotency\n  });\n\n  console.log('GALA transfer ID:', galaTransfer.transactionId);\n  console.log('Status:', galaTransfer.status);\n\n  // Transfer launchpad tokens\n  const tokenTransfer = await sdk.transferToken({\n    to: 'eth|5678...',\n    tokenName: 'dragnrkti',\n    amount: '1000',  // Token amount\n    uniqueKey: 'galaconnect-operation-token-456'\n  });\n\n  console.log('Token transfer ID:', tokenTransfer.transactionId);\n}\n```\n\n**Features:**\n- EIP-712 signatures for security\n- Supports both `0x` and `eth|` address formats\n- Optional idempotency keys prevent duplicates\n- Comprehensive validation\n\n**MCP Tool Equivalents:**\n- `gala_launchpad_transfer_gala`\n- `gala_launchpad_transfer_token`\n"
-        },
-        {
-          "userQuestion": "What parameters does transferGala() accept?",
-          "assistantResponse": "The primary methods for Transfers are `transferGala()`, `transferToken()`. Each method accepts configuration options as a single object parameter.\n\n**Common Parameters:**\n- `tokenName`: The token identifier (e.g., 'dragnrkti')\n- `amount`: Quantity as a string (for precision)\n- Wallet/auth options when transactions are involved\n\nCheck the SDK documentation or use TypeScript intellisense for the complete parameter interface."
-        },
-        {
-          "userQuestion": "What are best practices for transfer tokens?",
-          "assistantResponse": "1. **Use TypeScript**: Get full type safety and intellisense.\n2. **Handle errors**: Always wrap SDK calls in try-catch blocks.\n3. **Validate inputs**: Check parameters before making API calls.\n4. **Cache when appropriate**: Reduce API calls for static data."
-        },
-        {
-          "userQuestion": "What errors should I handle when transfer tokens?",
-          "assistantResponse": "**Common Errors:**\n- `InsufficientBalance`: Not enough tokens/GALA\n- `InvalidRecipientAddress`: Check address format\n- `TokenLocked`: Some balance may be locked\n\n**Tip:** Verify available balance before transfer."
-        },
-        {
-          "userQuestion": "What should I learn next after transfer tokens?",
-          "assistantResponse": "**Related Topics:**\n\n- **Balances**: `explainSdkUsage({ topic: 'balances' })`\n- **Locks**: `explainSdkUsage({ topic: 'locks' })`\n- **Bridge operations**: `explainSdkUsage({ topic: 'bridge-operations' })`\n\n**Learning Path:** Start with the basics, then explore related topics to build a complete understanding of the SDK capabilities."
-        }
-      ]
-    },
-    {
-      "topicKey": "error-handling",
-      "label": "Error handling",
-      "category": "utils",
-      "description": "SDK configuration and helpers",
-      "methodCount": 0,
-      "exchanges": [
-        {
-          "userQuestion": "How do I handle SDK errors properly?",
-          "assistantResponse": "\n## Error Handling with SDK\n\n**Covers Methods:**\n- Error types from SDK (ValidationError, NetworkError, TransactionError, TokenNotFoundError, etc.)\n\n```typescript\nimport {\n  createLaunchpadSDK,\n  ValidationError,\n  NetworkError,\n  TransactionError,\n  TokenNotFoundError\n} from '@gala-chain/launchpad-sdk';\n\nasync function errorHandlingExample() {\n  const sdk = createLaunchpadSDK({\n    wallet: 'your-private-key'\n  });\n\n  try {\n    // Attempt trade\n    const result = await sdk.buy({\n      tokenName: 'dragnrkti',\n      amount: '100',\n      type: 'native',\n      expectedAmount: '5000',\n      slippageToleranceFactor: 0.01\n    });\n\n    console.log('Success:', result.transactionId);\n\n  } catch (error) {\n    if (error instanceof ValidationError) {\n      console.error('Invalid input:', error.message);\n      console.error('Field:', error.field);\n      console.error('Code:', error.code);\n\n    } else if (error instanceof TokenNotFoundError) {\n      console.error('Token does not exist:', error.tokenName);\n\n    } else if (error instanceof NetworkError) {\n      console.error('Network issue:', error.message);\n      console.error('Status code:', error.statusCode);\n\n    } else if (error instanceof TransactionError) {\n      console.error('Transaction failed:', error.message);\n      console.error('Transaction ID:', error.transactionId);\n\n    } else {\n      console.error('Unexpected error:', error);\n    }\n  }\n}\n```\n\n**Error Types:**\n- `ValidationError` - Invalid input parameters\n- `NetworkError` - HTTP/network failures\n- `TransactionError` - Blockchain transaction failures\n- `TokenNotFoundError` - Token doesn't exist\n- `ConfigurationError` - SDK misconfiguration\n- `WebSocketError` - Real-time connection issues\n"
-        },
-        {
-          "userQuestion": "Where can I find more details about handle SDK errors properly?",
-          "assistantResponse": "This topic covers conceptual material and best practices. For reference documentation, check the full SDK API docs or use TypeScript intellisense in your editor for complete method signatures and parameter types."
-        },
-        {
-          "userQuestion": "What are best practices for handle SDK errors properly?",
-          "assistantResponse": "1. **Wrap all SDK calls in try-catch**: Handle errors gracefully.\n2. **Check for specific error types**: Different errors require different handling.\n3. **Log errors for debugging**: Include context like token name and amounts."
-        },
-        {
-          "userQuestion": "What should I learn next after handle SDK errors properly?",
-          "assistantResponse": "**Related Topics:**\n\n- Check the SDK documentation for related functionality\n\n**Learning Path:** Start with the basics, then explore related topics to build a complete understanding of the SDK capabilities."
-        },
-        {
-          "userQuestion": "Any final tips for handle SDK errors properly?",
-          "assistantResponse": "**Quick Tips:**\n\n1. **Start Simple**: Begin with the basic use case before exploring advanced features\n2. **Use TypeScript**: The SDK has full TypeScript support for better autocomplete and type safety\n3. **Check the Demos**: The examples/ directory has working demos for most SDK features\n4. **Read Error Messages**: SDK errors include helpful context for troubleshooting\n\nYou're ready to start building with this feature!"
-        }
-      ]
-    },
-    {
-      "topicKey": "installation",
-      "label": "Installation",
-      "category": "utils",
-      "description": "SDK configuration and helpers",
-      "methodCount": 0,
-      "exchanges": [
-        {
-          "userQuestion": "How do I install and configure the SDK?",
-          "assistantResponse": "\n## Installing and Importing SDK\n\n**Covers Methods:**\n- SDK installation, imports, and configuration\n\n### NPM Installation\n\n```bash\n# Install SDK\nnpm install @gala-chain/launchpad-sdk\n\n# Install peer dependencies\nnpm install ethers@^6.15.0 @gala-chain/api@^2.4.3 @gala-chain/connect@^2.4.3 \\\n  socket.io-client@^4.8.1 axios@^1.12.2 bignumber.js@^9.1.2 zod@^3.25.76\n```\n\n### Import Patterns\n\n```typescript\n// Main SDK class\nimport { LaunchpadSDK } from '@gala-chain/launchpad-sdk';\n\n// Helper functions (recommended)\nimport {\n  createLaunchpadSDK,\n  createTestLaunchpadSDK,\n  createWallet,\n  validateWalletInput\n} from '@gala-chain/launchpad-sdk';\n\n// Error types\nimport {\n  ValidationError,\n  NetworkError,\n  TransactionError,\n  TokenNotFoundError\n} from '@gala-chain/launchpad-sdk';\n\n// Type definitions\nimport type {\n  PoolData,\n  TradeResult,\n  TokenBalanceInfo,\n  BuyTokenOptions,\n  SellTokenOptions\n} from '@gala-chain/launchpad-sdk';\n```\n\n### Environment Configuration\n\n```typescript\n// Production (default)\nconst sdk = createLaunchpadSDK({\n  wallet: 'your-private-key',\n  config: {\n    baseUrl: 'https://lpad-backend-prod1.defi.gala.com',\n    debug: false,\n    timeout: 60000\n  }\n});\n\n// Development\nconst sdk = createLaunchpadSDK({\n  wallet: 'your-private-key',\n  config: {\n    baseUrl: 'https://lpad-backend-dev1.defi.gala.com',\n    debug: true\n  }\n});\n```\n"
-        },
-        {
-          "userQuestion": "Where can I find more details about install and configure the SDK?",
-          "assistantResponse": "This topic covers conceptual material and best practices. For reference documentation, check the full SDK API docs or use TypeScript intellisense in your editor for complete method signatures and parameter types."
-        },
-        {
-          "userQuestion": "What are best practices for install and configure the SDK?",
-          "assistantResponse": "1. **Use TypeScript**: Get full type safety and intellisense.\n2. **Handle errors**: Always wrap SDK calls in try-catch blocks.\n3. **Validate inputs**: Check parameters before making API calls.\n4. **Cache when appropriate**: Reduce API calls for static data."
-        },
-        {
-          "userQuestion": "What should I learn next after install and configure the SDK?",
-          "assistantResponse": "**Related Topics:**\n\n- Check the SDK documentation for related functionality\n\n**Learning Path:** Start with the basics, then explore related topics to build a complete understanding of the SDK capabilities."
-        },
-        {
-          "userQuestion": "Any final tips for install and configure the SDK?",
-          "assistantResponse": "**Quick Tips:**\n\n1. **Start Simple**: Begin with the basic use case before exploring advanced features\n2. **Use TypeScript**: The SDK has full TypeScript support for better autocomplete and type safety\n3. **Check the Demos**: The examples/ directory has working demos for most SDK features\n4. **Read Error Messages**: SDK errors include helpful context for troubleshooting\n\nYou're ready to start building with this feature!"
-        }
-      ]
-    },
-    {
-      "topicKey": "liquidity-positions",
-      "label": "Liquidity positions",
-      "category": "utils",
-      "description": "SDK configuration and helpers",
-      "methodCount": 9,
-      "exchanges": [
-        {
-          "userQuestion": "How do I manage liquidity positions?",
-          "assistantResponse": "\n## GSwap Liquidity Position Management\n\n**Covers Methods:**\n- `getSwapUserLiquidityPositions()`\n- `getAllSwapUserLiquidityPositions()`\n- `getSwapLiquidityPosition()`\n- `getSwapLiquidityPositionById()`\n- `addSwapLiquidityByPrice()`\n- `addSwapLiquidityByTicks()`\n- `getSwapEstimateRemoveLiquidity()`\n- `removeSwapLiquidity()`\n- `collectSwapPositionFees()`\n\nProvide liquidity on GalaSwap DEX and earn passive trading fees from swaps.\n\n**Overview:** Concentrated liquidity allows capital deployment within specific price ranges. Liquidity providers earn fees when trades occur within their price range, making it an attractive passive income strategy.\n\n**9 Core SDK Methods:**\n\n1. **getSwapUserLiquidityPositions(ownerAddress, limit?, bookmark?)** - View all open positions for wallet\n   - Returns: Array of positions with token pairs, amounts, accumulated fees\n\n2. **getSwapLiquidityPositionById(ownerAddress, positionId)** - Get specific position by UUID\n\n3. **getSwapLiquidityPosition(ownerAddress, position)** - Get position by token pair and tick range\n\n4. **addSwapLiquidityByPrice(args)** - Create position using user-friendly price ranges\n   - params: token0, token1, fee, minPrice, maxPrice, amount0Desired, amount1Desired\n\n5. **addSwapLiquidityByTicks(args)** - Create position using precise tick boundaries (advanced)\n\n6. **getSwapEstimateRemoveLiquidity(args)** - Preview removal amounts before executing\n   - Returns: estimated token amounts and accumulated fees\n\n7. **removeSwapLiquidity(args)** - Close or reduce position with slippage protection\n   - Removes liquidity and collects accumulated fees\n\n8. **collectSwapPositionFees(args)** - Harvest accumulated fees without closing position\n   - Passive income collection\n\n**Fee Tiers:** 500 bps (0.05%), 3000 bps (0.30%), 10000 bps (1.00%)\n\n**MCP Tools (8 tools):**\n- gala_launchpad_get_user_liquidity_positions\n- gala_launchpad_get_liquidity_position_by_id\n- gala_launchpad_get_liquidity_position\n- gala_launchpad_add_liquidity_by_price\n- gala_launchpad_add_liquidity_by_ticks\n- gala_launchpad_estimate_remove_liquidity\n- gala_launchpad_remove_liquidity\n- gala_launchpad_collect_position_fees\n\n**Slash Commands (4 commands):**\n- /galachain-launchpad:my-positions - View all positions\n- /galachain-launchpad:add-liquidity - Create position\n- /galachain-launchpad:remove-liquidity - Close position\n- /galachain-launchpad:collect-fees - Harvest fees\n\n**Auto-Pagination Method:**\n\nUse `getAllSwapUserLiquidityPositions()` to fetch all positions without manual pagination:\n\n```typescript\n// Fetch ALL positions automatically (handles pagination internally)\nconst allPositions = await sdk.getAllSwapUserLiquidityPositions(ownerAddress);\n\nconsole.log(`Total positions: ${allPositions.length}`);\nallPositions.forEach(position => {\n  const fees = position.fees0 + position.fees1; // Total accumulated fees\n  console.log(`Position: ${position.token0}-${position.token1}`);\n  console.log(`Accumulated fees: ${fees}`);\n});\n```\n\n**Demo Script:** See packages/sdk/examples/demo-liquidity-positions.ts for complete workflows\n"
-        },
-        {
-          "userQuestion": "What parameters does getSwapUserLiquidityPositions() accept?",
-          "assistantResponse": "The primary methods for Liquidity positions are `getSwapUserLiquidityPositions()`, `getAllSwapUserLiquidityPositions()`, `getSwapLiquidityPosition()`. Each method accepts configuration options as a single object parameter.\n\n**Common Parameters:**\n- `tokenName`: The token identifier (e.g., 'dragnrkti')\n- `amount`: Quantity as a string (for precision)\n- Wallet/auth options when transactions are involved\n\nCheck the SDK documentation or use TypeScript intellisense for the complete parameter interface."
-        },
-        {
-          "userQuestion": "What are best practices for manage liquidity positions?",
-          "assistantResponse": "1. **Use TypeScript**: Get full type safety and intellisense.\n2. **Handle errors**: Always wrap SDK calls in try-catch blocks.\n3. **Validate inputs**: Check parameters before making API calls.\n4. **Cache when appropriate**: Reduce API calls for static data."
-        },
-        {
-          "userQuestion": "What errors should I handle when manage liquidity positions?",
-          "assistantResponse": "**Common Errors:**\n- `TickOutOfRange`: Invalid tick boundaries for fee tier\n- `InsufficientAmount`: Not enough tokens for position\n- `PositionNotFound`: Position ID doesn't exist\n\n**Tip:** Use `addSwapLiquidityByPrice()` for easier price-based ranges."
-        },
-        {
-          "userQuestion": "Can you walk me through a complete manage liquidity positions example?",
-          "assistantResponse": "**Complete Workflow: Liquidity positions**\n\nHere's the typical flow: `getSwapUserLiquidityPositions()` → `getAllSwapUserLiquidityPositions()` → `getSwapLiquidityPosition()`\n\n**Step-by-Step:**\n1. **Setup**: Initialize SDK with your configuration\n2. **Validate**: Check prerequisites (balances, permissions)\n3. **Calculate**: Use calculation methods to preview results\n4. **Execute**: Perform the main operation\n5. **Verify**: Confirm the operation succeeded\n\n**Pro Tip:** The SDK methods are designed to be called in sequence. Each step provides data needed for the next."
-        },
-        {
-          "userQuestion": "What other methods are available for Liquidity positions?",
-          "assistantResponse": "**Additional Methods:**\n\n- `getSwapLiquidityPositionById()`\n- `addSwapLiquidityByPrice()`\n- `addSwapLiquidityByTicks()`\n- `getSwapEstimateRemoveLiquidity()`\n\n**Total methods in this topic:** 9\n\nEach method serves a specific purpose in the workflow. Use TypeScript intellisense or the SDK documentation to explore parameter options for each method."
-        },
-        {
-          "userQuestion": "When would I actually use manage liquidity positions in a real application?",
-          "assistantResponse": "**Real-World Use Cases:**\n\n1. **Fee Earning**: Provide liquidity to earn trading fees\n2. **Market Making**: Set tight ranges for active trading pairs\n3. **Range Orders**: Use LP positions as limit orders\n4. **Yield Strategies**: Combine with other DeFi protocols"
-        },
-        {
-          "userQuestion": "What should I learn next after manage liquidity positions?",
-          "assistantResponse": "**Related Topics:**\n\n- **Dex trading**: `explainSdkUsage({ topic: 'dex-trading' })`\n- **Fetch dex pools**: `explainSdkUsage({ topic: 'fetch-dex-pools' })`\n- **Advanced dex analysis**: `explainSdkUsage({ topic: 'advanced-dex-analysis' })`\n\n**Learning Path:** Start with the basics, then explore related topics to build a complete understanding of the SDK capabilities."
-        }
-      ]
-    },
-    {
-      "topicKey": "mcp-to-sdk-mapping",
-      "label": "Mcp to sdk mapping",
-      "category": "utils",
-      "description": "SDK configuration and helpers",
-      "methodCount": 0,
-      "exchanges": [
-        {
-          "userQuestion": "How do I map MCP tools to SDK methods?",
-          "assistantResponse": "\n## MCP Tool to SDK Method Mapping Guide\n\n**Covers Concepts:**\n- Understanding MCP tool architecture\n- Mapping between MCP tools and SDK methods\n- When to use MCP vs direct SDK\n\nThis is a conceptual guide showing how MCP (Model Context Protocol) tools map to SDK methods.\n\n### Architecture Overview\n\n```\n┌─────────────────────────────────────────────────────────────┐\n│                     MCP Server Layer                         │\n│  (241 tools - user-friendly wrappers with validation)       │\n└─────────────────────────────────────────────────────────────┘\n                            │\n                            ▼\n┌─────────────────────────────────────────────────────────────┐\n│                    LaunchpadSDK Layer                        │\n│   (217 methods - low-level programmatic access)             │\n└─────────────────────────────────────────────────────────────┘\n                            │\n                            ▼\n┌─────────────────────────────────────────────────────────────┐\n│               Gala Launchpad Backend APIs                    │\n│  (REST endpoints, WebSocket events, GalaChain)              │\n└─────────────────────────────────────────────────────────────┘\n```\n\n### MCP vs SDK Decision Matrix\n\n| Scenario | Use MCP | Use SDK |\n|----------|---------|---------|\n| **AI Agent Development** | ✅ Yes | ❌ No |\n| **Claude Desktop Integration** | ✅ Yes | ❌ No |\n| **LLM-Driven Trading Bots** | ✅ Yes | ❌ No |\n| **TypeScript Application** | ❌ No | ✅ Yes |\n| **Node.js Backend Service** | ❌ No | ✅ Yes |\n| **React/Vue Frontend** | ❌ No | ✅ Yes |\n| **Python Application** | ❌ No (SDK only) | ❌ No (not yet) |\n\n### Tool Naming Conventions\n\n**MCP Tool Pattern:** `gala_launchpad_{action}_{resource}`\n**SDK Method Pattern:** `{action}{Resource}`\n\nExamples:\n- MCP: `gala_launchpad_fetch_pools` → SDK: `fetchPools()`\n- MCP: `gala_launchpad_buy_tokens` → SDK: `buy()`\n- MCP: `gala_launchpad_get_swap_quote_exact_input` → SDK: `getSwapQuoteExactInput()`\n\n### Common Mapping Patterns\n\n**1. Direct 1:1 Mapping (Most Common):**\n\n```typescript\n// MCP Tool: gala_launchpad_fetch_pools\n// SDK Method: fetchPools()\n\n// MCP Usage (AI agent)\nconst result = await tools.gala_launchpad_fetch_pools({\n  type: 'recent',\n  limit: 10\n});\n\n// SDK Usage (TypeScript app)\nconst sdk = createLaunchpadSDK({ wallet: 'private-key' });\nconst result = await sdk.fetchPools({ type: 'recent', limit: 10 });\n```\n\n**2. Composite Tool → Multiple SDK Methods:**\n\n```typescript\n// MCP Tool: gala_launchpad_buy_tokens_with_calculation\n// Calls TWO SDK methods internally:\n\n// 1. Calculate quote\nconst quote = await sdk.calculateBuyAmount({\n  tokenName: 'anime',\n  amount: '100',\n  type: 'native'\n});\n\n// 2. Execute trade\nconst result = await sdk.buy({\n  tokenName: 'anime',\n  amount: '100',\n  type: 'native',\n  expectedAmount: quote.amount,\n  slippageToleranceFactor: 0.01\n});\n```\n\n**3. SDK Method → No MCP Tool (Advanced Features):**\n\nSome SDK methods don't have MCP equivalents:\n- `setWallet()` - Runtime wallet changes\n- `getConfig()` - SDK configuration access\n- `warmCacheFromPoolData()` - Cache optimization\n\n**4. MCP Tool → No Direct SDK Method (Abstractions):**\n\nSome MCP tools provide abstractions:\n- `gala_launchpad_portfolio` - Aggregates multiple SDK calls\n- `gala_launchpad_analyze_token` - Composite analysis workflow\n\n### Complete Mapping Reference\n\n**Trading (13 MCP tools → 9 SDK methods):**\n\n| MCP Tool | SDK Method |\n|----------|-----------|\n| `gala_launchpad_buy_tokens` | `buy()` |\n| `gala_launchpad_sell_tokens` | `sell()` |\n| `gala_launchpad_calculate_buy_amount` | `calculateBuyAmount()` |\n| `gala_launchpad_calculate_sell_amount` | `calculateSellAmount()` |\n| `gala_launchpad_graduate_token` | `graduateToken()` |\n| `gala_launchpad_calculate_buy_amount_local` | `calculateBuyAmountLocal()` |\n| `gala_launchpad_calculate_sell_amount_local` | `calculateSellAmountLocal()` |\n| `gala_launchpad_calculate_buy_amount_external` | `calculateBuyAmountExternal()` |\n| `gala_launchpad_calculate_sell_amount_external` | `calculateSellAmountExternal()` |\n\n**DEX Trading (6 MCP tools → 6 SDK methods):**\n\n| MCP Tool | SDK Method |\n|----------|-----------|\n| `gala_launchpad_get_swap_quote_exact_input` | `getSwapQuoteExactInput()` |\n| `gala_launchpad_get_swap_quote_exact_output` | `getSwapQuoteExactOutput()` |\n| `gala_launchpad_execute_swap` | `executeSwap()` |\n| `gala_launchpad_get_swap_user_assets` | `getSwapUserAssets()` |\n| `gala_launchpad_get_all_swap_user_assets` | `getAllSwapUserAssets()` |\n| `gala_launchpad_get_swap_pool_info` | `getSwapPoolInfo()` |\n\n**Liquidity Management (8 MCP tools → 9 SDK methods):**\n\n| MCP Tool | SDK Method |\n|----------|-----------|\n| `gala_launchpad_get_user_liquidity_positions` | `getSwapUserLiquidityPositions()` |\n| `gala_launchpad_get_all_user_liquidity_positions` | `getAllSwapUserLiquidityPositions()` |\n| `gala_launchpad_get_liquidity_position_by_id` | `getSwapLiquidityPositionById()` |\n| `gala_launchpad_add_liquidity_by_price` | `addSwapLiquidityByPrice()` |\n| `gala_launchpad_add_liquidity_by_ticks` | `addSwapLiquidityByTicks()` |\n| `gala_launchpad_estimate_remove_liquidity` | `getSwapEstimateRemoveLiquidity()` |\n| `gala_launchpad_remove_liquidity` | `removeSwapLiquidity()` |\n| `gala_launchpad_collect_position_fees` | `collectSwapPositionFees()` |\n\n### When to Use Each\n\n**Use MCP Tools When:**\n- Building AI agents (Claude, GPT, etc.)\n- Need LLM-friendly error messages\n- Want automatic parameter validation\n- Working in Claude Desktop environment\n- Need slash command shortcuts\n\n**Use SDK Directly When:**\n- Building TypeScript/JavaScript applications\n- Need maximum performance\n- Want full TypeScript type safety\n- Building React/Vue components\n- Need fine-grained control\n\n### Migration Example\n\n**From MCP to SDK:**\n\n```typescript\n// AI Agent using MCP\nasync function mcpExample() {\n  const result = await tools.gala_launchpad_buy_tokens({\n    tokenName: 'anime',\n    amount: '100',\n    type: 'native',\n    slippageToleranceFactor: 0.01\n  });\n  return result;\n}\n\n// TypeScript App using SDK\nimport { createLaunchpadSDK } from '@gala-chain/launchpad-sdk';\n\nasync function sdkExample() {\n  const sdk = createLaunchpadSDK({ wallet: 'private-key' });\n\n  // Step 1: Calculate quote\n  const quote = await sdk.calculateBuyAmount({\n    tokenName: 'anime',\n    amount: '100',\n    type: 'native'\n  });\n\n  // Step 2: Execute trade\n  const result = await sdk.buy({\n    tokenName: 'anime',\n    amount: '100',\n    type: 'native',\n    expectedAmount: quote.amount,\n    slippageToleranceFactor: 0.01\n  });\n\n  return result;\n}\n```\n\n**Key Differences:**\n1. MCP combines calculation + execution (safer for AI)\n2. SDK exposes individual steps (more control)\n3. MCP validates all inputs via Zod schemas\n4. SDK provides TypeScript type safety\n\n### Resources\n\n- **SDK Documentation**: packages/sdk/README.md\n- **MCP Documentation**: packages/mcp-server/README.md\n- **API Reference**: docs/API-REFERENCE.md\n- **Tool Registry**: packages/mcp-server/src/tools/registry.ts\n"
-        },
-        {
-          "userQuestion": "Where can I find more details about map MCP tools to SDK methods?",
-          "assistantResponse": "This topic covers conceptual material and best practices. For reference documentation, check the full SDK API docs or use TypeScript intellisense in your editor for complete method signatures and parameter types."
-        },
-        {
-          "userQuestion": "What are best practices for map MCP tools to SDK methods?",
-          "assistantResponse": "1. **Use TypeScript**: Get full type safety and intellisense.\n2. **Handle errors**: Always wrap SDK calls in try-catch blocks.\n3. **Validate inputs**: Check parameters before making API calls.\n4. **Cache when appropriate**: Reduce API calls for static data."
-        },
-        {
-          "userQuestion": "What should I learn next after map MCP tools to SDK methods?",
-          "assistantResponse": "**Related Topics:**\n\n- Check the SDK documentation for related functionality\n\n**Learning Path:** Start with the basics, then explore related topics to build a complete understanding of the SDK capabilities."
-        },
-        {
-          "userQuestion": "Any final tips for map MCP tools to SDK methods?",
-          "assistantResponse": "**Quick Tips:**\n\n1. **Start Simple**: Begin with the basic use case before exploring advanced features\n2. **Use TypeScript**: The SDK has full TypeScript support for better autocomplete and type safety\n3. **Check the Demos**: The examples/ directory has working demos for most SDK features\n4. **Read Error Messages**: SDK errors include helpful context for troubleshooting\n\nYou're ready to start building with this feature!"
-        }
-      ]
-    },
-    {
-      "topicKey": "multi-wallet",
-      "label": "Multi wallet",
-      "category": "utils",
-      "description": "SDK configuration and helpers",
-      "methodCount": 0,
-      "exchanges": [
-        {
-          "userQuestion": "How do I work with multiple wallets?",
-          "assistantResponse": "\n## Multi-Wallet Support with SDK\n\n**Covers Methods:**\n- `createWallet()` (utility function)\n- `buy()`, `sell()`, `launchToken()` with privateKey override\n\n```typescript\nimport { createLaunchpadSDK, createWallet } from '@gala-chain/launchpad-sdk';\n\nasync function multiWalletExample() {\n  // Main SDK with your wallet\n  const sdk = createLaunchpadSDK({\n    wallet: 'your-main-private-key'\n  });\n\n  // Create a test wallet\n  const testWallet = createWallet();\n  console.log('Test wallet:', testWallet.address);\n\n  // 1. Fund test wallet from main wallet\n  await sdk.transferGala({\n    recipientAddress: testWallet.address,\n    amount: '1000'\n  });\n\n  // 2. Have test wallet buy tokens (using privateKey override)\n  const buyCalc = await sdk.calculateBuyAmount({\n    tokenName: 'dragnrkti',\n    amount: '100',\n    type: 'native'\n  });\n\n  const buyResult = await sdk.buy({\n    tokenName: 'dragnrkti',\n    amount: '100',\n    type: 'native',\n    expectedAmount: buyCalc.amount,\n    slippageToleranceFactor: 0.01,\n    privateKey: testWallet.privateKey  // Override to use test wallet\n  });\n\n  console.log('Test wallet bought tokens');\n\n  // 3. Check balances for both wallets\n  const mainBalance = await sdk.fetchGalaBalance();  // Main wallet\n  const testBalance = await sdk.fetchGalaBalance(testWallet.address);  // Test wallet\n\n  console.log(`Main wallet: ${mainBalance.balance} GALA`);\n  console.log(`Test wallet: ${testBalance.balance} GALA`);\n}\n```\n\n**Key Points:**\n- All signing operations support `privateKey` parameter\n- Creates temporary SDK instance internally\n- Supports: buy, sell, launchToken, transfers, profile updates\n"
-        },
-        {
-          "userQuestion": "Where can I find more details about work with multiple wallets?",
-          "assistantResponse": "This topic covers conceptual material and best practices. For reference documentation, check the full SDK API docs or use TypeScript intellisense in your editor for complete method signatures and parameter types."
-        },
-        {
-          "userQuestion": "What are best practices for work with multiple wallets?",
-          "assistantResponse": "1. **Use TypeScript**: Get full type safety and intellisense.\n2. **Handle errors**: Always wrap SDK calls in try-catch blocks.\n3. **Validate inputs**: Check parameters before making API calls.\n4. **Cache when appropriate**: Reduce API calls for static data."
-        },
-        {
-          "userQuestion": "What should I learn next after work with multiple wallets?",
-          "assistantResponse": "**Related Topics:**\n\n- Check the SDK documentation for related functionality\n\n**Learning Path:** Start with the basics, then explore related topics to build a complete understanding of the SDK capabilities."
-        },
-        {
-          "userQuestion": "Any final tips for work with multiple wallets?",
-          "assistantResponse": "**Quick Tips:**\n\n1. **Start Simple**: Begin with the basic use case before exploring advanced features\n2. **Use TypeScript**: The SDK has full TypeScript support for better autocomplete and type safety\n3. **Check the Demos**: The examples/ directory has working demos for most SDK features\n4. **Read Error Messages**: SDK errors include helpful context for troubleshooting\n\nYou're ready to start building with this feature!"
-        }
-      ]
-    },
-    {
-      "topicKey": "spot-prices-smart-routing",
-      "label": "Spot prices smart routing",
-      "category": "utils",
-      "description": "SDK configuration and helpers",
-      "methodCount": 2,
-      "exchanges": [
-        {
-          "userQuestion": "How do I get token prices with smart routing?",
-          "assistantResponse": "\n## Smart Spot Price Routing with DEX Fallback\n\n**Covers Methods:**\n- `fetchTokenPrice()` (smart routing)\n- `isTokenGraduated()`\n\nThe SDK intelligently routes pricing requests between DEX and Launchpad backends based on token graduation status - no need to know which backend a token uses!\n\n```typescript\nimport { createLaunchpadSDK } from '@gala-chain/launchpad-sdk';\n\nasync function tokenPricing() {\n  const sdk = createLaunchpadSDK({\n    wallet: 'your-private-key'\n  });\n\n  // OPTION 1: SMART ROUTING (Recommended) - Automatic backend selection\n  // Use tokenId for ANY token (graduated or ungraduated)\n  // SDK automatically detects and routes to correct backend\n  console.log('=== Smart Routing (Recommended) ===');\n  const smartPrice = await sdk.fetchTokenPrice({\n    tokenId: 'Token|Unit|ANIME|eth:0x...'  // Works for ANY token!\n  });\n  console.log(`Token price: $${smartPrice}`);\n  // ✅ Handles graduated tokens (DEX) automatically\n  // ✅ Handles ungraduated tokens (Launchpad) automatically\n  // ✅ No need to know token status beforehand\n\n  // OPTION 2: EXPLICIT DEX PRICING - Graduated tokens only\n  // Use tokenId directly for DEX tokens\n  console.log('\\n=== Explicit DEX Pricing ===');\n  const dexPrices = await sdk.fetchTokenPrice({\n    tokenId: 'GALA|Unit|none|none'  // Or other DEX token\n  });\n  console.log(`DEX Token GALA: $${dexPrices}`);\n\n  // OPTION 3: TOKEN NAME PRICING - For launchpad tokens by name\n  // Use tokenName for simple lookup of launchpad tokens\n  console.log('\\n=== Token Name Pricing ===');\n  const launchpadPrice = await sdk.fetchTokenPrice({ tokenName: 'anime' });\n  console.log(`Launchpad token anime: $${launchpadPrice.price}`);\n\n  // ADVANCED: The smart router handles fallback automatically!\n  // No need for manual fallback - fetchTokenPrice with tokenId detects\n  // ungraduated tokens and automatically falls back to launchpad pricing\n  console.log('\\n=== Automatic Fallback (Built-in) ===');\n  const autoPrice = await sdk.fetchTokenPrice({\n    tokenId: 'Token|Unit|ANIME|eth:0x...'  // Auto-fallback if ungraduated\n  });\n  console.log(`Auto-routed price: $${autoPrice.price}`);\n\n  // USECASE: Price comparison and discovery\n  console.log('\\n=== Price Discovery ===');\n  async function comparePrices(tokenName: string) {\n    const launchpadPrice = await sdk.fetchTokenPrice({ tokenName });\n\n    // Check if graduated (on DEX)\n    const isGraduated = await sdk.isTokenGraduated(tokenName);\n\n    if (isGraduated) {\n      const dexPrice = await sdk.fetchTokenPrice({\n        tokenId: `Token|Unit|${tokenName.toUpperCase()}|eth:0x...`\n      });\n      console.log(`Launchpad: $${launchpadPrice.price}, DEX: $${dexPrice.price}`);\n      return { launchpadPrice, dexPrice, graduated: true };\n    } else {\n      console.log(`Launchpad: $${launchpadPrice.price} (not on DEX yet)`);\n      return { launchpadPrice, graduated: false };\n    }\n  }\n\n  const priceComparison = await comparePrices('anime');\n}\n```\n\n**Smart Routing Benefits:**\n- ✅ **Seamless Transitions** - Works before and after token graduation\n- ✅ **No Backend Knowledge** - SDK handles routing automatically\n- ✅ **Error Handling** - Automatic fallback if needed\n- ✅ **Single API** - Use same method for all tokens\n\n**When to Use Each Method:**\n\n| Method | Use Case | Token Status |\n|--------|----------|--------------|\n| `fetchTokenPrice({ tokenId })` | Smart routing (recommended) | Any (DEX or Launchpad) |\n| `fetchTokenPrice({ tokenName })` | Token name pricing | Any |\n| `isTokenGraduated(name)` | Check token status | Any |\n\n**Key Differences:**\n\n**Ungraduated Tokens (Launchpad):**\n- Priced on exponential bonding curve\n- Token name parameter works: `fetchTokenPrice({ tokenName: 'anime' })`\n- Price affected by supply/demand\n\n**Graduated Tokens (DEX):**\n- Priced on DEX via order books\n- Token ID format needed: `Token|Unit|SYMBOL|eth:0x...`\n- Market-driven pricing\n\n**Graduation Impact:**\nWhen a token graduates from launchpad to DEX:\n- Bonding curve closes\n- Trading moves to DEX order books\n- Smart routing automatically switches backends\n- Old launchpad queries will fail (use DEX pricing instead)\n\n**Error Handling:**\n```typescript\nasync function safePriceQuery(tokenId: string) {\n  try {\n    // Always try smart routing first\n    return await sdk.fetchTokenPrice({ tokenId });\n  } catch (error) {\n    if (error.message.includes('not found')) {\n      console.log('Token not available on DEX');\n      // Could try fallback to launchpad pricing here\n    }\n    throw error;\n  }\n}\n```\n\n**MCP Tool Equivalents:**\n- `gala_launchpad_fetch_token_spot_price` - Smart routing\n- `gala_launchpad_fetch_launchpad_token_spot_price` - Launchpad-only\n- `gala_launchpad_is_token_graduated` - Check graduation status\n"
-        },
-        {
-          "userQuestion": "What parameters does fetchTokenPrice() accept?",
-          "assistantResponse": "The primary methods for Spot prices smart routing are `fetchTokenPrice()`, `getSwapPoolPrice()`. Each method accepts configuration options as a single object parameter.\n\n**Common Parameters:**\n- `tokenName`: The token identifier (e.g., 'dragnrkti')\n- `amount`: Quantity as a string (for precision)\n- Wallet/auth options when transactions are involved\n\nCheck the SDK documentation or use TypeScript intellisense for the complete parameter interface."
-        },
-        {
-          "userQuestion": "What are best practices for get token prices with smart routing?",
-          "assistantResponse": "1. **Use TypeScript**: Get full type safety and intellisense.\n2. **Handle errors**: Always wrap SDK calls in try-catch blocks.\n3. **Validate inputs**: Check parameters before making API calls.\n4. **Cache when appropriate**: Reduce API calls for static data."
-        },
-        {
-          "userQuestion": "What should I learn next after get token prices with smart routing?",
-          "assistantResponse": "**Related Topics:**\n\n- Check the SDK documentation for related functionality\n\n**Learning Path:** Start with the basics, then explore related topics to build a complete understanding of the SDK capabilities."
-        },
-        {
-          "userQuestion": "Any final tips for get token prices with smart routing?",
-          "assistantResponse": "**Quick Tips:**\n\n1. **Start Simple**: Begin with the basic use case before exploring advanced features\n2. **Use TypeScript**: The SDK has full TypeScript support for better autocomplete and type safety\n3. **Check the Demos**: The examples/ directory has working demos for most SDK features\n4. **Read Error Messages**: SDK errors include helpful context for troubleshooting\n\nYou're ready to start building with this feature!"
-        }
-      ]
-    },
-    {
-      "topicKey": "token-creation",
-      "label": "Token creation",
-      "category": "utils",
-      "description": "SDK configuration and helpers",
-      "methodCount": 5,
-      "exchanges": [
-        {
-          "userQuestion": "How do I create and launch new tokens?",
-          "assistantResponse": "\n## Creating Tokens with SDK\n\n**Covers Methods:**\n- `isTokenNameAvailable()`\n- `isTokenSymbolAvailable()`\n- `fetchLaunchTokenFee()`\n- `uploadTokenImage()`\n- `launchToken()`\n\n```typescript\nimport { createLaunchpadSDK } from '@gala-chain/launchpad-sdk';\n\nasync function launchToken() {\n  const sdk = createLaunchpadSDK({\n    wallet: 'your-private-key'\n  });\n\n  // 1. Check if name/symbol available\n  const nameAvailable = await sdk.isTokenNameAvailable('mytoken');\n  const symbolAvailable = await sdk.isTokenSymbolAvailable('MTK');\n\n  if (!nameAvailable || !symbolAvailable) {\n    throw new Error('Name or symbol already taken');\n  }\n\n  // 2. Check launch fee\n  const launchFee = await sdk.fetchLaunchTokenFee();\n  console.log(`Launch fee: ${launchFee} GALA`);\n\n  // 3. Upload token image (Node.js only)\n  const imageUpload = await sdk.uploadTokenImage({\n    tokenName: 'mytoken',\n    imagePath: '/path/to/image.png'\n  });\n\n  // 4. Launch the token\n  const result = await sdk.launchToken({\n    tokenName: 'mytoken',\n    tokenSymbol: 'MTK',\n    tokenDescription: 'My awesome token',\n    tokenImage: imageUpload.imageUrl,\n    websiteUrl: 'https://mytoken.com',\n    twitterUrl: 'https://twitter.com/mytoken',\n    preBuyQuantity: '100'  // Optional: pre-buy with GALA\n  });\n\n  console.log('Token launched!');\n  console.log('Transaction ID:', result.transactionId);\n\n  // Get frontend URL\n  const url = sdk.getUrlByTokenName('mytoken');\n  console.log(`View at: ${url}`);\n}\n```\n\n**MCP Tool Equivalents:**\n- `gala_launchpad_check_token_name`\n- `gala_launchpad_check_token_symbol`\n- `gala_launchpad_fetch_launch_token_fee`\n- `gala_launchpad_upload_token_image`\n- `gala_launchpad_launch_token`\n- `gala_launchpad_get_url_by_token_name`\n"
-        },
-        {
-          "userQuestion": "What parameters does isTokenNameAvailable() accept?",
-          "assistantResponse": "The primary methods for Token creation are `isTokenNameAvailable()`, `isTokenSymbolAvailable()`, `fetchLaunchTokenFee()`. Each method accepts configuration options as a single object parameter.\n\n**Common Parameters:**\n- `tokenName`: The token identifier (e.g., 'dragnrkti')\n- `amount`: Quantity as a string (for precision)\n- Wallet/auth options when transactions are involved\n\nCheck the SDK documentation or use TypeScript intellisense for the complete parameter interface."
-        },
-        {
-          "userQuestion": "What are best practices for create and launch new tokens?",
-          "assistantResponse": "1. **Check availability**: Verify token name and symbol are available first.\n2. **Upload image first**: Use `uploadTokenImage()` before `launchToken()`.\n3. **Review fees**: Check launch fees with `fetchLaunchTokenFee()`."
-        },
-        {
-          "userQuestion": "What errors should I handle when create and launch new tokens?",
-          "assistantResponse": "**Common Errors:**\n- `TokenNameTaken`: Name already exists - check availability first\n- `SymbolTaken`: Symbol in use - verify with `isTokenSymbolAvailable()`\n- `InsufficientLaunchFee`: Check fee with `fetchLaunchTokenFee()`\n\n**Important:** Token creation is irreversible!"
-        },
-        {
-          "userQuestion": "Can you walk me through a complete create and launch new tokens example?",
-          "assistantResponse": "**Complete Workflow: Token creation**\n\nHere's the typical flow: `isTokenNameAvailable()` → `isTokenSymbolAvailable()` → `fetchLaunchTokenFee()`\n\n**Step-by-Step:**\n1. **Setup**: Initialize SDK with your configuration\n2. **Validate**: Check prerequisites (balances, permissions)\n3. **Calculate**: Use calculation methods to preview results\n4. **Execute**: Perform the main operation\n5. **Verify**: Confirm the operation succeeded\n\n**Pro Tip:** The SDK methods are designed to be called in sequence. Each step provides data needed for the next."
-        },
-        {
-          "userQuestion": "What edge cases should I know about for create and launch new tokens?",
-          "assistantResponse": "**Edge Cases:**\n1. **Image requirements**: JPEG/PNG, reasonable size\n2. **Name restrictions**: Alphanumeric only, 3-20 chars\n3. **Symbol format**: Uppercase, 1-8 chars\n\n**Gotcha:** Once created, tokens cannot be renamed or have their symbol changed!"
-        },
-        {
-          "userQuestion": "What other methods are available for Token creation?",
-          "assistantResponse": "**Additional Methods:**\n\n- `uploadTokenImage()`\n- `launchToken()`\n\n**Total methods in this topic:** 5\n\nEach method serves a specific purpose in the workflow. Use TypeScript intellisense or the SDK documentation to explore parameter options for each method."
-        },
-        {
-          "userQuestion": "When would I actually use create and launch new tokens in a real application?",
-          "assistantResponse": "**Real-World Use Cases:**\n\n1. **Community Tokens**: Launch tokens for DAOs or communities\n2. **Gaming Tokens**: Create in-game currencies or assets\n3. **Creator Coins**: Personal tokens for content creators\n4. **Project Tokens**: Utility tokens for new projects"
-        },
-        {
-          "userQuestion": "What should I learn next after create and launch new tokens?",
-          "assistantResponse": "**Related Topics:**\n\n- **Token details**: `explainSdkUsage({ topic: 'token-details' })`\n- **Fetch pools**: `explainSdkUsage({ topic: 'fetch-pools' })`\n- **Streaming**: `explainSdkUsage({ topic: 'streaming' })`\n\n**Learning Path:** Start with the basics, then explore related topics to build a complete understanding of the SDK capabilities."
-        }
-      ]
-    },
-    {
-      "topicKey": "token-status",
-      "label": "Token status",
-      "category": "utils",
-      "description": "SDK configuration and helpers",
-      "methodCount": 3,
-      "exchanges": [
-        {
-          "userQuestion": "How do I check token pool status?",
-          "assistantResponse": "\n## Token Status and Event Monitoring\n\n**Covers Methods:**\n- `isTokenGraduated()`\n- `onDexPoolCreation()`\n- `onLaunchpadTokenCreation()`\n\nCheck token graduation status and monitor real-time token/pool creation events.\n\n```typescript\nimport { createLaunchpadSDK } from '@gala-chain/launchpad-sdk';\n\nasync function monitorTokenStatus() {\n  const sdk = createLaunchpadSDK({ wallet: 'your-private-key' });\n\n  // ============================================================================\n  // CHECK GRADUATION STATUS - Determine if token is on DEX or bonding curve\n  // ============================================================================\n\n  // Check if token has graduated from bonding curve to DEX\n  const isGraduated = await sdk.isTokenGraduated('anime');\n\n  if (isGraduated) {\n    console.log('Token has graduated to DEX - trade via GalaSwap');\n    // Use DEX trading methods: executeSwap(), getSwapQuoteExactInput(), etc.\n  } else {\n    console.log('Token on bonding curve - trade via launchpad');\n    // Use bonding curve methods: buy(), sell(), calculateBuyAmount(), etc.\n  }\n\n  // ============================================================================\n  // MONITOR DEX POOL CREATION - Real-time notifications\n  // ============================================================================\n\n  // Set up listener for new DEX pools\n  const cleanupDexPool = sdk.onDexPoolCreation((poolData) => {\n    console.log('New DEX pool created!');\n    console.log(`  Token: ${poolData.tokenName}`);\n    console.log(`  Token0: ${poolData.token0}`);\n    console.log(`  Token1: ${poolData.token1}`);\n    console.log(`  Fee Tier: ${poolData.feeTier}`);\n    console.log(`  Initial TVL: ${poolData.tvl}`);\n\n    // Take action on new pool\n    // Example: Automatically provide liquidity or execute arbitrage\n  });\n\n  // ============================================================================\n  // MONITOR TOKEN LAUNCHES - Real-time notifications\n  // ============================================================================\n\n  // Set up listener for new token launches\n  const cleanupTokenCreation = sdk.onLaunchpadTokenCreation((tokenData) => {\n    console.log('New token launched!');\n    console.log(`  Name: ${tokenData.tokenName}`);\n    console.log(`  Symbol: ${tokenData.tokenSymbol}`);\n    console.log(`  Creator: ${tokenData.creator}`);\n    console.log(`  Max Supply: ${tokenData.maxSupply}`);\n    console.log(`  Base Price: ${tokenData.basePrice}`);\n\n    // Take action on new token\n    // Example: Automatically buy early or analyze opportunity\n  });\n\n  // ============================================================================\n  // COMPLETE WORKFLOW: Monitoring + Trading\n  // ============================================================================\n\n  async function autoTrade() {\n    // Monitor new tokens\n    sdk.onLaunchpadTokenCreation(async (token) => {\n      console.log(`New token: ${token.tokenName}`);\n\n      // Wait for graduation\n      const checkGraduation = setInterval(async () => {\n        const graduated = await sdk.isTokenGraduated(token.tokenName);\n\n        if (graduated) {\n          clearInterval(checkGraduation);\n          console.log(`${token.tokenName} graduated! Switching to DEX trading.`);\n\n          // Now use DEX methods instead of bonding curve\n          const quote = await sdk.getSwapQuoteExactInput('GALA', token.tokenName, '100');\n          console.log(`DEX quote: ${quote.estimatedOutput}`);\n        }\n      }, 60000); // Check every minute\n    });\n\n    // Monitor new DEX pools\n    sdk.onDexPoolCreation(async (pool) => {\n      console.log(`New pool: ${pool.tokenName}`);\n\n      // Analyze liquidity opportunity\n      const poolInfo = await sdk.getSwapPoolInfo(pool.token0, pool.token1);\n      console.log(`Pool liquidity: ${poolInfo.liquidity}`);\n    });\n  }\n\n  // Keep process running\n  console.log('Monitoring events... Press Ctrl+C to stop');\n  await new Promise(() => {}); // Run forever\n\n  // Cleanup when done\n  cleanupDexPool();\n  cleanupTokenCreation();\n}\n```\n\n**Use Cases:**\n- **Arbitrage Bots**: Detect graduation events and switch trading strategies\n- **Early Bird Trading**: Monitor new token launches and trade immediately\n- **Liquidity Provision**: Detect new DEX pools and provide liquidity\n- **Portfolio Automation**: Automatically adjust positions on graduation\n- **Price Discovery**: Track token lifecycle from launch to DEX\n\n**Event Data:**\n- **DEX Pool Creation**: tokenName, token0, token1, feeTier, tvl, timestamp\n- **Token Launch**: tokenName, tokenSymbol, creator, maxSupply, basePrice, timestamp\n\n**MCP Tool Equivalents:**\n- `gala_launchpad_is_token_graduated`\n- `gala_launchpad_on_dex_pool_creation` (WebSocket event)\n- `gala_launchpad_on_launchpad_token_creation` (WebSocket event)\n"
-        },
-        {
-          "userQuestion": "What parameters does isTokenGraduated() accept?",
-          "assistantResponse": "The primary methods for Token status are `isTokenGraduated()`, `onDexPoolCreation()`, `onLaunchpadTokenCreation()`. Each method accepts configuration options as a single object parameter.\n\n**Common Parameters:**\n- `tokenName`: The token identifier (e.g., 'dragnrkti')\n- `amount`: Quantity as a string (for precision)\n- Wallet/auth options when transactions are involved\n\nCheck the SDK documentation or use TypeScript intellisense for the complete parameter interface."
-        },
-        {
-          "userQuestion": "What are best practices for check token pool status?",
-          "assistantResponse": "1. **Use TypeScript**: Get full type safety and intellisense.\n2. **Handle errors**: Always wrap SDK calls in try-catch blocks.\n3. **Validate inputs**: Check parameters before making API calls.\n4. **Cache when appropriate**: Reduce API calls for static data."
-        },
-        {
-          "userQuestion": "Can you walk me through a complete check token pool status example?",
-          "assistantResponse": "**Complete Workflow: Token status**\n\nHere's the typical flow: `isTokenGraduated()` → `onDexPoolCreation()` → `onLaunchpadTokenCreation()`\n\n**Step-by-Step:**\n1. **Setup**: Initialize SDK with your configuration\n2. **Validate**: Check prerequisites (balances, permissions)\n3. **Calculate**: Use calculation methods to preview results\n4. **Execute**: Perform the main operation\n5. **Verify**: Confirm the operation succeeded\n\n**Pro Tip:** The SDK methods are designed to be called in sequence. Each step provides data needed for the next."
-        },
-        {
-          "userQuestion": "What should I learn next after check token pool status?",
-          "assistantResponse": "**Related Topics:**\n\n- Check the SDK documentation for related functionality\n\n**Learning Path:** Start with the basics, then explore related topics to build a complete understanding of the SDK capabilities."
-        }
-      ]
-    },
-    {
-      "topicKey": "utilities-and-helpers",
-      "label": "Utilities and helpers",
-      "category": "utils",
-      "description": "SDK configuration and helpers",
-      "methodCount": 10,
-      "exchanges": [
-        {
-          "userQuestion": "How do I use SDK utilities and helpers?",
-          "assistantResponse": "\n## Utility Methods and Helpers\n\n**Covers Methods:**\n- `fetchGalaPrice()`\n- `fetchTokenClassesWithSupply()`\n- `calculateInitialBuyAmount()`\n- `getBundlerTransactionResult()`\n- `getSwapPoolPrice()`\n- `fetchSwapPositionDirect()`\n- `getAllSwapUserAssets()`\n- `cleanup()`\n\nEssential helper methods for development, debugging, and special use cases.\n\n### Price & Supply Queries\n\n```typescript\n// Get current GALA price in USD\nconst galaPrice = await sdk.fetchGalaPrice();\nconsole.log(`GALA: $${galaPrice}`);\n\n// Get token supply metrics from GalaChain\nconst supplies = await sdk.fetchTokenClassesWithSupply();\nsupplies.forEach(token => {\n  console.log(`${token.tokenClass}: ${token.totalSupply}`);\n});\n```\n\n### Transaction Monitoring\n\n```typescript\n// Check transaction status\nconst status = await sdk.getBundlerTransactionResult('tx-id-123');\nconsole.log('Status:', status.status); // 'pending' | 'success' | 'failed'\n```\n\n### Advanced Swap Queries\n\n```typescript\n// Get pool price without full quote\nconst price = await sdk.getSwapPoolPrice('GALA|Unit|none|none', 'GUSDC|Unit|none|none');\nconsole.log(`Pool price: ${price}`);\n\n// Auto-paginated asset fetch\nconst allAssets = await sdk.getAllSwapUserAssets('eth|0x...', { limit: 100 });\nconsole.log(`Total assets: ${allAssets.length}`);\n\n// Direct position lookup (if you have compound key)\nconst position = await sdk.fetchSwapPositionDirect({\n  owner: 'eth|0x...',\n  token0: 'GALA|Unit|none|none',\n  token1: 'GUSDC|Unit|none|none',\n  feeTier: 3000\n});\n```\n\n### Launch Calculations\n\n```typescript\n// Calculate initial buy amount for token launch\nconst buyAmount = await sdk.calculateInitialBuyAmount('100');\nconsole.log(`Initial buy: ${buyAmount} tokens`);\n```\n\n### SDK Cleanup\n\n```typescript\n// Proper cleanup when done (closes connections)\nawait sdk.cleanup();\n```\n\n### Monitor Bundler Transactions\n\n```typescript\n// After a trade, monitor transaction status\nconst tradeResult = await sdk.buy({ tokenName, amount, type: 'native', expectedAmount, slippageToleranceFactor: 0.01 });\n\n// Poll for completion\nconst status = await sdk.getBundlerTransactionResult(tradeResult.transactionId);\nconsole.log('Status:', status.status); // PENDING, PROCESSING, COMPLETED, FAILED\n\n// Wait with polling\nlet attempts = 0;\nwhile (status.status === 'PENDING' || status.status === 'PROCESSING') {\n  await new Promise(r => setTimeout(r, 2000));\n  const updated = await sdk.getBundlerTransactionResult(tradeResult.transactionId);\n  if (updated.status === 'COMPLETED') break;\n  if (++attempts > 30) throw new Error('Transaction timeout');\n}\n```\n\n**MCP Tools:**\n- `gala_launchpad_fetch_gala_price`\n- `gala_launchpad_fetch_token_classes_with_supply`\n- `gala_launchpad_calculate_initial_buy_amount`\n- `gala_launchpad_get_bundler_transaction_result`\n- `gala_launchpad_get_swap_pool_price`\n- `gala_launchpad_fetch_swap_position_direct`\n- `gala_launchpad_get_all_swap_user_assets`\n"
-        },
-        {
-          "userQuestion": "What parameters does fetchGalaPrice() accept?",
-          "assistantResponse": "The primary methods for Utilities and helpers are `fetchGalaPrice()`, `fetchTokenClassesWithSupply()`, `calculateInitialBuyAmount()`. Each method accepts configuration options as a single object parameter.\n\n**Common Parameters:**\n- `tokenName`: The token identifier (e.g., 'dragnrkti')\n- `amount`: Quantity as a string (for precision)\n- Wallet/auth options when transactions are involved\n\nCheck the SDK documentation or use TypeScript intellisense for the complete parameter interface."
-        },
-        {
-          "userQuestion": "What are best practices for use SDK utilities and helpers?",
-          "assistantResponse": "1. **Use TypeScript**: Get full type safety and intellisense.\n2. **Handle errors**: Always wrap SDK calls in try-catch blocks.\n3. **Validate inputs**: Check parameters before making API calls.\n4. **Cache when appropriate**: Reduce API calls for static data."
-        },
-        {
-          "userQuestion": "Can you walk me through a complete use SDK utilities and helpers example?",
-          "assistantResponse": "**Complete Workflow: Utilities and helpers**\n\nHere's the typical flow: `fetchGalaPrice()` → `fetchTokenClassesWithSupply()` → `calculateInitialBuyAmount()`\n\n**Step-by-Step:**\n1. **Setup**: Initialize SDK with your configuration\n2. **Validate**: Check prerequisites (balances, permissions)\n3. **Calculate**: Use calculation methods to preview results\n4. **Execute**: Perform the main operation\n5. **Verify**: Confirm the operation succeeded\n\n**Pro Tip:** The SDK methods are designed to be called in sequence. Each step provides data needed for the next."
-        },
-        {
-          "userQuestion": "What other methods are available for Utilities and helpers?",
-          "assistantResponse": "**Additional Methods:**\n\n- `getBundlerTransactionResult()`\n- `getSwapPoolPrice()`\n- `fetchSwapPositionDirect()`\n- `getAllSwapUserAssets()`\n\n**Total methods in this topic:** 10\n\nEach method serves a specific purpose in the workflow. Use TypeScript intellisense or the SDK documentation to explore parameter options for each method."
-        },
-        {
-          "userQuestion": "What should I learn next after use SDK utilities and helpers?",
-          "assistantResponse": "**Related Topics:**\n\n- **Utilities system**: `explainSdkUsage({ topic: 'utilities-system' })`\n- **Balances**: `explainSdkUsage({ topic: 'balances' })`\n- **Fetch pools**: `explainSdkUsage({ topic: 'fetch-pools' })`\n\n**Learning Path:** Start with the basics, then explore related topics to build a complete understanding of the SDK capabilities."
-        },
-        {
-          "userQuestion": "Are there any advanced patterns for this topic?",
-          "assistantResponse": "**Advanced Patterns:**\n\n1. **Batching**: Combine multiple operations for efficiency\n2. **Caching**: Cache frequently-accessed data locally\n3. **Event-Driven**: Use subscriptions for real-time updates\n4. **Error Recovery**: Implement retry logic with exponential backoff\n5. **Monitoring**: Track operation success rates and latencies\n\n**Performance Tip:** For high-volume operations, consider using the local calculation methods where available to reduce network calls."
-        }
-      ]
-    },
-    {
-      "topicKey": "utilities-system",
-      "label": "Utilities system",
-      "category": "wallet",
-      "description": "Wallet creation and key derivation",
-      "methodCount": 11,
-      "exchanges": [
-        {
-          "userQuestion": "How do I access system utilities?",
-          "assistantResponse": "\n## SDK Configuration and Wallet Utilities\n\n**Covers Methods:**\n- `getAddress()`\n- `getConfig()`\n- `getEthereumAddress()`\n- `getUrlByTokenName()`\n- `getVersion()`\n- `getWallet()`\n- `hasWallet()`\n- `setWallet()`\n\nEssential utilities for SDK configuration, wallet management, and system information.\n\n```typescript\nimport { createLaunchpadSDK } from '@gala-chain/launchpad-sdk';\n\nasync function sdkUtilities() {\n  // ============================================================================\n  // ADDRESS MANAGEMENT - Get wallet addresses in different formats\n  // ============================================================================\n\n  const sdk = createLaunchpadSDK({ wallet: 'your-private-key' });\n\n  // Get GalaChain address (eth|0x... format)\n  const galaAddress = sdk.getAddress();\n  console.log(`GalaChain address: ${galaAddress}`); // \"eth|0x1234...\"\n\n  // Get Ethereum address (0x... format)\n  const ethAddress = sdk.getEthereumAddress();\n  console.log(`Ethereum address: ${ethAddress}`); // \"0x1234...\"\n\n  // ============================================================================\n  // WALLET MANAGEMENT - Check and update wallet\n  // ============================================================================\n\n  // Check if SDK has wallet configured\n  if (sdk.hasWallet()) {\n    console.log('Wallet configured - can execute trades');\n\n    // Get wallet instance (for advanced use)\n    const wallet = sdk.getWallet();\n    console.log(`Wallet address: ${wallet.address}`);\n  } else {\n    console.log('Read-only mode - cannot execute trades');\n  }\n\n  // Update wallet at runtime\n  sdk.setWallet('new-private-key');\n  console.log(`New address: ${sdk.getAddress()}`);\n\n  // ============================================================================\n  // CONFIGURATION ACCESS - Get SDK config\n  // ============================================================================\n\n  // Get SDK configuration\n  const config = sdk.getConfig();\n  console.log(`Base URL: ${config.baseUrl}`);\n  console.log(`Environment: ${config.env}`);\n  console.log(`Debug: ${config.debug}`);\n  console.log(`Timeout: ${config.timeout}ms`);\n\n  // ============================================================================\n  // VERSION INFORMATION - Get SDK version\n  // ============================================================================\n\n  // Get SDK version\n  const version = sdk.getVersion();\n  console.log(`SDK Version: ${version}`); // \"4.0.4-beta.0\"\n\n  // ============================================================================\n  // URL GENERATION - Get frontend URLs for tokens\n  // ============================================================================\n\n  // Generate frontend URL for token\n  const url = sdk.getUrlByTokenName('anime');\n  console.log(`Token URL: ${url}`);\n  // \"https://launchpad.gala.com/token/anime\" (production)\n  // \"https://lpad-dev1.defi.gala.com/token/anime\" (development)\n\n  // Complete workflow: Launch token + share URL\n  const launchResult = await sdk.launchToken({\n    tokenName: 'mytoken',\n    tokenSymbol: 'MTK',\n    tokenDescription: 'My awesome token'\n  });\n\n  const tokenUrl = sdk.getUrlByTokenName('mytoken');\n  console.log(`Share your token: ${tokenUrl}`);\n\n  // ============================================================================\n  // MULTI-WALLET SCENARIO - Check multiple addresses\n  // ============================================================================\n\n  async function compareWallets() {\n    const wallet1 = createLaunchpadSDK({ wallet: 'private-key-1' });\n    const wallet2 = createLaunchpadSDK({ wallet: 'private-key-2' });\n\n    console.log(`Wallet 1: ${wallet1.getAddress()}`);\n    console.log(`Wallet 2: ${wallet2.getAddress()}`);\n\n    // Compare balances\n    const balance1 = await wallet1.fetchGalaBalance();\n    const balance2 = await wallet2.fetchGalaBalance();\n\n    console.log(`Wallet 1 balance: ${balance1.balance}`);\n    console.log(`Wallet 2 balance: ${balance2.balance}`);\n  }\n\n  // ============================================================================\n  // READ-ONLY SDK - Public data without wallet\n  // ============================================================================\n\n  async function readOnlyMode() {\n    // Create SDK without wallet (read-only mode)\n    const readOnlySdk = createLaunchpadSDK();\n\n    console.log(`Has wallet: ${readOnlySdk.hasWallet()}`); // false\n\n    // Can fetch public data\n    const pools = await readOnlySdk.fetchPools({ type: 'recent', limit: 10 });\n    console.log(`Found ${pools.total} pools`);\n\n    // Cannot execute trades (will throw error)\n    try {\n      await readOnlySdk.buy({ tokenName: 'anime', amount: '100', type: 'native' });\n    } catch (error) {\n      console.error('Cannot trade without wallet');\n    }\n  }\n\n  // ============================================================================\n  // ENVIRONMENT SWITCHING - Change environments at runtime\n  // ============================================================================\n\n  async function switchEnvironments() {\n    // Production SDK\n    const prodSdk = createLaunchpadSDK({\n      wallet: 'your-private-key',\n      config: { env: 'production' }\n    });\n\n    console.log(`Prod config: ${prodSdk.getConfig().baseUrl}`);\n    console.log(`Prod URL: ${prodSdk.getUrlByTokenName('anime')}`);\n\n    // Development SDK\n    const devSdk = createLaunchpadSDK({\n      wallet: 'your-private-key',\n      config: { env: 'development' }\n    });\n\n    console.log(`Dev config: ${devSdk.getConfig().baseUrl}`);\n    console.log(`Dev URL: ${devSdk.getUrlByTokenName('anime')}`);\n  }\n}\n```\n\n**Key Methods:**\n\n| Method | Returns | Use Case |\n|--------|---------|----------|\n| `getAddress()` | GalaChain address (eth|0x...) | Trading, transfers, profile |\n| `getEthereumAddress()` | Ethereum address (0x...) | DEX trading, external systems |\n| `getConfig()` | SDK configuration object | Debug, environment info |\n| `getVersion()` | SDK version string | Compatibility checks |\n| `getUrlByTokenName()` | Frontend URL | Share token pages |\n| `getWallet()` | Wallet instance | Advanced wallet operations |\n| `hasWallet()` | Boolean | Check if trades enabled |\n| `setWallet()` | void | Update wallet at runtime |\n\n**MCP Tool Equivalents:**\n- `gala_launchpad_get_address`\n- `gala_launchpad_get_ethereum_address`\n- `gala_launchpad_get_config`\n- `gala_launchpad_get_version`\n- `gala_launchpad_get_url_by_token_name`\n"
-        },
-        {
-          "userQuestion": "What parameters does getAddress() accept?",
-          "assistantResponse": "The primary methods for Utilities system are `getAddress()`, `getConfig()`, `getEthereumAddress()`. Each method accepts configuration options as a single object parameter.\n\n**Common Parameters:**\n- `tokenName`: The token identifier (e.g., 'dragnrkti')\n- `amount`: Quantity as a string (for precision)\n- Wallet/auth options when transactions are involved\n\nCheck the SDK documentation or use TypeScript intellisense for the complete parameter interface."
-        },
-        {
-          "userQuestion": "What are best practices for access system utilities?",
-          "assistantResponse": "1. **Use TypeScript**: Get full type safety and intellisense.\n2. **Handle errors**: Always wrap SDK calls in try-catch blocks.\n3. **Validate inputs**: Check parameters before making API calls.\n4. **Cache when appropriate**: Reduce API calls for static data."
-        },
-        {
-          "userQuestion": "Can you walk me through a complete access system utilities example?",
-          "assistantResponse": "**Complete Workflow: Utilities system**\n\nHere's the typical flow: `getAddress()` → `getConfig()` → `getEthereumAddress()`\n\n**Step-by-Step:**\n1. **Setup**: Initialize SDK with your configuration\n2. **Validate**: Check prerequisites (balances, permissions)\n3. **Calculate**: Use calculation methods to preview results\n4. **Execute**: Perform the main operation\n5. **Verify**: Confirm the operation succeeded\n\n**Pro Tip:** The SDK methods are designed to be called in sequence. Each step provides data needed for the next."
-        },
-        {
-          "userQuestion": "What other methods are available for Utilities system?",
-          "assistantResponse": "**Additional Methods:**\n\n- `getUrlByTokenName()`\n- `getVersion()`\n- `getWallet()`\n- `hasWallet()`\n\n**Total methods in this topic:** 11\n\nEach method serves a specific purpose in the workflow. Use TypeScript intellisense or the SDK documentation to explore parameter options for each method."
-        },
-        {
-          "userQuestion": "What should I learn next after access system utilities?",
-          "assistantResponse": "**Related Topics:**\n\n- **Utilities and helpers**: `explainSdkUsage({ topic: 'utilities-and-helpers' })`\n- **Session auth**: `explainSdkUsage({ topic: 'session-auth' })`\n- **Profile management**: `explainSdkUsage({ topic: 'profile-management' })`\n\n**Learning Path:** Start with the basics, then explore related topics to build a complete understanding of the SDK capabilities."
-        },
-        {
-          "userQuestion": "Are there any advanced patterns for this topic?",
-          "assistantResponse": "**Advanced Patterns:**\n\n1. **Batching**: Combine multiple operations for efficiency\n2. **Caching**: Cache frequently-accessed data locally\n3. **Event-Driven**: Use subscriptions for real-time updates\n4. **Error Recovery**: Implement retry logic with exponential backoff\n5. **Monitoring**: Track operation success rates and latencies\n\n**Performance Tip:** For high-volume operations, consider using the local calculation methods where available to reduce network calls."
-        }
-      ]
-    }
-  ]
-}