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

package/dist/tools/utils/explainSdkUsage.js

@@ -34,14 +34,14 @@ exports.TOPIC_METHOD_MAPPING = {
     'token-distribution': ['fetchTokenDistribution', 'fetchUserHolderContext'],
     'token-status': ['isTokenGraduated', 'onDexPoolCreation', 'onLaunchpadTokenCreation'],
     // Portfolio Management
-    'multi-wallet': [], // Composite workflow topic
+    'multi-wallet': ['getAddress'], // Composite workflow topic
     'transfers': ['transferGala', 'transferToken'],
     'locks': ['lockTokens', 'unlockTokens', 'burnTokens', 'fetchLockedBalance'],
     // DEX Trading
     'dex-trading': ['getSwapQuoteExactInput', 'getSwapQuoteExactOutput', 'executeSwap', 'getSwapUserAssets', 'getAllSwapUserAssets', 'getSwapPoolInfo'],
-    'error-handling': [], // Cross-cutting concern
+    'error-handling': ['getBundlerTransactionResult'], // Cross-cutting concern
     // Developer Tools
-    'installation': [], // Setup topic
+    'installation': ['getVersion'], // Setup topic
     'local-calculations': ['calculateBuyAmountLocal', 'calculateSellAmountLocal', 'calculateBuyAmountExternal', 'calculateSellAmountExternal', 'calculateInitialBuyAmount'],
     // Market Data
     'price-history': ['fetchPriceHistory', 'fetchAllPriceHistory'],
@@ -65,7 +65,7 @@ exports.TOPIC_METHOD_MAPPING = {
     // Event Subscriptions
     'event-subscriptions': ['subscribeToStream', 'unsubscribeFromStream', 'onStreamStatusChanged', 'onUserBanned', 'onUserUnbanned', 'onBanEnforcement', 'onContentFlagged', 'onFlagResolved', 'onStreamChatMessage', 'onStreamChatUpdated', 'onStreamChatDeleted', 'onStreamChatPinned', 'onStreamChatUnpinned', 'onChatStatusChanged', 'onViewerCountChanged', 'onRecordingStatusChanged', 'onSimulcastStatusChanged', 'onDownloadReady', 'onUserTyping', 'onStreamReaction', 'onContentReactionAdded', 'onContentReactionRemoved', 'onStreamCountdownUpdated', 'onStreamLanguageUpdated', 'onStreamControlStatusChanged', 'onConnection', 'onAuthenticated', 'onTokenSubscribed', 'onTokenUnsubscribed', 'onRoomSubscribed', 'onRoomLeft', 'onDexPoolCreation', 'onLaunchpadTokenCreation'],
     // MCP Integration
-    'mcp-to-sdk-mapping': [], // Composite workflow topic
+    'mcp-to-sdk-mapping': ['explainSdkUsage'], // Composite workflow topic
     // Bridge Operations
     'bridge-operations': [
         'estimateBridgeFee', 'bridgeOut', 'bridgeIn', 'getBridgeStatus',
@@ -113,7 +113,7 @@ exports.TOPIC_METHOD_MAPPING = {
     ],
     // Stream Chat
     'stream-chat': [
-        'getChatMessages', 'sendChatMessage', 'updateChatMessage', 'deleteChatMessage', 'getChatStatus', 'disableChat', 'enableChat',
+        'getChatStatus', 'disableChat', 'enableChat',
         'getGlobalChatStatus', 'setGlobalChatEnabled',
         'connectStreamWebSocket', 'authenticateStreamWebSocket', 'subscribeToStream',
         'unsubscribeFromStream', 'sendStreamChatViaWebSocket', 'sendStreamReaction', 'disconnectStreamWebSocket',
@@ -166,6 +166,14 @@ exports.TOPIC_METHOD_MAPPING = {
         'createNftTokenClass', 'fetchNftTokenClasses',
         'mintNft', 'fetchNftBalances'
     ],
+    // Token Identification & Format Concepts (v5.14.0+)
+    // These are conceptual topics that help AI understand token formats
+    'token-identification': [
+        'fetchPools', 'isTokenGraduated', 'resolveTokenClassKey', 'fetchTokenPrice'
+    ],
+    'graduation-detection': [
+        'isTokenGraduated', 'fetchPools', 'onDexPoolCreation', 'onLaunchpadTokenCreation'
+    ],
 };
 /**
  * Composite topics that don't map 1:1 to SDK methods
@@ -184,6 +192,8 @@ exports.COMPOSITE_TOPICS = new Set([
     'session-auth', 'streaming', 'stream-chat', 'ban-management', 'api-key-management',
     'moderator-invites', 'overseer-invites', 'content-flag-management', 'content-reactions', 'trade-history', 'token-ban-management',
     'nft-collection-management',
+    // Token Concepts (v5.14.0+)
+    'token-identification', 'graduation-detection',
 ]);
 /**
  * SDK code examples organized by topic
@@ -220,10 +230,6 @@ async function buyTokens() {
     type: 'native'      // 'native' = GALA amount, 'exact' = token amount
   });
 
-  console.log('Expected tokens:', calculation.amount);
-  console.log('RBC Fee:', calculation.reverseBondingCurveFee);
-  console.log('Transaction fee:', calculation.transactionFee);
-
   // 3. Execute buy with slippage protection
   const result = await sdk.buy({
     tokenName: 'dragnrkti',
@@ -234,10 +240,6 @@ async function buyTokens() {
     slippageToleranceFactor: 0.01  // 1% slippage tolerance (REQUIRED)
   });
 
-  console.log('Transaction ID:', result.transactionId);
-  console.log('GALA spent:', result.inputAmount);
-  console.log('Tokens received:', result.outputAmount);
-  console.log('Total fees:', result.totalFees);
 }
 \`\`\`
 
@@ -266,9 +268,6 @@ async function sellTokens() {
     type: 'exact'       // 'exact' = exact tokens, 'native' = target GALA amount
   });
 
-  console.log('Expected GALA:', calculation.amount);
-  console.log('RBC Fee:', calculation.reverseBondingCurveFee);
-
   // 3. Execute sell with slippage protection
   const result = await sdk.sell({
     tokenName: 'dragnrkti',
@@ -279,8 +278,6 @@ async function sellTokens() {
     slippageToleranceFactor: 0.01  // 1% slippage
   });
 
-  console.log('Tokens sold:', result.inputAmount);
-  console.log('GALA received:', result.outputAmount);
 }
 \`\`\`
 
@@ -304,10 +301,6 @@ async function graduatePool() {
   // Option 1: Calculate graduation cost first (recommended)
   const calculation = await sdk.calculateBuyAmountForGraduation('dragnrkti');
 
-  console.log('GALA cost to graduate:', calculation.amount);
-  console.log('RBC Fee:', calculation.reverseBondingCurveFee);
-  console.log('Transaction fee:', calculation.transactionFee);
-
   // Check if you have enough balance
   const balance = await sdk.fetchGalaBalance();
   // Use compareAmounts() instead of parseFloat for precision with currency amounts
@@ -321,10 +314,6 @@ async function graduatePool() {
     slippageToleranceFactor: 0.01  // Optional: defaults to SDK config
   });
 
-  console.log('Pool graduated!');
-  console.log('Transaction ID:', result.transactionId);
-  console.log('Total GALA spent:', result.inputAmount);
-  console.log('Tokens received:', result.outputAmount);
 }
 \`\`\`
 
@@ -367,9 +356,8 @@ async function basicPoolFetching() {
     page: 1
   });
 
-  console.log(\`Found \${pools.total} pools, page \${pools.page} of \${pools.totalPages}\`);
   pools.pools.forEach(pool => {
-    console.log(\`\${pool.tokenName}: \${pool.tokenSymbol}\`);
+
   });
 }
 
@@ -382,7 +370,6 @@ async function fetchAllPools() {
     type: 'recent'
   });
 
-  console.log(\`Total pools: \${allPools.pools.length}\`);
 }
 
 // 3. POOL DETAILS - Complete information
@@ -391,10 +378,6 @@ async function getPoolDetails(tokenName) {
 
   const details = await sdk.fetchPoolDetails(tokenName);
 
-  console.log('Sale status:', details.saleStatus); // 'Ongoing' or 'Completed'
-  console.log('Base price:', details.basePrice);
-  console.log('Max supply:', details.maxSupply);
-  console.log('Remaining tokens:', details.sellingTokenQuantity);
 }
 
 // 4. POOL DETAILS FOR CALCULATIONS - Optimized for math
@@ -404,10 +387,6 @@ async function getOptimizedPoolDetails(tokenName) {
   // Returns only fields needed for bonding curve calculations
   const poolData = await sdk.fetchPoolDetailsForCalculation(tokenName);
 
-  console.log('Current supply:', poolData.currentSupply);
-  console.log('Remaining tokens:', poolData.remainingTokens);
-  console.log('Max supply:', poolData.maxSupply);
-  console.log('Reverse bonding curve max fee:', poolData.reverseBondingCurveMaxFeeFactor);
 }
 
 // 5. VOLUME & OHLCV DATA - Historical candlestick data
@@ -423,7 +402,7 @@ async function getVolumeData(tokenName) {
   });
 
   volumeData.forEach(candle => {
-    console.log(\`\${candle.time}: O:\${candle.open} H:\${candle.high} L:\${candle.low} C:\${candle.close} V:\${candle.volume}\`);
+
   });
 }
 
@@ -434,9 +413,6 @@ async function getDexTokenPrices() {
   // Fetch prices for multiple DEX tokens
   const prices = await sdk.fetchTokenPrice(['GALA', 'SILK', 'MUSIC']);
 
-  console.log(\`GALA: $\${prices.GALA}\`);
-  console.log(\`SILK: $\${prices.SILK}\`);
-  console.log(\`MUSIC: $\${prices.MUSIC}\`);
 }
 
 // 7. LAUNCHPAD TOKEN SPOT PRICES (via smart router)
@@ -446,7 +422,6 @@ async function getLaunchpadTokenPrice(tokenName) {
   // Get USD spot price for a launchpad token (anime, woohoo, etc.)
   const price = await sdk.fetchTokenPrice({ tokenName });
 
-  console.log(\`\${tokenName} price: $\${price.price}\`);
 }
 
 // 8. RESOLVE UTILITY ADDRESSES
@@ -455,11 +430,10 @@ async function resolveAddresses(tokenName) {
 
   // Get GalaChain vault address for token
   const vaultAddress = await sdk.resolveVaultAddress(tokenName);
-  console.log(\`Vault address: \${vaultAddress}\`);
 
   // Get TokenClassKey for token
   const tokenClassKey = await sdk.resolveTokenClassKey(tokenName);
-  console.log(\`TokenClassKey: \${tokenClassKey}\`);
+
 }
 
 // 9. COMPLETE INVESTMENT ANALYSIS WORKFLOW
@@ -475,14 +449,11 @@ async function analyzeToken(tokenName) {
   ]);
 
   // Analyze status
-  console.log(\`Pool Status: \${details.saleStatus}\`);
-  console.log(\`Supply: \${details.currentSupply} / \${details.maxSupply}\`);
 
   // Analyze volume trend
   // Note: For analytics/aggregation, we use safeParseFloat for performance. For trades, use BigNumber via SDK
   const volumes = volumeData.map(v => safeParseFloat(v.volume, 0));
   const avgVolume = volumes.reduce((a, b) => a + b, 0) / volumes.length;
-  console.log(\`Avg daily volume: $\${toBigNumberFixed(avgVolume, 2)}\`);
 
   // Analyze distribution
   // Use compareAmounts for precise balance comparisons
@@ -490,10 +461,9 @@ async function analyzeToken(tokenName) {
     .sort((a, b) => compareAmounts(b.balance, a.balance) > 0 ? 1 : -1)
     .slice(0, 5)
     .reduce((sum, h) => sum + h.percentage, 0);
-  console.log(\`Top 5 holders: \${toBigNumberFixed(top5Ownership, 2)}%\`);
 
   // Check badges
-  console.log(\`Badges: \${badges.join(', ')}\`);
+
 }
 \`\`\`
 
@@ -530,9 +500,6 @@ async function checkBalances() {
 
   // Check GALA balance
   const galaBalance = await sdk.fetchGalaBalance();
-  console.log(\`GALA: \${galaBalance.balance}\`);
-  console.log(\`Decimals: \${galaBalance.decimals}\`);
-  console.log(\`Last updated: \${galaBalance.lastUpdated.toISOString()}\`);
 
   // Check specific token balance
   const tokenBalance = await sdk.fetchTokenBalance({
@@ -540,19 +507,14 @@ async function checkBalances() {
     address: sdk.getAddress()
   });
 
-  console.log(\`Token: \${tokenBalance.quantity}\`);
-  console.log(\`USD value: $\${tokenBalance.holdingPriceUsd}\`);
-  console.log(\`GALA value: \${tokenBalance.holdingPriceGala}\`);
-
   // Check all tokens held
   const portfolio = await sdk.fetchTokensHeld({
     address: sdk.getAddress(),
     limit: 20
   });
 
-  console.log(\`Holding \${portfolio.total} different tokens\`);
   portfolio.tokens.forEach(token => {
-    console.log(\`\${token.name}: \${token.quantity}\`);
+
   });
 
   // Check tokens created by this wallet
@@ -561,18 +523,16 @@ async function checkBalances() {
     limit: 10
   });
 
-  console.log(\`Created \${createdTokens.total} tokens\`);
   createdTokens.tokens.forEach(token => {
-    console.log(\`  \${token.symbol}: \${token.name}\`);
+
   });
 
   // Get user profile
   const profile = await sdk.fetchProfile();
-  console.log(\`Profile: \${profile.fullName}\`);
 
   // Check profile of another user
   const otherProfile = await sdk.fetchProfile('eth|0x...');
-  console.log(\`Other user: \${otherProfile.fullName}\`);
+
 }
 \`\`\`
 
@@ -600,8 +560,6 @@ const locked = await sdk.fetchLockedTokens({
   address: walletAddress
 });
 
-console.log('Available:', available.quantity);
-console.log('Locked:', locked.lockedQuantity);
 \`\`\`
 `,
     // ============================================================================
@@ -639,7 +597,6 @@ async function launchToken() {
 
   // 2. Check launch fee
   const launchFee = await sdk.fetchLaunchTokenFee();
-  console.log(\`Launch fee: \${launchFee} GALA\`);
 
   // 3. Upload token image (Node.js only)
   const imageUpload = await sdk.uploadTokenImage({
@@ -658,12 +615,9 @@ async function launchToken() {
     preBuyQuantity: '100'  // Optional: pre-buy with GALA
   });
 
-  console.log('Token launched!');
-  console.log('Transaction ID:', result.transactionId);
-
   // Get frontend URL
   const url = sdk.getUrlByTokenName('mytoken');
-  console.log(\`View at: \${url}\`);
+
 }
 \`\`\`
 
@@ -699,7 +653,6 @@ async function multiWalletExample() {
 
   // Create a test wallet
   const testWallet = createWallet();
-  console.log('Test wallet:', testWallet.address);
 
   // 1. Fund test wallet from main wallet
   await sdk.transferGala({
@@ -723,14 +676,10 @@ async function multiWalletExample() {
     privateKey: testWallet.privateKey  // Override to use test wallet
   });
 
-  console.log('Test wallet bought tokens');
-
   // 3. Check balances for both wallets
   const mainBalance = await sdk.fetchGalaBalance();  // Main wallet
   const testBalance = await sdk.fetchGalaBalance(testWallet.address);  // Test wallet
 
-  console.log(\`Main wallet: \${mainBalance.balance} GALA\`);
-  console.log(\`Test wallet: \${testBalance.balance} GALA\`);
 }
 \`\`\`
 
@@ -761,9 +710,6 @@ async function transferTokens() {
     uniqueKey: 'galaconnect-operation-my-transfer-123'  // Optional idempotency
   });
 
-  console.log('GALA transfer ID:', galaTransfer.transactionId);
-  console.log('Status:', galaTransfer.status);
-
   // Transfer launchpad tokens
   const tokenTransfer = await sdk.transferToken({
     to: 'eth|5678...',
@@ -772,7 +718,6 @@ async function transferTokens() {
     uniqueKey: 'galaconnect-operation-token-456'
   });
 
-  console.log('Token transfer ID:', tokenTransfer.transactionId);
 }
 \`\`\`
 
@@ -817,9 +762,6 @@ async function tokenLockingAndBurning() {
     }]
   });
 
-  console.log('Lock transaction ID:', lockResult.transactionId);
-  console.log('Locked entries:', lockResult.locked);
-
   // ============================================================================
   // LOCK TOKENS - Multiple tokens in one transaction (batch)
   // ============================================================================
@@ -833,8 +775,6 @@ async function tokenLockingAndBurning() {
     ]
   });
 
-  console.log('Batch lock completed:', batchLock.locked.length, 'tokens locked');
-
   // ============================================================================
   // LOCK TOKENS - Advanced options
   // ============================================================================
@@ -850,8 +790,6 @@ async function tokenLockingAndBurning() {
     }]
   });
 
-  console.log('Escrow lock created');
-
   // Lock for time-based vesting
   const vestingLock = await sdk.lockTokens({
     tokens: [{
@@ -862,8 +800,6 @@ async function tokenLockingAndBurning() {
     }]
   });
 
-  console.log('Vesting lock created with expiry');
-
   // ============================================================================
   // UNLOCK TOKENS - Release locked tokens
   // ============================================================================
@@ -876,9 +812,6 @@ async function tokenLockingAndBurning() {
     }]
   });
 
-  console.log('Unlock transaction ID:', unlockResult.transactionId);
-  console.log('Unlocked entries:', unlockResult.unlocked);
-
   // Unlock multiple tokens in one transaction
   const batchUnlock = await sdk.unlockTokens({
     tokens: [
@@ -887,8 +820,6 @@ async function tokenLockingAndBurning() {
     ]
   });
 
-  console.log('Batch unlock completed');
-
   // ============================================================================
   // BURN TOKENS - Permanently destroy (IRREVERSIBLE!)
   // ============================================================================
@@ -901,9 +832,6 @@ async function tokenLockingAndBurning() {
     }]
   });
 
-  console.log('Burn transaction ID:', burnResult.transactionId);
-  console.log('Burned:', burnResult.burned);
-
   // Batch burn multiple token types
   const batchBurn = await sdk.burnTokens({
     tokens: [
@@ -912,8 +840,6 @@ async function tokenLockingAndBurning() {
     ]
   });
 
-  console.log('Batch burn completed:', batchBurn.burned.length, 'token types burned');
-
   // ============================================================================
   // QUERY LOCKED TOKENS - Check lock status
   // ============================================================================
@@ -923,15 +849,11 @@ async function tokenLockingAndBurning() {
     address: sdk.getAddress()
   });
 
-  console.log('Locked quantity:', lockedTokens.lockedQuantity);
-  console.log('Active holds:', lockedTokens.holds);
-
   // Each hold contains: lockAuthority, expires, name, quantity
   for (const hold of lockedTokens.holds) {
-    console.log(\`  - \${hold.quantity} locked by \${hold.lockAuthority}\`);
-    if (hold.expires) console.log(\`    Expires: \${new Date(hold.expires)}\`);
-    if (hold.name) console.log(\`    Name: \${hold.name}\`);
-  }
+
+    if (hold.expires) }\`);
+    if (hold.name) }
 
   // ============================================================================
   // STAKING WORKFLOW EXAMPLE
@@ -948,8 +870,6 @@ async function tokenLockingAndBurning() {
       }]
     });
 
-    console.log('Staked 5000 tokens for 90 days');
-
     // Step 2: After staking period expires, unlock
     const unstake = await sdk.unlockTokens({
       tokens: [{
@@ -959,7 +879,6 @@ async function tokenLockingAndBurning() {
       }]
     });
 
-    console.log('Unstaked tokens after staking period');
     return { stake, unstake };
   }
 
@@ -978,8 +897,6 @@ async function tokenLockingAndBurning() {
       }]
     });
 
-    console.log('Escrow created: seller can release payment upon delivery');
-
     // Step 2: Seller releases escrow after delivery (seller calls unlock)
     // This would be executed by the seller's SDK instance
     // const release = await sellerSdk.unlockTokens({
@@ -1075,13 +992,9 @@ async function dexTradingExample() {
 
   // Quote 1: Exact input (spend known GALA amount)
   const quoteIn = await sdk.getSwapQuoteExactInput('GALA', 'GUSDC', '100');
-  console.log('Spend 100 GALA → get ~' + quoteIn.estimatedOutput + ' GUSDC');
-  console.log('Price impact: ' + quoteIn.priceImpact + '%');
-  console.log('Fee tier: ' + quoteIn.feeTier + ' bps');
 
   // Quote 2: Exact output (get known token amount)
   const quoteOut = await sdk.getSwapQuoteExactOutput('GALA', 'GUSDC', '100');
-  console.log('Get exactly 100 GUSDC → need ~' + quoteOut.inputAmount + ' GALA');
 
   // ============================================================================
   // EXECUTE: Perform the swap with slippage protection
@@ -1096,18 +1009,14 @@ async function dexTradingExample() {
     0.01                          // 1% slippage tolerance
   );
 
-  console.log('Transaction ID: ' + result.transactionId);
-  console.log('Status: ' + result.status);
-  console.log('Received: ' + result.outputAmount + ' ' + result.toToken);
-
   // ============================================================================
   // PORTFOLIO: Check balances and assets
   // ============================================================================
 
   const assets = await sdk.getSwapUserAssets(sdk.getEthereumAddress());
-  console.log('Assets in wallet:');
+
   assets.forEach(asset => {
-    console.log('  ' + asset.symbol + ': ' + asset.balance);
+
   });
 
   // ============================================================================
@@ -1115,10 +1024,9 @@ async function dexTradingExample() {
   // ============================================================================
 
   const allAssets = await sdk.getAllSwapUserAssets(sdk.getEthereumAddress());
-  console.log('Complete asset portfolio:');
-  console.log('Total assets: ' + allAssets.length);
+
   allAssets.forEach(asset => {
-    console.log('  ' + asset.symbol + ': ' + asset.balance);
+
   });
 
   // ============================================================================
@@ -1126,10 +1034,7 @@ async function dexTradingExample() {
   // ============================================================================
 
   const pool = await sdk.getSwapPoolInfo('GALA', 'GUSDC');
-  console.log('GALA↔GUSDC Pool Info:');
-  console.log('  Liquidity: ' + pool.liquidity);
-  console.log('  Available fee tiers: ' + pool.feeTiers.join(', ') + ' bps');
-  console.log('  24h swaps: ' + pool.swapCount);
+
 }
 \`\`\`
 
@@ -1181,8 +1086,6 @@ async function errorHandlingExample() {
       slippageToleranceFactor: 0.01
     });
 
-    console.log('Success:', result.transactionId);
-
   } catch (error) {
     if (error instanceof ValidationError) {
       console.error('Invalid input:', error.message);
@@ -1322,12 +1225,6 @@ async function localCalculationsExample() {
     type: 'native'      // 'native' = GALA amount, 'exact' = token amount
   });
 
-  console.log('LOCAL Buy Quote (instant):');
-  console.log('  Tokens received:', localBuy.amount);
-  console.log('  Transaction fee:', localBuy.transactionFee);
-  console.log('  RBC Fee:', localBuy.reverseBondingCurveFee); // Always "0" for buys
-  console.log('  Gas fee:', localBuy.gasFee);
-
   // 2. Sell calculation (local, requires pool details)
   const poolDetails = await sdk.fetchPoolDetails('dragnrkti');
 
@@ -1341,11 +1238,6 @@ async function localCalculationsExample() {
     maxFeePortion: poolDetails.reverseBondingCurveMaxFeeFactor || 0
   });
 
-  console.log('LOCAL Sell Quote (instant):');
-  console.log('  GALA received:', localSell.amount);
-  console.log('  RBC Fee:', localSell.reverseBondingCurveFee);
-  console.log('  Transaction fee:', localSell.transactionFee);
-
   // ============================================================================
   // EXTERNAL CALCULATIONS - Real-time network queries (explicit)
   // ============================================================================
@@ -1357,9 +1249,6 @@ async function localCalculationsExample() {
     type: 'native'
   });
 
-  console.log('EXTERNAL Buy Quote (network):');
-  console.log('  Tokens received:', externalBuy.amount);
-
   // 4. External sell (explicit network call)
   const externalSell = await sdk.calculateSellAmountExternal({
     tokenName: 'dragnrkti',
@@ -1367,9 +1256,6 @@ async function localCalculationsExample() {
     type: 'exact'
   });
 
-  console.log('EXTERNAL Sell Quote (network):');
-  console.log('  GALA received:', externalSell.amount);
-
   // ============================================================================
   // A/B COMPARISON - Verify local accuracy
   // ============================================================================
@@ -1379,9 +1265,6 @@ async function localCalculationsExample() {
   const buyDiff = Math.abs(safeParseNumber(localBuy.amount, 0) - safeParseNumber(externalBuy.amount, 0));
   const buyPct = (buyDiff / safeParseNumber(externalBuy.amount, 1)) * 100;
 
-  console.log('Local vs External Accuracy:');
-  console.log(\`  Buy difference: \${toBigNumberFixed(buyPct, 4)}% (should be <0.01%)\`);
-
   // ============================================================================
   // PERFORMANCE BENEFIT - Local is instant
   // ============================================================================
@@ -1444,9 +1327,6 @@ async function analyzePriceHistory() {
     limit: 50
   });
 
-  console.log(\`Found \${history.snapshots.length} snapshots\`);
-  console.log(\`Total available: \${history.total} (page \${history.page} of \${history.totalPages})\`);
-
   // Auto-paginated complete history
   const allHistory = await sdk.fetchAllPriceHistory({
     tokenId: 'GWETH|Unit|none|none',
@@ -1461,14 +1341,11 @@ async function analyzePriceHistory() {
   const variance = prices.reduce((sum, p) => sum + Math.pow(p - avg, 2), 0) / prices.length;
   const volatility = Math.sqrt(variance);
 
-  console.log(\`Average: $\${toBigNumberFixed(avg, 4)}, Volatility: $\${toBigNumberFixed(volatility, 4)}\`);
-
   // Data export (CSV)
   const csv = ['timestamp,price'].concat(
     allHistory.snapshots.map(s => \`\${s.timestamp.toISOString()},\${s.price}\`)
   ).join('\\n');
 
-  console.log('CSV export:', csv.split('\\n').slice(0, 3).join('\\n'));
 }
 \`\`\`
 
@@ -1513,15 +1390,6 @@ async function analyzeTokenDetails() {
   // Fetch token metadata
   const details = await sdk.fetchTokenDetails('GUSDC|Unit|none|eth:0x...');
 
-  console.log('Token Information:');
-  console.log(\`  Name: \${details.name}\`);
-  console.log(\`  Symbol: \${details.symbol}\`);
-  console.log(\`  Decimals: \${details.decimals}\`);
-  console.log(\`  Verified: \${details.verified}\`);
-  console.log(\`  Trading: \${details.tradingEnabled}\`);
-  console.log(\`  Network: \${details.network}\`);
-  console.log(\`  Image: \${details.image}\`);
-
   // Pre-trading validation
   async function validateBeforeTrade(tokenId: string) {
     const token = await sdk.fetchTokenDetails(tokenId);
@@ -1548,7 +1416,7 @@ async function analyzeTokenDetails() {
   );
 
   const verified = details_list.filter(t => t?.verified).length;
-  console.log(\`Verified tokens: \${verified}/\${tokens.length}\`);
+
 }
 \`\`\`
 
@@ -1595,40 +1463,37 @@ async function tokenPricing() {
   // OPTION 1: SMART ROUTING (Recommended) - Automatic backend selection
   // Use tokenId for ANY token (graduated or ungraduated)
   // SDK automatically detects and routes to correct backend
-  console.log('=== Smart Routing (Recommended) ===');
+
   const smartPrice = await sdk.fetchTokenPrice({
     tokenId: 'Token|Unit|ANIME|eth:0x...'  // Works for ANY token!
   });
-  console.log(\`Token price: $\${smartPrice}\`);
+
   // ✅ Handles graduated tokens (DEX) automatically
   // ✅ Handles ungraduated tokens (Launchpad) automatically
   // ✅ No need to know token status beforehand
 
   // OPTION 2: EXPLICIT DEX PRICING - Graduated tokens only
   // Use tokenId directly for DEX tokens
-  console.log('\\n=== Explicit DEX Pricing ===');
+
   const dexPrices = await sdk.fetchTokenPrice({
     tokenId: 'GALA|Unit|none|none'  // Or other DEX token
   });
-  console.log(\`DEX Token GALA: $\${dexPrices}\`);
 
   // OPTION 3: TOKEN NAME PRICING - For launchpad tokens by name
   // Use tokenName for simple lookup of launchpad tokens
-  console.log('\\n=== Token Name Pricing ===');
+
   const launchpadPrice = await sdk.fetchTokenPrice({ tokenName: 'anime' });
-  console.log(\`Launchpad token anime: $\${launchpadPrice.price}\`);
 
   // ADVANCED: The smart router handles fallback automatically!
   // No need for manual fallback - fetchTokenPrice with tokenId detects
   // ungraduated tokens and automatically falls back to launchpad pricing
-  console.log('\\n=== Automatic Fallback (Built-in) ===');
+
   const autoPrice = await sdk.fetchTokenPrice({
     tokenId: 'Token|Unit|ANIME|eth:0x...'  // Auto-fallback if ungraduated
   });
-  console.log(\`Auto-routed price: $\${autoPrice.price}\`);
 
   // USECASE: Price comparison and discovery
-  console.log('\\n=== Price Discovery ===');
+
   async function comparePrices(tokenName: string) {
     const launchpadPrice = await sdk.fetchTokenPrice({ tokenName });
 
@@ -1639,10 +1504,10 @@ async function tokenPricing() {
       const dexPrice = await sdk.fetchTokenPrice({
         tokenId: \`Token|Unit|\${tokenName.toUpperCase()}|eth:0x...\`
       });
-      console.log(\`Launchpad: $\${launchpadPrice.price}, DEX: $\${dexPrice.price}\`);
+
       return { launchpadPrice, dexPrice, graduated: true };
     } else {
-      console.log(\`Launchpad: $\${launchpadPrice.price} (not on DEX yet)\`);
+
       return { launchpadPrice, graduated: false };
     }
   }
@@ -1692,7 +1557,7 @@ async function safePriceQuery(tokenId: string) {
     return await sdk.fetchTokenPrice({ tokenId });
   } catch (error) {
     if (error.message.includes('not found')) {
-      console.log('Token not available on DEX');
+
       // Could try fallback to launchpad pricing here
     }
     throw error;
@@ -1728,12 +1593,9 @@ async function manageUserProfiles() {
 
   // Fetch current user profile
   const myProfile = await sdk.fetchProfile();
-  console.log(\`Name: \${myProfile.fullName}\`);
-  console.log(\`Avatar: \${myProfile.profileImage}\`);
 
   // Fetch another user's profile
   const other = await sdk.fetchProfile('eth|0x...');
-  console.log(\`Other user: \${other.fullName}\`);
 
   // Update profile
   const updated = await sdk.updateProfile({
@@ -1742,8 +1604,6 @@ async function manageUserProfiles() {
     address: sdk.getAddress()
   });
 
-  console.log(\`Updated: \${updated.fullName}\`);
-
   // Upload profile image (Node.js only)
   const imgResult = await sdk.uploadProfileImage({
     imagePath: '/path/to/avatar.png'
@@ -1790,7 +1650,6 @@ async function manageUserProfiles() {
     addresses.map(addr => sdk.fetchProfile(addr).catch(() => null))
   );
 
-  console.log('Profiles:', profiles.filter(p => p).map(p => p.fullName));
 }
 \`\`\`
 
@@ -1838,19 +1697,13 @@ async function analyzeTokenDistribution() {
   // Fetch complete token distribution (all holders, non-paginated)
   const distribution = await sdk.fetchTokenDistribution('anime');
 
-  console.log(\`Total holders: \${distribution.totalHolders}\`);
-  console.log(\`Total supply: \${distribution.totalSupply}\`);
-  console.log(\`Last updated: \${distribution.lastUpdated.toISOString()}\`);
-
   // Analyze top holders
   // Use compareAmounts for precise balance sorting with large numbers
   distribution.holders
     .sort((a, b) => compareAmounts(b.balance, a.balance) > 0 ? 1 : -1)
     .slice(0, 5)
     .forEach((holder, index) => {
-      console.log(\`#\${index + 1}: \${holder.address}\`);
-      console.log(\`  Balance: \${holder.balance}\`);
-      console.log(\`  Ownership: \${toBigNumberFixed(holder.percentage, 2)}%\`);
+
     });
 
   // Check concentration risk (e.g., top 5 holders own >80%)
@@ -1859,24 +1712,20 @@ async function analyzeTokenDistribution() {
     .slice(0, 5)
     .reduce((sum, holder) => sum + holder.percentage, 0);
 
-  console.log(\`Top 5 holders control: \${toBigNumberFixed(top5Ownership, 2)}%\`);
-
   // Find specific holder
   const myAddress = sdk.getAddress();
   const myHolding = distribution.holders.find(h => h.address === myAddress);
 
   if (myHolding) {
-    console.log(\`Your ownership: \${toBigNumberFixed(myHolding.percentage, 4)}%\`);
-    console.log(\`Your balance: \${myHolding.balance}\`);
+
   }
 
   // Calculate concentration metrics
   const giniCoefficient = calculateGini(distribution.holders);
-  console.log(\`Gini coefficient: \${toBigNumberFixed(giniCoefficient, 4)}\`);
 
   // Count whales (holders with >5%)
   const whales = distribution.holders.filter(h => h.percentage > 5);
-  console.log(\`Whales (>5%): \${whales.length}\`);
+
 }
 
 // Helper: Calculate Gini coefficient for wealth distribution
@@ -1941,15 +1790,13 @@ async function getUserCard() {
   // }
 
   if (holderContext.quantity !== null) {
-    console.log(\`Rank: #\${holderContext.rank}\`);
-    console.log(\`Holder Tier: \${holderContext.holderTier?.tierName}\`);
-    console.log(\`Owns: \${holderContext.percentage ? toBigNumberFixed(holderContext.percentage, 4) : 'N/A'}%\`);
+
   } else {
-    console.log('User is not a holder of this token');
+
   }
 
   if (holderContext.isCreator) {
-    console.log('This user created the token!');
+
   }
 }
 \`\`\`
@@ -2037,11 +1884,9 @@ Use \`getAllSwapUserLiquidityPositions()\` to fetch all positions without manual
 // Fetch ALL positions automatically (handles pagination internally)
 const allPositions = await sdk.getAllSwapUserLiquidityPositions(ownerAddress);
 
-console.log(\`Total positions: \${allPositions.length}\`);
 allPositions.forEach(position => {
   const fees = position.fees0 + position.fees1; // Total accumulated fees
-  console.log(\`Position: \${position.token0}-\${position.token1}\`);
-  console.log(\`Accumulated fees: \${fees}\`);
+
 });
 \`\`\`
 
@@ -2080,9 +1925,7 @@ async function advancedDexAnalysis() {
   const composite = await sdk.fetchCompositePoolData('anime');
 
   if (composite.isGraduated) {
-    console.log('Token graduated to DEX!');
-    console.log('DEX Pool TVL:', composite.dexPool.tvl);
-    console.log('DEX 24h Volume:', composite.dexPool.volume1d);
+
   }
 
   // Step 2: Compare local vs external price calculations
@@ -2098,9 +1941,6 @@ async function advancedDexAnalysis() {
     '100'
   );
 
-  console.log('Local calculation:', localQuote.outputAmount);
-  console.log('External API:', externalQuote.outputAmount);
-  console.log('Price difference:',
     Math.abs(safeParseFloat(localQuote.outputAmount, 0) - safeParseFloat(externalQuote.outputAmount, 0))
   );
 
@@ -2111,8 +1951,6 @@ async function advancedDexAnalysis() {
     '100'
   );
 
-  console.log('Best route:', bestQuote.route); // 'local' or 'external'
-  console.log('Best price:', bestQuote.outputAmount);
 }
 \`\`\`
 
@@ -2150,20 +1988,14 @@ async function tradingAnalytics() {
     page: 1
   });
 
-  console.log(\`Analyzing \${trades.total} trades\`);
-
   // Calculate analytics
   const totalVolume = trades.trades.reduce((sum, t) => sum + safeParseFloat(t.galaAmount, 0), 0);
   const averageTradeSize = totalVolume / trades.trades.length;
   const whaleTrades = trades.trades.filter(t => safeParseFloat(t.galaAmount, 0) > 1000);
 
-  console.log(\`Total volume: \${totalVolume} GALA\`);
-  console.log(\`Average trade size: \${averageTradeSize} GALA\`);
-  console.log(\`Whale trades (>1000 GALA): \${whaleTrades.length}\`);
-
   // Most recent trades
   trades.trades.slice(0, 10).forEach(trade => {
-    console.log(\`\${trade.type}: \${trade.galaAmount} GALA at \${trade.timestamp}\`);
+
   });
 }
 
@@ -2173,13 +2005,11 @@ async function queryTradesV1() {
 
   // Query all trades for a specific token
   const { trades, meta } = await sdk.getV1Trades({ tokenName: 'anime' });
-  console.log(\`Found \${meta.totalItems} trades for anime\`);
 
   // Query all trades by a specific user
   const userTrades = await sdk.getV1Trades({
     userAddress: 'eth|1234567890abcdef...'
   });
-  console.log(\`User has \${userTrades.meta.totalItems} trades across all tokens\`);
 
   // Query a user's trades on a specific token with pagination
   const filteredTrades = await sdk.getV1Trades({
@@ -2188,11 +2018,10 @@ async function queryTradesV1() {
     page: 2,
     limit: 20
   });
-  console.log(\`Page \${filteredTrades.meta.currentPage} of \${filteredTrades.meta.totalPages}\`);
 
   // Analyze trade types
   filteredTrades.trades.forEach(trade => {
-    console.log(\`\${trade.txnType}: \${trade.inputAmount} -> \${trade.outputAmount}\`);
+
   });
 }
 \`\`\`
@@ -2225,12 +2054,11 @@ Essential helper methods for development, debugging, and special use cases.
 \`\`\`typescript
 // Get current GALA price in USD
 const galaPrice = await sdk.fetchGalaPrice();
-console.log(\`GALA: $\${galaPrice}\`);
 
 // Get token supply metrics from GalaChain
 const supplies = await sdk.fetchTokenClassesWithSupply();
 supplies.forEach(token => {
-  console.log(\`\${token.tokenClass}: \${token.totalSupply}\`);
+
 });
 \`\`\`
 
@@ -2239,7 +2067,7 @@ supplies.forEach(token => {
 \`\`\`typescript
 // Check transaction status
 const status = await sdk.getBundlerTransactionResult('tx-id-123');
-console.log('Status:', status.status); // 'pending' | 'success' | 'failed'
+
 \`\`\`
 
 ### Advanced Swap Queries
@@ -2247,11 +2075,9 @@ console.log('Status:', status.status); // 'pending' | 'success' | 'failed'
 \`\`\`typescript
 // Get pool price without full quote
 const price = await sdk.getSwapPoolPrice('GALA|Unit|none|none', 'GUSDC|Unit|none|none');
-console.log(\`Pool price: \${price}\`);
 
 // Auto-paginated asset fetch
 const allAssets = await sdk.getAllSwapUserAssets('eth|0x...', { limit: 100 });
-console.log(\`Total assets: \${allAssets.length}\`);
 
 // Direct position lookup (if you have compound key)
 const position = await sdk.fetchSwapPositionDirect({
@@ -2267,7 +2093,7 @@ const position = await sdk.fetchSwapPositionDirect({
 \`\`\`typescript
 // Calculate initial buy amount for token launch
 const buyAmount = await sdk.calculateInitialBuyAmount('100');
-console.log(\`Initial buy: \${buyAmount} tokens\`);
+
 \`\`\`
 
 ### SDK Cleanup
@@ -2285,7 +2111,6 @@ const tradeResult = await sdk.buy({ tokenName, amount, type: 'native', expectedA
 
 // Poll for completion
 const status = await sdk.getBundlerTransactionResult(tradeResult.transactionId);
-console.log('Status:', status.status); // PENDING, PROCESSING, COMPLETED, FAILED
 
 // Wait with polling
 let attempts = 0;
@@ -2334,22 +2159,21 @@ async function manageDexSeasons() {
 
   // Display season information
   seasons.forEach(season => {
-    console.log(\`Season: \${season.name} (ID: \${season.id})\`);
-    console.log(\`Duration: \${season.start} to \${season.end}\`);
+
   });
 
   // Get current season
   const activeSeason = await sdk.fetchCurrentDexSeason();
   if (activeSeason) {
-    console.log(\`Active: \${activeSeason.name}\`);
+
   } else {
-    console.log('No active season (between seasons)');
+
   }
 
   // Verify season is active
   const now = new Date();
   const isActive = activeSeason && now >= activeSeason.start && now <= activeSeason.end;
-  console.log(\`Season active: \${isActive}\`);
+
 }
 \`\`\`
 
@@ -2376,29 +2200,26 @@ async function viewLeaderboards() {
   const leaderboard = await sdk.fetchDexLeaderboardBySeasonId(4);
 
   // Display top 10 ranked players
-  console.log(\`Season \${leaderboard.seasonId} - Top 10 Players:\`);
+
   leaderboard.entries.slice(0, 10).forEach(entry => {
-    console.log(\`  \${entry.rank}. \${entry.wallet}\`);
-    console.log(\`     XP: \${entry.totalXp} (Liquidity: \${entry.liquidityXp}, Trading: \${entry.tradingXp})\`);
+
   });
 
   // Analyze mastery titles
   const topPlayer = leaderboard.entries[0];
   topPlayer.masteryTitles.forEach(title => {
-    console.log(\`  🏆 \${title.name} (Type: \${title.type}, Tier: \${title.order})\`);
+
   });
 
   // Option 2: Get current leaderboard (convenience method)
   const currentBoard = await sdk.fetchCurrentDexLeaderboard();
 
   if (currentBoard) {
-    console.log(\`Season \${currentBoard.seasonId} is active\`);
-    console.log(\`Total participants: \${currentBoard.entries.length}\`);
 
     // Top 3 performers
     const topThree = currentBoard.entries.slice(0, 3);
     topThree.forEach(entry => {
-      console.log(\`  #\${entry.rank}: \${entry.totalXp} XP\`);
+
     });
   }
 }
@@ -2426,24 +2247,17 @@ async function analyzeVolumeTrends() {
   const summary = await sdk.fetchDexAggregatedVolumeSummary();
 
   // Display volumes
-  console.log(\`1-Day Volume: $\${summary.volume1d.toLocaleString()}\`);
-  console.log(\`7-Day Volume: $\${summary.volume7d.toLocaleString()}\`);
-  console.log(\`30-Day Volume: $\${summary.volume30d.toLocaleString()}\`);
 
   // Analyze trends
   const trend1d = summary.volume1dDelta > 0 ? '📈 UP' : '📉 DOWN';
   const trend7d = summary.volume7dDelta > 0 ? '📈 UP' : '📉 DOWN';
   const trend30d = summary.volume30dDelta > 0 ? '📈 UP' : '📉 DOWN';
 
-  console.log(\`1-Day Trend: \${trend1d} (\${toBigNumberFixed(summary.volume1dDelta * 100, 2)}%)\`);
-  console.log(\`7-Day Trend: \${trend7d} (\${toBigNumberFixed(summary.volume7dDelta * 100, 2)}%)\`);
-  console.log(\`30-Day Trend: \${trend30d} (\${toBigNumberFixed(summary.volume30dDelta * 100, 2)}%)\`);
-
   // Growth analysis
   if (summary.volume30dDelta > 0.1) {
-    console.log('Strong growth - Platform adoption increasing');
+
   } else if (summary.volume30dDelta < -0.1) {
-    console.log('Declining volume - Platform may be slowing');
+
   }
 }
 \`\`\`
@@ -2468,26 +2282,23 @@ async function queryDexPools() {
   // Option 1: Fetch pools with pagination
   const pools = await sdk.fetchDexPools({
     search: 'GALA',
-    sortBy: 'tvl',      // Sort by: tvl, volume30d, volume1d
+    sortBy: 'TVL',      // Sort by: TVL, volume30d, volume1d
     limit: 20,
     page: 1
   });
 
-  console.log(\`Found \${pools.total} pools, page \${pools.page} of \${pools.totalPages}\`);
   pools.pools.forEach(pool => {
-    console.log(\`\${pool.tokenName}: TVL \${pool.tvl}, 24h Volume: \${pool.volume1d}\`);
+
   });
 
   // Option 2: Fetch ALL pools automatically (handles pagination)
   const allPools = await sdk.fetchAllDexPools({
-    sortBy: 'tvl'
+    sortBy: 'TVL'
   });
 
-  console.log(\`Total pools: \${allPools.pools.length}\`);
-
   // Analyze pool metrics
-  const avgTvl = allPools.pools.reduce((sum, p) => sum + safeParseFloat(p.tvl, 0), 0) / allPools.pools.length;
-  console.log(\`Average TVL: $\${toBigNumberFixed(avgTvl, 2)}\`);
+  const avgTvl = allPools.pools.reduce((sum, p) => sum + safeParseFloat(p.TVL, 0), 0) / allPools.pools.length;
+
 }
 \`\`\`
 
@@ -2530,10 +2341,10 @@ async function monitorTokenStatus() {
   const isGraduated = await sdk.isTokenGraduated('anime');
 
   if (isGraduated) {
-    console.log('Token has graduated to DEX - trade via GalaSwap');
+
     // Use DEX trading methods: executeSwap(), getSwapQuoteExactInput(), etc.
   } else {
-    console.log('Token on bonding curve - trade via launchpad');
+
     // Use bonding curve methods: buy(), sell(), calculateBuyAmount(), etc.
   }
 
@@ -2543,12 +2354,6 @@ async function monitorTokenStatus() {
 
   // Set up listener for new DEX pools
   const cleanupDexPool = sdk.onDexPoolCreation((poolData) => {
-    console.log('New DEX pool created!');
-    console.log(\`  Token: \${poolData.tokenName}\`);
-    console.log(\`  Token0: \${poolData.token0}\`);
-    console.log(\`  Token1: \${poolData.token1}\`);
-    console.log(\`  Fee Tier: \${poolData.feeTier}\`);
-    console.log(\`  Initial TVL: \${poolData.tvl}\`);
 
     // Take action on new pool
     // Example: Automatically provide liquidity or execute arbitrage
@@ -2560,12 +2365,6 @@ async function monitorTokenStatus() {
 
   // Set up listener for new token launches
   const cleanupTokenCreation = sdk.onLaunchpadTokenCreation((tokenData) => {
-    console.log('New token launched!');
-    console.log(\`  Name: \${tokenData.tokenName}\`);
-    console.log(\`  Symbol: \${tokenData.tokenSymbol}\`);
-    console.log(\`  Creator: \${tokenData.creator}\`);
-    console.log(\`  Max Supply: \${tokenData.maxSupply}\`);
-    console.log(\`  Base Price: \${tokenData.basePrice}\`);
 
     // Take action on new token
     // Example: Automatically buy early or analyze opportunity
@@ -2578,7 +2377,6 @@ async function monitorTokenStatus() {
   async function autoTrade() {
     // Monitor new tokens
     sdk.onLaunchpadTokenCreation(async (token) => {
-      console.log(\`New token: \${token.tokenName}\`);
 
       // Wait for graduation
       const checkGraduation = setInterval(async () => {
@@ -2586,27 +2384,25 @@ async function monitorTokenStatus() {
 
         if (graduated) {
           clearInterval(checkGraduation);
-          console.log(\`\${token.tokenName} graduated! Switching to DEX trading.\`);
 
           // Now use DEX methods instead of bonding curve
           const quote = await sdk.getSwapQuoteExactInput('GALA', token.tokenName, '100');
-          console.log(\`DEX quote: \${quote.estimatedOutput}\`);
+
         }
       }, 60000); // Check every minute
     });
 
     // Monitor new DEX pools
     sdk.onDexPoolCreation(async (pool) => {
-      console.log(\`New pool: \${pool.tokenName}\`);
 
       // Analyze liquidity opportunity
       const poolInfo = await sdk.getSwapPoolInfo(pool.token0, pool.token1);
-      console.log(\`Pool liquidity: \${poolInfo.liquidity}\`);
+
     });
   }
 
   // Keep process running
-  console.log('Monitoring events... Press Ctrl+C to stop');
+
   await new Promise(() => {}); // Run forever
 
   // Cleanup when done
@@ -2623,7 +2419,7 @@ async function monitorTokenStatus() {
 - **Price Discovery**: Track token lifecycle from launch to DEX
 
 **Event Data:**
-- **DEX Pool Creation**: tokenName, token0, token1, feeTier, tvl, timestamp
+- **DEX Pool Creation**: tokenName, token0, token1, feeTier, TVL, timestamp
 - **Token Launch**: tokenName, tokenSymbol, creator, maxSupply, basePrice, timestamp
 
 **MCP Tool Equivalents:**
@@ -2663,11 +2459,9 @@ async function sdkUtilities() {
 
   // Get GalaChain address (eth|0x... format)
   const galaAddress = sdk.getAddress();
-  console.log(\`GalaChain address: \${galaAddress}\`); // "eth|0x1234..."
 
   // Get Ethereum address (0x... format)
   const ethAddress = sdk.getEthereumAddress();
-  console.log(\`Ethereum address: \${ethAddress}\`); // "0x1234..."
 
   // ============================================================================
   // WALLET MANAGEMENT - Check and update wallet
@@ -2675,18 +2469,16 @@ async function sdkUtilities() {
 
   // Check if SDK has wallet configured
   if (sdk.hasWallet()) {
-    console.log('Wallet configured - can execute trades');
 
     // Get wallet instance (for advanced use)
     const wallet = sdk.getWallet();
-    console.log(\`Wallet address: \${wallet.address}\`);
+
   } else {
-    console.log('Read-only mode - cannot execute trades');
+
   }
 
   // Update wallet at runtime
   sdk.setWallet('new-private-key');
-  console.log(\`New address: \${sdk.getAddress()}\`);
 
   // ============================================================================
   // CONFIGURATION ACCESS - Get SDK config
@@ -2694,10 +2486,6 @@ async function sdkUtilities() {
 
   // Get SDK configuration
   const config = sdk.getConfig();
-  console.log(\`Base URL: \${config.baseUrl}\`);
-  console.log(\`Environment: \${config.env}\`);
-  console.log(\`Debug: \${config.debug}\`);
-  console.log(\`Timeout: \${config.timeout}ms\`);
 
   // ============================================================================
   // VERSION INFORMATION - Get SDK version
@@ -2705,7 +2493,6 @@ async function sdkUtilities() {
 
   // Get SDK version
   const version = sdk.getVersion();
-  console.log(\`SDK Version: \${version}\`); // "4.0.4-beta.0"
 
   // ============================================================================
   // URL GENERATION - Get frontend URLs for tokens
@@ -2713,7 +2500,7 @@ async function sdkUtilities() {
 
   // Generate frontend URL for token
   const url = sdk.getUrlByTokenName('anime');
-  console.log(\`Token URL: \${url}\`);
+
   // "https://launchpad.gala.com/token/anime" (production)
   // "https://lpad-dev1.defi.gala.com/token/anime" (development)
 
@@ -2725,7 +2512,6 @@ async function sdkUtilities() {
   });
 
   const tokenUrl = sdk.getUrlByTokenName('mytoken');
-  console.log(\`Share your token: \${tokenUrl}\`);
 
   // ============================================================================
   // MULTI-WALLET SCENARIO - Check multiple addresses
@@ -2735,15 +2521,10 @@ async function sdkUtilities() {
     const wallet1 = createLaunchpadSDK({ wallet: 'private-key-1' });
     const wallet2 = createLaunchpadSDK({ wallet: 'private-key-2' });
 
-    console.log(\`Wallet 1: \${wallet1.getAddress()}\`);
-    console.log(\`Wallet 2: \${wallet2.getAddress()}\`);
-
     // Compare balances
     const balance1 = await wallet1.fetchGalaBalance();
     const balance2 = await wallet2.fetchGalaBalance();
 
-    console.log(\`Wallet 1 balance: \${balance1.balance}\`);
-    console.log(\`Wallet 2 balance: \${balance2.balance}\`);
   }
 
   // ============================================================================
@@ -2754,11 +2535,8 @@ async function sdkUtilities() {
     // Create SDK without wallet (read-only mode)
     const readOnlySdk = createLaunchpadSDK();
 
-    console.log(\`Has wallet: \${readOnlySdk.hasWallet()}\`); // false
-
     // Can fetch public data
     const pools = await readOnlySdk.fetchPools({ type: 'recent', limit: 10 });
-    console.log(\`Found \${pools.total} pools\`);
 
     // Cannot execute trades (will throw error)
     try {
@@ -2779,17 +2557,12 @@ async function sdkUtilities() {
       config: { env: 'production' }
     });
 
-    console.log(\`Prod config: \${prodSdk.getConfig().baseUrl}\`);
-    console.log(\`Prod URL: \${prodSdk.getUrlByTokenName('anime')}\`);
-
     // Development SDK
     const devSdk = createLaunchpadSDK({
       wallet: 'your-private-key',
       config: { env: 'development' }
     });
 
-    console.log(\`Dev config: \${devSdk.getConfig().baseUrl}\`);
-    console.log(\`Dev URL: \${devSdk.getUrlByTokenName('anime')}\`);
   }
 }
 \`\`\`
@@ -2844,30 +2617,17 @@ async function subscribeToEvents() {
 
   // Subscribe to liquidity additions
   const cleanupAdded = sdk.subscribeToDexLiquidityAdded((event) => {
-    console.log('Liquidity added!');
-    console.log(\`  Pool: \${event.token0}-\${event.token1}\`);
-    console.log(\`  Amount0: \${event.amount0}\`);
-    console.log(\`  Amount1: \${event.amount1}\`);
-    console.log(\`  Owner: \${event.owner}\`);
-    console.log(\`  Position ID: \${event.positionId}\`);
+
   });
 
   // Subscribe to liquidity changes (compound events)
   const cleanupChanged = sdk.subscribeToDexLiquidityChanged((event) => {
-    console.log('Liquidity changed!');
-    console.log(\`  Type: \${event.type}\`); // 'added', 'removed', 'modified'
-    console.log(\`  Pool: \${event.token0}-\${event.token1}\`);
-    console.log(\`  Delta: \${event.liquidityDelta}\`);
+
   });
 
   // Subscribe to liquidity removals
   const cleanupRemoved = sdk.subscribeToDexLiquidityRemoved((event) => {
-    console.log('Liquidity removed!');
-    console.log(\`  Pool: \${event.token0}-\${event.token1}\`);
-    console.log(\`  Amount0: \${event.amount0}\`);
-    console.log(\`  Amount1: \${event.amount1}\`);
-    console.log(\`  Owner: \${event.owner}\`);
-    console.log(\`  Fees collected: \${event.fees0}, \${event.fees1}\`);
+
   });
 
   // ============================================================================
@@ -2876,12 +2636,6 @@ async function subscribeToEvents() {
 
   // Subscribe to new DEX pool creation
   const cleanupPool = sdk.subscribeToDexPoolAdded((pool) => {
-    console.log('New DEX pool created!');
-    console.log(\`  Token: \${pool.tokenName}\`);
-    console.log(\`  Token0: \${pool.token0}\`);
-    console.log(\`  Token1: \${pool.token1}\`);
-    console.log(\`  Fee Tier: \${pool.feeTier}\`);
-    console.log(\`  Initial TVL: \${pool.tvl}\`);
 
     // Auto-provide liquidity to new pools
     sdk.addSwapLiquidityByPrice({
@@ -2892,7 +2646,7 @@ async function subscribeToEvents() {
       maxPrice: '1.05',
       amount0Desired: '1000',
       amount1Desired: '1000'
-    }).then(() => console.log('Liquidity provided to new pool'));
+    }).then(() => );
   });
 
   // ============================================================================
@@ -2901,16 +2655,10 @@ async function subscribeToEvents() {
 
   // Subscribe to DEX swap executions
   const cleanupSwap = sdk.subscribeToDexSwapExecuted((swap) => {
-    console.log('DEX swap executed!');
-    console.log(\`  Pair: \${swap.tokenIn} → \${swap.tokenOut}\`);
-    console.log(\`  Amount In: \${swap.amountIn}\`);
-    console.log(\`  Amount Out: \${swap.amountOut}\`);
-    console.log(\`  Trader: \${swap.trader}\`);
-    console.log(\`  Fee Tier: \${swap.feeTier}\`);
 
     // Track volume and price impact
     const priceImpact = calculatePriceImpact(swap.amountIn, swap.amountOut);
-    console.log(\`  Price impact: \${priceImpact}%\`);
+
   });
 
   // ============================================================================
@@ -2919,12 +2667,6 @@ async function subscribeToEvents() {
 
   // Subscribe to new token launches
   const cleanupToken = sdk.subscribeToTokenCreations((token) => {
-    console.log('New token launched!');
-    console.log(\`  Name: \${token.tokenName}\`);
-    console.log(\`  Symbol: \${token.tokenSymbol}\`);
-    console.log(\`  Creator: \${token.creator}\`);
-    console.log(\`  Max Supply: \${token.maxSupply}\`);
-    console.log(\`  Base Price: \${token.basePrice}\`);
 
     // Auto-buy new tokens
     sdk.buy({
@@ -2932,7 +2674,7 @@ async function subscribeToEvents() {
       amount: '100',
       type: 'native',
       slippageToleranceFactor: 0.01
-    }).then(() => console.log('Auto-bought new token'));
+    }).then(() => );
   });
 
   // ============================================================================
@@ -2952,7 +2694,6 @@ async function subscribeToEvents() {
 
       if (divergence > 0.01) {
         // 1% arbitrage opportunity
-        console.log(\`Arbitrage opportunity: \${divergence * 100}%\`);
 
         // Execute arbitrage trade
         await sdk.executeSwap(
@@ -2968,13 +2709,12 @@ async function subscribeToEvents() {
 
     // Monitor liquidity additions for new opportunities
     sdk.subscribeToDexLiquidityAdded(async (event) => {
-      console.log(\`New liquidity in \${event.token0}-\${event.token1}\`);
 
       // Check if pool has sufficient depth for arbitrage
       const poolInfo = await sdk.getSwapPoolInfo(event.token0, event.token1);
       // Use compareAmounts for precise liquidity threshold comparison
       if (compareAmounts(poolInfo.liquidity, '100000') > 0) {
-        console.log('Pool has sufficient liquidity for arbitrage');
+
       }
     });
   }
@@ -2988,7 +2728,6 @@ async function subscribeToEvents() {
 
     // Auto-add liquidity to new pools
     sdk.subscribeToDexPoolAdded(async (pool) => {
-      console.log(\`New pool: \${pool.tokenName}\`);
 
       // Wait for some initial swaps to establish price
       setTimeout(async () => {
@@ -3007,24 +2746,22 @@ async function subscribeToEvents() {
             amount1Desired: '10000'
           });
 
-          console.log('Liquidity added to new pool');
         }
       }, 60000); // Wait 1 minute
     });
 
     // Monitor liquidity removals (potential exit signal)
     sdk.subscribeToDexLiquidityRemoved((event) => {
-      console.log(\`Large liquidity removal: \${event.amount0}, \${event.amount1}\`);
 
       // Check if we should also exit
       if (isLargeRemoval(event)) {
-        console.log('Large removal detected - consider exiting position');
+
       }
     });
   }
 
   // Keep subscriptions running
-  console.log('Subscriptions active... Press Ctrl+C to stop');
+
   await new Promise(() => {}); // Run forever
 
   // Cleanup when done
@@ -3054,7 +2791,7 @@ async function subscribeToEvents() {
 
 **DexPoolAdded:**
 - tokenName, token0, token1
-- feeTier, tvl
+- feeTier, TVL
 - timestamp
 
 **SwapExecuted:**
@@ -3083,10 +2820,10 @@ async function subscribeToEvents() {
 // Handle connection lifecycle events
 await sdk.connectStreamWebSocket({
   onConnect: () => {
-    console.log('WebSocket connected');
+
   },
   onDisconnect: (reason) => {
-    console.log('WebSocket disconnected:', reason);
+
     // Implement reconnection logic if needed
   },
   onError: (error) => {
@@ -3096,7 +2833,7 @@ await sdk.connectStreamWebSocket({
 
 // Check connection state
 if (sdk.isStreamWebSocketConnected()) {
-  console.log('Ready to send/receive messages');
+
 }
 \`\`\`
 
@@ -3107,9 +2844,9 @@ if (sdk.isStreamWebSocketConnected()) {
 await sdk.connectStreamWebSocket({
   onTypingIndicator: (event) => {
     if (event.isTyping) {
-      console.log(\`\${event.userAddress} is typing...\`);
+
     } else {
-      console.log(\`\${event.userAddress} stopped typing\`);
+
     }
   }
 });
@@ -3375,41 +3112,30 @@ async function getCurrentSeason() {
   const currentSeason = await sdk.fetchCurrentDexSeason();
 
   if (currentSeason) {
-    console.log('Current DEX Season:');
-    console.log(\`  Season ID: \${currentSeason.id}\`);
-    console.log(\`  Name: \${currentSeason.name}\`);
-    console.log(\`  Start: \${currentSeason.start.toISOString()}\`);
-    console.log(\`  End: \${currentSeason.end.toISOString()}\`);
 
     // Check if season is currently active
     const now = new Date();
     const isActive = now >= currentSeason.start && now <= currentSeason.end;
 
-    console.log(\`  Active: \${isActive}\`);
-
     // Calculate time remaining
     const timeRemaining = currentSeason.end.getTime() - now.getTime();
     const daysRemaining = Math.floor(timeRemaining / (1000 * 60 * 60 * 24));
 
-    console.log(\`  Days remaining: \${daysRemaining}\`);
-
     // Fetch leaderboard for current season
     const leaderboard = await sdk.fetchDexLeaderboardBySeasonId(currentSeason.id);
-    console.log(\`  Total participants: \${leaderboard.entries.length}\`);
 
     // Show top 3 players
     leaderboard.entries.slice(0, 3).forEach((entry, index) => {
-      console.log(\`  #\${index + 1}: \${entry.wallet} - \${entry.totalXp} XP\`);
+
     });
   } else {
-    console.log('No active season (between seasons)');
 
     // Fetch all seasons to see when next one starts
     const allSeasons = await sdk.fetchAllDexSeasons();
     const futureSeason = allSeasons.find(s => s.start > new Date());
 
     if (futureSeason) {
-      console.log(\`Next season starts: \${futureSeason.start.toISOString()}\`);
+
     }
   }
 }
@@ -3421,7 +3147,6 @@ async function participateInSeason() {
   const season = await sdk.fetchCurrentDexSeason();
 
   if (season) {
-    console.log(\`Active season: \${season.name}\`);
 
     // Execute trades to earn XP
     const quote = await sdk.getSwapQuoteExactInput('GALA', 'GUSDC', '100');
@@ -3434,8 +3159,6 @@ async function participateInSeason() {
       0.01
     );
 
-    console.log('Trade executed - XP earned!');
-
     // Check updated leaderboard position
     const leaderboard = await sdk.fetchCurrentDexLeaderboard();
     const myPosition = leaderboard?.entries.find(
@@ -3443,11 +3166,10 @@ async function participateInSeason() {
     );
 
     if (myPosition) {
-      console.log(\`Current rank: #\${myPosition.rank}\`);
-      console.log(\`Total XP: \${myPosition.totalXp}\`);
+
     }
   } else {
-    console.log('No active season - trades won't earn XP');
+
   }
 }
 \`\`\`
@@ -3502,11 +3224,9 @@ async function bridgeOperations() {
 
   // 2. Get supported bridge tokens
   const supportedTokens = await sdk.getSupportedBridgeTokens('Ethereum');
-  console.log('Bridgeable to Ethereum:', supportedTokens.map(t => t.symbol));
 
   // 3. Check if specific token is bridgeable
   const canBridge = await sdk.isTokenBridgeableToEthereum('GALA');
-  console.log('GALA bridgeable to Ethereum:', canBridge.bridgeable);
 
   // 4. Estimate bridge fee (calculated externally by GalaConnect API)
   const fee = await sdk.estimateBridgeFee({
@@ -3514,7 +3234,6 @@ async function bridgeOperations() {
     destinationChain: 'Ethereum',
     amount: '100',
   });
-  console.log('Bridge fee:', fee.totalFee, 'GALA');
 
   // 5. Bridge Out: GalaChain → Ethereum
   const bridgeOutTx = await sdk.bridgeOut({
@@ -3523,15 +3242,12 @@ async function bridgeOperations() {
     destinationChain: 'Ethereum',
     recipientAddress: '0x5678...',
   });
-  console.log('Bridge out TX:', bridgeOutTx.transactionHash);
 
   // 6. Get bridge status
   const status = await sdk.getBridgeStatus(bridgeOutTx.transactionHash);
-  console.log('Bridge status:', status.status);
 
   // 7. Get Ethereum transaction status
   const ethTxStatus = await sdk.getEthereumTransactionStatus(bridgeOutTx.transactionHash);
-  console.log('ETH TX confirmed:', ethTxStatus.confirmed);
 
   // 8. Query external chain balances
   const ethBalance = await sdk.fetchEthereumWalletNativeBalance();
@@ -3540,7 +3256,7 @@ async function bridgeOperations() {
 
   // 9. Discover all bridgeable tokens
   const allBridgeable = await sdk.fetchAllBridgeableTokensByNetwork('ETHEREUM');
-  console.log('All tokens bridgeable to Ethereum:', allBridgeable.length);
+
 }
 \`\`\`
 
@@ -3589,18 +3305,16 @@ async function discoverDexTokens() {
     limit: 20
   });
 
-  console.log(\`Found \${tokens.total} tokens, page \${tokens.page} of \${tokens.totalPages}\`);
   tokens.items.forEach(token => {
-    console.log(\`\${token.symbol}: \${token.name} (decimals: \${token.decimals})\`);
+
   });
 
   // Option 2: Fetch ALL tokens (auto-pagination)
   const allTokens = await sdk.fetchAllAvailableDexTokens();
-  console.log(\`Total DEX tokens: \${allTokens.length}\`);
 
   // Option 3: Search for specific tokens
   const searchResults = await sdk.fetchAllAvailableDexTokens({ search: 'USD' });
-  console.log('USD-related tokens:', searchResults.map(t => t.symbol));
+
 }
 \`\`\`
 
@@ -3641,7 +3355,6 @@ async function wrapToken() {
     memo: 'Wrapping for DEX trading'  // Optional
   });
 
-  console.log('Wrap transaction:', result.transactionId);
 }
 \`\`\`
 
@@ -3659,7 +3372,6 @@ async function unwrapToken() {
     memo: 'Unwrapping after trading'  // Optional
   });
 
-  console.log('Unwrap transaction:', result.transactionId);
 }
 \`\`\`
 
@@ -3671,11 +3383,10 @@ async function estimateFees() {
 
   // Estimate wrap fee (uses cross_channel_authorization)
   const wrapFee = await sdk.estimateWrapFee('MUSIC', '100');
-  console.log('Wrap fee:', wrapFee);
 
   // Estimate unwrap fee (uses automatic authorization)
   const unwrapFee = await sdk.estimateUnwrapFee('GMUSIC', '100');
-  console.log('Unwrap fee:', unwrapFee);
+
 }
 \`\`\`
 
@@ -3686,7 +3397,7 @@ async function checkStatus() {
   const sdk = createLaunchpadSDK({ wallet: 'your-private-key' });
 
   const status = await sdk.getWrapStatus('transaction-id-here');
-  console.log('Status:', status.status);  // pending, processing, completed, failed
+
 }
 \`\`\`
 
@@ -3710,7 +3421,7 @@ async function discoverWrappableTokens() {
 
   // Check if token is wrappable
   const isWrappable = await sdk.isTokenWrappable('$MUSIC|Unit|none|none');
-  console.log('Is wrappable:', isWrappable.isWrappable);
+
 }
 \`\`\`
 
@@ -3741,7 +3452,7 @@ async function getReferralUrl() {
 
   // Get your unique referral URL
   const result = await sdk.fetchReferralUrl();
-  console.log('Share this URL:', result.referralUrl);
+
 }
 \`\`\`
 
@@ -3758,9 +3469,8 @@ async function fetchReferrals() {
     limit: 20
   });
 
-  console.log('Total referrals:', referrals.total);
   referrals.items.forEach(ref => {
-    console.log(\`Referred: \${ref.referredAddress} on \${ref.createdAt}\`);
+
   });
 }
 \`\`\`
@@ -3773,7 +3483,7 @@ async function fetchAllReferrals() {
 
   // Get ALL referrals with auto-pagination
   const allReferrals = await sdk.fetchAllReferrals({ address: '0x...' });
-  console.log('Total referrals:', allReferrals.length);
+
 }
 \`\`\`
 
@@ -3784,8 +3494,7 @@ async function getReferralSummary() {
   const sdk = createLaunchpadSDK({ wallet: 'your-private-key' });
 
   const summary = await sdk.fetchReferralsSummary({ address: '0x...' });
-  console.log('Total referred users:', summary.totalReferrals);
-  console.log('Total rewards earned:', summary.totalRewards);
+
 }
 \`\`\`
 
@@ -3813,14 +3522,12 @@ async function registerAccount() {
 
   // Register the SDK wallet
   const result = await sdk.registerAccount();
-  console.log('Account exists:', result.exists);
-  console.log('Wallet alias:', result.walletAlias);
 
   // Register a specific address
   const otherResult = await sdk.registerAccount({
     address: '0x1234...'  // Supports eth|, 0x, or client| formats
   });
-  console.log('Other account exists:', otherResult.exists);
+
 }
 \`\`\`
 
@@ -3858,24 +3565,18 @@ async function manageStream() {
 
   // Start a stream for your token
   const stream = await sdk.startStream('mytoken');
-  console.log('Stream Key:', stream.streamKey);
-  console.log('RTMP URL:', stream.rtmpUrl);
-  console.log('Playback URL:', stream.playbackUrl);
+
   // Use stream.streamKey in OBS or other RTMP software
 
   // Get stream info (public endpoint)
   const info = await sdk.getStreamInfo('mytoken');
-  console.log('Status:', info.status);  // IDLE, ACTIVE, DISABLED
-  console.log('Is Live:', info.isLive);
-  console.log('Viewers:', info.viewerCount);
 
   // Stop the stream when done
   await sdk.stopStream('mytoken');
-  console.log('Stream stopped');
 
   // Reset stream key if compromised
   const newKey = await sdk.resetStreamKey('mytoken');
-  console.log('New Stream Key:', newKey.streamKey);
+
 }
 \`\`\`
 
@@ -3891,18 +3592,13 @@ async function manageRecordings() {
     page: 1,
     limit: 20,
   });
-  console.log('Total recordings:', recordings.total);
 
   for (const rec of recordings.recordings) {
-    console.log('Asset ID:', rec.assetId);
-    console.log('Duration:', rec.duration, 'seconds');
-    console.log('Status:', rec.status);  // READY, PROCESSING, ERRORED
+
   }
 
   // Get download URL for a recording
   const download = await sdk.getRecordingDownload('mytoken', 'asset-123');
-  console.log('Download URL:', download.downloadUrl);
-  console.log('Expires:', download.expiresAt);
 
   // Delete a recording
   await sdk.deleteRecording('mytoken', 'asset-123');
@@ -3919,8 +3615,6 @@ async function manageSimulcast() {
 
   // Get existing simulcast targets
   const targets = await sdk.getSimulcastTargets('mytoken');
-  console.log('Max targets:', targets.maxTargets);
-  console.log('Current targets:', targets.targets.length);
 
   // Add YouTube simulcast
   const youtube = await sdk.addSimulcastTarget({
@@ -3930,7 +3624,6 @@ async function manageSimulcast() {
     streamKey: 'your-youtube-stream-key',
     name: 'My YouTube Channel',
   });
-  console.log('Added target:', youtube.target.targetId);
 
   // Add Twitch simulcast
   await sdk.addSimulcastTarget({
@@ -3965,7 +3658,6 @@ async function adminOperations() {
 
   // Get global streaming status
   const globalStatus = await sdk.getGlobalStreamingStatus();
-  console.log('Global streaming enabled:', globalStatus.enabled);
 
   // Enable/disable streaming globally (maintenance mode)
   await sdk.setGlobalStreamingEnabled(false);  // Disable all streams
@@ -4038,7 +3730,7 @@ async function restChat() {
   });
 
   for (const msg of messages.messages) {
-    console.log(\`[\${msg.createdAt}] \${msg.user?.fullName}: \${msg.content}\`);
+
   }
 
   // Send a chat message via REST
@@ -4046,20 +3738,18 @@ async function restChat() {
     tokenName: 'mytoken',
     content: 'Hello everyone!',
   });
-  console.log('Message ID:', sent.message.messageId);
 
   // Delete a chat message (user can delete own, admin can delete any)
   const deleted = await sdk.deleteChatMessage({
     tokenName: 'mytoken',
     messageId: sent.message.messageId,
   });
-  console.log('Message deleted:', deleted.deleted);
 
   // Check chat status
   const status = await sdk.getChatStatus('mytoken');
-  console.log('Chat enabled:', status.enabled);
+
   if (!status.enabled) {
-    console.log('Reason:', status.reason);  // 'global' or 'token'
+
   }
 }
 \`\`\`
@@ -4077,17 +3767,17 @@ async function webSocketChat() {
 
   // Connect with event callbacks
   await sdk.connectStreamWebSocket({
-    onConnect: () => console.log('Connected!'),
-    onDisconnect: (reason) => console.log('Disconnected:', reason),
+    onConnect: () => ,
+    onDisconnect: (reason) => ,
     onError: (error) => console.error('Error:', error),
     onChatMessage: (msg) => {
-      console.log(\`[\${msg.tokenName}] \${msg.userAddress}: \${msg.content}\`);
+
     },
     onViewerCount: (data) => {
-      console.log(\`Viewers on \${data.tokenName}: \${data.count}\`);
+
     },
     onStreamStatus: (status) => {
-      console.log(\`Stream \${status.tokenName}: \${status.status}\`);
+
     },
   });
 
@@ -4096,7 +3786,6 @@ async function webSocketChat() {
 
   // Subscribe to a stream's events
   const subscribed = await sdk.subscribeToStream('mytoken');
-  console.log('Subscribed, stream status:', subscribed.status);
 
   // Send message via WebSocket (lower latency)
   await sdk.sendStreamChatViaWebSocket('mytoken', 'Hello via WebSocket!');
@@ -4129,7 +3818,6 @@ async function adminChat() {
 
   // Get global chat status
   const globalStatus = await sdk.getGlobalChatStatus();
-  console.log('Global chat enabled:', globalStatus.enabled);
 
   // Disable/enable chat globally
   await sdk.setGlobalChatEnabled(false);  // Disable all chat
@@ -4199,36 +3887,30 @@ const sdk = createLaunchpadSDK({
 
 // 1. Login to get JWT token
 const session = await sdk.login();
-console.log('Authenticated:', session.address);
-console.log('Token expires in:', session.expiresIn, 'seconds');
 
 // 2. Check authentication status
 if (sdk.isAuthenticated()) {
-  console.log('Session is valid');
+
 }
 
 // 3. Get current session info
 const info = await sdk.getSession();
-console.log('Session issued at:', info.issuedAt);
-console.log('Session expires at:', info.expiresAt);
 
 // 4. Access token directly (for custom requests)
 const token = sdk.getAccessToken();
-console.log('JWT token:', token);
 
 // 5. Refresh token before expiry
 if (sdk.shouldRefreshToken()) {
   const refreshed = await sdk.refreshToken();
-  console.log('Token refreshed, new expiry:', refreshed.expiresIn);
+
 }
 
 // 6. Ensure valid token (auto-refreshes if needed)
 const validToken = await sdk.ensureValidToken();
-console.log('Valid token obtained');
 
 // 7. Logout when done
 sdk.logout();
-console.log('Logged out');
+
 \`\`\`
 
 ## Auto-Refresh Behavior
@@ -4351,7 +4033,6 @@ const permanentBan = await sdk.createBan({
   userAddress: 'eth|0x1234567890abcdef1234567890abcdef12345678',
   reason: 'Spamming chat',
 });
-console.log('Permanent ban created:', permanentBan.ban.id);
 
 // Create a temporary ban (1 hour)
 const tempBan = await sdk.createBan({
@@ -4360,14 +4041,13 @@ const tempBan = await sdk.createBan({
   reason: 'Inappropriate behavior',
   durationSeconds: BAN_DURATIONS.ONE_HOUR, // 3600 seconds
 });
-console.log('Temp ban expires:', tempBan.ban.expiresAt);
 
 // Remove a ban (unban user)
 const unbanned = await sdk.removeBan({
   tokenName: 'mytoken',
   userAddress: 'eth|0x1234567890abcdef1234567890abcdef12345678',
 });
-console.log('User unbanned:', unbanned.removed);
+
 \`\`\`
 
 ## Duration Presets
@@ -4398,12 +4078,9 @@ const allBans = await sdk.listBans({
   page: 1,
   limit: 20,
 });
-console.log('Total bans:', allBans.meta.total);
 
 for (const ban of allBans.bans) {
-  console.log(\`- \${ban.userAddress}: \${ban.reason || 'No reason'}\`);
-  console.log(\`  Permanent: \${ban.isPermanent}\`);
-  console.log(\`  Expires: \${ban.expiresAt || 'Never'}\`);
+
 }
 
 // Search bans by user
@@ -4430,12 +4107,9 @@ const status = await sdk.getBanStatus({
 });
 
 if (status.banned) {
-  console.log('User is banned!');
-  console.log('Reason:', status.ban?.reason);
-  console.log('Permanent:', status.ban?.isPermanent);
-  console.log('Expires:', status.ban?.expiresAt);
+
 } else {
-  console.log('User is not banned');
+
 }
 \`\`\`
 
@@ -4449,14 +4123,12 @@ const viewers = await sdk.getActiveUsers({
   tokenName: 'mytoken',
   type: ACTIVE_USER_TYPE.VIEWERS, // or 'viewers'
 });
-console.log('Active viewers:', viewers.total);
 
 // Get only chat participants
 const chatters = await sdk.getActiveUsers({
   tokenName: 'mytoken',
   type: ACTIVE_USER_TYPE.CHAT_PARTICIPANTS, // or 'chat_participants'
 });
-console.log('Chat participants:', chatters.total);
 
 // Search active users
 const searchActive = await sdk.getActiveUsers({
@@ -4465,8 +4137,7 @@ const searchActive = await sdk.getActiveUsers({
 });
 
 for (const user of searchActive.users) {
-  console.log(\`- \${user.fullName || user.userAddress}\`);
-  console.log(\`  In chat: \${user.isChatParticipant}\`);
+
 }
 \`\`\`
 
@@ -4499,17 +4170,14 @@ Ban events are broadcast to affected users via WebSocket:
 // Listen for ban events
 sdk.connectStreamWebSocket({
   onUserBanned: (event) => {
-    console.log('User banned:', event.userAddress);
-    console.log('Reason:', event.reason);
-    console.log('Expires:', event.expiresAt);
+
   },
   onUserUnbanned: (event) => {
-    console.log('User unbanned:', event.userAddress);
+
   },
   onBanEnforcement: (event) => {
     // Received when banned user tries to chat/react
-    console.log('Ban enforced for action:', event.action);
-    console.log('Reason:', event.reason);
+
   },
 });
 \`\`\`
@@ -4555,17 +4223,16 @@ await sdk.login();
 // Create a moderator key for specific tokens
 const result = await sdk.createApiKey({
   role: API_KEY_ROLE.MODERATOR,
-  description: 'Chat moderation bot',
+  description: 'Chat moderation bot.',
   delegateAllTokens: false,
   tokenNames: ['mytoken', 'othertoken'],
   expiresAt: '2025-12-31T23:59:59Z', // Optional expiration
 });
 
 // CRITICAL: Save this immediately - shown only once!
-console.log('Raw Key:', result.rawKey);
+
 // Format: glp_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
-console.log('Key ID:', result.id);
-console.log('Prefix:', result.keyPrefix);
+
 \`\`\`
 
 ## Role Hierarchy
@@ -4598,14 +4265,14 @@ const canOwn = roleHasSufficientPermission('MODERATOR', 'OWNER');      // false
 // Delegate all tokens (current and future)
 const allTokensKey = await sdk.createApiKey({
   role: API_KEY_ROLE.MODERATOR,
-  description: 'All tokens moderator',
+  description: 'All tokens moderator.',
   delegateAllTokens: true,
 });
 
 // Delegate specific tokens only
 const specificKey = await sdk.createApiKey({
   role: API_KEY_ROLE.MANAGER,
-  description: 'Project manager for specific tokens',
+  description: 'Project manager for specific tokens.',
   delegateAllTokens: false,
   tokenNames: ['token1', 'token2', 'token3'], // Case-insensitive
 });
@@ -4619,18 +4286,14 @@ const list = await sdk.listApiKeys({
   page: 1,
   limit: 20,
 });
-console.log('Total keys:', list.meta.total);
 
 for (const key of list.apiKeys) {
-  console.log(\`- \${key.keyPrefix}: \${key.role}\`);
-  console.log(\`  Description: \${key.description || 'None'}\`);
-  console.log(\`  Last used: \${key.lastUsedAt || 'Never'}\`);
-  console.log(\`  Expires: \${key.expiresAt || 'Never'}\`);
+
 }
 
 // Get single API key by ID
 const key = await sdk.getApiKey(123);
-console.log('Key details:', key);
+
 \`\`\`
 
 ## Updating API Keys
@@ -4638,7 +4301,7 @@ console.log('Key details:', key);
 \`\`\`typescript
 // Update description
 const updated = await sdk.updateApiKey(123, {
-  description: 'Updated description',
+  description: 'Updated description.',
 });
 
 // Upgrade role
@@ -4673,7 +4336,6 @@ await sdk.updateApiKey(123, {
 \`\`\`typescript
 // Revoke (soft delete) an API key
 await sdk.revokeApiKey(123);
-console.log('API key revoked');
 
 // Key is now unusable - attempts to use it will fail with 401
 \`\`\`
@@ -4683,7 +4345,7 @@ console.log('API key revoked');
 \`\`\`typescript
 // Get list of valid roles
 const roles = sdk.getApiKeyRoles();
-console.log('Available roles:', roles);
+
 // ['MODERATOR', 'TECHNICAL_PRODUCER', 'MANAGER', 'OWNER']
 \`\`\`
 
@@ -4698,13 +4360,13 @@ import {
 
 // Validate role string
 if (isValidApiKeyRole('MODERATOR')) {
-  console.log('Valid role');
+
 }
 
 // Validate creation options
 const createErrors = validateCreateApiKeyOptions({
   role: 'MODERATOR',
-  description: 'Test key',
+  description: 'Test key.',
 });
 if (createErrors.length > 0) {
   console.error('Validation errors:', createErrors);
@@ -4767,14 +4429,12 @@ await sdk.login();
 const result = await sdk.createModeratorInvite({
   tokenName: 'mytoken',
   role: MODERATOR_ROLE.MODERATOR,
-  description: 'John - Friday stream moderator',
+  description: 'John - Friday stream moderator.',
   expiresAt: '2025-12-31T23:59:59Z', // Optional expiration
 });
 
 // Share this URL with the intended moderator
-console.log('Invite URL:', result.invite.inviteUrl);
-console.log('Invite Code:', result.invite.inviteCode);
-console.log('Status:', result.invite.status); // PENDING
+
 \`\`\`
 
 ## Moderator Roles
@@ -4799,14 +4459,8 @@ const list = await sdk.listModeratorInvites({
   limit: 20,
 });
 
-console.log('Total invites:', list.meta.totalItems);
-
 for (const invite of list.invites) {
-  console.log(\`- ID \${invite.id}: \${invite.role}\`);
-  console.log(\`  Status: \${invite.status}\`);
-  console.log(\`  Description: \${invite.description || 'None'}\`);
-  console.log(\`  Created: \${invite.createdAt}\`);
-  console.log(\`  Expires: \${invite.expiresAt || 'Never'}\`);
+
 }
 \`\`\`
 
@@ -4823,9 +4477,6 @@ const result = await sdk.claimModeratorInvite({
   inviteCode: inviteCode,
 });
 
-console.log('Claimed token:', result.token.tokenName);
-console.log('Your role:', result.token.role);
-console.log('Claimed at:', result.token.claimedAt);
 // Token now appears in /studio dashboard
 \`\`\`
 
@@ -4835,11 +4486,6 @@ console.log('Claimed at:', result.token.claimedAt);
 // Preview invite details before logging in (public endpoint)
 const preview = await sdk.getModeratorInviteByCode('abc123...');
 
-console.log('Token:', preview.tokenName);
-console.log('Symbol:', preview.tokenSymbol);
-console.log('Role offered:', preview.role);
-console.log('Status:', preview.status);
-console.log('Invited by:', preview.invitedBy.fullName);
 \`\`\`
 
 ## Getting Moderated Tokens (Studio Dashboard)
@@ -4854,9 +4500,7 @@ const tokens = await sdk.getModeratedTokens({
 });
 
 for (const token of tokens.tokens) {
-  console.log(\`- \${token.tokenName} (\${token.tokenSymbol})\`);
-  console.log(\`  Role: \${token.role}\`);
-  console.log(\`  Stream status: \${token.muxStreamStatus}\`);
+
 }
 \`\`\`
 
@@ -4865,7 +4509,6 @@ for (const token of tokens.tokens) {
 \`\`\`typescript
 // Revoke by invite ID (owner only)
 await sdk.revokeModeratorInvite(123);
-console.log('Invite revoked');
 
 // If already claimed, moderator loses access immediately
 // If pending, invite can no longer be claimed
@@ -4917,18 +4560,16 @@ const sdk = createLaunchpadSDK({
 
 // Option 1: Using Admin API key
 const result = await sdk.createOverseerInvite({
-  description: 'John - Platform Support Team',
+  description: 'John - Platform Support Team.',
   expiresAt: '2025-12-31T23:59:59Z', // Optional
 });
 
 // Option 2: Using JWT (as existing Overseer)
 await sdk.login();
 const result = await sdk.createOverseerInvite({
-  description: 'Platform team member',
+  description: 'Platform team member.',
 });
 
-console.log('Share this link:', result.invite.inviteUrl);
-console.log('Invite Code:', result.invite.inviteCode);
 \`\`\`
 
 ## Claiming Overseer Invites
@@ -4939,13 +4580,10 @@ await sdk.login();
 
 // Claim the invite
 const claimed = await sdk.claimOverseerInvite('abc123...');
-console.log('Now an overseer!');
-console.log('Status:', claimed.invite.status); // CLAIMED
 
 // Check own status
 const status = await sdk.getMyOverseerStatus();
-console.log('Is Overseer:', status.isOverseer); // true
-console.log('Granted at:', status.overseer?.createdAt);
+
 \`\`\`
 
 ## Listing Overseers and Invites
@@ -4959,9 +4597,7 @@ const invites = await sdk.listOverseerInvites({
 });
 
 for (const invite of invites.invites) {
-  console.log(\`#\${invite.id}: \${invite.description || 'No description'}\`);
-  console.log(\`  Status: \${invite.status}\`);
-  console.log(\`  Created by: \${invite.invitedBy.fullName || invite.invitedBy.address}\`);
+
 }
 
 // List all active overseers
@@ -4972,8 +4608,7 @@ const overseers = await sdk.listOverseers({
 });
 
 for (const overseer of overseers.overseers) {
-  console.log(\`Overseer: \${overseer.userAddress}\`);
-  console.log(\`  Since: \${overseer.createdAt}\`);
+
 }
 \`\`\`
 
@@ -4983,10 +4618,6 @@ for (const overseer of overseers.overseers) {
 // Get public info about an invite (no auth required)
 const preview = await sdk.getOverseerInviteByCode('abc123...');
 
-console.log('Status:', preview.status);
-console.log('Description:', preview.description);
-console.log('Invited by:', preview.invitedBy.fullName);
-console.log('Expires:', preview.expiresAt);
 \`\`\`
 
 ## Revoking Access
@@ -4994,11 +4625,10 @@ console.log('Expires:', preview.expiresAt);
 \`\`\`typescript
 // Revoke an invite by ID
 await sdk.revokeOverseerInvite(123);
-console.log('Invite revoked');
 
 // Revoke an overseer by wallet address
 await sdk.revokeOverseer('eth|1234567890abcdef...');
-console.log('Overseer access revoked');
+
 \`\`\`
 
 ## SDK Methods Reference
@@ -5057,8 +4687,6 @@ const flag = await sdk.createFlag({
   reason: 'Spam/harassment',
 });
 
-console.log('Flag ID:', flag.id);
-console.log('Status:', flag.status); // PENDING
 \`\`\`
 
 ## Listing Flags
@@ -5073,9 +4701,7 @@ const flags = await sdk.listFlags({
 });
 
 for (const flag of flags.flags) {
-  console.log(\`Flag #\${flag.id}: \${flag.contentType}\`);
-  console.log(\`  Reason: \${flag.reason}\`);
-  console.log(\`  Reporter: \${flag.reporterAddress}\`);
+
 }
 \`\`\`
 
@@ -5116,14 +4742,12 @@ const comments = await sdk.getComments({
 });
 
 for (const comment of comments.comments) {
-  console.log(\`ID: \${comment.id}, MessageId: \${comment.messageId}\`);
-  console.log(\`\${comment.userAddress}: \${comment.content}\`);
 
   // Check reactions on this comment
   if (comment.reactions) {
-    console.log(\`Total reactions: \${comment.reactions.totalCount}\`);
+
     for (const reaction of comment.reactions.reactions) {
-      console.log(\`  \${reaction.reactionType}: \${reaction.count} (you reacted: \${reaction.userReacted})\`);
+
     }
   }
 }
@@ -5134,7 +4758,6 @@ const newComment = await sdk.createComment({
   tokenName: 'mytoken',
   content: 'Great project! Looking forward to the launch.',
 });
-console.log('Comment messageId:', newComment.comment.messageId);
 
 // Add a reaction to a comment using its messageId
 await sdk.addReaction({
@@ -5196,9 +4819,8 @@ const result = await sdk.getTrades({
   page: 1
 });
 
-console.log(\`Found \${result.trades.length} trades\`);
 for (const trade of result.trades) {
-  console.log(\`\${trade.txnType}: \${trade.inputAmount} → \${trade.outputAmount}\`);
+
 }
 \`\`\`
 
@@ -5248,16 +4870,15 @@ const userTrades = await sdk.getTrades({
 ### Pagination
 
 \`\`\`typescript
-// Paginate through all trades
-let page = 1;
+// Paginate through all trades using offset-based pagination
+let offset = 0;
 let hasMore = true;
 
 while (hasMore) {
-  const result = await sdk.getTrades({ tokenName: 'anime', page, limit: 50 });
-  console.log(\`Page \${page}: \${result.trades.length} trades\`);
+  const result = await sdk.getTrades({ tokenName: 'anime', offset, limit: 50 });
 
   hasMore = result.trades.length === 50;
-  page++;
+  offset += 50;
 }
 \`\`\`
 
@@ -5306,9 +4927,6 @@ const result = await sdk.banToken({
   tokenName: 'scamtoken',
   reason: 'Fraudulent project - reported by multiple users',
 });
-console.log('Token banned:', result.tokenName);
-console.log('Ban ID:', result.ban.id);
-console.log('Banned by:', result.ban.bannedBy);
 
 // Ban without reason (optional)
 await sdk.banToken({ tokenName: 'problematictoken' });
@@ -5319,8 +4937,6 @@ await sdk.banToken({ tokenName: 'problematictoken' });
 \`\`\`typescript
 // Remove a token ban
 const result = await sdk.unbanToken({ tokenName: 'scamtoken' });
-console.log('Ban removed:', result.removed); // true
-console.log('Token:', result.tokenName);
 
 // Token is now:
 // - Visible in pool listings again
@@ -5336,12 +4952,9 @@ console.log('Token:', result.tokenName);
 const status = await sdk.isTokenBanned({ tokenName: 'sometoken' });
 
 if (status.banned) {
-  console.log('Token is banned!');
-  console.log('Reason:', status.ban?.reason);
-  console.log('Banned by:', status.ban?.bannedBy);
-  console.log('Banned at:', status.ban?.createdAt);
+
 } else {
-  console.log('Token is not banned');
+
 }
 
 // getTokenBan is an alias - use whichever is more readable
@@ -5353,12 +4966,9 @@ const details = await sdk.getTokenBan({ tokenName: 'sometoken' });
 \`\`\`typescript
 // Get first page with default limit (20)
 const page1 = await sdk.listTokenBans({});
-console.log('Total banned tokens:', page1.meta.total);
 
 for (const ban of page1.items) {
-  console.log(\`- \${ban.tokenName}: \${ban.reason || 'No reason'}\`);
-  console.log(\`  Banned by: \${ban.bannedBy}\`);
-  console.log(\`  Date: \${ban.createdAt}\`);
+
 }
 
 // Search for specific tokens (partial match, case-insensitive)
@@ -5369,16 +4979,16 @@ const searchResults = await sdk.listTokenBans({
 });
 
 // Paginate through all banned tokens
-let page = 1;
+let cursor: string | undefined;
 let hasMore = true;
 while (hasMore) {
-  const results = await sdk.listTokenBans({ page, limit: 20 });
-  console.log(\`Page \${page}: \${results.items.length} bans\`);
+  const results = await sdk.listTokenBans({ cursor, limit: 20 });
+
   for (const ban of results.items) {
-    console.log(\`  - \${ban.tokenName}\`);
+
   }
-  hasMore = page < results.meta.totalPages;
-  page++;
+  hasMore = results.pageInfo.hasNextPage;
+  cursor = results.pageInfo.nextCursor;
 }
 \`\`\`
 
@@ -5422,11 +5032,10 @@ const sdk = createLaunchpadSDK({ privateKey: 'your-private-key' });
 
 // Check if a collection name is available
 const available = await sdk.isNftCollectionAvailable('MyEpicNFTs');
-console.log('Collection available:', available);
 
 // Get fee for claiming a collection
 const claimFee = await sdk.getNftCollectionClaimFee();
-console.log('Claim fee:', claimFee); // Usually "10000" GALA
+
 \`\`\`
 
 ## Claim a Collection
@@ -5435,16 +5044,13 @@ console.log('Claim fee:', claimFee); // Usually "10000" GALA
 // Claim an available collection name
 const result = await sdk.claimNftCollection({
   collectionName: 'MyEpicNFTs',
-  description: 'Epic NFT collection for gaming',
+  description: 'Epic NFT collection for gaming.',
 });
-console.log('Collection claimed:', result.collectionName);
-console.log('Transaction ID:', result.transactionId);
 
 // Fetch your owned collections
 const collections = await sdk.fetchNftCollections(walletAddress);
 for (const collection of collections) {
-  console.log(\`Collection: \${collection.collectionName}\`);
-  console.log(\`  Status: \${collection.status}\`);
+
 }
 \`\`\`
 
@@ -5453,13 +5059,12 @@ for (const collection of collections) {
 \`\`\`typescript
 // Get fee for creating a token class
 const classCreateFee = await sdk.getNftTokenClassCreateFee();
-console.log('Create fee:', classCreateFee); // Usually "1000" GALA
 
 // Create a token class (rarity tier)
 const classResult = await sdk.createNftTokenClass({
   collectionName: 'MyEpicNFTs',
   tokenClassName: 'LegendaryWizard',
-  description: 'Ultra-rare legendary wizard NFTs',
+  description: 'Ultra-rare legendary wizard NFTs.',
   maximumSupply: '100',  // Max NFTs of this type
   data: {
     rarity: 'legendary',
@@ -5467,15 +5072,13 @@ const classResult = await sdk.createNftTokenClass({
     power: '9000',
   },
 });
-console.log('Token class created:', classResult.tokenClassName);
 
 // Fetch token classes for your collection
 const classes = await sdk.fetchNftTokenClasses({
   collectionName: 'MyEpicNFTs',
 });
 for (const tokenClass of classes) {
-  console.log(\`Class: \${tokenClass.tokenClassName}\`);
-  console.log(\`  Current Supply: \${tokenClass.currentSupply}/\${tokenClass.maxSupply}\`);
+
 }
 \`\`\`
 
@@ -5488,7 +5091,6 @@ const mintFeeEstimate = await sdk.estimateNftMintFee({
   tokenClassName: 'LegendaryWizard',
   quantity: 5,
 });
-console.log('Estimated mint fee:', mintFeeEstimate); // Dynamic fee in GALA
 
 // Estimate multiple operations at once
 const bundleFee = await sdk.estimateNftOperationFees({
@@ -5498,9 +5100,9 @@ const bundleFee = await sdk.estimateNftOperationFees({
     { type: 'mint', quantity: 10 },
   ],
 });
-console.log('Total bundle fee:', bundleFee.totalFee);
+
 for (const op of bundleFee.breakdown) {
-  console.log(\`  \${op.operationType}: \${op.fee}\`);
+
 }
 \`\`\`
 
@@ -5520,13 +5122,11 @@ const mintResult = await sdk.mintNft({
     ],
   },
 });
-console.log('Minted:', mintResult.quantityMinted);
-console.log('Transaction ID:', mintResult.transactionId);
 
 // Check NFT balances
 const balances = await sdk.fetchNftBalances(walletAddress);
 for (const balance of balances) {
-  console.log(\`\${balance.collectionName}/\${balance.tokenClassName}: \${balance.quantity}\`);
+
 }
 
 // Filter by collection
@@ -5543,18 +5143,16 @@ if (!available) throw new Error('Collection name taken');
 // 2. Claim collection (10,000 GALA)
 const claimResult = await sdk.claimNftCollection({
   collectionName: 'MyEpicNFTs',
-  description: 'My epic NFT collection',
+  description: 'My epic NFT collection.',
 });
-console.log('✓ Collection claimed');
 
 // 3. Create token class (1,000 GALA)
 const classResult = await sdk.createNftTokenClass({
   collectionName: 'MyEpicNFTs',
   tokenClassName: 'Legendary',
-  description: 'Legendary tier NFTs',
+  description: 'Legendary tier NFTs.',
   maximumSupply: '1000',
 });
-console.log('✓ Token class created');
 
 // 4. Estimate mint fee
 const fee = await sdk.estimateNftMintFee({
@@ -5562,7 +5160,6 @@ const fee = await sdk.estimateNftMintFee({
   tokenClassName: 'Legendary',
   quantity: 100,
 });
-console.log(\`✓ Mint fee: \${fee} GALA\`);
 
 // 5. Mint NFTs
 const mintResult = await sdk.mintNft({
@@ -5571,11 +5168,10 @@ const mintResult = await sdk.mintNft({
   quantity: 100,
   to: userWallet,
 });
-console.log('✓ Minted:', mintResult.quantityMinted);
 
 // 6. Verify ownership
 const balances = await sdk.fetchNftBalances(userWallet, 'MyEpicNFTs');
-console.log('Total NFTs:', balances.reduce((sum, b) => sum + parseInt(b.quantity), 0));
+
 \`\`\`
 
 **MCP Tool Equivalents:**
@@ -5590,6 +5186,226 @@ console.log('Total NFTs:', balances.reduce((sum, b) => sum + parseInt(b.quantity
 - \`gala_launchpad_fetch_nft_token_classes\`
 - \`gala_launchpad_mint_nft\`
 - \`gala_launchpad_fetch_nft_balances\`
+`,
+    // ============================================================================
+    // TOKEN IDENTIFICATION: Understanding Token Formats (v5.14.0+)
+    // ============================================================================
+    // These conceptual topics help AI assistants understand when to use which
+    // token identifier format (tokenName vs tokenClassKey).
+    // ============================================================================
+    'token-identification': `
+# Token Identification in Launchpad SDK
+
+The SDK uses **TWO distinct token identifier formats**. Using the wrong format causes errors.
+
+## Format 1: Token Name (Launchpad/Bonding Curve Tokens)
+
+- **Format**: Simple lowercase string, 3-20 alphanumeric characters
+- **Examples**: \`"anime"\`, \`"demonkpop"\`, \`"shoewars"\`
+- **Parameter**: Usually \`tokenName\`
+- **Used for**: Bonding curve operations (before graduation)
+
+\`\`\`typescript
+// ✅ CORRECT - Bonding curve buy
+await sdk.buy({ tokenName: 'anime', amount: '100', type: 'native' });
+
+// ✅ CORRECT - Bonding curve sell
+await sdk.sell({ tokenName: 'anime', amount: '50', type: 'tokens' });
+
+// ✅ CORRECT - Check pool status
+const pool = await sdk.fetchPools({ tokenName: 'anime' });
+\`\`\`
+
+## Format 2: TokenClassKey (GalaChain/DEX Tokens)
+
+- **Format**: Pipe-delimited string: \`collection|category|type|additionalKey\`
+- **Examples**: \`"GALA|Unit|none|none"\`, \`"GUSDC|Unit|none|eth:0xa0b..."\`
+- **Parameter**: Usually \`tokenId\`, \`fromToken\`, \`toToken\`
+- **Used for**: DEX swaps, LP operations, standard GalaChain tokens
+
+\`\`\`typescript
+// ✅ CORRECT - DEX swap (requires full tokenClassKey)
+const quote = await sdk.getSwapQuoteExactInput('GALA|Unit|none|none', 'GUSDC|Unit|none|eth:0xa0b...', '100');
+await sdk.executeSwap('GALA|Unit|none|none', 'GUSDC|Unit|none|eth:0xa0b...', '100', quote.estimatedOutput, quote.feeTier);
+
+// ✅ CORRECT - Add DEX liquidity
+await sdk.addSwapLiquidityByPrice({
+  token0: 'GALA|Unit|none|none',
+  token1: 'GUSDC|Unit|none|eth:0xa0b...',
+  fee: 3000,
+  minPrice: '0.01',
+  maxPrice: '0.05',
+  amount0Desired: '1000',
+  amount1Desired: '50'
+});
+\`\`\`
+
+## Common Mistakes
+
+\`\`\`typescript
+// ❌ WRONG - Bare symbol for DEX (throws ValidationError)
+await sdk.executeSwap('GALA', 'GUSDC', '100', output, fee);
+
+// ❌ WRONG - TokenClassKey for bonding curve
+await sdk.buy({ tokenName: 'Token|Unit|ANIME|client:gala-launchpad', amount: '100' });
+
+// ❌ WRONG - Simple name for DEX quote
+await sdk.getSwapQuoteExactInput('anime', 'GALA|Unit|none|none', '100');
+\`\`\`
+
+## Method-to-Format Quick Reference
+
+| Method | tokenName | tokenClassKey | Notes |
+|--------|:---------:|:-------------:|-------|
+| \`buy()\` | ✅ | ❌ | Bonding curve only |
+| \`sell()\` | ✅ | ❌ | Bonding curve only |
+| \`graduateToken()\` | ✅ | ❌ | Triggers DEX migration |
+| \`executeSwap()\` | ❌ | ✅ | DEX only |
+| \`getSwapQuote*()\` | ❌ | ✅ | DEX quotes |
+| \`addSwapLiquidity*()\` | ❌ | ✅ | LP operations |
+| \`transferToken()\` | ✅ | ✅ | Both work |
+| \`fetchTokenPrice()\` | ✅ | ✅ | Smart router |
+
+## Getting TokenClassKey for a Graduated Token
+
+**⚠️ IMPORTANT: Never construct a tokenClassKey manually!**
+
+The tokenClassKey contains the token's **symbol** (set at creation), which may differ
+from the tokenName. Always query for it:
+
+\`\`\`typescript
+// From pool data after graduation (RECOMMENDED)
+const pool = await sdk.fetchPools({ tokenName: 'anime' });
+const tokenClassKey = pool.items[0]?.tokenClassKey;
+// → Returns the actual tokenClassKey (symbol may differ from tokenName!)
+
+// Or use the resolver
+const resolved = await sdk.resolveTokenClassKey('anime');
+// → Queries backend for the correct tokenClassKey
+\`\`\`
+
+## Well-Known Token Constants
+
+\`\`\`typescript
+const GALA = 'GALA|Unit|none|none';
+const GUSDC = 'GUSDC|Unit|none|eth:0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48';
+const WETH = 'GETH|Unit|none|eth:0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2';
+\`\`\`
+
+**See Also:** \`src/types/token.types.ts\` for full type definitions and utilities.
+`,
+    'graduation-detection': `
+# Detecting Token Graduation Status
+
+Launchpad tokens transition from bonding curve to DEX when they "graduate."
+This affects which SDK methods work and which token format to use.
+
+## Checking Graduation Status
+
+\`\`\`typescript
+import { createLaunchpadSDK } from '@gala-chain/launchpad-sdk';
+
+async function checkGraduationStatus(tokenName: string) {
+  const sdk = createLaunchpadSDK();
+
+  // Method 1: Check via pool data (recommended)
+  const pool = await sdk.fetchPools({ tokenName });
+  const isGraduated = pool.items[0]?.isGraduated ?? false;
+
+  // Method 2: Use the helper method
+  const graduated = await sdk.isTokenGraduated(tokenName);
+
+  return graduated;
+}
+\`\`\`
+
+## Handling Graduated vs Non-Graduated Tokens
+
+\`\`\`typescript
+async function tradeToken(tokenName: string, galaAmount: string) {
+  const sdk = createLaunchpadSDK({ wallet: 'your-private-key' });
+
+  // Check graduation status first
+  const pool = await sdk.fetchPools({ tokenName });
+  const isGraduated = pool.items[0]?.isGraduated ?? false;
+
+  if (isGraduated) {
+    // Token is on DEX - use tokenClassKey format
+    const tokenClassKey = pool.items[0]?.tokenClassKey;
+    if (!tokenClassKey) throw new Error('Token graduated but no tokenClassKey found');
+
+    const quote = await sdk.getSwapQuoteExactInput(
+      'GALA|Unit|none|none',
+      tokenClassKey,
+      galaAmount
+    );
+
+    const result = await sdk.executeSwap(
+      'GALA|Unit|none|none',
+      tokenClassKey,
+      galaAmount,
+      quote.estimatedOutput,
+      quote.feeTier
+    );
+
+    return { method: 'DEX', result };
+  } else {
+    // Token is on bonding curve - use simple tokenName
+    const calc = await sdk.calculateBuyAmount({
+      tokenName,
+      amount: galaAmount,
+      type: 'native'
+    });
+
+    const result = await sdk.buy({
+      tokenName,
+      amount: galaAmount,
+      type: 'native',
+      expectedAmount: calc.amount,
+      slippageToleranceFactor: 0.01
+    });
+
+    return { method: 'BondingCurve', result };
+  }
+}
+\`\`\`
+
+## Subscribing to Graduation Events
+
+\`\`\`typescript
+// Listen for new DEX pool creation (graduation event)
+sdk.onDexPoolCreation((event) => {
+  console.log(\`Token graduated: \${event.tokenName}\`);
+  console.log(\`New tokenClassKey: \${event.tokenClassKey}\`);
+  // Update your local state to use DEX trading
+});
+
+// Listen for new launchpad token creation
+sdk.onLaunchpadTokenCreation((event) => {
+  console.log(\`New token launched: \${event.tokenName}\`);
+  // This token is on bonding curve, use tokenName
+});
+\`\`\`
+
+## Key Differences: Pre vs Post Graduation
+
+| Aspect | Pre-Graduation | Post-Graduation |
+|--------|----------------|-----------------|
+| Trading venue | Bonding curve | GalaSwap DEX |
+| Token format | \`tokenName\` ("anime") | \`tokenClassKey\` ("Token\\|Unit\\|ANIME\\|...") |
+| Buy method | \`sdk.buy()\` | \`sdk.executeSwap()\` |
+| Sell method | \`sdk.sell()\` | \`sdk.executeSwap()\` |
+| Liquidity | None | LP positions available |
+| Price source | Bonding curve formula | DEX pool |
+
+## Why This Matters
+
+- **Wrong format = Error**: Using tokenName for DEX throws \`ValidationError\`
+- **Wrong method = Error**: Using \`buy()\` for graduated token may fail
+- **Performance**: Checking graduation once avoids repeated API calls
+- **User experience**: Show appropriate UI based on trading venue
+
+**Related Topics:** \`token-identification\`, \`dex-trading\`, \`buy-tokens\`, \`pool-graduation\`
 `,
 };
 /**
@@ -5597,7 +5413,7 @@ console.log('Total NFTs:', balances.reduce((sum, b) => sum + parseInt(b.quantity
  */
 exports.explainSdkUsageTool = {
     name: 'gala_launchpad_explain_sdk_usage',
-    description: 'Get detailed SDK code examples for all 224 MCP tools (mapping to ~208 SDK methods) organized into 49 composite workflow topics covering: buy-tokens, sell-tokens, pool-graduation, fetch-pools, balances, token-creation, token-status, dex-trading, liquidity-positions, advanced-dex-analysis, price-history, token-details, token-distribution, profile-management, multi-wallet, transfers, locks, trading-analytics, utilities-and-helpers, utilities-system, error-handling, installation, local-calculations, spot-prices-smart-routing, event-subscriptions, mcp-to-sdk-mapping, DEX leaderboards, bridge-operations, dex-token-discovery, wrap-unwrap-operations, referral-system, account-management, session-auth, streaming, stream-chat, ban-management, api-key-management, moderator-invites, overseer-invites, content-flag-management, content-reactions, trade-history, token-ban-management, and nft-collection-management',
+    description: 'Get detailed SDK code examples for all 224 MCP tools (mapping to ~208 SDK methods) organized into 51 composite workflow topics covering: buy-tokens, sell-tokens, pool-graduation, fetch-pools, balances, token-creation, token-status, dex-trading, liquidity-positions, advanced-dex-analysis, price-history, token-details, token-distribution, profile-management, multi-wallet, transfers, locks, trading-analytics, utilities-and-helpers, utilities-system, error-handling, installation, local-calculations, spot-prices-smart-routing, event-subscriptions, mcp-to-sdk-mapping, DEX leaderboards, bridge-operations, dex-token-discovery, wrap-unwrap-operations, referral-system, account-management, session-auth, streaming, stream-chat, ban-management, api-key-management, moderator-invites, overseer-invites, content-flag-management, content-reactions, trade-history, token-ban-management, nft-collection-management, token-identification (explains tokenName vs tokenClassKey formats), and graduation-detection (how to check if a token has graduated from bonding curve to DEX).',
     inputSchema: {
         type: 'object',
         properties: {
@@ -5653,8 +5469,10 @@ exports.explainSdkUsageTool = {
                     'trade-history',
                     'token-ban-management',
                     'nft-collection-management',
+                    'token-identification',
+                    'graduation-detection',
                 ],
-                description: 'The SDK usage topic to explain',
+                description: 'The SDK usage topic to explain.',
             },
         },
         required: ['topic'],