@gala-chain/launchpad-mcp-server 4.0.17-beta.9 → 4.0.19

package/MCP_TEST_ANALYSIS.md

@@ -1,11 +1,11 @@
 # MCP Tool Test Analysis
 
-**Last Updated:** 2025-12-08 (Session 17: v4.0.17-beta.6 Wrappable Token Tools Testing)
-**Total Tools:** 121 (was 115, +5 wrappable token tools, +1 DEX tool correction)
+**Last Updated:** 2025-12-08 (Session 18: v4.0.17-beta.10 Wrap/Unwrap Execution Testing)
+**Total Tools:** 126 (was 121, +5 wrap/unwrap execution/fee tools)
 **Environment:** STAGE
-**SDK Version:** 4.0.17-beta.6
-**MCP Version:** 4.0.17-beta.6
-**Previous Beta:** 4.0.17-beta.1
+**SDK Version:** 4.0.17-beta.10
+**MCP Version:** 4.0.17-beta.10
+**Previous Beta:** 4.0.17-beta.6
 
 ## Summary
 
@@ -19,14 +19,18 @@
 | creation | 4 | 4 | 0 | 0 | 0 |
 | transfers | 2 | 2 | 0 | 0 | 0 |
 | locks | 2 | 2 | 0 | 0 | 0 |
-| bridge | 26 | 22 | 1 | 2 | 1 |
-| **TOTAL** | **121** | **120** | **1** | **3** | **1** |
+| bridge | 31 | 24 | 3 | 3 | 1 |
+| **TOTAL** | **126** | **118** | **3** | **4** | **1** |
 
-**Coverage: 100%** (121/121 tools accounted for)
-**Pass Rate: 99%** (120/121 testable tools passed)
+**Coverage: 100%** (126/126 tools accounted for)
+**Pass Rate: 94%** (118/122 testable tools passed)
+**New in v4.0.17-beta.10:** 5 wrap/unwrap tools tested (discovery: PASS, execution: FAIL - signing issue)
 **New in v4.0.17-beta.6:** 5 wrappable token tools added (MUSIC ↔ GMUSIC wrap/unwrap discovery)
 **New in v4.0.17-beta.1:** getSolanaTransactionStatus, bridge_out tested, Solana balance queries working
-**Known Issue:** bridge_in fails on Solana devnet (block height exceeded - timing issue)
+**Known Issues:**
+- `bridge_in` fails on Solana devnet (block height exceeded - timing issue)
+- `wrap_token` fails with 404 (music-contract endpoint issue)
+- `unwrap_token` fails with 400 (GalaChain Gateway requires native signing, not DEX API signing)
 
 ---
 
@@ -177,7 +181,7 @@
 
 ---
 
-## BRIDGE (26 tools) - 22 PASS, 2 SKIP, 1 CONFIG-REQUIRED, 1 FAIL
+## BRIDGE (31 tools) - 24 PASS, 3 SKIP, 1 CONFIG-REQUIRED, 3 FAIL
 
 | Tool | Status | Last Tested | Notes |
 |------|--------|-------------|-------|
@@ -207,6 +211,21 @@
 | `gala_launchpad_get_wrappable_token` | PASS | 2025-12-08 | **NEW** - Lookup by tokenId, returns wrap counterpart info |
 | `gala_launchpad_get_wrap_counterpart` | PASS | 2025-12-08 | **NEW** - MUSIC → GMUSIC, GMUSIC → MUSIC counterpart lookup |
 | `gala_launchpad_is_token_wrappable` | PASS | 2025-12-08 | **NEW** - Boolean check: MUSIC=true (wrappable), GALA=false (not wrappable) |
+| `gala_launchpad_wrap_token` | FAIL | 2025-12-08 | **NEW** - 404 error: music-contract endpoint not found |
+| `gala_launchpad_unwrap_token` | FAIL | 2025-12-08 | **NEW** - 400 error: "Signature is missing" - requires GalaChain native signing |
+| `gala_launchpad_estimate_wrap_fee` | PASS | 2025-12-08 | **NEW** - Returns fee: "0" GALA, auth: cross_channel_authorization |
+| `gala_launchpad_estimate_unwrap_fee` | PASS | 2025-12-08 | **NEW** - Returns fee: "0" GALA, auth: automatic |
+| `gala_launchpad_get_wrap_status` | SKIP | 2025-12-08 | **NEW** - Cannot test without successful wrap/unwrap transaction |
+
+**Bridge Tool Notes (v4.0.17-beta.10):**
+- **NEW (5 tools):** Wrap/unwrap execution and fee estimation
+  - `wrap_token` - FAIL (404 - music-contract endpoint not found)
+  - `unwrap_token` - FAIL (400 - GalaChain Gateway requires native signing, not DEX API `Sign` header)
+  - `estimate_wrap_fee` - PASS (returns 0 GALA fee)
+  - `estimate_unwrap_fee` - PASS (returns 0 GALA fee)
+  - `get_wrap_status` - SKIP (no successful transaction to check)
+- **Root Cause:** WrapService uses HttpClient with `Sign` header (DEX API style) but GalaChain Gateway requires native contract signing
+- **Fix Required:** SDK needs to use GalaChain-native DTO signing (like `@gala-chain/connect`)
 
 **Bridge Tool Notes (v4.0.17-beta.6):**
 - **NEW (5 tools):** Wrappable token discovery for wrap/unwrap pairs (e.g., MUSIC ↔ GMUSIC)
@@ -989,23 +1008,32 @@ fetchAllAvailableDexTokens({ search: 'GALA' }):
 
 ## Next Steps
 
-v4.0.17-beta.6 ready for:
-- Full Solana bridge operations (with proper devnet funding)
-- Production deployment with complete bridge support
-- Cross-chain transfer testing
-- Wrap/unwrap token operations (MUSIC ↔ GMUSIC, etc.)
+v4.0.17-beta.10 status:
+- ✅ Full Solana bridge operations (bridge_out tested, bridge_in has devnet timing issue)
+- ✅ Wrappable token discovery (all 5 discovery tools work)
+- ❌ **BLOCKED:** Wrap/unwrap execution requires SDK architectural change
+  - Root cause: WrapService uses DEX API signing (`Sign` header)
+  - GalaChain Gateway requires native GalaChain contract signing
+  - Fix needed: Integrate `@gala-chain/connect` or similar for DTO signing
 
-All 121 MCP tools verified:
+All 126 MCP tools verified:
 - 85 read-only tools: 100% PASS
 - 28 write operations: 100% PASS (trading, DEX, creation, uploads, transfers, locks)
-- 26 bridge tools: 22 PASS, 1 FAIL, 2 SKIP, 1 CONFIG-REQUIRED
+- 31 bridge tools: 24 PASS, 3 FAIL, 3 SKIP, 1 CONFIG-REQUIRED
+- 3 tools FAIL:
+  - `bridge_in` - Solana devnet timing issue
+  - `wrap_token` - 404 (music-contract endpoint)
+  - `unwrap_token` - 400 (GalaChain signing incompatibility)
 - 1 intentionally skipped: `graduate_token` - irreversible state change
 - New Solana utilities: `create_solana_wallet`, `get_solana_transaction_status`
-- New wrappable token tools: 5 tools for wrap/unwrap pair discovery
+- New wrappable token tools: 10 tools total (5 discovery + 5 execution/fee)
 
-**v4.0.17-beta.6 release ready for production.**
+**v4.0.17-beta.10 release status:**
+- ✅ Production ready for all non-wrap/unwrap operations
+- ⚠️ Wrap/unwrap execution requires SDK fix before production use
 
 ### Change History
+- **v4.0.17-beta.10** (2025-12-08): Tested wrap/unwrap execution tools - discovery PASS, execution FAIL (signing incompatibility), tool count 121→126
 - **v4.0.17-beta.6** (2025-12-08): Added 5 wrappable token tools (MUSIC ↔ GMUSIC wrap/unwrap discovery), fixed tool count mismatch (116→121)
 - **v4.0.17-beta.1** (2025-12-07): Solana balance queries working, new getSolanaTransactionStatus tool, estimateBridgeFee verified
 - **v4.0.15-beta.12** (2025-12-07): Solana bridge testing - WebSocket fix, devnet airdrop, wallet creation
@@ -1252,3 +1280,119 @@ Fixed by updating `createToolRegistry(toolCategories, 116)` to `createToolRegist
 - All 5 wrappable token tools working correctly
 - Use case: Wrap/unwrap operations (MUSIC ↔ GMUSIC, etc.)
 - Caching: Wrappable token list cached permanently for efficiency
+
+---
+
+### Session 18: 2025-12-08 (v4.0.17-beta.10 Wrap/Unwrap Execution Testing)
+
+**Test Configuration:**
+- Environment: STAGE
+- SDK Version: 4.0.17-beta.10
+- MCP Version: 4.0.17-beta.10
+- Total MCP Tools: 126 (was 121, +5 wrap/unwrap execution tools)
+- Wallet Balance: 100 GMUSIC, 9.4M GALA (sufficient for testing)
+
+**Test Objective:**
+Execute 10 wrap + 10 unwrap operations against STAGE to verify wrap/unwrap functionality.
+
+**Wrappable Token Pair Found:**
+- MUSIC (music channel) ↔ GMUSIC (asset channel)
+- Channel IDs: MUSIC=3, ASSET=1
+
+**Tool Categories Tested:**
+
+#### 1. Wrappable Token Discovery (5 tools) - ALL PASS ✅
+These tools work correctly for discovering wrap/unwrap pairs:
+
+✅ `gala_launchpad_fetch_wrappable_tokens` - PASS
+- Returns paginated wrappable token list
+- Found 2 tokens: MUSIC, GMUSIC
+
+✅ `gala_launchpad_fetch_all_wrappable_tokens` - PASS
+- Auto-paginated discovery with caching
+- Returns complete MUSIC ↔ GMUSIC pair data
+
+✅ `gala_launchpad_get_wrappable_token` - PASS
+- Lookup by tokenId: `$GMUSIC|Unit|none|none`
+- Returns token with counterpart info
+
+✅ `gala_launchpad_get_wrap_counterpart` - PASS
+- MUSIC → GMUSIC, GMUSIC → MUSIC working correctly
+
+✅ `gala_launchpad_is_token_wrappable` - PASS
+- MUSIC: true, GMUSIC: true, GALA: false
+
+#### 2. Wrap/Unwrap Fee Estimation (2 tools) - PASS ✅
+✅ `gala_launchpad_estimate_wrap_fee` - PASS
+- Returns fee: "0" GALA (fees are currently zero)
+- Auth type: cross_channel_authorization
+
+✅ `gala_launchpad_estimate_unwrap_fee` - PASS
+- Returns fee: "0" GALA
+- Auth type: automatic
+
+#### 3. Wrap/Unwrap Execution (2 tools) - FAIL ❌
+**Critical Finding: GalaChain Gateway requires native GalaChain signing**
+
+❌ `gala_launchpad_wrap_token` - FAIL (404)
+- Attempted: Wrap 1 MUSIC → GMUSIC
+- Error: "Request failed with status code 404"
+- Endpoint: `/api/music-contract/RequestTokenBridgeOut`
+- Root cause: Music-contract endpoint may not exist or has different path
+
+❌ `gala_launchpad_unwrap_token` - FAIL (400 - Signature Missing)
+- Attempted: Unwrap 1 GMUSIC → MUSIC
+- Error: "Request failed with status code 400"
+- Response: `{ ErrorKey: 'MISSING_SIGNATURE', Message: 'Signature is missing.' }`
+- Endpoint: `/api/asset/token-contract/RequestTokenBridgeOut`
+- Root cause: SDK uses DEX API-style signing (`Sign` header) but GalaChain Gateway requires native GalaChain contract signing
+
+#### 4. Wrap Status (1 tool) - UNTESTED
+⏭️ `gala_launchpad_get_wrap_status` - SKIP
+- Cannot test without successful wrap/unwrap transaction
+
+**Technical Root Cause Analysis:**
+
+The wrap/unwrap execution tools fail because of a **signing mechanism incompatibility**:
+
+1. **SDK's Current Approach (WrapService.ts):**
+   - Uses `HttpClient.request()` which adds `Sign` header (DEX API signature)
+   - Posts to GalaChain Gateway endpoints like `/api/asset/token-contract/RequestTokenBridgeOut`
+
+2. **GalaChain Gateway Requirements:**
+   - Expects native GalaChain contract signing (likely via `@gala-chain/connect` or DTO signing)
+   - The `Sign` header used for DEX API authentication is not recognized
+   - Returns `MISSING_SIGNATURE` error
+
+3. **Affected Code:**
+   - `packages/sdk/src/services/WrapService.ts:executeChannelBridge()` method
+   - Lines 403-409: HTTP POST request without proper GalaChain signature
+
+**Recommended Fix (Not Implemented):**
+The SDK would need to:
+1. Use GalaChain-native DTO signing (like `@gala-chain/connect`)
+2. Sign the `RequestTokenBridgeOut` payload properly
+3. Include signed DTO in request body (not as HTTP header)
+
+**Test Results Summary:**
+
+| Tool Category | Count | Pass | Fail | Skip |
+|---------------|-------|------|------|------|
+| Wrappable Token Discovery | 5 | 5 | 0 | 0 |
+| Fee Estimation | 2 | 2 | 0 | 0 |
+| Wrap/Unwrap Execution | 2 | 0 | 2 | 0 |
+| Wrap Status | 1 | 0 | 0 | 1 |
+| **TOTAL** | **10** | **7** | **2** | **1** |
+
+**10 Wrap + 10 Unwrap Test Result:**
+❌ **BLOCKED** - Cannot execute wrap/unwrap operations due to GalaChain Gateway signing requirements
+
+**Key Findings:**
+1. **Discovery tools fully functional** - All 5 wrappable token discovery tools work correctly
+2. **Fee estimation works** - Both estimate_wrap_fee and estimate_unwrap_fee return valid responses
+3. **Execution blocked** - wrap_token and unwrap_token fail due to signing mechanism incompatibility
+4. **SDK needs architectural change** - WrapService must use GalaChain-native contract signing instead of DEX API signing
+
+**Impact on Tool Status:**
+- Bridge category: 26 tools → 22 PASS, 3 FAIL (was 1), 1 SKIP (was 2)
+- Total MCP tools: 126 → 120 PASS, 3 FAIL, 3 SKIP

package/dist/generated/version.d.ts

@@ -3,5 +3,5 @@
  * This file is generated by scripts/inject-version.ts during build
  * DO NOT EDIT MANUALLY
  */
-export declare const MCP_SERVER_VERSION = "4.0.17-beta.9";
+export declare const MCP_SERVER_VERSION = "4.0.19";
 //# sourceMappingURL=version.d.ts.map

package/dist/generated/version.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"version.d.ts","sourceRoot":"","sources":["../../src/generated/version.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,eAAO,MAAM,kBAAkB,kBAAkB,CAAC"}
+{"version":3,"file":"version.d.ts","sourceRoot":"","sources":["../../src/generated/version.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,eAAO,MAAM,kBAAkB,WAAW,CAAC"}

package/dist/generated/version.js

@@ -6,5 +6,5 @@
  */
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.MCP_SERVER_VERSION = void 0;
-exports.MCP_SERVER_VERSION = '4.0.17-beta.9';
+exports.MCP_SERVER_VERSION = '4.0.19';
 //# sourceMappingURL=version.js.map

package/dist/generated/version.js.map

@@ -1 +1 @@
-{"version":3,"file":"version.js","sourceRoot":"","sources":["../../src/generated/version.ts"],"names":[],"mappings":";AAAA;;;;GAIG;;;AAEU,QAAA,kBAAkB,GAAG,eAAe,CAAC"}
+{"version":3,"file":"version.js","sourceRoot":"","sources":["../../src/generated/version.ts"],"names":[],"mappings":";AAAA;;;;GAIG;;;AAEU,QAAA,kBAAkB,GAAG,QAAQ,CAAC"}

package/dist/tools/balance/index.d.ts

@@ -9,5 +9,6 @@ export declare const fetchTokensHeldTool: MCPTool;
 export declare const fetchTokensCreatedTool: MCPTool;
 export declare const fetchProfileTool: MCPTool;
 export declare const updateProfileTool: MCPTool;
+export declare const fetchReferralUrlTool: MCPTool;
 export declare const balanceTools: MCPTool[];
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/tools/balance/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAelD,eAAO,MAAM,oBAAoB,EAAE,OAgBlC,CAAC;AAGF,eAAO,MAAM,qBAAqB,EAAE,OAmBnC,CAAC;AAGF,eAAO,MAAM,qBAAqB,EAAE,OA2BnC,CAAC;AAGF,eAAO,MAAM,mBAAmB,EAAE,OA2BjC,CAAC;AAGF,eAAO,MAAM,sBAAsB,EAAE,OA2BpC,CAAC;AAGF,eAAO,MAAM,gBAAgB,EAAE,OAgB9B,CAAC;AAGF,eAAO,MAAM,iBAAiB,EAAE,OAyB/B,CAAC;AAEF,eAAO,MAAM,YAAY,EAAE,OAAO,EAQjC,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/tools/balance/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAelD,eAAO,MAAM,oBAAoB,EAAE,OAgBlC,CAAC;AAGF,eAAO,MAAM,qBAAqB,EAAE,OAmBnC,CAAC;AAGF,eAAO,MAAM,qBAAqB,EAAE,OA2BnC,CAAC;AAGF,eAAO,MAAM,mBAAmB,EAAE,OA2BjC,CAAC;AAGF,eAAO,MAAM,sBAAsB,EAAE,OA2BpC,CAAC;AAGF,eAAO,MAAM,gBAAgB,EAAE,OAgB9B,CAAC;AAGF,eAAO,MAAM,iBAAiB,EAAE,OAyB/B,CAAC;AAGF,eAAO,MAAM,oBAAoB,EAAE,OAYlC,CAAC;AAEF,eAAO,MAAM,YAAY,EAAE,OAAO,EASjC,CAAC"}

package/dist/tools/balance/index.js

@@ -3,7 +3,7 @@
  * Balance & Portfolio Tools
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.balanceTools = exports.updateProfileTool = exports.fetchProfileTool = exports.fetchTokensCreatedTool = exports.fetchTokensHeldTool = exports.fetchLockedTokensTool = exports.fetchTokenBalanceTool = exports.fetchGalaBalanceTool = void 0;
+exports.balanceTools = exports.fetchReferralUrlTool = exports.updateProfileTool = exports.fetchProfileTool = exports.fetchTokensCreatedTool = exports.fetchTokensHeldTool = exports.fetchLockedTokensTool = exports.fetchTokenBalanceTool = exports.fetchGalaBalanceTool = 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");
@@ -178,6 +178,20 @@ exports.updateProfileTool = {
         return (0, response_formatter_js_1.formatBoolean)(true, 'Profile updated successfully');
     }),
 };
+// 8. Fetch Referral URL
+exports.fetchReferralUrlTool = {
+    name: 'gala_launchpad_fetch_referral_url',
+    description: "Fetch the authenticated user's unique referral URL for sharing. The referral URL can be used to earn rewards when new users sign up through the link. Requires wallet configuration.",
+    inputSchema: {
+        type: 'object',
+        properties: {},
+        required: [],
+    },
+    handler: (0, error_handler_js_1.withErrorHandling)(async (sdk) => {
+        const result = await sdk.fetchReferralUrl();
+        return (0, response_formatter_js_1.formatSuccess)(result);
+    }),
+};
 exports.balanceTools = [
     exports.fetchGalaBalanceTool,
     exports.fetchTokenBalanceTool,
@@ -186,5 +200,6 @@ exports.balanceTools = [
     exports.fetchTokensCreatedTool,
     exports.fetchProfileTool,
     exports.updateProfileTool,
+    exports.fetchReferralUrlTool,
 ];
 //# sourceMappingURL=index.js.map

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

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

package/dist/tools/index.d.ts

@@ -7,7 +7,7 @@
  * @see src/utils/tool-registry.ts
  */
 /**
- * Enhanced tool registry with validation (130 tools total):
+ * Enhanced tool registry with validation (126 tools total):
  * - Pools: 19 tools (pool operations + 2 watchers: onDexPoolCreation, onLaunchpadTokenCreation)
  * - Trading: 13 tools (buy, sell, calculate amounts, graduation)
  * - DEX/GalaSwap: 29 tools (swap/quote, liquidity, pool discovery, leaderboard, volume, token discovery)
@@ -16,7 +16,7 @@
  * - Transfers: 2 tools (GALA and token transfers)
  * - Locks: 2 tools (token lock/unlock for staking, escrow)
  * - Utilities: 19 tools (config, version, environment, wallet, Solana wallet, cache, cleanup, key derivation)
- * - Bridge: 35 tools (cross-chain bridging, bridgeable/wrappable token queries + balance fetchers, wrap/unwrap execution, devnet airdrop, tx status)
+ * - Bridge: 31 tools (cross-chain bridging, bridgeable/wrappable token queries, wrap/unwrap execution, devnet airdrop, tx status)
  */
 export declare const registry: import("../utils/tool-registry.js").ToolRegistry;
 /**

package/dist/tools/index.js

@@ -70,7 +70,7 @@ const toolCategories = [
     },
 ];
 /**
- * Enhanced tool registry with validation (130 tools total):
+ * Enhanced tool registry with validation (126 tools total):
  * - Pools: 19 tools (pool operations + 2 watchers: onDexPoolCreation, onLaunchpadTokenCreation)
  * - Trading: 13 tools (buy, sell, calculate amounts, graduation)
  * - DEX/GalaSwap: 29 tools (swap/quote, liquidity, pool discovery, leaderboard, volume, token discovery)
@@ -79,9 +79,9 @@ const toolCategories = [
  * - Transfers: 2 tools (GALA and token transfers)
  * - Locks: 2 tools (token lock/unlock for staking, escrow)
  * - Utilities: 19 tools (config, version, environment, wallet, Solana wallet, cache, cleanup, key derivation)
- * - Bridge: 35 tools (cross-chain bridging, bridgeable/wrappable token queries + balance fetchers, wrap/unwrap execution, devnet airdrop, tx status)
+ * - Bridge: 31 tools (cross-chain bridging, bridgeable/wrappable token queries, wrap/unwrap execution, devnet airdrop, tx status)
  */
-exports.registry = (0, tool_registry_js_1.createToolRegistry)(toolCategories, 130);
+exports.registry = (0, tool_registry_js_1.createToolRegistry)(toolCategories, 126);
 /**
  * Complete tool array (for backward compatibility)
  */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@gala-chain/launchpad-mcp-server",
-  "version": "4.0.17-beta.9",
+  "version": "4.0.19",
   "description": "MCP server for Gala Launchpad - 105 tools (pool management, event watchers, GSwap DEX trading, price history, token creation, wallet management, DEX pool discovery, liquidity positions, token locks, locked token queries, composite pool data, cross-chain bridging, key derivation) 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": {
@@ -73,7 +73,7 @@
   "dependencies": {
     "@gala-chain/api": "^2.4.3",
     "@gala-chain/connect": "^2.4.3",
-    "@gala-chain/launchpad-sdk": "4.0.17-beta.9",
+    "@gala-chain/launchpad-sdk": "^4.0.19",
     "@humanwhocodes/config-array": "^0.13.0",
     "@modelcontextprotocol/sdk": "^0.5.0",
     "axios": "^1.12.2",