@gala-chain/launchpad-mcp-server 1.22.0 → 1.22.1

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/index.ts

@@ -1,154 +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 { liquidityPositionPrompts } from './liquidity-positions.js';
-import type { MCPPrompt } from '../types/mcp.js';
-
-/**
- * All available prompts
- */
-export const prompts: MCPPrompt[] = [
-  ...tradingPrompts,
-  ...portfolioPrompts,
-  ...analysisPrompts,
-  ...creationPrompts,
-  ...discoveryPrompts,
-  ...dexTradingPrompts,
-  ...liquidityPositionPrompts,
-  ...utilityPrompts,
-];
-
-/**
- * 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;
-    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,
-  liquidityPositionPrompts,
-  utilityPrompts,
-};

package/src/prompts/liquidity-positions.ts

@@ -1,270 +0,0 @@
-/**
- * DEX Liquidity Position Prompts
- *
- * Slash commands for managing liquidity positions on GalaSwap DEX
- */
-
-import type { MCPPrompt } from '../types/mcp.js';
-import { validateNumericAmount } from '../utils/validation.js';
-
-/**
- * View My Liquidity Positions - List all open LP positions
- *
- * This prompt shows all open liquidity positions for the authenticated wallet.
- */
-export const myPositionsPrompt: MCPPrompt = {
-  name: 'galachain-launchpad:my-positions',
-  description:
-    'View all your open liquidity positions on GalaSwap DEX with details about each position',
-  arguments: [],
-  handler: () => {
-    return [
-      {
-        role: 'user',
-        content: {
-          type: 'text',
-          text: `I want to view all my open liquidity positions on GalaSwap DEX.
-
-**Action:**
-Show me all my liquidity positions with the following information for each:
-- Position ID
-- Token pair (token0/token1)
-- Fee tier
-- Current liquidity amount
-- Token amounts locked
-- Accumulated trading fees
-
-**Workflow:**
-1. Fetch all my open positions using gala_launchpad_get_user_liquidity_positions
-2. Display each position with key details
-3. Show total summary (number of positions, total accumulated fees)
-
-Please use the following MCP tools:
-- gala_launchpad_get_user_liquidity_positions: Retrieve all open positions for my wallet
-
-Proceed with fetching my positions.`,
-        },
-      },
-    ];
-  },
-};
-
-/**
- * Add Liquidity - Create new LP position with guided workflow
- *
- * Guides through adding liquidity to a pool with price range selection
- */
-export const addLiquidityPrompt: MCPPrompt = {
-  name: 'galachain-launchpad:add-liquidity',
-  description:
-    'Add liquidity to a GalaSwap DEX pool. Guides through selecting token pair, price range, and amounts.',
-  arguments: [
-    {
-      name: 'token0',
-      description: 'First token symbol (e.g., GALA)',
-      required: true,
-    },
-    {
-      name: 'token1',
-      description: 'Second token symbol (e.g., GUSDC)',
-      required: true,
-    },
-    {
-      name: 'amount0',
-      description: 'Amount of token0 to provide (e.g., 1000)',
-      required: true,
-    },
-    {
-      name: 'amount1',
-      description: 'Amount of token1 to provide (e.g., 1000)',
-      required: true,
-    },
-    {
-      name: 'minPrice',
-      description: 'Minimum price boundary for LP range (e.g., 0.90)',
-      required: false,
-    },
-    {
-      name: 'maxPrice',
-      description: 'Maximum price boundary for LP range (e.g., 1.10)',
-      required: false,
-    },
-    {
-      name: 'feeTier',
-      description: 'Fee tier in basis points: 500, 3000, or 10000 (default: 3000)',
-      required: false,
-    },
-  ],
-  handler: (args) => {
-    // Validate amounts
-    validateNumericAmount(args.amount0, 'amount0');
-    validateNumericAmount(args.amount1, 'amount1');
-
-    const minPrice = args.minPrice || '0.95';
-    const maxPrice = args.maxPrice || '1.05';
-    const feeTier = args.feeTier || '3000';
-
-    return [
-      {
-        role: 'user',
-        content: {
-          type: 'text',
-          text: `I want to add liquidity to the ${args.token0}/${args.token1} pool on GalaSwap DEX.
-
-**Liquidity Details:**
-- Token Pair: ${args.token0} / ${args.token1}
-- Amount of ${args.token0}: ${args.amount0}
-- Amount of ${args.token1}: ${args.amount1}
-- Price Range: ${minPrice} - ${maxPrice}
-- Fee Tier: ${feeTier} basis points (${parseInt(feeTier) / 100}%)
-
-**Workflow:**
-1. Check my wallet balances to ensure I have sufficient tokens
-2. Get pool information for the ${args.token0}/${args.token1} pair
-3. Add liquidity by price range with the specified amounts and price boundaries
-4. Confirm the position was created successfully
-
-**Important:**
-- Price range ${minPrice}-${maxPrice} means liquidity is only provided when the price is in this range
-- Lower fee tiers (500 bps) for stablecoins, higher fees (3000-10000 bps) for volatile pairs
-- I accept the estimated slippage shown in the quote
-
-Please use the following MCP tools:
-- gala_launchpad_get_swap_user_assets: Check my token balances
-- gala_launchpad_get_swap_pool_info: Get ${args.token0}/${args.token1} pool details
-- gala_launchpad_add_liquidity_by_price: Add liquidity with price range
-
-Proceed with adding liquidity.`,
-        },
-      },
-    ];
-  },
-};
-
-/**
- * Remove Liquidity - Close or reduce LP position
- *
- * Guides through removing liquidity from an existing position
- */
-export const removeLiquidityPrompt: MCPPrompt = {
-  name: 'galachain-launchpad:remove-liquidity',
-  description:
-    'Remove liquidity from an existing position. Shows estimated tokens and fees to receive.',
-  arguments: [
-    {
-      name: 'positionId',
-      description: 'Position ID to remove liquidity from',
-      required: true,
-    },
-    {
-      name: 'percentage',
-      description: 'Percentage of liquidity to remove (0-100, default: 100 to close position)',
-      required: false,
-    },
-  ],
-  handler: (args) => {
-    const percentage = args.percentage || '100';
-
-    return [
-      {
-        role: 'user',
-        content: {
-          type: 'text',
-          text: `I want to remove ${percentage}% of liquidity from position ${args.positionId}.
-
-**Removal Details:**
-- Position ID: ${args.positionId}
-- Removal Amount: ${percentage}% of liquidity
-${percentage === '100' ? '- Action: Close position completely' : '- Action: Reduce position by ' + percentage + '%'}
-
-**Workflow:**
-1. Get position details (token pair, current liquidity, accumulated fees)
-2. Estimate tokens and fees that will be received when removing
-3. Show the breakdown of what I'll receive
-4. Execute the removal with slippage protection
-5. Verify the position was updated/closed
-
-**Important:**
-- Removing 100% closes the position
-- Removing less keeps the position open with reduced liquidity
-- Accumulated fees can be collected separately if desired
-- Slippage protection ensures I receive acceptable amounts
-
-Please use the following MCP tools:
-- gala_launchpad_get_liquidity_position_by_id: Get position details
-- gala_launchpad_estimate_remove_liquidity: Preview what I'll receive
-- gala_launchpad_remove_liquidity: Execute the removal
-
-Proceed with removing liquidity.`,
-        },
-      },
-    ];
-  },
-};
-
-/**
- * Collect Fees - Harvest accumulated trading fees
- *
- * Guides through collecting accumulated fees from a position
- */
-export const collectFeesPrompt: MCPPrompt = {
-  name: 'galachain-launchpad:collect-fees',
-  description:
-    'Collect accumulated trading fees from a liquidity position without modifying the position.',
-  arguments: [
-    {
-      name: 'positionId',
-      description: 'Position ID to collect fees from',
-      required: true,
-    },
-  ],
-  handler: (args) => {
-    return [
-      {
-        role: 'user',
-        content: {
-          type: 'text',
-          text: `I want to collect accumulated trading fees from position ${args.positionId}.
-
-**Fee Collection Details:**
-- Position ID: ${args.positionId}
-- Action: Harvest accumulated trading fees
-- Position Impact: Liquidity remains unchanged, only fees collected
-
-**Workflow:**
-1. Get position details to show accumulated fees
-2. Show how much in fees is available to collect (in both tokens)
-3. Execute fee collection transaction
-4. Confirm fees were successfully collected
-
-**Benefits:**
-- Passive income from liquidity provision
-- Fees accumulate continuously as trades happen
-- Can be collected without closing the position
-- Frees up rewards to reinvest or use elsewhere
-
-**Important:**
-- Fee collection doesn't affect your liquidity position
-- Fees are only earned on trades within your price range
-- Fee amounts depend on trading volume and your fee tier
-
-Please use the following MCP tools:
-- gala_launchpad_get_liquidity_position_by_id: Get position details and fee amounts
-- gala_launchpad_collect_position_fees: Collect the accumulated fees
-
-Proceed with collecting fees.`,
-        },
-      },
-    ];
-  },
-};
-
-/**
- * Export all liquidity position prompts
- */
-export const liquidityPositionPrompts: MCPPrompt[] = [
-  myPositionsPrompt,
-  addLiquidityPrompt,
-  removeLiquidityPrompt,
-  collectFeesPrompt,
-];