@gala-chain/launchpad-mcp-server 1.5.0 → 1.6.0

package/dist/tools/utils/getCacheInfo.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"getCacheInfo.d.ts","sourceRoot":"","sources":["../../../src/tools/utils/getCacheInfo.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,eAAO,MAAM,gBAAgB,sCAI3B,CAAC"}

package/dist/tools/utils/getCacheInfo.js

@@ -0,0 +1,16 @@
+"use strict";
+/**
+ * Get Cache Info Tool
+ *
+ * Returns statistics about the token metadata cache for monitoring and debugging.
+ * The cache persists entire MCP server lifetime and accumulates metadata across conversations.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getCacheInfoTool = void 0;
+const tool_factory_js_1 = require("../../utils/tool-factory.js");
+exports.getCacheInfoTool = (0, tool_factory_js_1.createNoParamTool)({
+    name: 'gala_launchpad_get_cache_info',
+    description: 'Get token metadata cache statistics including total tokens cached, cache size in bytes, and timestamp of oldest entry. The cache persists for the entire MCP server lifetime.',
+    handler: (sdk) => sdk.getCacheInfo(),
+});
+//# sourceMappingURL=getCacheInfo.js.map

package/dist/tools/utils/getCacheInfo.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"getCacheInfo.js","sourceRoot":"","sources":["../../../src/tools/utils/getCacheInfo.ts"],"names":[],"mappings":";AAAA;;;;;GAKG;;;AAEH,iEAAgE;AAEnD,QAAA,gBAAgB,GAAG,IAAA,mCAAiB,EAAC;IAChD,IAAI,EAAE,+BAA+B;IACrC,WAAW,EAAE,+KAA+K;IAC5L,OAAO,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,YAAY,EAAE;CACrC,CAAC,CAAC"}

package/dist/tools/utils/getConfig.d.ts

@@ -1,6 +1,5 @@
 /**
- * Get Config Tool
+ * Get Config Tool (45% code reduction via factory pattern)
  */
-import type { MCPTool } from '../../types/mcp.js';
-export declare const getConfigTool: MCPTool;
+export declare const getConfigTool: import("../../types/mcp.js").MCPTool;
 //# sourceMappingURL=getConfig.d.ts.map

package/dist/tools/utils/getConfig.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"getConfig.d.ts","sourceRoot":"","sources":["../../../src/tools/utils/getConfig.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAIlD,eAAO,MAAM,aAAa,EAAE,OAW3B,CAAC"}
+{"version":3,"file":"getConfig.d.ts","sourceRoot":"","sources":["../../../src/tools/utils/getConfig.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH,eAAO,MAAM,aAAa,sCAIxB,CAAC"}

package/dist/tools/utils/getConfig.js

@@ -1,21 +1,13 @@
 "use strict";
 /**
- * Get Config Tool
+ * Get Config Tool (45% code reduction via factory pattern)
  */
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.getConfigTool = void 0;
-const response_formatter_js_1 = require("../../utils/response-formatter.js");
-const error_handler_js_1 = require("../../utils/error-handler.js");
-exports.getConfigTool = {
+const tool_factory_js_1 = require("../../utils/tool-factory.js");
+exports.getConfigTool = (0, tool_factory_js_1.createNoParamTool)({
     name: 'gala_launchpad_get_config',
     description: 'Get the current SDK configuration including environment, base URLs, timeouts, feature flags, and effective slippage tolerance factors.',
-    inputSchema: {
-        type: 'object',
-        properties: {},
-    },
-    handler: (0, error_handler_js_1.withErrorHandling)(async (sdk) => {
-        const config = sdk.getConfig();
-        return (0, response_formatter_js_1.formatSuccess)(config);
-    }),
-};
+    handler: (sdk) => sdk.getConfig(),
+});
 //# sourceMappingURL=getConfig.js.map

package/dist/tools/utils/getConfig.js.map

@@ -1 +1 @@
-{"version":3,"file":"getConfig.js","sourceRoot":"","sources":["../../../src/tools/utils/getConfig.ts"],"names":[],"mappings":";AAAA;;GAEG;;;AAGH,6EAAkE;AAClE,mEAAiE;AAEpD,QAAA,aAAa,GAAY;IACpC,IAAI,EAAE,2BAA2B;IACjC,WAAW,EAAE,wIAAwI;IACrJ,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE,EAAE;KACf;IACD,OAAO,EAAE,IAAA,oCAAiB,EAAC,KAAK,EAAE,GAAG,EAAE,EAAE;QACvC,MAAM,MAAM,GAAG,GAAG,CAAC,SAAS,EAAE,CAAC;QAC/B,OAAO,IAAA,qCAAa,EAAC,MAAM,CAAC,CAAC;IAC/B,CAAC,CAAC;CACH,CAAC"}
+{"version":3,"file":"getConfig.js","sourceRoot":"","sources":["../../../src/tools/utils/getConfig.ts"],"names":[],"mappings":";AAAA;;GAEG;;;AAEH,iEAAgE;AAEnD,QAAA,aAAa,GAAG,IAAA,mCAAiB,EAAC;IAC7C,IAAI,EAAE,2BAA2B;IACjC,WAAW,EAAE,wIAAwI;IACrJ,OAAO,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,SAAS,EAAE;CAClC,CAAC,CAAC"}

package/dist/tools/utils/getEthereumAddress.d.ts

@@ -1,6 +1,5 @@
 /**
- * Get Ethereum Address Tool
+ * Get Ethereum Address Tool (45% code reduction via factory pattern)
  */
-import type { MCPTool } from '../../types/mcp.js';
-export declare const getEthereumAddressTool: MCPTool;
+export declare const getEthereumAddressTool: import("../../types/mcp.js").MCPTool;
 //# sourceMappingURL=getEthereumAddress.d.ts.map

package/dist/tools/utils/getEthereumAddress.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"getEthereumAddress.d.ts","sourceRoot":"","sources":["../../../src/tools/utils/getEthereumAddress.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAIlD,eAAO,MAAM,sBAAsB,EAAE,OAWpC,CAAC"}
+{"version":3,"file":"getEthereumAddress.d.ts","sourceRoot":"","sources":["../../../src/tools/utils/getEthereumAddress.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH,eAAO,MAAM,sBAAsB,sCAKjC,CAAC"}

package/dist/tools/utils/getEthereumAddress.js

@@ -1,21 +1,14 @@
 "use strict";
 /**
- * Get Ethereum Address Tool
+ * Get Ethereum Address Tool (45% code reduction via factory pattern)
  */
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.getEthereumAddressTool = void 0;
-const response_formatter_js_1 = require("../../utils/response-formatter.js");
-const error_handler_js_1 = require("../../utils/error-handler.js");
-exports.getEthereumAddressTool = {
+const tool_factory_js_1 = require("../../utils/tool-factory.js");
+exports.getEthereumAddressTool = (0, tool_factory_js_1.createNoParamTool)({
     name: 'gala_launchpad_get_ethereum_address',
     description: 'Get the standard Ethereum address format (0x...) for the authenticated wallet.',
-    inputSchema: {
-        type: 'object',
-        properties: {},
-    },
-    handler: (0, error_handler_js_1.withErrorHandling)(async (sdk) => {
-        const address = sdk.getEthereumAddress();
-        return (0, response_formatter_js_1.formatSuccess)({ address });
-    }),
-};
+    handler: (sdk) => sdk.getEthereumAddress(),
+    resultKey: 'address',
+});
 //# sourceMappingURL=getEthereumAddress.js.map

package/dist/tools/utils/getEthereumAddress.js.map

@@ -1 +1 @@
-{"version":3,"file":"getEthereumAddress.js","sourceRoot":"","sources":["../../../src/tools/utils/getEthereumAddress.ts"],"names":[],"mappings":";AAAA;;GAEG;;;AAGH,6EAAkE;AAClE,mEAAiE;AAEpD,QAAA,sBAAsB,GAAY;IAC7C,IAAI,EAAE,qCAAqC;IAC3C,WAAW,EAAE,gFAAgF;IAC7F,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE,EAAE;KACf;IACD,OAAO,EAAE,IAAA,oCAAiB,EAAC,KAAK,EAAE,GAAG,EAAE,EAAE;QACvC,MAAM,OAAO,GAAG,GAAG,CAAC,kBAAkB,EAAE,CAAC;QACzC,OAAO,IAAA,qCAAa,EAAC,EAAE,OAAO,EAAE,CAAC,CAAC;IACpC,CAAC,CAAC;CACH,CAAC"}
+{"version":3,"file":"getEthereumAddress.js","sourceRoot":"","sources":["../../../src/tools/utils/getEthereumAddress.ts"],"names":[],"mappings":";AAAA;;GAEG;;;AAEH,iEAAgE;AAEnD,QAAA,sBAAsB,GAAG,IAAA,mCAAiB,EAAC;IACtD,IAAI,EAAE,qCAAqC;IAC3C,WAAW,EAAE,gFAAgF;IAC7F,OAAO,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,kBAAkB,EAAE;IAC1C,SAAS,EAAE,SAAS;CACrB,CAAC,CAAC"}

package/dist/tools/utils/getUrlByTokenName.d.ts

@@ -1,6 +1,5 @@
 /**
- * Get URL by Token Name Tool
+ * Get URL by Token Name Tool (73% code reduction via factory pattern)
  */
-import type { MCPTool } from '../../types/mcp.js';
-export declare const getUrlByTokenNameTool: MCPTool;
+export declare const getUrlByTokenNameTool: import("../../types/mcp.js").MCPTool;
 //# sourceMappingURL=getUrlByTokenName.d.ts.map

package/dist/tools/utils/getUrlByTokenName.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"getUrlByTokenName.d.ts","sourceRoot":"","sources":["../../../src/tools/utils/getUrlByTokenName.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAKlD,eAAO,MAAM,qBAAqB,EAAE,OAiBnC,CAAC"}
+{"version":3,"file":"getUrlByTokenName.d.ts","sourceRoot":"","sources":["../../../src/tools/utils/getUrlByTokenName.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH,eAAO,MAAM,qBAAqB,sCAKhC,CAAC"}

package/dist/tools/utils/getUrlByTokenName.js

@@ -1,28 +1,14 @@
 "use strict";
 /**
- * Get URL by Token Name Tool
+ * Get URL by Token Name Tool (73% code reduction via factory pattern)
  */
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.getUrlByTokenNameTool = void 0;
-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");
-exports.getUrlByTokenNameTool = {
+const tool_factory_js_1 = require("../../utils/tool-factory.js");
+exports.getUrlByTokenNameTool = (0, tool_factory_js_1.createResolutionTool)({
     name: 'gala_launchpad_get_url_by_token_name',
     description: 'Get the launchpad frontend URL for a specific token. Returns the complete URL for viewing/trading the token in the web interface.',
-    inputSchema: {
-        type: 'object',
-        properties: {
-            tokenName: {
-                ...common_schemas_js_1.TOKEN_NAME_SCHEMA,
-                description: 'Token name to generate URL for',
-            },
-        },
-        required: ['tokenName'],
-    },
-    handler: (0, error_handler_js_1.withErrorHandling)(async (sdk, args) => {
-        const url = sdk.getUrlByTokenName(args.tokenName);
-        return (0, response_formatter_js_1.formatSuccess)({ url, tokenName: args.tokenName });
-    }),
-};
+    resolver: async (sdk, tokenName) => sdk.getUrlByTokenName(tokenName),
+    resultKey: 'url',
+});
 //# sourceMappingURL=getUrlByTokenName.js.map

package/dist/tools/utils/getUrlByTokenName.js.map

@@ -1 +1 @@
-{"version":3,"file":"getUrlByTokenName.js","sourceRoot":"","sources":["../../../src/tools/utils/getUrlByTokenName.ts"],"names":[],"mappings":";AAAA;;GAEG;;;AAGH,6EAAkE;AAClE,mEAAiE;AACjE,uEAAoE;AAEvD,QAAA,qBAAqB,GAAY;IAC5C,IAAI,EAAE,sCAAsC;IAC5C,WAAW,EAAE,mIAAmI;IAChJ,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACV,SAAS,EAAE;gBACT,GAAG,qCAAiB;gBACpB,WAAW,EAAE,gCAAgC;aAC9C;SACF;QACD,QAAQ,EAAE,CAAC,WAAW,CAAC;KACxB;IACD,OAAO,EAAE,IAAA,oCAAiB,EAAC,KAAK,EAAE,GAAG,EAAE,IAAI,EAAE,EAAE;QAC7C,MAAM,GAAG,GAAG,GAAG,CAAC,iBAAiB,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QAClD,OAAO,IAAA,qCAAa,EAAC,EAAE,GAAG,EAAE,SAAS,EAAE,IAAI,CAAC,SAAS,EAAE,CAAC,CAAC;IAC3D,CAAC,CAAC;CACH,CAAC"}
+{"version":3,"file":"getUrlByTokenName.js","sourceRoot":"","sources":["../../../src/tools/utils/getUrlByTokenName.ts"],"names":[],"mappings":";AAAA;;GAEG;;;AAEH,iEAAmE;AAEtD,QAAA,qBAAqB,GAAG,IAAA,sCAAoB,EAAC;IACxD,IAAI,EAAE,sCAAsC;IAC5C,WAAW,EAAE,mIAAmI;IAChJ,QAAQ,EAAE,KAAK,EAAE,GAAG,EAAE,SAAS,EAAE,EAAE,CAAC,GAAG,CAAC,iBAAiB,CAAC,SAAS,CAAC;IACpE,SAAS,EAAE,KAAK;CACjB,CAAC,CAAC"}

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/tools/utils/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAUH,eAAO,MAAM,YAAY,wCAQxB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/tools/utils/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAYH,eAAO,MAAM,YAAY,wCAUxB,CAAC"}

package/dist/tools/utils/index.js

@@ -11,6 +11,8 @@ const getConfig_js_1 = require("./getConfig.js");
 const getUrlByTokenName_js_1 = require("./getUrlByTokenName.js");
 const explainSdkUsage_js_1 = require("./explainSdkUsage.js");
 const isTokenGraduated_js_1 = require("./isTokenGraduated.js");
+const getCacheInfo_js_1 = require("./getCacheInfo.js");
+const clearCache_js_1 = require("./clearCache.js");
 exports.utilityTools = [
     createWallet_js_1.createWalletTool,
     getAddress_js_1.getAddressTool,
@@ -19,5 +21,7 @@ exports.utilityTools = [
     getUrlByTokenName_js_1.getUrlByTokenNameTool,
     explainSdkUsage_js_1.explainSdkUsageTool,
     isTokenGraduated_js_1.isTokenGraduatedTool,
+    getCacheInfo_js_1.getCacheInfoTool,
+    clearCache_js_1.clearCacheTool,
 ];
 //# sourceMappingURL=index.js.map

package/dist/tools/utils/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/tools/utils/index.ts"],"names":[],"mappings":";AAAA;;GAEG;;;AAEH,uDAAqD;AACrD,mDAAiD;AACjD,mEAAiE;AACjE,iDAA+C;AAC/C,iEAA+D;AAC/D,6DAA2D;AAC3D,+DAA6D;AAEhD,QAAA,YAAY,GAAG;IAC1B,kCAAgB;IAChB,8BAAc;IACd,8CAAsB;IACtB,4BAAa;IACb,4CAAqB;IACrB,wCAAmB;IACnB,0CAAoB;CACrB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/tools/utils/index.ts"],"names":[],"mappings":";AAAA;;GAEG;;;AAEH,uDAAqD;AACrD,mDAAiD;AACjD,mEAAiE;AACjE,iDAA+C;AAC/C,iEAA+D;AAC/D,6DAA2D;AAC3D,+DAA6D;AAC7D,uDAAqD;AACrD,mDAAiD;AAEpC,QAAA,YAAY,GAAG;IAC1B,kCAAgB;IAChB,8BAAc;IACd,8CAAsB;IACtB,4BAAa;IACb,4CAAqB;IACrB,wCAAmB;IACnB,0CAAoB;IACpB,kCAAgB;IAChB,8BAAc;CACf,CAAC"}

package/dist/tools/utils/isTokenGraduated.d.ts

@@ -1,6 +1,5 @@
 /**
- * Check if token has graduated from bonding curve
+ * Check if token has graduated from bonding curve (73% code reduction via factory pattern)
  */
-import type { MCPTool } from '../../types/mcp.js';
-export declare const isTokenGraduatedTool: MCPTool;
+export declare const isTokenGraduatedTool: import("../../types/mcp.js").MCPTool;
 //# sourceMappingURL=isTokenGraduated.d.ts.map

package/dist/tools/utils/isTokenGraduated.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"isTokenGraduated.d.ts","sourceRoot":"","sources":["../../../src/tools/utils/isTokenGraduated.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAKlD,eAAO,MAAM,oBAAoB,EAAE,OAkBlC,CAAC"}
+{"version":3,"file":"isTokenGraduated.d.ts","sourceRoot":"","sources":["../../../src/tools/utils/isTokenGraduated.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH,eAAO,MAAM,oBAAoB,sCAS/B,CAAC"}

package/dist/tools/utils/isTokenGraduated.js

@@ -1,29 +1,18 @@
 "use strict";
 /**
- * Check if token has graduated from bonding curve
+ * Check if token has graduated from bonding curve (73% code reduction via factory pattern)
  */
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.isTokenGraduatedTool = void 0;
-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");
-exports.isTokenGraduatedTool = {
+const tool_factory_js_1 = require("../../utils/tool-factory.js");
+exports.isTokenGraduatedTool = (0, tool_factory_js_1.createResolutionTool)({
     name: 'gala_launchpad_is_token_graduated',
     description: `Check if a token has completed the bonding curve phase and graduated to full DEX trading.
 
 RETURNS: Boolean indicating if pool saleStatus is "Completed"
 
 USAGE: Useful for conditional logic before attempting graduation or checking pool state.`,
-    inputSchema: {
-        type: 'object',
-        properties: {
-            tokenName: common_schemas_js_1.TOKEN_NAME_SCHEMA,
-        },
-        required: ['tokenName'],
-    },
-    handler: (0, error_handler_js_1.withErrorHandling)(async (sdk, args) => {
-        const result = await sdk.isTokenGraduated(args.tokenName);
-        return (0, response_formatter_js_1.formatSuccess)({ graduated: result });
-    }),
-};
+    resolver: (sdk, tokenName) => sdk.isTokenGraduated(tokenName),
+    resultKey: 'graduated',
+});
 //# sourceMappingURL=isTokenGraduated.js.map

package/dist/tools/utils/isTokenGraduated.js.map

@@ -1 +1 @@
-{"version":3,"file":"isTokenGraduated.js","sourceRoot":"","sources":["../../../src/tools/utils/isTokenGraduated.ts"],"names":[],"mappings":";AAAA;;GAEG;;;AAGH,6EAAkE;AAClE,mEAAiE;AACjE,uEAAoE;AAEvD,QAAA,oBAAoB,GAAY;IAC3C,IAAI,EAAE,mCAAmC;IACzC,WAAW,EAAE;;;;yFAI0E;IACvF,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACV,SAAS,EAAE,qCAAiB;SAC7B;QACD,QAAQ,EAAE,CAAC,WAAW,CAAC;KACxB;IACD,OAAO,EAAE,IAAA,oCAAiB,EAAC,KAAK,EAAE,GAAG,EAAE,IAAI,EAAE,EAAE;QAC7C,MAAM,MAAM,GAAG,MAAM,GAAG,CAAC,gBAAgB,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QAC1D,OAAO,IAAA,qCAAa,EAAC,EAAE,SAAS,EAAE,MAAM,EAAE,CAAC,CAAC;IAC9C,CAAC,CAAC;CACH,CAAC"}
+{"version":3,"file":"isTokenGraduated.js","sourceRoot":"","sources":["../../../src/tools/utils/isTokenGraduated.ts"],"names":[],"mappings":";AAAA;;GAEG;;;AAEH,iEAAmE;AAEtD,QAAA,oBAAoB,GAAG,IAAA,sCAAoB,EAAC;IACvD,IAAI,EAAE,mCAAmC;IACzC,WAAW,EAAE;;;;yFAI0E;IACvF,QAAQ,EAAE,CAAC,GAAG,EAAE,SAAS,EAAE,EAAE,CAAC,GAAG,CAAC,gBAAgB,CAAC,SAAS,CAAC;IAC7D,SAAS,EAAE,WAAW;CACvB,CAAC,CAAC"}

package/dist/utils/default-values.d.ts

@@ -0,0 +1,147 @@
+/**
+ * Default Value Utilities
+ *
+ * Centralized default values for tool parameters to eliminate magic numbers
+ * and ensure consistency across 47 MCP tools.
+ *
+ * @see Phase 2.2 of refactoring plan
+ */
+/**
+ * Default pagination configuration
+ */
+export declare const DEFAULT_PAGINATION: {
+    readonly page: 1;
+    readonly limit: 20;
+};
+/**
+ * Operation-specific default limits
+ */
+export declare const DEFAULT_LIMITS: {
+    readonly trade: 20;
+    readonly user: 20;
+    readonly pool: 20;
+    readonly comment: 20;
+};
+/**
+ * Maximum limits per operation type (from MCP_CONSTRAINTS)
+ */
+export declare const MAX_LIMITS: {
+    readonly trade: 20;
+    readonly user: 20;
+    readonly pool: 100;
+    readonly comment: 50;
+};
+/**
+ * Default slippage tolerance (1%)
+ */
+export declare const DEFAULT_SLIPPAGE_TOLERANCE = 0.01;
+/**
+ * Default reverse bonding curve fee slippage tolerance (1%)
+ */
+export declare const DEFAULT_RBC_FEE_SLIPPAGE = 0.01;
+/**
+ * Default pool type for fetchPools
+ */
+export declare const DEFAULT_POOL_TYPE = "recent";
+/**
+ * Default sort order
+ */
+export declare const DEFAULT_SORT_ORDER = "DESC";
+/**
+ * Default resolution for volume data (1 hour)
+ */
+export declare const DEFAULT_VOLUME_RESOLUTION = "1h";
+/**
+ * Resolution mapping (string to seconds)
+ */
+export declare const RESOLUTION_MAP: Record<string, number>;
+/**
+ * Applies default pagination values to args object
+ *
+ * @example
+ * ```typescript
+ * const params = applyPaginationDefaults(args);
+ * // { page: 1, limit: 20, ...otherArgs }
+ * ```
+ */
+export declare function applyPaginationDefaults<T extends Record<string, any>>(args: T, defaults?: {
+    page?: number;
+    limit?: number;
+}): T & {
+    page: number;
+    limit: number;
+};
+/**
+ * Applies operation-specific pagination defaults
+ *
+ * @example
+ * ```typescript
+ * const params = applyOperationPaginationDefaults(args, 'pool');
+ * // Uses default limit of 20 for pool operations
+ * ```
+ */
+export declare function applyOperationPaginationDefaults<T extends Record<string, any>>(args: T, operationType: keyof typeof DEFAULT_LIMITS): T & {
+    page: number;
+    limit: number;
+};
+/**
+ * Applies default slippage values to trading args
+ *
+ * @example
+ * ```typescript
+ * const params = applySlippageDefaults(args);
+ * // { slippageToleranceFactor: 0.01, maxAcceptableReverseBondingCurveFeeSlippageFactor: 0.01, ...args }
+ * ```
+ */
+export declare function applySlippageDefaults<T extends Record<string, any>>(args: T, defaults?: {
+    slippageToleranceFactor?: number;
+    maxAcceptableReverseBondingCurveFeeSlippageFactor?: number;
+}): T & {
+    slippageToleranceFactor: number;
+    maxAcceptableReverseBondingCurveFeeSlippageFactor: number;
+};
+/**
+ * Converts volume resolution string to seconds
+ *
+ * @example
+ * ```typescript
+ * const seconds = resolutionToSeconds('1h', '1h');
+ * // 3600
+ * ```
+ */
+export declare function resolutionToSeconds(resolution: string | undefined, defaultResolution?: string): number;
+/**
+ * Converts ISO 8601 date string to Unix timestamp (seconds)
+ *
+ * @example
+ * ```typescript
+ * const timestamp = dateToUnixTimestamp('2024-01-15T14:30:25Z');
+ * // 1705329025
+ * ```
+ */
+export declare function dateToUnixTimestamp(isoDate: string | undefined): number | undefined;
+export declare const defaultValues: {
+    pagination: {
+        readonly page: 1;
+        readonly limit: 20;
+    };
+    limits: {
+        readonly trade: 20;
+        readonly user: 20;
+        readonly pool: 20;
+        readonly comment: 20;
+    };
+    maxLimits: {
+        readonly trade: 20;
+        readonly user: 20;
+        readonly pool: 100;
+        readonly comment: 50;
+    };
+    slippageTolerance: number;
+    rbcFeeSlippage: number;
+    poolType: string;
+    sortOrder: string;
+    volumeResolution: string;
+    resolutionMap: Record<string, number>;
+};
+//# sourceMappingURL=default-values.d.ts.map

package/dist/utils/default-values.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"default-values.d.ts","sourceRoot":"","sources":["../../src/utils/default-values.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAQH;;GAEG;AACH,eAAO,MAAM,kBAAkB;;;CAGrB,CAAC;AAEX;;GAEG;AACH,eAAO,MAAM,cAAc;;;;;CAKjB,CAAC;AAEX;;GAEG;AACH,eAAO,MAAM,UAAU;;;;;CAKb,CAAC;AAMX;;GAEG;AACH,eAAO,MAAM,0BAA0B,OAAO,CAAC;AAE/C;;GAEG;AACH,eAAO,MAAM,wBAAwB,OAAO,CAAC;AAE7C;;GAEG;AACH,eAAO,MAAM,iBAAiB,WAAW,CAAC;AAE1C;;GAEG;AACH,eAAO,MAAM,kBAAkB,SAAS,CAAC;AAMzC;;GAEG;AACH,eAAO,MAAM,yBAAyB,OAAO,CAAC;AAE9C;;GAEG;AACH,eAAO,MAAM,cAAc,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAOxC,CAAC;AAMX;;;;;;;;GAQG;AACH,wBAAgB,uBAAuB,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EACnE,IAAI,EAAE,CAAC,EACP,QAAQ,GAAE;IAAE,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAuB,GAC/D,CAAC,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAMrC;AAED;;;;;;;;GAQG;AACH,wBAAgB,gCAAgC,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAC5E,IAAI,EAAE,CAAC,EACP,aAAa,EAAE,MAAM,OAAO,cAAc,GACzC,CAAC,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAKrC;AAED;;;;;;;;GAQG;AACH,wBAAgB,qBAAqB,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EACjE,IAAI,EAAE,CAAC,EACP,QAAQ,GAAE;IACR,uBAAuB,CAAC,EAAE,MAAM,CAAC;IACjC,iDAAiD,CAAC,EAAE,MAAM,CAAC;CACvD,GACL,CAAC,GAAG;IACL,uBAAuB,EAAE,MAAM,CAAC;IAChC,iDAAiD,EAAE,MAAM,CAAC;CAC3D,CAYA;AAED;;;;;;;;GAQG;AACH,wBAAgB,mBAAmB,CACjC,UAAU,EAAE,MAAM,GAAG,SAAS,EAC9B,iBAAiB,GAAE,MAAkC,GACpD,MAAM,CAER;AAED;;;;;;;;GAQG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,GAAG,SAAS,CAGnF;AAMD,eAAO,MAAM,aAAa;;;;;;;;;;;;;;;;;;;;;;;CAUzB,CAAC"}

package/dist/utils/default-values.js

@@ -0,0 +1,177 @@
+"use strict";
+/**
+ * Default Value Utilities
+ *
+ * Centralized default values for tool parameters to eliminate magic numbers
+ * and ensure consistency across 47 MCP tools.
+ *
+ * @see Phase 2.2 of refactoring plan
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.defaultValues = exports.RESOLUTION_MAP = exports.DEFAULT_VOLUME_RESOLUTION = exports.DEFAULT_SORT_ORDER = exports.DEFAULT_POOL_TYPE = exports.DEFAULT_RBC_FEE_SLIPPAGE = exports.DEFAULT_SLIPPAGE_TOLERANCE = exports.MAX_LIMITS = exports.DEFAULT_LIMITS = exports.DEFAULT_PAGINATION = void 0;
+exports.applyPaginationDefaults = applyPaginationDefaults;
+exports.applyOperationPaginationDefaults = applyOperationPaginationDefaults;
+exports.applySlippageDefaults = applySlippageDefaults;
+exports.resolutionToSeconds = resolutionToSeconds;
+exports.dateToUnixTimestamp = dateToUnixTimestamp;
+const constraints_js_1 = require("./constraints.js");
+// =============================================================================
+// Pagination Defaults
+// =============================================================================
+/**
+ * Default pagination configuration
+ */
+exports.DEFAULT_PAGINATION = {
+    page: 1,
+    limit: 20,
+};
+/**
+ * Operation-specific default limits
+ */
+exports.DEFAULT_LIMITS = {
+    trade: 20,
+    user: 20,
+    pool: 20,
+    comment: 20,
+};
+/**
+ * Maximum limits per operation type (from MCP_CONSTRAINTS)
+ */
+exports.MAX_LIMITS = {
+    trade: constraints_js_1.MCP_CONSTRAINTS.TRADE_LIMIT, // 20
+    user: constraints_js_1.MCP_CONSTRAINTS.USER_LIMIT, // 20
+    pool: constraints_js_1.MCP_CONSTRAINTS.POOL_LIMIT, // 100
+    comment: constraints_js_1.MCP_CONSTRAINTS.COMMENT_LIMIT, // 50
+};
+// =============================================================================
+// Trading Defaults
+// =============================================================================
+/**
+ * Default slippage tolerance (1%)
+ */
+exports.DEFAULT_SLIPPAGE_TOLERANCE = 0.01;
+/**
+ * Default reverse bonding curve fee slippage tolerance (1%)
+ */
+exports.DEFAULT_RBC_FEE_SLIPPAGE = 0.01;
+/**
+ * Default pool type for fetchPools
+ */
+exports.DEFAULT_POOL_TYPE = 'recent';
+/**
+ * Default sort order
+ */
+exports.DEFAULT_SORT_ORDER = 'DESC';
+// =============================================================================
+// Volume Data Defaults
+// =============================================================================
+/**
+ * Default resolution for volume data (1 hour)
+ */
+exports.DEFAULT_VOLUME_RESOLUTION = '1h';
+/**
+ * Resolution mapping (string to seconds)
+ */
+exports.RESOLUTION_MAP = {
+    '1m': 60,
+    '5m': 300,
+    '15m': 900,
+    '1h': 3600,
+    '4h': 14400,
+    '1d': 86400,
+};
+// =============================================================================
+// Utility Functions
+// =============================================================================
+/**
+ * Applies default pagination values to args object
+ *
+ * @example
+ * ```typescript
+ * const params = applyPaginationDefaults(args);
+ * // { page: 1, limit: 20, ...otherArgs }
+ * ```
+ */
+function applyPaginationDefaults(args, defaults = exports.DEFAULT_PAGINATION) {
+    return {
+        ...args,
+        page: args.page ?? defaults.page ?? exports.DEFAULT_PAGINATION.page,
+        limit: args.limit ?? defaults.limit ?? exports.DEFAULT_PAGINATION.limit,
+    };
+}
+/**
+ * Applies operation-specific pagination defaults
+ *
+ * @example
+ * ```typescript
+ * const params = applyOperationPaginationDefaults(args, 'pool');
+ * // Uses default limit of 20 for pool operations
+ * ```
+ */
+function applyOperationPaginationDefaults(args, operationType) {
+    return applyPaginationDefaults(args, {
+        page: exports.DEFAULT_PAGINATION.page,
+        limit: exports.DEFAULT_LIMITS[operationType],
+    });
+}
+/**
+ * Applies default slippage values to trading args
+ *
+ * @example
+ * ```typescript
+ * const params = applySlippageDefaults(args);
+ * // { slippageToleranceFactor: 0.01, maxAcceptableReverseBondingCurveFeeSlippageFactor: 0.01, ...args }
+ * ```
+ */
+function applySlippageDefaults(args, defaults = {}) {
+    return {
+        ...args,
+        slippageToleranceFactor: args.slippageToleranceFactor ??
+            defaults.slippageToleranceFactor ??
+            exports.DEFAULT_SLIPPAGE_TOLERANCE,
+        maxAcceptableReverseBondingCurveFeeSlippageFactor: args.maxAcceptableReverseBondingCurveFeeSlippageFactor ??
+            defaults.maxAcceptableReverseBondingCurveFeeSlippageFactor ??
+            exports.DEFAULT_RBC_FEE_SLIPPAGE,
+    };
+}
+/**
+ * Converts volume resolution string to seconds
+ *
+ * @example
+ * ```typescript
+ * const seconds = resolutionToSeconds('1h', '1h');
+ * // 3600
+ * ```
+ */
+function resolutionToSeconds(resolution, defaultResolution = exports.DEFAULT_VOLUME_RESOLUTION) {
+    return exports.RESOLUTION_MAP[resolution ?? defaultResolution] ?? exports.RESOLUTION_MAP[defaultResolution];
+}
+/**
+ * Converts ISO 8601 date string to Unix timestamp (seconds)
+ *
+ * @example
+ * ```typescript
+ * const timestamp = dateToUnixTimestamp('2024-01-15T14:30:25Z');
+ * // 1705329025
+ * ```
+ */
+function dateToUnixTimestamp(isoDate) {
+    if (!isoDate)
+        return undefined;
+    return Math.floor(new Date(isoDate).getTime() / 1000);
+}
+// =============================================================================
+// Export All
+// =============================================================================
+exports.defaultValues = {
+    pagination: exports.DEFAULT_PAGINATION,
+    limits: exports.DEFAULT_LIMITS,
+    maxLimits: exports.MAX_LIMITS,
+    slippageTolerance: exports.DEFAULT_SLIPPAGE_TOLERANCE,
+    rbcFeeSlippage: exports.DEFAULT_RBC_FEE_SLIPPAGE,
+    poolType: exports.DEFAULT_POOL_TYPE,
+    sortOrder: exports.DEFAULT_SORT_ORDER,
+    volumeResolution: exports.DEFAULT_VOLUME_RESOLUTION,
+    resolutionMap: exports.RESOLUTION_MAP,
+};
+//# sourceMappingURL=default-values.js.map

package/dist/utils/default-values.js.map

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

package/dist/utils/error-handler.d.ts

@@ -1,7 +1,10 @@
 /**
  * Error Handler Utility
  *
- * Formats errors for MCP protocol responses
+ * Formats errors for MCP protocol responses with AI-friendly tips.
+ * Uses centralized error templates from error-templates.ts.
+ *
+ * @see src/utils/error-templates.ts
  */
 import type { MCPToolResponse } from '../types/mcp.js';
 /**
@@ -10,6 +13,10 @@ import type { MCPToolResponse } from '../types/mcp.js';
 export declare function formatError(error: unknown): MCPToolResponse;
 /**
  * Wrap handler with error handling
+ *
+ * @template TArgs - Array of argument types
+ * @param handler - Handler function to wrap with error handling
+ * @returns Wrapped handler with automatic error formatting
  */
-export declare function withErrorHandling<T extends (...args: any[]) => Promise<MCPToolResponse>>(handler: T): T;
+export declare function withErrorHandling<TArgs extends unknown[]>(handler: (...args: TArgs) => Promise<MCPToolResponse>): (...args: TArgs) => Promise<MCPToolResponse>;
 //# sourceMappingURL=error-handler.d.ts.map

package/dist/utils/error-handler.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"error-handler.d.ts","sourceRoot":"","sources":["../../src/utils/error-handler.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAEvD;;GAEG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,OAAO,GAAG,eAAe,CAoB3D;AA+ED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,CAAC,SAAS,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,OAAO,CAAC,eAAe,CAAC,EACtF,OAAO,EAAE,CAAC,GACT,CAAC,CAQH"}
+{"version":3,"file":"error-handler.d.ts","sourceRoot":"","sources":["../../src/utils/error-handler.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAGvD;;GAEG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,OAAO,GAAG,eAAe,CAkB3D;AAkBD;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,SAAS,OAAO,EAAE,EACvD,OAAO,EAAE,CAAC,GAAG,IAAI,EAAE,KAAK,KAAK,OAAO,CAAC,eAAe,CAAC,GACpD,CAAC,GAAG,IAAI,EAAE,KAAK,KAAK,OAAO,CAAC,eAAe,CAAC,CAQ9C"}