@gala-chain/launchpad-mcp-server 5.0.2-beta.1 → 5.0.4-beta.0

package/dist/tools/dex/helpers.js

@@ -0,0 +1,570 @@
+"use strict";
+/**
+ * DEX Helper Utilities
+ *
+ * Shared formatting and validation functions for DEX tools.
+ * Reduces duplication across quote, position, volume, and swap tools.
+ *
+ * Contains:
+ * - Quote response formatting (SwapQuoteResult, DexPoolQuoteResult)
+ * - Liquidity position formatting
+ * - Wallet validation
+ * - Volume trend analysis
+ * - Token asset mapping
+ * - Handler factories for quote tools
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.VALID_FEE_TIERS = void 0;
+exports.formatQuoteResponse = formatQuoteResponse;
+exports.formatDexPoolQuoteResponse = formatDexPoolQuoteResponse;
+exports.formatPosition = formatPosition;
+exports.formatPositions = formatPositions;
+exports.validateWalletConfigured = validateWalletConfigured;
+exports.formatVolumeTrends = formatVolumeTrends;
+exports.mapTokenAssets = mapTokenAssets;
+exports.formatFeeTierPercent = formatFeeTierPercent;
+exports.formatFeeTiersPercent = formatFeeTiersPercent;
+exports.validateFeeTier = validateFeeTier;
+exports.extractTokenPairParams = extractTokenPairParams;
+exports.extractTokenPairWithTicksParams = extractTokenPairWithTicksParams;
+exports.mapTokenMetadata = mapTokenMetadata;
+exports.mapTokenMetadataArray = mapTokenMetadataArray;
+exports.parsePositionListResult = parsePositionListResult;
+exports.formatPositionListResponse = formatPositionListResponse;
+exports.formatAddLiquidityResponse = formatAddLiquidityResponse;
+exports.createSwapQuoteTool = createSwapQuoteTool;
+exports.createDexPoolQuoteTool = createDexPoolQuoteTool;
+const safe_parsers_js_1 = require("../../utils/safe-parsers.js");
+const response_formatter_js_1 = require("../../utils/response-formatter.js");
+const error_handler_js_1 = require("../../utils/error-handler.js");
+const common_schemas_js_1 = require("../../schemas/common-schemas.js");
+/**
+ * Build a standardized quote message.
+ *
+ * Centralizes the message format pattern used by all quote response formatters.
+ * Format: "{prefix} {inputAmount} {fromToken} -> ~{outputAmount} {toToken}{suffix}"
+ *
+ * @param data - Quote data with tokens and amounts
+ * @param options - Message formatting options
+ * @returns Formatted quote message string
+ */
+function buildQuoteMessage(data, options) {
+    const { fromToken, toToken, inputAmount, outputAmount } = data;
+    const { prefix, suffix = '' } = options;
+    return `${prefix} ${inputAmount} ${fromToken} -> ~${outputAmount} ${toToken}${suffix}`;
+}
+/**
+ * Format a swap quote response with standardized fields.
+ *
+ * Handles SwapQuoteResult (from getSwapQuote* methods).
+ * Adds optional calculationMode for context.
+ *
+ * @param quote - The quote result to format (SwapQuoteResult)
+ * @param mode - Optional calculation mode (e.g., 'local', 'external')
+ * @returns Formatted response object with common quote fields
+ */
+function formatQuoteResponse(quote, mode) {
+    return {
+        fromToken: quote.fromToken,
+        toToken: quote.toToken,
+        inputAmount: quote.inputAmount,
+        estimatedOutput: quote.estimatedOutput,
+        feeTier: quote.feeTier,
+        priceImpact: quote.priceImpact,
+        executionPrice: quote.executionPrice,
+        ...(mode && { calculationMode: mode }),
+        message: buildQuoteMessage({
+            fromToken: quote.fromToken,
+            toToken: quote.toToken,
+            inputAmount: quote.inputAmount,
+            outputAmount: quote.estimatedOutput,
+        }, { prefix: 'Quote:' }),
+    };
+}
+/**
+ * Format a DEX pool quote response with additional pool data.
+ *
+ * Handles DexPoolQuoteResult (from calculateDexPoolQuote* methods).
+ * Includes price tracking and optionally cached data indicator.
+ *
+ * @param quote - The pool quote result to format (DexPoolQuoteResult)
+ * @param tokens - Tuple of [fromToken, toToken] symbols
+ * @param mode - Calculation mode ('local' or 'external')
+ * @param usedCachedData - Whether cached pool data was used (optional)
+ * @returns Formatted response object with pool quote fields
+ */
+function formatDexPoolQuoteResponse(quote, tokens, mode, usedCachedData) {
+    const [fromToken, toToken] = tokens;
+    const modeLabel = mode === 'local' ? 'Local' : 'External';
+    return {
+        mode,
+        fromToken,
+        toToken,
+        inputAmount: quote.amount0,
+        outputAmount: quote.amount1,
+        currentSqrtPrice: quote.currentSqrtPrice,
+        newSqrtPrice: quote.newSqrtPrice,
+        priceImpact: quote.priceImpact,
+        executionPrice: quote.executionPrice,
+        ...(usedCachedData !== undefined && { usedCachedData }),
+        message: buildQuoteMessage({ fromToken, toToken, inputAmount: quote.amount0, outputAmount: quote.amount1 }, { prefix: `${modeLabel} quote:`, suffix: usedCachedData ? ' (using cached pool data)' : '' }),
+    };
+}
+/**
+ * Format a single liquidity position for MCP response.
+ *
+ * Core formatting function used by all position-related tools.
+ * Extracts and maps position fields consistently with optional metadata.
+ *
+ * @param position - SDK position object (LiquidityPosition)
+ * @param options - Optional formatting options (includeOwner, includeTimestamps)
+ * @returns Formatted position object with standardized fields
+ *
+ * @example
+ * // Basic formatting (for list responses)
+ * formatPosition(pos);
+ *
+ * // With metadata (for detail responses)
+ * formatPosition(pos, { includeOwner: true, includeTimestamps: true });
+ */
+function formatPosition(position, options = {}) {
+    const base = {
+        positionId: position.positionId,
+        token0: position.token0,
+        token1: position.token1,
+        feeTier: position.feeTier,
+        liquidity: String(position.liquidity),
+        amount0: position.amount0 ? String(position.amount0) : undefined,
+        amount1: position.amount1 ? String(position.amount1) : undefined,
+        feeAmount0: position.feeAmount0 ? String(position.feeAmount0) : undefined,
+        feeAmount1: position.feeAmount1 ? String(position.feeAmount1) : undefined,
+        tickLower: position.tickLower,
+        tickUpper: position.tickUpper,
+    };
+    if (options.includeOwner && position.ownerAddress) {
+        base.ownerAddress = position.ownerAddress;
+    }
+    if (options.includeTimestamps) {
+        base.createdAt = position.createdAt ? position.createdAt.toISOString() : undefined;
+        base.updatedAt = position.updatedAt ? position.updatedAt.toISOString() : undefined;
+    }
+    return base;
+}
+/**
+ * Format liquidity position data for MCP response.
+ *
+ * Convenience wrapper around formatPosition for array mapping.
+ * Handles null/undefined positions gracefully.
+ *
+ * @param positions - Array of position objects (LiquidityPosition) to format
+ * @param options - Optional formatting options passed to each position
+ * @returns Formatted positions array with standardized fields
+ */
+function formatPositions(positions, options = {}) {
+    return (positions && Array.isArray(positions))
+        ? positions.map((pos) => formatPosition(pos, options))
+        : [];
+}
+/**
+ * Validate that a wallet is configured.
+ *
+ * Checks if SDK has a valid wallet address configured by attempting to get address.
+ * Used before wallet-required operations.
+ *
+ * @param sdk - LaunchpadSDK instance
+ * @throws Error if wallet not configured
+ */
+function validateWalletConfigured(sdk) {
+    try {
+        sdk.getAddress();
+    }
+    catch {
+        throw new Error('Wallet not configured - required for this operation');
+    }
+}
+/**
+ * Format volume trend analysis.
+ *
+ * Extracts trend direction and percentage change for volume metrics.
+ * Used for consistent volume summary formatting across tools.
+ *
+ * @param volume1d - 1-day volume
+ * @param volume7d - 7-day volume
+ * @param volume30d - 30-day volume
+ * @param delta1d - 1-day delta change value
+ * @param delta7d - 7-day delta change value
+ * @param delta30d - 30-day delta change value
+ * @returns Formatted trend analysis object
+ */
+function formatVolumeTrends(volume1d, volume7d, volume30d, delta1d, delta7d, delta30d) {
+    return {
+        analysis: {
+            volume1dTrend: delta1d > 0 ? 'increasing' : 'decreasing',
+            volume7dTrend: delta7d > 0 ? 'increasing' : 'decreasing',
+            volume30dTrend: delta30d > 0 ? 'increasing' : 'decreasing',
+            volume1dChangePercent: `${(delta1d * 100).toFixed(2)}%`,
+            volume7dChangePercent: `${(delta7d * 100).toFixed(2)}%`,
+            volume30dChangePercent: `${(delta30d * 100).toFixed(2)}%`,
+        },
+        formattedMetrics: {
+            volume1d: `$${volume1d.toLocaleString('en-US', { maximumFractionDigits: 2 })}`,
+            volume7d: `$${volume7d.toLocaleString('en-US', { maximumFractionDigits: 2 })}`,
+            volume30d: `$${volume30d.toLocaleString('en-US', { maximumFractionDigits: 2 })}`,
+        },
+    };
+}
+/**
+ * Map token asset fields for consistent asset formatting.
+ *
+ * Extracts and formats token asset metadata with rich information.
+ * Used for consistent asset mapping across multiple tools.
+ *
+ * @param assets - Array of asset objects to map
+ * @returns Formatted assets array with standardized fields
+ */
+function mapTokenAssets(assets) {
+    return (assets || []).map((asset) => ({
+        symbol: asset.symbol,
+        name: asset.name,
+        description: undefined, // GSwapTokenAsset doesn't have description
+        image: asset.imageUrl,
+        balance: String(asset.balance),
+        decimals: asset.decimals,
+        verified: undefined, // GSwapTokenAsset doesn't have verified
+        compositeKey: typeof asset.tokenId === 'string' ? asset.tokenId : undefined,
+    }));
+}
+// =============================================================================
+// Fee Tier Formatting Helpers - Consistent percentage display
+// =============================================================================
+/**
+ * Valid GalaSwap fee tiers in basis points.
+ * Used for validation and display formatting.
+ */
+exports.VALID_FEE_TIERS = [500, 3000, 10000];
+/**
+ * Format a fee tier as a percentage string.
+ *
+ * Converts basis points to percentage for human-readable display.
+ * Uses proper formula: fee / 10000 to get decimal, then format as percentage.
+ *
+ * @param fee - Fee tier in basis points (500, 3000, or 10000)
+ * @returns Formatted percentage string (e.g., "0.05%", "0.30%", "1.00%")
+ *
+ * @example
+ * formatFeeTierPercent(500)   // "0.05%"
+ * formatFeeTierPercent(3000)  // "0.30%"
+ * formatFeeTierPercent(10000) // "1.00%"
+ */
+function formatFeeTierPercent(fee) {
+    const percent = fee / 10000;
+    return `${percent.toFixed(2)}%`;
+}
+/**
+ * Format an array of fee tiers as percentage strings.
+ *
+ * Convenience wrapper for formatting multiple fee tiers.
+ * Common use case: pool info response with available fee tiers.
+ *
+ * @param tiers - Array of fee tiers in basis points
+ * @returns Array of formatted percentage strings
+ *
+ * @example
+ * formatFeeTiersPercent([500, 3000, 10000])
+ * // ["0.05%", "0.30%", "1.00%"]
+ */
+function formatFeeTiersPercent(tiers) {
+    return tiers.map(formatFeeTierPercent);
+}
+/**
+ * Validate that a fee tier is valid.
+ *
+ * Checks if the provided fee tier is one of the valid GalaSwap fee tiers.
+ * Throws an error with helpful message if invalid.
+ *
+ * @param fee - Fee tier to validate
+ * @throws Error if fee tier is not 500, 3000, or 10000
+ *
+ * @example
+ * validateFeeTier(3000);   // OK
+ * validateFeeTier(1000);   // throws Error
+ */
+function validateFeeTier(fee) {
+    // Type guard: ensure fee is actually a number before validation
+    if (typeof fee !== 'number' || !Number.isFinite(fee)) {
+        throw new Error(`Invalid fee tier type: expected number, got ${typeof fee}. ` +
+            `Valid fee tiers are: ${exports.VALID_FEE_TIERS.join(', ')} (representing 0.05%, 0.30%, 1.00%)`);
+    }
+    if (!exports.VALID_FEE_TIERS.includes(fee)) {
+        throw new Error(`Invalid fee tier: ${fee}. Valid fee tiers are: ${exports.VALID_FEE_TIERS.join(', ')} (representing 0.05%, 0.30%, 1.00%)`);
+    }
+}
+/**
+ * Extract token pair parameters (token0, token1, fee) from MCP args.
+ *
+ * Eliminates repetitive type casting across DEX tools.
+ * Used in pool queries, quotes, and liquidity operations.
+ *
+ * @param args - MCP tool args object
+ * @returns Typed token pair parameters
+ *
+ * @example
+ * const { token0, token1, fee } = extractTokenPairParams(args);
+ * await sdk.fetchCompositePoolData({ token0, token1, fee });
+ */
+function extractTokenPairParams(args) {
+    return {
+        token0: args.token0,
+        token1: args.token1,
+        fee: args.fee,
+    };
+}
+/**
+ * Extract token pair with tick range parameters from MCP args.
+ *
+ * Extends extractTokenPairParams with tick boundaries for concentrated liquidity.
+ * Used in position queries, liquidity add/remove, and fee estimation.
+ *
+ * @param args - MCP tool args object
+ * @returns Typed token pair with tick parameters
+ *
+ * @example
+ * const params = extractTokenPairWithTicksParams(args);
+ * await sdk.getSwapLiquidityPosition(owner, params);
+ */
+function extractTokenPairWithTicksParams(args) {
+    return {
+        ...extractTokenPairParams(args),
+        tickLower: args.tickLower,
+        tickUpper: args.tickUpper,
+    };
+}
+/**
+ * Map token metadata for DEX token discovery responses.
+ *
+ * Extracts common token metadata fields for consistent formatting.
+ * Used in fetchAvailableDexTokens and fetchAllAvailableDexTokens.
+ *
+ * @param token - SDK token metadata object
+ * @returns Formatted token metadata object
+ */
+function mapTokenMetadata(token) {
+    return {
+        symbol: token.symbol,
+        name: token.name,
+        description: token.description,
+        image: token.image,
+        decimals: token.decimals,
+        verified: token.verified,
+        compositeKey: token.compositeKey,
+        category: token.category,
+        type: token.type,
+        collection: token.collection,
+    };
+}
+/**
+ * Map array of tokens for DEX token discovery responses.
+ *
+ * Convenience wrapper around mapTokenMetadata for array mapping.
+ *
+ * @param tokens - Array of SDK token metadata objects
+ * @returns Formatted token metadata array
+ *
+ * @example
+ * const tokens = await sdk.fetchAllAvailableDexTokens({ search });
+ * return formatSuccess({ tokens: mapTokenMetadataArray(tokens) });
+ */
+function mapTokenMetadataArray(tokens) {
+    return (tokens || []).map(mapTokenMetadata);
+}
+/**
+ * Parse SDK position list result into normalized format.
+ *
+ * Handles both array and object returns for backward compatibility.
+ * Used by getUserLiquidityPositions and getAllUserLiquidityPositions.
+ *
+ * @param result - Raw SDK result (array or object with items/prices)
+ * @returns Normalized result with positions, prices map, and count
+ *
+ * @example
+ * const { positions, prices, pricesCount } = parsePositionListResult(result);
+ */
+function parsePositionListResult(result) {
+    const positions = Array.isArray(result) ? result : result?.items || [];
+    const prices = !Array.isArray(result) && result?.prices ? result.prices : new Map();
+    return {
+        positions,
+        prices,
+        pricesCount: prices.size,
+    };
+}
+/**
+ * Format position list response with consistent structure.
+ *
+ * Consolidates the common response formatting logic used by both
+ * getUserLiquidityPositions and getAllUserLiquidityPositions tools.
+ *
+ * @param parsed - Parsed position list result from parsePositionListResult
+ * @param options - Formatting options (ownerAddress, withPrices, messageSuffix)
+ * @returns Formatted response object ready for formatSuccess()
+ *
+ * @example
+ * const parsed = parsePositionListResult(result);
+ * return formatSuccess(formatPositionListResponse(parsed, {
+ *   ownerAddress: args.ownerAddress,
+ *   withPrices: !!args.withPrices,
+ *   messageSuffix: '(auto-paginated)',
+ * }));
+ */
+function formatPositionListResponse(parsed, options) {
+    const { positions, pricesCount } = parsed;
+    const { ownerAddress, withPrices, messageSuffix } = options;
+    const positionCount = positions.length;
+    // Build message with optional suffix
+    const suffix = messageSuffix ? ` ${messageSuffix}` : '';
+    const pricingNote = withPrices ? ` with pricing data for ${pricesCount}` : '';
+    const message = positionCount > 0
+        ? `${positionCount} open positions found${suffix}${pricingNote}`
+        : 'No open positions found';
+    return {
+        ownerAddress,
+        positionCount,
+        positionsWithPricing: pricesCount,
+        positions: formatPositions(positions),
+        pricingStatus: withPrices
+            ? `Pricing fetched for ${pricesCount}/${positionCount} positions`
+            : 'No pricing requested',
+        message,
+    };
+}
+/**
+ * Format add liquidity response with consistent structure.
+ *
+ * Consolidates the common response fields for addLiquidityByPrice and addLiquidityByTicks.
+ * Both operations return the same core fields, differing only in range representation.
+ *
+ * @param result - SDK add liquidity result
+ * @param inputArgs - Original input arguments (for fallback amounts)
+ * @param rangeField - Object with either priceRange or tickRange field
+ * @returns Formatted response object ready for formatSuccess()
+ *
+ * @example
+ * return formatSuccess(formatAddLiquidityResponse(result, typedArgs, {
+ *   priceRange: `${typedArgs.minPrice} - ${typedArgs.maxPrice}`,
+ * }));
+ */
+function formatAddLiquidityResponse(result, inputArgs, rangeField) {
+    return {
+        transactionId: result.transactionId,
+        status: result.status,
+        token0: inputArgs.token0,
+        token1: inputArgs.token1,
+        ...rangeField,
+        amount0: result.amount0 || inputArgs.amount0Desired,
+        amount1: result.amount1 || inputArgs.amount1Desired,
+        liquidity: result.liquidity,
+        positionId: result.positionId,
+        message: `Liquidity added! Position: ${result.positionId || result.transactionId}`,
+    };
+}
+/**
+ * Factory function to create swap quote tools with consistent structure.
+ *
+ * Eliminates duplication between exactInput and exactOutput quote tools.
+ * Both tools share identical schema and handler logic, differing only in
+ * the description and SDK method called.
+ *
+ * @param config - Configuration for the quote tool
+ * @returns MCPTool definition for the swap quote tool
+ *
+ * @example
+ * const exactInputTool = createSwapQuoteTool({
+ *   name: 'gala_launchpad_get_swap_quote_exact_input',
+ *   description: 'Get swap quote for exact input amount',
+ *   amountDescription: 'Amount of source token to spend',
+ *   sdkMethod: 'getSwapQuoteExactInput',
+ * });
+ */
+function createSwapQuoteTool(config) {
+    return {
+        name: config.name,
+        description: config.description,
+        inputSchema: {
+            type: 'object',
+            properties: {
+                ...common_schemas_js_1.SWAP_QUOTE_INPUT_SCHEMA,
+                amount: {
+                    ...common_schemas_js_1.SWAP_QUOTE_INPUT_SCHEMA.amount,
+                    description: config.amountDescription,
+                },
+            },
+            required: ['fromToken', 'toToken', 'amount'],
+        },
+        handler: (0, error_handler_js_1.withErrorHandling)(async (sdk, args) => {
+            const quote = await sdk[config.sdkMethod](args.fromToken, args.toToken, args.amount);
+            return (0, response_formatter_js_1.formatSuccess)(formatQuoteResponse(quote));
+        }),
+    };
+}
+/**
+ * Factory function to create DEX pool quote tools.
+ *
+ * Eliminates duplication between local and external pool quote tools.
+ * Handles the composite pool data fetching and mode-specific SDK calls.
+ *
+ * @param config - Configuration for the pool quote tool
+ * @returns MCPTool definition for the DEX pool quote tool
+ */
+function createDexPoolQuoteTool(config) {
+    const properties = { ...common_schemas_js_1.DEX_POOL_QUOTE_INPUT_SCHEMA };
+    if (config.includeCachedDataParam) {
+        properties.compositePoolData = {
+            type: 'string',
+            description: 'Optional: Pre-fetched composite pool data as JSON string from gala_launchpad_fetch_composite_pool_data. If provided, skips fetch for efficiency (ideal for bulk quotes).',
+        };
+    }
+    return {
+        name: config.name,
+        description: config.description,
+        inputSchema: {
+            type: 'object',
+            properties,
+            required: ['token0', 'token1', 'fee', 'fromToken', 'toToken', 'amount'],
+        },
+        handler: (0, error_handler_js_1.withErrorHandling)(async (sdk, args) => {
+            // Use provided composite data or fetch it
+            let composite;
+            if (config.includeCachedDataParam && args.compositePoolData) {
+                const result = (0, safe_parsers_js_1.safeParseJson)(args.compositePoolData, null);
+                if (!result) {
+                    throw new Error(`Invalid compositePoolData JSON: must be a valid JSON object`);
+                }
+                composite = result;
+                // Basic structural validation - SDK will validate fully, but provide better error for obvious issues
+                if (!composite || typeof composite !== 'object') {
+                    throw new Error('compositePoolData must be a JSON object, not a primitive value');
+                }
+                if (!('pool' in composite) || !('tickDataMap' in composite)) {
+                    throw new Error('compositePoolData must contain "pool" and "tickDataMap" properties. ' +
+                        'Use gala_launchpad_fetch_composite_pool_data to get valid pool data.');
+                }
+            }
+            else {
+                composite = await sdk.fetchCompositePoolData(extractTokenPairParams(args));
+            }
+            // Calculate quote using appropriate SDK method
+            const sdkMethod = config.mode === 'local'
+                ? 'calculateDexPoolQuoteExactAmountLocal'
+                : 'calculateDexPoolQuoteExactAmountExternal';
+            const quote = await sdk[sdkMethod]({
+                compositePoolData: composite,
+                fromToken: args.fromToken,
+                toToken: args.toToken,
+                amount: args.amount,
+            });
+            const usedCachedData = config.includeCachedDataParam ? !!args.compositePoolData : undefined;
+            return (0, response_formatter_js_1.formatSuccess)(formatDexPoolQuoteResponse(quote, [args.fromToken, args.toToken], config.mode, usedCachedData));
+        }),
+    };
+}
+//# sourceMappingURL=helpers.js.map

package/dist/tools/dex/helpers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"helpers.js","sourceRoot":"","sources":["../../../src/tools/dex/helpers.ts"],"names":[],"mappings":"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"}

package/dist/tools/dex/index.d.ts

@@ -1,22 +1,61 @@
 /**
- * DEX/GalaSwap Trading Operations Tools & Pool Discovery
+ * DEX Trading Operations Tools
  *
- * 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.
+ * Core trading tools for executing swaps on GalaSwap DEX.
+ * Provides quote generation, swap execution, and user asset queries.
+ *
+ * Related categories:
+ * - dex-pools: Pool discovery and information
+ * - dex-liquidity: Liquidity position management
+ * - dex-analytics: Leaderboard and volume analytics
  */
 import type { MCPTool } from '../../types/mcp.js';
+/**
+ * 1. Get Swap Quote (Exact Input)
+ *
+ * Get swap quote for exact input amount - specify how much you want to spend.
+ */
 export declare const getSwapQuoteExactInputTool: MCPTool;
+/**
+ * 2. Get Swap Quote (Exact Output)
+ *
+ * Get swap quote for exact output amount - specify how much you want to receive.
+ */
 export declare const getSwapQuoteExactOutputTool: MCPTool;
-export declare const executeSwapTool: MCPTool;
-export declare const getSwapUserAssetsTool: MCPTool;
-export declare const getSwapPoolInfoTool: MCPTool;
-export declare const fetchCompositePoolDataTool: MCPTool;
+/**
+ * 3. Calculate DEX Pool Quote (Local - instant offline calculation)
+ *
+ * Calculate instant DEX quote using local bonding curve math.
+ * Auto-fetches pool data unless compositePoolData is provided (for bulk efficiency).
+ */
 export declare const calculateDexPoolQuoteLocalTool: MCPTool;
+/**
+ * 4. Calculate DEX Pool Quote (External - real-time from blockchain)
+ *
+ * Calculate real-time DEX quote from GalaChain blockchain.
+ * Slower than local but always reflects current pool state.
+ * Use for final price verification.
+ */
 export declare const calculateDexPoolQuoteExternalTool: MCPTool;
-export declare const getSwapPoolPriceTool: MCPTool;
+/**
+ * 5. Execute Swap
+ *
+ * Execute a token swap on GalaSwap DEX with slippage protection.
+ * Get a quote first using getSwapQuote tools.
+ */
+export declare const executeSwapTool: MCPTool;
+/**
+ * 6. Get User Assets (with rich metadata)
+ *
+ * Get all token assets and balances for a wallet address with rich metadata.
+ */
+export declare const getSwapUserAssetsTool: MCPTool;
+/**
+ * 7. Get All Swap User Assets (auto-paginated, with rich metadata)
+ *
+ * Get ALL token assets and balances for a wallet (auto-paginates) with rich metadata.
+ * Complete portfolio view for DEX trading.
+ */
 export declare const getAllSwapUserAssetsTool: MCPTool;
-export declare const fetchAvailableDexTokensTool: MCPTool;
-export declare const fetchAllAvailableDexTokensTool: MCPTool;
 export declare const dexTools: MCPTool[];
 //# sourceMappingURL=index.d.ts.map

package/dist/tools/dex/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/tools/dex/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAqClD,eAAO,MAAM,0BAA0B,EAAE,OA6BxC,CAAC;AAGF,eAAO,MAAM,2BAA2B,EAAE,OA6BzC,CAAC;AAGF,eAAO,MAAM,eAAe,EAAE,OAuD7B,CAAC;AAGF,eAAO,MAAM,qBAAqB,EAAE,OA+BnC,CAAC;AAGF,eAAO,MAAM,mBAAmB,EAAE,OAwBjC,CAAC;AASF,eAAO,MAAM,0BAA0B,EAAE,OAsCxC,CAAC;AAGF,eAAO,MAAM,8BAA8B,EAAE,OAqE5C,CAAC;AAGF,eAAO,MAAM,iCAAiC,EAAE,OA0D/C,CAAC;AAGF,eAAO,MAAM,oBAAoB,EAAE,OA6BlC,CAAC;AAGF,eAAO,MAAM,wBAAwB,EAAE,OAgCtC,CAAC;AAGF,eAAO,MAAM,2BAA2B,EAAE,OAqDzC,CAAC;AAGF,eAAO,MAAM,8BAA8B,EAAE,OAqC5C,CAAC;AAGF,eAAO,MAAM,QAAQ,EAAE,OAAO,EAkB7B,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/tools/dex/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAoClD;;;;GAIG;AACH,eAAO,MAAM,0BAA0B,EAAE,OAKvC,CAAC;AAEH;;;;GAIG;AACH,eAAO,MAAM,2BAA2B,EAAE,OAKxC,CAAC;AAEH;;;;;GAKG;AACH,eAAO,MAAM,8BAA8B,EAAE,OAM3C,CAAC;AAEH;;;;;;GAMG;AACH,eAAO,MAAM,iCAAiC,EAAE,OAK9C,CAAC;AAMH;;;;;GAKG;AACH,eAAO,MAAM,eAAe,EAAE,OAgD7B,CAAC;AAMF;;;;GAIG;AACH,eAAO,MAAM,qBAAqB,EAAE,OAuBnC,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,wBAAwB,EAAE,OAwBtC,CAAC;AAOF,eAAO,MAAM,QAAQ,EAAE,OAAO,EAQ7B,CAAC"}