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

package/dist/prompts/tier1-pool-discovery.js

@@ -0,0 +1,221 @@
+"use strict";
+/**
+ * Tier 1 Workflow: Pool Discovery and Analysis
+ *
+ * High-impact workflow for discovering and analyzing DEX liquidity pools.
+ * Helps users find trading opportunities and understand pool metrics.
+ *
+ * Slash command: /galachain-launchpad:discover-pools
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.tier1PoolDiscoveryPrompts = exports.checkLeaderboardPrompt = exports.fetchPoolDetailsPrompt = exports.fetchAllPoolsPrompt = exports.discoverPoolsPrompt = void 0;
+const mcpToolNames_js_1 = require("../constants/mcpToolNames.js");
+const handlerHelpers_js_1 = require("./utils/handlerHelpers.js");
+const index_js_1 = require("./factories/index.js");
+const validation_js_1 = require("../utils/validation.js");
+// =============================================================================
+// Pool Discovery Workflow
+// =============================================================================
+/**
+ * Discover Pools - Main workflow for pool discovery and analysis
+ */
+exports.discoverPoolsPrompt = (0, index_js_1.createDiscoveryPrompt)({
+    name: 'galachain-launchpad:discover-pools',
+    description: 'Discover DEX liquidity pools with filtering and analysis - find hot pools, high TVL, or high volume trading opportunities',
+    toolName: mcpToolNames_js_1.MCP_TOOLS.FETCH_DEX_POOLS,
+    fetchAllToolName: mcpToolNames_js_1.MCP_TOOLS.FETCH_ALL_DEX_POOLS,
+    itemType: 'DEX liquidity pools',
+    sortOptions: ['tvl', 'volume30d', 'volume1d', 'fee'],
+    defaultSort: 'tvl',
+    defaultSortOrder: 'desc',
+    includeSearch: true,
+    searchDescription: 'Filter by token symbol (e.g., GALA, GUSDC, GMUSIC)',
+    defaultLimit: 20,
+    maxLimit: 100,
+    additionalFilters: [
+        {
+            name: 'minTvl',
+            description: 'Minimum TVL in USD (e.g., "50000" for $50K+)',
+            required: false,
+        },
+        {
+            name: 'minVolume',
+            description: 'Minimum 24h volume in USD (e.g., "10000" for $10K+)',
+            required: false,
+        },
+    ],
+    buildAdditionalFilters: (args) => {
+        const filters = {};
+        if (args.minTvl) {
+            (0, validation_js_1.validateNumericAmount)(args.minTvl, 'minTvl');
+            filters.minTvl = args.minTvl;
+        }
+        if (args.minVolume) {
+            (0, validation_js_1.validateNumericAmount)(args.minVolume, 'minVolume');
+            filters.minVolume = args.minVolume;
+        }
+        return filters;
+    },
+    displayFormat: 'Show pool name, TVL, 24h volume, fee tier, and APR. Highlight top opportunities.',
+});
+/**
+ * Fetch All Pools - Auto-paginated pool discovery
+ */
+exports.fetchAllPoolsPrompt = (0, index_js_1.createFetchAllPrompt)({
+    name: 'galachain-launchpad:fetch-all-pools',
+    description: 'Fetch ALL DEX liquidity pools with auto-pagination for comprehensive analysis',
+    toolName: mcpToolNames_js_1.MCP_TOOLS.FETCH_ALL_DEX_POOLS,
+    itemType: 'DEX liquidity pools',
+    sortOptions: ['tvl', 'volume30d', 'volume1d'],
+    defaultSort: 'tvl',
+});
+/**
+ * Fetch Pool Details - Detailed pool analysis
+ */
+exports.fetchPoolDetailsPrompt = {
+    name: 'galachain-launchpad:fetch-pool-details',
+    description: 'Get comprehensive bonding curve pool analytics - supply metrics, fees, and trading history',
+    arguments: [
+        {
+            name: 'tokenName',
+            description: 'Token name to analyze (e.g., anime, demonkpop)',
+            required: true,
+        },
+    ],
+    handler: (args) => {
+        if (!args.tokenName) {
+            throw new Error('tokenName is required');
+        }
+        const messages = [
+            `# Pool Analysis Workflow: ${args.tokenName}`,
+            '',
+            '## Workflow Steps',
+            '',
+            '1. **Fetch Pool Details**',
+            `   - Call: gala_launchpad_fetch_pool_details_for_calculation`,
+            `   - Token: ${args.tokenName}`,
+            '   - Get: currentSupply, remainingTokens, maxSupply, bonding curve fees',
+            '',
+            '2. **Analyze Pool Metrics**',
+            '   - Supply progression (current vs max)',
+            '   - Token availability (remaining tokens)',
+            '   - Fee structure (min/max fee factors)',
+            '   - Graduation progress (% to completion)',
+            '',
+            '3. **Evaluate Trading Opportunity**',
+            '   - Risk assessment based on supply',
+            '   - Fee impact on trades',
+            '   - Graduation timeline estimate',
+            '',
+            '## Key Metrics to Review',
+            '',
+            '- **Current Supply**: Tokens in circulation',
+            '- **Max Supply**: Total tokens available',
+            '- **Remaining Tokens**: Tokens left to purchase',
+            '- **Graduation Progress**: Percentage complete (0-100%)',
+            '- **Min Fee Factor**: Minimum fee per trade',
+            '- **Max Fee Factor**: Maximum fee per trade',
+            '',
+            '## Trading Strategy Suggestions',
+            '',
+            '- **Early Stage (< 30%)**: Lower prices, higher growth potential, higher risk',
+            '- **Mid Stage (30-70%)**: Balanced risk/reward, established supply',
+            '- **Late Stage (> 70%)**: Lower growth potential, approaching graduation, fee increase likely',
+            '',
+            '## Next Steps',
+            '',
+            '- Use for calculating buy/sell amounts with price impact',
+            '- Monitor graduation progress to time peak exits',
+            '- Consider fees when planning large trades',
+            '- Compare with similar tokens for relative valuation',
+        ];
+        return (0, handlerHelpers_js_1.createPromptResponse)(messages.join('\n'));
+    },
+};
+/**
+ * Check Leaderboard - Top pools by metrics
+ */
+exports.checkLeaderboardPrompt = {
+    name: 'galachain-launchpad:check-leaderboard',
+    description: 'View top DEX pools ranked by TVL, volume, or APR',
+    arguments: [
+        {
+            name: 'metric',
+            description: 'Ranking metric: tvl (TVL), volume (24h volume), or apr (Annual percentage rate)',
+            required: false,
+        },
+        {
+            name: 'limit',
+            description: 'Number of pools to show (default: 10, max: 50)',
+            required: false,
+        },
+    ],
+    handler: (args) => {
+        const metric = (args.metric || 'tvl').toLowerCase();
+        const limit = Math.min(Math.max(1, parseInt(args.limit || '10', 10)), 50);
+        const validMetrics = ['tvl', 'volume', 'apr'];
+        if (!validMetrics.includes(metric)) {
+            throw new Error(`metric must be one of: ${validMetrics.join(', ')}`);
+        }
+        const metricLabels = {
+            tvl: 'Total Value Locked',
+            volume: '24h Trading Volume',
+            apr: 'Annual Percentage Rate',
+        };
+        const messages = [
+            `# DEX Leaderboard: Top Pools by ${metricLabels[metric]}`,
+            '',
+            '## Workflow',
+            '',
+            '1. **Fetch Leaderboard Data**',
+            `   - Call: gala_launchpad_fetch_current_dex_leaderboard`,
+            `   - Metric: ${metric}`,
+            `   - Limit: ${limit}`,
+            '',
+            '2. **Review Top Opportunities**',
+            '   - Identify leading pools',
+            '   - Check liquidity and activity',
+            '   - Analyze trading volume trends',
+            '',
+            '3. **Compare Metrics**',
+            `   - ${metricLabels[metric]} rankings`,
+            '   - Fee tier comparisons',
+            '   - Historical performance',
+            '',
+            '## Interpretation Guide',
+            '',
+            '**High TVL Pools:**',
+            '- Indicate liquidity and stability',
+            '- Lower slippage for trades',
+            '- More developed markets',
+            '',
+            '**High Volume Pools:**',
+            '- Show active trading',
+            '- May indicate price discovery',
+            '- Higher swap fees collected',
+            '',
+            '**High APR Pools:**',
+            '- Attract liquidity providers',
+            '- May have high fees or volume',
+            '- Risk: APR fluctuates with volume',
+            '',
+            '## Trading Strategy',
+            '',
+            '1. Find pools aligned with your assets',
+            '2. Compare across fee tiers',
+            '3. Evaluate slippage impact',
+            '4. Plan entry and exit points',
+        ];
+        return (0, handlerHelpers_js_1.createPromptResponse)(messages.join('\n'));
+    },
+};
+/**
+ * Tier 1 Pool Discovery Prompts Export
+ */
+exports.tier1PoolDiscoveryPrompts = [
+    exports.discoverPoolsPrompt,
+    exports.fetchAllPoolsPrompt,
+    exports.fetchPoolDetailsPrompt,
+    exports.checkLeaderboardPrompt,
+];
+//# sourceMappingURL=tier1-pool-discovery.js.map

package/dist/prompts/tier1-pool-discovery.js.map

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

package/dist/prompts/tier1-price-history.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Tier 1 Workflow: Price History and Trend Analysis
+ *
+ * High-impact workflow for historical pricing and technical analysis.
+ * Helps users understand price trends, volatility, and trading opportunities.
+ *
+ * Slash command: /galachain-launchpad:price-trends
+ */
+import type { MCPPrompt } from '../types/mcp.js';
+/**
+ * Price Trends - Comprehensive price history analysis workflow
+ */
+export declare const priceTrendsPrompt: MCPPrompt;
+/**
+ * Fetch Price History - Detailed historical price data
+ */
+export declare const fetchPriceHistoryPrompt: MCPPrompt;
+/**
+ * Fetch Current Price - Spot price lookup
+ */
+export declare const fetchCurrentPricePrompt: MCPPrompt;
+/**
+ * Fetch All Price History - Auto-paginated historical prices
+ */
+export declare const fetchAllPriceHistoryPrompt: MCPPrompt;
+/**
+ * Tier 1 Price History Prompts Export
+ */
+export declare const tier1PriceHistoryPrompts: MCPPrompt[];
+//# sourceMappingURL=tier1-price-history.d.ts.map

package/dist/prompts/tier1-price-history.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tier1-price-history.d.ts","sourceRoot":"","sources":["../../src/prompts/tier1-price-history.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAQjD;;GAEG;AACH,eAAO,MAAM,iBAAiB,EAAE,SAyI/B,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,uBAAuB,EAAE,SAmHrC,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,uBAAuB,EAAE,SAoErC,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,0BAA0B,EAAE,SAkFxC,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,wBAAwB,EAAE,SAAS,EAK/C,CAAC"}