@gala-chain/launchpad-mcp-server 1.17.5 → 1.17.6

package/dist/generated/version.d.ts

@@ -3,5 +3,5 @@
  * This file is generated by scripts/inject-version.ts during build
  * DO NOT EDIT MANUALLY
  */
-export declare const MCP_SERVER_VERSION = "1.17.5";
+export declare const MCP_SERVER_VERSION = "1.17.6";
 //# sourceMappingURL=version.d.ts.map

package/dist/generated/version.js

@@ -6,5 +6,5 @@
  */
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.MCP_SERVER_VERSION = void 0;
-exports.MCP_SERVER_VERSION = '1.17.5';
+exports.MCP_SERVER_VERSION = '1.17.6';
 //# sourceMappingURL=version.js.map

package/dist/tools/utils/explainSdkUsage.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"explainSdkUsage.d.ts","sourceRoot":"","sources":["../../../src/tools/utils/explainSdkUsage.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AA6qClD;;GAEG;AACH,eAAO,MAAM,mBAAmB,EAAE,OAqEjC,CAAC"}
+{"version":3,"file":"explainSdkUsage.d.ts","sourceRoot":"","sources":["../../../src/tools/utils/explainSdkUsage.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AA4zClD;;GAEG;AACH,eAAO,MAAM,mBAAmB,EAAE,OAqEjC,CAAC"}

package/dist/tools/utils/explainSdkUsage.js

@@ -909,6 +909,148 @@ async function analyzeTokenDetails() {
 - Object: \`{ collection, category, type, additionalKey }\`
 
 **MCP Tool Equivalent:** \`gala_launchpad_fetch_token_details\`
+`,
+    'spot-prices-smart-routing': `
+## Smart Spot Price Routing with DEX Fallback
+
+The SDK intelligently routes pricing requests between DEX and Launchpad backends based on token graduation status - no need to know which backend a token uses!
+
+\`\`\`typescript
+import { createLaunchpadSDK } from '@gala-chain/launchpad-sdk';
+
+async function tokenPricing() {
+  const sdk = createLaunchpadSDK({
+    wallet: 'your-private-key'
+  });
+
+  // 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.fetchTokenSpotPrice({
+    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.fetchTokenSpotPrice({
+    tokenId: 'GALA|Unit|none|none'  // Or other DEX token
+  });
+  console.log(\`DEX Token GALA: $\${dexPrices}\`);
+
+  // OPTION 3: EXPLICIT LAUNCHPAD PRICING - Ungraduated tokens
+  // Use tokenName for launchpad bonding curve tokens
+  console.log('\\n=== Explicit Launchpad Pricing ===');
+  const launchpadPrice = await sdk.fetchLaunchpadTokenSpotPrice('anime');
+  console.log(\`Launchpad token anime: $\${launchpadPrice}\`);
+
+  // ADVANCED: Handle both pricing methods with error recovery
+  console.log('\\n=== Fallback Pricing Strategy ===');
+  async function getPriceWithFallback(tokenId: string, tokenName?: string) {
+    try {
+      // Try DEX pricing first
+      return await sdk.fetchTokenSpotPrice({ tokenId });
+    } catch (error) {
+      // If not on DEX, try launchpad pricing
+      if (tokenName) {
+        try {
+          return await sdk.fetchLaunchpadTokenSpotPrice(tokenName);
+        } catch (fallbackError) {
+          throw new Error(\`Could not fetch price for \${tokenName}\`);
+        }
+      }
+      throw error;
+    }
+  }
+
+  const fallbackPrice = await getPriceWithFallback(
+    'Token|Unit|ANIME|eth:0x...',
+    'anime'
+  );
+  console.log(\`Fallback price: $\${fallbackPrice}\`);
+
+  // USECASE: Price comparison and discovery
+  console.log('\\n=== Price Discovery ===');
+  async function comparePrices(tokenName: string) {
+    const launchpadPrice = await sdk.fetchLaunchpadTokenSpotPrice(tokenName);
+
+    // Check if graduated (on DEX)
+    const isGraduated = await sdk.isTokenGraduated(tokenName);
+
+    if (isGraduated) {
+      const dexPrice = await sdk.fetchTokenSpotPrice({
+        tokenId: \`Token|Unit|\${tokenName.toUpperCase()}|eth:0x...\`
+      });
+      console.log(\`Launchpad: $\${launchpadPrice}, DEX: $\${dexPrice}\`);
+      return { launchpadPrice, dexPrice, graduated: true };
+    } else {
+      console.log(\`Launchpad: $\${launchpadPrice} (not on DEX yet)\`);
+      return { launchpadPrice, graduated: false };
+    }
+  }
+
+  const priceComparison = await comparePrices('anime');
+}
+\`\`\`
+
+**Smart Routing Benefits:**
+- ✅ **Seamless Transitions** - Works before and after token graduation
+- ✅ **No Backend Knowledge** - SDK handles routing automatically
+- ✅ **Error Handling** - Automatic fallback if needed
+- ✅ **Single API** - Use same method for all tokens
+
+**When to Use Each Method:**
+
+| Method | Use Case | Token Status |
+|--------|----------|--------------|
+| \`fetchTokenSpotPrice({ tokenId })\` | Smart routing (recommended) | Any (DEX or Launchpad) |
+| \`fetchLaunchpadTokenSpotPrice(name)\` | Launchpad-only pricing | Ungraduated tokens |
+| \`isTokenGraduated(name)\` | Check token status | Any |
+
+**Key Differences:**
+
+**Ungraduated Tokens (Launchpad):**
+- Priced on exponential bonding curve
+- Token name parameter works: \`fetchLaunchpadTokenSpotPrice('anime')\`
+- Price affected by supply/demand
+
+**Graduated Tokens (DEX):**
+- Priced on DEX via order books
+- Token ID format needed: \`Token|Unit|SYMBOL|eth:0x...\`
+- Market-driven pricing
+
+**Graduation Impact:**
+When a token graduates from launchpad to DEX:
+- Bonding curve closes
+- Trading moves to DEX order books
+- Smart routing automatically switches backends
+- Old launchpad queries will fail (use DEX pricing instead)
+
+**Error Handling:**
+\`\`\`typescript
+async function safePriceQuery(tokenId: string) {
+  try {
+    // Always try smart routing first
+    return await sdk.fetchTokenSpotPrice({ 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;
+  }
+}
+\`\`\`
+
+**MCP Tool Equivalents:**
+- \`gala_launchpad_fetch_token_spot_price\` - Smart routing
+- \`gala_launchpad_fetch_launchpad_token_spot_price\` - Launchpad-only
+- \`gala_launchpad_is_token_graduated\` - Check graduation status
 `,
     'profile-management': `
 ## User Profile Management with SDK

package/dist/tools/utils/explainSdkUsage.js.map

@@ -1 +1 @@
-{"version":3,"file":"explainSdkUsage.js","sourceRoot":"","sources":["../../../src/tools/utils/explainSdkUsage.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"explainSdkUsage.js","sourceRoot":"","sources":["../../../src/tools/utils/explainSdkUsage.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@gala-chain/launchpad-mcp-server",
-  "version": "1.17.5",
+  "version": "1.17.6",
   "description": "MCP server for Gala Launchpad SDK with 55 tools + 14 slash commands - Production-grade AI agent integration with comprehensive validation, optimized performance, and 80%+ test coverage",
   "main": "dist/index.js",
   "bin": {