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

package/src/prompts/pools.ts

@@ -0,0 +1,496 @@
+/**
+ * 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, validateOptionalLimit } from '../utils/validation.js';
+import { createPromptResponse } from './utils/handlerHelpers.js';
+import { createSimpleOperationText } from './utils/textTemplates.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) => {
+    validateOptionalLimit(args.limit, 100);
+
+    return createPromptResponse(
+      createSimpleOperationText({
+        operation: 'Fetch token pools from Gala Launchpad.',
+        parameters: {
+          type: `Type: ${args.type || 'recent'}`,
+          page: `Page: ${args.page || 1}`,
+          limit: `Limit: ${args.limit || 20}`,
+        },
+        toolName: MCP_TOOLS.FETCH_POOLS,
+        actionDescription: 'retrieve pools with pagination',
+        displayFormat: 'Display 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 createPromptResponse(
+      createSimpleOperationText({
+        operation: 'Fetch optimized pool details for bonding curve calculations.',
+        parameters: {
+          token_name: `Token: ${args.tokenName}`,
+        },
+        toolName: MCP_TOOLS.FETCH_POOL_DETAILS_FOR_CALCULATION,
+        actionDescription: 'get currentSupply (computed with full precision), remainingTokens, maxSupply, reverseBondingCurveMaxFeeFactor, and reverseBondingCurveMinFeeFactor',
+        displayFormat: '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 createPromptResponse(
+      createSimpleOperationText({
+        operation: 'Fetch complete token metadata from the DEX API.',
+        parameters: {
+          token_id: `Token ID: ${args.tokenId}`,
+        },
+        toolName: MCP_TOOLS.FETCH_TOKEN_DETAILS,
+        actionDescription: 'retrieve symbol, decimals, name, image, description, verification status, network information (chainId, contractAddress), and trading enabled status',
+        displayFormat: '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 createPromptResponse(
+      createSimpleOperationText({
+        operation: 'Analyze token holder distribution.',
+        parameters: {
+          token_name: `Token: ${args.tokenName}`,
+        },
+        toolName: MCP_TOOLS.FETCH_TOKEN_DISTRIBUTION,
+        actionDescription: 'get complete holder list with addresses, balances, ownership percentages, total supply, total holder count, and last updated timestamp',
+        displayFormat: '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 createPromptResponse(
+      createSimpleOperationText({
+        operation: 'Fetch achievement badges for token.',
+        parameters: {
+          token_name: `Token: ${args.tokenName}`,
+        },
+        toolName: MCP_TOOLS.FETCH_TOKEN_BADGES,
+        actionDescription: 'retrieve badges for trading volume milestones, community engagement, and other achievements',
+        displayFormat: '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 createPromptResponse(
+      createSimpleOperationText({
+        operation: 'Fetch OHLCV candlestick data for charting.',
+        parameters: {
+          token_name: `Token: ${args.tokenName}`,
+          ...(args.from && { from: `From: ${args.from}` }),
+          ...(args.to && { to: `To: ${args.to}` }),
+          resolution: `Resolution: ${args.resolution || '1h'}`,
+        },
+        toolName: MCP_TOOLS.FETCH_VOLUME_DATA,
+        actionDescription: 'retrieve candlestick data',
+        displayFormat: 'Display 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 createPromptResponse(
+      createSimpleOperationText({
+        operation: 'Fetch the current GALA USD spot price.',
+        toolName: MCP_TOOLS.FETCH_GALA_SPOT_PRICE,
+        actionDescription: 'get the latest GALA price in USD',
+        displayFormat: '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 createPromptResponse(
+      createSimpleOperationText({
+        operation: 'Fetch current USD spot price for token.',
+        parameters: {
+          token_name: `Token: ${args.tokenName}`,
+        },
+        toolName: MCP_TOOLS.FETCH_TOKEN_SPOT_PRICE,
+        actionDescription: 'get current USD price with smart routing (launchpad or DEX), real-time pricing data, and unified interface for all token types',
+        displayFormat: '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) => {
+    validateOptionalLimit(args.limit, 50);
+
+    return createPromptResponse(
+      createSimpleOperationText({
+        operation: 'Fetch historical price snapshots for token.',
+        parameters: {
+          token_id: `Token: ${args.tokenId}`,
+          ...(args.from && { from: `From: ${args.from}` }),
+          ...(args.to && { to: `To: ${args.to}` }),
+          page: `Page: ${args.page || 1}`,
+          limit: `Limit: ${args.limit || 10}`,
+        },
+        toolName: MCP_TOOLS.FETCH_PRICE_HISTORY,
+        actionDescription: 'retrieve historical price data from DEX Backend API',
+        displayFormat: '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 createPromptResponse(
+      createSimpleOperationText({
+        operation: 'Fetch ALL historical price snapshots for token (automatic pagination).',
+        parameters: {
+          token_id: `Token: ${args.tokenId}`,
+          from: args.from ? `From: ${args.from}` : undefined,
+          to: args.to ? `To: ${args.to}` : undefined,
+        },
+        toolName: MCP_TOOLS.FETCH_ALL_PRICE_HISTORY,
+        actionDescription: 'retrieve complete historical data',
+        displayFormat: '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 createPromptResponse(
+      createSimpleOperationText({
+        operation: 'Check if token name is available.',
+        parameters: {
+          token_name: `Token Name: ${args.tokenName}`,
+        },
+        toolName: MCP_TOOLS.CHECK_TOKEN_NAME,
+        actionDescription: 'verify availability',
+        displayFormat: '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 createPromptResponse(
+      createSimpleOperationText({
+        operation: 'Check if token symbol is available.',
+        parameters: {
+          token_symbol: `Token Symbol: ${args.symbol}`,
+        },
+        toolName: MCP_TOOLS.CHECK_TOKEN_SYMBOL,
+        actionDescription: 'verify availability',
+        displayFormat: '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 createPromptResponse(
+      createSimpleOperationText({
+        operation: 'Resolve GalaChain vault address for token.',
+        parameters: {
+          token_name: `Token: ${args.tokenName}`,
+        },
+        toolName: MCP_TOOLS.RESOLVE_VAULT_ADDRESS,
+        actionDescription: 'get the vault address',
+        displayFormat: '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 createPromptResponse(
+      createSimpleOperationText({
+        operation: 'Resolve GalaChain TokenClassKey for launchpad token.',
+        parameters: {
+          token_name: `Token: ${args.tokenName}`,
+        },
+        toolName: MCP_TOOLS.RESOLVE_TOKEN_CLASS_KEY,
+        actionDescription: 'get the TokenClassKey',
+        displayFormat: '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,
+];

package/src/prompts/portfolio.ts

@@ -0,0 +1,208 @@
+/**
+ * Portfolio Prompts
+ *
+ * Slash commands for portfolio management on Gala Launchpad
+ */
+
+import type { MCPPrompt } from '../types/mcp.js';
+import { MCP_TOOLS } from '../constants/mcpToolNames.js';
+import { createPortfolioWorkflow } from './utils/workflowTemplates.js';
+import { validateTokenName, validateOptionalLimit } from '../utils/validation.js';
+import { createPromptResponse } from './utils/handlerHelpers.js';
+
+/**
+ * Portfolio - Complete portfolio analysis
+ */
+export const portfolioPrompt: MCPPrompt = {
+  name: 'galachain-launchpad:portfolio',
+  description: 'Analyze complete portfolio with GALA balance, token holdings, and total USD value',
+  handler: () => [
+    {
+      role: 'user',
+      content: {
+        type: 'text',
+        text: createPortfolioWorkflow(),
+      },
+    },
+  ],
+};
+
+/**
+ * Tokens Held - List all token holdings
+ */
+export const tokensHeldPrompt: MCPPrompt = {
+  name: 'galachain-launchpad:tokens-held',
+  description: 'List all Launchpad tokens currently held with balances',
+  arguments: [
+    {
+      name: 'search',
+      description: 'Optional search filter for token names (fuzzy match)',
+      required: false,
+    },
+    {
+      name: 'limit',
+      description: 'Number of tokens to show (default: 20)',
+      required: false,
+    },
+  ],
+  handler: (args) => {
+    // Validate inputs
+    validateOptionalLimit(args.limit, 100);
+
+    const limit = args.limit || '20';
+    const searchFilter = args.search
+      ? `- search: "${args.search}" (fuzzy match filter)`
+      : '- No search filter (show all tokens)';
+
+    return createPromptResponse(`Show me all Launchpad tokens I'm currently holding:
+
+Use ${MCP_TOOLS.FETCH_TOKENS_HELD} with:
+${searchFilter}
+- limit: ${limit}
+
+For each token, display:
+- Token name
+- Balance (formatted with decimals)
+- Whether I created this token (if applicable)
+
+Sort by balance (highest to lowest).
+
+If I have more tokens than the limit, show pagination info and offer to fetch more.`);
+  },
+};
+
+/**
+ * Tokens Created - Show tokens created by user
+ */
+export const tokensCreatedPrompt: MCPPrompt = {
+  name: 'galachain-launchpad:tokens-created',
+  description: 'List all Launchpad tokens created by the user with their current status',
+  arguments: [
+    {
+      name: 'search',
+      description: 'Optional search filter for token names (fuzzy match)',
+      required: false,
+    },
+    {
+      name: 'limit',
+      description: 'Number of tokens to show (default: 20)',
+      required: false,
+    },
+  ],
+  handler: (args) => {
+    // Validate inputs
+    validateOptionalLimit(args.limit, 100);
+
+    const limit = args.limit || '20';
+    const searchFilter = args.search
+      ? `- search: "${args.search}" (fuzzy match filter)`
+      : '- No search filter (show all tokens)';
+
+    return createPromptResponse(`Show me all Launchpad tokens I've created:
+
+Use ${MCP_TOOLS.FETCH_TOKENS_CREATED} with:
+${searchFilter}
+- limit: ${limit}
+
+For each token, display:
+- Token name and symbol
+- Current status (check using ${MCP_TOOLS.FETCH_POOL_DETAILS}):
+  * Pool status (Ongoing/Completed)
+  * Current supply
+  * Remaining tokens
+  * Progress percentage
+- Whether graduated (use ${MCP_TOOLS.IS_TOKEN_GRADUATED})
+- Frontend URL (use ${MCP_TOOLS.GET_URL_BY_TOKEN_NAME})
+
+Provide a summary:
+- Total tokens created
+- How many are graduated
+- How many are still in bonding curve phase`);
+  },
+};
+
+/**
+ * Balance - Check GALA and specific token balances
+ */
+export const balancePrompt: MCPPrompt = {
+  name: 'galachain-launchpad:balance',
+  description: 'Check GALA balance and optionally a specific token balance',
+  arguments: [
+    {
+      name: 'tokenName',
+      description: 'Optional token name to check balance for (e.g., anime)',
+      required: false,
+    },
+  ],
+  handler: (args) => {
+    // Validate inputs
+    if (args.tokenName) {
+      validateTokenName(args.tokenName);
+    }
+
+    return createPromptResponse(args.tokenName
+            ? `Check my balances:
+
+1. GALA balance using ${MCP_TOOLS.FETCH_GALA_BALANCE}
+2. ${args.tokenName} token balance using ${MCP_TOOLS.FETCH_TOKEN_BALANCE}
+3. Calculate USD values:
+   - GALA USD value using ${MCP_TOOLS.FETCH_GALA_SPOT_PRICE}
+   - ${args.tokenName} USD value using ${MCP_TOOLS.FETCH_LAUNCHPAD_TOKEN_SPOT_PRICE}
+
+Display:
+- GALA: [amount] ($[USD value])
+- ${args.tokenName}: [amount] ($[USD value])
+- Total value: $[combined USD value]`
+            : `Check my GALA balance:
+
+Use ${MCP_TOOLS.FETCH_GALA_BALANCE} to get current GALA balance.
+Use ${MCP_TOOLS.FETCH_GALA_SPOT_PRICE} to calculate USD value.
+
+Display:
+- GALA: [amount]
+- USD value: $[calculated value]
+
+Tip: Add tokenName argument to check a specific token balance.`);
+  },
+};
+
+/**
+ * Profile - Show user profile information
+ */
+export const profilePrompt: MCPPrompt = {
+  name: 'galachain-launchpad:profile',
+  description: 'Show user profile information and activity summary',
+  handler: () =>
+    createPromptResponse(`Show my Gala Launchpad profile:
+
+1. Get profile info using ${MCP_TOOLS.FETCH_PROFILE}
+   - Full name
+   - Profile image URL
+   - Wallet address
+
+2. Get activity summary:
+   - Tokens held count: ${MCP_TOOLS.FETCH_TOKENS_HELD} (limit: 1) for total
+   - Tokens created count: ${MCP_TOOLS.FETCH_TOKENS_CREATED} (limit: 1) for total
+
+3. Get wallet info:
+   - GalaChain address format: ${MCP_TOOLS.GET_ADDRESS}
+   - Ethereum address format: ${MCP_TOOLS.GET_ETHEREUM_ADDRESS}
+   - GALA balance: ${MCP_TOOLS.FETCH_GALA_BALANCE}
+
+Display:
+- Profile details
+- Activity metrics
+- Wallet addresses
+- Current balance`),
+};
+
+/**
+ * Export all portfolio prompts
+ */
+export const portfolioPrompts: MCPPrompt[] = [
+  portfolioPrompt,
+  tokensHeldPrompt,
+  tokensCreatedPrompt,
+  balancePrompt,
+  profilePrompt,
+];