@gala-chain/launchpad-mcp-server 1.23.1 → 1.24.0

package/src/tools/pools/index.ts

@@ -0,0 +1,284 @@
+/**
+ * Pool Management Tools
+ */
+
+import { POOL_TYPES } from '@gala-chain/launchpad-sdk';
+import type { MCPTool } from '../../types/mcp.js';
+import { formatSuccess } from '../../utils/response-formatter.js';
+import { withErrorHandling } from '../../utils/error-handler.js';
+import {
+  TOKEN_NAME_SCHEMA,
+  TOKEN_SYMBOL_SCHEMA,
+  ADDRESS_SCHEMA,
+  PAGE_SCHEMA,
+  createLimitSchema,
+  CALCULATION_MODE_SCHEMA,
+  CURRENT_SUPPLY_SCHEMA,
+} from '../../schemas/common-schemas.js';
+import { fetchPoolDetailsForCalculationTool } from './fetchPoolDetailsForCalculation.js';
+import { fetchAllPoolsTool } from './fetchAllPools.js';
+import { fetchPriceHistoryTool } from './fetchPriceHistory.js';
+import { fetchAllPriceHistoryTool } from './fetchAllPriceHistory.js';
+import { fetchTokenDetailsTool } from './fetchTokenDetails.js';
+import {
+  createSimpleTokenFetchTool,
+  createBooleanCheckTool,
+  createResolutionTool,
+  createNoParamTool,
+} from '../../utils/tool-factory.js';
+import { resolutionToSeconds, dateToUnixTimestamp, DEFAULT_VOLUME_RESOLUTION } from '../../utils/default-values.js';
+
+// 1. Fetch Pools
+export const fetchPoolsTool: MCPTool = {
+  name: 'gala_launchpad_fetch_pools',
+  description: 'Fetch token pools from Gala Launchpad with filtering and pagination',
+  inputSchema: {
+    type: 'object',
+    properties: {
+      type: {
+        type: 'string',
+        enum: Object.values(POOL_TYPES),
+        description: 'Type of pools to fetch (default: recent)',
+      },
+      creatorAddress: {
+        ...ADDRESS_SCHEMA,
+        description: 'Filter by creator address (optional)',
+      },
+      page: PAGE_SCHEMA,
+      limit: createLimitSchema('pool', 20),
+    },
+  },
+  handler: withErrorHandling(async (sdk, args) => {
+    const result = await sdk.fetchPools({
+      type: args.type || 'recent',
+      page: args.page || 1,
+      limit: args.limit || 20,
+    });
+    return formatSuccess(result);
+  }),
+};
+
+// 2. Fetch Pool Details (73% code reduction via factory pattern)
+export const fetchPoolDetailsTool = createSimpleTokenFetchTool({
+  name: 'gala_launchpad_fetch_pool_details',
+  description: 'Get detailed pool state from GalaChain bonding curve',
+  handler: (sdk, tokenName) => sdk.fetchPoolDetails(tokenName),
+});
+
+// 3. Fetch Token Distribution (73% code reduction via factory pattern)
+export const fetchTokenDistributionTool = createSimpleTokenFetchTool({
+  name: 'gala_launchpad_fetch_token_distribution',
+  description: 'Get holder distribution and supply metrics',
+  handler: (sdk, tokenName) => sdk.fetchTokenDistribution(tokenName),
+});
+
+// 4. Fetch Token Badges (73% code reduction via factory pattern)
+export const fetchTokenBadgesTool = createSimpleTokenFetchTool({
+  name: 'gala_launchpad_fetch_token_badges',
+  description: 'Get achievement badges for volume and engagement',
+  handler: (sdk, tokenName) => sdk.fetchTokenBadges(tokenName),
+});
+
+// 5. Fetch Volume Data (using centralized default values utilities)
+export const fetchVolumeDataTool: MCPTool = {
+  name: 'gala_launchpad_fetch_volume_data',
+  description: 'Get OHLCV (candlestick) data for charting',
+  inputSchema: {
+    type: 'object',
+    properties: {
+      tokenName: TOKEN_NAME_SCHEMA,
+      from: {
+        type: 'string',
+        format: 'date-time',
+        description: 'Start date (ISO 8601)',
+      },
+      to: {
+        type: 'string',
+        format: 'date-time',
+        description: 'End date (ISO 8601)',
+      },
+      resolution: {
+        type: 'string',
+        enum: ['1m', '5m', '15m', '1h', '4h', '1d'],
+        description: 'Time resolution (default: 1h)',
+      },
+    },
+    required: ['tokenName'],
+  },
+  handler: withErrorHandling(async (sdk, args) => {
+    const result = await sdk.fetchVolumeData({
+      tokenName: args.tokenName,
+      from: dateToUnixTimestamp(args.from),
+      to: dateToUnixTimestamp(args.to),
+      resolution: resolutionToSeconds(args.resolution, DEFAULT_VOLUME_RESOLUTION),
+    });
+    return formatSuccess(result);
+  }),
+};
+
+// 6. Fetch Token Spot Price (Smart Router - Launchpad or DEX)
+export const fetchTokenPriceTool: MCPTool = {
+  name: 'gala_launchpad_fetch_token_spot_price',
+  description: `Fetch USD spot price for ANY token with smart routing
+
+Routes to the correct backend automatically:
+- **tokenName** → Launchpad token (detects graduation status)
+- **tokenId** → DEX token via /v1/trade/price endpoint`,
+  inputSchema: {
+    type: 'object',
+    properties: {
+      tokenName: {
+        ...TOKEN_NAME_SCHEMA,
+        description: 'Launchpad token name (e.g., "galadog", "anime") - auto-detects graduation status',
+      },
+      tokenId: {
+        oneOf: [
+          {
+            type: 'string',
+            description:
+              'Pipe-delimited format: "collection|category|type|additionalKey" (e.g., "Token|Unit|GUSDC|eth:0x...")',
+          },
+          {
+            type: 'object',
+            properties: {
+              collection: {
+                type: 'string',
+                description: 'Token collection (e.g., "Token")',
+              },
+              category: {
+                type: 'string',
+                description: 'Token category (e.g., "Unit")',
+              },
+              type: {
+                type: 'string',
+                description: 'Token type (e.g., "GUSDC")',
+              },
+              additionalKey: {
+                type: 'string',
+                description: 'Additional key (e.g., "eth:0x...")',
+              },
+            },
+            required: ['collection', 'category', 'type', 'additionalKey'],
+            description: 'TokenClassKey object format',
+          },
+        ],
+        description: 'DEX token identifier in flexible format (string or object)',
+      },
+      currentSupply: CURRENT_SUPPLY_SCHEMA,
+      calculateAmountMode: CALCULATION_MODE_SCHEMA,
+    },
+  },
+  handler: withErrorHandling(async (sdk, args) => {
+    const result = await sdk.fetchTokenPrice({
+      tokenName: args.tokenName,
+      tokenId: args.tokenId,
+      currentSupply: args.currentSupply,
+      calculateAmountMode: args.calculateAmountMode,
+    });
+    return formatSuccess(result);
+  }),
+};
+
+// 7. Fetch GALA Spot Price (45% code reduction via factory pattern)
+export const fetchGalaPriceTool = createNoParamTool({
+  name: 'gala_launchpad_fetch_gala_spot_price',
+  description: 'Fetch current GALA USD spot price (convenience method)',
+  handler: (sdk) => sdk.fetchGalaPrice(),
+});
+
+// 8. Fetch Launchpad Token Spot Price (DEPRECATED)
+export const fetchLaunchpadTokenSpotPriceTool: MCPTool = {
+  name: 'gala_launchpad_fetch_launchpad_token_spot_price',
+  description: `⚠️ **DEPRECATED** - Use gala_launchpad_fetch_token_spot_price with { tokenName } instead. Will be removed in v4.0.0.
+
+Fetch USD spot price for a launchpad token by name.
+
+Performance optimization: Provide currentSupply to avoid fetching pool details twice.`,
+  inputSchema: {
+    type: 'object',
+    properties: {
+      tokenName: {
+        ...TOKEN_NAME_SCHEMA,
+        description: 'Token name (e.g., "dragnrkti", "rocketri", "unicornri")',
+      },
+      calculateAmountMode: CALCULATION_MODE_SCHEMA,
+      currentSupply: CURRENT_SUPPLY_SCHEMA,
+    },
+    required: ['tokenName'],
+  },
+  handler: withErrorHandling(async (sdk, args) => {
+    // Build options object only if mode or supply provided
+    const options = args.calculateAmountMode || args.currentSupply
+      ? {
+          tokenName: args.tokenName,
+          calculateAmountMode: args.calculateAmountMode,
+          currentSupply: args.currentSupply,
+        }
+      : args.tokenName;
+
+    const result = await sdk.fetchLaunchpadTokenSpotPrice(options);
+    return formatSuccess(result);
+  }),
+};
+
+// 9. Check Token Name (60% code reduction via factory pattern)
+export const checkTokenNameTool = createBooleanCheckTool({
+  name: 'gala_launchpad_check_token_name',
+  description: 'Check if token name is available',
+  paramName: 'tokenName',
+  paramSchema: TOKEN_NAME_SCHEMA,
+  handler: (sdk, tokenName) => sdk.isTokenNameAvailable(tokenName),
+  messages: {
+    true: 'Token name is available',
+    false: 'Token name is already taken',
+  },
+});
+
+// 10. Check Token Symbol (60% code reduction via factory pattern)
+export const checkTokenSymbolTool = createBooleanCheckTool({
+  name: 'gala_launchpad_check_token_symbol',
+  description: 'Check if token symbol is available',
+  paramName: 'symbol',
+  paramSchema: TOKEN_SYMBOL_SCHEMA,
+  handler: (sdk, symbol) => sdk.isTokenSymbolAvailable(symbol),
+  messages: {
+    true: 'Token symbol is available',
+    false: 'Token symbol is already taken',
+  },
+});
+
+// 11. Resolve Vault Address (73% code reduction via factory pattern)
+export const resolveVaultAddressTool = createResolutionTool({
+  name: 'gala_launchpad_resolve_vault_address',
+  description: 'Get GalaChain vault address for a token (useful for debugging)',
+  resolver: (sdk, tokenName) => sdk.resolveVaultAddress(tokenName),
+  resultKey: 'vaultAddress',
+});
+
+// 12. Resolve Token Class Key (73% code reduction via factory pattern)
+export const resolveTokenClassKeyTool = createResolutionTool({
+  name: 'gala_launchpad_resolve_token_class_key',
+  description: 'Get GalaChain TokenClassKey for a launchpad token (useful for direct GalaChain operations)',
+  resolver: (sdk, tokenName) => sdk.resolveTokenClassKey(tokenName),
+  resultKey: 'tokenClassKey',
+});
+
+export const poolTools: MCPTool[] = [
+  fetchPoolsTool,
+  fetchAllPoolsTool,
+  fetchPoolDetailsTool,
+  fetchPoolDetailsForCalculationTool,
+  fetchTokenDetailsTool,
+  fetchTokenDistributionTool,
+  fetchTokenBadgesTool,
+  fetchVolumeDataTool,
+  fetchTokenPriceTool,
+  fetchGalaPriceTool,
+  fetchLaunchpadTokenSpotPriceTool,
+  fetchPriceHistoryTool,
+  fetchAllPriceHistoryTool,
+  checkTokenNameTool,
+  checkTokenSymbolTool,
+  resolveVaultAddressTool,
+  resolveTokenClassKeyTool,
+];

package/src/tools/social/index.ts

@@ -0,0 +1,64 @@
+/**
+ * Comments & Social Tools
+ */
+
+import type { MCPTool } from '../../types/mcp.js';
+import { formatSuccess } from '../../utils/response-formatter.js';
+import { withErrorHandling } from '../../utils/error-handler.js';
+import {
+  TOKEN_NAME_SCHEMA,
+  COMMENT_MESSAGE_SCHEMA,
+  PRIVATE_KEY_SCHEMA,
+  PAGE_SCHEMA,
+  createLimitSchema,
+} from '../../schemas/common-schemas.js';
+import { applyOperationPaginationDefaults } from '../../utils/default-values.js';
+
+// 1. Post Comment
+export const postCommentTool: MCPTool = {
+  name: 'gala_launchpad_post_comment',
+  description: 'Post a comment on a token pool',
+  inputSchema: {
+    type: 'object',
+    properties: {
+      tokenName: TOKEN_NAME_SCHEMA,
+      message: COMMENT_MESSAGE_SCHEMA,
+      privateKey: PRIVATE_KEY_SCHEMA,
+    },
+    required: ['tokenName', 'message'],
+  },
+  handler: withErrorHandling(async (sdk, args) => {
+    await sdk.postComment({
+      tokenName: args.tokenName,
+      content: args.message, // MCP parameter "message" → SDK parameter "content"
+      privateKey: args.privateKey,
+    });
+    // postComment returns void, so return success message
+    return formatSuccess({ success: true, message: 'Comment posted successfully' });
+  }),
+};
+
+// 2. Fetch Comments (using centralized pagination defaults)
+export const fetchCommentsTool: MCPTool = {
+  name: 'gala_launchpad_fetch_comments',
+  description: 'Get comments for a token pool',
+  inputSchema: {
+    type: 'object',
+    properties: {
+      tokenName: TOKEN_NAME_SCHEMA,
+      page: PAGE_SCHEMA,
+      limit: createLimitSchema('comment', 20),
+    },
+    required: ['tokenName'],
+  },
+  handler: withErrorHandling(async (sdk, args) => {
+    const pagination = applyOperationPaginationDefaults(args, 'comment');
+    const result = await sdk.fetchComments({
+      tokenName: args.tokenName,
+      ...pagination,
+    });
+    return formatSuccess(result);
+  }),
+};
+
+export const socialTools: MCPTool[] = [postCommentTool, fetchCommentsTool];