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

package/src/prompts/creation-utils.ts

@@ -1,103 +0,0 @@
-/**
- * Token Creation Utilities Prompts
- *
- * Slash commands for creation utility operations
- */
-
-import type { MCPPrompt } from '../types/mcp.js';
-import { MCP_TOOLS } from '../constants/mcpToolNames.js';
-import { validateTokenName } from '../utils/validation.js';
-import { createPromptResponse } from './utils/handlerHelpers.js';
-import { createSimpleOperationText } from './utils/textTemplates.js';
-
-/**
- * Upload Profile Image - Standalone profile image upload
- */
-export const uploadProfileImagePrompt: MCPPrompt = {
-  name: 'galachain-launchpad:upload-profile-image',
-  description: 'Upload profile image from filesystem',
-  arguments: [
-    {
-      name: 'imagePath',
-      description: 'Absolute file path to image file',
-      required: true,
-    },
-    {
-      name: 'address',
-      description: 'Wallet address (optional, defaults to SDK wallet)',
-      required: false,
-    },
-  ],
-  handler: (args) =>
-    createPromptResponse(
-      createSimpleOperationText({
-        operation: 'Upload profile image.',
-        parameters: {
-          imagePath: `Image Path: ${args.imagePath}`,
-          wallet: args.address ? `Address: ${args.address}` : 'Using default wallet',
-        },
-        toolName: MCP_TOOLS.UPLOAD_PROFILE_IMAGE,
-        actionDescription: 'upload the image file',
-        displayFormat: 'Display confirmation and the image URL.',
-      })
-    ),
-};
-
-/**
- * Upload Token Image - Token image file upload
- */
-export const uploadTokenImagePrompt: MCPPrompt = {
-  name: 'galachain-launchpad:upload-token-image',
-  description: 'Upload token image from filesystem (Node.js only)',
-  arguments: [
-    {
-      name: 'tokenName',
-      description: 'Token name (e.g., anime, mytoken)',
-      required: true,
-    },
-    {
-      name: 'imagePath',
-      description: 'Absolute file path to image file',
-      required: true,
-    },
-  ],
-  handler: (args) => {
-    validateTokenName(args.tokenName);
-
-    return createPromptResponse(
-      createSimpleOperationText({
-        operation: 'Upload token image.',
-        parameters: {
-          token: `Token: ${args.tokenName}`,
-          imagePath: `Image Path: ${args.imagePath}`,
-        },
-        toolName: MCP_TOOLS.UPLOAD_TOKEN_IMAGE,
-        actionDescription: 'upload the token image file',
-        displayFormat: 'This tool is Node.js only (not available in browser).\n\nDisplay confirmation and the uploaded image URL.',
-      })
-    );
-  },
-};
-
-/**
- * Fetch Launch Token Fee - Current launch fee query
- */
-export const fetchLaunchTokenFeePrompt: MCPPrompt = {
-  name: 'galachain-launchpad:fetch-launch-token-fee',
-  description: 'Get the current GALA fee required to launch a new token',
-  handler: () =>
-    createPromptResponse(
-      createSimpleOperationText({
-        operation: 'Check the current token launch fee.',
-        toolName: MCP_TOOLS.FETCH_LAUNCH_TOKEN_FEE,
-        actionDescription: 'retrieve the current GALA fee',
-        displayFormat: 'This is a dynamic value that may change. Display the current fee amount.',
-      })
-    ),
-};
-
-export const creationUtilityPrompts: MCPPrompt[] = [
-  uploadProfileImagePrompt,
-  uploadTokenImagePrompt,
-  fetchLaunchTokenFeePrompt,
-];

package/src/prompts/dex-trading.ts

@@ -1,86 +0,0 @@
-/**
- * DEX Trading Prompts
- *
- * Slash commands for GalaSwap DEX trading operations (for graduated tokens)
- */
-
-import type { MCPPrompt } from '../types/mcp.js';
-import { validateNumericAmount, validateSlippage } from '../utils/validation.js';
-
-/**
- * DEX Swap - Guided swap workflow for graduated tokens
- *
- * This prompt guides users through swapping tokens on GalaSwap DEX.
- * It's designed for tokens that have graduated from bonding curves.
- */
-export const dexSwapPrompt: MCPPrompt = {
-  name: 'galachain-launchpad:dex-swap',
-  description:
-    'Execute a token swap on GalaSwap DEX for graduated tokens. Get a quote first, then execute with slippage protection.',
-  arguments: [
-    {
-      name: 'fromToken',
-      description: 'Source token symbol (e.g., GALA, GUSDC)',
-      required: true,
-    },
-    {
-      name: 'toToken',
-      description: 'Destination token symbol (e.g., GUSDC, GALA)',
-      required: true,
-    },
-    {
-      name: 'amount',
-      description: 'Amount to swap (e.g., 100)',
-      required: true,
-    },
-    {
-      name: 'slippage',
-      description: 'Slippage tolerance percentage (default: 1)',
-      required: false,
-    },
-  ],
-  handler: (args) => {
-    // Validate inputs
-    validateNumericAmount(args.amount, 'amount');
-    if (args.slippage) {
-      validateSlippage(args.slippage);
-    }
-
-    const slippageValue = args.slippage || '1';
-
-    return [
-      {
-        role: 'user',
-        content: {
-          type: 'text',
-          text: `I want to swap tokens on GalaSwap DEX:
-
-**Swap Details:**
-- From Token: ${args.fromToken}
-- To Token: ${args.toToken}
-- Amount: ${args.amount} ${args.fromToken}
-- Slippage Tolerance: ${slippageValue}%
-
-**Workflow:**
-1. Get a swap quote for ${args.amount} ${args.fromToken} → ${args.toToken}
-2. Review the estimated output and price impact
-3. Execute the swap with ${slippageValue}% slippage protection
-
-Please use the following MCP tools to complete this workflow:
-- gala_launchpad_get_swap_quote_exact_input: Get initial quote before swapping
-- gala_launchpad_get_swap_quote_exact_output: Get quote for specific desired output
-- gala_launchpad_execute_swap: Execute the swap after review
-- gala_launchpad_get_swap_user_assets: Check wallet balances
-- gala_launchpad_get_swap_pool_info: Get pool details and fee tiers
-
-Please proceed with getting the quote first, then guide me through the execution.`,
-        },
-      },
-    ];
-  },
-};
-
-/**
- * Export all DEX trading prompts
- */
-export const dexTradingPrompts: MCPPrompt[] = [dexSwapPrompt];

package/src/prompts/discover-tokens.ts

@@ -1,86 +0,0 @@
-/**
- * Token Discovery Prompts
- *
- * Slash commands for discovering and researching tokens on Gala Launchpad
- */
-
-import type { MCPPrompt } from '../types/mcp.js';
-import { createDiscoverTokensWorkflow } from './utils/workflowTemplates.js';
-import { validateNumericAmount } from '../utils/validation.js';
-
-/**
- * Discover Tokens - Token discovery and exploration workflow
- */
-export const discoverTokensPrompt: MCPPrompt = {
-  name: 'galachain-launchpad:discover-tokens',
-  description:
-    'Discover new opportunities on Gala Launchpad - find recently launched tokens, popular tokens, or tokens near graduation',
-  arguments: [
-    {
-      name: 'type',
-      description:
-        'Type of discovery - "recent" for newly launched tokens (default), "popular" for most traded tokens, or "near-graduation" for tokens close to completing their bonding curve',
-      required: false,
-    },
-    {
-      name: 'limit',
-      description: 'Number of tokens to show (default: 10, max: 50)',
-      required: false,
-    },
-    {
-      name: 'minProgress',
-      description:
-        'Minimum graduation progress percentage - only for "near-graduation" type (e.g., "85" for 85%+ progress)',
-      required: false,
-    },
-    {
-      name: 'maxPrice',
-      description:
-        'Maximum USD price for tokens (e.g., "1.50" to find tokens under $1.50) - useful for finding low-cost tokens to accumulate',
-      required: false,
-    },
-  ],
-  handler: (args) => {
-    // Parse and validate inputs
-    const type = (args.type || 'recent') as 'recent' | 'popular' | 'near-graduation';
-    const limit = Math.min(Math.max(1, parseInt(args.limit || '10', 10)), 50);
-
-    // Validate type
-    if (!['recent', 'popular', 'near-graduation'].includes(type)) {
-      throw new Error('Type must be "recent", "popular", or "near-graduation"');
-    }
-
-    // Validate minProgress if provided
-    if (args.minProgress) {
-      const progress = parseInt(args.minProgress, 10);
-      if (isNaN(progress) || progress < 0 || progress > 100) {
-        throw new Error('minProgress must be a number between 0 and 100');
-      }
-    }
-
-    // Validate maxPrice if provided
-    if (args.maxPrice) {
-      validateNumericAmount(args.maxPrice, 'maxPrice');
-    }
-
-    return [
-      {
-        role: 'user',
-        content: {
-          type: 'text',
-          text: createDiscoverTokensWorkflow({
-            type,
-            limit,
-            minProgress: args.minProgress,
-            maxPrice: args.maxPrice,
-          }),
-        },
-      },
-    ];
-  },
-};
-
-/**
- * Export all discovery prompts
- */
-export const discoveryPrompts: MCPPrompt[] = [discoverTokensPrompt];

package/src/prompts/explore-dex-pools.ts

@@ -1,138 +0,0 @@
-/**
- * DEX Pool Exploration Prompts
- *
- * Slash commands for discovering and exploring GalaSwap DEX liquidity pools.
- * These prompts guide users through finding trading pairs and analyzing pool metrics.
- */
-
-import type { MCPPrompt } from '../types/mcp.js';
-import { MCP_TOOLS } from '../constants/mcpToolNames.js';
-import { validatePaginationLimit } from '../utils/validation.js';
-import { createPromptResponse } from './utils/handlerHelpers.js';
-import { createSimpleOperationText } from './utils/textTemplates.js';
-
-/**
- * Fetch DEX Pools - Paginated pool discovery with filters
- */
-export const fetchDexPoolsPrompt: MCPPrompt = {
-  name: 'galachain-launchpad:fetch-dex-pools',
-  description: 'Discover DEX liquidity pools with pagination, sorting, and search filtering',
-  arguments: [
-    {
-      name: 'search',
-      description: 'Search filter for token symbols (e.g., GALA, GUSDC, GWETH)',
-      required: false,
-    },
-    {
-      name: 'sortBy',
-      description: 'Sort field: tvl (default), volume30d, or volume1d',
-      required: false,
-    },
-    {
-      name: 'sortOrder',
-      description: 'Sort order: desc (default) or asc',
-      required: false,
-    },
-    {
-      name: 'page',
-      description: 'Page number (default: 1)',
-      required: false,
-    },
-    {
-      name: 'limit',
-      description: 'Results per page (default: 10, max: 20)',
-      required: false,
-    },
-  ],
-  handler: (args) => {
-    if (args.limit) {
-      validatePaginationLimit(args.limit, 20);
-    }
-
-    const sortBy = args.sortBy || 'tvl';
-    const sortOrder = args.sortOrder || 'desc';
-    const page = args.page || 1;
-    const limit = args.limit || 10;
-
-    return createPromptResponse(
-      createSimpleOperationText({
-        operation: 'Discover liquidity pools on GalaSwap DEX.',
-        parameters: {
-          search: args.search ? `Search: ${args.search}` : 'Search: (none)',
-          sort_by: `Sort by: ${sortBy}`,
-          sort_order: `Order: ${sortOrder}`,
-          page: `Page: ${page}`,
-          limit: `Limit: ${limit}`,
-        },
-        toolName: MCP_TOOLS.FETCH_DEX_POOLS,
-        actionDescription: 'retrieve liquidity pools with pagination and filtering',
-        displayFormat: 'Display results showing pool names, token pairs, TVL, volumes, and APR metrics.',
-      })
-    );
-  },
-};
-
-/**
- * Fetch All DEX Pools - Complete pool discovery with auto-pagination
- */
-export const fetchAllDexPoolsPrompt: MCPPrompt = {
-  name: 'galachain-launchpad:fetch-all-dex-pools',
-  description: 'Discover ALL DEX liquidity pools with automatic pagination',
-  arguments: [
-    {
-      name: 'search',
-      description: 'Search filter for token symbols (e.g., GALA, GUSDC)',
-      required: false,
-    },
-    {
-      name: 'sortBy',
-      description: 'Sort field: tvl (default), volume30d, or volume1d',
-      required: false,
-    },
-    {
-      name: 'sortOrder',
-      description: 'Sort order: desc (default) or asc',
-      required: false,
-    },
-  ],
-  handler: (args) => {
-    const sortBy = args.sortBy || 'tvl';
-    const sortOrder = args.sortOrder || 'desc';
-
-    return [
-      {
-        role: 'user',
-        content: {
-          type: 'text',
-          text: `I want to discover all DEX liquidity pools on GalaSwap.
-
-**Discovery Parameters:**
-- Search Filter: ${args.search || '(none - get all pools)'}
-- Sort By: ${sortBy}
-- Sort Order: ${sortOrder}
-
-**Action:**
-Fetch all available DEX pools with automatic pagination. Show me comprehensive pool data including:
-- Pool identifiers (token pairs)
-- Total Value Locked (TVL) and TVL breakdown by token
-- 24-hour and 30-day trading volumes
-- Fee tiers and APR
-- Volume-to-TVL ratios
-
-Please use the following MCP tool:
-- gala_launchpad_fetch_all_dex_pools: Retrieve all pools with auto-pagination
-
-Display the results in a clear format showing the top pools and key metrics for analysis.`,
-        },
-      },
-    ];
-  },
-};
-
-/**
- * Export all DEX pool exploration prompts
- */
-export const exploreDexPoolsPrompts: MCPPrompt[] = [
-  fetchDexPoolsPrompt,
-  fetchAllDexPoolsPrompt,
-];

package/src/prompts/index.ts

@@ -1,178 +0,0 @@
-/**
- * Gala Launchpad MCP Prompts (Slash Commands)
- *
- * Provides user-friendly slash commands for common Launchpad workflows
- */
-
-import { tradingPrompts } from './trading.js';
-import { portfolioPrompts } from './portfolio.js';
-import { analysisPrompts } from './analysis.js';
-import { utilityPrompts } from './utility.js';
-import { creationPrompts } from './create-token.js';
-import { discoveryPrompts } from './discover-tokens.js';
-import { dexTradingPrompts } from './dex-trading.js';
-import { exploreDexPoolsPrompts } from './explore-dex-pools.js';
-import { liquidityPositionPrompts } from './liquidity-positions.js';
-import { poolPrompts } from './pools.js';
-import { tradingCalculationPrompts } from './trading-calculations.js';
-import { balancePrompts } from './balances.js';
-import { creationUtilityPrompts } from './creation-utils.js';
-import { socialPrompts } from './social.js';
-import { transferPrompts } from './transfers.js';
-import { utilityToolPrompts } from './utility-tools.js';
-import type { MCPPrompt } from '../types/mcp.js';
-
-/**
- * All available prompts (74 total - 2 new DEX pool exploration prompts)
- */
-export const prompts: MCPPrompt[] = [
-  ...tradingPrompts,
-  ...portfolioPrompts,
-  ...analysisPrompts,
-  ...creationPrompts,
-  ...discoveryPrompts,
-  ...dexTradingPrompts,
-  ...exploreDexPoolsPrompts,
-  ...liquidityPositionPrompts,
-  ...utilityPrompts,
-  ...poolPrompts,
-  ...tradingCalculationPrompts,
-  ...balancePrompts,
-  ...creationUtilityPrompts,
-  ...socialPrompts,
-  ...transferPrompts,
-  ...utilityToolPrompts,
-];
-
-/**
- * Optimized prompt registry using Map for O(1) lookups
- * Improves performance for large prompt collections
- */
-const promptMap = new Map<string, MCPPrompt>(
-  prompts.map((prompt) => [prompt.name, prompt])
-);
-
-/**
- * Get prompt by name (optimized with Map lookup)
- *
- * @param name - Prompt name (e.g., 'galachain-launchpad:analyze-token')
- * @returns Prompt object or undefined if not found
- *
- * @example
- * ```typescript
- * const prompt = getPrompt('galachain-launchpad:buy-tokens');
- * if (prompt) {
- *   const messages = prompt.handler({ tokenName: 'anime', galaAmount: '100' });
- * }
- * ```
- */
-export function getPrompt(name: string): MCPPrompt | undefined {
-  return promptMap.get(name);
-}
-
-/**
- * Get all prompt names
- *
- * @returns Array of all registered prompt names
- *
- * @example
- * ```typescript
- * const names = getPromptNames();
- * // ['galachain-launchpad:analyze-token', 'galachain-launchpad:buy-tokens', ...]
- * ```
- */
-export function getPromptNames(): string[] {
-  return Array.from(promptMap.keys());
-}
-
-/**
- * Check if a prompt exists by name
- *
- * @param name - Prompt name to check
- * @returns True if prompt exists, false otherwise
- *
- * @example
- * ```typescript
- * if (hasPrompt('galachain-launchpad:analyze-token')) {
- *   console.log('Prompt is available');
- * }
- * ```
- */
-export function hasPrompt(name: string): boolean {
-  return promptMap.has(name);
-}
-
-/**
- * Get prompts by category
- *
- * @param category - Category name ('trading', 'portfolio', 'analysis', 'creation', 'discovery', 'dex', or 'utility')
- * @returns Array of prompts in the specified category
- *
- * @example
- * ```typescript
- * const tradingCommands = getPromptsByCategory('trading');
- * // Returns [analyzeTokenPrompt, buyTokensPrompt, sellTokensPrompt, graduateTokenPrompt]
- * const dexCommands = getPromptsByCategory('dex');
- * // Returns [dexSwapPrompt]
- * ```
- */
-export function getPromptsByCategory(
-  category: 'trading' | 'portfolio' | 'analysis' | 'creation' | 'discovery' | 'dex' | 'liquidity' | 'utility'
-): MCPPrompt[] {
-  switch (category) {
-    case 'trading':
-      return tradingPrompts;
-    case 'portfolio':
-      return portfolioPrompts;
-    case 'analysis':
-      return analysisPrompts;
-    case 'creation':
-      return creationPrompts;
-    case 'discovery':
-      return [...discoveryPrompts, ...exploreDexPoolsPrompts];
-    case 'dex':
-      return dexTradingPrompts;
-    case 'liquidity':
-      return liquidityPositionPrompts;
-    case 'utility':
-      return utilityPrompts;
-    default:
-      return [];
-  }
-}
-
-/**
- * Get prompt count
- *
- * @returns Total number of registered prompts
- *
- * @example
- * ```typescript
- * console.log(`Total prompts: ${getPromptCount()}`); // Total prompts: 15
- * ```
- */
-export function getPromptCount(): number {
-  return promptMap.size;
-}
-
-/**
- * Export individual prompt categories for documentation
- */
-export {
-  tradingPrompts,
-  portfolioPrompts,
-  analysisPrompts,
-  creationPrompts,
-  discoveryPrompts,
-  dexTradingPrompts,
-  exploreDexPoolsPrompts,
-  liquidityPositionPrompts,
-  utilityPrompts,
-  poolPrompts,
-  tradingCalculationPrompts,
-  balancePrompts,
-  creationUtilityPrompts,
-  socialPrompts,
-  transferPrompts,
-  utilityToolPrompts,
-};