@gala-chain/launchpad-mcp-server 1.22.3 → 1.23.0

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.
Files changed (153) hide show
  1. package/CHANGELOG.md +161 -0
  2. package/README.md +83 -8
  3. package/dist/constants/mcpToolNames.d.ts +69 -11
  4. package/dist/constants/mcpToolNames.d.ts.map +1 -1
  5. package/dist/constants/mcpToolNames.js +47 -9
  6. package/dist/constants/mcpToolNames.js.map +1 -1
  7. package/dist/generated/version.d.ts +1 -1
  8. package/dist/generated/version.js +1 -1
  9. package/dist/prompts/balances.d.ts +24 -0
  10. package/dist/prompts/balances.d.ts.map +1 -0
  11. package/dist/prompts/balances.js +191 -0
  12. package/dist/prompts/balances.js.map +1 -0
  13. package/dist/prompts/creation-utils.d.ts +20 -0
  14. package/dist/prompts/creation-utils.d.ts.map +1 -0
  15. package/dist/prompts/creation-utils.js +115 -0
  16. package/dist/prompts/creation-utils.js.map +1 -0
  17. package/dist/prompts/index.d.ts +9 -2
  18. package/dist/prompts/index.d.ts.map +1 -1
  19. package/dist/prompts/index.js +23 -2
  20. package/dist/prompts/index.js.map +1 -1
  21. package/dist/prompts/pools.d.ts +64 -0
  22. package/dist/prompts/pools.d.ts.map +1 -0
  23. package/dist/prompts/pools.js +548 -0
  24. package/dist/prompts/pools.js.map +1 -0
  25. package/dist/prompts/social.d.ts +16 -0
  26. package/dist/prompts/social.d.ts.map +1 -0
  27. package/dist/prompts/social.js +97 -0
  28. package/dist/prompts/social.js.map +1 -0
  29. package/dist/prompts/trading-calculations.d.ts +52 -0
  30. package/dist/prompts/trading-calculations.d.ts.map +1 -0
  31. package/dist/prompts/trading-calculations.js +479 -0
  32. package/dist/prompts/trading-calculations.js.map +1 -0
  33. package/dist/prompts/transfers.d.ts +16 -0
  34. package/dist/prompts/transfers.d.ts.map +1 -0
  35. package/dist/prompts/transfers.js +100 -0
  36. package/dist/prompts/transfers.js.map +1 -0
  37. package/dist/prompts/utility-tools.d.ts +56 -0
  38. package/dist/prompts/utility-tools.d.ts.map +1 -0
  39. package/dist/prompts/utility-tools.js +338 -0
  40. package/dist/prompts/utility-tools.js.map +1 -0
  41. package/dist/prompts/utility.d.ts +8 -0
  42. package/dist/prompts/utility.d.ts.map +1 -1
  43. package/dist/prompts/utility.js +49 -2
  44. package/dist/prompts/utility.js.map +1 -1
  45. package/dist/server.d.ts +17 -0
  46. package/dist/server.d.ts.map +1 -1
  47. package/dist/server.js +81 -3
  48. package/dist/server.js.map +1 -1
  49. package/dist/tools/index.d.ts +9 -1
  50. package/dist/tools/index.d.ts.map +1 -1
  51. package/dist/tools/index.js +10 -2
  52. package/dist/tools/index.js.map +1 -1
  53. package/dist/tools/utils/getConfig.d.ts +2 -0
  54. package/dist/tools/utils/getConfig.d.ts.map +1 -1
  55. package/dist/tools/utils/getConfig.js +12 -3
  56. package/dist/tools/utils/getConfig.js.map +1 -1
  57. package/dist/tools/utils/getEnvironment.d.ts +8 -0
  58. package/dist/tools/utils/getEnvironment.d.ts.map +1 -0
  59. package/dist/tools/utils/getEnvironment.js +19 -0
  60. package/dist/tools/utils/getEnvironment.js.map +1 -0
  61. package/dist/tools/utils/index.d.ts.map +1 -1
  62. package/dist/tools/utils/index.js +4 -0
  63. package/dist/tools/utils/index.js.map +1 -1
  64. package/dist/tools/utils/switchEnvironment.d.ts +8 -0
  65. package/dist/tools/utils/switchEnvironment.d.ts.map +1 -0
  66. package/dist/tools/utils/switchEnvironment.js +30 -0
  67. package/dist/tools/utils/switchEnvironment.js.map +1 -0
  68. package/dist/types/mcp.d.ts +1 -1
  69. package/dist/types/mcp.d.ts.map +1 -1
  70. package/dist/utils/tool-factory.d.ts +30 -0
  71. package/dist/utils/tool-factory.d.ts.map +1 -1
  72. package/dist/utils/tool-factory.js +31 -0
  73. package/dist/utils/tool-factory.js.map +1 -1
  74. package/docs/AI-AGENT-PATTERNS.md +555 -0
  75. package/docs/CONSTRAINTS-REFERENCE.md +454 -0
  76. package/docs/PROMPT-TOOL-MAPPING.md +352 -0
  77. package/docs/examples/default-values-pattern.md +240 -0
  78. package/docs/examples/tool-factory-pattern.md +217 -0
  79. package/jest.config.js +94 -0
  80. package/package.json +1 -1
  81. package/src/__tests__/integration/fetchTokenDetails.integration.test.ts +258 -0
  82. package/src/__tests__/integration/poolTools.integration.test.ts +185 -0
  83. package/src/__tests__/server.test.ts +256 -0
  84. package/src/constants/mcpToolNames.ts +181 -0
  85. package/src/index.ts +19 -0
  86. package/src/prompts/__tests__/promptStructure.test.ts +137 -0
  87. package/src/prompts/__tests__/registry.test.ts +359 -0
  88. package/src/prompts/analysis.ts +429 -0
  89. package/src/prompts/balances.ts +198 -0
  90. package/src/prompts/create-token.ts +123 -0
  91. package/src/prompts/creation-utils.ts +118 -0
  92. package/src/prompts/dex-trading.ts +86 -0
  93. package/src/prompts/discover-tokens.ts +86 -0
  94. package/src/prompts/index.ts +175 -0
  95. package/src/prompts/liquidity-positions.ts +270 -0
  96. package/src/prompts/pools.ts +571 -0
  97. package/src/prompts/portfolio.ts +242 -0
  98. package/src/prompts/social.ts +100 -0
  99. package/src/prompts/trading-calculations.ts +499 -0
  100. package/src/prompts/trading.ts +191 -0
  101. package/src/prompts/transfers.ts +103 -0
  102. package/src/prompts/utility-tools.ts +349 -0
  103. package/src/prompts/utility.ts +92 -0
  104. package/src/prompts/utils/workflowTemplates.ts +511 -0
  105. package/src/schemas/common-schemas.ts +393 -0
  106. package/src/scripts/test-all-prompts.ts +184 -0
  107. package/src/server.ts +367 -0
  108. package/src/tools/__tests__/dex-tools.test.ts +562 -0
  109. package/src/tools/__tests__/liquidity-positions.test.ts +673 -0
  110. package/src/tools/balance/index.ts +174 -0
  111. package/src/tools/creation/index.ts +182 -0
  112. package/src/tools/dex/index.ts +226 -0
  113. package/src/tools/dex/liquidity-positions.ts +547 -0
  114. package/src/tools/index.ts +94 -0
  115. package/src/tools/pools/fetchAllPools.ts +47 -0
  116. package/src/tools/pools/fetchAllPriceHistory.ts +119 -0
  117. package/src/tools/pools/fetchPoolDetails.ts +27 -0
  118. package/src/tools/pools/fetchPoolDetailsForCalculation.ts +22 -0
  119. package/src/tools/pools/fetchPools.ts +47 -0
  120. package/src/tools/pools/fetchPriceHistory.ts +124 -0
  121. package/src/tools/pools/fetchTokenDetails.ts +77 -0
  122. package/src/tools/pools/index.ts +284 -0
  123. package/src/tools/social/index.ts +64 -0
  124. package/src/tools/trading/index.ts +605 -0
  125. package/src/tools/transfers/index.ts +75 -0
  126. package/src/tools/utils/clearCache.ts +36 -0
  127. package/src/tools/utils/createWallet.ts +19 -0
  128. package/src/tools/utils/explainSdkUsage.ts +1446 -0
  129. package/src/tools/utils/getAddress.ts +12 -0
  130. package/src/tools/utils/getCacheInfo.ts +14 -0
  131. package/src/tools/utils/getConfig.ts +21 -0
  132. package/src/tools/utils/getEnvironment.ts +17 -0
  133. package/src/tools/utils/getEthereumAddress.ts +12 -0
  134. package/src/tools/utils/getUrlByTokenName.ts +12 -0
  135. package/src/tools/utils/getVersion.ts +25 -0
  136. package/src/tools/utils/getWallet.ts +25 -0
  137. package/src/tools/utils/hasWallet.ts +15 -0
  138. package/src/tools/utils/index.ts +37 -0
  139. package/src/tools/utils/isTokenGraduated.ts +16 -0
  140. package/src/tools/utils/setWallet.ts +41 -0
  141. package/src/tools/utils/switchEnvironment.ts +28 -0
  142. package/src/types/mcp.ts +72 -0
  143. package/src/utils/__tests__/validation.test.ts +147 -0
  144. package/src/utils/constraints.ts +155 -0
  145. package/src/utils/default-values.ts +208 -0
  146. package/src/utils/error-handler.ts +69 -0
  147. package/src/utils/error-templates.ts +273 -0
  148. package/src/utils/response-formatter.ts +51 -0
  149. package/src/utils/tool-factory.ts +303 -0
  150. package/src/utils/tool-registry.ts +296 -0
  151. package/src/utils/validation.ts +371 -0
  152. package/tests/wallet-management-integration.test.ts +284 -0
  153. package/tsconfig.json +23 -0
@@ -0,0 +1,36 @@
1
+ /**
2
+ * Clear Cache Tool
3
+ *
4
+ * Clears token metadata cache (all tokens or specific token).
5
+ * Useful for testing or forcing fresh fetches of token data.
6
+ */
7
+
8
+ import { withErrorHandling } from '../../utils/error-handler.js';
9
+ import { formatSuccess } from '../../utils/response-formatter.js';
10
+ import { TOKEN_NAME_SCHEMA } from '../../schemas/common-schemas.js';
11
+ import type { MCPTool } from '../../types/mcp.js';
12
+
13
+ export const clearCacheTool: MCPTool = {
14
+ name: 'gala_launchpad_clear_cache',
15
+ description: 'Clear token metadata cache. Can clear a specific token or the entire cache. The cache automatically warms from fetchPools calls.',
16
+ inputSchema: {
17
+ type: 'object',
18
+ properties: {
19
+ tokenName: {
20
+ ...TOKEN_NAME_SCHEMA,
21
+ description: 'Optional token name to clear (clears all if not provided)',
22
+ },
23
+ },
24
+ },
25
+ handler: withErrorHandling(async (sdk, args) => {
26
+ const tokenName = args?.tokenName;
27
+ sdk.clearCache(tokenName);
28
+
29
+ return formatSuccess({
30
+ message: tokenName
31
+ ? `Cache cleared for token: ${tokenName}`
32
+ : 'Cache cleared for all tokens',
33
+ tokenName: tokenName || null,
34
+ });
35
+ }),
36
+ };
@@ -0,0 +1,19 @@
1
+ /**
2
+ * Create Wallet Tool (45% code reduction via factory pattern)
3
+ */
4
+
5
+ import { createWallet } from '@gala-chain/launchpad-sdk';
6
+ import { createNoParamTool } from '../../utils/tool-factory.js';
7
+
8
+ export const createWalletTool = createNoParamTool({
9
+ name: 'gala_launchpad_create_wallet',
10
+ description: 'Create a new wallet with a random private key. Returns wallet address and private key.',
11
+ handler: () => {
12
+ const wallet = createWallet();
13
+ return {
14
+ address: wallet.address,
15
+ privateKey: wallet.privateKey,
16
+ galaAddress: wallet.galaAddress,
17
+ };
18
+ },
19
+ });