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

package/src/tools/dex/fetchDexPools.ts

@@ -0,0 +1,58 @@
+/**
+ * Fetch DEX Pools Tool
+ *
+ * Queries the GalaSwap DEX backend for available liquidity pools with pagination,
+ * sorting, and search filtering capabilities.
+ */
+
+import type { MCPTool } from '../../types/mcp.js';
+import { formatSuccess } from '../../utils/response-formatter.js';
+import { withErrorHandling } from '../../utils/error-handler.js';
+
+export const fetchDexPoolsTool: MCPTool = {
+  name: 'gala_launchpad_fetch_dex_pools',
+  description: 'Fetch DEX pools with pagination and filtering - query available liquidity pools on GalaSwap',
+  inputSchema: {
+    type: 'object',
+    properties: {
+      search: {
+        type: 'string',
+        minLength: 1,
+        maxLength: 100,
+        description: 'Search filter for token symbols in pool pair (e.g., "GALA", "GUSDC", "GALA/GUSDC")',
+      },
+      sortBy: {
+        type: 'string',
+        enum: ['tvl', 'volume30d', 'volume1d'],
+        description: 'Field to sort results by (default: tvl)',
+      },
+      sortOrder: {
+        type: 'string',
+        enum: ['asc', 'desc'],
+        description: 'Sort order direction (default: desc)',
+      },
+      page: {
+        type: 'number',
+        minimum: 1,
+        description: 'Page number (1-based pagination, default: 1)',
+      },
+      limit: {
+        type: 'number',
+        minimum: 1,
+        maximum: 20,
+        description: 'Number of results per page (default: 10, maximum: 20)',
+      },
+    },
+  },
+  handler: withErrorHandling(async (sdk, args) => {
+    const result = await sdk.fetchDexPools({
+      search: args.search,
+      sortBy: args.sortBy || 'tvl',
+      sortOrder: args.sortOrder || 'desc',
+      page: args.page || 1,
+      limit: args.limit || 10,
+    });
+
+    return formatSuccess(result);
+  }),
+};

package/src/tools/dex/index.ts

@@ -1,12 +1,15 @@
 /**
- * DEX/GalaSwap Trading Operations Tools
+ * DEX/GalaSwap Trading Operations Tools & Pool Discovery
  *
- * Tools for trading on GalaSwap DEX after tokens graduate from bonding curves.
- * These tools provide quote generation, swap execution, liquidity management, and asset management.
+ * Tools for trading on GalaSwap DEX after tokens graduate from bonding curves,
+ * discovering liquidity pools, and managing positions.
+ * Provides quote generation, swap execution, liquidity management, asset management, and pool exploration.
  */
 
 import type { MCPTool } from '../../types/mcp.js';
 import { liquidityPositionTools } from './liquidity-positions.js';
+import { fetchDexPoolsTool } from './fetchDexPools.js';
+import { fetchAllDexPoolsTool } from './fetchAllDexPools.js';
 import { formatSuccess } from '../../utils/response-formatter.js';
 import { withErrorHandling } from '../../utils/error-handler.js';
 import {
@@ -215,8 +218,10 @@ export const getSwapPoolInfoTool: MCPTool = {
   }),
 };
 
-// Export all DEX tools (5 swap tools + 8 liquidity position tools = 13 tools)
+// Export all DEX tools (2 pool discovery + 5 swap tools + 8 liquidity position tools = 15 tools)
 export const dexTools: MCPTool[] = [
+  fetchDexPoolsTool,
+  fetchAllDexPoolsTool,
   getSwapQuoteExactInputTool,
   getSwapQuoteExactOutputTool,
   executeSwapTool,

package/src/utils/validation.ts

@@ -369,3 +369,61 @@ export function safeValidate(
     return { success: false, error: String(error) };
   }
 }
+
+/**
+ * Validate optional field if present
+ *
+ * Convenience wrapper for validating optional fields. Only runs validation
+ * if the value is defined and not null.
+ *
+ * @param value - Value to validate (can be undefined)
+ * @param validator - Validation function to run if value is present
+ * @throws {ValidationError} If validation fails
+ *
+ * @example
+ * ```typescript
+ * validateOptional(args.slippage, (val) => validateSlippage(val));
+ * ```
+ */
+export function validateOptional<T>(
+  value: T | undefined | null,
+  validator: (val: T) => void
+): void {
+  if (value !== undefined && value !== null && value !== '') {
+    validator(value as T);
+  }
+}
+
+/**
+ * Validate optional slippage field
+ *
+ * @param slippage - Slippage value to validate (optional)
+ * @throws {ValidationError} If slippage is invalid
+ */
+export function validateOptionalSlippage(slippage?: string | number): void {
+  validateOptional(slippage, (val) => validateSlippage(val));
+}
+
+/**
+ * Validate optional pagination limit field
+ *
+ * @param limit - Limit value to validate (optional)
+ * @param max - Maximum allowed limit (default: 100)
+ * @throws {ValidationError} If limit is invalid
+ */
+export function validateOptionalLimit(
+  limit?: string | number,
+  max: number = 100
+): void {
+  validateOptional(limit, (val) => validatePaginationLimit(val, max));
+}
+
+/**
+ * Validate optional address field
+ *
+ * @param address - Address value to validate (optional)
+ * @throws {ValidationError} If address is invalid
+ */
+export function validateOptionalAddress(address?: string): void {
+  validateOptional(address, (val) => validateAddress(val));
+}