@gala-chain/launchpad-mcp-server 1.13.4 → 1.14.0

package/src/prompts/__tests__/promptStructure.test.ts

@@ -1,114 +0,0 @@
-/**
- * Prompt Structure Tests
- *
- * Validates that all prompts conform to MCP protocol specification
- */
-
-import { prompts } from '../index';
-
-describe('Prompt Structure', () => {
-  // Helper to generate valid args for each prompt type
-  function getValidArgsForPrompt(promptName: string): Record<string, string> {
-    if (promptName.includes('analyze-token') || promptName.includes('pool-details')) {
-      return { tokenName: 'anime' };
-    }
-    if (promptName.includes('buy-tokens')) {
-      return { tokenName: 'anime', galaAmount: '100' };
-    }
-    if (promptName.includes('sell-tokens')) {
-      return { tokenName: 'anime', tokenAmount: '1000' };
-    }
-    if (promptName.includes('graduate-token')) {
-      return { tokenName: 'anime' };
-    }
-    if (promptName.includes('compare-tokens')) {
-      return { token1: 'anime', token2: 'test' };
-    }
-    if (promptName.includes('graduation-status') || promptName.includes('spot-prices')) {
-      return { tokens: 'anime,test,dragon' };
-    }
-    return {}; // For prompts with no required args (portfolio, balance, etc.)
-  }
-
-  describe('MCP Protocol Compliance', () => {
-    it.each(prompts)('$name should have required fields', (prompt) => {
-      expect(prompt).toHaveProperty('name');
-      expect(prompt).toHaveProperty('description');
-      expect(prompt).toHaveProperty('handler');
-      expect(typeof prompt.name).toBe('string');
-      expect(typeof prompt.description).toBe('string');
-      expect(typeof prompt.handler).toBe('function');
-    });
-
-    it.each(prompts)('$name should have valid argument structure', (prompt) => {
-      if (prompt.arguments) {
-        expect(Array.isArray(prompt.arguments)).toBe(true);
-        prompt.arguments.forEach((arg) => {
-          expect(arg).toHaveProperty('name');
-          expect(arg).toHaveProperty('description');
-          expect(arg).toHaveProperty('required');
-          expect(typeof arg.name).toBe('string');
-          expect(typeof arg.description).toBe('string');
-          expect(typeof arg.required).toBe('boolean');
-        });
-      }
-    });
-
-    it.each(prompts)('$name handler should return PromptMessage array', (prompt) => {
-      const args = getValidArgsForPrompt(prompt.name);
-      const messages = prompt.handler(args);
-      expect(Array.isArray(messages)).toBe(true);
-      expect(messages.length).toBeGreaterThan(0);
-    });
-
-    it.each(prompts)('$name messages should have valid structure', (prompt) => {
-      const args = getValidArgsForPrompt(prompt.name);
-      const messages = prompt.handler(args);
-      messages.forEach((msg) => {
-        expect(msg).toHaveProperty('role');
-        expect(msg).toHaveProperty('content');
-        expect(['user', 'assistant']).toContain(msg.role);
-        expect(msg.content).toHaveProperty('type');
-        expect(['text', 'image', 'resource']).toContain(msg.content.type);
-      });
-    });
-  });
-
-  describe('Handler Execution', () => {
-    it('analyze-token handler should accept tokenName', () => {
-      const prompt = prompts.find((p) => p.name === 'galachain-launchpad:analyze-token');
-      expect(() => prompt?.handler({ tokenName: 'anime' })).not.toThrow();
-    });
-
-    it('buy-tokens handler should accept required args', () => {
-      const prompt = prompts.find((p) => p.name === 'galachain-launchpad:buy-tokens');
-      expect(() => prompt?.handler({ tokenName: 'anime', galaAmount: '100' })).not.toThrow();
-    });
-
-    it('graduate-token handler should accept optional slippage', () => {
-      const prompt = prompts.find((p) => p.name === 'galachain-launchpad:graduate-token');
-      expect(() => prompt?.handler({ tokenName: 'anime', slippage: '2' })).not.toThrow();
-    });
-  });
-
-  describe('Message Content', () => {
-    it.each(prompts)('$name should generate non-empty text content', (prompt) => {
-      const args = getValidArgsForPrompt(prompt.name);
-      const messages = prompt.handler(args);
-      messages.forEach((msg) => {
-        if (msg.content.type === 'text') {
-          expect(msg.content.text).toBeDefined();
-          expect(msg.content.text!.length).toBeGreaterThan(10);
-        }
-      });
-    });
-
-    it.each(prompts)('$name should reference MCP tools in instructions', (prompt) => {
-      const args = getValidArgsForPrompt(prompt.name);
-      const messages = prompt.handler(args);
-      const text = messages[0].content.text || '';
-      // Should contain at least one tool reference
-      expect(text).toMatch(/gala_launchpad_/);
-    });
-  });
-});

package/src/prompts/__tests__/registry.test.ts

@@ -1,143 +0,0 @@
-/**
- * Prompt Registry Tests
- *
- * Tests for prompt registration, lookup, and utility functions
- */
-
-import {
-  prompts,
-  getPrompt,
-  getPromptNames,
-  hasPrompt,
-  getPromptsByCategory,
-  getPromptCount,
-} from '../index';
-
-describe('Prompt Registry', () => {
-  describe('prompts array', () => {
-    it('should contain exactly 14 prompts', () => {
-      expect(prompts).toHaveLength(14);
-    });
-
-    it('should have all unique prompt names', () => {
-      const names = prompts.map((p) => p.name);
-      const uniqueNames = new Set(names);
-      expect(uniqueNames.size).toBe(names.length);
-    });
-
-    it('should have all prompts with galachain-launchpad prefix', () => {
-      prompts.forEach((prompt) => {
-        expect(prompt.name).toMatch(/^galachain-launchpad:/);
-      });
-    });
-  });
-
-  describe('getPrompt()', () => {
-    it('should return prompt for valid name', () => {
-      const prompt = getPrompt('galachain-launchpad:analyze-token');
-      expect(prompt).toBeDefined();
-      expect(prompt?.name).toBe('galachain-launchpad:analyze-token');
-    });
-
-    it('should return undefined for invalid name', () => {
-      const prompt = getPrompt('non-existent-prompt');
-      expect(prompt).toBeUndefined();
-    });
-
-    it('should find all 14 prompts by name', () => {
-      const names = [
-        'galachain-launchpad:analyze-token',
-        'galachain-launchpad:buy-tokens',
-        'galachain-launchpad:sell-tokens',
-        'galachain-launchpad:graduate-token',
-        'galachain-launchpad:portfolio',
-        'galachain-launchpad:tokens-held',
-        'galachain-launchpad:tokens-created',
-        'galachain-launchpad:balance',
-        'galachain-launchpad:profile',
-        'galachain-launchpad:compare-tokens',
-        'galachain-launchpad:graduation-status',
-        'galachain-launchpad:spot-prices',
-        'galachain-launchpad:pool-details',
-        'galachain-launchpad:trade-history',
-      ];
-
-      names.forEach((name) => {
-        const prompt = getPrompt(name);
-        expect(prompt).toBeDefined();
-        expect(prompt?.name).toBe(name);
-      });
-    });
-
-    it('should use O(1) Map lookup (performance test)', () => {
-      const iterations = 10000;
-      const start = Date.now();
-
-      for (let i = 0; i < iterations; i++) {
-        getPrompt('galachain-launchpad:analyze-token');
-      }
-
-      const duration = Date.now() - start;
-      // Should complete 10k lookups in under 100ms (Map is O(1))
-      expect(duration).toBeLessThan(100);
-    });
-  });
-
-  describe('getPromptNames()', () => {
-    it('should return array of all prompt names', () => {
-      const names = getPromptNames();
-      expect(names).toHaveLength(14);
-      expect(names).toContain('galachain-launchpad:analyze-token');
-      expect(names).toContain('galachain-launchpad:buy-tokens');
-    });
-
-    it('should return names in consistent order', () => {
-      const names1 = getPromptNames();
-      const names2 = getPromptNames();
-      expect(names1).toEqual(names2);
-    });
-  });
-
-  describe('hasPrompt()', () => {
-    it('should return true for existing prompts', () => {
-      expect(hasPrompt('galachain-launchpad:analyze-token')).toBe(true);
-      expect(hasPrompt('galachain-launchpad:buy-tokens')).toBe(true);
-    });
-
-    it('should return false for non-existent prompts', () => {
-      expect(hasPrompt('invalid-prompt')).toBe(false);
-      expect(hasPrompt('')).toBe(false);
-    });
-  });
-
-  describe('getPromptsByCategory()', () => {
-    it('should return 4 trading prompts', () => {
-      const trading = getPromptsByCategory('trading');
-      expect(trading).toHaveLength(4);
-      expect(trading[0].name).toContain('analyze-token');
-      expect(trading[1].name).toContain('buy-tokens');
-    });
-
-    it('should return 5 portfolio prompts', () => {
-      const portfolio = getPromptsByCategory('portfolio');
-      expect(portfolio).toHaveLength(5);
-      expect(portfolio[0].name).toContain('portfolio');
-    });
-
-    it('should return 5 analysis prompts', () => {
-      const analysis = getPromptsByCategory('analysis');
-      expect(analysis).toHaveLength(5);
-    });
-
-    it('should return empty array for invalid category', () => {
-      const result = getPromptsByCategory('invalid' as any);
-      expect(result).toEqual([]);
-    });
-  });
-
-  describe('getPromptCount()', () => {
-    it('should return 14', () => {
-      expect(getPromptCount()).toBe(14);
-    });
-  });
-});

package/src/prompts/analysis.ts

@@ -1,429 +0,0 @@
-/**
- * Analysis Prompts
- *
- * Slash commands for token analysis and comparison on Gala Launchpad
- */
-
-import type { MCPPrompt } from '../types/mcp.js';
-import { MCP_TOOLS } from '../constants/mcpToolNames.js';
-import { validateTokenName, validateTokenList, validatePaginationLimit } from '../utils/validation.js';
-
-/**
- * Compare Tokens - Side-by-side comparison
- */
-export const compareTokensPrompt: MCPPrompt = {
-  name: 'galachain-launchpad:compare-tokens',
-  description: 'Compare two Launchpad tokens side-by-side with detailed metrics',
-  arguments: [
-    {
-      name: 'token1',
-      description: 'First token to compare (e.g., anime)',
-      required: true,
-    },
-    {
-      name: 'token2',
-      description: 'Second token to compare (e.g., test216253)',
-      required: true,
-    },
-  ],
-  handler: (args) => {
-    // Validate inputs
-    validateTokenName(args.token1, 'token1');
-    validateTokenName(args.token2, 'token2');
-
-    return [
-      {
-        role: 'user',
-        content: {
-          type: 'text',
-          text: `Compare two Launchpad tokens side-by-side:
-
-Token 1: ${args.token1}
-Token 2: ${args.token2}
-
-For EACH token, use the optimized pattern:
-
-1. Fetch pool details using ${MCP_TOOLS.FETCH_POOL_DETAILS_FOR_CALCULATION}
-
-2. Calculate metrics using LOCAL mode:
-   - Spot price: ${MCP_TOOLS.FETCH_LAUNCHPAD_TOKEN_SPOT_PRICE}
-   - Graduation cost: ${MCP_TOOLS.CALCULATE_BUY_AMOUNT_FOR_GRADUATION}
-   - Is graduated: ${MCP_TOOLS.IS_TOKEN_GRADUATED}
-
-3. Get additional data:
-   - Full pool details: ${MCP_TOOLS.FETCH_POOL_DETAILS}
-   - Token distribution: ${MCP_TOOLS.FETCH_TOKEN_DISTRIBUTION}
-   - Badges: ${MCP_TOOLS.FETCH_TOKEN_BADGES}
-
-Present a comparison table:
-
-| Metric | ${args.token1} | ${args.token2} |
-|--------|--------|--------|
-| Spot Price (USD) | ... | ... |
-| Market Cap Estimate | ... | ... |
-| Pool Status | ... | ... |
-| Progress to Graduation | ... | ... |
-| Remaining Tokens | ... | ... |
-| GALA to Graduate | ... | ... |
-| Holder Count | ... | ... |
-| Creator Status | ... | ... |
-
-Provide analysis:
-- Which token is closer to graduation?
-- Which has better liquidity?
-- Which might be a better investment and why?
-- Any notable badges or achievements?`,
-        },
-      },
-    ];
-  },
-};
-
-/**
- * Graduation Status - Check multiple tokens for graduation readiness
- */
-export const graduationStatusPrompt: MCPPrompt = {
-  name: 'galachain-launchpad:graduation-status',
-  description: 'Check graduation status and readiness for multiple tokens',
-  arguments: [
-    {
-      name: 'tokens',
-      description: 'Comma-separated token names (e.g., anime,test216253,dragnrkti)',
-      required: true,
-    },
-  ],
-  handler: (args) => {
-    // Validate inputs
-    const tokenArray = validateTokenList(args.tokens);
-
-    return [
-      {
-        role: 'user',
-        content: {
-          type: 'text',
-          text: `Check graduation status for multiple tokens:
-
-Tokens: ${args.tokens}
-
-For EACH token in the list:
-
-1. Check if graduated: ${MCP_TOOLS.IS_TOKEN_GRADUATED}
-
-2. If not graduated, use optimized pattern:
-   a. Fetch pool details: ${MCP_TOOLS.FETCH_POOL_DETAILS_FOR_CALCULATION}
-   b. Calculate graduation cost: ${MCP_TOOLS.CALCULATE_BUY_AMOUNT_FOR_GRADUATION} (LOCAL mode)
-   c. Calculate progress: (currentSupply / maxSupply * 100)
-
-3. Get full pool details: ${MCP_TOOLS.FETCH_POOL_DETAILS}
-
-Present a table:
-
-| Token | Status | Progress | Remaining Tokens | GALA to Graduate | Frontend URL |
-|-------|--------|----------|------------------|------------------|--------------|
-| ... | ... | ... | ... | ... | ... |
-
-Summary:
-- Total tokens analyzed: ${tokenArray.length}
-- Already graduated: [count]
-- Close to graduation (>90%): [count]
-- Mid-progress (50-90%): [count]
-- Early stage (<50%): [count]
-
-Provide recommendations:
-- Which tokens are good graduation opportunities?
-- Which tokens might be undervalued?`,
-        },
-      },
-    ];
-  },
-};
-
-/**
- * Spot Prices - Batch spot price lookup
- */
-export const spotPricesPrompt: MCPPrompt = {
-  name: 'galachain-launchpad:spot-prices',
-  description: 'Get spot prices for multiple Launchpad tokens efficiently',
-  arguments: [
-    {
-      name: 'tokens',
-      description: 'Comma-separated token names (e.g., anime,test216253,dragnrkti)',
-      required: true,
-    },
-  ],
-  handler: (args) => {
-    // Validate inputs
-    validateTokenList(args.tokens);
-
-    return [
-      {
-        role: 'user',
-        content: {
-          type: 'text',
-          text: `Get spot prices for multiple Launchpad tokens:
-
-Tokens: ${args.tokens}
-
-Use the optimized batch pattern for EACH token:
-
-1. Fetch pool details: ${MCP_TOOLS.FETCH_POOL_DETAILS_FOR_CALCULATION}
-2. Calculate spot price: ${MCP_TOOLS.FETCH_LAUNCHPAD_TOKEN_SPOT_PRICE} (LOCAL mode)
-
-Also get GALA spot price: ${MCP_TOOLS.FETCH_GALA_SPOT_PRICE}
-
-Present results:
-
-**GALA Spot Price:** $[price]
-
-**Launchpad Token Prices:**
-| Token | USD Price | GALA Price | Market Cap Est. |
-|-------|-----------|------------|-----------------|
-| ... | ... | ... | ... |
-
-Performance note: Using LOCAL calculations - instant results with <0.01% difference from external!
-
-Sort by USD price (highest to lowest).`,
-        },
-      },
-    ];
-  },
-};
-
-/**
- * Pool Details - Comprehensive pool information
- */
-export const poolDetailsPrompt: MCPPrompt = {
-  name: 'galachain-launchpad:pool-details',
-  description: 'Get comprehensive pool information including distribution and badges',
-  arguments: [
-    {
-      name: 'tokenName',
-      description: 'Token to analyze (e.g., anime)',
-      required: true,
-    },
-  ],
-  handler: (args) => {
-    // Validate inputs
-    validateTokenName(args.tokenName);
-
-    return [
-      {
-        role: 'user',
-        content: {
-          type: 'text',
-          text: `Get comprehensive pool information for "${args.tokenName}":
-
-1. Full pool details: ${MCP_TOOLS.FETCH_POOL_DETAILS}
-2. Token distribution: ${MCP_TOOLS.FETCH_TOKEN_DISTRIBUTION}
-3. Achievement badges: ${MCP_TOOLS.FETCH_TOKEN_BADGES}
-4. Recent volume data (last 24h): ${MCP_TOOLS.FETCH_VOLUME_DATA} with 1h resolution
-5. Check if graduated: ${MCP_TOOLS.IS_TOKEN_GRADUATED}
-6. Frontend URL: ${MCP_TOOLS.GET_URL_BY_TOKEN_NAME}
-
-Display organized sections:
-
-**Basic Info:**
-- Token name and symbol
-- Pool status
-- Created by
-- Frontend URL
-
-**Supply Metrics:**
-- Current supply
-- Maximum supply
-- Remaining tokens
-- Progress percentage
-
-**Distribution:**
-- Total holders
-- Top holders (if available)
-- Distribution metrics
-
-**Achievements:**
-- Volume badges
-- Engagement badges
-- Other achievements
-
-**Recent Activity (24h):**
-- Trading volume
-- Price movement
-- Number of trades
-
-**Reverse Bonding Curve:**
-- Max fee factor
-- Min fee factor
-- Current fee structure`,
-        },
-      },
-    ];
-  },
-};
-
-/**
- * Trade History - Recent trades with filters
- */
-export const tradeHistoryPrompt: MCPPrompt = {
-  name: 'galachain-launchpad:trade-history',
-  description: 'View recent trades for a token or user with filtering options',
-  arguments: [
-    {
-      name: 'tokenName',
-      description: 'Token to view trades for (optional)',
-      required: false,
-    },
-    {
-      name: 'userAddress',
-      description: 'User address to filter by (optional)',
-      required: false,
-    },
-    {
-      name: 'tradeType',
-      description: 'Trade type filter: BUY or SELL (optional)',
-      required: false,
-    },
-    {
-      name: 'limit',
-      description: 'Number of trades to show (default: 20)',
-      required: false,
-    },
-  ],
-  handler: (args) => {
-    // Validate inputs
-    if (args.tokenName) {
-      validateTokenName(args.tokenName);
-    }
-    if (args.limit) {
-      validatePaginationLimit(args.limit, 20);
-    }
-    if (args.tradeType && args.tradeType !== 'BUY' && args.tradeType !== 'SELL') {
-      throw new Error('tradeType must be either BUY or SELL');
-    }
-
-    const limit = args.limit || '20';
-
-    return [
-      {
-        role: 'user',
-        content: {
-          type: 'text',
-          text: `Show recent trade history:
-
-${args.tokenName ? `Token: ${args.tokenName}` : 'All tokens'}
-${args.userAddress ? `User: ${args.userAddress}` : 'All users'}
-${args.tradeType ? `Type: ${args.tradeType}` : 'All trade types'}
-Limit: ${limit}
-
-Use ${MCP_TOOLS.FETCH_TRADES} with:
-${args.tokenName ? `- tokenName: "${args.tokenName}"` : ''}
-${args.userAddress ? `- userAddress: "${args.userAddress}"` : ''}
-${args.tradeType ? `- tradeType: "${args.tradeType}"` : ''}
-- limit: ${limit}
-- sortOrder: "DESC" (newest first)
-
-For each trade, display:
-- Timestamp (formatted)
-- Token name
-- Trade type (BUY/SELL)
-- Amount (tokens)
-- Price (GALA)
-- User address (truncated)
-- Transaction ID
-
-Calculate summary:
-- Total trades shown
-- Total volume (GALA)
-- Average trade size
-- Buy vs Sell ratio (if not filtered)`,
-        },
-      },
-    ];
-  },
-};
-
-/**
- * Fetch All Pools - Get all available pools with automatic pagination
- */
-export const fetchAllPoolsPrompt: MCPPrompt = {
-  name: 'galachain-launchpad:fetch-all-pools',
-  description: 'Fetch all available Launchpad pools with automatic pagination (no limit needed)',
-  arguments: [
-    {
-      name: 'search',
-      description: 'Optional search filter for token names (fuzzy match)',
-      required: false,
-    },
-    {
-      name: 'type',
-      description: 'Pool type filter: recent or popular (optional, default: recent)',
-      required: false,
-    },
-  ],
-  handler: (args) => {
-    // Validate type if provided
-    if (args.type && args.type !== 'recent' && args.type !== 'popular') {
-      throw new Error('type must be either "recent" or "popular"');
-    }
-
-    const searchFilter = args.search
-      ? `- search: "${args.search}" (fuzzy match filter)`
-      : '- No search filter';
-    const typeFilter = args.type ? args.type : 'recent';
-
-    return [
-      {
-        role: 'user',
-        content: {
-          type: 'text',
-          text: `Fetch ALL available Launchpad pools with automatic pagination:
-
-Use ${MCP_TOOLS.FETCH_ALL_POOLS} with:
-${searchFilter}
-- type: "${typeFilter}"
-
-This tool automatically:
-- Fetches the first page to determine total available pools
-- Concurrently fetches remaining pages (up to 5 at a time)
-- Returns ALL matching pools in a single result
-
-For each pool, display:
-- Token name and symbol
-- Pool status (Ongoing/Completed)
-- Current price (if available)
-- Progress percentage
-- Creator address (truncated)
-- Frontend URL (use ${MCP_TOOLS.GET_URL_BY_TOKEN_NAME})
-
-Provide summary:
-- Total pools found
-- How many are graduated (Completed)
-- How many are active (Ongoing)
-- Distribution by progress stage:
-  * Early (<25%)
-  * Growing (25-75%)
-  * Near graduation (75-99%)
-  * Graduated (100%)
-
-Performance note:
-- Uses concurrent fetching with ${MCP_TOOLS.FETCH_ALL_POOLS}
-- Max 5 concurrent requests to avoid rate limiting
-- Automatic cache warming for token metadata
-- Much faster than manual pagination!
-
-Sort pools by creation date (newest first) or progress (closest to graduation first).`,
-        },
-      },
-    ];
-  },
-};
-
-/**
- * Export all analysis prompts
- */
-export const analysisPrompts: MCPPrompt[] = [
-  compareTokensPrompt,
-  graduationStatusPrompt,
-  spotPricesPrompt,
-  poolDetailsPrompt,
-  tradeHistoryPrompt,
-  fetchAllPoolsPrompt,
-];