@gala-chain/launchpad-mcp-server 5.1.1 → 7.0.0-beta.2

package/dist/tools/dex/helpers.js

@@ -1,520 +1,68 @@
 "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
- */
+/** Shared formatting and argument helpers for the v6 GSwap MCP 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.mapTokenAssets = mapTokenAssets;
 exports.mapTokenMetadataArray = mapTokenMetadataArray;
-exports.parsePositionListResult = parsePositionListResult;
-exports.formatPositionListResponse = formatPositionListResponse;
-exports.formatAddLiquidityResponse = formatAddLiquidityResponse;
+exports.formatFeeTierPercent = formatFeeTierPercent;
+exports.formatFeeTiersPercent = formatFeeTiersPercent;
 exports.createSwapQuoteTool = createSwapQuoteTool;
 exports.createDexPoolQuoteTool = createDexPoolQuoteTool;
-const safe_parsers_js_1 = require("../../utils/safe-parsers.js");
+exports.formatPosition = formatPosition;
+exports.formatPositions = formatPositions;
+exports.formatPool = formatPool;
+exports.formatSlot0 = formatSlot0;
+exports.formatDexSubmission = formatDexSubmission;
+exports.asPriceIn = asPriceIn;
 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 !== undefined && 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 result = {
-        positionId: position.positionId,
-        token0: position.token0,
-        token1: position.token1,
-        feeTier: position.feeTier,
-        liquidity: String(position.liquidity),
-        tickLower: position.tickLower,
-        tickUpper: position.tickUpper,
-    };
-    // Only assign optional string properties if they have a value
-    // eslint-disable-next-line @typescript-eslint/no-unnecessary-condition -- runtime defensive check for falsy values
-    if (position.amount0 !== undefined && position.amount0 !== '') {
-        result.amount0 = String(position.amount0);
-    }
-    // eslint-disable-next-line @typescript-eslint/no-unnecessary-condition -- runtime defensive check for falsy values
-    if (position.amount1 !== undefined && position.amount1 !== '') {
-        result.amount1 = String(position.amount1);
-    }
-    // eslint-disable-next-line @typescript-eslint/no-unnecessary-condition -- runtime defensive check for falsy values
-    if (position.feeAmount0 !== undefined && position.feeAmount0 !== '') {
-        result.feeAmount0 = String(position.feeAmount0);
-    }
-    // eslint-disable-next-line @typescript-eslint/no-unnecessary-condition -- runtime defensive check for falsy values
-    if (position.feeAmount1 !== undefined && position.feeAmount1 !== '') {
-        result.feeAmount1 = String(position.feeAmount1);
-    }
-    // eslint-disable-next-line @typescript-eslint/no-unnecessary-condition -- runtime defensive check for falsy values
-    if (options.includeOwner && position.ownerAddress !== undefined && position.ownerAddress !== '') {
-        result.ownerAddress = position.ownerAddress;
-    }
-    if (options.includeTimestamps) {
-        if (position.createdAt) {
-            result.createdAt = position.createdAt.toISOString();
-        }
-        if (position.updatedAt) {
-            result.updatedAt = position.updatedAt.toISOString();
-        }
-    }
-    return result;
-}
-/**
- * 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 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 (Array.isArray(assets) ? assets : []).map((asset) => {
-        const result = {
-            symbol: asset.symbol,
-            balance: String(asset.balance),
-            decimals: asset.decimals,
-        };
-        // eslint-disable-next-line @typescript-eslint/no-unnecessary-condition -- runtime defensive check for null/undefined
-        if (asset.name !== undefined && asset.name !== null) {
-            result.name = asset.name;
-        }
-        // eslint-disable-next-line @typescript-eslint/no-unnecessary-condition -- runtime defensive check for null/undefined
-        if (asset.imageUrl !== undefined && asset.imageUrl !== null) {
-            result.image = asset.imageUrl;
-        }
-        if (typeof asset.tokenId === 'string') {
-            result.compositeKey = asset.tokenId;
-        }
-        return result;
-    });
-}
-// =============================================================================
-// 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,
+        token0: requiredString(args, 'token0'),
+        token1: requiredString(args, 'token1'),
+        fee: requiredNumber(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,
+        tickLower: requiredNumber(args, 'tickLower'),
+        tickUpper: requiredNumber(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,
+function mapTokenAssets(result) {
+    if (!isRecord(result) || !Array.isArray(result.tokens)) {
+        return [];
+    }
+    return result.tokens.filter(isRecord).map((token) => ({
         image: token.image,
+        name: token.name,
         decimals: token.decimals,
-        verified: token.verified,
-        compositeKey: token.compositeKey,
-        category: token.category,
-        type: token.type,
-        collection: token.collection,
-    };
+        verified: token.verify,
+        symbol: token.symbol,
+        quantity: token.quantity,
+    }));
 }
-/**
- * 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 (Array.isArray(tokens) ? 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) {
-    // eslint-disable-next-line @typescript-eslint/no-unnecessary-condition -- runtime defensive check for union type
-    const positions = Array.isArray(result) ? result : result !== undefined && 'items' in result ? (Array.isArray(result.items) ? result.items : []) : [];
-    // eslint-disable-next-line @typescript-eslint/no-unnecessary-condition -- runtime defensive check for union type
-    const pricesValue = !Array.isArray(result) && result !== undefined && 'prices' in result ? result.prices : new Map();
-    const prices = pricesValue;
-    return {
-        positions,
-        prices,
-        pricesCount: prices.size,
-    };
+    return tokens.map((token) => ({
+        symbol: token.symbol,
+        decimals: token.decimals,
+        collection: token.collection,
+        category: token.category,
+        type: token.type,
+        additionalKey: token.additionalKey,
+        compositeKey: `${token.collection}|${token.category}|${token.type}|${token.additionalKey}`,
+    }));
 }
-/**
- * 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 !== undefined && 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,
-    };
+function formatFeeTierPercent(fee) {
+    return `${(fee / 10000).toFixed(2)}%`;
 }
-/**
- * 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}`,
-    };
+function formatFeeTiersPercent(fees) {
+    return fees.map(formatFeeTierPercent);
 }
-/**
- * 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',
- * });
- */
+/** Create a v6 `sdk.dex.quoting` MCP tool. */
 function createSwapQuoteTool(config) {
     return {
         name: config.name,
@@ -527,75 +75,112 @@ function createSwapQuoteTool(config) {
                     ...common_schemas_js_1.SWAP_QUOTE_INPUT_SCHEMA.amount,
                     description: config.amountDescription,
                 },
+                fee: {
+                    type: 'number',
+                    description: 'Optional fee tier in basis points.',
+                },
             },
             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));
+            const fromToken = requiredString(args, 'fromToken');
+            const toToken = requiredString(args, 'toToken');
+            const amount = requiredString(args, 'amount');
+            const fee = optionalNumber(args, 'fee');
+            const quote = config.exactOutput
+                ? await sdk.dex.quoting.quoteExactOutput(fromToken, toToken, amount, fee)
+                : await sdk.dex.quoting.quoteExactInput(fromToken, toToken, amount, fee);
+            return (0, response_formatter_js_1.formatSuccess)({
+                ...quote,
+                inputAmount: quote.amountIn,
+                estimatedOutput: quote.amountOut,
+                priceImpact: quote.priceImpact?.toString() ?? null,
+                message: `Quote: ${quote.amountIn} ${fromToken} -> ~${quote.amountOut} ${toToken}`,
+            });
         }),
     };
 }
-/**
- * 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
- */
+/** Create the legacy-named pool quote tool on the v6 quoting service. */
 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,
+            properties: { ...common_schemas_js_1.DEX_POOL_QUOTE_INPUT_SCHEMA },
             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 !== undefined && args.compositePoolData !== '') {
-                const result = (0, safe_parsers_js_1.safeParseJson)(args.compositePoolData, null);
-                // eslint-disable-next-line @typescript-eslint/no-unnecessary-condition -- runtime defensive check after parse
-                if (result === null || result === undefined) {
-                    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 (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 fromToken = requiredString(args, 'fromToken');
+            const toToken = requiredString(args, 'toToken');
+            const amount = requiredString(args, 'amount');
+            const fee = requiredNumber(args, 'fee');
+            const quote = config.exactOutput === true
+                ? await sdk.dex.quoting.quoteExactOutput(fromToken, toToken, amount, fee)
+                : await sdk.dex.quoting.quoteExactInput(fromToken, toToken, amount, fee);
+            return (0, response_formatter_js_1.formatSuccess)({
+                ...quote,
+                mode: 'external',
+                pool: { token0: requiredString(args, 'token0'), token1: requiredString(args, 'token1'), fee },
+                priceImpact: quote.priceImpact?.toString() ?? null,
             });
-            const usedCachedData = config.includeCachedDataParam && args.compositePoolData !== undefined && args.compositePoolData !== '' ? true : undefined;
-            return (0, response_formatter_js_1.formatSuccess)(formatDexPoolQuoteResponse(quote, [args.fromToken, args.toToken], config.mode, usedCachedData));
         }),
     };
 }
+function formatPosition(position) {
+    return {
+        pool: position.pool,
+        token0: position.token0Symbol,
+        token1: position.token1Symbol,
+        feeTier: position.fee,
+        liquidity: position.liquidity,
+        amount0: position.amount0,
+        amount1: position.amount1,
+        tickLower: position.tickLower,
+        tickUpper: position.tickUpper,
+        ownerAddress: position.owner,
+        inRange: position.inRange,
+        fees0: position.fees0,
+        fees1: position.fees1,
+    };
+}
+function formatPositions(positions) {
+    return positions.map(formatPosition);
+}
+function formatPool(pool) {
+    return { ...pool, feePercent: formatFeeTierPercent(pool.fee) };
+}
+function formatSlot0(slot0) {
+    return { ...slot0 };
+}
+async function formatDexSubmission(value) {
+    const formatted = await (0, response_formatter_js_1.formatSdkResult)(value);
+    return isRecord(formatted) ? formatted : { result: formatted };
+}
+function asPriceIn(value) {
+    return value;
+}
+function requiredString(args, name) {
+    const value = args[name];
+    if (typeof value !== 'string' || value.trim() === '') {
+        throw new Error(`${name} must be a non-empty string`);
+    }
+    return value;
+}
+function requiredNumber(args, name) {
+    const value = args[name];
+    if (typeof value !== 'number' || !Number.isFinite(value)) {
+        throw new Error(`${name} must be a finite number`);
+    }
+    return value;
+}
+function optionalNumber(args, name) {
+    const value = args[name];
+    if (value === undefined)
+        return undefined;
+    return requiredNumber(args, name);
+}
+function isRecord(value) {
+    return typeof value === 'object' && value !== null;
+}
 //# sourceMappingURL=helpers.js.map