@gala-chain/launchpad-mcp-server 1.27.2 → 2.0.1
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +110 -18
- package/dist/generated/version.d.ts +1 -1
- package/dist/generated/version.d.ts.map +1 -1
- package/dist/generated/version.js +1 -1
- package/dist/generated/version.js.map +1 -1
- package/dist/prompts/advanced-pools.d.ts +18 -0
- package/dist/prompts/advanced-pools.d.ts.map +1 -0
- package/dist/prompts/advanced-pools.js +90 -0
- package/dist/prompts/advanced-pools.js.map +1 -0
- package/dist/prompts/index.d.ts +7 -5
- package/dist/prompts/index.d.ts.map +1 -1
- package/dist/prompts/index.js +12 -4
- package/dist/prompts/index.js.map +1 -1
- package/dist/prompts/liquidity-positions.d.ts +12 -0
- package/dist/prompts/liquidity-positions.d.ts.map +1 -1
- package/dist/prompts/liquidity-positions.js +80 -1
- package/dist/prompts/liquidity-positions.js.map +1 -1
- package/dist/prompts/monitoring.d.ts +23 -0
- package/dist/prompts/monitoring.d.ts.map +1 -0
- package/dist/prompts/monitoring.js +169 -0
- package/dist/prompts/monitoring.js.map +1 -0
- package/dist/schemas/common-schemas.d.ts +42 -0
- package/dist/schemas/common-schemas.d.ts.map +1 -1
- package/dist/schemas/common-schemas.js +43 -1
- package/dist/schemas/common-schemas.js.map +1 -1
- package/dist/tools/balance/all-assets.d.ts +9 -0
- package/dist/tools/balance/all-assets.d.ts.map +1 -0
- package/dist/tools/balance/all-assets.js +104 -0
- package/dist/tools/balance/all-assets.js.map +1 -0
- package/dist/tools/dex/fetchAllDexPools.d.ts.map +1 -1
- package/dist/tools/dex/fetchAllDexPools.js +5 -0
- package/dist/tools/dex/fetchAllDexPools.js.map +1 -1
- package/dist/tools/dex/index.js +1 -1
- package/dist/tools/dex/index.js.map +1 -1
- package/dist/tools/dex/liquidity-positions.d.ts +1 -0
- package/dist/tools/dex/liquidity-positions.d.ts.map +1 -1
- package/dist/tools/dex/liquidity-positions.js +103 -29
- package/dist/tools/dex/liquidity-positions.js.map +1 -1
- package/dist/tools/dex/pool-price.d.ts +9 -0
- package/dist/tools/dex/pool-price.d.ts.map +1 -0
- package/dist/tools/dex/pool-price.js +78 -0
- package/dist/tools/dex/pool-price.js.map +1 -0
- package/dist/tools/dex/pool-quote-calculation.d.ts +9 -0
- package/dist/tools/dex/pool-quote-calculation.d.ts.map +1 -0
- package/dist/tools/dex/pool-quote-calculation.js +99 -0
- package/dist/tools/dex/pool-quote-calculation.js.map +1 -0
- package/dist/tools/dex/pool-quote-external.d.ts +10 -0
- package/dist/tools/dex/pool-quote-external.d.ts.map +1 -0
- package/dist/tools/dex/pool-quote-external.js +84 -0
- package/dist/tools/dex/pool-quote-external.js.map +1 -0
- package/dist/tools/dex/pool-quote-local.d.ts +10 -0
- package/dist/tools/dex/pool-quote-local.d.ts.map +1 -0
- package/dist/tools/dex/pool-quote-local.js +84 -0
- package/dist/tools/dex/pool-quote-local.js.map +1 -0
- package/dist/tools/dex/position-direct.d.ts +9 -0
- package/dist/tools/dex/position-direct.d.ts.map +1 -0
- package/dist/tools/dex/position-direct.js +65 -0
- package/dist/tools/dex/position-direct.js.map +1 -0
- package/dist/tools/index.d.ts +9 -9
- package/dist/tools/index.js +10 -10
- package/dist/tools/pools/composite-pool.d.ts +9 -0
- package/dist/tools/pools/composite-pool.d.ts.map +1 -0
- package/dist/tools/pools/composite-pool.js +69 -0
- package/dist/tools/pools/composite-pool.js.map +1 -0
- package/dist/tools/utils/cleanup.d.ts +9 -0
- package/dist/tools/utils/cleanup.d.ts.map +1 -0
- package/dist/tools/utils/cleanup.js +54 -0
- package/dist/tools/utils/cleanup.js.map +1 -0
- package/dist/tools/utils/faucet.d.ts +10 -0
- package/dist/tools/utils/faucet.d.ts.map +1 -0
- package/dist/tools/utils/faucet.js +51 -0
- package/dist/tools/utils/faucet.js.map +1 -0
- package/package.json +2 -2
package/README.md
CHANGED
|
@@ -4,13 +4,71 @@ MCP (Model Context Protocol) server for Gala Launchpad SDK - Enables AI agents t
|
|
|
4
4
|
|
|
5
5
|
## 🚀 Features
|
|
6
6
|
|
|
7
|
-
- **76 AI-accessible tools** for complete Gala Launchpad integration (includes
|
|
8
|
-
- **
|
|
7
|
+
- **76 AI-accessible tools** for complete Gala Launchpad integration (includes 22 pool management & event watcher tools, 13 trading operation tools, 8 balance & portfolio tools, 4 token creation tools, 2 transfer tools, 2 social/comment tools, 17 utility tools, 2 DEX pool discovery tools, 5 GSwap DEX trading tools)
|
|
8
|
+
- **78 slash commands** (prompts) for streamlined workflows - 89% tool coverage (every major operation has a corresponding slash command)
|
|
9
9
|
- **Type-safe** - Full TypeScript support with validated inputs
|
|
10
10
|
- **Production-ready** - Built on [@gala-chain/launchpad-sdk ](https://www.npmjs.com/package/@gala-chain/launchpad-sdk)
|
|
11
11
|
- **Easy setup** - Works with Claude Desktop and other MCP clients
|
|
12
|
-
- **Comprehensive** - Pool management, trading, balances, token creation, comments, transfers
|
|
13
|
-
- **Optimized** - Local bonding curve calculations for instant results
|
|
12
|
+
- **Comprehensive** - Pool management, trading, balances, token creation, comments, transfers, DEX trading, liquidity positions
|
|
13
|
+
- **Optimized** - Local bonding curve calculations and DEX quote calculations for instant results
|
|
14
|
+
- **Real-time monitoring** - WebSocket-based watchers for pool and token creation events
|
|
15
|
+
|
|
16
|
+
## What's New in v2.0.0
|
|
17
|
+
|
|
18
|
+
### New Tools (9 Total)
|
|
19
|
+
|
|
20
|
+
**High-Priority DEX & Pool Tools:**
|
|
21
|
+
- **gala_launchpad_fetch_composite_pool_data** - Fetch combined bonding curve + DEX pool data for comprehensive analysis
|
|
22
|
+
- **gala_launchpad_calculate_dex_pool_quote** - Calculate DEX pool swap quotes with local/external mode selection
|
|
23
|
+
- **gala_launchpad_get_swap_pool_price** - Get current price for token pair in DEX pool
|
|
24
|
+
- **gala_launchpad_get_all_swap_user_assets** - Get all user assets with auto-pagination
|
|
25
|
+
|
|
26
|
+
**Advanced DEX Quote Calculation:**
|
|
27
|
+
- **gala_launchpad_calculate_dex_pool_quote_local** - Local/offline DEX quote calculation (instant, no network)
|
|
28
|
+
- **gala_launchpad_calculate_dex_pool_quote_external** - External GalaChain DEX quotes (real-time blockchain data)
|
|
29
|
+
|
|
30
|
+
**Position Management:**
|
|
31
|
+
- **gala_launchpad_fetch_swap_position_by_id** - Direct LP position lookup by ID
|
|
32
|
+
|
|
33
|
+
**Testing & Utilities:**
|
|
34
|
+
- **gala_launchpad_retrieve_from_faucet** - Test utility for faucet GALA retrieval (dev/test only)
|
|
35
|
+
- **gala_launchpad_cleanup** - SDK lifecycle cleanup utility
|
|
36
|
+
|
|
37
|
+
### New Prompts (3 Total)
|
|
38
|
+
|
|
39
|
+
**Real-Time Monitoring:**
|
|
40
|
+
- **galachain-launchpad:watch-dex-pools** - Monitor new DEX pool creation events via WebSocket
|
|
41
|
+
- **galachain-launchpad:watch-token-launches** - Monitor new token launch events via WebSocket
|
|
42
|
+
|
|
43
|
+
**Advanced Pool Analysis:**
|
|
44
|
+
- **galachain-launchpad:fetch-pool-details** - Comprehensive bonding curve pool analytics
|
|
45
|
+
|
|
46
|
+
### Tool Coverage
|
|
47
|
+
|
|
48
|
+
- **76 total MCP tools** (full coverage of Gala Launchpad features)
|
|
49
|
+
- **78 total prompts** (up from 75 in v1.x)
|
|
50
|
+
- **89% tool→prompt coverage** (70/78 tools have dedicated prompts)
|
|
51
|
+
- **New focus**: DEX ecosystem integration, real-time monitoring, advanced quote calculations
|
|
52
|
+
|
|
53
|
+
### Category Breakdown
|
|
54
|
+
|
|
55
|
+
| Category | Tool Count | Change | Key Features |
|
|
56
|
+
|----------|------------|--------|--------------|
|
|
57
|
+
| **Pool Management** | 22 | +3 | Composite pool data, real-time watchers, advanced analytics |
|
|
58
|
+
| **DEX Trading** | 22 | +5 | Local/external quote calculation, pool pricing, position lookup |
|
|
59
|
+
| **Balance & Portfolio** | 8 | +1 | Auto-paginated asset queries, complete portfolio data |
|
|
60
|
+
| **Trading Operations** | 13 | - | Buy, sell, calculate amounts, graduation |
|
|
61
|
+
| **Utilities** | 17 | +2 | Faucet access, SDK cleanup, advanced debugging |
|
|
62
|
+
| **Creation** | 4 | - | Token launch, image upload |
|
|
63
|
+
| **Social** | 2 | - | Comments and interactions |
|
|
64
|
+
| **Transfers** | 2 | - | GALA and token transfers |
|
|
65
|
+
|
|
66
|
+
### Performance Improvements
|
|
67
|
+
|
|
68
|
+
- **Local DEX quote calculation** - Instant results without network calls
|
|
69
|
+
- **Composite pool data** - Single call for bonding curve + DEX metrics
|
|
70
|
+
- **Auto-paginated queries** - Fetch all assets without manual pagination
|
|
71
|
+
- **WebSocket monitoring** - Real-time updates for pools and token launches
|
|
14
72
|
|
|
15
73
|
## 📦 Installation
|
|
16
74
|
|
|
@@ -98,13 +156,14 @@ Use the wallet management tools to upgrade or switch wallets at runtime:
|
|
|
98
156
|
- `gala_launchpad_set_wallet` - Upgrade from read-only to full-access mode
|
|
99
157
|
- `gala_launchpad_get_wallet` - Retrieve wallet information
|
|
100
158
|
|
|
101
|
-
## 🛠️ Available Tools (
|
|
159
|
+
## 🛠️ Available Tools (88 Total)
|
|
102
160
|
|
|
103
|
-
### Pool Management, Pricing & Event Watchers (
|
|
161
|
+
### Pool Management, Pricing & Event Watchers (22 tools)
|
|
104
162
|
- `gala_launchpad_fetch_pools` - Fetch token pools with filtering
|
|
105
163
|
- `gala_launchpad_fetch_all_pools` - Fetch all available pools with automatic pagination
|
|
106
164
|
- `gala_launchpad_fetch_pool_details` - Get detailed pool state
|
|
107
165
|
- `gala_launchpad_fetch_pool_details_for_calculation` - Get optimized pool details for local calculations
|
|
166
|
+
- `gala_launchpad_fetch_composite_pool_data` - **NEW v2.0** - Fetch combined bonding curve + DEX pool data
|
|
108
167
|
- `gala_launchpad_fetch_token_distribution` - Get holder distribution
|
|
109
168
|
- `gala_launchpad_fetch_token_badges` - Get achievement badges
|
|
110
169
|
- `gala_launchpad_fetch_volume_data` - Get OHLCV charting data
|
|
@@ -121,9 +180,9 @@ Use the wallet management tools to upgrade or switch wallets at runtime:
|
|
|
121
180
|
- `gala_launchpad_on_dex_pool_creation` - Watch for new DEX pool creation events
|
|
122
181
|
- `gala_launchpad_on_launchpad_token_creation` - Watch for new launchpad token creation events
|
|
123
182
|
|
|
124
|
-
#### 🔔 Event Watchers (2 tools) -
|
|
183
|
+
#### 🔔 Event Watchers (2 tools) - Real-Time Monitoring
|
|
125
184
|
|
|
126
|
-
**Real-time pool and token discovery with
|
|
185
|
+
**Real-time pool and token discovery with WebSocket-based watchers:**
|
|
127
186
|
|
|
128
187
|
**`gala_launchpad_on_dex_pool_creation` - Watch for DEX Pool Creation**
|
|
129
188
|
|
|
@@ -338,7 +397,7 @@ const result2 = await gala_launchpad_graduate_token({
|
|
|
338
397
|
|
|
339
398
|
**Accuracy:** Local calculations match external (network) with <0.01% difference.
|
|
340
399
|
|
|
341
|
-
### DEX Pool Discovery (2 tools)
|
|
400
|
+
### DEX Pool Discovery (2 tools)
|
|
342
401
|
|
|
343
402
|
**Discover and explore GalaSwap DEX liquidity pools with filtering, sorting, and pagination:**
|
|
344
403
|
|
|
@@ -352,7 +411,7 @@ const result2 = await gala_launchpad_graduate_token({
|
|
|
352
411
|
- 🚀 **Auto-pagination** - Fetch all pools automatically with `fetchAllDexPools`
|
|
353
412
|
- 💰 **Complete pool data** - TVL, fees, APR, volume metrics, and token pricing
|
|
354
413
|
|
|
355
|
-
### GSwap DEX Trading (
|
|
414
|
+
### GSwap DEX Trading (22 tools)
|
|
356
415
|
|
|
357
416
|
**Real-time DEX trading for graduated tokens with slippage protection:**
|
|
358
417
|
|
|
@@ -360,7 +419,14 @@ const result2 = await gala_launchpad_graduate_token({
|
|
|
360
419
|
- `gala_launchpad_get_swap_quote_exact_output` - Get swap quote for exact desired output
|
|
361
420
|
- `gala_launchpad_execute_swap` - Execute token swap on GalaSwap DEX with slippage protection
|
|
362
421
|
- `gala_launchpad_get_swap_user_assets` - Get user token balances across all DEX pools
|
|
422
|
+
- `gala_launchpad_get_all_swap_user_assets` - **NEW v2.0** - Get all user assets with auto-pagination
|
|
363
423
|
- `gala_launchpad_get_swap_pool_info` - Get liquidity and fee tier information for token pairs
|
|
424
|
+
- `gala_launchpad_get_swap_pool_price` - **NEW v2.0** - Get current price for token pair in DEX pool
|
|
425
|
+
- `gala_launchpad_calculate_dex_pool_quote` - **NEW v2.0** - Calculate DEX pool quotes (local or external mode)
|
|
426
|
+
- `gala_launchpad_calculate_dex_pool_quote_local` - **NEW v2.0** - Local/offline DEX quote calculation
|
|
427
|
+
- `gala_launchpad_calculate_dex_pool_quote_external` - **NEW v2.0** - External GalaChain DEX quotes
|
|
428
|
+
- **10 liquidity position tools** - Add, remove, collect fees, query positions
|
|
429
|
+
- `gala_launchpad_fetch_swap_position_by_id` - **NEW v2.0** - Direct LP position lookup by ID
|
|
364
430
|
|
|
365
431
|
**Complete DEX Trading Workflow Example:**
|
|
366
432
|
|
|
@@ -404,6 +470,7 @@ const assets = await gala_launchpad_get_swap_user_assets({
|
|
|
404
470
|
- ✅ **Multi-format tokens** - Supports simple names ('GALA') or full token IDs ('GALA|Unit|none|none')
|
|
405
471
|
- ✅ **Fee Tiers** - Automatic detection of available liquidity pools (0.05%, 0.3%, 1.0%)
|
|
406
472
|
- ✅ **Environment-aligned** - Uses same URLs as LaunchpadSDK (STAGE/PROD cannot be mixed)
|
|
473
|
+
- ✅ **Local Quote Calculation** - **NEW v2.0** - Instant offline DEX quotes for high-frequency operations
|
|
407
474
|
|
|
408
475
|
#### 📊 Historical Price Analysis
|
|
409
476
|
|
|
@@ -500,13 +567,15 @@ Ask Claude:
|
|
|
500
567
|
|
|
501
568
|
> "Show me the most and least expensive tokens right now"
|
|
502
569
|
|
|
503
|
-
### Balance & Portfolio (
|
|
570
|
+
### Balance & Portfolio (8 tools)
|
|
504
571
|
- `gala_launchpad_fetch_gala_balance` - Get GALA balance
|
|
505
572
|
- `gala_launchpad_fetch_token_balance` - Get token balance
|
|
506
573
|
- `gala_launchpad_fetch_tokens_held` - Get portfolio holdings
|
|
507
574
|
- `gala_launchpad_fetch_tokens_created` - Get created tokens
|
|
508
575
|
- `gala_launchpad_fetch_profile` - Get user profile
|
|
509
576
|
- `gala_launchpad_update_profile` - Update profile
|
|
577
|
+
- `gala_launchpad_get_swap_user_assets` - Get user token balances from DEX
|
|
578
|
+
- `gala_launchpad_get_all_swap_user_assets` - **NEW v2.0** - Get all user assets with auto-pagination
|
|
510
579
|
|
|
511
580
|
### Wallet Management (3 tools)
|
|
512
581
|
- `gala_launchpad_has_wallet` - Check if wallet is configured
|
|
@@ -527,7 +596,7 @@ Ask Claude:
|
|
|
527
596
|
- `gala_launchpad_transfer_gala` - Transfer GALA tokens
|
|
528
597
|
- `gala_launchpad_transfer_token` - Transfer launchpad tokens
|
|
529
598
|
|
|
530
|
-
### Utility Tools (
|
|
599
|
+
### Utility Tools (17 tools)
|
|
531
600
|
- `gala_launchpad_create_wallet` - Create new GalaChain wallet
|
|
532
601
|
- `gala_launchpad_get_address` - Get user's GalaChain address
|
|
533
602
|
- `gala_launchpad_get_ethereum_address` - Get user's Ethereum address
|
|
@@ -542,6 +611,9 @@ Ask Claude:
|
|
|
542
611
|
- `gala_launchpad_get_environment` - Get current MCP server environment
|
|
543
612
|
- `gala_launchpad_switch_environment` - Switch MCP server environment
|
|
544
613
|
- `gala_launchpad_get_version` - Get SDK and MCP server version information
|
|
614
|
+
- `gala_launchpad_is_token_graduated` - Check if token has completed bonding curve
|
|
615
|
+
- `gala_launchpad_retrieve_from_faucet` - **NEW v2.0** - Test utility for faucet GALA retrieval
|
|
616
|
+
- `gala_launchpad_cleanup` - **NEW v2.0** - SDK lifecycle cleanup utility
|
|
545
617
|
|
|
546
618
|
## 💡 Example Usage
|
|
547
619
|
|
|
@@ -557,9 +629,13 @@ Ask Claude (or your AI assistant):
|
|
|
557
629
|
|
|
558
630
|
> "Show me all tokens I'm holding"
|
|
559
631
|
|
|
560
|
-
|
|
632
|
+
> "Watch for new DEX pool creation for the next 5 minutes"
|
|
561
633
|
|
|
562
|
-
|
|
634
|
+
> "Get the current GALA/GUSDC price from the DEX pool"
|
|
635
|
+
|
|
636
|
+
## ⚡ Slash Commands (Prompts) - 78 Total
|
|
637
|
+
|
|
638
|
+
The MCP server exposes **78 slash commands** (prompts) for streamlined workflows with 89% tool coverage - every major operation has a corresponding slash command for quick access. These appear as `/galachain-launchpad:<<method>>` in Claude Desktop.
|
|
563
639
|
|
|
564
640
|
### Trading Commands (4 commands)
|
|
565
641
|
|
|
@@ -666,23 +742,38 @@ The MCP server exposes **74 slash commands** (prompts) for complete 1:1 mapping
|
|
|
666
742
|
- **Example**: `/galachain-launchpad:discover-tokens type=near-graduation minProgress=90 limit=10`
|
|
667
743
|
- Helps find investment opportunities with filtering and analysis
|
|
668
744
|
|
|
669
|
-
###
|
|
745
|
+
### Real-Time Monitoring Commands (2 commands) - NEW v2.0
|
|
746
|
+
|
|
747
|
+
**`/galachain-launchpad:watch-dex-pools`** - **NEW v2.0**
|
|
748
|
+
- Monitor new DEX pool creation events in real-time via WebSocket
|
|
749
|
+
- **Arguments**: `duration` (optional: seconds, default 60), `minTVL` (optional: minimum TVL filter), `tokens` (optional: comma-separated token symbols)
|
|
750
|
+
- **Example**: `/galachain-launchpad:watch-dex-pools duration=300 minTVL=100000 tokens=GALA,GUSDC`
|
|
751
|
+
- Real-time alerts as new liquidity pools are created
|
|
752
|
+
|
|
753
|
+
**`/galachain-launchpad:watch-token-launches`** - **NEW v2.0**
|
|
754
|
+
- Monitor new token launch events in real-time via WebSocket
|
|
755
|
+
- **Arguments**: `duration` (optional: seconds, default 60), `creatorAddress` (optional: filter by creator)
|
|
756
|
+
- **Example**: `/galachain-launchpad:watch-token-launches duration=300 creatorAddress=eth|0x...`
|
|
757
|
+
- Discover new tokens immediately as they launch
|
|
758
|
+
|
|
759
|
+
### DEX Pool Discovery Commands (2 commands)
|
|
670
760
|
|
|
671
|
-
**`/galachain-launchpad:fetch-dex-pools`**
|
|
761
|
+
**`/galachain-launchpad:fetch-dex-pools`**
|
|
672
762
|
- Discover DEX liquidity pools with pagination and filtering
|
|
673
763
|
- **Arguments**: `search` (optional: token symbol filter), `sortBy` (optional: tvl/volume30d/volume1d, default: tvl), `sortOrder` (optional: asc/desc, default: desc), `page` (optional, default: 1), `limit` (optional, default: 10, max: 20)
|
|
674
764
|
- **Example**: `/galachain-launchpad:fetch-dex-pools search=GALA sortBy=volume30d limit=10`
|
|
675
765
|
- Browse DEX pools with complete metrics: TVL, trading volume, APR, and fee data
|
|
676
766
|
|
|
677
|
-
**`/galachain-launchpad:fetch-all-dex-pools`**
|
|
767
|
+
**`/galachain-launchpad:fetch-all-dex-pools`**
|
|
678
768
|
- Discover ALL available DEX liquidity pools with automatic pagination
|
|
679
769
|
- **Arguments**: `search` (optional: token symbol filter), `sortBy` (optional: tvl/volume30d/volume1d, default: tvl), `sortOrder` (optional: asc/desc, default: desc)
|
|
680
770
|
- **Example**: `/galachain-launchpad:fetch-all-dex-pools search=GUSDC sortBy=volume1d sortOrder=asc`
|
|
681
771
|
- Retrieves the complete list of all DEX pools - perfect for comprehensive analysis and discovery
|
|
682
772
|
|
|
683
|
-
### Pool Management Commands (
|
|
773
|
+
### Pool Management Commands (14 commands)
|
|
684
774
|
|
|
685
775
|
**`/galachain-launchpad:fetch-pools`** - Fetch token pools with filtering
|
|
776
|
+
**`/galachain-launchpad:fetch-pool-details`** - **NEW v2.0** - Get comprehensive bonding curve pool analytics
|
|
686
777
|
**`/galachain-launchpad:fetch-pool-details-for-calculation`** - Get optimized pool details for local calculations
|
|
687
778
|
**`/galachain-launchpad:fetch-token-details`** - Fetch comprehensive token metadata
|
|
688
779
|
**`/galachain-launchpad:fetch-token-distribution`** - Get holder distribution and supply metrics
|
|
@@ -761,6 +852,7 @@ The MCP server exposes **74 slash commands** (prompts) for complete 1:1 mapping
|
|
|
761
852
|
✅ **Optimized** - Uses LOCAL calculations for maximum performance
|
|
762
853
|
✅ **Safe** - Asks for confirmation before executing transactions
|
|
763
854
|
✅ **Educational** - Shows what MCP tools are being used behind the scenes
|
|
855
|
+
✅ **Real-time monitoring** - **NEW v2.0** - WebSocket watchers for pools and token launches
|
|
764
856
|
|
|
765
857
|
### Example Slash Command Usage
|
|
766
858
|
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"version.d.ts","sourceRoot":"","sources":["../../src/generated/version.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,eAAO,MAAM,kBAAkB,
|
|
1
|
+
{"version":3,"file":"version.d.ts","sourceRoot":"","sources":["../../src/generated/version.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,eAAO,MAAM,kBAAkB,UAAU,CAAC"}
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"version.js","sourceRoot":"","sources":["../../src/generated/version.ts"],"names":[],"mappings":";AAAA;;;;GAIG;;;AAEU,QAAA,kBAAkB,GAAG,
|
|
1
|
+
{"version":3,"file":"version.js","sourceRoot":"","sources":["../../src/generated/version.ts"],"names":[],"mappings":";AAAA;;;;GAIG;;;AAEU,QAAA,kBAAkB,GAAG,OAAO,CAAC"}
|
|
@@ -0,0 +1,18 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Advanced Pool Management Prompts
|
|
3
|
+
*
|
|
4
|
+
* Slash commands for detailed pool analysis and bonding curve operations
|
|
5
|
+
*/
|
|
6
|
+
import type { MCPPrompt } from '../types/mcp.js';
|
|
7
|
+
/**
|
|
8
|
+
* Fetch Pool Details - Complete bonding curve pool data
|
|
9
|
+
*
|
|
10
|
+
* Retrieves comprehensive pool analytics including supply metrics, graduation status,
|
|
11
|
+
* fee structure, and historical performance data
|
|
12
|
+
*/
|
|
13
|
+
export declare const fetchPoolDetailsPrompt: MCPPrompt;
|
|
14
|
+
/**
|
|
15
|
+
* Export all advanced pool prompts
|
|
16
|
+
*/
|
|
17
|
+
export declare const advancedPoolPrompts: MCPPrompt[];
|
|
18
|
+
//# sourceMappingURL=advanced-pools.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"advanced-pools.d.ts","sourceRoot":"","sources":["../../src/prompts/advanced-pools.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAMjD;;;;;GAKG;AACH,eAAO,MAAM,sBAAsB,EAAE,SAqEpC,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,mBAAmB,EAAE,SAAS,EAA6B,CAAC"}
|
|
@@ -0,0 +1,90 @@
|
|
|
1
|
+
"use strict";
|
|
2
|
+
/**
|
|
3
|
+
* Advanced Pool Management Prompts
|
|
4
|
+
*
|
|
5
|
+
* Slash commands for detailed pool analysis and bonding curve operations
|
|
6
|
+
*/
|
|
7
|
+
Object.defineProperty(exports, "__esModule", { value: true });
|
|
8
|
+
exports.advancedPoolPrompts = exports.fetchPoolDetailsPrompt = void 0;
|
|
9
|
+
const mcpToolNames_js_1 = require("../constants/mcpToolNames.js");
|
|
10
|
+
const validation_js_1 = require("../utils/validation.js");
|
|
11
|
+
const handlerHelpers_js_1 = require("./utils/handlerHelpers.js");
|
|
12
|
+
/**
|
|
13
|
+
* Fetch Pool Details - Complete bonding curve pool data
|
|
14
|
+
*
|
|
15
|
+
* Retrieves comprehensive pool analytics including supply metrics, graduation status,
|
|
16
|
+
* fee structure, and historical performance data
|
|
17
|
+
*/
|
|
18
|
+
exports.fetchPoolDetailsPrompt = {
|
|
19
|
+
name: 'galachain-launchpad:fetch-pool-details',
|
|
20
|
+
description: 'Get detailed bonding curve pool analytics including supply, fees, graduation status, and performance metrics',
|
|
21
|
+
arguments: [
|
|
22
|
+
{
|
|
23
|
+
name: 'tokenName',
|
|
24
|
+
description: 'Token name to analyze (e.g., anime, test216253)',
|
|
25
|
+
required: true,
|
|
26
|
+
},
|
|
27
|
+
],
|
|
28
|
+
handler: (args) => {
|
|
29
|
+
(0, validation_js_1.validateTokenName)(args.tokenName);
|
|
30
|
+
return (0, handlerHelpers_js_1.createPromptResponse)(`Fetch comprehensive bonding curve pool details for ${args.tokenName}.
|
|
31
|
+
|
|
32
|
+
**Pool Analysis:**
|
|
33
|
+
Get complete bonding curve pool data for trading decisions, graduation planning, and pool health assessment.
|
|
34
|
+
|
|
35
|
+
**Data Retrieved:**
|
|
36
|
+
- **Supply Metrics**: Current supply, max supply, remaining tokens, graduation progress
|
|
37
|
+
- **Pool Status**: Active, graduated, or pending
|
|
38
|
+
- **Fee Structure**: Transaction fees, reverse bonding curve fees, creator fees
|
|
39
|
+
- **Vault Information**: GalaChain vault address and balances
|
|
40
|
+
- **Creator Details**: Token creator address and initial configuration
|
|
41
|
+
- **Trading Status**: Whether pool is active for trading
|
|
42
|
+
- **Graduation Metrics**: Percentage complete, tokens remaining until graduation
|
|
43
|
+
|
|
44
|
+
**Workflow:**
|
|
45
|
+
1. Query GalaChain for pool state
|
|
46
|
+
2. Calculate derived metrics (graduation %, supply ratios)
|
|
47
|
+
3. Retrieve fee configuration
|
|
48
|
+
4. Get vault and creator information
|
|
49
|
+
5. Compile comprehensive pool analysis
|
|
50
|
+
|
|
51
|
+
**Use Cases:**
|
|
52
|
+
1. **Pre-Trade Analysis**: Verify pool is active and has sufficient liquidity
|
|
53
|
+
2. **Graduation Planning**: Calculate how many tokens needed to graduate
|
|
54
|
+
3. **Fee Assessment**: Understand transaction costs before trading
|
|
55
|
+
4. **Pool Health Check**: Monitor supply levels and trading status
|
|
56
|
+
5. **Investment Research**: Analyze pool fundamentals before buying
|
|
57
|
+
|
|
58
|
+
**Key Metrics Explained:**
|
|
59
|
+
- **currentSupply**: Tokens currently in circulation (includes bonding curve + user wallets)
|
|
60
|
+
- **maxSupply**: Total tokens that will exist when fully graduated
|
|
61
|
+
- **remainingTokens**: Tokens still locked in bonding curve
|
|
62
|
+
- **graduationProgress**: Percentage toward graduation (currentSupply / maxSupply)
|
|
63
|
+
|
|
64
|
+
**Difference from fetch-pool-details-for-calculation:**
|
|
65
|
+
- This tool provides FULL pool data including vault info, creator details, status
|
|
66
|
+
- fetch-pool-details-for-calculation provides ONLY data needed for bonding curve math
|
|
67
|
+
- Use this for comprehensive analysis; use calculation variant for price quotes
|
|
68
|
+
|
|
69
|
+
**Related Tools:**
|
|
70
|
+
- Use ${mcpToolNames_js_1.MCP_TOOLS.FETCH_POOL_DETAILS_FOR_CALCULATION} for lightweight bonding curve calculations
|
|
71
|
+
- Use ${mcpToolNames_js_1.MCP_TOOLS.CALCULATE_BUY_AMOUNT_FOR_GRADUATION} to plan graduation cost
|
|
72
|
+
- Use ${mcpToolNames_js_1.MCP_TOOLS.FETCH_TOKEN_DISTRIBUTION} to analyze holder concentration
|
|
73
|
+
|
|
74
|
+
**Important Notes:**
|
|
75
|
+
- Pool details are cached briefly for performance
|
|
76
|
+
- Supply metrics update in real-time after each trade
|
|
77
|
+
- Graduated pools return historical bonding curve data
|
|
78
|
+
- Fee structures can vary by token creator configuration
|
|
79
|
+
|
|
80
|
+
Please use the following MCP tool:
|
|
81
|
+
- ${mcpToolNames_js_1.MCP_TOOLS.FETCH_POOL_DETAILS}: Retrieve comprehensive pool details
|
|
82
|
+
|
|
83
|
+
Proceed with fetching pool details.`);
|
|
84
|
+
},
|
|
85
|
+
};
|
|
86
|
+
/**
|
|
87
|
+
* Export all advanced pool prompts
|
|
88
|
+
*/
|
|
89
|
+
exports.advancedPoolPrompts = [exports.fetchPoolDetailsPrompt];
|
|
90
|
+
//# sourceMappingURL=advanced-pools.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"advanced-pools.js","sourceRoot":"","sources":["../../src/prompts/advanced-pools.ts"],"names":[],"mappings":";AAAA;;;;GAIG;;;AAGH,kEAAyD;AACzD,0DAA2D;AAC3D,iEAAiE;AAGjE;;;;;GAKG;AACU,QAAA,sBAAsB,GAAc;IAC/C,IAAI,EAAE,wCAAwC;IAC9C,WAAW,EACT,8GAA8G;IAChH,SAAS,EAAE;QACT;YACE,IAAI,EAAE,WAAW;YACjB,WAAW,EAAE,iDAAiD;YAC9D,QAAQ,EAAE,IAAI;SACf;KACF;IACD,OAAO,EAAE,CAAC,IAAI,EAAE,EAAE;QAChB,IAAA,iCAAiB,EAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QAElC,OAAO,IAAA,wCAAoB,EAAC,sDAAsD,IAAI,CAAC,SAAS;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;QAwC5F,2BAAS,CAAC,kCAAkC;QAC5C,2BAAS,CAAC,mCAAmC;QAC7C,2BAAS,CAAC,wBAAwB;;;;;;;;;IAStC,2BAAS,CAAC,kBAAkB;;oCAEI,CAAC,CAAC;IACpC,CAAC;CACF,CAAC;AAEF;;GAEG;AACU,QAAA,mBAAmB,GAAgB,CAAC,8BAAsB,CAAC,CAAC"}
|
package/dist/prompts/index.d.ts
CHANGED
|
@@ -19,9 +19,11 @@ import { creationUtilityPrompts } from './creation-utils.js';
|
|
|
19
19
|
import { socialPrompts } from './social.js';
|
|
20
20
|
import { transferPrompts } from './transfers.js';
|
|
21
21
|
import { utilityToolPrompts } from './utility-tools.js';
|
|
22
|
+
import { monitoringPrompts } from './monitoring.js';
|
|
23
|
+
import { advancedPoolPrompts } from './advanced-pools.js';
|
|
22
24
|
import type { MCPPrompt } from '../types/mcp.js';
|
|
23
25
|
/**
|
|
24
|
-
* All available prompts (
|
|
26
|
+
* All available prompts (78 total - added monitoring and advanced pool prompts)
|
|
25
27
|
*/
|
|
26
28
|
export declare const prompts: MCPPrompt[];
|
|
27
29
|
/**
|
|
@@ -68,7 +70,7 @@ export declare function hasPrompt(name: string): boolean;
|
|
|
68
70
|
/**
|
|
69
71
|
* Get prompts by category
|
|
70
72
|
*
|
|
71
|
-
* @param category - Category name ('trading', 'portfolio', 'analysis', 'creation', 'discovery', 'dex', or 'utility')
|
|
73
|
+
* @param category - Category name ('trading', 'portfolio', 'analysis', 'creation', 'discovery', 'dex', 'liquidity', 'monitoring', or 'utility')
|
|
72
74
|
* @returns Array of prompts in the specified category
|
|
73
75
|
*
|
|
74
76
|
* @example
|
|
@@ -79,7 +81,7 @@ export declare function hasPrompt(name: string): boolean;
|
|
|
79
81
|
* // Returns [dexSwapPrompt]
|
|
80
82
|
* ```
|
|
81
83
|
*/
|
|
82
|
-
export declare function getPromptsByCategory(category: 'trading' | 'portfolio' | 'analysis' | 'creation' | 'discovery' | 'dex' | 'liquidity' | 'utility'): MCPPrompt[];
|
|
84
|
+
export declare function getPromptsByCategory(category: 'trading' | 'portfolio' | 'analysis' | 'creation' | 'discovery' | 'dex' | 'liquidity' | 'monitoring' | 'utility'): MCPPrompt[];
|
|
83
85
|
/**
|
|
84
86
|
* Get prompt count
|
|
85
87
|
*
|
|
@@ -87,12 +89,12 @@ export declare function getPromptsByCategory(category: 'trading' | 'portfolio' |
|
|
|
87
89
|
*
|
|
88
90
|
* @example
|
|
89
91
|
* ```typescript
|
|
90
|
-
* console.log(`Total prompts: ${getPromptCount()}`); // Total prompts:
|
|
92
|
+
* console.log(`Total prompts: ${getPromptCount()}`); // Total prompts: 78
|
|
91
93
|
* ```
|
|
92
94
|
*/
|
|
93
95
|
export declare function getPromptCount(): number;
|
|
94
96
|
/**
|
|
95
97
|
* Export individual prompt categories for documentation
|
|
96
98
|
*/
|
|
97
|
-
export { tradingPrompts, portfolioPrompts, analysisPrompts, creationPrompts, discoveryPrompts, dexTradingPrompts, exploreDexPoolsPrompts, liquidityPositionPrompts, utilityPrompts, poolPrompts, tradingCalculationPrompts, balancePrompts, creationUtilityPrompts, socialPrompts, transferPrompts, utilityToolPrompts, };
|
|
99
|
+
export { tradingPrompts, portfolioPrompts, analysisPrompts, creationPrompts, discoveryPrompts, dexTradingPrompts, exploreDexPoolsPrompts, liquidityPositionPrompts, utilityPrompts, poolPrompts, tradingCalculationPrompts, balancePrompts, creationUtilityPrompts, socialPrompts, transferPrompts, utilityToolPrompts, monitoringPrompts, advancedPoolPrompts, };
|
|
98
100
|
//# sourceMappingURL=index.d.ts.map
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/prompts/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAC9C,OAAO,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAClD,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAChD,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAC9C,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AACxD,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AACrD,OAAO,EAAE,sBAAsB,EAAE,MAAM,wBAAwB,CAAC;AAChE,OAAO,EAAE,wBAAwB,EAAE,MAAM,0BAA0B,CAAC;AACpE,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AACzC,OAAO,EAAE,yBAAyB,EAAE,MAAM,2BAA2B,CAAC;AACtE,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAC/C,OAAO,EAAE,sBAAsB,EAAE,MAAM,qBAAqB,CAAC;AAC7D,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AACjD,OAAO,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AACxD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAEjD;;GAEG;AACH,eAAO,MAAM,OAAO,EAAE,SAAS,
|
|
1
|
+
{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/prompts/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAC9C,OAAO,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAClD,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAChD,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAC9C,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AACxD,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AACrD,OAAO,EAAE,sBAAsB,EAAE,MAAM,wBAAwB,CAAC;AAChE,OAAO,EAAE,wBAAwB,EAAE,MAAM,0BAA0B,CAAC;AACpE,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AACzC,OAAO,EAAE,yBAAyB,EAAE,MAAM,2BAA2B,CAAC;AACtE,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAC/C,OAAO,EAAE,sBAAsB,EAAE,MAAM,qBAAqB,CAAC;AAC7D,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AACjD,OAAO,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AACxD,OAAO,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AACpD,OAAO,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAC1D,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAEjD;;GAEG;AACH,eAAO,MAAM,OAAO,EAAE,SAAS,EAmB9B,CAAC;AAUF;;;;;;;;;;;;;GAaG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,GAAG,SAAS,CAE7D;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,cAAc,IAAI,MAAM,EAAE,CAEzC;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAE/C;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,oBAAoB,CAClC,QAAQ,EAAE,SAAS,GAAG,WAAW,GAAG,UAAU,GAAG,UAAU,GAAG,WAAW,GAAG,KAAK,GAAG,WAAW,GAAG,YAAY,GAAG,SAAS,GACzH,SAAS,EAAE,CAuBb;AAED;;;;;;;;;GASG;AACH,wBAAgB,cAAc,IAAI,MAAM,CAEvC;AAED;;GAEG;AACH,OAAO,EACL,cAAc,EACd,gBAAgB,EAChB,eAAe,EACf,eAAe,EACf,gBAAgB,EAChB,iBAAiB,EACjB,sBAAsB,EACtB,wBAAwB,EACxB,cAAc,EACd,WAAW,EACX,yBAAyB,EACzB,cAAc,EACd,sBAAsB,EACtB,aAAa,EACb,eAAe,EACf,kBAAkB,EAClB,iBAAiB,EACjB,mBAAmB,GACpB,CAAC"}
|
package/dist/prompts/index.js
CHANGED
|
@@ -5,7 +5,7 @@
|
|
|
5
5
|
* Provides user-friendly slash commands for common Launchpad workflows
|
|
6
6
|
*/
|
|
7
7
|
Object.defineProperty(exports, "__esModule", { value: true });
|
|
8
|
-
exports.utilityToolPrompts = exports.transferPrompts = exports.socialPrompts = exports.creationUtilityPrompts = exports.balancePrompts = exports.tradingCalculationPrompts = exports.poolPrompts = exports.utilityPrompts = exports.liquidityPositionPrompts = exports.exploreDexPoolsPrompts = exports.dexTradingPrompts = exports.discoveryPrompts = exports.creationPrompts = exports.analysisPrompts = exports.portfolioPrompts = exports.tradingPrompts = exports.prompts = void 0;
|
|
8
|
+
exports.advancedPoolPrompts = exports.monitoringPrompts = exports.utilityToolPrompts = exports.transferPrompts = exports.socialPrompts = exports.creationUtilityPrompts = exports.balancePrompts = exports.tradingCalculationPrompts = exports.poolPrompts = exports.utilityPrompts = exports.liquidityPositionPrompts = exports.exploreDexPoolsPrompts = exports.dexTradingPrompts = exports.discoveryPrompts = exports.creationPrompts = exports.analysisPrompts = exports.portfolioPrompts = exports.tradingPrompts = exports.prompts = void 0;
|
|
9
9
|
exports.getPrompt = getPrompt;
|
|
10
10
|
exports.getPromptNames = getPromptNames;
|
|
11
11
|
exports.hasPrompt = hasPrompt;
|
|
@@ -43,8 +43,12 @@ const transfers_js_1 = require("./transfers.js");
|
|
|
43
43
|
Object.defineProperty(exports, "transferPrompts", { enumerable: true, get: function () { return transfers_js_1.transferPrompts; } });
|
|
44
44
|
const utility_tools_js_1 = require("./utility-tools.js");
|
|
45
45
|
Object.defineProperty(exports, "utilityToolPrompts", { enumerable: true, get: function () { return utility_tools_js_1.utilityToolPrompts; } });
|
|
46
|
+
const monitoring_js_1 = require("./monitoring.js");
|
|
47
|
+
Object.defineProperty(exports, "monitoringPrompts", { enumerable: true, get: function () { return monitoring_js_1.monitoringPrompts; } });
|
|
48
|
+
const advanced_pools_js_1 = require("./advanced-pools.js");
|
|
49
|
+
Object.defineProperty(exports, "advancedPoolPrompts", { enumerable: true, get: function () { return advanced_pools_js_1.advancedPoolPrompts; } });
|
|
46
50
|
/**
|
|
47
|
-
* All available prompts (
|
|
51
|
+
* All available prompts (78 total - added monitoring and advanced pool prompts)
|
|
48
52
|
*/
|
|
49
53
|
exports.prompts = [
|
|
50
54
|
...trading_js_1.tradingPrompts,
|
|
@@ -63,6 +67,8 @@ exports.prompts = [
|
|
|
63
67
|
...social_js_1.socialPrompts,
|
|
64
68
|
...transfers_js_1.transferPrompts,
|
|
65
69
|
...utility_tools_js_1.utilityToolPrompts,
|
|
70
|
+
...monitoring_js_1.monitoringPrompts,
|
|
71
|
+
...advanced_pools_js_1.advancedPoolPrompts,
|
|
66
72
|
];
|
|
67
73
|
/**
|
|
68
74
|
* Optimized prompt registry using Map for O(1) lookups
|
|
@@ -119,7 +125,7 @@ function hasPrompt(name) {
|
|
|
119
125
|
/**
|
|
120
126
|
* Get prompts by category
|
|
121
127
|
*
|
|
122
|
-
* @param category - Category name ('trading', 'portfolio', 'analysis', 'creation', 'discovery', 'dex', or 'utility')
|
|
128
|
+
* @param category - Category name ('trading', 'portfolio', 'analysis', 'creation', 'discovery', 'dex', 'liquidity', 'monitoring', or 'utility')
|
|
123
129
|
* @returns Array of prompts in the specified category
|
|
124
130
|
*
|
|
125
131
|
* @example
|
|
@@ -146,6 +152,8 @@ function getPromptsByCategory(category) {
|
|
|
146
152
|
return dex_trading_js_1.dexTradingPrompts;
|
|
147
153
|
case 'liquidity':
|
|
148
154
|
return liquidity_positions_js_1.liquidityPositionPrompts;
|
|
155
|
+
case 'monitoring':
|
|
156
|
+
return monitoring_js_1.monitoringPrompts;
|
|
149
157
|
case 'utility':
|
|
150
158
|
return utility_js_1.utilityPrompts;
|
|
151
159
|
default:
|
|
@@ -159,7 +167,7 @@ function getPromptsByCategory(category) {
|
|
|
159
167
|
*
|
|
160
168
|
* @example
|
|
161
169
|
* ```typescript
|
|
162
|
-
* console.log(`Total prompts: ${getPromptCount()}`); // Total prompts:
|
|
170
|
+
* console.log(`Total prompts: ${getPromptCount()}`); // Total prompts: 78
|
|
163
171
|
* ```
|
|
164
172
|
*/
|
|
165
173
|
function getPromptCount() {
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/prompts/index.ts"],"names":[],"mappings":";AAAA;;;;GAIG;;;
|
|
1
|
+
{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/prompts/index.ts"],"names":[],"mappings":"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"}
|
|
@@ -28,6 +28,18 @@ export declare const removeLiquidityPrompt: MCPPrompt;
|
|
|
28
28
|
* Guides through collecting accumulated fees from a position
|
|
29
29
|
*/
|
|
30
30
|
export declare const collectFeesPrompt: MCPPrompt;
|
|
31
|
+
/**
|
|
32
|
+
* Fetch Position Details - Get detailed position information including fee growth
|
|
33
|
+
*
|
|
34
|
+
* Retrieves comprehensive position details by token pair and tick range
|
|
35
|
+
*/
|
|
36
|
+
/**
|
|
37
|
+
* Fetch Position Direct - Get position using ONLY compound key (most efficient)
|
|
38
|
+
*
|
|
39
|
+
* This prompt shows the most efficient way to fetch a position when you already
|
|
40
|
+
* have all position parameters (token0, token1, fee, tickLower, tickUpper, owner)
|
|
41
|
+
*/
|
|
42
|
+
export declare const fetchPositionDirectPrompt: MCPPrompt;
|
|
31
43
|
/**
|
|
32
44
|
* Export all liquidity position prompts
|
|
33
45
|
*/
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"liquidity-positions.d.ts","sourceRoot":"","sources":["../../src/prompts/liquidity-positions.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAIjD;;;;GAIG;AACH,eAAO,MAAM,iBAAiB,EAAE,SA0B/B,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,kBAAkB,EAAE,SA6EhC,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,qBAAqB,EAAE,SA8CnC,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,iBAAiB,EAAE,SAyC/B,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,wBAAwB,EAAE,SAAS,
|
|
1
|
+
{"version":3,"file":"liquidity-positions.d.ts","sourceRoot":"","sources":["../../src/prompts/liquidity-positions.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAIjD;;;;GAIG;AACH,eAAO,MAAM,iBAAiB,EAAE,SA0B/B,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,kBAAkB,EAAE,SA6EhC,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,qBAAqB,EAAE,SA8CnC,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,iBAAiB,EAAE,SAyC/B,CAAC;AAEF;;;;GAIG;AACH;;;;;GAKG;AACH,eAAO,MAAM,yBAAyB,EAAE,SAoEvC,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,wBAAwB,EAAE,SAAS,EAM/C,CAAC"}
|
|
@@ -5,7 +5,7 @@
|
|
|
5
5
|
* Slash commands for managing liquidity positions on GalaSwap DEX
|
|
6
6
|
*/
|
|
7
7
|
Object.defineProperty(exports, "__esModule", { value: true });
|
|
8
|
-
exports.liquidityPositionPrompts = exports.collectFeesPrompt = exports.removeLiquidityPrompt = exports.addLiquidityPrompt = exports.myPositionsPrompt = void 0;
|
|
8
|
+
exports.liquidityPositionPrompts = exports.fetchPositionDirectPrompt = exports.collectFeesPrompt = exports.removeLiquidityPrompt = exports.addLiquidityPrompt = exports.myPositionsPrompt = void 0;
|
|
9
9
|
const validation_js_1 = require("../utils/validation.js");
|
|
10
10
|
const handlerHelpers_js_1 = require("./utils/handlerHelpers.js");
|
|
11
11
|
/**
|
|
@@ -213,6 +213,84 @@ Please use the following MCP tools:
|
|
|
213
213
|
|
|
214
214
|
Proceed with collecting fees.`),
|
|
215
215
|
};
|
|
216
|
+
/**
|
|
217
|
+
* Fetch Position Details - Get detailed position information including fee growth
|
|
218
|
+
*
|
|
219
|
+
* Retrieves comprehensive position details by token pair and tick range
|
|
220
|
+
*/
|
|
221
|
+
/**
|
|
222
|
+
* Fetch Position Direct - Get position using ONLY compound key (most efficient)
|
|
223
|
+
*
|
|
224
|
+
* This prompt shows the most efficient way to fetch a position when you already
|
|
225
|
+
* have all position parameters (token0, token1, fee, tickLower, tickUpper, owner)
|
|
226
|
+
*/
|
|
227
|
+
exports.fetchPositionDirectPrompt = {
|
|
228
|
+
name: 'galachain-launchpad:fetch-position-direct',
|
|
229
|
+
description: 'Fetch a single liquidity position using the compound key (most efficient when you have all position parameters)',
|
|
230
|
+
arguments: [
|
|
231
|
+
{
|
|
232
|
+
name: 'token0',
|
|
233
|
+
description: 'First token symbol (e.g., GALA)',
|
|
234
|
+
required: true,
|
|
235
|
+
},
|
|
236
|
+
{
|
|
237
|
+
name: 'token1',
|
|
238
|
+
description: 'Second token symbol (e.g., GUSDC)',
|
|
239
|
+
required: true,
|
|
240
|
+
},
|
|
241
|
+
{
|
|
242
|
+
name: 'fee',
|
|
243
|
+
description: 'Fee tier in basis points: 500, 3000, or 10000',
|
|
244
|
+
required: true,
|
|
245
|
+
},
|
|
246
|
+
{
|
|
247
|
+
name: 'tickLower',
|
|
248
|
+
description: 'Lower tick boundary of the position',
|
|
249
|
+
required: true,
|
|
250
|
+
},
|
|
251
|
+
{
|
|
252
|
+
name: 'tickUpper',
|
|
253
|
+
description: 'Upper tick boundary of the position',
|
|
254
|
+
required: true,
|
|
255
|
+
},
|
|
256
|
+
{
|
|
257
|
+
name: 'owner',
|
|
258
|
+
description: 'Position owner address (e.g., eth|0x...)',
|
|
259
|
+
required: true,
|
|
260
|
+
},
|
|
261
|
+
],
|
|
262
|
+
handler: (args) => {
|
|
263
|
+
const feeTierPercent = (parseInt(args.fee) / 100).toFixed(2);
|
|
264
|
+
return (0, handlerHelpers_js_1.createPromptResponse)(`I want to fetch position details using the compound key directly.
|
|
265
|
+
|
|
266
|
+
**Position Query Parameters:**
|
|
267
|
+
- Token Pair: ${args.token0} / ${args.token1}
|
|
268
|
+
- Tick Range: ${args.tickLower} to ${args.tickUpper}
|
|
269
|
+
- Fee Tier: ${args.fee} basis points (${feeTierPercent}%)
|
|
270
|
+
- Owner Address: ${args.owner}
|
|
271
|
+
|
|
272
|
+
**Workflow:**
|
|
273
|
+
1. Query position using compound key (token0, token1, fee, ticks, owner)
|
|
274
|
+
2. Retrieve comprehensive position information in a single direct HTTP call
|
|
275
|
+
3. Display position details with liquidity and fee information
|
|
276
|
+
|
|
277
|
+
**Information to Display:**
|
|
278
|
+
- Position ID
|
|
279
|
+
- Liquidity amount
|
|
280
|
+
- Token amounts locked (amount0, amount1)
|
|
281
|
+
- Uncollected fees (feeAmount0, feeAmount1)
|
|
282
|
+
- Position tick range
|
|
283
|
+
|
|
284
|
+
**Why Direct Query?**
|
|
285
|
+
This is the most efficient method when you already have all position parameters.
|
|
286
|
+
It makes a single direct HTTP call without fetching unnecessary data.
|
|
287
|
+
|
|
288
|
+
Please use the following MCP tools:
|
|
289
|
+
- gala_launchpad_fetch_swap_position_direct: Retrieve position using compound key directly
|
|
290
|
+
|
|
291
|
+
Proceed with fetching the position.`);
|
|
292
|
+
},
|
|
293
|
+
};
|
|
216
294
|
/**
|
|
217
295
|
* Export all liquidity position prompts
|
|
218
296
|
*/
|
|
@@ -221,5 +299,6 @@ exports.liquidityPositionPrompts = [
|
|
|
221
299
|
exports.addLiquidityPrompt,
|
|
222
300
|
exports.removeLiquidityPrompt,
|
|
223
301
|
exports.collectFeesPrompt,
|
|
302
|
+
exports.fetchPositionDirectPrompt,
|
|
224
303
|
];
|
|
225
304
|
//# sourceMappingURL=liquidity-positions.js.map
|