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

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 21: v4.0.20-beta.1 Solana Bridging with Helius RPC)
 **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.1
+**MCP Version:** 4.0.20-beta.1
+**Previous Beta:** 4.0.20-beta.0
 
 ## Summary
 
@@ -19,15 +19,15 @@
 | 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 | 29 | 1 | 0 | 1 |
+| **TOTAL** | **127** | **124** | **1** | **1** | **1** |
 
 **Coverage: 100%** (127/127 tools accounted for)
-**Pass Rate: 99%** (122/123 testable tools passed)
+**Pass Rate: 99%** (124/125 testable tools passed)
+**🎉 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.1:** Custom RPC URL support (ethereumRpcUrl, solanaRpcUrl config options)
 **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
 **Known Issues:**
 - `bridge_in` fails on Solana devnet (block height exceeded - timing issue)
 
@@ -1497,3 +1497,100 @@ 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)

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.20-beta.2";
 //# sourceMappingURL=version.d.ts.map

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.20-beta.2';
 //# sourceMappingURL=version.js.map

package/package.json

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