@gala-chain/launchpad-mcp-server 1.7.15 → 1.8.1

package/src/tools/pools/fetchAllPools.ts

@@ -0,0 +1,47 @@
+/**
+ * Fetch All Pools Tool
+ *
+ * Convenience tool that fetches all available pools with automatic pagination.
+ * Equivalent to calling fetchPools with limit: 0.
+ */
+
+import type { MCPTool } from '../../types/mcp.js';
+import { formatSuccess } from '../../utils/response-formatter.js';
+import { withErrorHandling } from '../../utils/error-handler.js';
+
+export const fetchAllPoolsTool: MCPTool = {
+  name: 'gala_launchpad_fetch_all_pools',
+  description: 'Fetch all available pools with automatic pagination. No page/limit parameters needed - returns ALL pools matching filters.',
+  inputSchema: {
+    type: 'object',
+    properties: {
+      search: {
+        type: 'string',
+        minLength: 1,
+        maxLength: 100,
+        description: 'Optional search query (fuzzy match filter)',
+      },
+      tokenName: {
+        type: 'string',
+        minLength: 3,
+        maxLength: 20,
+        pattern: '^[a-zA-Z0-9]{3,20}$',
+        description: 'Optional token name (exact match filter)',
+      },
+      type: {
+        type: 'string',
+        enum: ['recent', 'popular'],
+        description: 'Type of pools to fetch (default: recent)',
+      },
+    },
+  },
+  handler: withErrorHandling(async (sdk, args) => {
+    const result = await sdk.fetchAllPools({
+      ...(args.search && { search: args.search }),
+      ...(args.tokenName && { tokenName: args.tokenName }),
+      ...(args.type && { type: args.type }),
+    });
+
+    return formatSuccess(result);
+  }),
+};

package/src/tools/pools/fetchPoolDetails.ts

@@ -0,0 +1,27 @@
+/**
+ * Fetch Pool Details Tool
+ */
+
+import type { MCPTool } from '../../types/mcp.js';
+import { formatSuccess } from '../../utils/response-formatter.js';
+import { withErrorHandling } from '../../utils/error-handler.js';
+
+export const fetchPoolDetailsTool: MCPTool = {
+  name: 'gala_launchpad_fetch_pool_details',
+  description: 'Get detailed pool state from GalaChain bonding curve',
+  inputSchema: {
+    type: 'object',
+    properties: {
+      tokenName: {
+        type: 'string',
+        pattern: '^[a-z0-9_-]{2,20}$',
+        description: 'Token name',
+      },
+    },
+    required: ['tokenName'],
+  },
+  handler: withErrorHandling(async (sdk, args) => {
+    const result = await sdk.fetchPoolDetails(args.tokenName);
+    return formatSuccess(result);
+  }),
+};

package/src/tools/pools/fetchPoolDetailsForCalculation.ts

@@ -0,0 +1,22 @@
+/**
+ * Fetch Pool Details for Calculation Tool (73% code reduction via factory pattern)
+ */
+
+import { createSimpleTokenFetchTool } from '../../utils/tool-factory.js';
+
+export const fetchPoolDetailsForCalculationTool = createSimpleTokenFetchTool({
+  name: 'gala_launchpad_fetch_pool_details_for_calculation',
+  description: `Get optimized pool details for local bonding curve calculations.
+
+Returns only essential calculation parameters:
+- currentSupply: Current token supply (computed with full precision)
+- remainingTokens: Tokens available for purchase
+- maxSupply: Maximum token supply
+- reverseBondingCurveMaxFeeFactor: Maximum reverse bonding curve fee (normalized to number)
+- reverseBondingCurveMinFeeFactor: Minimum reverse bonding curve fee (normalized to number)
+- reverseBondingCurveNetFeeFactor: Net fee factor (max - min, for convenience)
+
+This is more efficient than fetchPoolDetails as it returns only fields needed for calculations.
+Perfect for use with calculateBuyAmountLocal and calculateSellAmountLocal.`,
+  handler: (sdk, tokenName) => sdk.fetchPoolDetailsForCalculation(tokenName),
+});

package/src/tools/pools/fetchPools.ts

@@ -0,0 +1,47 @@
+/**
+ * Fetch Pools Tool
+ */
+
+import type { MCPTool } from '../../types/mcp.js';
+import { formatSuccess } from '../../utils/response-formatter.js';
+import { withErrorHandling } from '../../utils/error-handler.js';
+
+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: ['recent', 'trending', 'user'],
+        description: 'Type of pools to fetch (default: recent)',
+      },
+      creatorAddress: {
+        type: 'string',
+        pattern: '^(0x[a-fA-F0-9]{40}|eth\\|[a-fA-F0-9]{40})$',
+        description: 'Filter by creator address (optional)',
+      },
+      page: {
+        type: 'number',
+        minimum: 1,
+        description: 'Page number (default: 1)',
+      },
+      limit: {
+        type: 'number',
+        minimum: 1,
+        maximum: 100,
+        description: 'Results per page (default: 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);
+  }),
+};

package/src/tools/pools/index.ts

@@ -0,0 +1,240 @@
+/**
+ * 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 {
+  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 (General DEX Tokens)
+export const fetchTokenSpotPriceTool: MCPTool = {
+  name: 'gala_launchpad_fetch_token_spot_price',
+  description: 'Fetch USD spot price for DEX tokens (GALA, SILK, MUSIC, etc.)',
+  inputSchema: {
+    type: 'object',
+    properties: {
+      symbols: {
+        oneOf: [
+          { type: 'string' },
+          {
+            type: 'array',
+            items: { type: 'string' },
+            minItems: 1
+          }
+        ],
+        description: 'Single symbol string or array of symbols (e.g., "GALA" or ["GALA", "SILK", "MUSIC"])',
+      },
+    },
+    required: ['symbols'],
+  },
+  handler: withErrorHandling(async (sdk, args) => {
+    const result = await sdk.fetchTokenSpotPrice(args.symbols);
+    return formatSuccess(result);
+  }),
+};
+
+// 7. Fetch GALA Spot Price (45% code reduction via factory pattern)
+export const fetchGalaSpotPriceTool = createNoParamTool({
+  name: 'gala_launchpad_fetch_gala_spot_price',
+  description: 'Fetch current GALA USD spot price (convenience method)',
+  handler: (sdk) => sdk.fetchGalaSpotPrice(),
+});
+
+// 8. Fetch Launchpad Token Spot Price
+export const fetchLaunchpadTokenSpotPriceTool: MCPTool = {
+  name: 'gala_launchpad_fetch_launchpad_token_spot_price',
+  description: `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,
+  fetchTokenDistributionTool,
+  fetchTokenBadgesTool,
+  fetchVolumeDataTool,
+  fetchTokenSpotPriceTool,
+  fetchGalaSpotPriceTool,
+  fetchLaunchpadTokenSpotPriceTool,
+  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];