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

package/src/prompts/create-token.ts

@@ -0,0 +1,123 @@
+/**
+ * Token Creation Prompts
+ *
+ * Slash commands for creating new tokens on Gala Launchpad
+ */
+
+import type { MCPPrompt } from '../types/mcp.js';
+import { createCreateTokenWorkflow } from './utils/workflowTemplates.js';
+import {
+  validateTokenName,
+  validateTokenSymbol,
+  validateUrl,
+  validateNumericAmount,
+} from '../utils/validation.js';
+
+/**
+ * Create Token - Guided token creation workflow
+ */
+export const createTokenPrompt: MCPPrompt = {
+  name: 'galachain-launchpad:create-token',
+  description:
+    'Guide user through creating a new token on Gala Launchpad with metadata, image upload, and optional pre-buy',
+  arguments: [
+    {
+      name: 'tokenName',
+      description:
+        'Name for the new token - must be 3-20 lowercase alphanumeric characters (e.g., "mytoken")',
+      required: true,
+    },
+    {
+      name: 'tokenSymbol',
+      description: 'Token symbol - must be 1-8 uppercase letters (e.g., "MTK")',
+      required: true,
+    },
+    {
+      name: 'description',
+      description: 'Token description - brief description of what the token is for (1-500 chars)',
+      required: true,
+    },
+    {
+      name: 'websiteUrl',
+      description: 'Optional website URL (e.g., "https://mytoken.com") - at least one social URL required',
+      required: false,
+    },
+    {
+      name: 'twitterUrl',
+      description:
+        'Optional Twitter profile URL (e.g., "https://twitter.com/mytoken") - at least one social URL required',
+      required: false,
+    },
+    {
+      name: 'telegramUrl',
+      description:
+        'Optional Telegram channel URL (e.g., "https://t.me/mytoken") - at least one social URL required',
+      required: false,
+    },
+    {
+      name: 'imagePath',
+      description:
+        'Optional path to token image file - will be uploaded to IPFS (e.g., "/path/to/image.png")',
+      required: false,
+    },
+    {
+      name: 'preBuyGala',
+      description:
+        'Optional GALA amount for initial token purchase (e.g., "100" for 100 GALA) - helps bootstrap liquidity',
+      required: false,
+    },
+  ],
+  handler: (args) => {
+    // Validate inputs
+    validateTokenName(args.tokenName);
+    validateTokenSymbol(args.tokenSymbol);
+
+    // Validate at least one social URL
+    const hasSocialUrl = args.websiteUrl || args.twitterUrl || args.telegramUrl;
+    if (!hasSocialUrl) {
+      throw new Error(
+        'At least one social URL is required: websiteUrl, twitterUrl, or telegramUrl'
+      );
+    }
+
+    // Validate social URLs if provided
+    if (args.websiteUrl) {
+      validateUrl(args.websiteUrl, 'websiteUrl');
+    }
+    if (args.twitterUrl) {
+      validateUrl(args.twitterUrl, 'twitterUrl');
+    }
+    if (args.telegramUrl) {
+      validateUrl(args.telegramUrl, 'telegramUrl');
+    }
+
+    // Validate pre-buy amount if provided
+    if (args.preBuyGala) {
+      validateNumericAmount(args.preBuyGala, 'preBuyGala');
+    }
+
+    return [
+      {
+        role: 'user',
+        content: {
+          type: 'text',
+          text: createCreateTokenWorkflow({
+            tokenName: args.tokenName,
+            tokenSymbol: args.tokenSymbol,
+            description: args.description,
+            websiteUrl: args.websiteUrl,
+            twitterUrl: args.twitterUrl,
+            telegramUrl: args.telegramUrl,
+            imagePath: args.imagePath,
+            preBuyGala: args.preBuyGala,
+          }),
+        },
+      },
+    ];
+  },
+};
+
+/**
+ * Export all token creation prompts
+ */
+export const creationPrompts: MCPPrompt[] = [createTokenPrompt];

package/src/prompts/creation-utils.ts

@@ -0,0 +1,118 @@
+/**
+ * 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';
+
+/**
+ * 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) => {
+    return [
+      {
+        role: 'user',
+        content: {
+          type: 'text',
+          text: `Upload profile image.
+
+Image Path: ${args.imagePath}
+${args.address ? `Address: ${args.address}` : 'Using default wallet'}
+
+Use ${MCP_TOOLS.UPLOAD_PROFILE_IMAGE} to upload the image file.
+
+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 [
+      {
+        role: 'user',
+        content: {
+          type: 'text',
+          text: `Upload token image.
+
+Token: ${args.tokenName}
+Image Path: ${args.imagePath}
+
+Use ${MCP_TOOLS.UPLOAD_TOKEN_IMAGE} to upload the token image file.
+
+This tool is Node.js only (not available in browser).
+
+Display 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: () => {
+    return [
+      {
+        role: 'user',
+        content: {
+          type: 'text',
+          text: `Check the current token launch fee.
+
+Use ${MCP_TOOLS.FETCH_LAUNCH_TOKEN_FEE} to retrieve the current GALA fee.
+
+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

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

@@ -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,175 @@
+/**
+ * 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 { 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 (72 total)
+ */
+export const prompts: MCPPrompt[] = [
+  ...tradingPrompts,
+  ...portfolioPrompts,
+  ...analysisPrompts,
+  ...creationPrompts,
+  ...discoveryPrompts,
+  ...dexTradingPrompts,
+  ...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;
+    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,
+  poolPrompts,
+  tradingCalculationPrompts,
+  balancePrompts,
+  creationUtilityPrompts,
+  socialPrompts,
+  transferPrompts,
+  utilityToolPrompts,
+};