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

package/src/prompts/pools.ts

@@ -1,571 +0,0 @@
-/**
- * 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,
-];