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

package/dist/tools/trading/helpers/arg-extractors.d.ts

@@ -0,0 +1,128 @@
+/**
+ * Trading Tool Argument Extractors
+ *
+ * Shared argument extraction functions for trading operations.
+ * Uses a composable pattern where base extractors can be combined.
+ *
+ * Architecture:
+ * - Base extractors (extractBaseCalculationArgs, extractExecutionParams, etc.)
+ * - Composite extractors combine bases (extractTradeArgs = base + execution)
+ * - All extractors use the typed cast helpers to eliminate raw "as" casts
+ */
+type Args = Record<string, unknown>;
+/**
+ * Extracts calculation args for buy/sell amount calculations
+ *
+ * @param args - Raw args from MCP tool
+ * @returns Typed calculation params { tokenName, amount, type }
+ */
+export declare function extractCalculationArgs(args: Args): {
+    tokenName: string;
+    amount: string;
+    type: "exact" | "native";
+};
+/**
+ * Extracts trade execution args for buy/sell operations
+ *
+ * Composes: baseCalculation + executionParams
+ *
+ * @param args - Raw args from MCP tool
+ * @returns Typed trade params for SDK
+ */
+export declare function extractTradeArgs(args: Args): {
+    expectedAmount: string;
+    maxAcceptableReverseBondingCurveFee: string | undefined;
+    maxAcceptableReverseBondingCurveFeeSlippageFactor: number | undefined;
+    slippageToleranceFactor: number | undefined;
+    privateKey: string | undefined;
+    tokenName: string;
+    amount: string;
+    type: "exact" | "native";
+};
+/**
+ * Extracts trade execution args for buy operations
+ * @deprecated Use extractTradeArgs instead - buy and sell share identical signatures
+ */
+export declare const extractBuyArgs: typeof extractTradeArgs;
+/**
+ * Extracts trade execution args for sell operations
+ * @deprecated Use extractTradeArgs instead - buy and sell share identical signatures
+ */
+export declare const extractSellArgs: typeof extractTradeArgs;
+/**
+ * Extracts local calculation args (with optional tokenName)
+ *
+ * @param args - Raw args from MCP tool
+ * @returns Typed local calculation params
+ */
+export declare function extractLocalCalculationArgs(args: Args): {
+    tokenName: string | undefined;
+    amount: string;
+    type: "exact" | "native";
+};
+/**
+ * Extracts local sell calculation args with RBC fee parameters
+ *
+ * Composes: baseLocalCalculation + localSellFeeParams
+ *
+ * @param args - Raw args from MCP tool
+ * @returns Typed local sell calculation params
+ */
+export declare function extractLocalSellArgs(args: Args): {
+    maxSupply: string | undefined;
+    reverseBondingCurveMinFeeFactor: number | undefined;
+    reverseBondingCurveMaxFeeFactor: number | undefined;
+    tokenName: string | undefined;
+    amount: string;
+    type: "exact" | "native";
+};
+/**
+ * Extracts graduation args for graduateToken
+ *
+ * Composes: tokenName + graduationExecutionParams + graduationCalcOptions
+ *
+ * @param args - Raw args from MCP tool
+ * @returns Typed graduation params
+ */
+export declare function extractGraduationArgs(args: Args): {
+    calculateAmountMode: "local" | "external" | undefined;
+    currentSupply: string | undefined;
+    slippageToleranceFactor: number | undefined;
+    maxAcceptableReverseBondingCurveFeeSlippageFactor: number | undefined;
+    privateKey: string | undefined;
+    tokenName: string;
+};
+/**
+ * Extracts graduation calculation args
+ *
+ * @param args - Raw args from MCP tool
+ * @returns Token name string or options object with tokenName + calculation options
+ */
+export declare function extractGraduationCalcArgs(args: Args): string | {
+    calculateAmountMode: "local" | "external" | undefined;
+    currentSupply: string | undefined;
+    tokenName: string;
+};
+/**
+ * Extracts trade history filter args for fetchTrades
+ *
+ * Extracts filtering, pagination, and date parameters for trade history queries.
+ * Returns a base options object ready for date augmentation.
+ *
+ * @param args - Raw args from MCP tool
+ * @param pagination - Pre-computed pagination from applyOperationPaginationDefaults
+ * @returns Options object with filters and pagination (dates need separate handling)
+ */
+export declare function extractTradeHistoryArgs(args: Args, pagination: {
+    page: number;
+    limit: number;
+}): {
+    tokenName: string | undefined;
+    tradeType: 'buy' | 'sell' | undefined;
+    userAddress: string | undefined;
+    page: number;
+    limit: number;
+    sortOrder: 'asc' | 'desc';
+};
+export {};
+//# sourceMappingURL=arg-extractors.d.ts.map

package/dist/tools/trading/helpers/arg-extractors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"arg-extractors.d.ts","sourceRoot":"","sources":["../../../../src/tools/trading/helpers/arg-extractors.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAMH,KAAK,IAAI,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AA2GpC;;;;;GAKG;AACH,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,IAAI;;;;EAEhD;AAED;;;;;;;GAOG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,IAAI;;;;;;;;;EAK1C;AAED;;;GAGG;AACH,eAAO,MAAM,cAAc,yBAAmB,CAAC;AAE/C;;;GAGG;AACH,eAAO,MAAM,eAAe,yBAAmB,CAAC;AAEhD;;;;;GAKG;AACH,wBAAgB,2BAA2B,CAAC,IAAI,EAAE,IAAI;;;;EAErD;AAED;;;;;;;GAOG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,IAAI;;;;;;;EAK9C;AAED;;;;;;;GAOG;AACH,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,IAAI;;;;;;;EAM/C;AAED;;;;;GAKG;AACH,wBAAgB,yBAAyB,CAAC,IAAI,EAAE,IAAI;;;;EASnD;AAED;;;;;;;;;GASG;AACH,wBAAgB,uBAAuB,CACrC,IAAI,EAAE,IAAI,EACV,UAAU,EAAE;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GAC1C;IACD,SAAS,EAAE,MAAM,GAAG,SAAS,CAAC;IAC9B,SAAS,EAAE,KAAK,GAAG,MAAM,GAAG,SAAS,CAAC;IACtC,WAAW,EAAE,MAAM,GAAG,SAAS,CAAC;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,KAAK,GAAG,MAAM,CAAC;CAC3B,CAQA"}

package/dist/tools/trading/helpers/arg-extractors.js

@@ -0,0 +1,215 @@
+"use strict";
+/**
+ * Trading Tool Argument Extractors
+ *
+ * Shared argument extraction functions for trading operations.
+ * Uses a composable pattern where base extractors can be combined.
+ *
+ * Architecture:
+ * - Base extractors (extractBaseCalculationArgs, extractExecutionParams, etc.)
+ * - Composite extractors combine bases (extractTradeArgs = base + execution)
+ * - All extractors use the typed cast helpers to eliminate raw "as" casts
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.extractSellArgs = exports.extractBuyArgs = void 0;
+exports.extractCalculationArgs = extractCalculationArgs;
+exports.extractTradeArgs = extractTradeArgs;
+exports.extractLocalCalculationArgs = extractLocalCalculationArgs;
+exports.extractLocalSellArgs = extractLocalSellArgs;
+exports.extractGraduationArgs = extractGraduationArgs;
+exports.extractGraduationCalcArgs = extractGraduationCalcArgs;
+exports.extractTradeHistoryArgs = extractTradeHistoryArgs;
+/** Cast to string (required field) */
+const str = (args, key) => args[key];
+/** Cast to optional string */
+const optStr = (args, key) => args[key];
+/** Cast to optional number */
+const optNum = (args, key) => args[key];
+/** Cast to trade type enum */
+const tradeType = (args) => args.type;
+/** Cast to calculation mode enum */
+const calcMode = (args) => args.calculateAmountMode;
+/** Cast to trade history trade type enum */
+const historyTradeType = (args) => args.tradeType;
+/** Cast to sort order enum with default */
+const sortOrder = (args) => args.sortOrder || 'desc';
+// =============================================================================
+// Base Extractors - Composable building blocks
+// =============================================================================
+/**
+ * Base calculation fields: tokenName (required), amount, type
+ * Used by: calculateBuyAmount, calculateSellAmount, external calculations
+ */
+function extractBaseCalculationArgs(args) {
+    return {
+        tokenName: str(args, 'tokenName'),
+        amount: str(args, 'amount'),
+        type: tradeType(args),
+    };
+}
+/**
+ * Base calculation fields with optional tokenName
+ * Used by: local calculations where tokenName can be inferred
+ */
+function extractBaseLocalCalculationArgs(args) {
+    return {
+        tokenName: optStr(args, 'tokenName'),
+        amount: str(args, 'amount'),
+        type: tradeType(args),
+    };
+}
+/**
+ * Trade execution params: slippage, RBC fee, private key
+ * Used by: buy, sell, graduateToken
+ */
+function extractExecutionParams(args) {
+    return {
+        expectedAmount: str(args, 'expectedAmount'),
+        maxAcceptableReverseBondingCurveFee: optStr(args, 'maxAcceptableReverseBondingCurveFee'),
+        maxAcceptableReverseBondingCurveFeeSlippageFactor: optNum(args, 'maxAcceptableReverseBondingCurveFeeSlippageFactor'),
+        slippageToleranceFactor: optNum(args, 'slippageToleranceFactor'),
+        privateKey: optStr(args, 'privateKey'),
+    };
+}
+/**
+ * Graduation-specific execution params (no expectedAmount)
+ * Used by: graduateToken
+ */
+function extractGraduationExecutionParams(args) {
+    return {
+        slippageToleranceFactor: optNum(args, 'slippageToleranceFactor'),
+        maxAcceptableReverseBondingCurveFeeSlippageFactor: optNum(args, 'maxAcceptableReverseBondingCurveFeeSlippageFactor'),
+        privateKey: optStr(args, 'privateKey'),
+    };
+}
+/**
+ * Graduation calculation options: mode, currentSupply
+ * Used by: graduateToken, calculateBuyAmountForGraduation
+ */
+function extractGraduationCalcOptions(args) {
+    return {
+        calculateAmountMode: calcMode(args),
+        currentSupply: optStr(args, 'currentSupply'),
+    };
+}
+/**
+ * Local sell RBC fee parameters
+ * Used by: calculateSellAmountLocal
+ */
+function extractLocalSellFeeParams(args) {
+    return {
+        maxSupply: optStr(args, 'maxSupply'),
+        reverseBondingCurveMinFeeFactor: optNum(args, 'reverseBondingCurveMinFeeFactor'),
+        reverseBondingCurveMaxFeeFactor: optNum(args, 'reverseBondingCurveMaxFeeFactor'),
+    };
+}
+// =============================================================================
+// Composite Extractors - Public API (combine base extractors)
+// =============================================================================
+/**
+ * Extracts calculation args for buy/sell amount calculations
+ *
+ * @param args - Raw args from MCP tool
+ * @returns Typed calculation params { tokenName, amount, type }
+ */
+function extractCalculationArgs(args) {
+    return extractBaseCalculationArgs(args);
+}
+/**
+ * Extracts trade execution args for buy/sell operations
+ *
+ * Composes: baseCalculation + executionParams
+ *
+ * @param args - Raw args from MCP tool
+ * @returns Typed trade params for SDK
+ */
+function extractTradeArgs(args) {
+    return {
+        ...extractBaseCalculationArgs(args),
+        ...extractExecutionParams(args),
+    };
+}
+/**
+ * Extracts trade execution args for buy operations
+ * @deprecated Use extractTradeArgs instead - buy and sell share identical signatures
+ */
+exports.extractBuyArgs = extractTradeArgs;
+/**
+ * Extracts trade execution args for sell operations
+ * @deprecated Use extractTradeArgs instead - buy and sell share identical signatures
+ */
+exports.extractSellArgs = extractTradeArgs;
+/**
+ * Extracts local calculation args (with optional tokenName)
+ *
+ * @param args - Raw args from MCP tool
+ * @returns Typed local calculation params
+ */
+function extractLocalCalculationArgs(args) {
+    return extractBaseLocalCalculationArgs(args);
+}
+/**
+ * Extracts local sell calculation args with RBC fee parameters
+ *
+ * Composes: baseLocalCalculation + localSellFeeParams
+ *
+ * @param args - Raw args from MCP tool
+ * @returns Typed local sell calculation params
+ */
+function extractLocalSellArgs(args) {
+    return {
+        ...extractBaseLocalCalculationArgs(args),
+        ...extractLocalSellFeeParams(args),
+    };
+}
+/**
+ * Extracts graduation args for graduateToken
+ *
+ * Composes: tokenName + graduationExecutionParams + graduationCalcOptions
+ *
+ * @param args - Raw args from MCP tool
+ * @returns Typed graduation params
+ */
+function extractGraduationArgs(args) {
+    return {
+        tokenName: str(args, 'tokenName'),
+        ...extractGraduationExecutionParams(args),
+        ...extractGraduationCalcOptions(args),
+    };
+}
+/**
+ * Extracts graduation calculation args
+ *
+ * @param args - Raw args from MCP tool
+ * @returns Token name string or options object with tokenName + calculation options
+ */
+function extractGraduationCalcArgs(args) {
+    // Build options object only if mode or supply provided
+    if (args.calculateAmountMode || args.currentSupply) {
+        return {
+            tokenName: str(args, 'tokenName'),
+            ...extractGraduationCalcOptions(args),
+        };
+    }
+    return str(args, 'tokenName');
+}
+/**
+ * Extracts trade history filter args for fetchTrades
+ *
+ * Extracts filtering, pagination, and date parameters for trade history queries.
+ * Returns a base options object ready for date augmentation.
+ *
+ * @param args - Raw args from MCP tool
+ * @param pagination - Pre-computed pagination from applyOperationPaginationDefaults
+ * @returns Options object with filters and pagination (dates need separate handling)
+ */
+function extractTradeHistoryArgs(args, pagination) {
+    return {
+        tokenName: optStr(args, 'tokenName'),
+        tradeType: historyTradeType(args),
+        userAddress: optStr(args, 'userAddress'),
+        ...pagination,
+        sortOrder: sortOrder(args),
+    };
+}
+//# sourceMappingURL=arg-extractors.js.map

package/dist/tools/trading/helpers/arg-extractors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"arg-extractors.js","sourceRoot":"","sources":["../../../../src/tools/trading/helpers/arg-extractors.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;GAUG;;;AAuHH,wDAEC;AAUD,4CAKC;AAoBD,kEAEC;AAUD,oDAKC;AAUD,sDAMC;AAQD,8DASC;AAYD,0DAkBC;AApOD,sCAAsC;AACtC,MAAM,GAAG,GAAG,CAAC,IAAU,EAAE,GAAW,EAAU,EAAE,CAAC,IAAI,CAAC,GAAG,CAAW,CAAC;AAErE,8BAA8B;AAC9B,MAAM,MAAM,GAAG,CAAC,IAAU,EAAE,GAAW,EAAsB,EAAE,CAAC,IAAI,CAAC,GAAG,CAAuB,CAAC;AAEhG,8BAA8B;AAC9B,MAAM,MAAM,GAAG,CAAC,IAAU,EAAE,GAAW,EAAsB,EAAE,CAAC,IAAI,CAAC,GAAG,CAAuB,CAAC;AAEhG,8BAA8B;AAC9B,MAAM,SAAS,GAAG,CAAC,IAAU,EAAsB,EAAE,CAAC,IAAI,CAAC,IAA0B,CAAC;AAEtF,oCAAoC;AACpC,MAAM,QAAQ,GAAG,CAAC,IAAU,EAAoC,EAAE,CAChE,IAAI,CAAC,mBAAuD,CAAC;AAE/D,4CAA4C;AAC5C,MAAM,gBAAgB,GAAG,CAAC,IAAU,EAA8B,EAAE,CAClE,IAAI,CAAC,SAAuC,CAAC;AAE/C,2CAA2C;AAC3C,MAAM,SAAS,GAAG,CAAC,IAAU,EAAkB,EAAE,CAC9C,IAAI,CAAC,SAAwC,IAAI,MAAM,CAAC;AAE3D,gFAAgF;AAChF,+CAA+C;AAC/C,gFAAgF;AAEhF;;;GAGG;AACH,SAAS,0BAA0B,CAAC,IAAU;IAC5C,OAAO;QACL,SAAS,EAAE,GAAG,CAAC,IAAI,EAAE,WAAW,CAAC;QACjC,MAAM,EAAE,GAAG,CAAC,IAAI,EAAE,QAAQ,CAAC;QAC3B,IAAI,EAAE,SAAS,CAAC,IAAI,CAAC;KACtB,CAAC;AACJ,CAAC;AAED;;;GAGG;AACH,SAAS,+BAA+B,CAAC,IAAU;IACjD,OAAO;QACL,SAAS,EAAE,MAAM,CAAC,IAAI,EAAE,WAAW,CAAC;QACpC,MAAM,EAAE,GAAG,CAAC,IAAI,EAAE,QAAQ,CAAC;QAC3B,IAAI,EAAE,SAAS,CAAC,IAAI,CAAC;KACtB,CAAC;AACJ,CAAC;AAED;;;GAGG;AACH,SAAS,sBAAsB,CAAC,IAAU;IACxC,OAAO;QACL,cAAc,EAAE,GAAG,CAAC,IAAI,EAAE,gBAAgB,CAAC;QAC3C,mCAAmC,EAAE,MAAM,CAAC,IAAI,EAAE,qCAAqC,CAAC;QACxF,iDAAiD,EAAE,MAAM,CAAC,IAAI,EAAE,mDAAmD,CAAC;QACpH,uBAAuB,EAAE,MAAM,CAAC,IAAI,EAAE,yBAAyB,CAAC;QAChE,UAAU,EAAE,MAAM,CAAC,IAAI,EAAE,YAAY,CAAC;KACvC,CAAC;AACJ,CAAC;AAED;;;GAGG;AACH,SAAS,gCAAgC,CAAC,IAAU;IAClD,OAAO;QACL,uBAAuB,EAAE,MAAM,CAAC,IAAI,EAAE,yBAAyB,CAAC;QAChE,iDAAiD,EAAE,MAAM,CAAC,IAAI,EAAE,mDAAmD,CAAC;QACpH,UAAU,EAAE,MAAM,CAAC,IAAI,EAAE,YAAY,CAAC;KACvC,CAAC;AACJ,CAAC;AAED;;;GAGG;AACH,SAAS,4BAA4B,CAAC,IAAU;IAC9C,OAAO;QACL,mBAAmB,EAAE,QAAQ,CAAC,IAAI,CAAC;QACnC,aAAa,EAAE,MAAM,CAAC,IAAI,EAAE,eAAe,CAAC;KAC7C,CAAC;AACJ,CAAC;AAED;;;GAGG;AACH,SAAS,yBAAyB,CAAC,IAAU;IAC3C,OAAO;QACL,SAAS,EAAE,MAAM,CAAC,IAAI,EAAE,WAAW,CAAC;QACpC,+BAA+B,EAAE,MAAM,CAAC,IAAI,EAAE,iCAAiC,CAAC;QAChF,+BAA+B,EAAE,MAAM,CAAC,IAAI,EAAE,iCAAiC,CAAC;KACjF,CAAC;AACJ,CAAC;AAED,gFAAgF;AAChF,8DAA8D;AAC9D,gFAAgF;AAEhF;;;;;GAKG;AACH,SAAgB,sBAAsB,CAAC,IAAU;IAC/C,OAAO,0BAA0B,CAAC,IAAI,CAAC,CAAC;AAC1C,CAAC;AAED;;;;;;;GAOG;AACH,SAAgB,gBAAgB,CAAC,IAAU;IACzC,OAAO;QACL,GAAG,0BAA0B,CAAC,IAAI,CAAC;QACnC,GAAG,sBAAsB,CAAC,IAAI,CAAC;KAChC,CAAC;AACJ,CAAC;AAED;;;GAGG;AACU,QAAA,cAAc,GAAG,gBAAgB,CAAC;AAE/C;;;GAGG;AACU,QAAA,eAAe,GAAG,gBAAgB,CAAC;AAEhD;;;;;GAKG;AACH,SAAgB,2BAA2B,CAAC,IAAU;IACpD,OAAO,+BAA+B,CAAC,IAAI,CAAC,CAAC;AAC/C,CAAC;AAED;;;;;;;GAOG;AACH,SAAgB,oBAAoB,CAAC,IAAU;IAC7C,OAAO;QACL,GAAG,+BAA+B,CAAC,IAAI,CAAC;QACxC,GAAG,yBAAyB,CAAC,IAAI,CAAC;KACnC,CAAC;AACJ,CAAC;AAED;;;;;;;GAOG;AACH,SAAgB,qBAAqB,CAAC,IAAU;IAC9C,OAAO;QACL,SAAS,EAAE,GAAG,CAAC,IAAI,EAAE,WAAW,CAAC;QACjC,GAAG,gCAAgC,CAAC,IAAI,CAAC;QACzC,GAAG,4BAA4B,CAAC,IAAI,CAAC;KACtC,CAAC;AACJ,CAAC;AAED;;;;;GAKG;AACH,SAAgB,yBAAyB,CAAC,IAAU;IAClD,uDAAuD;IACvD,IAAI,IAAI,CAAC,mBAAmB,IAAI,IAAI,CAAC,aAAa,EAAE,CAAC;QACnD,OAAO;YACL,SAAS,EAAE,GAAG,CAAC,IAAI,EAAE,WAAW,CAAC;YACjC,GAAG,4BAA4B,CAAC,IAAI,CAAC;SACtC,CAAC;IACJ,CAAC;IACD,OAAO,GAAG,CAAC,IAAI,EAAE,WAAW,CAAC,CAAC;AAChC,CAAC;AAED;;;;;;;;;GASG;AACH,SAAgB,uBAAuB,CACrC,IAAU,EACV,UAA2C;IAS3C,OAAO;QACL,SAAS,EAAE,MAAM,CAAC,IAAI,EAAE,WAAW,CAAC;QACpC,SAAS,EAAE,gBAAgB,CAAC,IAAI,CAAC;QACjC,WAAW,EAAE,MAAM,CAAC,IAAI,EAAE,aAAa,CAAC;QACxC,GAAG,UAAU;QACb,SAAS,EAAE,SAAS,CAAC,IAAI,CAAC;KAC3B,CAAC;AACJ,CAAC"}

package/dist/tools/trading/helpers/index.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Trading Helpers Module
+ *
+ * Exports shared schemas and argument extractors for trading tools.
+ */
+export * from './trading-schemas.js';
+export * from './arg-extractors.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/tools/trading/helpers/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/tools/trading/helpers/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,cAAc,sBAAsB,CAAC;AACrC,cAAc,qBAAqB,CAAC"}

package/dist/tools/trading/helpers/index.js

@@ -0,0 +1,24 @@
+"use strict";
+/**
+ * Trading Helpers Module
+ *
+ * Exports shared schemas and argument extractors for trading tools.
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./trading-schemas.js"), exports);
+__exportStar(require("./arg-extractors.js"), exports);
+//# sourceMappingURL=index.js.map

package/dist/tools/trading/helpers/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/tools/trading/helpers/index.ts"],"names":[],"mappings":";AAAA;;;;GAIG;;;;;;;;;;;;;;;;AAEH,uDAAqC;AACrC,sDAAoC"}

package/dist/tools/trading/helpers/trading-schemas.d.ts

@@ -0,0 +1,276 @@
+/**
+ * Trading Tool Schema Helpers
+ *
+ * Shared schemas for trading operations to eliminate DRY violations.
+ * These schemas are used across buy, sell, calculate, and graduation tools.
+ */
+/**
+ * Trade type schema for BUY calculations
+ *
+ * @description Specifies how to interpret the amount when buying tokens
+ * - native: Amount is GALA to spend
+ * - exact: Amount is tokens to receive
+ */
+export declare const BUY_CALCULATION_TYPE_SCHEMA: {
+    description: string;
+    type: "string";
+    enum: ("exact" | "native")[];
+};
+/**
+ * Trade type schema for SELL calculations
+ *
+ * @description Specifies how to interpret the amount when selling tokens
+ * - native: Amount is GALA to receive
+ * - exact: Amount is tokens to sell
+ */
+export declare const SELL_CALCULATION_TYPE_SCHEMA: {
+    description: string;
+    type: "string";
+    enum: ("exact" | "native")[];
+};
+/**
+ * Trade type schema for BUY execution (must match calculation)
+ */
+export declare const BUY_EXECUTION_TYPE_SCHEMA: {
+    description: string;
+    type: "string";
+    enum: ("exact" | "native")[];
+};
+/**
+ * Trade type schema for SELL execution (must match calculation)
+ */
+export declare const SELL_EXECUTION_TYPE_SCHEMA: {
+    description: string;
+    type: "string";
+    enum: ("exact" | "native")[];
+};
+/**
+ * Trade type schema for local calculations (compact)
+ */
+export declare const LOCAL_BUY_TYPE_SCHEMA: {
+    description: string;
+    type: "string";
+    enum: ("exact" | "native")[];
+};
+/**
+ * Trade type schema for local sell calculations (compact)
+ */
+export declare const LOCAL_SELL_TYPE_SCHEMA: {
+    description: string;
+    type: "string";
+    enum: ("exact" | "native")[];
+};
+/**
+ * Generic trade amount schema
+ */
+export declare const TRADE_AMOUNT_SCHEMA: {
+    description: string;
+};
+/**
+ * Expected amount schema for BUY execution
+ *
+ * @description The expected token output from calculateBuyAmount
+ */
+export declare const EXPECTED_BUY_AMOUNT_SCHEMA: {
+    description: string;
+};
+/**
+ * Expected amount schema for SELL execution
+ *
+ * @description The expected GALA output from calculateSellAmount
+ */
+export declare const EXPECTED_SELL_AMOUNT_SCHEMA: {
+    description: string;
+};
+/**
+ * Max acceptable reverse bonding curve fee schema for BUY
+ */
+export declare const BUY_RBC_FEE_SCHEMA: {
+    description: string;
+};
+/**
+ * Max acceptable reverse bonding curve fee schema for SELL
+ */
+export declare const SELL_RBC_FEE_SCHEMA: {
+    description: string;
+};
+/**
+ * Common calculation input properties (tokenName, amount, type)
+ * Used by all calculate* tools
+ */
+export declare const CALCULATION_INPUT_PROPERTIES: {
+    tokenName: Record<string, unknown>;
+    amount: {
+        description: string;
+    };
+};
+/**
+ * Trade execution slippage properties (fee slippage, output slippage, wallet)
+ * Shared by buy, sell, and graduate tools
+ */
+export declare const TRADE_EXECUTION_PROPERTIES: {
+    maxAcceptableReverseBondingCurveFeeSlippageFactor: {
+        type: "number";
+        minimum: number;
+        maximum: number;
+        description: string;
+    };
+    slippageToleranceFactor: {
+        type: "number";
+        minimum: number;
+        maximum: number;
+        description: string;
+    };
+    privateKey: Record<string, unknown>;
+};
+/**
+ * RBC fee properties for buy execution (includes base fee + slippage)
+ */
+export declare const BUY_RBC_EXECUTION_PROPERTIES: {
+    maxAcceptableReverseBondingCurveFeeSlippageFactor: {
+        type: "number";
+        minimum: number;
+        maximum: number;
+        description: string;
+    };
+    slippageToleranceFactor: {
+        type: "number";
+        minimum: number;
+        maximum: number;
+        description: string;
+    };
+    privateKey: Record<string, unknown>;
+    maxAcceptableReverseBondingCurveFee: {
+        description: string;
+    };
+};
+/**
+ * RBC fee properties for sell execution (includes base fee + slippage)
+ */
+export declare const SELL_RBC_EXECUTION_PROPERTIES: {
+    maxAcceptableReverseBondingCurveFeeSlippageFactor: {
+        type: "number";
+        minimum: number;
+        maximum: number;
+        description: string;
+    };
+    slippageToleranceFactor: {
+        type: "number";
+        minimum: number;
+        maximum: number;
+        description: string;
+    };
+    privateKey: Record<string, unknown>;
+    maxAcceptableReverseBondingCurveFee: {
+        description: string;
+    };
+};
+/**
+ * Graduation-specific optional properties
+ */
+export declare const GRADUATION_OPTIONAL_PROPERTIES: {
+    calculateAmountMode: {
+        type: "string";
+        enum: string[];
+        description: string;
+    };
+    currentSupply: {
+        description: string;
+    };
+};
+/**
+ * Local sell calculation additional properties
+ */
+export declare const LOCAL_SELL_PROPERTIES: {
+    maxSupply: {
+        description: string;
+    };
+    reverseBondingCurveMinFeeFactor: {
+        type: "number";
+        minimum: number;
+        maximum: number;
+        description: string;
+    };
+    reverseBondingCurveMaxFeeFactor: {
+        type: "number";
+        minimum: number;
+        maximum: number;
+        description: string;
+    };
+};
+/**
+ * Configuration for creating a trade execution tool schema.
+ *
+ * This factory eliminates duplication between buy and sell execution tools,
+ * which share nearly identical structures with only minor differences in
+ * type schemas and RBC fee descriptions.
+ */
+export interface TradeExecutionToolConfig {
+    /** Trade direction: 'buy' or 'sell' */
+    direction: 'buy' | 'sell';
+}
+/**
+ * Factory function to create trade execution tool inputSchema.
+ *
+ * Generates consistent inputSchema for buy/sell execution tools.
+ * Both tools share: tokenName, amount, type, expectedAmount, and RBC execution properties.
+ * The direction determines which type schema and expected amount schema to use.
+ *
+ * @param config - Configuration with trade direction
+ * @returns Object containing inputSchema definition
+ *
+ * @example
+ * const buySchema = createTradeExecutionSchema({ direction: 'buy' });
+ * const sellSchema = createTradeExecutionSchema({ direction: 'sell' });
+ *
+ * @since 6.10.0
+ */
+export declare function createTradeExecutionSchema(config: TradeExecutionToolConfig): {
+    type: 'object';
+    properties: Record<string, unknown>;
+    required: string[];
+};
+/**
+ * Configuration for creating a bonding curve calculation tool.
+ *
+ * This factory eliminates duplication between the 4 local/external calculation tools:
+ * - calculateBuyAmountLocal, calculateBuyAmountExternal
+ * - calculateSellAmountLocal, calculateSellAmountExternal
+ */
+export interface BondingCurveCalculationToolConfig {
+    /** Tool name (e.g., 'gala_launchpad_calculate_buy_amount_local') */
+    name: string;
+    /** Tool description */
+    description: string;
+    /** Trade direction: 'buy' or 'sell' */
+    direction: 'buy' | 'sell';
+    /** Calculation mode: 'local' (client-side) or 'external' (GalaChain network) */
+    mode: 'local' | 'external';
+    /** Whether to include additional local sell properties (maxSupply, fee factors) */
+    includeLocalSellProperties?: boolean;
+}
+/**
+ * Factory function to create bonding curve calculation tool configurations.
+ *
+ * Generates consistent inputSchema and required fields for calculation tools.
+ * The actual handler still needs to be created separately using createSimpleHandler.
+ *
+ * @param config - Configuration for the calculation tool
+ * @returns Object containing inputSchema and required fields
+ *
+ * @example
+ * const { inputSchema, required } = createCalculationToolSchema({
+ *   name: 'gala_launchpad_calculate_buy_amount_local',
+ *   description: 'Calculate buy amounts locally',
+ *   direction: 'buy',
+ *   mode: 'local',
+ * });
+ */
+export declare function createCalculationToolSchema(config: BondingCurveCalculationToolConfig): {
+    inputSchema: {
+        type: 'object';
+        properties: Record<string, unknown>;
+        required: string[];
+    };
+};
+//# sourceMappingURL=trading-schemas.d.ts.map

package/dist/tools/trading/helpers/trading-schemas.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"trading-schemas.d.ts","sourceRoot":"","sources":["../../../../src/tools/trading/helpers/trading-schemas.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAyBH;;;;;;GAMG;AACH,eAAO,MAAM,2BAA2B;;;;CAWvC,CAAC;AAEF;;;;;;GAMG;AACH,eAAO,MAAM,4BAA4B;;;;CAWxC,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,yBAAyB;;;;CAMrC,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,0BAA0B;;;;CAMtC,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,qBAAqB;;;;CAKjC,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,sBAAsB;;;;CAKlC,CAAC;AAMF;;GAEG;AACH,eAAO,MAAM,mBAAmB;;CAG/B,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,0BAA0B;;CAgBtC,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,2BAA2B;;CAgBvC,CAAC;AAMF;;GAEG;AACH,eAAO,MAAM,kBAAkB;;CAG9B,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,mBAAmB;;CAG/B,CAAC;AAMF;;;GAGG;AACH,eAAO,MAAM,4BAA4B;;;;;CAGxC,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,0BAA0B;;;;;;;;;;;;;;CAItC,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,4BAA4B;;;;;;;;;;;;;;;;;CAGxC,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,6BAA6B;;;;;;;;;;;;;;;;;CAGzC,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,8BAA8B;;;;;;;;;CAG1C,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;;;;CAiBjC,CAAC;AAMF;;;;;;GAMG;AACH,MAAM,WAAW,wBAAwB;IACvC,uCAAuC;IACvC,SAAS,EAAE,KAAK,GAAG,MAAM,CAAC;CAC3B;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,0BAA0B,CAAC,MAAM,EAAE,wBAAwB,GAAG;IAC5E,IAAI,EAAE,QAAQ,CAAC;IACf,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACpC,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB,CAoBA;AAMD;;;;;;GAMG;AACH,MAAM,WAAW,iCAAiC;IAChD,oEAAoE;IACpE,IAAI,EAAE,MAAM,CAAC;IACb,uBAAuB;IACvB,WAAW,EAAE,MAAM,CAAC;IACpB,uCAAuC;IACvC,SAAS,EAAE,KAAK,GAAG,MAAM,CAAC;IAC1B,gFAAgF;IAChF,IAAI,EAAE,OAAO,GAAG,UAAU,CAAC;IAC3B,mFAAmF;IACnF,0BAA0B,CAAC,EAAE,OAAO,CAAC;CACtC;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,2BAA2B,CAAC,MAAM,EAAE,iCAAiC,GAAG;IACtF,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ,CAAC;QACf,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QACpC,QAAQ,EAAE,MAAM,EAAE,CAAC;KACpB,CAAC;CACH,CA4BA"}