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

package/dist/tools/dex-pools/index.js

@@ -0,0 +1,231 @@
+"use strict";
+/**
+ * DEX Pool Discovery & Information Tools
+ *
+ * Tools for discovering and querying GalaSwap DEX liquidity pools.
+ * Provides pool listing, search, pricing, and token discovery capabilities.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.dexPoolsTools = exports.fetchAllAvailableDexTokensTool = exports.fetchAvailableDexTokensTool = exports.getSwapPoolPriceTool = exports.fetchCompositePoolDataTool = exports.getSwapPoolInfoTool = exports.fetchAllDexPoolsTool = exports.fetchDexPoolsTool = void 0;
+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 pool_filter_builder_js_1 = require("../../utils/pool-filter-builder.js");
+const helpers_js_1 = require("../dex/helpers.js");
+// ============================================================================
+// POOL DISCOVERY TOOLS (2 tools)
+// ============================================================================
+/**
+ * 1. Fetch DEX Pools (paginated)
+ *
+ * Queries the GalaSwap DEX backend for available liquidity pools with pagination,
+ * sorting, and search filtering capabilities.
+ */
+exports.fetchDexPoolsTool = {
+    name: 'gala_launchpad_fetch_dex_pools',
+    description: 'Fetch DEX pools with pagination and filtering - query available liquidity pools on GalaSwap',
+    inputSchema: (0, common_schemas_js_1.createPoolDiscoverySchema)({
+        includePagination: true,
+        defaultLimit: 10,
+    }),
+    handler: (0, handler_factories_js_1.createSimpleHandler)('fetchDexPools', (args) => ({
+        ...(0, pool_filter_builder_js_1.buildDexPoolFilters)(args, { sortBy: 'tvl', sortOrder: 'desc' }),
+        page: args.page ?? default_values_js_1.DEFAULT_PAGINATION.page,
+        limit: args.limit ?? 10, // DEX pools default to 10
+    })),
+};
+/**
+ * 2. Fetch All DEX Pools (auto-paginated)
+ *
+ * Convenience tool that fetches all available DEX pools with automatic pagination.
+ * No page/limit parameters needed - returns ALL pools matching filters.
+ */
+exports.fetchAllDexPoolsTool = {
+    name: 'gala_launchpad_fetch_all_dex_pools',
+    description: 'Fetch all DEX pools with automatic pagination. No page/limit parameters needed - returns ALL pools matching filters.',
+    inputSchema: (0, common_schemas_js_1.createPoolDiscoverySchema)({
+        additionalProperties: {
+            withPrices: {
+                type: 'boolean',
+                description: 'Whether to fetch real-time pricing data for each pool (default: false)',
+            },
+        },
+    }),
+    handler: (0, handler_factories_js_1.createSimpleHandler)('fetchAllDexPools', (args) => (0, pool_filter_builder_js_1.buildDexPoolFilters)(args, { sortBy: 'tvl', sortOrder: 'desc' })),
+};
+// ============================================================================
+// POOL INFORMATION TOOLS (3 tools)
+// ============================================================================
+/**
+ * 3. Get Pool Info
+ *
+ * Get liquidity and fee tier information for a token pair on GalaSwap DEX.
+ */
+exports.getSwapPoolInfoTool = {
+    name: 'gala_launchpad_get_swap_pool_info',
+    description: 'Get liquidity and fee tier information for a token pair on GalaSwap DEX',
+    inputSchema: {
+        type: 'object',
+        properties: {
+            tokenA: common_schemas_js_1.DEX_TOKEN_SYMBOL_SCHEMA,
+            tokenB: common_schemas_js_1.DEX_TOKEN_SYMBOL_SCHEMA,
+        },
+        required: ['tokenA', 'tokenB'],
+    },
+    handler: (0, handler_factories_js_1.createCustomMessageHandler)('getSwapPoolInfo', (args) => [args.tokenA, args.tokenB], (poolInfo, args) => ({
+        tokenA: poolInfo.tokenA,
+        tokenB: poolInfo.tokenB,
+        liquidity: poolInfo.liquidity,
+        feeTiers: poolInfo.feeTiers,
+        feeTiersFormatted: (0, helpers_js_1.formatFeeTiersPercent)(poolInfo.feeTiers),
+        swapCount: poolInfo.swapCount,
+        message: `Pool ${args.tokenA}/${args.tokenB} has ${poolInfo.liquidity} liquidity with ${poolInfo.feeTiers.length} fee tiers`,
+    })),
+};
+/**
+ * 4. Fetch Composite Pool Data
+ *
+ * Fetch complete pool state for offline DEX quote calculations.
+ * Returns pool liquidity, tick data, and token balances.
+ * Use this for bulk pricing operations or when you need multiple quotes for the same pool.
+ */
+exports.fetchCompositePoolDataTool = {
+    name: 'gala_launchpad_fetch_composite_pool_data',
+    description: 'Fetch complete pool state for offline DEX quote calculations. Returns pool liquidity, tick data, and token balances. Use this for bulk pricing operations or when you need multiple quotes for the same pool.',
+    inputSchema: {
+        type: 'object',
+        properties: {
+            token0: {
+                ...common_schemas_js_1.DEX_TOKEN_CLASS_KEY_SCHEMA,
+                description: 'First token class key (e.g., "GALA|Unit|none|none")',
+            },
+            token1: {
+                ...common_schemas_js_1.DEX_TOKEN_CLASS_KEY_SCHEMA,
+                description: 'Second token class key (e.g., "Token|Unit|BENE|client:5c806869e7fd0e2384461ce9")',
+            },
+            fee: common_schemas_js_1.FEE_TIER_SCHEMA,
+        },
+        required: ['token0', 'token1', 'fee'],
+    },
+    handler: (0, handler_factories_js_1.createCustomMessageHandler)('fetchCompositePoolData', (args) => (0, helpers_js_1.extractTokenPairParams)(args), (composite, args) => {
+        const params = (0, helpers_js_1.extractTokenPairParams)(args);
+        return {
+            ...params,
+            token0Decimals: composite.token0Decimals,
+            token1Decimals: composite.token1Decimals,
+            poolLiquidity: composite.pool.liquidity.toString(),
+            tick: composite.pool.tick,
+            sqrtPrice: composite.pool.sqrtPrice.toString(),
+            tickDataCount: Object.keys(composite.tickDataMap).length,
+            message: `Composite pool data fetched for ${params.token0}/${params.token1} (${(0, helpers_js_1.formatFeeTierPercent)(params.fee)} fee)`,
+        };
+    }),
+};
+/**
+ * 5. Get Swap Pool Price
+ *
+ * Get current price, tick, and liquidity for a DEX pool.
+ * Use to check if liquidity positions are in-range.
+ */
+exports.getSwapPoolPriceTool = {
+    name: 'gala_launchpad_get_swap_pool_price',
+    description: 'Get current price, tick, and liquidity for a DEX pool. Use to check if liquidity positions are in-range.',
+    inputSchema: {
+        type: 'object',
+        properties: {
+            token0: common_schemas_js_1.DEX_TOKEN_SYMBOL_SCHEMA,
+            token1: common_schemas_js_1.DEX_TOKEN_SYMBOL_SCHEMA,
+            fee: common_schemas_js_1.FEE_TIER_SCHEMA,
+        },
+        required: ['token0', 'token1', 'fee'],
+    },
+    handler: (0, handler_factories_js_1.createCustomMessageHandler)('getSwapPoolPrice', (args) => {
+        const { token0, token1, fee } = (0, helpers_js_1.extractTokenPairParams)(args);
+        return [token0, token1, fee];
+    }, (priceData, args) => {
+        const { token0, token1, fee } = (0, helpers_js_1.extractTokenPairParams)(args);
+        return {
+            token0,
+            token1,
+            fee,
+            price: priceData.price,
+            tick: priceData.tick,
+            liquidity: priceData.liquidity,
+            message: `Pool price: ${priceData.price} ${token1} per ${token0} (tick: ${priceData.tick})`,
+        };
+    }),
+};
+// ============================================================================
+// TOKEN DISCOVERY TOOLS (2 tools)
+// ============================================================================
+/**
+ * 6. Fetch Available DEX Tokens (paginated)
+ *
+ * Discover all tokens available on the DEX (paginated).
+ * Returns rich token metadata without requiring a wallet address.
+ * Use for token discovery and listing.
+ */
+exports.fetchAvailableDexTokensTool = {
+    name: 'gala_launchpad_fetch_available_dex_tokens',
+    description: 'Discover all tokens available on the DEX (paginated). Returns rich token metadata without requiring a wallet address. Use for token discovery and listing.',
+    inputSchema: {
+        type: 'object',
+        properties: {
+            search: common_schemas_js_1.SEARCH_SCHEMA,
+            limit: (0, common_schemas_js_1.createLimitSchema)('pool', 20),
+            page: common_schemas_js_1.PAGE_SCHEMA,
+        },
+        required: [],
+    },
+    handler: (0, handler_factories_js_1.createCustomMessageHandler)('fetchAvailableDexTokens', (args) => ({
+        search: args.search,
+        limit: args.limit,
+        page: args.page,
+    }), (result) => ({
+        count: result.count,
+        page: result.page,
+        limit: result.limit,
+        hasMore: result.hasMore,
+        tokens: (0, helpers_js_1.mapTokenMetadataArray)(result.tokens),
+        message: `Found ${result.tokens.length} tokens (page ${result.page}, ${result.count} total)${result.hasMore ? ' - more pages available' : ''}`,
+    })),
+};
+/**
+ * 7. Fetch All Available DEX Tokens (auto-paginated)
+ *
+ * Discover ALL tokens available on the DEX (auto-paginates).
+ * Returns complete list with rich metadata.
+ * Use for comprehensive token catalogs.
+ */
+exports.fetchAllAvailableDexTokensTool = {
+    name: 'gala_launchpad_fetch_all_available_dex_tokens',
+    description: 'Discover ALL tokens available on the DEX (auto-paginates). Returns complete list with rich metadata. Use for comprehensive token catalogs.',
+    inputSchema: {
+        type: 'object',
+        properties: {
+            search: common_schemas_js_1.SEARCH_SCHEMA,
+        },
+        required: [],
+    },
+    handler: (0, handler_factories_js_1.createCustomMessageHandler)('fetchAllAvailableDexTokens', (args) => ({
+        search: args.search,
+    }), (tokens) => ({
+        tokenCount: tokens.length,
+        tokens: (0, helpers_js_1.mapTokenMetadataArray)(tokens),
+        message: `Found ${tokens.length} total tokens available on the DEX`,
+    })),
+};
+// ============================================================================
+// EXPORTS
+// ============================================================================
+// Export all pool tools (2 discovery + 3 info + 2 token discovery = 7 tools)
+exports.dexPoolsTools = [
+    exports.fetchDexPoolsTool,
+    exports.fetchAllDexPoolsTool,
+    exports.getSwapPoolInfoTool,
+    exports.fetchCompositePoolDataTool,
+    exports.getSwapPoolPriceTool,
+    exports.fetchAvailableDexTokensTool,
+    exports.fetchAllAvailableDexTokensTool,
+];
+//# sourceMappingURL=index.js.map

package/dist/tools/dex-pools/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/tools/dex-pools/index.ts"],"names":[],"mappings":";AAAA;;;;;GAKG;;;AAOH,kEAGiC;AACjC,uEAQyC;AACzC,qEAAmE;AACnE,+EAAyE;AACzE,kDAK2B;AA6B3B,+EAA+E;AAC/E,iCAAiC;AACjC,+EAA+E;AAE/E;;;;;GAKG;AACU,QAAA,iBAAiB,GAAY;IACxC,IAAI,EAAE,gCAAgC;IACtC,WAAW,EAAE,6FAA6F;IAC1G,WAAW,EAAE,IAAA,6CAAyB,EAAC;QACrC,iBAAiB,EAAE,IAAI;QACvB,YAAY,EAAE,EAAE;KACjB,CAAC;IACF,OAAO,EAAE,IAAA,0CAAmB,EAAC,eAAe,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;QACvD,GAAG,IAAA,4CAAmB,EAAC,IAAI,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,SAAS,EAAE,MAAM,EAAE,CAAC;QAClE,IAAI,EAAG,IAAI,CAAC,IAAe,IAAI,sCAAkB,CAAC,IAAI;QACtD,KAAK,EAAG,IAAI,CAAC,KAAgB,IAAI,EAAE,EAAE,0BAA0B;KAChE,CAAC,CAAC;CACJ,CAAC;AAEF;;;;;GAKG;AACU,QAAA,oBAAoB,GAAY;IAC3C,IAAI,EAAE,oCAAoC;IAC1C,WAAW,EAAE,sHAAsH;IACnI,WAAW,EAAE,IAAA,6CAAyB,EAAC;QACrC,oBAAoB,EAAE;YACpB,UAAU,EAAE;gBACV,IAAI,EAAE,SAAS;gBACf,WAAW,EAAE,wEAAwE;aACtF;SACF;KACF,CAAC;IACF,OAAO,EAAE,IAAA,0CAAmB,EAAC,kBAAkB,EAAE,CAAC,IAAI,EAAE,EAAE,CACxD,IAAA,4CAAmB,EAAC,IAAI,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,SAAS,EAAE,MAAM,EAAE,CAAC,CAChE;CACF,CAAC;AAEF,+EAA+E;AAC/E,mCAAmC;AACnC,+EAA+E;AAE/E;;;;GAIG;AACU,QAAA,mBAAmB,GAAY;IAC1C,IAAI,EAAE,mCAAmC;IACzC,WAAW,EACT,yEAAyE;IAC3E,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACV,MAAM,EAAE,2CAAuB;YAC/B,MAAM,EAAE,2CAAuB;SAChC;QACD,QAAQ,EAAE,CAAC,QAAQ,EAAE,QAAQ,CAAC;KAC/B;IACD,OAAO,EAAE,IAAA,iDAA0B,EACjC,iBAAiB,EACjB,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,MAAgB,EAAE,IAAI,CAAC,MAAgB,CAAC,EACxD,CAAC,QAAQ,EAAE,IAAI,EAAE,EAAE,CAAC,CAAC;QACnB,MAAM,EAAE,QAAQ,CAAC,MAAM;QACvB,MAAM,EAAE,QAAQ,CAAC,MAAM;QACvB,SAAS,EAAE,QAAQ,CAAC,SAAS;QAC7B,QAAQ,EAAE,QAAQ,CAAC,QAAQ;QAC3B,iBAAiB,EAAE,IAAA,kCAAqB,EAAC,QAAQ,CAAC,QAAQ,CAAC;QAC3D,SAAS,EAAE,QAAQ,CAAC,SAAS;QAC7B,OAAO,EAAE,QAAQ,IAAI,CAAC,MAAM,IAAI,IAAI,CAAC,MAAM,QAAQ,QAAQ,CAAC,SAAS,mBAAmB,QAAQ,CAAC,QAAQ,CAAC,MAAM,YAAY;KAC7H,CAAC,CACH;CACF,CAAC;AAEF;;;;;;GAMG;AACU,QAAA,0BAA0B,GAAY;IACjD,IAAI,EAAE,0CAA0C;IAChD,WAAW,EACT,+MAA+M;IACjN,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACV,MAAM,EAAE;gBACN,GAAG,8CAA0B;gBAC7B,WAAW,EAAE,qDAAqD;aACnE;YACD,MAAM,EAAE;gBACN,GAAG,8CAA0B;gBAC7B,WAAW,EAAE,kFAAkF;aAChG;YACD,GAAG,EAAE,mCAAe;SACrB;QACD,QAAQ,EAAE,CAAC,QAAQ,EAAE,QAAQ,EAAE,KAAK,CAAC;KACtC;IACD,OAAO,EAAE,IAAA,iDAA0B,EACjC,wBAAwB,EACxB,CAAC,IAAI,EAAE,EAAE,CAAC,IAAA,mCAAsB,EAAC,IAAI,CAAC,EACtC,CAAC,SAAS,EAAE,IAAI,EAAE,EAAE;QAClB,MAAM,MAAM,GAAG,IAAA,mCAAsB,EAAC,IAAI,CAAC,CAAC;QAC5C,OAAO;YACL,GAAG,MAAM;YACT,cAAc,EAAE,SAAS,CAAC,cAAc;YACxC,cAAc,EAAE,SAAS,CAAC,cAAc;YACxC,aAAa,EAAE,SAAS,CAAC,IAAI,CAAC,SAAS,CAAC,QAAQ,EAAE;YAClD,IAAI,EAAE,SAAS,CAAC,IAAI,CAAC,IAAI;YACzB,SAAS,EAAE,SAAS,CAAC,IAAI,CAAC,SAAS,CAAC,QAAQ,EAAE;YAC9C,aAAa,EAAE,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,WAAW,CAAC,CAAC,MAAM;YACxD,OAAO,EAAE,mCAAmC,MAAM,CAAC,MAAM,IAAI,MAAM,CAAC,MAAM,KAAK,IAAA,iCAAoB,EAAC,MAAM,CAAC,GAAG,CAAC,OAAO;SACvH,CAAC;IACJ,CAAC,CACF;CACF,CAAC;AAEF;;;;;GAKG;AACU,QAAA,oBAAoB,GAAY;IAC3C,IAAI,EAAE,oCAAoC;IAC1C,WAAW,EACT,0GAA0G;IAC5G,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACV,MAAM,EAAE,2CAAuB;YAC/B,MAAM,EAAE,2CAAuB;YAC/B,GAAG,EAAE,mCAAe;SACrB;QACD,QAAQ,EAAE,CAAC,QAAQ,EAAE,QAAQ,EAAE,KAAK,CAAC;KACtC;IACD,OAAO,EAAE,IAAA,iDAA0B,EACjC,kBAAkB,EAClB,CAAC,IAAI,EAAE,EAAE;QACP,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,GAAG,IAAA,mCAAsB,EAAC,IAAI,CAAC,CAAC;QAC7D,OAAO,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,CAAC,CAAC;IAC/B,CAAC,EACD,CAAC,SAAS,EAAE,IAAI,EAAE,EAAE;QAClB,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,GAAG,IAAA,mCAAsB,EAAC,IAAI,CAAC,CAAC;QAC7D,OAAO;YACL,MAAM;YACN,MAAM;YACN,GAAG;YACH,KAAK,EAAE,SAAS,CAAC,KAAK;YACtB,IAAI,EAAE,SAAS,CAAC,IAAI;YACpB,SAAS,EAAE,SAAS,CAAC,SAAS;YAC9B,OAAO,EAAE,eAAe,SAAS,CAAC,KAAK,IAAI,MAAM,QAAQ,MAAM,WAAW,SAAS,CAAC,IAAI,GAAG;SAC5F,CAAC;IACJ,CAAC,CACF;CACF,CAAC;AAEF,+EAA+E;AAC/E,kCAAkC;AAClC,+EAA+E;AAE/E;;;;;;GAMG;AACU,QAAA,2BAA2B,GAAY;IAClD,IAAI,EAAE,2CAA2C;IACjD,WAAW,EACT,4JAA4J;IAC9J,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACV,MAAM,EAAE,iCAAa;YACrB,KAAK,EAAE,IAAA,qCAAiB,EAAC,MAAM,EAAE,EAAE,CAAC;YACpC,IAAI,EAAE,+BAAW;SAClB;QACD,QAAQ,EAAE,EAAE;KACb;IACD,OAAO,EAAE,IAAA,iDAA0B,EACjC,yBAAyB,EACzB,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;QACT,MAAM,EAAE,IAAI,CAAC,MAA4B;QACzC,KAAK,EAAE,IAAI,CAAC,KAA2B;QACvC,IAAI,EAAE,IAAI,CAAC,IAA0B;KACtC,CAAC,EACF,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;QACX,KAAK,EAAE,MAAM,CAAC,KAAK;QACnB,IAAI,EAAE,MAAM,CAAC,IAAI;QACjB,KAAK,EAAE,MAAM,CAAC,KAAK;QACnB,OAAO,EAAE,MAAM,CAAC,OAAO;QACvB,MAAM,EAAE,IAAA,kCAAqB,EAAC,MAAM,CAAC,MAAM,CAAC;QAC5C,OAAO,EAAE,SAAS,MAAM,CAAC,MAAM,CAAC,MAAM,iBAAiB,MAAM,CAAC,IAAI,KAAK,MAAM,CAAC,KAAK,UAAU,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,yBAAyB,CAAC,CAAC,CAAC,EAAE,EAAE;KAC/I,CAAC,CACH;CACF,CAAC;AAEF;;;;;;GAMG;AACU,QAAA,8BAA8B,GAAY;IACrD,IAAI,EAAE,+CAA+C;IACrD,WAAW,EACT,4IAA4I;IAC9I,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACV,MAAM,EAAE,iCAAa;SACtB;QACD,QAAQ,EAAE,EAAE;KACb;IACD,OAAO,EAAE,IAAA,iDAA0B,EACjC,4BAA4B,EAC5B,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;QACT,MAAM,EAAE,IAAI,CAAC,MAA4B;KAC1C,CAAC,EACF,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;QACX,UAAU,EAAE,MAAM,CAAC,MAAM;QACzB,MAAM,EAAE,IAAA,kCAAqB,EAAC,MAAM,CAAC;QACrC,OAAO,EAAE,SAAS,MAAM,CAAC,MAAM,oCAAoC;KACpE,CAAC,CACH;CACF,CAAC;AAEF,+EAA+E;AAC/E,UAAU;AACV,+EAA+E;AAE/E,6EAA6E;AAChE,QAAA,aAAa,GAAc;IACtC,yBAAiB;IACjB,4BAAoB;IACpB,2BAAmB;IACnB,kCAA0B;IAC1B,4BAAoB;IACpB,mCAA2B;IAC3B,sCAA8B;CAC/B,CAAC"}