@gala-chain/launchpad-mcp-server 1.22.4 → 1.23.0

package/src/prompts/pools.ts

@@ -0,0 +1,571 @@
+/**
+ * Pool Management Prompts
+ *
+ * Slash commands for pool management, pricing, and token data operations
+ */
+
+import type { MCPPrompt } from '../types/mcp.js';
+import { MCP_TOOLS } from '../constants/mcpToolNames.js';
+import { validateTokenName, validatePaginationLimit } from '../utils/validation.js';
+
+/**
+ * Fetch Pools - Paginated pool fetching with filters
+ */
+export const fetchPoolsPrompt: MCPPrompt = {
+  name: 'galachain-launchpad:fetch-pools',
+  description: 'Fetch token pools with pagination and optional filters',
+  arguments: [
+    {
+      name: 'type',
+      description: 'Pool type: recent, popular (default: recent)',
+      required: false,
+    },
+    {
+      name: 'page',
+      description: 'Page number (default: 1)',
+      required: false,
+    },
+    {
+      name: 'limit',
+      description: 'Results per page (default: 20, max: 100)',
+      required: false,
+    },
+  ],
+  handler: (args) => {
+    if (args.limit) {
+      validatePaginationLimit(args.limit, 100);
+    }
+
+    return [
+      {
+        role: 'user',
+        content: {
+          type: 'text',
+          text: `Fetch token pools from Gala Launchpad.
+
+Use ${MCP_TOOLS.FETCH_POOLS} with parameters:
+- type: ${args.type || 'recent'}
+- page: ${args.page || 1}
+- limit: ${args.limit || 20}
+
+Display the results showing token names, symbols, and key metrics.`,
+        },
+      },
+    ];
+  },
+};
+
+/**
+ * Fetch Pool Details for Calculation - Optimized pool details
+ */
+export const fetchPoolDetailsForCalculationPrompt: MCPPrompt = {
+  name: 'galachain-launchpad:fetch-pool-details-for-calculation',
+  description: 'Get optimized pool details for local bonding curve calculations',
+  arguments: [
+    {
+      name: 'tokenName',
+      description: 'Token name (e.g., anime, test216253)',
+      required: true,
+    },
+  ],
+  handler: (args) => {
+    validateTokenName(args.tokenName);
+
+    return [
+      {
+        role: 'user',
+        content: {
+          type: 'text',
+          text: `Fetch optimized pool details for bonding curve calculations.
+
+Token: ${args.tokenName}
+
+Use ${MCP_TOOLS.FETCH_POOL_DETAILS_FOR_CALCULATION} to get:
+- currentSupply (computed with full precision)
+- remainingTokens
+- maxSupply
+- reverseBondingCurveMaxFeeFactor
+- reverseBondingCurveMinFeeFactor
+
+This data is optimized for use with local calculation tools.`,
+        },
+      },
+    ];
+  },
+};
+
+/**
+ * Fetch Token Details - Complete token metadata
+ */
+export const fetchTokenDetailsPrompt: MCPPrompt = {
+  name: 'galachain-launchpad:fetch-token-details',
+  description: 'Fetch comprehensive token metadata from DEX API',
+  arguments: [
+    {
+      name: 'tokenId',
+      description: 'Token ID (e.g., Token|Unit|GUSDC|eth:0x...)',
+      required: true,
+    },
+  ],
+  handler: (args) => {
+    return [
+      {
+        role: 'user',
+        content: {
+          type: 'text',
+          text: `Fetch complete token metadata from the DEX API.
+
+Token ID: ${args.tokenId}
+
+Use ${MCP_TOOLS.FETCH_TOKEN_DETAILS} to retrieve:
+- Symbol, decimals, name, image
+- Description and verification status
+- Network information (chainId, contractAddress)
+- Trading enabled status
+
+Display the complete token information.`,
+        },
+      },
+    ];
+  },
+};
+
+/**
+ * Fetch Token Distribution - Holder analysis
+ */
+export const fetchTokenDistributionPrompt: MCPPrompt = {
+  name: 'galachain-launchpad:fetch-token-distribution',
+  description: 'Get token holder distribution and supply metrics',
+  arguments: [
+    {
+      name: 'tokenName',
+      description: 'Token name (e.g., anime, test216253)',
+      required: true,
+    },
+  ],
+  handler: (args) => {
+    validateTokenName(args.tokenName);
+
+    return [
+      {
+        role: 'user',
+        content: {
+          type: 'text',
+          text: `Analyze token holder distribution.
+
+Token: ${args.tokenName}
+
+Use ${MCP_TOOLS.FETCH_TOKEN_DISTRIBUTION} to get:
+- Complete holder list with addresses, balances, and ownership percentages
+- Total supply (computed from holder balances)
+- Total holder count
+- Last updated timestamp
+
+Identify top holders and concentration risk.`,
+        },
+      },
+    ];
+  },
+};
+
+/**
+ * Fetch Token Badges - Achievement badges
+ */
+export const fetchTokenBadgesPrompt: MCPPrompt = {
+  name: 'galachain-launchpad:fetch-token-badges',
+  description: 'Get achievement badges for volume and engagement',
+  arguments: [
+    {
+      name: 'tokenName',
+      description: 'Token name (e.g., anime, test216253)',
+      required: true,
+    },
+  ],
+  handler: (args) => {
+    validateTokenName(args.tokenName);
+
+    return [
+      {
+        role: 'user',
+        content: {
+          type: 'text',
+          text: `Fetch achievement badges for token.
+
+Token: ${args.tokenName}
+
+Use ${MCP_TOOLS.FETCH_TOKEN_BADGES} to retrieve badges for:
+- Trading volume milestones
+- Community engagement
+- Other achievements
+
+Display all earned badges.`,
+        },
+      },
+    ];
+  },
+};
+
+/**
+ * Fetch Volume Data - OHLCV candlestick data
+ */
+export const fetchVolumeDataPrompt: MCPPrompt = {
+  name: 'galachain-launchpad:fetch-volume-data',
+  description: 'Get OHLCV (candlestick) data for charting',
+  arguments: [
+    {
+      name: 'tokenName',
+      description: 'Token name (e.g., anime, test216253)',
+      required: true,
+    },
+    {
+      name: 'from',
+      description: 'Start date (ISO 8601 format)',
+      required: false,
+    },
+    {
+      name: 'to',
+      description: 'End date (ISO 8601 format)',
+      required: false,
+    },
+    {
+      name: 'resolution',
+      description: 'Time resolution: 1m, 5m, 15m, 1h, 4h, 1d (default: 1h)',
+      required: false,
+    },
+  ],
+  handler: (args) => {
+    validateTokenName(args.tokenName);
+
+    return [
+      {
+        role: 'user',
+        content: {
+          type: 'text',
+          text: `Fetch OHLCV candlestick data for charting.
+
+Token: ${args.tokenName}
+${args.from ? `From: ${args.from}` : ''}
+${args.to ? `To: ${args.to}` : ''}
+Resolution: ${args.resolution || '1h'}
+
+Use ${MCP_TOOLS.FETCH_VOLUME_DATA} to get candlestick data suitable for price charts.`,
+        },
+      },
+    ];
+  },
+};
+
+/**
+ * Fetch GALA Spot Price - Current GALA USD price
+ */
+export const fetchGalaSpotPricePrompt: MCPPrompt = {
+  name: 'galachain-launchpad:fetch-gala-spot-price',
+  description: 'Fetch current GALA USD spot price',
+  handler: () => {
+    return [
+      {
+        role: 'user',
+        content: {
+          type: 'text',
+          text: `Fetch the current GALA USD spot price.
+
+Use ${MCP_TOOLS.FETCH_GALA_SPOT_PRICE} to get the latest GALA price in USD.
+
+Display the price in a clear format.`,
+        },
+      },
+    ];
+  },
+};
+
+/**
+ * Fetch Token Spot Price - Current USD price for any token
+ */
+export const fetchTokenSpotPricePrompt: MCPPrompt = {
+  name: 'galachain-launchpad:fetch-token-spot-price',
+  description: 'Fetch USD spot price for any token (launchpad or DEX)',
+  arguments: [
+    {
+      name: 'tokenName',
+      description: 'Token name (e.g., anime, gala, demonkpop)',
+      required: true,
+    },
+  ],
+  handler: (args) => {
+    validateTokenName(args.tokenName);
+
+    return [
+      {
+        role: 'user',
+        content: {
+          type: 'text',
+          text: `Fetch current USD spot price for token.
+
+Token: ${args.tokenName}
+
+Use ${MCP_TOOLS.FETCH_TOKEN_SPOT_PRICE} to get:
+- Current USD price with smart routing (launchpad or DEX)
+- Real-time pricing data
+- Unified interface for all token types
+
+Display the current price clearly.`,
+        },
+      },
+    ];
+  },
+};
+
+/**
+ * Fetch Price History - Paginated historical prices
+ */
+export const fetchPriceHistoryPrompt: MCPPrompt = {
+  name: 'galachain-launchpad:fetch-price-history',
+  description: 'Fetch historical token prices with pagination',
+  arguments: [
+    {
+      name: 'tokenId',
+      description: 'Token ID (e.g., Token|Unit|GUSDC|eth:0x...) OR tokenName (e.g., demonkpop)',
+      required: true,
+    },
+    {
+      name: 'from',
+      description: 'Start date (ISO 8601 format)',
+      required: false,
+    },
+    {
+      name: 'to',
+      description: 'End date (ISO 8601 format)',
+      required: false,
+    },
+    {
+      name: 'page',
+      description: 'Page number (default: 1)',
+      required: false,
+    },
+    {
+      name: 'limit',
+      description: 'Results per page (default: 10, max: 50)',
+      required: false,
+    },
+  ],
+  handler: (args) => {
+    if (args.limit) {
+      validatePaginationLimit(args.limit, 50);
+    }
+
+    return [
+      {
+        role: 'user',
+        content: {
+          type: 'text',
+          text: `Fetch historical price snapshots for token.
+
+Token: ${args.tokenId}
+${args.from ? `From: ${args.from}` : ''}
+${args.to ? `To: ${args.to}` : ''}
+Page: ${args.page || 1}
+Limit: ${args.limit || 10}
+
+Use ${MCP_TOOLS.FETCH_PRICE_HISTORY} to retrieve historical price data from the DEX Backend API.
+
+Display price snapshots with timestamps.`,
+        },
+      },
+    ];
+  },
+};
+
+/**
+ * Fetch All Price History - Auto-paginated complete history
+ */
+export const fetchAllPriceHistoryPrompt: MCPPrompt = {
+  name: 'galachain-launchpad:fetch-all-price-history',
+  description: 'Fetch complete historical token prices (auto-paginated)',
+  arguments: [
+    {
+      name: 'tokenId',
+      description: 'Token ID (e.g., Token|Unit|GUSDC|eth:0x...) OR tokenName (e.g., demonkpop)',
+      required: true,
+    },
+    {
+      name: 'from',
+      description: 'Start date (ISO 8601 format)',
+      required: false,
+    },
+    {
+      name: 'to',
+      description: 'End date (ISO 8601 format)',
+      required: false,
+    },
+  ],
+  handler: (args) => {
+    return [
+      {
+        role: 'user',
+        content: {
+          type: 'text',
+          text: `Fetch ALL historical price snapshots for token (automatic pagination).
+
+Token: ${args.tokenId}
+${args.from ? `From: ${args.from}` : ''}
+${args.to ? `To: ${args.to}` : ''}
+
+Use ${MCP_TOOLS.FETCH_ALL_PRICE_HISTORY} to retrieve complete historical data.
+
+This automatically handles pagination and returns all available snapshots.`,
+        },
+      },
+    ];
+  },
+};
+
+/**
+ * Check Token Name - Name availability check
+ */
+export const checkTokenNamePrompt: MCPPrompt = {
+  name: 'galachain-launchpad:check-token-name',
+  description: 'Check if a token name is available',
+  arguments: [
+    {
+      name: 'tokenName',
+      description: 'Token name to check (3-20 alphanumeric characters)',
+      required: true,
+    },
+  ],
+  handler: (args) => {
+    validateTokenName(args.tokenName);
+
+    return [
+      {
+        role: 'user',
+        content: {
+          type: 'text',
+          text: `Check if token name is available.
+
+Token Name: ${args.tokenName}
+
+Use ${MCP_TOOLS.CHECK_TOKEN_NAME} to verify availability.
+
+Display whether the name is available or already taken.`,
+        },
+      },
+    ];
+  },
+};
+
+/**
+ * Check Token Symbol - Symbol availability check
+ */
+export const checkTokenSymbolPrompt: MCPPrompt = {
+  name: 'galachain-launchpad:check-token-symbol',
+  description: 'Check if a token symbol is available',
+  arguments: [
+    {
+      name: 'symbol',
+      description: 'Token symbol to check (1-8 uppercase characters)',
+      required: true,
+    },
+  ],
+  handler: (args) => {
+    return [
+      {
+        role: 'user',
+        content: {
+          type: 'text',
+          text: `Check if token symbol is available.
+
+Token Symbol: ${args.symbol}
+
+Use ${MCP_TOOLS.CHECK_TOKEN_SYMBOL} to verify availability.
+
+Display whether the symbol is available or already taken.`,
+        },
+      },
+    ];
+  },
+};
+
+/**
+ * Resolve Vault Address - GalaChain vault lookup
+ */
+export const resolveVaultAddressPrompt: MCPPrompt = {
+  name: 'galachain-launchpad:resolve-vault-address',
+  description: 'Get GalaChain vault address for a token',
+  arguments: [
+    {
+      name: 'tokenName',
+      description: 'Token name (e.g., anime, test216253)',
+      required: true,
+    },
+  ],
+  handler: (args) => {
+    validateTokenName(args.tokenName);
+
+    return [
+      {
+        role: 'user',
+        content: {
+          type: 'text',
+          text: `Resolve GalaChain vault address for token.
+
+Token: ${args.tokenName}
+
+Use ${MCP_TOOLS.RESOLVE_VAULT_ADDRESS} to get the vault address.
+
+This is useful for debugging and direct GalaChain operations.`,
+        },
+      },
+    ];
+  },
+};
+
+/**
+ * Resolve Token Class Key - TokenClassKey resolution
+ */
+export const resolveTokenClassKeyPrompt: MCPPrompt = {
+  name: 'galachain-launchpad:resolve-token-class-key',
+  description: 'Get GalaChain TokenClassKey for a launchpad token',
+  arguments: [
+    {
+      name: 'tokenName',
+      description: 'Token name (e.g., anime, test216253)',
+      required: true,
+    },
+  ],
+  handler: (args) => {
+    validateTokenName(args.tokenName);
+
+    return [
+      {
+        role: 'user',
+        content: {
+          type: 'text',
+          text: `Resolve GalaChain TokenClassKey for launchpad token.
+
+Token: ${args.tokenName}
+
+Use ${MCP_TOOLS.RESOLVE_TOKEN_CLASS_KEY} to get the TokenClassKey.
+
+This is useful for direct GalaChain operations.`,
+        },
+      },
+    ];
+  },
+};
+
+export const poolPrompts: MCPPrompt[] = [
+  fetchPoolsPrompt,
+  fetchPoolDetailsForCalculationPrompt,
+  fetchTokenDetailsPrompt,
+  fetchTokenDistributionPrompt,
+  fetchTokenBadgesPrompt,
+  fetchVolumeDataPrompt,
+  fetchGalaSpotPricePrompt,
+  fetchTokenSpotPricePrompt,
+  fetchPriceHistoryPrompt,
+  fetchAllPriceHistoryPrompt,
+  checkTokenNamePrompt,
+  checkTokenSymbolPrompt,
+  resolveVaultAddressPrompt,
+  resolveTokenClassKeyPrompt,
+];