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

package/src/prompts/trading-calculations.ts

@@ -1,499 +0,0 @@
-/**
- * Trading Calculations Prompts
- *
- * Slash commands for trading calculations, amounts, and related operations
- */
-
-import type { MCPPrompt } from '../types/mcp.js';
-import { MCP_TOOLS } from '../constants/mcpToolNames.js';
-import { validateTokenName, validateNumericAmount } from '../utils/validation.js';
-
-/**
- * Calculate Buy Amount - Buy cost calculation
- */
-export const calculateBuyAmountPrompt: MCPPrompt = {
-  name: 'galachain-launchpad:calculate-buy-amount',
-  description: 'Calculate token amounts and fees for buying',
-  arguments: [
-    {
-      name: 'tokenName',
-      description: 'Token name (e.g., anime, test216253)',
-      required: true,
-    },
-    {
-      name: 'amount',
-      description: 'Amount in GALA to spend or exact token quantity',
-      required: true,
-    },
-    {
-      name: 'type',
-      description: 'Type: native (spend GALA) or exact (buy exact tokens)',
-      required: true,
-    },
-  ],
-  handler: (args) => {
-    validateTokenName(args.tokenName, 'tokenName');
-    validateNumericAmount(args.amount, 'amount');
-
-    return [
-      {
-        role: 'user',
-        content: {
-          type: 'text',
-          text: `Calculate buy amount and fee breakdown.
-
-Token: ${args.tokenName}
-Amount: ${args.amount}
-Type: ${args.type}
-
-Use ${MCP_TOOLS.CALCULATE_BUY_AMOUNT} to get:
-- Exact token amount you'll receive
-- Transaction fee
-- Gas fee
-- Reverse bonding curve fee
-
-Display the complete cost breakdown.`,
-        },
-      },
-    ];
-  },
-};
-
-/**
- * Calculate Sell Amount - Sell proceeds calculation
- */
-export const calculateSellAmountPrompt: MCPPrompt = {
-  name: 'galachain-launchpad:calculate-sell-amount',
-  description: 'Calculate GALA amounts and fees for selling',
-  arguments: [
-    {
-      name: 'tokenName',
-      description: 'Token name (e.g., anime, test216253)',
-      required: true,
-    },
-    {
-      name: 'amount',
-      description: 'Amount of GALA to receive or exact token quantity to sell',
-      required: true,
-    },
-    {
-      name: 'type',
-      description: 'Type: native (receive GALA) or exact (sell exact tokens)',
-      required: true,
-    },
-  ],
-  handler: (args) => {
-    validateTokenName(args.tokenName, 'tokenName');
-    validateNumericAmount(args.amount, 'amount');
-
-    return [
-      {
-        role: 'user',
-        content: {
-          type: 'text',
-          text: `Calculate sell amount and fee breakdown.
-
-Token: ${args.tokenName}
-Amount: ${args.amount}
-Type: ${args.type}
-
-Use ${MCP_TOOLS.CALCULATE_SELL_AMOUNT} to get:
-- GALA amount you'll receive
-- Transaction fee
-- Gas fee
-- Reverse bonding curve fee
-
-Display the complete proceeds breakdown.`,
-        },
-      },
-    ];
-  },
-};
-
-/**
- * Fetch Trades - Trade history query
- */
-export const fetchTradesPrompt: MCPPrompt = {
-  name: 'galachain-launchpad:fetch-trades',
-  description: 'Query your trading history with optional filters',
-  arguments: [
-    {
-      name: 'tokenName',
-      description: 'Token name (e.g., anime)',
-      required: false,
-    },
-    {
-      name: 'tradeType',
-      description: 'Filter: BUY or SELL',
-      required: false,
-    },
-    {
-      name: 'page',
-      description: 'Page number (default: 1)',
-      required: false,
-    },
-    {
-      name: 'limit',
-      description: 'Results per page (default: 20)',
-      required: false,
-    },
-  ],
-  handler: (args) => {
-    if (args.tokenName) {
-      validateTokenName(args.tokenName, 'tokenName');
-    }
-
-    return [
-      {
-        role: 'user',
-        content: {
-          type: 'text',
-          text: `Fetch trading history.
-
-${args.tokenName ? `Token: ${args.tokenName}` : ''}
-${args.tradeType ? `Trade Type: ${args.tradeType}` : ''}
-Page: ${args.page || 1}
-Limit: ${args.limit || 20}
-
-Use ${MCP_TOOLS.FETCH_TRADES} to retrieve your trades.
-
-Display trade details including amounts, prices, and timestamps.`,
-        },
-      },
-    ];
-  },
-};
-
-/**
- * Calculate Initial Buy - Pre-buy calculation
- */
-export const calculateInitialBuyPrompt: MCPPrompt = {
-  name: 'galachain-launchpad:calculate-initial-buy',
-  description: 'Calculate pre-buy amounts during token creation',
-  arguments: [
-    {
-      name: 'amount',
-      description: 'GALA amount to spend for initial buy',
-      required: true,
-    },
-  ],
-  handler: (args) => {
-    validateNumericAmount(args.amount, 'amount');
-
-    return [
-      {
-        role: 'user',
-        content: {
-          type: 'text',
-          text: `Calculate pre-buy amounts for token creation.
-
-GALA Amount: ${args.amount}
-
-Use ${MCP_TOOLS.CALCULATE_INITIAL_BUY} to calculate:
-- Token quantity from initial buy
-- Applied fees and costs
-
-Display the calculated results.`,
-        },
-      },
-    ];
-  },
-};
-
-/**
- * Get Bundler Transaction Result - Transaction status lookup
- */
-export const getBundlerTransactionResultPrompt: MCPPrompt = {
-  name: 'galachain-launchpad:get-bundler-transaction-result',
-  description: 'Check bundler transaction status by ID',
-  arguments: [
-    {
-      name: 'transactionId',
-      description: 'Transaction ID (UUID format)',
-      required: true,
-    },
-  ],
-  handler: (args) => {
-    return [
-      {
-        role: 'user',
-        content: {
-          type: 'text',
-          text: `Get bundler transaction result.
-
-Transaction ID: ${args.transactionId}
-
-Use ${MCP_TOOLS.GET_BUNDLER_TRANSACTION_RESULT} to check:
-- Current transaction status (PENDING, PROCESSING, COMPLETED, FAILED)
-- Transaction method
-- Metadata
-
-Display the transaction status clearly.`,
-        },
-      },
-    ];
-  },
-};
-
-/**
- * Calculate Buy Amount for Graduation - Graduation cost
- */
-export const calculateBuyAmountForGraduationPrompt: MCPPrompt = {
-  name: 'galachain-launchpad:calculate-graduation-cost',
-  description: 'Calculate cost to graduate a token pool to DEX',
-  arguments: [
-    {
-      name: 'tokenName',
-      description: 'Token name (e.g., anime, test216253)',
-      required: true,
-    },
-  ],
-  handler: (args) => {
-    validateTokenName(args.tokenName, 'tokenName');
-
-    return [
-      {
-        role: 'user',
-        content: {
-          type: 'text',
-          text: `Calculate graduation cost for token pool.
-
-Token: ${args.tokenName}
-
-Use ${MCP_TOOLS.CALCULATE_BUY_AMOUNT_FOR_GRADUATION} to determine:
-- GALA cost to buy all remaining tokens
-- Transaction and gas fees
-- Complete cost breakdown
-
-Display how much GALA is needed to graduate this token.`,
-        },
-      },
-    ];
-  },
-};
-
-/**
- * Calculate Buy Amount (Local) - LOCAL bonding curve calc
- */
-export const calculateBuyAmountLocalPrompt: MCPPrompt = {
-  name: 'galachain-launchpad:calculate-buy-amount-local',
-  description: 'Calculate buy amount using LOCAL bonding curve (instant, no network)',
-  arguments: [
-    {
-      name: 'tokenName',
-      description: 'Token name (e.g., anime, test216253)',
-      required: true,
-    },
-    {
-      name: 'amount',
-      description: 'Amount in GALA to spend',
-      required: true,
-    },
-  ],
-  handler: (args) => {
-    validateTokenName(args.tokenName, 'tokenName');
-    validateNumericAmount(args.amount, 'amount');
-
-    return [
-      {
-        role: 'user',
-        content: {
-          type: 'text',
-          text: `Calculate buy amount using LOCAL bonding curve formula.
-
-Token: ${args.tokenName}
-Amount: ${args.amount} GALA
-
-Use ${MCP_TOOLS.CALCULATE_BUY_AMOUNT_LOCAL} for instant calculation:
-- Uses client-side exponential bonding curve formula
-- No network call required
-- Results within <0.01% of external calculation
-
-Perfect for price discovery and UI updates.`,
-        },
-      },
-    ];
-  },
-};
-
-/**
- * Calculate Buy Amount (External) - EXTERNAL bonding curve calc
- */
-export const calculateBuyAmountExternalPrompt: MCPPrompt = {
-  name: 'galachain-launchpad:calculate-buy-amount-external',
-  description: 'Calculate buy amount using EXTERNAL GalaChain call (real-time)',
-  arguments: [
-    {
-      name: 'tokenName',
-      description: 'Token name (e.g., anime, test216253)',
-      required: true,
-    },
-    {
-      name: 'amount',
-      description: 'Amount in GALA to spend',
-      required: true,
-    },
-  ],
-  handler: (args) => {
-    validateTokenName(args.tokenName, 'tokenName');
-    validateNumericAmount(args.amount, 'amount');
-
-    return [
-      {
-        role: 'user',
-        content: {
-          type: 'text',
-          text: `Calculate buy amount using EXTERNAL GalaChain network call.
-
-Token: ${args.tokenName}
-Amount: ${args.amount} GALA
-
-Use ${MCP_TOOLS.CALCULATE_BUY_AMOUNT_EXTERNAL} for real-time calculation:
-- Queries GalaChain network for current pricing
-- Most accurate pricing available
-- Includes reverse bonding curve fees
-
-Use this for precise trading decisions.`,
-        },
-      },
-    ];
-  },
-};
-
-/**
- * Calculate Sell Amount (Local) - LOCAL sell calc
- */
-export const calculateSellAmountLocalPrompt: MCPPrompt = {
-  name: 'galachain-launchpad:calculate-sell-amount-local',
-  description: 'Calculate sell amount using LOCAL bonding curve (instant)',
-  arguments: [
-    {
-      name: 'tokenName',
-      description: 'Token name (e.g., anime, test216253)',
-      required: true,
-    },
-    {
-      name: 'amount',
-      description: 'Exact token amount to sell',
-      required: true,
-    },
-  ],
-  handler: (args) => {
-    validateTokenName(args.tokenName, 'tokenName');
-    validateNumericAmount(args.amount, 'amount');
-
-    return [
-      {
-        role: 'user',
-        content: {
-          type: 'text',
-          text: `Calculate sell proceeds using LOCAL bonding curve formula.
-
-Token: ${args.tokenName}
-Sell Amount: ${args.amount} tokens
-
-Use ${MCP_TOOLS.CALCULATE_SELL_AMOUNT_LOCAL} for instant calculation:
-- Uses client-side bonding curve formula
-- Requires pool details (fetch separately)
-- No network call required
-
-Display the expected GALA proceeds.`,
-        },
-      },
-    ];
-  },
-};
-
-/**
- * Calculate Sell Amount (External) - EXTERNAL sell calc
- */
-export const calculateSellAmountExternalPrompt: MCPPrompt = {
-  name: 'galachain-launchpad:calculate-sell-amount-external',
-  description: 'Calculate sell amount using EXTERNAL GalaChain call (real-time)',
-  arguments: [
-    {
-      name: 'tokenName',
-      description: 'Token name (e.g., anime, test216253)',
-      required: true,
-    },
-    {
-      name: 'amount',
-      description: 'Exact token amount to sell',
-      required: true,
-    },
-  ],
-  handler: (args) => {
-    validateTokenName(args.tokenName, 'tokenName');
-    validateNumericAmount(args.amount, 'amount');
-
-    return [
-      {
-        role: 'user',
-        content: {
-          type: 'text',
-          text: `Calculate sell proceeds using EXTERNAL GalaChain network call.
-
-Token: ${args.tokenName}
-Sell Amount: ${args.amount} tokens
-
-Use ${MCP_TOOLS.CALCULATE_SELL_AMOUNT_EXTERNAL} for real-time calculation:
-- Queries GalaChain network for current pricing
-- Most accurate pricing available
-- Includes reverse bonding curve fees
-
-Use this for precise selling decisions.`,
-        },
-      },
-    ];
-  },
-};
-
-/**
- * Is Token Graduated - Graduation status check
- */
-export const isTokenGraduatedPrompt: MCPPrompt = {
-  name: 'galachain-launchpad:is-token-graduated',
-  description: 'Check if a token has completed bonding curve and graduated to DEX',
-  arguments: [
-    {
-      name: 'tokenName',
-      description: 'Token name (e.g., anime, test216253)',
-      required: true,
-    },
-  ],
-  handler: (args) => {
-    validateTokenName(args.tokenName, 'tokenName');
-
-    return [
-      {
-        role: 'user',
-        content: {
-          type: 'text',
-          text: `Check token graduation status.
-
-Token: ${args.tokenName}
-
-Use ${MCP_TOOLS.IS_TOKEN_GRADUATED} to determine:
-- Whether token has completed bonding curve
-- Whether token is now trading on full DEX
-
-Display the graduation status clearly.`,
-        },
-      },
-    ];
-  },
-};
-
-export const tradingCalculationPrompts: MCPPrompt[] = [
-  calculateBuyAmountPrompt,
-  calculateSellAmountPrompt,
-  fetchTradesPrompt,
-  calculateInitialBuyPrompt,
-  getBundlerTransactionResultPrompt,
-  calculateBuyAmountForGraduationPrompt,
-  calculateBuyAmountLocalPrompt,
-  calculateBuyAmountExternalPrompt,
-  calculateSellAmountLocalPrompt,
-  calculateSellAmountExternalPrompt,
-  isTokenGraduatedPrompt,
-];

package/src/prompts/trading.ts

@@ -1,191 +0,0 @@
-/**
- * Trading Prompts
- *
- * Slash commands for trading operations on Gala Launchpad
- */
-
-import type { MCPPrompt } from '../types/mcp.js';
-import {
-  createTradingWorkflow,
-  createAnalysisWorkflow,
-} from './utils/workflowTemplates.js';
-import { validateTokenName, validateNumericAmount, validateSlippage } from '../utils/validation.js';
-
-/**
- * Analyze Token - Complete token analysis workflow
- */
-export const analyzeTokenPrompt: MCPPrompt = {
-  name: 'galachain-launchpad:analyze-token',
-  description:
-    'Perform comprehensive analysis of a Launchpad token including pool details, spot price, and graduation cost',
-  arguments: [
-    {
-      name: 'tokenName',
-      description: 'Token name to analyze (e.g., anime, test216253)',
-      required: true,
-    },
-  ],
-  handler: (args) => {
-    // Validate inputs
-    validateTokenName(args.tokenName);
-
-    return [
-      {
-        role: 'user',
-        content: {
-          type: 'text',
-          text: createAnalysisWorkflow(args.tokenName),
-        },
-      },
-    ];
-  },
-};
-
-/**
- * Buy Tokens - Guided token purchase workflow
- */
-export const buyTokensPrompt: MCPPrompt = {
-  name: 'galachain-launchpad:buy-tokens',
-  description: 'Guide user through buying tokens with slippage protection and cost breakdown',
-  arguments: [
-    {
-      name: 'tokenName',
-      description: 'Token to buy (e.g., anime)',
-      required: true,
-    },
-    {
-      name: 'galaAmount',
-      description: 'GALA amount to spend (e.g., 100)',
-      required: true,
-    },
-    {
-      name: 'slippage',
-      description: 'Slippage tolerance percentage (default: 1)',
-      required: false,
-    },
-  ],
-  handler: (args) => {
-    // Validate inputs
-    validateTokenName(args.tokenName);
-    validateNumericAmount(args.galaAmount, 'galaAmount');
-    if (args.slippage) {
-      validateSlippage(args.slippage);
-    }
-
-    return [
-      {
-        role: 'user',
-        content: {
-          type: 'text',
-          text: createTradingWorkflow({
-            operation: 'buy',
-            tokenName: args.tokenName,
-            amount: args.galaAmount,
-            amountType: 'gala',
-            slippage: args.slippage || '1',
-          }),
-        },
-      },
-    ];
-  },
-};
-
-/**
- * Sell Tokens - Guided token sale workflow
- */
-export const sellTokensPrompt: MCPPrompt = {
-  name: 'galachain-launchpad:sell-tokens',
-  description: 'Guide user through selling tokens with slippage protection',
-  arguments: [
-    {
-      name: 'tokenName',
-      description: 'Token to sell (e.g., anime)',
-      required: true,
-    },
-    {
-      name: 'tokenAmount',
-      description: 'Token amount to sell (e.g., 1000)',
-      required: true,
-    },
-    {
-      name: 'slippage',
-      description: 'Slippage tolerance percentage (default: 1)',
-      required: false,
-    },
-  ],
-  handler: (args) => {
-    // Validate inputs
-    validateTokenName(args.tokenName);
-    validateNumericAmount(args.tokenAmount, 'tokenAmount');
-    if (args.slippage) {
-      validateSlippage(args.slippage);
-    }
-
-    return [
-      {
-        role: 'user',
-        content: {
-          type: 'text',
-          text: createTradingWorkflow({
-            operation: 'sell',
-            tokenName: args.tokenName,
-            amount: args.tokenAmount,
-            slippage: args.slippage || '1',
-          }),
-        },
-      },
-    ];
-  },
-};
-
-/**
- * Graduate Token - One-step graduation workflow
- */
-export const graduateTokenPrompt: MCPPrompt = {
-  name: 'galachain-launchpad:graduate-token',
-  description:
-    'Graduate a bonding curve pool by buying all remaining tokens in one transaction',
-  arguments: [
-    {
-      name: 'tokenName',
-      description: 'Token to graduate (e.g., anime)',
-      required: true,
-    },
-    {
-      name: 'slippage',
-      description: 'Slippage tolerance percentage (default: 1)',
-      required: false,
-    },
-  ],
-  handler: (args) => {
-    // Validate inputs
-    validateTokenName(args.tokenName);
-    if (args.slippage) {
-      validateSlippage(args.slippage);
-    }
-
-    return [
-      {
-        role: 'user',
-        content: {
-          type: 'text',
-          text: createTradingWorkflow({
-            operation: 'graduate',
-            tokenName: args.tokenName,
-            slippage: args.slippage || '1',
-          }),
-        },
-      },
-    ];
-  },
-};
-
-/**
- * Export all trading prompts
- */
-export const tradingPrompts: MCPPrompt[] = [
-  analyzeTokenPrompt,
-  buyTokensPrompt,
-  sellTokensPrompt,
-  graduateTokenPrompt,
-];