@gala-chain/launchpad-mcp-server 1.27.2 → 2.0.0

package/dist/tools/dex/pool-quote-local.js

@@ -0,0 +1,84 @@
+"use strict";
+/**
+ * DEX Pool Quote Local Tool
+ *
+ * Calculate DEX pool swap quotes using LOCAL/offline bonding curve formulas.
+ * Provides instant client-side calculation without network call to GalaChain.
+ * Requires composite pool data to be fetched first.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.calculateDexPoolQuoteLocalTool = void 0;
+const response_formatter_js_1 = require("../../utils/response-formatter.js");
+const error_handler_js_1 = require("../../utils/error-handler.js");
+// Token schema for quote calculations
+const TOKEN_SCHEMA = {
+    type: 'string',
+    minLength: 1,
+    description: 'Token identifier in delimited format (e.g., "GALA|Unit|none|none" or "Token|Unit|GUSDC|eth:0x...")',
+};
+// Fee tier schema
+const FEE_TIER_SCHEMA = {
+    type: 'number',
+    enum: [500, 3000, 10000],
+    description: 'Fee tier in basis points: 500 (0.05%), 3000 (0.30%), 10000 (1.00%)',
+};
+// Amount schema
+const AMOUNT_SCHEMA = {
+    type: 'string',
+    pattern: '^\\d+(\\.\\d+)?$',
+    description: 'Amount to swap (as decimal string, e.g., "10.5")',
+};
+exports.calculateDexPoolQuoteLocalTool = {
+    name: 'gala_launchpad_calculate_dex_pool_quote_local',
+    description: 'Calculate DEX pool swap quotes using LOCAL offline formulas (no network call). Instant client-side calculation. Requires fetching composite pool data first with token0, token1, and fee tier.',
+    inputSchema: {
+        type: 'object',
+        properties: {
+            token0: TOKEN_SCHEMA,
+            token1: TOKEN_SCHEMA,
+            fee: FEE_TIER_SCHEMA,
+            fromToken: TOKEN_SCHEMA,
+            toToken: TOKEN_SCHEMA,
+            amount: AMOUNT_SCHEMA,
+        },
+        required: ['token0', 'token1', 'fee', 'fromToken', 'toToken', 'amount'],
+    },
+    handler: (0, error_handler_js_1.withErrorHandling)(async (sdk, args) => {
+        // First fetch composite pool data
+        const compositeData = await sdk.fetchCompositePoolData({
+            token0: args.token0,
+            token1: args.token1,
+            fee: args.fee,
+        });
+        // Calculate quote using LOCAL method (instant, offline)
+        const quote = await sdk.calculateDexPoolQuoteExactAmountLocal({
+            compositePoolData: compositeData,
+            fromToken: args.fromToken,
+            toToken: args.toToken,
+            amount: args.amount,
+        });
+        // Determine swap direction
+        const isToken0ToToken1 = args.fromToken === args.token0;
+        const inputAmount = args.amount;
+        const outputAmount = isToken0ToToken1 ? quote.amount1 : quote.amount0;
+        // Calculate price impact if provided
+        const priceImpact = quote.priceImpact || 'N/A';
+        const executionPrice = quote.executionPrice || 'N/A';
+        return (0, response_formatter_js_1.formatSuccess)({
+            poolId: `${args.token0}-${args.token1}-${args.fee}`,
+            fromToken: args.fromToken,
+            toToken: args.toToken,
+            inputAmount: inputAmount,
+            outputAmount: outputAmount,
+            prices: {
+                currentSqrtPrice: quote.currentSqrtPrice,
+                newSqrtPrice: quote.newSqrtPrice,
+                executionPrice: executionPrice,
+                priceImpact: priceImpact,
+            },
+            calculationMode: 'local',
+            message: `LOCAL quote: Swapping ${inputAmount} ${args.fromToken.split('|')[2] || args.fromToken} will yield ${outputAmount} ${args.toToken.split('|')[2] || args.toToken} (instant, offline calculation)`,
+        });
+    }),
+};
+//# sourceMappingURL=pool-quote-local.js.map

package/dist/tools/dex/pool-quote-local.js.map

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

package/dist/tools/dex/position-direct.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Swap Position Direct Tool
+ *
+ * Fetch LP position details by position ID with direct data access.
+ * Useful for portfolio management when you know the specific position ID.
+ */
+import type { MCPTool } from '../../types/mcp.js';
+export declare const fetchSwapPositionByIdTool: MCPTool;
+//# sourceMappingURL=position-direct.d.ts.map

package/dist/tools/dex/position-direct.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"position-direct.d.ts","sourceRoot":"","sources":["../../../src/tools/dex/position-direct.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAYlD,eAAO,MAAM,yBAAyB,EAAE,OA+CvC,CAAC"}

package/dist/tools/dex/position-direct.js

@@ -0,0 +1,65 @@
+"use strict";
+/**
+ * Swap Position Direct Tool
+ *
+ * Fetch LP position details by position ID with direct data access.
+ * Useful for portfolio management when you know the specific position ID.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.fetchSwapPositionByIdTool = 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");
+// Position ID schema
+const POSITION_ID_SCHEMA = {
+    type: 'string',
+    minLength: 1,
+    description: 'Unique position identifier (e.g., "pos-abc123" or position ID from getSwapLiquidityPositions)',
+};
+exports.fetchSwapPositionByIdTool = {
+    name: 'gala_launchpad_fetch_swap_position_by_id',
+    description: 'Fetch LP position details by position ID (alternative to compound key lookup). Retrieves specific liquidity position by its unique identifier. Useful when you have the position ID from getSwapLiquidityPositions.',
+    inputSchema: {
+        type: 'object',
+        properties: {
+            positionId: POSITION_ID_SCHEMA,
+            ownerAddress: {
+                ...common_schemas_js_1.ADDRESS_SCHEMA,
+                description: 'Wallet address that owns the position (e.g., "eth|0x123..." or "0x123...")',
+            },
+        },
+        required: ['positionId', 'ownerAddress'],
+    },
+    handler: (0, error_handler_js_1.withErrorHandling)(async (sdk, args) => {
+        // Get position by ID
+        const position = await sdk.getSwapLiquidityPositionById(args.ownerAddress, args.positionId);
+        if (!position) {
+            return (0, response_formatter_js_1.formatSuccess)({
+                positionId: args.positionId,
+                ownerAddress: args.ownerAddress,
+                found: false,
+                message: `Position ${args.positionId} not found for owner ${args.ownerAddress}`,
+            });
+        }
+        // Format position details for display
+        return (0, response_formatter_js_1.formatSuccess)({
+            positionId: args.positionId,
+            ownerAddress: args.ownerAddress,
+            found: true,
+            position: {
+                token0: position.token0,
+                token1: position.token1,
+                feeTier: position.feeTier,
+                tickLower: position.tickLower,
+                tickUpper: position.tickUpper,
+                liquidity: position.liquidity,
+                amount0: position.amount0,
+                amount1: position.amount1,
+                feeAmount0: position.feeAmount0,
+                feeAmount1: position.feeAmount1,
+            },
+            message: `Position ${args.positionId} found: ${position.token0}/${position.token1} (fee: ${position.feeTier}, liquidity: ${position.liquidity})`,
+        });
+    }),
+};
+//# sourceMappingURL=position-direct.js.map

package/dist/tools/dex/position-direct.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"position-direct.js","sourceRoot":"","sources":["../../../src/tools/dex/position-direct.ts"],"names":[],"mappings":";AAAA;;;;;GAKG;;;AAGH,6EAAkE;AAClE,mEAAiE;AACjE,uEAAiE;AAEjE,qBAAqB;AACrB,MAAM,kBAAkB,GAAG;IACzB,IAAI,EAAE,QAAQ;IACd,SAAS,EAAE,CAAC;IACZ,WAAW,EAAE,+FAA+F;CAC7G,CAAC;AAEW,QAAA,yBAAyB,GAAY;IAChD,IAAI,EAAE,0CAA0C;IAChD,WAAW,EAAE,qNAAqN;IAClO,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACV,UAAU,EAAE,kBAAkB;YAC9B,YAAY,EAAE;gBACZ,GAAG,kCAAc;gBACjB,WAAW,EAAE,4EAA4E;aAC1F;SACF;QACD,QAAQ,EAAE,CAAC,YAAY,EAAE,cAAc,CAAC;KACzC;IACD,OAAO,EAAE,IAAA,oCAAiB,EAAC,KAAK,EAAE,GAAG,EAAE,IAAI,EAAE,EAAE;QAC7C,qBAAqB;QACrB,MAAM,QAAQ,GAAG,MAAM,GAAG,CAAC,4BAA4B,CAAC,IAAI,CAAC,YAAY,EAAE,IAAI,CAAC,UAAU,CAAC,CAAC;QAE5F,IAAI,CAAC,QAAQ,EAAE,CAAC;YACd,OAAO,IAAA,qCAAa,EAAC;gBACnB,UAAU,EAAE,IAAI,CAAC,UAAU;gBAC3B,YAAY,EAAE,IAAI,CAAC,YAAY;gBAC/B,KAAK,EAAE,KAAK;gBACZ,OAAO,EAAE,YAAY,IAAI,CAAC,UAAU,wBAAwB,IAAI,CAAC,YAAY,EAAE;aAChF,CAAC,CAAC;QACL,CAAC;QAED,sCAAsC;QACtC,OAAO,IAAA,qCAAa,EAAC;YACnB,UAAU,EAAE,IAAI,CAAC,UAAU;YAC3B,YAAY,EAAE,IAAI,CAAC,YAAY;YAC/B,KAAK,EAAE,IAAI;YACX,QAAQ,EAAE;gBACR,MAAM,EAAE,QAAQ,CAAC,MAAM;gBACvB,MAAM,EAAE,QAAQ,CAAC,MAAM;gBACvB,OAAO,EAAE,QAAQ,CAAC,OAAO;gBACzB,SAAS,EAAE,QAAQ,CAAC,SAAS;gBAC7B,SAAS,EAAE,QAAQ,CAAC,SAAS;gBAC7B,SAAS,EAAE,QAAQ,CAAC,SAAS;gBAC7B,OAAO,EAAE,QAAQ,CAAC,OAAO;gBACzB,OAAO,EAAE,QAAQ,CAAC,OAAO;gBACzB,UAAU,EAAE,QAAQ,CAAC,UAAU;gBAC/B,UAAU,EAAE,QAAQ,CAAC,UAAU;aAChC;YACD,OAAO,EAAE,YAAY,IAAI,CAAC,UAAU,WAAW,QAAQ,CAAC,MAAM,IAAI,QAAQ,CAAC,MAAM,UAAU,QAAQ,CAAC,OAAO,gBAAgB,QAAQ,CAAC,SAAS,GAAG;SACjJ,CAAC,CAAC;IACL,CAAC,CAAC;CACH,CAAC"}

package/dist/tools/index.d.ts

@@ -7,15 +7,15 @@
  * @see src/utils/tool-registry.ts
  */
 /**
- * Enhanced tool registry with validation (76 tools total):
- * - Pools: 19 tools (17 + 2 watchers: onDexPoolCreation, onLaunchpadTokenCreation)
- * - Trading: 13 tools
- * - DEX/GalaSwap: 15 tools (5 swap + 8 liquidity + 2 pool discovery)
- * - Balance: 6 tools
- * - Creation: 4 tools
- * - Social: 2 tools
- * - Transfers: 2 tools
- * - Utilities: 15 tools (config, version, environment switching, wallet mgmt, etc.)
+ * Enhanced tool registry with validation (88 tools total):
+ * - Pools: 22 tools (pool operations + 2 watchers: onDexPoolCreation, onLaunchpadTokenCreation)
+ * - Trading: 13 tools (buy, sell, calculate amounts, graduation)
+ * - DEX/GalaSwap: 22 tools (5 swap + 10 liquidity + 2 pool discovery + 3 quote calc + 2 position mgmt)
+ * - Balance: 8 tools (balance queries + supply tracking)
+ * - Creation: 4 tools (token creation and launch)
+ * - Social: 2 tools (comments and interactions)
+ * - Transfers: 2 tools (GALA and token transfers)
+ * - Utilities: 17 tools (config, version, environment, wallet, faucet, cleanup, etc.)
  */
 export declare const registry: import("../utils/tool-registry.js").ToolRegistry;
 /**

package/dist/tools/index.js

@@ -64,17 +64,17 @@ const toolCategories = [
     },
 ];
 /**
- * Enhanced tool registry with validation (76 tools total):
- * - Pools: 19 tools (17 + 2 watchers: onDexPoolCreation, onLaunchpadTokenCreation)
- * - Trading: 13 tools
- * - DEX/GalaSwap: 15 tools (5 swap + 8 liquidity + 2 pool discovery)
- * - Balance: 6 tools
- * - Creation: 4 tools
- * - Social: 2 tools
- * - Transfers: 2 tools
- * - Utilities: 15 tools (config, version, environment switching, wallet mgmt, etc.)
+ * Enhanced tool registry with validation (88 tools total):
+ * - Pools: 22 tools (pool operations + 2 watchers: onDexPoolCreation, onLaunchpadTokenCreation)
+ * - Trading: 13 tools (buy, sell, calculate amounts, graduation)
+ * - DEX/GalaSwap: 22 tools (5 swap + 10 liquidity + 2 pool discovery + 3 quote calc + 2 position mgmt)
+ * - Balance: 8 tools (balance queries + supply tracking)
+ * - Creation: 4 tools (token creation and launch)
+ * - Social: 2 tools (comments and interactions)
+ * - Transfers: 2 tools (GALA and token transfers)
+ * - Utilities: 17 tools (config, version, environment, wallet, faucet, cleanup, etc.)
  */
-exports.registry = (0, tool_registry_js_1.createToolRegistry)(toolCategories, 76);
+exports.registry = (0, tool_registry_js_1.createToolRegistry)(toolCategories, 88);
 /**
  * Complete tool array (for backward compatibility)
  */

package/dist/tools/pools/composite-pool.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Composite Pool Data Tool
+ *
+ * Fetches complete DEX pool state including tick data for offline quote calculations.
+ * Returns pool liquidity, tick map, and token balances for local price simulations.
+ */
+import type { MCPTool } from '../../types/mcp.js';
+export declare const fetchCompositePoolDataTool: MCPTool;
+//# sourceMappingURL=composite-pool.d.ts.map

package/dist/tools/pools/composite-pool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"composite-pool.d.ts","sourceRoot":"","sources":["../../../src/tools/pools/composite-pool.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAkBlD,eAAO,MAAM,0BAA0B,EAAE,OA8CxC,CAAC"}

package/dist/tools/pools/composite-pool.js

@@ -0,0 +1,69 @@
+"use strict";
+/**
+ * Composite Pool Data Tool
+ *
+ * Fetches complete DEX pool state including tick data for offline quote calculations.
+ * Returns pool liquidity, tick map, and token balances for local price simulations.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.fetchCompositePoolDataTool = void 0;
+const response_formatter_js_1 = require("../../utils/response-formatter.js");
+const error_handler_js_1 = require("../../utils/error-handler.js");
+// Token symbol schema for DEX operations
+const TOKEN_SCHEMA = {
+    type: 'string',
+    minLength: 1,
+    description: 'Token identifier (e.g., "GALA|Unit|none|none" or "Token|Unit|GUSDC|eth:0x...")',
+};
+// Fee tier schema
+const FEE_TIER_SCHEMA = {
+    type: 'number',
+    enum: [500, 3000, 10000],
+    description: 'Fee tier in basis points: 500 (0.05%), 3000 (0.30%), 10000 (1.00%)',
+};
+exports.fetchCompositePoolDataTool = {
+    name: 'gala_launchpad_fetch_composite_pool_data',
+    description: 'Fetch complete DEX pool state for offline quote calculations. Returns pool liquidity, tick data, and token balances required for local price simulations.',
+    inputSchema: {
+        type: 'object',
+        properties: {
+            token0: TOKEN_SCHEMA,
+            token1: TOKEN_SCHEMA,
+            fee: FEE_TIER_SCHEMA,
+            gatewayBaseUrl: {
+                type: 'string',
+                description: 'Optional custom gateway URL (defaults to mainnet)',
+            },
+        },
+        required: ['token0', 'token1', 'fee'],
+    },
+    handler: (0, error_handler_js_1.withErrorHandling)(async (sdk, args) => {
+        // Fetch composite pool data using SDK method
+        const compositeData = await sdk.fetchCompositePoolData({
+            token0: args.token0,
+            token1: args.token1,
+            fee: args.fee,
+            gatewayBaseUrl: args.gatewayBaseUrl,
+        });
+        // Extract key pool metrics
+        const poolMetrics = {
+            liquidity: compositeData.pool.liquidity,
+            sqrtPrice: compositeData.pool.sqrtPrice,
+            tick: compositeData.pool.tick,
+            feeRate: compositeData.pool.fee,
+            token0Balance: compositeData.token0Balance.getQuantityTotal().toString(),
+            token1Balance: compositeData.token1Balance.getQuantityTotal().toString(),
+            token0Decimals: compositeData.token0Decimals,
+            token1Decimals: compositeData.token1Decimals,
+            tickCount: Object.keys(compositeData.tickDataMap).length,
+        };
+        return (0, response_formatter_js_1.formatSuccess)({
+            poolId: `${args.token0}-${args.token1}-${args.fee}`,
+            pool: poolMetrics,
+            hasLiquidity: Number(poolMetrics.liquidity) > 0,
+            tickDataAvailable: poolMetrics.tickCount > 0,
+            message: `Composite pool data fetched successfully. Pool has ${poolMetrics.tickCount} active ticks with ${poolMetrics.liquidity} total liquidity.`,
+        });
+    }),
+};
+//# sourceMappingURL=composite-pool.js.map

package/dist/tools/pools/composite-pool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"composite-pool.js","sourceRoot":"","sources":["../../../src/tools/pools/composite-pool.ts"],"names":[],"mappings":";AAAA;;;;;GAKG;;;AAGH,6EAAkE;AAClE,mEAAiE;AAEjE,yCAAyC;AACzC,MAAM,YAAY,GAAG;IACnB,IAAI,EAAE,QAAQ;IACd,SAAS,EAAE,CAAC;IACZ,WAAW,EAAE,gFAAgF;CAC9F,CAAC;AAEF,kBAAkB;AAClB,MAAM,eAAe,GAAG;IACtB,IAAI,EAAE,QAAQ;IACd,IAAI,EAAE,CAAC,GAAG,EAAE,IAAI,EAAE,KAAK,CAAC;IACxB,WAAW,EAAE,oEAAoE;CAClF,CAAC;AAEW,QAAA,0BAA0B,GAAY;IACjD,IAAI,EAAE,0CAA0C;IAChD,WAAW,EAAE,2JAA2J;IACxK,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACV,MAAM,EAAE,YAAY;YACpB,MAAM,EAAE,YAAY;YACpB,GAAG,EAAE,eAAe;YACpB,cAAc,EAAE;gBACd,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,mDAAmD;aACjE;SACF;QACD,QAAQ,EAAE,CAAC,QAAQ,EAAE,QAAQ,EAAE,KAAK,CAAC;KACtC;IACD,OAAO,EAAE,IAAA,oCAAiB,EAAC,KAAK,EAAE,GAAG,EAAE,IAAI,EAAE,EAAE;QAC7C,6CAA6C;QAC7C,MAAM,aAAa,GAAG,MAAM,GAAG,CAAC,sBAAsB,CAAC;YACrD,MAAM,EAAE,IAAI,CAAC,MAAM;YACnB,MAAM,EAAE,IAAI,CAAC,MAAM;YACnB,GAAG,EAAE,IAAI,CAAC,GAAG;YACb,cAAc,EAAE,IAAI,CAAC,cAAc;SACpC,CAAC,CAAC;QAEH,2BAA2B;QAC3B,MAAM,WAAW,GAAG;YAClB,SAAS,EAAE,aAAa,CAAC,IAAI,CAAC,SAAS;YACvC,SAAS,EAAE,aAAa,CAAC,IAAI,CAAC,SAAS;YACvC,IAAI,EAAE,aAAa,CAAC,IAAI,CAAC,IAAI;YAC7B,OAAO,EAAE,aAAa,CAAC,IAAI,CAAC,GAAG;YAC/B,aAAa,EAAE,aAAa,CAAC,aAAa,CAAC,gBAAgB,EAAE,CAAC,QAAQ,EAAE;YACxE,aAAa,EAAE,aAAa,CAAC,aAAa,CAAC,gBAAgB,EAAE,CAAC,QAAQ,EAAE;YACxE,cAAc,EAAE,aAAa,CAAC,cAAc;YAC5C,cAAc,EAAE,aAAa,CAAC,cAAc;YAC5C,SAAS,EAAE,MAAM,CAAC,IAAI,CAAC,aAAa,CAAC,WAAW,CAAC,CAAC,MAAM;SACzD,CAAC;QAEF,OAAO,IAAA,qCAAa,EAAC;YACnB,MAAM,EAAE,GAAG,IAAI,CAAC,MAAM,IAAI,IAAI,CAAC,MAAM,IAAI,IAAI,CAAC,GAAG,EAAE;YACnD,IAAI,EAAE,WAAW;YACjB,YAAY,EAAE,MAAM,CAAC,WAAW,CAAC,SAAS,CAAC,GAAG,CAAC;YAC/C,iBAAiB,EAAE,WAAW,CAAC,SAAS,GAAG,CAAC;YAC5C,OAAO,EAAE,sDAAsD,WAAW,CAAC,SAAS,sBAAsB,WAAW,CAAC,SAAS,mBAAmB;SACnJ,CAAC,CAAC;IACL,CAAC,CAAC;CACH,CAAC"}

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

@@ -0,0 +1,9 @@
+/**
+ * Cleanup Tool
+ *
+ * SDK lifecycle cleanup - clears cache, closes connections, resets state.
+ * Called during application shutdown to release resources properly.
+ */
+import type { MCPTool } from '../../types/mcp.js';
+export declare const cleanupTool: MCPTool;
+//# sourceMappingURL=cleanup.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"cleanup.d.ts","sourceRoot":"","sources":["../../../src/tools/utils/cleanup.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAElD,eAAO,MAAM,WAAW,EAAE,OA6CzB,CAAC"}

package/dist/tools/utils/cleanup.js

@@ -0,0 +1,54 @@
+"use strict";
+/**
+ * Cleanup Tool
+ *
+ * SDK lifecycle cleanup - clears cache, closes connections, resets state.
+ * Called during application shutdown to release resources properly.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.cleanupTool = void 0;
+const error_handler_js_1 = require("../../utils/error-handler.js");
+const response_formatter_js_1 = require("../../utils/response-formatter.js");
+exports.cleanupTool = {
+    name: 'gala_launchpad_cleanup',
+    description: 'SDK lifecycle cleanup - clears cache, closes connections, and resets state. Use during application shutdown or testing teardown to properly release resources.',
+    inputSchema: {
+        type: 'object',
+        properties: {
+            clearCache: {
+                type: 'boolean',
+                description: 'Whether to clear metadata cache (defaults to true)',
+                default: true,
+            },
+            closeConnections: {
+                type: 'boolean',
+                description: 'Whether to close WebSocket connections (defaults to true)',
+                default: true,
+            },
+        },
+    },
+    handler: (0, error_handler_js_1.withErrorHandling)(async (sdk, args) => {
+        const shouldClearCache = args?.clearCache !== false; // Default to true
+        const shouldCloseConnections = args?.closeConnections !== false; // Default to true
+        const operations = [];
+        // Clear cache if requested
+        if (shouldClearCache) {
+            sdk.clearCache(); // Clears all token metadata
+            operations.push('Cache cleared');
+        }
+        // Close connections if requested (always happens in cleanup)
+        if (shouldCloseConnections) {
+            await sdk.cleanup(); // Cleanup HTTP interceptors and WebSocket references
+            operations.push('Connections closed');
+        }
+        return (0, response_formatter_js_1.formatSuccess)({
+            success: true,
+            operations: operations,
+            clearedCache: shouldClearCache,
+            closedConnections: shouldCloseConnections,
+            message: `SDK cleanup completed: ${operations.join(', ')}`,
+            note: 'SDK instance is still usable and will reconnect automatically if needed',
+        });
+    }),
+};
+//# sourceMappingURL=cleanup.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"cleanup.js","sourceRoot":"","sources":["../../../src/tools/utils/cleanup.ts"],"names":[],"mappings":";AAAA;;;;;GAKG;;;AAEH,mEAAiE;AACjE,6EAAkE;AAGrD,QAAA,WAAW,GAAY;IAClC,IAAI,EAAE,wBAAwB;IAC9B,WAAW,EAAE,gKAAgK;IAC7K,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACV,UAAU,EAAE;gBACV,IAAI,EAAE,SAAS;gBACf,WAAW,EAAE,oDAAoD;gBACjE,OAAO,EAAE,IAAI;aACd;YACD,gBAAgB,EAAE;gBAChB,IAAI,EAAE,SAAS;gBACf,WAAW,EAAE,2DAA2D;gBACxE,OAAO,EAAE,IAAI;aACd;SACF;KACF;IACD,OAAO,EAAE,IAAA,oCAAiB,EAAC,KAAK,EAAE,GAAG,EAAE,IAAI,EAAE,EAAE;QAC7C,MAAM,gBAAgB,GAAG,IAAI,EAAE,UAAU,KAAK,KAAK,CAAC,CAAC,kBAAkB;QACvE,MAAM,sBAAsB,GAAG,IAAI,EAAE,gBAAgB,KAAK,KAAK,CAAC,CAAC,kBAAkB;QAEnF,MAAM,UAAU,GAAa,EAAE,CAAC;QAEhC,2BAA2B;QAC3B,IAAI,gBAAgB,EAAE,CAAC;YACrB,GAAG,CAAC,UAAU,EAAE,CAAC,CAAC,4BAA4B;YAC9C,UAAU,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC;QACnC,CAAC;QAED,6DAA6D;QAC7D,IAAI,sBAAsB,EAAE,CAAC;YAC3B,MAAM,GAAG,CAAC,OAAO,EAAE,CAAC,CAAC,qDAAqD;YAC1E,UAAU,CAAC,IAAI,CAAC,oBAAoB,CAAC,CAAC;QACxC,CAAC;QAED,OAAO,IAAA,qCAAa,EAAC;YACnB,OAAO,EAAE,IAAI;YACb,UAAU,EAAE,UAAU;YACtB,YAAY,EAAE,gBAAgB;YAC9B,iBAAiB,EAAE,sBAAsB;YACzC,OAAO,EAAE,0BAA0B,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE;YAC1D,IAAI,EAAE,yEAAyE;SAChF,CAAC,CAAC;IACL,CAAC,CAAC;CACH,CAAC"}

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

@@ -0,0 +1,10 @@
+/**
+ * Faucet Tool
+ *
+ * Test utility to retrieve GALA tokens from faucet.
+ * Only works in development/testing environments (production blocked).
+ * Backend provides a fixed amount (5 GALA).
+ */
+import type { MCPTool } from '../../types/mcp.js';
+export declare const retrieveFromFaucetTool: MCPTool;
+//# sourceMappingURL=faucet.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"faucet.d.ts","sourceRoot":"","sources":["../../../src/tools/utils/faucet.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAKH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAElD,eAAO,MAAM,sBAAsB,EAAE,OAyCpC,CAAC"}

package/dist/tools/utils/faucet.js

@@ -0,0 +1,51 @@
+"use strict";
+/**
+ * Faucet Tool
+ *
+ * Test utility to retrieve GALA tokens from faucet.
+ * Only works in development/testing environments (production blocked).
+ * Backend provides a fixed amount (5 GALA).
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.retrieveFromFaucetTool = void 0;
+const error_handler_js_1 = require("../../utils/error-handler.js");
+const response_formatter_js_1 = require("../../utils/response-formatter.js");
+const common_schemas_js_1 = require("../../schemas/common-schemas.js");
+exports.retrieveFromFaucetTool = {
+    name: 'gala_launchpad_retrieve_from_faucet',
+    description: 'Test utility to retrieve GALA tokens from faucet (dev/test environments only). Backend provides fixed amount of 5 GALA. Production environment will reject this request.',
+    inputSchema: {
+        type: 'object',
+        properties: {
+            recipientAddress: {
+                ...common_schemas_js_1.ADDRESS_SCHEMA,
+                description: 'Wallet address to receive faucet tokens (defaults to SDK authenticated wallet if not provided)',
+            },
+        },
+    },
+    handler: (0, error_handler_js_1.withErrorHandling)(async (sdk, args) => {
+        const recipientAddress = args?.recipientAddress;
+        try {
+            // Call SDK faucet method (defaults to SDK wallet if no address provided)
+            await sdk.retrieveGalaFromFaucet(recipientAddress);
+            const finalAddress = recipientAddress || sdk.getAddress();
+            return (0, response_formatter_js_1.formatSuccess)({
+                success: true,
+                recipientAddress: finalAddress,
+                amount: '5',
+                token: 'GALA',
+                message: `Successfully retrieved 5 GALA from faucet to ${finalAddress}`,
+                warning: 'This only works in development/testing environments',
+            });
+        }
+        catch (error) {
+            // Enhanced error message for production environment
+            if (error instanceof Error && error.message.includes('production')) {
+                throw new Error('Faucet is only available in development/testing environments. Production environment does not support faucet operations.');
+            }
+            // Re-throw other errors
+            throw error;
+        }
+    }),
+};
+//# sourceMappingURL=faucet.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"faucet.js","sourceRoot":"","sources":["../../../src/tools/utils/faucet.ts"],"names":[],"mappings":";AAAA;;;;;;GAMG;;;AAEH,mEAAiE;AACjE,6EAAkE;AAClE,uEAAiE;AAGpD,QAAA,sBAAsB,GAAY;IAC7C,IAAI,EAAE,qCAAqC;IAC3C,WAAW,EAAE,0KAA0K;IACvL,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACV,gBAAgB,EAAE;gBAChB,GAAG,kCAAc;gBACjB,WAAW,EAAE,gGAAgG;aAC9G;SACF;KACF;IACD,OAAO,EAAE,IAAA,oCAAiB,EAAC,KAAK,EAAE,GAAG,EAAE,IAAI,EAAE,EAAE;QAC7C,MAAM,gBAAgB,GAAG,IAAI,EAAE,gBAAgB,CAAC;QAEhD,IAAI,CAAC;YACH,yEAAyE;YACzE,MAAM,GAAG,CAAC,sBAAsB,CAAC,gBAAgB,CAAC,CAAC;YAEnD,MAAM,YAAY,GAAG,gBAAgB,IAAI,GAAG,CAAC,UAAU,EAAE,CAAC;YAE1D,OAAO,IAAA,qCAAa,EAAC;gBACnB,OAAO,EAAE,IAAI;gBACb,gBAAgB,EAAE,YAAY;gBAC9B,MAAM,EAAE,GAAG;gBACX,KAAK,EAAE,MAAM;gBACb,OAAO,EAAE,gDAAgD,YAAY,EAAE;gBACvE,OAAO,EAAE,qDAAqD;aAC/D,CAAC,CAAC;QACL,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,oDAAoD;YACpD,IAAI,KAAK,YAAY,KAAK,IAAI,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAC,EAAE,CAAC;gBACnE,MAAM,IAAI,KAAK,CACb,0HAA0H,CAC3H,CAAC;YACJ,CAAC;YAED,wBAAwB;YACxB,MAAM,KAAK,CAAC;QACd,CAAC;IACH,CAAC,CAAC;CACH,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@gala-chain/launchpad-mcp-server",
-  "version": "1.27.2",
+  "version": "2.0.0",
   "description": "MCP server for Gala Launchpad - 76 tools (pool management, event watchers, GSwap DEX trading, price history, token creation, wallet management, DEX pool discovery) supporting optional wallet (read-only and full-access modes). Production-grade AI agent integration for Claude Desktop with comprehensive validation and 80%+ test coverage",
   "main": "dist/index.js",
   "bin": {