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

package/src/prompts/social.ts

@@ -1,94 +0,0 @@
-/**
- * Social Interaction Prompts
- *
- * Slash commands for comments and social interactions
- */
-
-import type { MCPPrompt } from '../types/mcp.js';
-import { MCP_TOOLS } from '../constants/mcpToolNames.js';
-import { validateTokenName } from '../utils/validation.js';
-import { createPromptResponse } from './utils/handlerHelpers.js';
-import { createSimpleOperationText } from './utils/textTemplates.js';
-
-/**
- * Post Comment - Post comment on token
- */
-export const postCommentPrompt: MCPPrompt = {
-  name: 'galachain-launchpad:post-comment',
-  description: 'Post a comment on a token pool',
-  arguments: [
-    {
-      name: 'tokenName',
-      description: 'Token name (e.g., anime)',
-      required: true,
-    },
-    {
-      name: 'message',
-      description: 'Comment message (max 500 characters)',
-      required: true,
-    },
-  ],
-  handler: (args) => {
-    validateTokenName(args.tokenName);
-
-    return createPromptResponse(
-      createSimpleOperationText({
-        operation: 'Post comment on token pool.',
-        parameters: {
-          token: `Token: ${args.tokenName}`,
-          message: `Message: ${args.message}`,
-        },
-        toolName: MCP_TOOLS.POST_COMMENT,
-        actionDescription: 'post the comment',
-        displayFormat: 'Display confirmation of successful comment posting.',
-      })
-    );
-  },
-};
-
-/**
- * Fetch Comments - Get token comments
- */
-export const fetchCommentsPrompt: MCPPrompt = {
-  name: 'galachain-launchpad:fetch-comments',
-  description: 'Get comments for a token pool',
-  arguments: [
-    {
-      name: 'tokenName',
-      description: 'Token name (e.g., anime)',
-      required: true,
-    },
-    {
-      name: 'page',
-      description: 'Page number (default: 1)',
-      required: false,
-    },
-    {
-      name: 'limit',
-      description: 'Results per page (default: 20)',
-      required: false,
-    },
-  ],
-  handler: (args) => {
-    validateTokenName(args.tokenName);
-
-    return createPromptResponse(
-      createSimpleOperationText({
-        operation: 'Fetch comments for token pool.',
-        parameters: {
-          token: `Token: ${args.tokenName}`,
-          page: `Page: ${args.page || 1}`,
-          limit: `Limit: ${args.limit || 20}`,
-        },
-        toolName: MCP_TOOLS.FETCH_COMMENTS,
-        actionDescription: 'retrieve comments',
-        displayFormat: 'Display the comments with author information and timestamps.',
-      })
-    );
-  },
-};
-
-export const socialPrompts: MCPPrompt[] = [
-  postCommentPrompt,
-  fetchCommentsPrompt,
-];

package/src/prompts/trading-calculations.ts

@@ -1,414 +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, validateOptional } from '../utils/validation.js';
-import { createPromptResponse } from './utils/handlerHelpers.js';
-import { createSimpleOperationText } from './utils/textTemplates.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 createPromptResponse(`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 createPromptResponse(`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) => {
-    validateOptional(args.tokenName, (val) => validateTokenName(val, 'tokenName'));
-
-    return createPromptResponse(`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 createPromptResponse(`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 createPromptResponse(`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 createPromptResponse(
-      createSimpleOperationText({
-        operation: 'Calculate graduation cost for token pool.',
-        parameters: {
-          token_name: `Token: ${args.tokenName}`,
-        },
-        toolName: MCP_TOOLS.CALCULATE_BUY_AMOUNT_FOR_GRADUATION,
-        actionDescription: 'determine GALA cost to buy all remaining tokens, transaction fees, and complete cost breakdown',
-        displayFormat: '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 createPromptResponse(`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 createPromptResponse(`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 createPromptResponse(`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 createPromptResponse(`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 createPromptResponse(
-      createSimpleOperationText({
-        operation: 'Check token graduation status.',
-        parameters: {
-          token_name: `Token: ${args.tokenName}`,
-        },
-        toolName: MCP_TOOLS.IS_TOKEN_GRADUATED,
-        actionDescription: 'determine whether token has completed bonding curve and is trading on full DEX',
-        displayFormat: '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,160 +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, validateOptionalSlippage } from '../utils/validation.js';
-import { createPromptResponse } from './utils/handlerHelpers.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 createPromptResponse(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');
-    validateOptionalSlippage(args.slippage);
-
-    return createPromptResponse(
-      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');
-    validateOptionalSlippage(args.slippage);
-
-    return createPromptResponse(
-      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);
-    validateOptionalSlippage(args.slippage);
-
-    return createPromptResponse(
-      createTradingWorkflow({
-        operation: 'graduate',
-        tokenName: args.tokenName,
-        slippage: args.slippage || '1',
-      })
-    );
-  },
-};
-
-/**
- * Export all trading prompts
- */
-export const tradingPrompts: MCPPrompt[] = [
-  analyzeTokenPrompt,
-  buyTokensPrompt,
-  sellTokensPrompt,
-  graduateTokenPrompt,
-];