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

package/src/prompts/liquidity-positions.ts

@@ -0,0 +1,237 @@
+/**
+ * DEX Liquidity Position Prompts
+ *
+ * Slash commands for managing liquidity positions on GalaSwap DEX
+ */
+
+import type { MCPPrompt } from '../types/mcp.js';
+import { validateNumericAmount } from '../utils/validation.js';
+import { createPromptResponse } from './utils/handlerHelpers.js';
+
+/**
+ * View My Liquidity Positions - List all open LP positions
+ *
+ * This prompt shows all open liquidity positions for the authenticated wallet.
+ */
+export const myPositionsPrompt: MCPPrompt = {
+  name: 'galachain-launchpad:my-positions',
+  description:
+    'View all your open liquidity positions on GalaSwap DEX with details about each position',
+  arguments: [],
+  handler: () =>
+    createPromptResponse(`I want to view all my open liquidity positions on GalaSwap DEX.
+
+**Action:**
+Show me all my liquidity positions with the following information for each:
+- Position ID
+- Token pair (token0/token1)
+- Fee tier
+- Current liquidity amount
+- Token amounts locked
+- Accumulated trading fees
+
+**Workflow:**
+1. Fetch all my open positions using gala_launchpad_get_user_liquidity_positions
+2. Display each position with key details
+3. Show total summary (number of positions, total accumulated fees)
+
+Please use the following MCP tools:
+- gala_launchpad_get_user_liquidity_positions: Retrieve all open positions for my wallet
+
+Proceed with fetching my positions.`),
+};
+
+/**
+ * Add Liquidity - Create new LP position with guided workflow
+ *
+ * Guides through adding liquidity to a pool with price range selection
+ */
+export const addLiquidityPrompt: MCPPrompt = {
+  name: 'galachain-launchpad:add-liquidity',
+  description:
+    'Add liquidity to a GalaSwap DEX pool. Guides through selecting token pair, price range, and amounts.',
+  arguments: [
+    {
+      name: 'token0',
+      description: 'First token symbol (e.g., GALA)',
+      required: true,
+    },
+    {
+      name: 'token1',
+      description: 'Second token symbol (e.g., GUSDC)',
+      required: true,
+    },
+    {
+      name: 'amount0',
+      description: 'Amount of token0 to provide (e.g., 1000)',
+      required: true,
+    },
+    {
+      name: 'amount1',
+      description: 'Amount of token1 to provide (e.g., 1000)',
+      required: true,
+    },
+    {
+      name: 'minPrice',
+      description: 'Minimum price boundary for LP range (e.g., 0.90)',
+      required: false,
+    },
+    {
+      name: 'maxPrice',
+      description: 'Maximum price boundary for LP range (e.g., 1.10)',
+      required: false,
+    },
+    {
+      name: 'feeTier',
+      description: 'Fee tier in basis points: 500, 3000, or 10000 (default: 3000)',
+      required: false,
+    },
+  ],
+  handler: (args) => {
+    // Validate amounts
+    validateNumericAmount(args.amount0, 'amount0');
+    validateNumericAmount(args.amount1, 'amount1');
+
+    const minPrice = args.minPrice || '0.95';
+    const maxPrice = args.maxPrice || '1.05';
+    const feeTier = args.feeTier || '3000';
+
+    return createPromptResponse(`I want to add liquidity to the ${args.token0}/${args.token1} pool on GalaSwap DEX.
+
+**Liquidity Details:**
+- Token Pair: ${args.token0} / ${args.token1}
+- Amount of ${args.token0}: ${args.amount0}
+- Amount of ${args.token1}: ${args.amount1}
+- Price Range: ${minPrice} - ${maxPrice}
+- Fee Tier: ${feeTier} basis points (${parseInt(feeTier) / 100}%)
+
+**Workflow:**
+1. Check my wallet balances to ensure I have sufficient tokens
+2. Get pool information for the ${args.token0}/${args.token1} pair
+3. Add liquidity by price range with the specified amounts and price boundaries
+4. Confirm the position was created successfully
+
+**Important:**
+- Price range ${minPrice}-${maxPrice} means liquidity is only provided when the price is in this range
+- Lower fee tiers (500 bps) for stablecoins, higher fees (3000-10000 bps) for volatile pairs
+- I accept the estimated slippage shown in the quote
+
+Please use the following MCP tools:
+- gala_launchpad_get_swap_user_assets: Check my token balances
+- gala_launchpad_get_swap_pool_info: Get ${args.token0}/${args.token1} pool details
+- gala_launchpad_add_liquidity_by_price: Add liquidity with price range
+
+Proceed with adding liquidity.`);
+  },
+};
+
+/**
+ * Remove Liquidity - Close or reduce LP position
+ *
+ * Guides through removing liquidity from an existing position
+ */
+export const removeLiquidityPrompt: MCPPrompt = {
+  name: 'galachain-launchpad:remove-liquidity',
+  description:
+    'Remove liquidity from an existing position. Shows estimated tokens and fees to receive.',
+  arguments: [
+    {
+      name: 'positionId',
+      description: 'Position ID to remove liquidity from',
+      required: true,
+    },
+    {
+      name: 'percentage',
+      description: 'Percentage of liquidity to remove (0-100, default: 100 to close position)',
+      required: false,
+    },
+  ],
+  handler: (args) => {
+    const percentage = args.percentage || '100';
+
+    return createPromptResponse(`I want to remove ${percentage}% of liquidity from position ${args.positionId}.
+
+**Removal Details:**
+- Position ID: ${args.positionId}
+- Removal Amount: ${percentage}% of liquidity
+${percentage === '100' ? '- Action: Close position completely' : '- Action: Reduce position by ' + percentage + '%'}
+
+**Workflow:**
+1. Get position details (token pair, current liquidity, accumulated fees)
+2. Estimate tokens and fees that will be received when removing
+3. Show the breakdown of what I'll receive
+4. Execute the removal with slippage protection
+5. Verify the position was updated/closed
+
+**Important:**
+- Removing 100% closes the position
+- Removing less keeps the position open with reduced liquidity
+- Accumulated fees can be collected separately if desired
+- Slippage protection ensures I receive acceptable amounts
+
+Please use the following MCP tools:
+- gala_launchpad_get_liquidity_position_by_id: Get position details
+- gala_launchpad_estimate_remove_liquidity: Preview what I'll receive
+- gala_launchpad_remove_liquidity: Execute the removal
+
+Proceed with removing liquidity.`);
+  },
+};
+
+/**
+ * Collect Fees - Harvest accumulated trading fees
+ *
+ * Guides through collecting accumulated fees from a position
+ */
+export const collectFeesPrompt: MCPPrompt = {
+  name: 'galachain-launchpad:collect-fees',
+  description:
+    'Collect accumulated trading fees from a liquidity position without modifying the position.',
+  arguments: [
+    {
+      name: 'positionId',
+      description: 'Position ID to collect fees from',
+      required: true,
+    },
+  ],
+  handler: (args) =>
+    createPromptResponse(`I want to collect accumulated trading fees from position ${args.positionId}.
+
+**Fee Collection Details:**
+- Position ID: ${args.positionId}
+- Action: Harvest accumulated trading fees
+- Position Impact: Liquidity remains unchanged, only fees collected
+
+**Workflow:**
+1. Get position details to show accumulated fees
+2. Show how much in fees is available to collect (in both tokens)
+3. Execute fee collection transaction
+4. Confirm fees were successfully collected
+
+**Benefits:**
+- Passive income from liquidity provision
+- Fees accumulate continuously as trades happen
+- Can be collected without closing the position
+- Frees up rewards to reinvest or use elsewhere
+
+**Important:**
+- Fee collection doesn't affect your liquidity position
+- Fees are only earned on trades within your price range
+- Fee amounts depend on trading volume and your fee tier
+
+Please use the following MCP tools:
+- gala_launchpad_get_liquidity_position_by_id: Get position details and fee amounts
+- gala_launchpad_collect_position_fees: Collect the accumulated fees
+
+Proceed with collecting fees.`),
+};
+
+/**
+ * Export all liquidity position prompts
+ */
+export const liquidityPositionPrompts: MCPPrompt[] = [
+  myPositionsPrompt,
+  addLiquidityPrompt,
+  removeLiquidityPrompt,
+  collectFeesPrompt,
+];