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

package/src/prompts/transfers.ts

@@ -0,0 +1,103 @@
+/**
+ * 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';
+
+/**
+ * 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 [
+      {
+        role: 'user',
+        content: {
+          type: 'text',
+          text: `Transfer GALA tokens.
+
+Recipient: ${args.recipientAddress}
+Amount: ${args.amount} GALA
+
+Use ${MCP_TOOLS.TRANSFER_GALA} to execute the transfer.
+
+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 [
+      {
+        role: 'user',
+        content: {
+          type: 'text',
+          text: `Transfer launchpad tokens.
+
+Recipient: ${args.to}
+Token: ${args.tokenName}
+Amount: ${args.amount}
+
+Use ${MCP_TOOLS.TRANSFER_TOKEN} to execute the transfer.
+
+Display the transaction details and confirmation.`,
+        },
+      },
+    ];
+  },
+};
+
+export const transferPrompts: MCPPrompt[] = [
+  transferGalaPrompt,
+  transferTokenPrompt,
+];

package/src/prompts/utility-tools.ts

@@ -0,0 +1,349 @@
+/**
+ * Utility Tools Prompts
+ *
+ * Slash commands for utility and system operations
+ */
+
+import type { MCPPrompt } from '../types/mcp.js';
+import { MCP_TOOLS } from '../constants/mcpToolNames.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: () => {
+    return [
+      {
+        role: 'user',
+        content: {
+          type: 'text',
+          text: `Create a new wallet with random private key.
+
+Use ${MCP_TOOLS.CREATE_WALLET} to generate:
+- New wallet address
+- Random private key
+- Wallet credentials for authentication
+
+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: () => {
+    return [
+      {
+        role: 'user',
+        content: {
+          type: 'text',
+          text: `Get the GalaChain format address of the authenticated wallet.
+
+Use ${MCP_TOOLS.GET_ADDRESS} to retrieve the address in GalaChain format (eth|0x...).
+
+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: () => {
+    return [
+      {
+        role: 'user',
+        content: {
+          type: 'text',
+          text: `Get the standard Ethereum format address of the authenticated wallet.
+
+Use ${MCP_TOOLS.GET_ETHEREUM_ADDRESS} to retrieve the address in Ethereum format (0x...).
+
+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: () => {
+    return [
+      {
+        role: 'user',
+        content: {
+          type: 'text',
+          text: `Get the current SDK and MCP server configuration.
+
+Use ${MCP_TOOLS.GET_CONFIG} to retrieve:
+- Environment (production, development, testing)
+- Base URLs
+- Timeout settings
+- Feature flags
+- Effective slippage tolerance factors
+- Current MCP server environment state
+
+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) => {
+    return [
+      {
+        role: 'user',
+        content: {
+          type: 'text',
+          text: `Get the launchpad frontend URL for a token.
+
+Token: ${args.tokenName}
+
+Use ${MCP_TOOLS.GET_URL_BY_TOKEN_NAME} to generate the URL.
+
+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) => {
+    return [
+      {
+        role: 'user',
+        content: {
+          type: 'text',
+          text: `Get detailed SDK usage examples for topic: ${args.topic}
+
+Use ${MCP_TOOLS.EXPLAIN_SDK_USAGE} to retrieve complete runnable code examples.
+
+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: () => {
+    return [
+      {
+        role: 'user',
+        content: {
+          type: 'text',
+          text: `Get token metadata cache statistics.
+
+Use ${MCP_TOOLS.GET_CACHE_INFO} to retrieve:
+- Total tokens cached
+- Cache size in bytes
+- Timestamp of oldest entry
+
+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) => {
+    return [
+      {
+        role: 'user',
+        content: {
+          type: 'text',
+          text: `Clear token metadata cache.
+
+${args.tokenName ? `Token: ${args.tokenName}` : 'Clearing entire cache'}
+
+Use ${MCP_TOOLS.CLEAR_CACHE} to clear the cache.
+
+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: () => {
+    return [
+      {
+        role: 'user',
+        content: {
+          type: 'text',
+          text: `Check wallet configuration status.
+
+Use ${MCP_TOOLS.HAS_WALLET} to determine:
+- Whether a wallet is configured
+- Whether MCP server is in full-access or read-only mode
+
+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: () => {
+    return [
+      {
+        role: 'user',
+        content: {
+          type: 'text',
+          text: `Get the currently configured wallet instance.
+
+Use ${MCP_TOOLS.GET_WALLET} to retrieve:
+- Wallet object if available
+- Null if in read-only mode
+
+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) => {
+    return [
+      {
+        role: 'user',
+        content: {
+          type: 'text',
+          text: `Configure wallet for signing operations.
+
+Private Key: ${args.privateKey.substring(0, 10)}...${args.privateKey.substring(60)}
+
+Use ${MCP_TOOLS.SET_WALLET} to configure the wallet.
+
+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: () => {
+    return [
+      {
+        role: 'user',
+        content: {
+          type: 'text',
+          text: `Get the current MCP server environment.
+
+Use ${MCP_TOOLS.GET_ENVIRONMENT} to retrieve the active environment.
+
+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,92 @@
+/**
+ * Utility Prompts
+ *
+ * Slash commands for utility and information operations on Gala Launchpad
+ */
+
+import type { MCPPrompt } from '../types/mcp.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 [
+      {
+        role: 'user',
+        content: {
+          type: 'text',
+          text: `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 [
+      {
+        role: 'user',
+        content: {
+          type: 'text',
+          text: `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];