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

package/src/prompts/discover-tokens.ts

@@ -0,0 +1,86 @@
+/**
+ * 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

@@ -0,0 +1,154 @@
+/**
+ * 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

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