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

package/dist/tools/trading/index.js

@@ -1,235 +1,130 @@
 "use strict";
 /**
  * Trading Operations Tools
+ *
+ * MCP tools for bonding curve trading: buy, sell, calculate amounts, and graduation.
  */
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.tradingTools = exports.calculateSellAmountExternalTool = exports.calculateSellAmountLocalTool = exports.calculateBuyAmountExternalTool = exports.calculateBuyAmountLocalTool = exports.graduateTokenTool = exports.calculateBuyAmountForGraduationTool = exports.getBundlerTransactionResultTool = exports.calculateInitialBuyTool = exports.fetchTradesTool = exports.sellTokensTool = exports.buyTokensTool = exports.calculateSellAmountTool = exports.calculateBuyAmountTool = void 0;
-const launchpad_sdk_1 = require("@gala-chain/launchpad-sdk");
-const response_formatter_js_1 = require("../../utils/response-formatter.js");
-const error_handler_js_1 = require("../../utils/error-handler.js");
+const handler_factories_js_1 = require("../handler-factories.js");
 const common_schemas_js_1 = require("../../schemas/common-schemas.js");
 const default_values_js_1 = require("../../utils/default-values.js");
+const date_converter_js_1 = require("../../utils/date-converter.js");
+const index_js_1 = require("./helpers/index.js");
+// =============================================================================
+// Calculate Amount Tools
+// =============================================================================
 // 1. Calculate Buy Amount
 exports.calculateBuyAmountTool = {
     name: 'gala_launchpad_calculate_buy_amount',
-    description: 'Calculate token amounts for buying with fee breakdown',
+    description: `Calculate token amounts for buying with fee breakdown.
+
+PARAMETERS:
+- type: 'native' (spend GALA) or 'exact' (buy token amount)
+- amount: Spend amount (native) or token quantity (exact)
+
+RETURNS:
+- amount: Exact token amount to receive
+- totalCost: GALA needed (amount + all fees)
+- transactionFee: Gas fee (1 GALA)
+- reverseBondingCurveFee: Dynamic pool fee (min-max range)`,
     inputSchema: {
         type: 'object',
         properties: {
             tokenName: common_schemas_js_1.TOKEN_NAME_SCHEMA,
-            amount: {
-                ...common_schemas_js_1.DECIMAL_AMOUNT_SCHEMA,
-                description: 'Amount in standard decimal format (e.g., "1" for 1 GALA)',
-            },
-            type: {
-                type: 'string',
-                enum: Object.values(launchpad_sdk_1.TRADING_TYPES),
-                description: `Trade calculation type:
-
-- 'native': You specify GALA amount to spend
-  Example: "I want to spend 10 GALA to buy tokens" → type: 'native', amount: '10'
-
-- 'exact': You specify exact token amount to buy
-  Example: "I want to buy exactly 1000 WOO tokens" → type: 'exact', amount: '1000'
-
-Most common: Use 'native' when you know how much GALA to spend`,
-            },
+            amount: index_js_1.TRADE_AMOUNT_SCHEMA,
+            type: index_js_1.BUY_CALCULATION_TYPE_SCHEMA,
         },
         required: ['tokenName', 'amount', 'type'],
     },
-    handler: (0, error_handler_js_1.withErrorHandling)(async (sdk, args) => {
-        const result = await sdk.calculateBuyAmount({
-            tokenName: args.tokenName,
-            amount: args.amount,
-            type: args.type,
-        });
-        return (0, response_formatter_js_1.formatSuccess)(result);
-    }),
+    handler: (0, handler_factories_js_1.createSimpleHandler)('calculateBuyAmount', index_js_1.extractCalculationArgs),
 };
 // 2. Calculate Sell Amount
 exports.calculateSellAmountTool = {
     name: 'gala_launchpad_calculate_sell_amount',
-    description: 'Calculate GALA amounts for selling tokens',
+    description: `Calculate GALA amounts for selling tokens.
+
+PARAMETERS:
+- type: 'native' (receive GALA amount) or 'exact' (sell token amount)
+- amount: GALA desired (native) or tokens to sell (exact)
+
+RETURNS:
+- amount: GALA received after all deductions
+- totalCost: Tokens needed (amount + reverse fee)
+- transactionFee: Gas fee (1 GALA deducted from amount)
+- reverseBondingCurveFee: Dynamic pool fee applied to sale`,
     inputSchema: {
         type: 'object',
         properties: {
             tokenName: common_schemas_js_1.TOKEN_NAME_SCHEMA,
             amount: common_schemas_js_1.DECIMAL_AMOUNT_SCHEMA,
-            type: {
-                type: 'string',
-                enum: Object.values(launchpad_sdk_1.TRADING_TYPES),
-                description: `Trade calculation type:
-
-- 'native': You specify GALA amount you want to receive
-  Example: "I want to receive 10 GALA from selling tokens" → type: 'native', amount: '10'
-
-- 'exact': You specify exact token amount to sell
-  Example: "I want to sell exactly 1000 WOO tokens" → type: 'exact', amount: '1000'
-
-Most common: Use 'native' when you know how much GALA you want to receive`,
-            },
+            type: index_js_1.SELL_CALCULATION_TYPE_SCHEMA,
         },
         required: ['tokenName', 'amount', 'type'],
     },
-    handler: (0, error_handler_js_1.withErrorHandling)(async (sdk, args) => {
-        const result = await sdk.calculateSellAmount({
-            tokenName: args.tokenName,
-            amount: args.amount,
-            type: args.type,
-        });
-        return (0, response_formatter_js_1.formatSuccess)(result);
-    }),
+    handler: (0, handler_factories_js_1.createSimpleHandler)('calculateSellAmount', index_js_1.extractCalculationArgs),
 };
-// 3. Buy Tokens
+// =============================================================================
+// Trade Execution Tools
+// =============================================================================
+// 3. Buy Tokens (calls SDK buy() method)
 exports.buyTokensTool = {
-    name: 'gala_launchpad_buy_tokens',
+    name: 'gala_launchpad_buy',
     description: `Execute token purchase with slippage protection.
 
 WORKFLOW:
-1. calculateBuyAmount() → Get expected output (result.amount AND result.reverseBondingCurveFee)
-2. buy() → Execute trade with BOTH expectedAmount AND maxAcceptableReverseBondingCurveFee
-3. fetchTrades() → Verify trade completed
+1. calculateBuyAmount() -> Get expected output (result.amount AND result.reverseBondingCurveFee)
+2. buy() -> Execute trade with BOTH expectedAmount AND maxAcceptableReverseBondingCurveFee
+3. fetchTrades() -> Verify trade completed
 
 CRITICAL: Extract BOTH parameters from calculateBuyAmount:
-- result.amount → expectedAmount
-- result.reverseBondingCurveFee → maxAcceptableReverseBondingCurveFee
+- result.amount -> expectedAmount
+- result.reverseBondingCurveFee -> maxAcceptableReverseBondingCurveFee
 Omitting reverseBondingCurveFee may cause transaction failures!
 
 RETURNS: Transaction details including input/output amounts and transaction ID`,
-    inputSchema: {
-        type: 'object',
-        properties: {
-            tokenName: common_schemas_js_1.TOKEN_NAME_SCHEMA,
-            amount: {
-                ...common_schemas_js_1.DECIMAL_AMOUNT_SCHEMA,
-                description: 'Amount to spend/buy',
-            },
-            type: {
-                type: 'string',
-                enum: Object.values(launchpad_sdk_1.TRADING_TYPES),
-                description: `Trade type (must match what you used in calculateBuyAmount):
-
-- 'native': Spending GALA amount
-- 'exact': Buying exact token amount`,
-            },
-            expectedAmount: {
-                ...common_schemas_js_1.DECIMAL_AMOUNT_SCHEMA,
-                description: `Expected token output amount from calculateBuyAmount (REQUIRED).
-
-CRITICAL: This is the 'amount' field from calculateBuyAmount result, NOT your input amount.
-
-WORKFLOW:
-1. Call calculateBuyAmount({ tokenName, amount, type })
-2. Extract result.amount from the response
-3. Use result.amount as this expectedAmount parameter
-
-EXAMPLE:
-const calc = await calculateBuyAmount({ tokenName: 'woohoo', amount: '10', type: 'native' });
-// calc.amount = "16843.7579794843252"
-await buy({ tokenName: 'woohoo', amount: '10', type: 'native', expectedAmount: calc.amount, ... });
-// Use calc.amount ("16843.7579794843252"), NOT the input '10'`,
-            },
-            maxAcceptableReverseBondingCurveFee: {
-                ...common_schemas_js_1.DECIMAL_AMOUNT_SCHEMA,
-                description: 'RECOMMENDED: Base reverse bonding curve fee from calculateBuyAmount (GALA). Use result.reverseBondingCurveFee. Omitting this may cause transaction failures. Works with maxAcceptableReverseBondingCurveFeeSlippageFactor for automatic slippage adjustment.',
-            },
-            maxAcceptableReverseBondingCurveFeeSlippageFactor: common_schemas_js_1.RBC_FEE_SLIPPAGE_SCHEMA,
-            slippageToleranceFactor: common_schemas_js_1.SLIPPAGE_TOLERANCE_SCHEMA,
-            privateKey: common_schemas_js_1.PRIVATE_KEY_SCHEMA,
-        },
-        required: ['tokenName', 'amount', 'type', 'expectedAmount', 'slippageToleranceFactor'],
-    },
-    handler: (0, error_handler_js_1.withErrorHandling)(async (sdk, args) => {
-        const result = await sdk.buy({
-            tokenName: args.tokenName,
-            amount: args.amount,
-            type: args.type,
-            expectedAmount: args.expectedAmount,
-            maxAcceptableReverseBondingCurveFee: args.maxAcceptableReverseBondingCurveFee,
-            maxAcceptableReverseBondingCurveFeeSlippageFactor: args.maxAcceptableReverseBondingCurveFeeSlippageFactor,
-            slippageToleranceFactor: args.slippageToleranceFactor,
-            privateKey: args.privateKey,
-        });
-        return (0, response_formatter_js_1.formatSuccess)(result);
-    }),
+    inputSchema: (0, index_js_1.createTradeExecutionSchema)({ direction: 'buy' }),
+    handler: (0, handler_factories_js_1.createSimpleHandler)('buy', index_js_1.extractTradeArgs),
 };
-// 4. Sell Tokens
+// 4. Sell Tokens (calls SDK sell() method)
 exports.sellTokensTool = {
-    name: 'gala_launchpad_sell_tokens',
+    name: 'gala_launchpad_sell',
     description: `Execute token sale with slippage protection.
 
 WORKFLOW:
-1. calculateSellAmount() → Get expected output (result.amount AND result.reverseBondingCurveFee)
-2. sell() → Execute trade with BOTH expectedAmount AND maxAcceptableReverseBondingCurveFee
-3. fetchTrades() → Verify trade completed
+1. calculateSellAmount() -> Get expected output (result.amount AND result.reverseBondingCurveFee)
+2. sell() -> Execute trade with BOTH expectedAmount AND maxAcceptableReverseBondingCurveFee
+3. fetchTrades() -> Verify trade completed
 
 CRITICAL: Extract BOTH parameters from calculateSellAmount:
-- result.amount → expectedAmount
-- result.reverseBondingCurveFee → maxAcceptableReverseBondingCurveFee
+- result.amount -> expectedAmount
+- result.reverseBondingCurveFee -> maxAcceptableReverseBondingCurveFee
 Omitting reverseBondingCurveFee may cause transaction failures!
 
 RETURNS: Transaction details including input/output amounts and transaction ID`,
-    inputSchema: {
-        type: 'object',
-        properties: {
-            tokenName: common_schemas_js_1.TOKEN_NAME_SCHEMA,
-            amount: {
-                ...common_schemas_js_1.DECIMAL_AMOUNT_SCHEMA,
-                description: 'Amount to sell/receive',
-            },
-            type: {
-                type: 'string',
-                enum: Object.values(launchpad_sdk_1.TRADING_TYPES),
-                description: `Trade type (must match what you used in calculateSellAmount):
-
-- 'native': Receiving GALA amount
-- 'exact': Selling exact token amount`,
-            },
-            expectedAmount: {
-                ...common_schemas_js_1.DECIMAL_AMOUNT_SCHEMA,
-                description: `Expected GALA output amount from calculateSellAmount (REQUIRED).
-
-CRITICAL: This is the 'amount' field from calculateSellAmount result, NOT your input amount.
-
-WORKFLOW:
-1. Call calculateSellAmount({ tokenName, amount, type })
-2. Extract result.amount from the response
-3. Use result.amount as this expectedAmount parameter
-
-EXAMPLE:
-const calc = await calculateSellAmount({ tokenName: 'woohoo', amount: '10', type: 'native' });
-// calc.amount = "16843.7579794843252"
-await sell({ tokenName: 'woohoo', amount: '10', type: 'native', expectedAmount: calc.amount, ... });
-// Use calc.amount ("16843.7579794843252"), NOT the input '10'`,
-            },
-            maxAcceptableReverseBondingCurveFee: {
-                ...common_schemas_js_1.DECIMAL_AMOUNT_SCHEMA,
-                description: 'RECOMMENDED: Base reverse bonding curve fee from calculateSellAmount (GALA). Use result.reverseBondingCurveFee. Omitting this may cause transaction failures. Works with maxAcceptableReverseBondingCurveFeeSlippageFactor for automatic slippage adjustment.',
-            },
-            maxAcceptableReverseBondingCurveFeeSlippageFactor: common_schemas_js_1.RBC_FEE_SLIPPAGE_SCHEMA,
-            slippageToleranceFactor: common_schemas_js_1.SLIPPAGE_TOLERANCE_SCHEMA,
-            privateKey: common_schemas_js_1.PRIVATE_KEY_SCHEMA,
-        },
-        required: ['tokenName', 'amount', 'type', 'expectedAmount', 'slippageToleranceFactor'],
-    },
-    handler: (0, error_handler_js_1.withErrorHandling)(async (sdk, args) => {
-        const result = await sdk.sell({
-            tokenName: args.tokenName,
-            amount: args.amount,
-            type: args.type,
-            expectedAmount: args.expectedAmount,
-            maxAcceptableReverseBondingCurveFee: args.maxAcceptableReverseBondingCurveFee,
-            maxAcceptableReverseBondingCurveFeeSlippageFactor: args.maxAcceptableReverseBondingCurveFeeSlippageFactor,
-            slippageToleranceFactor: args.slippageToleranceFactor,
-            privateKey: args.privateKey,
-        });
-        return (0, response_formatter_js_1.formatSuccess)(result);
-    }),
+    inputSchema: (0, index_js_1.createTradeExecutionSchema)({ direction: 'sell' }),
+    handler: (0, handler_factories_js_1.createSimpleHandler)('sell', index_js_1.extractTradeArgs),
 };
+// =============================================================================
+// Trade History & Utilities
+// =============================================================================
 // 5. Fetch Trades
 exports.fetchTradesTool = {
     name: 'gala_launchpad_fetch_trades',
-    description: 'Get trade history with filtering',
+    description: `Get trade history with optional filtering and pagination.
+
+PARAMETERS:
+- tradeType: 'buy' (purchases only) or 'sell' (sales only) - optional filter
+- userAddress: Filter by specific wallet address (optional)
+- startDate/endDate: Filter by date range (optional, ISO 8601 format)
+
+RETURNS:
+- trades[]: Array of trades with:
+  - txHash: Transaction ID
+  - type: 'buy' or 'sell'
+  - amount: Token quantity
+  - price: GALA paid/received
+  - timestamp: When executed`,
     inputSchema: {
         type: 'object',
         properties: {
@@ -237,7 +132,7 @@ exports.fetchTradesTool = {
             tradeType: {
                 type: 'string',
                 enum: ['buy', 'sell'],
-                description: 'Filter by trade type',
+                description: "Filter by trade type: 'buy' (purchases) or 'sell' (sales)",
             },
             userAddress: {
                 ...common_schemas_js_1.ADDRESS_SCHEMA,
@@ -256,18 +151,10 @@ exports.fetchTradesTool = {
             sortOrder: common_schemas_js_1.SORT_ORDER_SCHEMA,
         },
     },
-    handler: (0, error_handler_js_1.withErrorHandling)(async (sdk, args) => {
+    handler: (0, handler_factories_js_1.createSimpleHandler)('fetchTrades', (args) => {
         const pagination = (0, default_values_js_1.applyOperationPaginationDefaults)(args, 'trade');
-        const result = await sdk.fetchTrades({
-            tokenName: args.tokenName,
-            tradeType: args.tradeType,
-            userAddress: args.userAddress,
-            ...pagination,
-            startDate: args.startDate,
-            endDate: args.endDate,
-            sortOrder: args.sortOrder || 'desc',
-        });
-        return (0, response_formatter_js_1.formatSuccess)(result);
+        const options = (0, index_js_1.extractTradeHistoryArgs)(args, pagination);
+        return (0, date_converter_js_1.addParsedStartEndDates)(options, args.startDate, args.endDate);
     }),
 };
 // 6. Calculate Initial Buy
@@ -284,10 +171,7 @@ exports.calculateInitialBuyTool = {
         },
         required: ['amount'],
     },
-    handler: (0, error_handler_js_1.withErrorHandling)(async (sdk, args) => {
-        const result = await sdk.calculateInitialBuyAmount(args.amount);
-        return (0, response_formatter_js_1.formatSuccess)(result);
-    }),
+    handler: (0, handler_factories_js_1.createSimpleHandler)('calculateInitialBuyAmount', (args) => args.amount),
 };
 // 7. Get Bundler Transaction Result
 exports.getBundlerTransactionResultTool = {
@@ -311,11 +195,11 @@ Note: This is a synchronous HTTP call, not WebSocket monitoring.`,
         },
         required: ['transactionId'],
     },
-    handler: (0, error_handler_js_1.withErrorHandling)(async (sdk, args) => {
-        const result = await sdk.getBundlerTransactionResult(args.transactionId);
-        return (0, response_formatter_js_1.formatSuccess)(result);
-    }),
+    handler: (0, handler_factories_js_1.createSimpleHandler)('getBundlerTransactionResult', (args) => args.transactionId),
 };
+// =============================================================================
+// Graduation Tools
+// =============================================================================
 // 8. Calculate Buy Amount for Graduation
 exports.calculateBuyAmountForGraduationTool = {
     name: 'gala_launchpad_calculate_buy_amount_for_graduation',
@@ -339,18 +223,7 @@ totalCost, amount, transactionFee, gasFee, reverseBondingCurveFee`,
         },
         required: ['tokenName'],
     },
-    handler: (0, error_handler_js_1.withErrorHandling)(async (sdk, args) => {
-        // Build options object only if mode or supply provided
-        const options = args.calculateAmountMode || args.currentSupply
-            ? {
-                tokenName: args.tokenName,
-                calculateAmountMode: args.calculateAmountMode,
-                currentSupply: args.currentSupply,
-            }
-            : args.tokenName;
-        const result = await sdk.calculateBuyAmountForGraduation(options);
-        return (0, response_formatter_js_1.formatSuccess)(result);
-    }),
+    handler: (0, handler_factories_js_1.createSimpleHandler)('calculateBuyAmountForGraduation', index_js_1.extractGraduationCalcArgs),
 };
 // 9. Graduate Token
 exports.graduateTokenTool = {
@@ -373,193 +246,97 @@ RETURNS: TradeResult with transaction details including amounts and transaction
         type: 'object',
         properties: {
             tokenName: common_schemas_js_1.TOKEN_NAME_SCHEMA,
-            slippageToleranceFactor: common_schemas_js_1.SLIPPAGE_TOLERANCE_SCHEMA,
-            maxAcceptableReverseBondingCurveFeeSlippageFactor: common_schemas_js_1.RBC_FEE_SLIPPAGE_SCHEMA,
-            privateKey: common_schemas_js_1.PRIVATE_KEY_SCHEMA,
-            calculateAmountMode: common_schemas_js_1.CALCULATION_MODE_SCHEMA,
-            currentSupply: common_schemas_js_1.CURRENT_SUPPLY_SCHEMA,
+            ...index_js_1.TRADE_EXECUTION_PROPERTIES,
+            ...index_js_1.GRADUATION_OPTIONAL_PROPERTIES,
         },
-        required: ['tokenName'], // Only tokenName is required
+        required: ['tokenName'],
     },
-    handler: (0, error_handler_js_1.withErrorHandling)(async (sdk, args) => {
-        const result = await sdk.graduateToken({
-            tokenName: args.tokenName,
-            slippageToleranceFactor: args.slippageToleranceFactor,
-            maxAcceptableReverseBondingCurveFeeSlippageFactor: args.maxAcceptableReverseBondingCurveFeeSlippageFactor,
-            privateKey: args.privateKey,
-            calculateAmountMode: args.calculateAmountMode,
-            currentSupply: args.currentSupply,
-        });
-        return (0, response_formatter_js_1.formatSuccess)(result);
-    }),
+    handler: (0, handler_factories_js_1.createSimpleHandler)('graduateToken', index_js_1.extractGraduationArgs),
 };
-// 10. Calculate Buy Amount (Local)
-exports.calculateBuyAmountLocalTool = {
-    name: 'gala_launchpad_calculate_buy_amount_local',
-    description: `Calculate buy amounts using LOCAL bonding curve formulas (instant, no network call).
+// =============================================================================
+// Local/External Calculation Tools (Using Factory Pattern)
+// =============================================================================
+// Shared descriptions for calculation tools
+const BUY_LOCAL_DESCRIPTION = `Calculate buy amounts using LOCAL bonding curve formulas (instant, no network call).
 
 Uses client-side exponential bonding curve calculations for instant quotes.
 Perfect for price discovery, UI updates, and offline scenarios.
 
 ACCURACY: Matches external calculations with <0.01% difference.
 
-RETURNS: { amount, reverseBondingCurveFee: "0", transactionFee, gasFee }`,
-    inputSchema: {
-        type: 'object',
-        properties: {
-            tokenName: common_schemas_js_1.TOKEN_NAME_SCHEMA,
-            amount: {
-                ...common_schemas_js_1.DECIMAL_AMOUNT_SCHEMA,
-                description: 'Amount in standard decimal format (e.g., "1" for 1 GALA)',
-            },
-            type: {
-                type: 'string',
-                enum: Object.values(launchpad_sdk_1.TRADING_TYPES),
-                description: `Trade calculation type:
-- 'native': Spend GALA amount
-- 'exact': Buy exact token amount`,
-            },
-        },
-        required: ['tokenName', 'amount', 'type'],
-    },
-    handler: (0, error_handler_js_1.withErrorHandling)(async (sdk, args) => {
-        const result = await sdk.calculateBuyAmountLocal({
-            tokenName: args.tokenName,
-            amount: args.amount,
-            type: args.type,
-        });
-        return (0, response_formatter_js_1.formatSuccess)(result);
-    }),
-};
-// 11. Calculate Buy Amount (External)
-exports.calculateBuyAmountExternalTool = {
-    name: 'gala_launchpad_calculate_buy_amount_external',
-    description: `Calculate buy amounts using EXTERNAL GalaChain network call (real-time).
+RETURNS: { amount, reverseBondingCurveFee: "0", transactionFee, gasFee }`;
+const BUY_EXTERNAL_DESCRIPTION = `Calculate buy amounts using EXTERNAL GalaChain network call (real-time).
 
 Explicit external calculation - queries GalaChain network for real-time pricing.
 Identical to calculateBuyAmount but makes the network dependency explicit.
 
-RETURNS: { amount, reverseBondingCurveFee, transactionFee, gasFee }`,
-    inputSchema: {
-        type: 'object',
-        properties: {
-            tokenName: common_schemas_js_1.TOKEN_NAME_SCHEMA,
-            amount: {
-                ...common_schemas_js_1.DECIMAL_AMOUNT_SCHEMA,
-                description: 'Amount in standard decimal format',
-            },
-            type: {
-                type: 'string',
-                enum: Object.values(launchpad_sdk_1.TRADING_TYPES),
-                description: `Trade calculation type:
-- 'native': Spend GALA amount
-- 'exact': Buy exact token amount`,
-            },
-        },
-        required: ['tokenName', 'amount', 'type'],
-    },
-    handler: (0, error_handler_js_1.withErrorHandling)(async (sdk, args) => {
-        const result = await sdk.calculateBuyAmountExternal({
-            tokenName: args.tokenName,
-            amount: args.amount,
-            type: args.type,
-        });
-        return (0, response_formatter_js_1.formatSuccess)(result);
-    }),
-};
-// 12. Calculate Sell Amount (Local)
-exports.calculateSellAmountLocalTool = {
-    name: 'gala_launchpad_calculate_sell_amount_local',
-    description: `Calculate sell amounts using LOCAL bonding curve formulas (instant, no network call).
+RETURNS: { amount, reverseBondingCurveFee, transactionFee, gasFee }`;
+const SELL_LOCAL_DESCRIPTION = `Calculate sell amounts using LOCAL bonding curve formulas (instant, no network call).
 
 Uses client-side calculations with reverse bonding curve fee support.
 Requires pool details (maxSupply, fee parameters) to calculate accurately.
 
 ACCURACY: Matches external calculations with <0.01% difference.
 
-RETURNS: { amount, reverseBondingCurveFee, transactionFee, gasFee }`,
-    inputSchema: {
-        type: 'object',
-        properties: {
-            tokenName: common_schemas_js_1.TOKEN_NAME_SCHEMA,
-            amount: {
-                ...common_schemas_js_1.DECIMAL_AMOUNT_SCHEMA,
-                description: 'Amount to sell/receive',
-            },
-            type: {
-                type: 'string',
-                enum: Object.values(launchpad_sdk_1.TRADING_TYPES),
-                description: `Trade calculation type:
-- 'native': Receive GALA amount
-- 'exact': Sell exact token amount`,
-            },
-            maxSupply: {
-                ...common_schemas_js_1.DECIMAL_AMOUNT_SCHEMA,
-                description: 'Token maximum supply (get from fetchPoolDetails)',
-            },
-            reverseBondingCurveMinFeeFactor: {
-                type: 'number',
-                minimum: 0,
-                maximum: 1,
-                description: 'Min reverse bonding curve fee factor (get from poolDetails.reverseBondingCurveMinFeeFactor)',
-            },
-            reverseBondingCurveMaxFeeFactor: {
-                type: 'number',
-                minimum: 0,
-                maximum: 1,
-                description: 'Max reverse bonding curve fee factor (get from poolDetails.reverseBondingCurveMaxFeeFactor)',
-            },
-        },
-        required: ['tokenName', 'amount', 'type', 'maxSupply', 'reverseBondingCurveMinFeeFactor', 'reverseBondingCurveMaxFeeFactor'],
-    },
-    handler: (0, error_handler_js_1.withErrorHandling)(async (sdk, args) => {
-        const result = await sdk.calculateSellAmountLocal({
-            tokenName: args.tokenName,
-            amount: args.amount,
-            type: args.type,
-            maxSupply: args.maxSupply,
-            reverseBondingCurveMinFeeFactor: args.reverseBondingCurveMinFeeFactor,
-            reverseBondingCurveMaxFeeFactor: args.reverseBondingCurveMaxFeeFactor,
-        });
-        return (0, response_formatter_js_1.formatSuccess)(result);
+RETURNS: { amount, reverseBondingCurveFee, transactionFee, gasFee }`;
+const SELL_EXTERNAL_DESCRIPTION = `Calculate sell amounts using EXTERNAL GalaChain network call (real-time).
+
+Explicit external calculation - queries GalaChain network for real-time pricing.
+Identical to calculateSellAmount but makes the network dependency explicit.
+
+RETURNS: { amount, reverseBondingCurveFee, transactionFee, gasFee }`;
+// 10. Calculate Buy Amount (Local)
+exports.calculateBuyAmountLocalTool = {
+    name: 'gala_launchpad_calculate_buy_amount_local',
+    description: BUY_LOCAL_DESCRIPTION,
+    ...(0, index_js_1.createCalculationToolSchema)({
+        name: 'gala_launchpad_calculate_buy_amount_local',
+        description: BUY_LOCAL_DESCRIPTION,
+        direction: 'buy',
+        mode: 'local',
     }),
+    handler: (0, handler_factories_js_1.createSimpleHandler)('calculateBuyAmountLocal', index_js_1.extractLocalCalculationArgs),
+};
+// 11. Calculate Buy Amount (External)
+exports.calculateBuyAmountExternalTool = {
+    name: 'gala_launchpad_calculate_buy_amount_external',
+    description: BUY_EXTERNAL_DESCRIPTION,
+    ...(0, index_js_1.createCalculationToolSchema)({
+        name: 'gala_launchpad_calculate_buy_amount_external',
+        description: BUY_EXTERNAL_DESCRIPTION,
+        direction: 'buy',
+        mode: 'external',
+    }),
+    handler: (0, handler_factories_js_1.createSimpleHandler)('calculateBuyAmountExternal', index_js_1.extractCalculationArgs),
+};
+// 12. Calculate Sell Amount (Local)
+exports.calculateSellAmountLocalTool = {
+    name: 'gala_launchpad_calculate_sell_amount_local',
+    description: SELL_LOCAL_DESCRIPTION,
+    ...(0, index_js_1.createCalculationToolSchema)({
+        name: 'gala_launchpad_calculate_sell_amount_local',
+        description: SELL_LOCAL_DESCRIPTION,
+        direction: 'sell',
+        mode: 'local',
+        includeLocalSellProperties: true,
+    }),
+    handler: (0, handler_factories_js_1.createSimpleHandler)('calculateSellAmountLocal', index_js_1.extractLocalSellArgs),
 };
 // 13. Calculate Sell Amount (External)
 exports.calculateSellAmountExternalTool = {
     name: 'gala_launchpad_calculate_sell_amount_external',
-    description: `Calculate sell amounts using EXTERNAL GalaChain network call (real-time).
-
-Explicit external calculation - queries GalaChain network for real-time pricing.
-Identical to calculateSellAmount but makes the network dependency explicit.
-
-RETURNS: { amount, reverseBondingCurveFee, transactionFee, gasFee }`,
-    inputSchema: {
-        type: 'object',
-        properties: {
-            tokenName: common_schemas_js_1.TOKEN_NAME_SCHEMA,
-            amount: {
-                ...common_schemas_js_1.DECIMAL_AMOUNT_SCHEMA,
-                description: 'Amount to sell/receive',
-            },
-            type: {
-                type: 'string',
-                enum: Object.values(launchpad_sdk_1.TRADING_TYPES),
-                description: `Trade calculation type:
-- 'native': Receive GALA amount
-- 'exact': Sell exact token amount`,
-            },
-        },
-        required: ['tokenName', 'amount', 'type'],
-    },
-    handler: (0, error_handler_js_1.withErrorHandling)(async (sdk, args) => {
-        const result = await sdk.calculateSellAmountExternal({
-            tokenName: args.tokenName,
-            amount: args.amount,
-            type: args.type,
-        });
-        return (0, response_formatter_js_1.formatSuccess)(result);
+    description: SELL_EXTERNAL_DESCRIPTION,
+    ...(0, index_js_1.createCalculationToolSchema)({
+        name: 'gala_launchpad_calculate_sell_amount_external',
+        description: SELL_EXTERNAL_DESCRIPTION,
+        direction: 'sell',
+        mode: 'external',
     }),
+    handler: (0, handler_factories_js_1.createSimpleHandler)('calculateSellAmountExternal', index_js_1.extractCalculationArgs),
 };
+// =============================================================================
+// Tool Export
+// =============================================================================
 exports.tradingTools = [
     exports.calculateBuyAmountTool,
     exports.calculateSellAmountTool,