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

package/src/prompts/transfers.ts

@@ -0,0 +1,97 @@
+/**
+ * Token Transfer Prompts
+ *
+ * Slash commands for transferring tokens and GALA
+ */
+
+import type { MCPPrompt } from '../types/mcp.js';
+import { MCP_TOOLS } from '../constants/mcpToolNames.js';
+import { validateAddress, validateNumericAmount, validateTokenName } from '../utils/validation.js';
+import { createPromptResponse } from './utils/handlerHelpers.js';
+import { createSimpleOperationText } from './utils/textTemplates.js';
+
+/**
+ * Transfer GALA - GALA token transfer
+ */
+export const transferGalaPrompt: MCPPrompt = {
+  name: 'galachain-launchpad:transfer-gala',
+  description: 'Transfer GALA tokens to another wallet',
+  arguments: [
+    {
+      name: 'recipientAddress',
+      description: 'Recipient wallet address',
+      required: true,
+    },
+    {
+      name: 'amount',
+      description: 'Amount of GALA to transfer',
+      required: true,
+    },
+  ],
+  handler: (args) => {
+    validateAddress(args.recipientAddress, 'recipientAddress');
+    validateNumericAmount(args.amount, 'amount');
+
+    return createPromptResponse(
+      createSimpleOperationText({
+        operation: 'Transfer GALA tokens.',
+        parameters: {
+          recipient: `Recipient: ${args.recipientAddress}`,
+          amount: `Amount: ${args.amount} GALA`,
+        },
+        toolName: MCP_TOOLS.TRANSFER_GALA,
+        actionDescription: 'execute the transfer',
+        displayFormat: 'Display the transaction details and confirmation.',
+      })
+    );
+  },
+};
+
+/**
+ * Transfer Token - Launchpad token transfer
+ */
+export const transferTokenPrompt: MCPPrompt = {
+  name: 'galachain-launchpad:transfer-token',
+  description: 'Transfer launchpad tokens to another wallet',
+  arguments: [
+    {
+      name: 'to',
+      description: 'Recipient wallet address',
+      required: true,
+    },
+    {
+      name: 'tokenName',
+      description: 'Token name (e.g., anime)',
+      required: true,
+    },
+    {
+      name: 'amount',
+      description: 'Token amount to transfer',
+      required: true,
+    },
+  ],
+  handler: (args) => {
+    validateAddress(args.to, 'to');
+    validateTokenName(args.tokenName, 'tokenName');
+    validateNumericAmount(args.amount, 'amount');
+
+    return createPromptResponse(
+      createSimpleOperationText({
+        operation: 'Transfer launchpad tokens.',
+        parameters: {
+          recipient: `Recipient: ${args.to}`,
+          token: `Token: ${args.tokenName}`,
+          amount: `Amount: ${args.amount}`,
+        },
+        toolName: MCP_TOOLS.TRANSFER_TOKEN,
+        actionDescription: 'execute the transfer',
+        displayFormat: 'Display the transaction details and confirmation.',
+      })
+    );
+  },
+};
+
+export const transferPrompts: MCPPrompt[] = [
+  transferGalaPrompt,
+  transferTokenPrompt,
+];

package/src/prompts/utility-tools.ts

@@ -0,0 +1,266 @@
+/**
+ * Utility Tools Prompts
+ *
+ * Slash commands for utility and system operations
+ */
+
+import type { MCPPrompt } from '../types/mcp.js';
+import { MCP_TOOLS } from '../constants/mcpToolNames.js';
+import { createPromptResponse } from './utils/handlerHelpers.js';
+import { createSimpleOperationText } from './utils/textTemplates.js';
+
+/**
+ * Create Wallet - Generate new wallet
+ */
+export const createWalletPrompt: MCPPrompt = {
+  name: 'galachain-launchpad:create-wallet',
+  description: 'Generate a new wallet with random private key',
+  handler: () =>
+    createPromptResponse(
+      createSimpleOperationText({
+        operation: 'Create a new wallet with random private key.',
+        toolName: MCP_TOOLS.CREATE_WALLET,
+        actionDescription: 'generate new wallet address, random private key, and wallet credentials for authentication',
+        displayFormat: 'Display the wallet details with a security warning about private key storage.',
+      })
+    ),
+};
+
+/**
+ * Get Address - Get GalaChain address
+ */
+export const getAddressPrompt: MCPPrompt = {
+  name: 'galachain-launchpad:get-address',
+  description: 'Get the GalaChain address format of authenticated wallet',
+  handler: () =>
+    createPromptResponse(
+      createSimpleOperationText({
+        operation: 'Get the GalaChain format address of the authenticated wallet.',
+        toolName: MCP_TOOLS.GET_ADDRESS,
+        actionDescription: 'retrieve the address in GalaChain format (eth|0x...)',
+        displayFormat: 'Display the wallet address.',
+      })
+    ),
+};
+
+/**
+ * Get Ethereum Address - Get Ethereum address
+ */
+export const getEthereumAddressPrompt: MCPPrompt = {
+  name: 'galachain-launchpad:get-ethereum-address',
+  description: 'Get the standard Ethereum address format of authenticated wallet',
+  handler: () =>
+    createPromptResponse(
+      createSimpleOperationText({
+        operation: 'Get the standard Ethereum format address of the authenticated wallet.',
+        toolName: MCP_TOOLS.GET_ETHEREUM_ADDRESS,
+        actionDescription: 'retrieve the address in Ethereum format (0x...)',
+        displayFormat: 'Display the wallet address.',
+      })
+    ),
+};
+
+/**
+ * Get Config - View SDK configuration
+ */
+export const getConfigPrompt: MCPPrompt = {
+  name: 'galachain-launchpad:get-config',
+  description: 'View current SDK and MCP server configuration',
+  handler: () =>
+    createPromptResponse(
+      createSimpleOperationText({
+        operation: 'Get the current SDK and MCP server configuration.',
+        toolName: MCP_TOOLS.GET_CONFIG,
+        actionDescription: 'retrieve environment, base URLs, timeout settings, feature flags, effective slippage tolerance factors, and current MCP server state',
+        displayFormat: 'Display the configuration in a readable format.',
+      })
+    ),
+};
+
+/**
+ * Get URL by Token Name - Generate launchpad URL
+ */
+export const getUrlByTokenNamePrompt: MCPPrompt = {
+  name: 'galachain-launchpad:get-url-by-token-name',
+  description: 'Get the launchpad frontend URL for a token',
+  arguments: [
+    {
+      name: 'tokenName',
+      description: 'Token name (e.g., anime)',
+      required: true,
+    },
+  ],
+  handler: (args) =>
+    createPromptResponse(
+      createSimpleOperationText({
+        operation: 'Get the launchpad frontend URL for a token.',
+        parameters: {
+          token_name: `Token: ${args.tokenName}`,
+        },
+        toolName: MCP_TOOLS.GET_URL_BY_TOKEN_NAME,
+        actionDescription: 'generate the URL',
+        displayFormat: 'Display the complete launchpad URL for viewing/trading the token.',
+      })
+    ),
+};
+
+/**
+ * Explain SDK Usage - SDK documentation helper
+ */
+export const explainSdkUsagePrompt: MCPPrompt = {
+  name: 'galachain-launchpad:explain-sdk-usage',
+  description: 'Get detailed SDK usage examples for a topic',
+  arguments: [
+    {
+      name: 'topic',
+      description: 'Topic: buy-tokens, sell-tokens, pool-graduation, fetch-pools, balances, dex-trading, liquidity-positions, price-history, token-details, token-distribution, token-creation, profile-management, multi-wallet, transfers, error-handling, installation, local-calculations, mcp-to-sdk-mapping',
+      required: true,
+    },
+  ],
+  handler: (args) =>
+    createPromptResponse(
+      createSimpleOperationText({
+        operation: `Get detailed SDK usage examples for topic: ${args.topic}.`,
+        toolName: MCP_TOOLS.EXPLAIN_SDK_USAGE,
+        actionDescription: 'retrieve complete runnable code examples',
+        displayFormat: 'Display the examples with explanations for integrating the SDK directly.',
+      })
+    ),
+};
+
+/**
+ * Get Cache Info - Cache statistics
+ */
+export const getCacheInfoPrompt: MCPPrompt = {
+  name: 'galachain-launchpad:get-cache-info',
+  description: 'Get token metadata cache statistics',
+  handler: () =>
+    createPromptResponse(
+      createSimpleOperationText({
+        operation: 'Get token metadata cache statistics.',
+        toolName: MCP_TOOLS.GET_CACHE_INFO,
+        actionDescription: 'retrieve total tokens cached, cache size in bytes, and timestamp of oldest entry',
+        displayFormat: 'Display the cache information.',
+      })
+    ),
+};
+
+/**
+ * Clear Cache - Cache management
+ */
+export const clearCachePrompt: MCPPrompt = {
+  name: 'galachain-launchpad:clear-cache',
+  description: 'Clear token metadata cache',
+  arguments: [
+    {
+      name: 'tokenName',
+      description: 'Token name to clear (optional, clears all if not provided)',
+      required: false,
+    },
+  ],
+  handler: (args) =>
+    createPromptResponse(
+      createSimpleOperationText({
+        operation: 'Clear token metadata cache.',
+        parameters: {
+          token_name: args.tokenName ? `Token: ${args.tokenName}` : 'Clearing entire cache',
+        },
+        toolName: MCP_TOOLS.CLEAR_CACHE,
+        actionDescription: 'clear the cache',
+        displayFormat: 'Display confirmation of cache clearing.',
+      })
+    ),
+};
+
+/**
+ * Has Wallet - Check wallet status
+ */
+export const hasWalletPrompt: MCPPrompt = {
+  name: 'galachain-launchpad:has-wallet',
+  description: 'Check if a wallet is configured in the MCP server',
+  handler: () =>
+    createPromptResponse(
+      createSimpleOperationText({
+        operation: 'Check wallet configuration status.',
+        toolName: MCP_TOOLS.HAS_WALLET,
+        actionDescription: 'determine whether a wallet is configured and whether MCP server is in full-access or read-only mode',
+        displayFormat: 'Display the wallet status clearly.',
+      })
+    ),
+};
+
+/**
+ * Get Wallet - Get wallet instance
+ */
+export const getWalletPrompt: MCPPrompt = {
+  name: 'galachain-launchpad:get-wallet',
+  description: 'Get the currently configured wallet instance',
+  handler: () =>
+    createPromptResponse(
+      createSimpleOperationText({
+        operation: 'Get the currently configured wallet instance.',
+        toolName: MCP_TOOLS.GET_WALLET,
+        actionDescription: 'retrieve wallet object if available (null if in read-only mode)',
+        displayFormat: 'Display the wallet information.',
+      })
+    ),
+};
+
+/**
+ * Set Wallet - Configure wallet
+ */
+export const setWalletPrompt: MCPPrompt = {
+  name: 'galachain-launchpad:set-wallet',
+  description: 'Configure a wallet for signing operations',
+  arguments: [
+    {
+      name: 'privateKey',
+      description: 'Private key in hex format (0x + 64 hex characters)',
+      required: true,
+    },
+  ],
+  handler: (args) =>
+    createPromptResponse(
+      createSimpleOperationText({
+        operation: 'Configure wallet for signing operations.',
+        parameters: {
+          private_key: `Private Key: ${args.privateKey.substring(0, 10)}...${args.privateKey.substring(60)}`,
+        },
+        toolName: MCP_TOOLS.SET_WALLET,
+        actionDescription: 'configure the wallet',
+        displayFormat: 'Display confirmation that wallet is configured for full-access mode.',
+      })
+    ),
+};
+
+/**
+ * Get Environment - Current environment query
+ */
+export const getEnvironmentPrompt: MCPPrompt = {
+  name: 'galachain-launchpad:get-environment',
+  description: 'Get the current MCP server environment',
+  handler: () =>
+    createPromptResponse(
+      createSimpleOperationText({
+        operation: 'Get the current MCP server environment.',
+        toolName: MCP_TOOLS.GET_ENVIRONMENT,
+        actionDescription: 'retrieve the active environment',
+        displayFormat: 'Display the current environment (production, development, or testing).',
+      })
+    ),
+};
+
+export const utilityToolPrompts: MCPPrompt[] = [
+  createWalletPrompt,
+  getAddressPrompt,
+  getEthereumAddressPrompt,
+  getConfigPrompt,
+  getUrlByTokenNamePrompt,
+  explainSdkUsagePrompt,
+  getCacheInfoPrompt,
+  clearCachePrompt,
+  hasWalletPrompt,
+  getWalletPrompt,
+  setWalletPrompt,
+  getEnvironmentPrompt,
+];

package/src/prompts/utility.ts

@@ -0,0 +1,77 @@
+/**
+ * Utility Prompts
+ *
+ * Slash commands for utility and information operations on Gala Launchpad
+ */
+
+import type { MCPPrompt } from '../types/mcp.js';
+import { createPromptResponse } from './utils/handlerHelpers.js';
+
+/**
+ * Get Version - Display SDK and MCP server version information
+ *
+ * Shows the current versions of both the Gala Launchpad SDK and the MCP server,
+ * useful for debugging version mismatch issues or verifying installed versions.
+ */
+export const getVersionPrompt: MCPPrompt = {
+  name: 'galachain-launchpad:version',
+  description: 'Get SDK and MCP server version information',
+  handler: () => {
+    return createPromptResponse(`Get version information for the Gala Launchpad SDK and MCP server.
+
+Use the gala_launchpad_get_version tool to fetch the version details.
+
+Display the results in a clear, formatted response showing:
+1. SDK Version
+2. MCP Server Version
+3. Timestamp
+
+This is helpful for debugging version compatibility issues or confirming installed versions.`);
+  },
+};
+
+/**
+ * Switch Environment - Dynamically change the MCP server environment
+ *
+ * Allows switching between production, development, and testing environments
+ * while preserving wallet configuration. Useful for testing against different
+ * backends or performing administrative operations.
+ */
+export const switchEnvironmentPrompt: MCPPrompt = {
+  name: 'galachain-launchpad:switch-environment',
+  description: 'Switch the MCP server to a different environment (production, development, or testing)',
+  arguments: [
+    {
+      name: 'environment',
+      description: 'Target environment: production, development, or testing',
+      required: false,
+    },
+  ],
+  handler: (args) => {
+    const targetEnv = args.environment?.toLowerCase() || '';
+    const validEnvs = ['production', 'development', 'testing'];
+    const isValidEnv = validEnvs.includes(targetEnv);
+
+    return createPromptResponse(`Switch the Gala Launchpad MCP server to a different environment.
+
+Current task: Switch to the ${isValidEnv ? targetEnv : 'specified'} environment
+
+Steps:
+1. First, get the current environment using the gala_launchpad_get_environment tool to see what we're currently on
+2. If switching is needed, use the gala_launchpad_switch_environment tool with environment="${targetEnv || 'production'}"
+3. After switching, verify the change by calling gala_launchpad_get_environment again
+4. Confirm the environment switch was successful and display the results
+
+Available environments:
+- production: Production environment (default)
+- development: Development environment for testing features
+- testing: Testing environment for local/staging tests
+
+Wallet Preservation: The wallet configuration will be preserved during the switch, maintaining your current signing capabilities if configured.`);
+  },
+};
+
+/**
+ * All utility prompts
+ */
+export const utilityPrompts: MCPPrompt[] = [getVersionPrompt, switchEnvironmentPrompt];

package/src/prompts/utils/handlerHelpers.ts

@@ -0,0 +1,55 @@
+/**
+ * Handler Helper Utilities
+ *
+ * Provides reusable utilities for creating MCP prompt handlers with
+ * standardized response formatting and validation patterns.
+ */
+
+import type { PromptMessage } from '../../types/mcp.js';
+
+/**
+ * Create a standard MCP prompt response with user role
+ *
+ * @param text - The prompt text to send to the user
+ * @returns Array containing formatted MCP message
+ *
+ * @example
+ * handler: (args) => {
+ *   validateTokenName(args.tokenName);
+ *   return createPromptResponse(`Fetch token ${args.tokenName}...`);
+ * }
+ */
+export function createPromptResponse(text: string): PromptMessage[] {
+  return [
+    {
+      role: 'user',
+      content: {
+        type: 'text',
+        text,
+      },
+    },
+  ];
+}
+
+/**
+ * Create a handler function that validates arguments and returns a prompt response
+ *
+ * @param validator - Function to validate the arguments
+ * @param textGenerator - Function that generates the prompt text from arguments
+ * @returns A handler function ready to use in a prompt definition
+ *
+ * @example
+ * handler: createValidatedHandler(
+ *   (args) => validateTokenName(args.tokenName),
+ *   (args) => `Fetch token ${args.tokenName}...`
+ * )
+ */
+export function createValidatedHandler<T>(
+  validator: (args: T) => void,
+  textGenerator: (args: T) => string
+): (args: T) => PromptMessage[] {
+  return (args: T) => {
+    validator(args);
+    return createPromptResponse(textGenerator(args));
+  };
+}

package/src/prompts/utils/textTemplates.ts

@@ -0,0 +1,73 @@
+/**
+ * Prompt Text Templates
+ *
+ * Provides reusable template generators for common MCP prompt patterns.
+ */
+
+/**
+ * Configuration for simple operation prompts
+ */
+export interface SimpleOperationConfig {
+  /** Operation description (e.g., "Fetch GALA balance for wallet.") */
+  operation: string;
+
+  /** Parameter descriptions as key-value pairs (optional) */
+  parameters?: Record<string, string | undefined>;
+
+  /** MCP tool name (e.g., MCP_TOOLS.FETCH_GALA_BALANCE) */
+  toolName: string;
+
+  /** Description of what the tool does (e.g., "retrieve the GALA balance") */
+  actionDescription: string;
+
+  /** Optional display format instructions */
+  displayFormat?: string;
+}
+
+/**
+ * Generate text for simple operation prompts
+ *
+ * Creates a standardized prompt text with operation, parameters, tool usage,
+ * and optional display format instructions.
+ *
+ * @param config - Configuration for the operation
+ * @returns Formatted prompt text
+ *
+ * @example
+ * text: createSimpleOperationText({
+ *   operation: 'Get GALA balance for wallet.',
+ *   parameters: {
+ *     address: args.address ? `Address: ${args.address}` : 'Using default wallet'
+ *   },
+ *   toolName: MCP_TOOLS.FETCH_GALA_BALANCE,
+ *   actionDescription: 'retrieve the GALA balance',
+ *   displayFormat: 'Display the balance in a clear format.'
+ * })
+ */
+export function createSimpleOperationText(config: SimpleOperationConfig): string {
+  const { operation, parameters, toolName, actionDescription, displayFormat } = config;
+
+  const parts: string[] = [operation];
+
+  // Add parameters section
+  if (parameters && Object.values(parameters).some((v) => v !== undefined)) {
+    parts.push('');
+    Object.entries(parameters).forEach(([, value]) => {
+      if (value !== undefined && value !== null && value !== '') {
+        parts.push(value);
+      }
+    });
+  }
+
+  // Add tool usage instruction
+  parts.push('');
+  parts.push(`Use ${toolName} to ${actionDescription}.`);
+
+  // Add display format if provided
+  if (displayFormat) {
+    parts.push('');
+    parts.push(displayFormat);
+  }
+
+  return parts.join('\n');
+}