@gala-chain/launchpad-mcp-server 4.0.20-beta.1 → 4.0.21

package/MCP_TEST_ANALYSIS.md

@@ -1,11 +1,11 @@
 # MCP Tool Test Analysis
 
-**Last Updated:** 2025-12-08 (Session 20: v4.0.20-beta.0 Wrap/Unwrap NOW WORKING!)
+**Last Updated:** 2025-12-09 (Session 22: v4.0.20-beta.2 Full Bridge & Wrap Testing)
 **Total Tools:** 127 (was 126, +1 referral URL tool)
 **Environment:** STAGE
-**SDK Version:** 4.0.20-beta.0
-**MCP Version:** 4.0.20-beta.0
-**Previous Beta:** 4.0.17-beta.10
+**SDK Version:** 4.0.20-beta.2
+**MCP Version:** 4.0.20-beta.2
+**Previous Beta:** 4.0.20-beta.1
 
 ## Summary
 
@@ -19,17 +19,18 @@
 | creation | 4 | 4 | 0 | 0 | 0 |
 | transfers | 2 | 2 | 0 | 0 | 0 |
 | locks | 2 | 2 | 0 | 0 | 0 |
-| bridge | 31 | 27 | 1 | 2 | 1 |
-| **TOTAL** | **127** | **122** | **1** | **3** | **1** |
+| bridge | 31 | 30 | 0 | 0 | 1 |
+| **TOTAL** | **127** | **125** | **0** | **1** | **1** |
 
 **Coverage: 100%** (127/127 tools accounted for)
-**Pass Rate: 99%** (122/123 testable tools passed)
+**Pass Rate: 100%** (125/125 testable tools passed)
+**🎉 Session 22 UPDATE:** `bridge_in` from Solana NOW PASSES! Fixed with WebSocket-first + retry logic
+**🎉 Session 21 UPDATE:** Solana balance queries NOW PASS with Helius RPC! (were FAIL with public Solana RPC)
 **🎉 MAJOR UPDATE in v4.0.20-beta.0:** wrap_token and unwrap_token NOW PASS! (were FAIL in v4.0.17-beta.10)
-**New in v4.0.20-beta.0:** 1 new referral URL tool tested (PASS), wrap/unwrap execution now working
-**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
+**New in v4.0.20-beta.2:** Solana bridge_in retry logic with fresh blockhash on block height exceeded
+**New in v4.0.20-beta.1:** Custom RPC URL support (ethereumRpcUrl, solanaRpcUrl config options)
 **Known Issues:**
-- `bridge_in` fails on Solana devnet (block height exceeded - timing issue)
+- `request_solana_devnet_airdrop` rate limited (1 SOL/day) - CONFIG status, not a bug
 
 ---
 
@@ -176,12 +177,12 @@
 
 | Tool | Status | Last Tested | Notes |
 |------|--------|-------------|-------|
-| `gala_launchpad_lock_token` | PASS | 2025-12-03 | Write operation - locked 10 anime tokens (test-lock-verification) |
-| `gala_launchpad_unlock_token` | PASS | 2025-12-03 | Write operation - unlocked 10 anime tokens (test-lock-verification) |
+| `gala_launchpad_lock_token` | PASS | 2025-12-09 | Write operation - locked 100 anime tokens (test-lock-session22) |
+| `gala_launchpad_unlock_token` | PASS | 2025-12-09 | Write operation - unlocked 100 anime tokens (test-lock-session22) |
 
 ---
 
-## BRIDGE (31 tools) - 27 PASS, 2 SKIP, 1 CONFIG-REQUIRED, 1 FAIL
+## BRIDGE (31 tools) - 30 PASS, 0 SKIP, 1 CONFIG-REQUIRED
 
 | Tool | Status | Last Tested | Notes |
 |------|--------|-------------|-------|
@@ -198,7 +199,7 @@
 | `gala_launchpad_get_solana_transaction_status` | PASS | 2025-12-07 | **NEW** - Returns { confirmed: false, status: "not_found" } for invalid sig |
 | `gala_launchpad_get_bridge_status` | PASS | 2025-12-08 | **NOW WORKING!** Returns status: DeliveryConfirmed for completed bridges |
 | `gala_launchpad_bridge_out` | PASS | 2025-12-07 | **TESTED** - Bridged 10 GALA to Solana, fee: 41.99 GALA, txHash returned |
-| `gala_launchpad_bridge_in` | FAIL | 2025-12-07 | Solana devnet timing issue - "block height exceeded" (tx expires before confirmation) |
+| `gala_launchpad_bridge_in` | PASS | 2025-12-09 | **FIXED in v4.0.20-beta.2** - Retry logic with fresh blockhash on block height exceeded |
 | `gala_launchpad_fetch_bridgeable_tokens_by_network` | PASS | 2025-12-06 | Paginated bridgeable token discovery |
 | `gala_launchpad_fetch_all_bridgeable_tokens_by_network` | PASS | 2025-12-06 | Auto-paginated bridgeable token discovery |
 | `gala_launchpad_fetch_all_tokens_bridgeable_to_ethereum` | PASS | 2025-12-06 | Returns 33 Ethereum-bridgeable tokens |
@@ -1497,3 +1498,197 @@ Previously blocked wrap_token and unwrap_token tools now work correctly. This is
 - ✅ **Ethereum Balances:** All 3 tools work
 - ⚠️ **Solana Balances:** Works on mainnet, fails on devnet (expected)
 - ⚠️ **bridge_in:** Solana devnet timing issue only
+
+---
+
+### Session 21: 2025-12-09 (v4.0.20-beta.1 Solana Bridging with Helius RPC)
+
+**Test Configuration:**
+- Environment: STAGE
+- SDK Version: 4.0.20-beta.1
+- MCP Version: 4.0.20-beta.1
+- Total MCP Tools: 127
+- **Solana RPC:** Helius devnet (`https://devnet.helius-rpc.com/?api-key=...`)
+
+**🎉 BREAKTHROUGH: Solana Balance Queries NOW PASS with Helius RPC!**
+
+Previous tests with public Solana RPC (`api.devnet.solana.com`) failed for token balance queries. With Helius RPC, all Solana operations work reliably.
+
+**Test Results:**
+
+#### 1. Solana Balance Queries (3 tools) - ALL PASS ✅
+| Tool | Status | Notes |
+|------|--------|-------|
+| `fetch_solana_wallet_native_balance` | PASS | SOL: 0.69952 |
+| `fetch_solana_wallet_token_balance` | **PASS** | GALA: 85 (was FAIL with public RPC) |
+| `fetch_solana_wallet_all_balances` | **PASS** | Returns SOL + GALA + GSOL (was FAIL with public RPC) |
+
+#### 2. Solana Bridge Operations (4 tools) - 3 PASS, 1 FAIL (expected)
+| Tool | Status | Notes |
+|------|--------|-------|
+| `estimate_bridge_fee` (Solana) | PASS | Fee: 39.80 GALA for 100 GALA → Solana |
+| `bridge_out` (→ Solana) | PASS | Bridged 50 GALA, txHash: `c3851d9b7cc70a8e30cfed276f428b1c82764c00e4e658b922e0d2cca35012ef` |
+| `get_bridge_status` | PASS | Status progressed: Pending → DeliveryInProgress |
+| `bridge_in` (← Solana) | FAIL | Block height exceeded (devnet timing issue) |
+
+#### 3. Solana Utility Tools (3 tools) - 2 PASS, 1 CONFIG
+| Tool | Status | Notes |
+|------|--------|-------|
+| `get_solana_transaction_status` | PASS | Returns { confirmed: false, status: "not_found" } for invalid sig |
+| `request_solana_devnet_airdrop` | CONFIG | Rate limited (1 SOL/day limit) |
+| `create_solana_wallet` | PASS | (tested in previous session) |
+
+#### 4. Solana Bridgeable Token Discovery (3 tools) - ALL PASS ✅
+| Tool | Status | Notes |
+|------|--------|-------|
+| `fetch_all_tokens_bridgeable_to_solana` | PASS | Returns 16 Solana-bridgeable tokens |
+| `is_token_bridgeable_to_solana` | PASS | GALA: true, mint: `eEUiUs4JWYZrp72djAGF1A8PhpR6rHphGeGN7GbVLp6` |
+| `fetch_bridgeable_tokens_by_network` (SOLANA) | PASS | Paginated discovery works |
+
+**Key Findings:**
+
+1. **🎉 Helius RPC fixes Solana devnet issues!** Token balance queries that failed with public Solana RPC now work
+2. **Bridge out to Solana works** - Successfully bridged 50 GALA, fee was ~40 GALA
+3. **Bridge status tracking works** - Status transitions from Pending → DeliveryInProgress correctly
+4. **Bridge in still has timing issue** - Solana devnet block height expires before tx confirms
+5. **16 tokens bridgeable to Solana** - Including GALA, GSOL, GTRUMP, GPENGU, GMEW, etc.
+
+**v4.0.20-beta.1 Improvements:**
+- Added `ethereumRpcUrl` and `solanaRpcUrl` config options for custom RPC endpoints
+- Reverted to public Ethereum RPC (publicnode.com) by default
+- Solana devnet uses Helius for reliable testing
+
+**Updated Bridge Tool Status:**
+
+| Tool | v4.0.20-beta.0 | v4.0.20-beta.1 | Notes |
+|------|----------------|----------------|-------|
+| `fetch_solana_wallet_token_balance` | FAIL | **PASS** | Fixed with Helius RPC |
+| `fetch_solana_wallet_all_balances` | FAIL | **PASS** | Fixed with Helius RPC |
+| `bridge_out` (Solana) | PASS | PASS | Consistent |
+| `bridge_in` (Solana) | FAIL | FAIL | Devnet timing issue (mainnet should work) |
+
+**Test Transaction Details:**
+
+```
+bridge_out to Solana:
+- Amount: 50 GALA
+- Fee: 39.80518273 GALA
+- Recipient: EHxvSMWjBxFwZrjod8xqKwZKyvJBVfbLU4o8c53o8s5H
+- TxHash: c3851d9b7cc70a8e30cfed276f428b1c82764c00e4e658b922e0d2cca35012ef
+- Status: DeliveryInProgress → (tokens received, GALA went from 85 → 125)
+```
+
+**Summary:**
+
+| Category | Total | Pass | Fail | Skip |
+|----------|-------|------|------|------|
+| Solana Balance Queries | 3 | **3** | **0** | 0 |
+| Solana Bridge Operations | 4 | 3 | 1 | 0 |
+| Solana Utility Tools | 3 | 2 | 0 | 1 |
+| Solana Bridgeable Discovery | 3 | 3 | 0 | 0 |
+| **TOTAL** | **13** | **11** | **1** | **1** |
+
+**v4.0.20-beta.1 Production Readiness:**
+- ✅ **Solana Balance Queries:** All 3 tools work with Helius RPC
+- ✅ **Bridge Out to Solana:** Fully functional
+- ✅ **Bridge Status Tracking:** Works correctly
+- ✅ **Bridgeable Token Discovery:** All tools work
+- ⚠️ **bridge_in from Solana:** Devnet timing issue only (mainnet should work)
+- ⚠️ **Airdrop:** Rate limited (expected)
+
+---
+
+### Session 22: 2025-12-09 (v4.0.20-beta.2 Full Bridge & Wrap Testing)
+
+**Test Configuration:**
+- Environment: STAGE
+- SDK Version: 4.0.20-beta.2
+- MCP Version: 4.0.20-beta.2
+- Total MCP Tools: 127
+- **Solana RPC:** Helius devnet
+- **Ethereum RPC:** Sepolia testnet (publicnode.com)
+
+**🎉 BREAKTHROUGH: `bridge_in` from Solana NOW PASSES!**
+
+Fixed with WebSocket-first confirmation + retry logic with fresh blockhash on block height exceeded errors.
+
+**Test Results:**
+
+#### 1. Solana Balance Queries (3 tools) - ALL PASS ✅
+| Tool | Status | Notes |
+|------|--------|-------|
+| `fetch_solana_wallet_native_balance` | PASS | SOL: 0.69912 |
+| `fetch_solana_wallet_token_balance` | PASS | GALA: 85 |
+| `fetch_solana_wallet_all_balances` | PASS | Returns SOL + GALA + GSOL |
+
+#### 2. Solana Bridge Operations (3 tools) - ALL PASS ✅
+| Tool | Status | Notes |
+|------|--------|-------|
+| `bridge_out` (→ Solana) | PASS | (tested in Session 21) |
+| `bridge_in` (← Solana) | **PASS** | **FIXED!** txHash: `4QTjXYQRSUPf9guf9rdecnxD7Yqo1bd86R189V1RYWn31UoJyhtG3LhZLuEXrrTzvicjx2iJkVXgiSKwAKHsSmkB` |
+| `get_bridge_status` | PASS | Status: DeliveryConfirmed |
+
+#### 3. Ethereum Balance Queries (3 tools) - ALL PASS ✅
+| Tool | Status | Notes |
+|------|--------|-------|
+| `fetch_ethereum_wallet_native_balance` | PASS | ETH: 2.55 |
+| `fetch_ethereum_wallet_token_balance` | PASS | GALA: 38 |
+| `fetch_ethereum_wallet_all_balances` | PASS | Returns ETH + GALA + GWETH + GUSDC + GUSDT + GWBTC |
+
+#### 4. Ethereum Bridge Operations (4 tools) - ALL PASS ✅
+| Tool | Status | Notes |
+|------|--------|-------|
+| `estimate_bridge_fee` (Ethereum) | PASS | Fee: 0.06 GALA for 10 GALA → Ethereum |
+| `get_supported_bridge_tokens` | PASS | 5 Ethereum tokens (GALA, GWETH, GUSDC, GUSDT, GWBTC) |
+| `bridge_out` (→ Ethereum) | PASS | txHash: `b9518d4a360dbfbc123cf53d3e365e9ebec561af4fc8db5831c2e023cdd591eb` |
+| `bridge_in` (← Ethereum) | PASS | txHash: `0xf740a90928a9c0feed23db9b44b6946a32204f19d023ac3583020d95a195c819` |
+
+#### 5. Wrapped Token Tools (9 tools) - ALL PASS ✅
+| Tool | Status | Notes |
+|------|--------|-------|
+| `fetch_all_wrappable_tokens` | PASS | Returns MUSIC ↔ GMUSIC pair |
+| `is_token_wrappable` | PASS | MUSIC: true, counterpart: GMUSIC |
+| `get_wrappable_token` | PASS | Returns full MUSIC metadata |
+| `get_wrap_counterpart` | PASS | MUSIC → GMUSIC |
+| `estimate_wrap_fee` | PASS | Fee: 0 GALA (cross_channel_authorization) |
+| `estimate_unwrap_fee` | PASS | Fee: 0 GALA (automatic) |
+| `wrap_token` | PASS | MUSIC → GMUSIC, txId: `8a946e3455d5dc858ed44dd0dc40e8e7567df5aae8d0eb63a4752f30702fcb28` |
+| `unwrap_token` | PASS | GMUSIC → MUSIC, txId: `2970fb6743bb72be3a338b3f0f26226f86536ac6e0cc6bf994d8a14d9a338427` |
+| `get_wrap_status` | PASS | Status: completed |
+
+**v4.0.20-beta.2 Fix Details:**
+
+The `bridge_in` Solana devnet "block height exceeded" error was fixed with:
+1. **WebSocket confirmation primary** - Keeps real-time feedback (user preference)
+2. **Polling fallback** - Only when WebSocket fails with block height exceeded
+3. **Retry with fresh blockhash** - Up to 3 attempts with exponential backoff
+4. **Status check after WebSocket failure** - Detects if tx landed despite timeout
+
+**Updated Bridge Tool Status:**
+
+| Tool | v4.0.20-beta.1 | v4.0.20-beta.2 | Notes |
+|------|----------------|----------------|-------|
+| `bridge_in` (Solana) | FAIL | **PASS** | Fixed with retry logic |
+| `bridge_in` (Ethereum) | PASS | PASS | Consistent |
+| `bridge_out` (Both) | PASS | PASS | Consistent |
+| All balance queries | PASS | PASS | Consistent |
+| All wrap/unwrap tools | PASS | PASS | Consistent |
+
+**Summary:**
+
+| Category | Total | Pass | Fail | Skip |
+|----------|-------|------|------|------|
+| Solana Balance Queries | 3 | 3 | 0 | 0 |
+| Solana Bridge Operations | 3 | **3** | **0** | 0 |
+| Ethereum Balance Queries | 3 | 3 | 0 | 0 |
+| Ethereum Bridge Operations | 4 | 4 | 0 | 0 |
+| Wrapped Token Tools | 9 | 9 | 0 | 0 |
+| **TOTAL** | **22** | **22** | **0** | **0** |
+
+**v4.0.20-beta.2 Production Readiness:**
+- ✅ **Solana Balance Queries:** All 3 tools work
+- ✅ **Solana Bridge:** Both bridge_out AND bridge_in work!
+- ✅ **Ethereum Balance Queries:** All 3 tools work
+- ✅ **Ethereum Bridge:** Both bridge_out AND bridge_in work
+- ✅ **Wrap/Unwrap:** All 9 tools work (MUSIC ↔ GMUSIC)
+- ✅ **100% Pass Rate** for all tested bridge & wrap tools

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.20-beta.1";
+export declare const MCP_SERVER_VERSION = "4.0.21";
 //# 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.20-beta.1';
+exports.MCP_SERVER_VERSION = '4.0.21';
 //# 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/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@gala-chain/launchpad-mcp-server",
-  "version": "4.0.20-beta.1",
+  "version": "4.0.21",
   "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.20-beta.1",
+    "@gala-chain/launchpad-sdk": "^4.0.21",
     "@humanwhocodes/config-array": "^0.13.0",
     "@modelcontextprotocol/sdk": "^0.5.0",
     "axios": "^1.12.2",