@gala-chain/launchpad-mcp-server 1.7.6 → 1.7.8

package/CHANGELOG.md

@@ -1,5 +1,32 @@
 # Changelog
 
+## 1.7.8
+
+### Patch Changes
+
+- Add token-distribution topic to explainSdkUsage tool
+  - New topic: 'token-distribution' - Analyze token holder distribution and concentration
+  - Includes complete code examples for analyzing holder distribution
+  - Added Gini coefficient calculation example for wealth distribution analysis
+  - Added whale detection and concentration risk analysis patterns
+  - Shows how to identify top holders and calculate ownership percentages
+  - Updated tool description and enum to include new topic
+
+## 1.7.7
+
+### Patch Changes
+
+- Update documentation across all files to reference correct SDK and MCP versions (3.11.7 and 1.7.7)
+- Add comprehensive Token Distribution Patterns section to CLAUDE.md
+- Update explainSdkUsage tool to show v3.11.7
+
+## 1.7.6
+
+### Patch Changes
+
+- Update SDK dependency to v3.11.6 with TypeScript declaration file fixes
+- Fixed TypeScript declaration file output structure by restoring correct tsconfig.json configuration
+
 ## 1.7.5
 
 ### Patch Changes

package/dist/tools/utils/explainSdkUsage.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"explainSdkUsage.d.ts","sourceRoot":"","sources":["../../../src/tools/utils/explainSdkUsage.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAqrBlD;;GAEG;AACH,eAAO,MAAM,mBAAmB,EAAE,OA6DjC,CAAC"}
+{"version":3,"file":"explainSdkUsage.d.ts","sourceRoot":"","sources":["../../../src/tools/utils/explainSdkUsage.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AA2wBlD;;GAEG;AACH,eAAO,MAAM,mBAAmB,EAAE,OA+DjC,CAAC"}

package/dist/tools/utils/explainSdkUsage.js

@@ -624,6 +624,91 @@ async function localCalculationsExample() {
 - \`gala_launchpad_calculate_buy_amount_external\`
 - \`gala_launchpad_calculate_sell_amount_local\`
 - \`gala_launchpad_calculate_sell_amount_external\`
+`,
+    'token-distribution': `
+## Token Holder Distribution with SDK
+
+\`\`\`typescript
+import { createLaunchpadSDK } from '@gala-chain/launchpad-sdk';
+
+async function analyzeTokenDistribution() {
+  const sdk = createLaunchpadSDK({
+    wallet: 'your-private-key-or-mnemonic'
+  });
+
+  // Fetch complete token distribution (all holders, non-paginated)
+  const distribution = await sdk.fetchTokenDistribution('anime');
+
+  console.log(\`Total holders: \${distribution.totalHolders}\`);
+  console.log(\`Total supply: \${distribution.totalSupply}\`);
+  console.log(\`Last updated: \${distribution.lastUpdated.toISOString()}\`);
+
+  // Analyze top holders
+  distribution.holders
+    .sort((a, b) => parseFloat(b.balance) - parseFloat(a.balance))
+    .slice(0, 5)
+    .forEach((holder, index) => {
+      console.log(\`#\${index + 1}: \${holder.address}\`);
+      console.log(\`  Balance: \${holder.balance}\`);
+      console.log(\`  Ownership: \${holder.percentage.toFixed(2)}%\`);
+    });
+
+  // Check concentration risk (e.g., top 5 holders own >80%)
+  const top5Ownership = distribution.holders
+    .sort((a, b) => parseFloat(b.balance) - parseFloat(a.balance))
+    .slice(0, 5)
+    .reduce((sum, holder) => sum + holder.percentage, 0);
+
+  console.log(\`Top 5 holders control: \${top5Ownership.toFixed(2)}%\`);
+
+  // Find specific holder
+  const myAddress = sdk.getAddress();
+  const myHolding = distribution.holders.find(h => h.address === myAddress);
+
+  if (myHolding) {
+    console.log(\`Your ownership: \${myHolding.percentage.toFixed(4)}%\`);
+    console.log(\`Your balance: \${myHolding.balance}\`);
+  }
+
+  // Calculate concentration metrics
+  const giniCoefficient = calculateGini(distribution.holders);
+  console.log(\`Gini coefficient: \${giniCoefficient.toFixed(4)}\`);
+
+  // Count whales (holders with >5%)
+  const whales = distribution.holders.filter(h => h.percentage > 5);
+  console.log(\`Whales (>5%): \${whales.length}\`);
+}
+
+// Helper: Calculate Gini coefficient for wealth distribution
+function calculateGini(holders: Array<{balance: string}>) {
+  const balances = holders.map(h => parseFloat(h.balance)).sort((a, b) => a - b);
+  const n = balances.length;
+  const sum = balances.reduce((a, b) => a + b, 0);
+
+  let numerator = 0;
+  for (let i = 0; i < n; i++) {
+    numerator += (2 * (i + 1) - n - 1) * balances[i];
+  }
+
+  return numerator / (n * sum);
+}
+\`\`\`
+
+**Key Characteristics:**
+- **Non-Paginated**: Returns ALL token holders in single response (no pagination)
+- **Complete Distribution**: Full holder list with addresses, balances, and ownership percentages
+- **BigNumber Precision**: Uses BigNumber.js for accurate percentage calculations
+- **Total Supply**: Computed from holder balances (sum of all holdings)
+- **Service Account Included**: Vault/service accounts appear in holder list
+
+**Use Cases:**
+- Analyze token concentration risk
+- Identify whale holders
+- Track ownership changes over time
+- Generate holder reports
+- Calculate distribution metrics (Gini coefficient, etc.)
+
+**MCP Tool Equivalent:** \`gala_launchpad_fetch_token_distribution\`
 `,
     'mcp-to-sdk-mapping': `
 ## MCP Tool to SDK Method Mapping
@@ -702,6 +787,7 @@ Available topics:
 - 'pool-graduation' - Graduate a bonding curve pool
 - 'fetch-pools' - Query pool data and details
 - 'balances' - Check GALA and token balances
+- 'token-distribution' - Analyze token holder distribution and concentration
 - 'token-creation' - Launch new tokens
 - 'multi-wallet' - Use multiple wallets (privateKey override pattern)
 - 'transfers' - Transfer GALA and tokens between wallets
@@ -722,6 +808,7 @@ Returns runnable TypeScript code examples with explanations.`,
                     'pool-graduation',
                     'fetch-pools',
                     'balances',
+                    'token-distribution',
                     'token-creation',
                     'multi-wallet',
                     'transfers',
@@ -743,7 +830,7 @@ Returns runnable TypeScript code examples with explanations.`,
         return (0, response_formatter_js_1.formatSuccess)({
             topic: args.topic,
             explanation: example,
-            sdkVersion: '3.8.0',
+            sdkVersion: '3.11.7',
             packageName: '@gala-chain/launchpad-sdk',
             documentation: 'https://www.npmjs.com/package/@gala-chain/launchpad-sdk',
         });

package/dist/tools/utils/explainSdkUsage.js.map

@@ -1 +1 @@
-{"version":3,"file":"explainSdkUsage.js","sourceRoot":"","sources":["../../../src/tools/utils/explainSdkUsage.ts"],"names":[],"mappings":";AAAA;;;;;GAKG;;;AAGH,mEAAiE;AACjE,6EAAkE;AAElE;;GAEG;AACH,MAAM,YAAY,GAAG;IACnB,oBAAoB;IACpB,YAAY,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAyCf;IAEC,aAAa,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAsChB;IAEC,iBAAiB,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAwCpB;IAEC,aAAa,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAyChB;IAEC,UAAU,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA4Cb;IAEC,gBAAgB,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAwDnB;IAEC,cAAc,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA4DjB;IAEC,WAAW,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA0Cd;IAEC,gBAAgB,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA4DnB;IAEC,cAAc,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAoEjB;IAEC,oBAAoB,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA8GvB;IAEC,oBAAoB,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA2DvB;CACA,CAAC;AAEF;;GAEG;AACU,QAAA,mBAAmB,GAAY;IAC1C,IAAI,EAAE,kCAAkC;IACxC,WAAW,EAAE;;;;;;;;;;;;;;;;;;;6DAmB8C;IAC3D,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACV,KAAK,EAAE;gBACL,IAAI,EAAE,QAAQ;gBACd,IAAI,EAAE;oBACJ,YAAY;oBACZ,aAAa;oBACb,iBAAiB;oBACjB,aAAa;oBACb,UAAU;oBACV,gBAAgB;oBAChB,cAAc;oBACd,WAAW;oBACX,gBAAgB;oBAChB,cAAc;oBACd,oBAAoB;oBACpB,oBAAoB;iBACrB;gBACD,WAAW,EAAE,gCAAgC;aAC9C;SACF;QACD,QAAQ,EAAE,CAAC,OAAO,CAAC;KACpB;IACD,OAAO,EAAE,IAAA,oCAAiB,EAAC,KAAK,EAAE,IAAI,EAAE,IAAI,EAAE,EAAE;QAC9C,MAAM,OAAO,GAAG,YAAY,CAAC,IAAI,CAAC,KAAkC,CAAC,CAAC;QAEtE,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,MAAM,IAAI,KAAK,CAAC,kBAAkB,IAAI,CAAC,KAAK,EAAE,CAAC,CAAC;QAClD,CAAC;QAED,OAAO,IAAA,qCAAa,EAAC;YACnB,KAAK,EAAE,IAAI,CAAC,KAAK;YACjB,WAAW,EAAE,OAAO;YACpB,UAAU,EAAE,OAAO;YACnB,WAAW,EAAE,2BAA2B;YACxC,aAAa,EAAE,yDAAyD;SACzE,CAAC,CAAC;IACL,CAAC,CAAC;CACH,CAAC"}
+{"version":3,"file":"explainSdkUsage.js","sourceRoot":"","sources":["../../../src/tools/utils/explainSdkUsage.ts"],"names":[],"mappings":";AAAA;;;;;GAKG;;;AAGH,mEAAiE;AACjE,6EAAkE;AAElE;;GAEG;AACH,MAAM,YAAY,GAAG;IACnB,oBAAoB;IACpB,YAAY,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAyCf;IAEC,aAAa,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAsChB;IAEC,iBAAiB,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAwCpB;IAEC,aAAa,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAyChB;IAEC,UAAU,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA4Cb;IAEC,gBAAgB,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAwDnB;IAEC,cAAc,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA4DjB;IAEC,WAAW,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA0Cd;IAEC,gBAAgB,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA4DnB;IAEC,cAAc,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAoEjB;IAEC,oBAAoB,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA8GvB;IAEC,oBAAoB,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAoFvB;IAEC,oBAAoB,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA2DvB;CACA,CAAC;AAEF;;GAEG;AACU,QAAA,mBAAmB,GAAY;IAC1C,IAAI,EAAE,kCAAkC;IACxC,WAAW,EAAE;;;;;;;;;;;;;;;;;;;;6DAoB8C;IAC3D,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACV,KAAK,EAAE;gBACL,IAAI,EAAE,QAAQ;gBACd,IAAI,EAAE;oBACJ,YAAY;oBACZ,aAAa;oBACb,iBAAiB;oBACjB,aAAa;oBACb,UAAU;oBACV,oBAAoB;oBACpB,gBAAgB;oBAChB,cAAc;oBACd,WAAW;oBACX,gBAAgB;oBAChB,cAAc;oBACd,oBAAoB;oBACpB,oBAAoB;iBACrB;gBACD,WAAW,EAAE,gCAAgC;aAC9C;SACF;QACD,QAAQ,EAAE,CAAC,OAAO,CAAC;KACpB;IACD,OAAO,EAAE,IAAA,oCAAiB,EAAC,KAAK,EAAE,IAAI,EAAE,IAAI,EAAE,EAAE;QAC9C,MAAM,OAAO,GAAG,YAAY,CAAC,IAAI,CAAC,KAAkC,CAAC,CAAC;QAEtE,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,MAAM,IAAI,KAAK,CAAC,kBAAkB,IAAI,CAAC,KAAK,EAAE,CAAC,CAAC;QAClD,CAAC;QAED,OAAO,IAAA,qCAAa,EAAC;YACnB,KAAK,EAAE,IAAI,CAAC,KAAK;YACjB,WAAW,EAAE,OAAO;YACpB,UAAU,EAAE,QAAQ;YACpB,WAAW,EAAE,2BAA2B;YACxC,aAAa,EAAE,yDAAyD;SACzE,CAAC,CAAC;IACL,CAAC,CAAC;CACH,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@gala-chain/launchpad-mcp-server",
-  "version": "1.7.6",
+  "version": "1.7.8",
   "description": "MCP server for Gala Launchpad SDK with 50 tools + 14 slash commands - Production-grade AI agent integration with comprehensive validation, optimized performance, and 80%+ test coverage",
   "main": "dist/index.js",
   "bin": {
@@ -62,7 +62,7 @@
   "dependencies": {
     "@gala-chain/api": "^2.4.3",
     "@gala-chain/connect": "^2.4.3",
-    "@gala-chain/launchpad-sdk": "^3.11.5",
+    "@gala-chain/launchpad-sdk": "^3.11.7",
     "@modelcontextprotocol/sdk": "^0.5.0",
     "axios": "^1.12.2",
     "bignumber.js": "^9.1.2",