@gala-chain/launchpad-mcp-server 1.24.1 → 1.25.0

package/src/__tests__/integration/poolTools.integration.test.ts

@@ -1,185 +0,0 @@
-/**
- * Integration Tests for Pool Tools
- *
- * These tests use real SDK instances and make actual API calls.
- * Requires valid PRIVATE_KEY environment variable.
- *
- * Run with: npm run test:integration
- */
-
-import { AgentConfig } from '@gala-chain/launchpad-sdk';
-import { fetchPoolsTool, fetchPoolDetailsTool } from '../../tools/pools/index.js';
-
-describe('Pool Tools Integration', () => {
-  let sdk: any;
-
-  beforeAll(async () => {
-    // Skip tests if no private key available
-    if (!process.env.PRIVATE_KEY) {
-      console.warn('⚠️  Skipping integration tests: PRIVATE_KEY environment variable not set');
-      return;
-    }
-
-    // Initialize SDK with AgentConfig
-    const { sdk: initializedSdk } = await AgentConfig.quickSetup({
-      environment: (process.env.ENVIRONMENT as any) || 'development',
-      privateKey: process.env.PRIVATE_KEY,
-      timeout: 30000,
-      debug: false,
-      autoValidate: false,
-    });
-
-    sdk = initializedSdk;
-  });
-
-  afterAll(() => {
-    if (sdk) {
-      sdk.cleanup();
-    }
-  });
-
-  describe('fetchPoolsTool', () => {
-    it('should fetch recent pools successfully', async () => {
-      if (!sdk) {
-        return; // Skip if SDK not initialized
-      }
-
-      const result = await fetchPoolsTool.handler(sdk, {
-        type: 'recent',
-        limit: 5,
-        page: 1,
-      });
-
-      expect(result).toBeDefined();
-      expect(result.content).toBeDefined();
-      expect(Array.isArray(result.content)).toBe(true);
-      expect(result.content.length).toBeGreaterThan(0);
-
-      const response = JSON.parse(result.content[0].text!);
-      expect(response).toHaveProperty('pools');
-      expect(Array.isArray(response.pools)).toBe(true);
-      expect(response.pools.length).toBeLessThanOrEqual(5);
-    });
-
-    it('should fetch popular pools successfully', async () => {
-      if (!sdk) {
-        return;
-      }
-
-      const result = await fetchPoolsTool.handler(sdk, {
-        type: 'popular',
-        limit: 3,
-        page: 1,
-      });
-
-      expect(result).toBeDefined();
-      const response = JSON.parse(result.content[0].text!);
-      expect(response).toHaveProperty('pools');
-      expect(response.pools.length).toBeLessThanOrEqual(3);
-    });
-
-    it('should handle pagination correctly', async () => {
-      if (!sdk) {
-        return;
-      }
-
-      const page1 = await fetchPoolsTool.handler(sdk, {
-        type: 'recent',
-        limit: 2,
-        page: 1,
-      });
-
-      const page2 = await fetchPoolsTool.handler(sdk, {
-        type: 'recent',
-        limit: 2,
-        page: 2,
-      });
-
-      const response1 = JSON.parse(page1.content[0].text!);
-      const response2 = JSON.parse(page2.content[0].text!);
-
-      expect(response1.page).toBe(1);
-      expect(response2.page).toBe(2);
-
-      // Different pools on different pages
-      if (response1.pools.length > 0 && response2.pools.length > 0) {
-        expect(response1.pools[0].name).not.toBe(response2.pools[0].name);
-      }
-    });
-  });
-
-  describe('fetchPoolDetailsTool', () => {
-    it('should fetch pool details for a known token', async () => {
-      if (!sdk) {
-        return;
-      }
-
-      // First get a pool name from recent pools
-      const pools = await fetchPoolsTool.handler(sdk, {
-        type: 'recent',
-        limit: 1,
-        page: 1,
-      });
-
-      const poolsResponse = JSON.parse(pools.content[0].text!);
-
-      if (poolsResponse.pools.length === 0) {
-        console.warn('⚠️  No pools available for testing');
-        return;
-      }
-
-      const tokenName = poolsResponse.pools[0].name;
-
-      // Fetch details for that token
-      const result = await fetchPoolDetailsTool.handler(sdk, {
-        tokenName,
-      });
-
-      expect(result).toBeDefined();
-      const response = JSON.parse(result.content[0].text!);
-
-      expect(response).toHaveProperty('name', tokenName);
-      expect(response).toHaveProperty('symbol');
-      expect(response).toHaveProperty('saleStatus');
-      expect(response).toHaveProperty('currentSupply');
-      expect(response).toHaveProperty('maxSupply');
-    });
-
-    it('should handle non-existent token gracefully', async () => {
-      if (!sdk) {
-        return;
-      }
-
-      const result = await fetchPoolDetailsTool.handler(sdk, {
-        tokenName: 'nonexistenttoken123456',
-      });
-
-      // Should return error response
-      expect(result).toBeDefined();
-      expect(result.isError).toBe(true);
-    });
-  });
-
-  describe('MCP Response Format', () => {
-    it('should return valid MCP response structure', async () => {
-      if (!sdk) {
-        return;
-      }
-
-      const result = await fetchPoolsTool.handler(sdk, {
-        type: 'recent',
-        limit: 1,
-        page: 1,
-      });
-
-      // Validate MCP response structure
-      expect(result).toHaveProperty('content');
-      expect(Array.isArray(result.content)).toBe(true);
-      expect(result.content[0]).toHaveProperty('type', 'text');
-      expect(result.content[0]).toHaveProperty('text');
-
-      // Validate JSON parseable
-      expect(() => JSON.parse(result.content[0].text!)).not.toThrow();
-    });
-  });
-});

package/src/__tests__/server.test.ts

@@ -1,255 +0,0 @@
-/**
- * MCP Server Tests
- *
- * Comprehensive test suite for LaunchpadMCPServer environment switching,
- * state management, and core server functionality.
- *
- * Note: These tests focus on the public API contract and behavior
- * rather than implementation details to avoid over-mocking dependencies.
- */
-
-describe('LaunchpadMCPServer', () => {
-  /**
-   * Environment Switching Contract Tests
-   *
-   * These tests verify the documented API contract for environment
-   * switching without requiring the full MCP SDK setup.
-   *
-   * The actual functionality is validated through:
-   * 1. TypeScript type checking (src/server.ts types)
-   * 2. Runtime behavior validation in manual testing
-   * 3. Integration tests in CI/CD pipeline
-   */
-
-  describe('switchEnvironment() API Contract', () => {
-    it('should accept production as valid environment', () => {
-      const validEnv: 'production' | 'development' | 'testing' = 'production';
-      expect(validEnv).toBeDefined();
-    });
-
-    it('should accept development as valid environment', () => {
-      const validEnv: 'production' | 'development' | 'testing' = 'development';
-      expect(validEnv).toBeDefined();
-    });
-
-    it('should accept testing as valid environment', () => {
-      const validEnv: 'production' | 'development' | 'testing' = 'testing';
-      expect(validEnv).toBeDefined();
-    });
-  });
-
-  describe('getEnvironment() API Contract', () => {
-    it('should return a string representing the environment', () => {
-      const env: 'production' | 'development' | 'testing' = 'production';
-      expect(typeof env).toBe('string');
-      expect(['production', 'development', 'testing']).toContain(env);
-    });
-  });
-
-  describe('Server State Management Contract', () => {
-    it('should store currentEnvironment with three valid options', () => {
-      type Environment = 'production' | 'development' | 'testing';
-      const validEnvironments: Environment[] = ['production', 'development', 'testing'];
-
-      validEnvironments.forEach((env) => {
-        expect(['production', 'development', 'testing']).toContain(env);
-      });
-    });
-
-    it('should store currentPrivateKey as optional string', () => {
-      const privateKey: string | undefined = '0x1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef';
-      expect(typeof privateKey).toBe('string');
-
-      const noKey: string | undefined = undefined;
-      expect(noKey).toBeUndefined();
-    });
-  });
-
-  describe('Environment Switch Response Contract', () => {
-    it('should return success indicator', () => {
-      const response = { success: true, previousEnvironment: 'production', newEnvironment: 'development' };
-      expect(response.success).toBe(true);
-    });
-
-    it('should track both previous and new environments', () => {
-      const response = { success: true, previousEnvironment: 'production', newEnvironment: 'development' };
-      expect(response.previousEnvironment).toBe('production');
-      expect(response.newEnvironment).toBe('development');
-    });
-
-    it('should show environment change progression', () => {
-      const response1 = { success: true, previousEnvironment: 'production', newEnvironment: 'development' };
-      const response2 = { success: true, previousEnvironment: 'development', newEnvironment: 'testing' };
-
-      expect(response1.newEnvironment).toBe(response2.previousEnvironment);
-    });
-  });
-
-  describe('Initialization Mode Contract', () => {
-    it('should support full-access mode with private key', () => {
-      const hasPrivateKey = Boolean('0x1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef');
-      expect(hasPrivateKey).toBe(true);
-    });
-
-    it('should support read-only mode without private key', () => {
-      const hasPrivateKey = Boolean(undefined);
-      expect(hasPrivateKey).toBe(false);
-    });
-  });
-
-  describe('Wallet Preservation Contract', () => {
-    it('should preserve wallet across environment switches', () => {
-      const originalWallet = '0xaaaa567890abcdef1234567890abcdef1234567890abcdef1234567890bcdef';
-      const preservedWallet = originalWallet; // Simulates internal preservation
-
-      expect(preservedWallet).toBe(originalWallet);
-    });
-
-    it('should maintain same wallet for multiple switches', () => {
-      const wallet = '0xbbbb567890abcdef1234567890abcdef1234567890abcdef1234567890bcdef';
-
-      const switch1 = { wallet }; // prod -> dev
-      const switch2 = { wallet }; // dev -> testing
-      const switch3 = { wallet }; // testing -> prod
-
-      expect(switch1.wallet).toBe(switch2.wallet);
-      expect(switch2.wallet).toBe(switch3.wallet);
-    });
-  });
-
-  describe('Error Handling Contract', () => {
-    it('should maintain server state on switch failure', () => {
-      const originalEnv = 'production';
-
-      // Simulates switch failure leaving original state intact
-      const finalEnv = originalEnv;
-
-      expect(finalEnv).toBe(originalEnv);
-    });
-
-    it('should preserve SDK when switch fails', () => {
-      const hasSdk = true; // Before switch attempt
-      const stillHasSdk = true; // After failed switch
-
-      expect(hasSdk).toBe(stillHasSdk);
-    });
-  });
-
-  describe('Configuration Retrieval Contract', () => {
-    it('should include mcpServerEnvironment in getConfig response', () => {
-      const config = {
-        baseUrl: 'https://api.example.com',
-        environment: 'production',
-        mcpServerEnvironment: 'production',
-      };
-
-      expect(config).toHaveProperty('mcpServerEnvironment');
-      expect(config.mcpServerEnvironment).toBe('production');
-    });
-
-    it('should reflect current environment in config', () => {
-      const currentEnv = 'development';
-      const config = { mcpServerEnvironment: currentEnv };
-
-      expect(config.mcpServerEnvironment).toBe(currentEnv);
-    });
-  });
-
-  describe('Type Safety Contract', () => {
-    it('should enforce environment type at compile time', () => {
-      // These would fail TypeScript compilation with wrong values
-      const validEnvs: Array<'production' | 'development' | 'testing'> = [
-        'production',
-        'development',
-        'testing',
-      ];
-
-      expect(validEnvs).toHaveLength(3);
-    });
-
-    it('should enforce optional private key type', () => {
-      // Valid variations
-      const fullAccess: string | undefined = '0x1234...';
-      const readOnly: string | undefined = undefined;
-
-      expect(typeof fullAccess).toBe('string');
-      expect(readOnly).toBeUndefined();
-    });
-  });
-
-  describe('Backward Compatibility Contract', () => {
-    it('should accept optional server parameter in tool handlers', () => {
-      type ToolHandler = (sdk: any, args: any, server?: any) => Promise<any>;
-
-      // Handler can work with or without server parameter
-      const handlerWithServer: ToolHandler = async (sdk, args, server) => {
-        return { result: server?.getEnvironment?.() };
-      };
-
-      const handlerWithoutServer: ToolHandler = async (_sdk, _args) => {
-        return { result: 'ok' };
-      };
-
-      expect(typeof handlerWithServer).toBe('function');
-      expect(typeof handlerWithoutServer).toBe('function');
-    });
-  });
-
-  describe('Server-Level Tool Factory Contract', () => {
-    it('should enable tools to access server state', () => {
-      interface ServerLevelToolConfig {
-        name: string;
-        description: string;
-        handler: (sdk: any, args: any, server: any) => Promise<any>;
-      }
-
-      const config: ServerLevelToolConfig = {
-        name: 'test-tool',
-        description: 'Test tool',
-        handler: async (sdk, args, server) => {
-          return { environment: server.getEnvironment() };
-        },
-      };
-
-      expect(config.handler).toBeDefined();
-      expect(typeof config.handler).toBe('function');
-    });
-  });
-
-  describe('Integration Pattern Validation', () => {
-    it('should support switching between all environment pairs', () => {
-      const environments: Array<'production' | 'development' | 'testing'> = [
-        'production',
-        'development',
-        'testing',
-      ];
-
-      // Validate all possible pairs
-      const pairs: Array<[string, string]> = [];
-      environments.forEach((from) => {
-        environments.forEach((to) => {
-          if (from !== to) {
-            pairs.push([from, to]);
-          }
-        });
-      });
-
-      expect(pairs).toHaveLength(6); // 3 * 2 non-diagonal transitions
-    });
-
-    it('should handle rapid successive switches', () => {
-      const switches = [
-        { from: 'production', to: 'development' },
-        { from: 'development', to: 'testing' },
-        { from: 'testing', to: 'production' },
-      ];
-
-      expect(switches).toHaveLength(3);
-      switches.forEach((s, i) => {
-        if (i > 0) {
-          expect(s.from).toBe(switches[i - 1].to);
-        }
-      });
-    });
-  });
-});

package/src/constants/mcpToolNames.ts

@@ -1,183 +0,0 @@
-/**
- * MCP Tool Name Constants
- *
- * Centralized constants for all Gala Launchpad MCP tool names.
- * Use these constants instead of hardcoded strings to prevent typos
- * and enable IDE autocomplete.
- *
- * Total: 74 tools across 9 categories (added 2 new DEX pool discovery tools)
- */
-
-/**
- * Pool Management & Pricing Tools (17 tools)
- */
-export const POOL_TOOLS = {
-  FETCH_POOLS: 'gala_launchpad_fetch_pools',
-  FETCH_ALL_POOLS: 'gala_launchpad_fetch_all_pools',
-  FETCH_POOL_DETAILS: 'gala_launchpad_fetch_pool_details',
-  FETCH_POOL_DETAILS_FOR_CALCULATION: 'gala_launchpad_fetch_pool_details_for_calculation',
-  FETCH_TOKEN_DETAILS: 'gala_launchpad_fetch_token_details',
-  FETCH_TOKEN_DISTRIBUTION: 'gala_launchpad_fetch_token_distribution',
-  FETCH_TOKEN_BADGES: 'gala_launchpad_fetch_token_badges',
-  FETCH_VOLUME_DATA: 'gala_launchpad_fetch_volume_data',
-  FETCH_GALA_SPOT_PRICE: 'gala_launchpad_fetch_gala_spot_price',
-  FETCH_TOKEN_SPOT_PRICE: 'gala_launchpad_fetch_token_spot_price',
-  FETCH_LAUNCHPAD_TOKEN_SPOT_PRICE: 'gala_launchpad_fetch_launchpad_token_spot_price',
-  FETCH_PRICE_HISTORY: 'gala_launchpad_fetch_price_history',
-  FETCH_ALL_PRICE_HISTORY: 'gala_launchpad_fetch_all_price_history',
-  CHECK_TOKEN_NAME: 'gala_launchpad_check_token_name',
-  CHECK_TOKEN_SYMBOL: 'gala_launchpad_check_token_symbol',
-  RESOLVE_VAULT_ADDRESS: 'gala_launchpad_resolve_vault_address',
-  RESOLVE_TOKEN_CLASS_KEY: 'gala_launchpad_resolve_token_class_key',
-} as const;
-
-/**
- * Trading Operations Tools (13 tools)
- */
-export const TRADING_TOOLS = {
-  CALCULATE_BUY_AMOUNT: 'gala_launchpad_calculate_buy_amount',
-  CALCULATE_BUY_AMOUNT_LOCAL: 'gala_launchpad_calculate_buy_amount_local',
-  CALCULATE_BUY_AMOUNT_EXTERNAL: 'gala_launchpad_calculate_buy_amount_external',
-  CALCULATE_SELL_AMOUNT: 'gala_launchpad_calculate_sell_amount',
-  CALCULATE_SELL_AMOUNT_LOCAL: 'gala_launchpad_calculate_sell_amount_local',
-  CALCULATE_SELL_AMOUNT_EXTERNAL: 'gala_launchpad_calculate_sell_amount_external',
-  CALCULATE_BUY_AMOUNT_FOR_GRADUATION: 'gala_launchpad_calculate_buy_amount_for_graduation',
-  BUY_TOKENS: 'gala_launchpad_buy_tokens',
-  SELL_TOKENS: 'gala_launchpad_sell_tokens',
-  GRADUATE_TOKEN: 'gala_launchpad_graduate_token',
-  FETCH_TRADES: 'gala_launchpad_fetch_trades',
-  GET_BUNDLER_TRANSACTION_RESULT: 'gala_launchpad_get_bundler_transaction_result',
-  IS_TOKEN_GRADUATED: 'gala_launchpad_is_token_graduated',
-} as const;
-
-/**
- * Balance & Portfolio Tools (6 tools)
- */
-export const BALANCE_TOOLS = {
-  FETCH_GALA_BALANCE: 'gala_launchpad_fetch_gala_balance',
-  FETCH_TOKEN_BALANCE: 'gala_launchpad_fetch_token_balance',
-  FETCH_TOKENS_HELD: 'gala_launchpad_fetch_tokens_held',
-  FETCH_TOKENS_CREATED: 'gala_launchpad_fetch_tokens_created',
-  FETCH_PROFILE: 'gala_launchpad_fetch_profile',
-  UPDATE_PROFILE: 'gala_launchpad_update_profile',
-} as const;
-
-/**
- * Token Creation Tools (5 tools)
- */
-export const CREATION_TOOLS = {
-  LAUNCH_TOKEN: 'gala_launchpad_launch_token',
-  UPLOAD_TOKEN_IMAGE: 'gala_launchpad_upload_token_image',
-  UPLOAD_PROFILE_IMAGE: 'gala_launchpad_upload_profile_image',
-  FETCH_LAUNCH_TOKEN_FEE: 'gala_launchpad_fetch_launch_token_fee',
-  CALCULATE_INITIAL_BUY: 'gala_launchpad_calculate_initial_buy',
-} as const;
-
-/**
- * Social & Comments Tools (2 tools)
- */
-export const SOCIAL_TOOLS = {
-  POST_COMMENT: 'gala_launchpad_post_comment',
-  FETCH_COMMENTS: 'gala_launchpad_fetch_comments',
-} as const;
-
-/**
- * Token Transfer Tools (2 tools)
- */
-export const TRANSFER_TOOLS = {
-  TRANSFER_GALA: 'gala_launchpad_transfer_gala',
-  TRANSFER_TOKEN: 'gala_launchpad_transfer_token',
-} as const;
-
-/**
- * Utility Tools (14 tools)
- */
-export const UTILITY_TOOLS = {
-  CREATE_WALLET: 'gala_launchpad_create_wallet',
-  GET_ADDRESS: 'gala_launchpad_get_address',
-  GET_ETHEREUM_ADDRESS: 'gala_launchpad_get_ethereum_address',
-  GET_CONFIG: 'gala_launchpad_get_config',
-  GET_URL_BY_TOKEN_NAME: 'gala_launchpad_get_url_by_token_name',
-  EXPLAIN_SDK_USAGE: 'gala_launchpad_explain_sdk_usage',
-  GET_CACHE_INFO: 'gala_launchpad_get_cache_info',
-  CLEAR_CACHE: 'gala_launchpad_clear_cache',
-  HAS_WALLET: 'gala_launchpad_has_wallet',
-  GET_WALLET: 'gala_launchpad_get_wallet',
-  SET_WALLET: 'gala_launchpad_set_wallet',
-  GET_ENVIRONMENT: 'gala_launchpad_get_environment',
-  SWITCH_ENVIRONMENT: 'gala_launchpad_switch_environment',
-  GET_VERSION: 'gala_launchpad_get_version',
-} as const;
-
-/**
- * DEX Trading & Pool Discovery Tools (7 tools)
- */
-export const DEX_TOOLS = {
-  FETCH_DEX_POOLS: 'gala_launchpad_fetch_dex_pools',
-  FETCH_ALL_DEX_POOLS: 'gala_launchpad_fetch_all_dex_pools',
-  GET_SWAP_QUOTE_EXACT_INPUT: 'gala_launchpad_get_swap_quote_exact_input',
-  GET_SWAP_QUOTE_EXACT_OUTPUT: 'gala_launchpad_get_swap_quote_exact_output',
-  EXECUTE_SWAP: 'gala_launchpad_execute_swap',
-  GET_SWAP_USER_ASSETS: 'gala_launchpad_get_swap_user_assets',
-  GET_SWAP_POOL_INFO: 'gala_launchpad_get_swap_pool_info',
-} as const;
-
-/**
- * Liquidity Position Management Tools (8 tools)
- */
-export const LIQUIDITY_TOOLS = {
-  GET_USER_LIQUIDITY_POSITIONS: 'gala_launchpad_get_user_liquidity_positions',
-  GET_LIQUIDITY_POSITION_BY_ID: 'gala_launchpad_get_liquidity_position_by_id',
-  GET_LIQUIDITY_POSITION: 'gala_launchpad_get_liquidity_position',
-  ESTIMATE_REMOVE_LIQUIDITY: 'gala_launchpad_estimate_remove_liquidity',
-  ADD_LIQUIDITY_BY_PRICE: 'gala_launchpad_add_liquidity_by_price',
-  ADD_LIQUIDITY_BY_TICKS: 'gala_launchpad_add_liquidity_by_ticks',
-  REMOVE_LIQUIDITY: 'gala_launchpad_remove_liquidity',
-  COLLECT_POSITION_FEES: 'gala_launchpad_collect_position_fees',
-} as const;
-
-/**
- * All MCP Tools - Flat structure for easy access
- *
- * Use specific category constants above for better organization,
- * or use this flat object for backwards compatibility.
- */
-export const MCP_TOOLS = {
-  // Pool Management & Pricing
-  ...POOL_TOOLS,
-  // Trading Operations
-  ...TRADING_TOOLS,
-  // Balance & Portfolio
-  ...BALANCE_TOOLS,
-  // Token Creation
-  ...CREATION_TOOLS,
-  // Social & Comments
-  ...SOCIAL_TOOLS,
-  // Token Transfers
-  ...TRANSFER_TOOLS,
-  // Utilities
-  ...UTILITY_TOOLS,
-  // DEX Trading
-  ...DEX_TOOLS,
-  // Liquidity Positions
-  ...LIQUIDITY_TOOLS,
-} as const;
-
-/**
- * Type helper for tool names
- */
-export type MCPToolName = (typeof MCP_TOOLS)[keyof typeof MCP_TOOLS];
-
-/**
- * Get all tool names as an array
- */
-export function getAllToolNames(): string[] {
-  return Object.values(MCP_TOOLS);
-}
-
-/**
- * Check if a string is a valid MCP tool name
- */
-export function isValidToolName(name: string): name is MCPToolName {
-  return getAllToolNames().includes(name);
-}

package/src/index.ts

@@ -1,19 +0,0 @@
-#!/usr/bin/env node
-/**
- * Gala Launchpad MCP Server Entry Point
- */
-
-import { LaunchpadMCPServer } from './server.js';
-
-async function main() {
-  const server = new LaunchpadMCPServer();
-
-  try {
-    await server.start();
-  } catch (error) {
-    console.error('[MCP Server] Fatal error:', error);
-    process.exit(1);
-  }
-}
-
-main();