@gala-chain/launchpad-mcp-server 1.2.18 → 1.2.19
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/CHANGELOG.md +19 -0
- package/README.md +34 -0
- package/package.json +1 -1
package/CHANGELOG.md
CHANGED
|
@@ -1,5 +1,24 @@
|
|
|
1
1
|
# Changelog
|
|
2
2
|
|
|
3
|
+
## 1.2.19 - 2025-10-02
|
|
4
|
+
|
|
5
|
+
### Documentation
|
|
6
|
+
|
|
7
|
+
- **Critical graduation calculation clarification** - Added comprehensive documentation to prevent misinterpretation of `calculateBuyAmountForGraduation` results
|
|
8
|
+
- Updated MCP README with "Understanding Graduation Calculations" section
|
|
9
|
+
- Added amount field reference table showing what each calculation method returns
|
|
10
|
+
- Clarified that `amount` field represents **GALA cost** (e.g., "1594263.419" = 1.59 million GALA), NOT token quantity
|
|
11
|
+
- Added real-world examples showing wrong vs correct interpretation
|
|
12
|
+
- Updated CLAUDE.md with "Token Graduation Patterns" section and complete workflow examples
|
|
13
|
+
- Emphasized that graduation amounts are typically hundreds of thousands to millions of GALA
|
|
14
|
+
|
|
15
|
+
### Benefits
|
|
16
|
+
|
|
17
|
+
- ✅ AI agents will correctly interpret graduation costs as GALA amounts
|
|
18
|
+
- ✅ Prevents confusion between GALA cost and token quantity
|
|
19
|
+
- ✅ Clear reference table for all calculation method return values
|
|
20
|
+
- ✅ Better understanding of bonding curve graduation mechanics
|
|
21
|
+
|
|
3
22
|
## 1.2.15
|
|
4
23
|
|
|
5
24
|
### Patch Changes
|
package/README.md
CHANGED
|
@@ -72,6 +72,40 @@ Add to your `claude_desktop_config.json`:
|
|
|
72
72
|
- `gala_launchpad_calculate_buy_amount_for_graduation` - Calculate cost to graduate pool
|
|
73
73
|
- `gala_launchpad_graduate_token` - One-step pool graduation
|
|
74
74
|
|
|
75
|
+
#### 🎓 Understanding Graduation Calculations
|
|
76
|
+
|
|
77
|
+
**CRITICAL:** The `amount` field in `gala_launchpad_calculate_buy_amount_for_graduation` represents **GALA cost**, NOT token quantity!
|
|
78
|
+
|
|
79
|
+
```javascript
|
|
80
|
+
// Example response
|
|
81
|
+
{
|
|
82
|
+
"amount": "1594263.41948877",
|
|
83
|
+
"transactionFee": "1594.26341949",
|
|
84
|
+
"gasFee": "1"
|
|
85
|
+
}
|
|
86
|
+
|
|
87
|
+
// ❌ WRONG INTERPRETATION:
|
|
88
|
+
// "Need to buy 1,594,263 tokens"
|
|
89
|
+
|
|
90
|
+
// ✅ CORRECT INTERPRETATION:
|
|
91
|
+
// "Need to spend 1,594,263.42 GALA to buy all remaining tokens and graduate the pool"
|
|
92
|
+
```
|
|
93
|
+
|
|
94
|
+
**Amount Field Reference:**
|
|
95
|
+
|
|
96
|
+
| Tool | `amount` Field Represents | Example | Meaning |
|
|
97
|
+
|------|---------------------------|---------|---------|
|
|
98
|
+
| `calculate_buy_amount` | **Token quantity** received | "16843.758" | 16,843.76 tokens |
|
|
99
|
+
| `calculate_sell_amount` | **GALA amount** received | "125.50" | 125.50 GALA |
|
|
100
|
+
| `calculate_buy_amount_for_graduation` | **GALA cost** to graduate | "1594263.419" | 1,594,263.42 GALA |
|
|
101
|
+
| `calculate_initial_buy` | **Token quantity** from pre-buy | "3663321.363" | 3,663,321.36 tokens |
|
|
102
|
+
|
|
103
|
+
**Key Points:**
|
|
104
|
+
- Read the full number as-is - decimal point is NOT shifted
|
|
105
|
+
- Graduation amounts are typically in the hundreds of thousands to millions of GALA
|
|
106
|
+
- Always use `graduate_token` for convenience - it handles calculations internally
|
|
107
|
+
- Pool status changes from "Ongoing" to "Completed" upon successful graduation
|
|
108
|
+
|
|
75
109
|
### Balance & Portfolio (6 tools)
|
|
76
110
|
- `gala_launchpad_fetch_gala_balance` - Get GALA balance
|
|
77
111
|
- `gala_launchpad_fetch_token_balance` - Get token balance
|
package/package.json
CHANGED