@gala-chain/launchpad-mcp-server 5.0.2-beta.1 → 5.0.4-beta.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 (520) hide show
  1. package/README.md +49 -21
  2. package/dist/ai-docs.json +7357 -0
  3. package/dist/constants/mcpToolNames.d.ts +3 -1
  4. package/dist/constants/mcpToolNames.d.ts.map +1 -1
  5. package/dist/constants/mcpToolNames.js +2 -1
  6. package/dist/constants/mcpToolNames.js.map +1 -1
  7. package/dist/explain-sdk-usage-ai.json +3445 -0
  8. package/dist/generated/version.d.ts +1 -1
  9. package/dist/generated/version.js +1 -1
  10. package/dist/prompts/account.d.ts +24 -0
  11. package/dist/prompts/account.d.ts.map +1 -0
  12. package/dist/prompts/account.js +89 -0
  13. package/dist/prompts/account.js.map +1 -0
  14. package/dist/prompts/api-keys.d.ts +36 -0
  15. package/dist/prompts/api-keys.d.ts.map +1 -0
  16. package/dist/prompts/api-keys.js +251 -0
  17. package/dist/prompts/api-keys.js.map +1 -0
  18. package/dist/prompts/auth.d.ts +29 -0
  19. package/dist/prompts/auth.d.ts.map +1 -0
  20. package/dist/prompts/auth.js +127 -0
  21. package/dist/prompts/auth.js.map +1 -0
  22. package/dist/prompts/balances.d.ts.map +1 -1
  23. package/dist/prompts/balances.js +17 -17
  24. package/dist/prompts/balances.js.map +1 -1
  25. package/dist/prompts/bans.d.ts +23 -0
  26. package/dist/prompts/bans.d.ts.map +1 -0
  27. package/dist/prompts/bans.js +82 -0
  28. package/dist/prompts/bans.js.map +1 -0
  29. package/dist/prompts/bridge.d.ts +2 -1
  30. package/dist/prompts/bridge.d.ts.map +1 -1
  31. package/dist/prompts/bridge.js +91 -227
  32. package/dist/prompts/bridge.js.map +1 -1
  33. package/dist/prompts/burns.d.ts +30 -0
  34. package/dist/prompts/burns.d.ts.map +1 -0
  35. package/dist/prompts/burns.js +127 -0
  36. package/dist/prompts/burns.js.map +1 -0
  37. package/dist/prompts/chat-messages.d.ts +21 -0
  38. package/dist/prompts/chat-messages.d.ts.map +1 -0
  39. package/dist/prompts/chat-messages.js +103 -0
  40. package/dist/prompts/chat-messages.js.map +1 -0
  41. package/dist/prompts/chat.d.ts +67 -0
  42. package/dist/prompts/chat.d.ts.map +1 -0
  43. package/dist/prompts/chat.js +355 -0
  44. package/dist/prompts/chat.js.map +1 -0
  45. package/dist/prompts/comments.d.ts +29 -0
  46. package/dist/prompts/comments.d.ts.map +1 -0
  47. package/dist/prompts/comments.js +133 -0
  48. package/dist/prompts/comments.js.map +1 -0
  49. package/dist/prompts/content-flags.d.ts +29 -0
  50. package/dist/prompts/content-flags.d.ts.map +1 -0
  51. package/dist/prompts/content-flags.js +248 -0
  52. package/dist/prompts/content-flags.js.map +1 -0
  53. package/dist/prompts/content-reactions.d.ts +29 -0
  54. package/dist/prompts/content-reactions.d.ts.map +1 -0
  55. package/dist/prompts/content-reactions.js +77 -0
  56. package/dist/prompts/content-reactions.js.map +1 -0
  57. package/dist/prompts/create-token.d.ts.map +1 -1
  58. package/dist/prompts/create-token.js +11 -18
  59. package/dist/prompts/create-token.js.map +1 -1
  60. package/dist/prompts/dex-trading.d.ts.map +1 -1
  61. package/dist/prompts/dex-trading.js +11 -42
  62. package/dist/prompts/dex-trading.js.map +1 -1
  63. package/dist/prompts/discover-tokens.d.ts.map +1 -1
  64. package/dist/prompts/discover-tokens.js +11 -26
  65. package/dist/prompts/discover-tokens.js.map +1 -1
  66. package/dist/prompts/event-subscriptions.d.ts +45 -0
  67. package/dist/prompts/event-subscriptions.d.ts.map +1 -0
  68. package/dist/prompts/event-subscriptions.js +330 -0
  69. package/dist/prompts/event-subscriptions.js.map +1 -0
  70. package/dist/prompts/explore-dex-pools.d.ts +2 -0
  71. package/dist/prompts/explore-dex-pools.d.ts.map +1 -1
  72. package/dist/prompts/explore-dex-pools.js +26 -104
  73. package/dist/prompts/explore-dex-pools.js.map +1 -1
  74. package/dist/prompts/factories/balance-prompt-factory.d.ts +102 -0
  75. package/dist/prompts/factories/balance-prompt-factory.d.ts.map +1 -0
  76. package/dist/prompts/factories/balance-prompt-factory.js +176 -0
  77. package/dist/prompts/factories/balance-prompt-factory.js.map +1 -0
  78. package/dist/prompts/factories/ban-management-factory.d.ts +90 -0
  79. package/dist/prompts/factories/ban-management-factory.d.ts.map +1 -0
  80. package/dist/prompts/factories/ban-management-factory.js +330 -0
  81. package/dist/prompts/factories/ban-management-factory.js.map +1 -0
  82. package/dist/prompts/factories/calculation-prompt-factory.d.ts +119 -0
  83. package/dist/prompts/factories/calculation-prompt-factory.d.ts.map +1 -0
  84. package/dist/prompts/factories/calculation-prompt-factory.js +183 -0
  85. package/dist/prompts/factories/calculation-prompt-factory.js.map +1 -0
  86. package/dist/prompts/factories/discovery-prompt-factory.d.ts +135 -0
  87. package/dist/prompts/factories/discovery-prompt-factory.d.ts.map +1 -0
  88. package/dist/prompts/factories/discovery-prompt-factory.js +240 -0
  89. package/dist/prompts/factories/discovery-prompt-factory.js.map +1 -0
  90. package/dist/prompts/factories/event-subscription-factory.d.ts +177 -0
  91. package/dist/prompts/factories/event-subscription-factory.d.ts.map +1 -0
  92. package/dist/prompts/factories/event-subscription-factory.js +329 -0
  93. package/dist/prompts/factories/event-subscription-factory.js.map +1 -0
  94. package/dist/prompts/factories/filtered-list-prompt-factory.d.ts +95 -0
  95. package/dist/prompts/factories/filtered-list-prompt-factory.d.ts.map +1 -0
  96. package/dist/prompts/factories/filtered-list-prompt-factory.js +147 -0
  97. package/dist/prompts/factories/filtered-list-prompt-factory.js.map +1 -0
  98. package/dist/prompts/factories/index.d.ts +33 -0
  99. package/dist/prompts/factories/index.d.ts.map +1 -0
  100. package/dist/prompts/factories/index.js +91 -0
  101. package/dist/prompts/factories/index.js.map +1 -0
  102. package/dist/prompts/factories/invite-management-factory.d.ts +88 -0
  103. package/dist/prompts/factories/invite-management-factory.d.ts.map +1 -0
  104. package/dist/prompts/factories/invite-management-factory.js +262 -0
  105. package/dist/prompts/factories/invite-management-factory.js.map +1 -0
  106. package/dist/prompts/factories/reaction-prompt-factory.d.ts +81 -0
  107. package/dist/prompts/factories/reaction-prompt-factory.d.ts.map +1 -0
  108. package/dist/prompts/factories/reaction-prompt-factory.js +188 -0
  109. package/dist/prompts/factories/reaction-prompt-factory.js.map +1 -0
  110. package/dist/prompts/factories/simple-operation-factory.d.ts +166 -0
  111. package/dist/prompts/factories/simple-operation-factory.d.ts.map +1 -0
  112. package/dist/prompts/factories/simple-operation-factory.js +218 -0
  113. package/dist/prompts/factories/simple-operation-factory.js.map +1 -0
  114. package/dist/prompts/index.d.ts +31 -6
  115. package/dist/prompts/index.d.ts.map +1 -1
  116. package/dist/prompts/index.js +136 -5
  117. package/dist/prompts/index.js.map +1 -1
  118. package/dist/prompts/locks.d.ts.map +1 -1
  119. package/dist/prompts/locks.js +32 -56
  120. package/dist/prompts/locks.js.map +1 -1
  121. package/dist/prompts/moderators.d.ts +22 -0
  122. package/dist/prompts/moderators.d.ts.map +1 -0
  123. package/dist/prompts/moderators.js +62 -0
  124. package/dist/prompts/moderators.js.map +1 -0
  125. package/dist/prompts/monitoring.d.ts +3 -1
  126. package/dist/prompts/monitoring.d.ts.map +1 -1
  127. package/dist/prompts/monitoring.js +52 -140
  128. package/dist/prompts/monitoring.js.map +1 -1
  129. package/dist/prompts/overseers.d.ts +34 -0
  130. package/dist/prompts/overseers.d.ts.map +1 -0
  131. package/dist/prompts/overseers.js +117 -0
  132. package/dist/prompts/overseers.js.map +1 -0
  133. package/dist/prompts/pools.d.ts +22 -20
  134. package/dist/prompts/pools.d.ts.map +1 -1
  135. package/dist/prompts/pools.js +150 -251
  136. package/dist/prompts/pools.js.map +1 -1
  137. package/dist/prompts/portfolio.d.ts.map +1 -1
  138. package/dist/prompts/portfolio.js +1 -9
  139. package/dist/prompts/portfolio.js.map +1 -1
  140. package/dist/prompts/prompt-factories.d.ts +179 -0
  141. package/dist/prompts/prompt-factories.d.ts.map +1 -0
  142. package/dist/prompts/prompt-factories.js +230 -0
  143. package/dist/prompts/prompt-factories.js.map +1 -0
  144. package/dist/prompts/referrals.d.ts +27 -0
  145. package/dist/prompts/referrals.d.ts.map +1 -0
  146. package/dist/prompts/referrals.js +176 -0
  147. package/dist/prompts/referrals.js.map +1 -0
  148. package/dist/prompts/streaming.d.ts +84 -0
  149. package/dist/prompts/streaming.d.ts.map +1 -0
  150. package/dist/prompts/streaming.js +411 -0
  151. package/dist/prompts/streaming.js.map +1 -0
  152. package/dist/prompts/tier1-bridge-operations.d.ts +30 -0
  153. package/dist/prompts/tier1-bridge-operations.d.ts.map +1 -0
  154. package/dist/prompts/tier1-bridge-operations.js +634 -0
  155. package/dist/prompts/tier1-bridge-operations.js.map +1 -0
  156. package/dist/prompts/tier1-liquidity-management.d.ts +30 -0
  157. package/dist/prompts/tier1-liquidity-management.d.ts.map +1 -0
  158. package/dist/prompts/tier1-liquidity-management.js +560 -0
  159. package/dist/prompts/tier1-liquidity-management.js.map +1 -0
  160. package/dist/prompts/tier1-pool-discovery.d.ts +30 -0
  161. package/dist/prompts/tier1-pool-discovery.d.ts.map +1 -0
  162. package/dist/prompts/tier1-pool-discovery.js +221 -0
  163. package/dist/prompts/tier1-pool-discovery.js.map +1 -0
  164. package/dist/prompts/tier1-price-history.d.ts +30 -0
  165. package/dist/prompts/tier1-price-history.d.ts.map +1 -0
  166. package/dist/prompts/tier1-price-history.js +429 -0
  167. package/dist/prompts/tier1-price-history.js.map +1 -0
  168. package/dist/prompts/tier1-token-analysis.d.ts +30 -0
  169. package/dist/prompts/tier1-token-analysis.d.ts.map +1 -0
  170. package/dist/prompts/tier1-token-analysis.js +376 -0
  171. package/dist/prompts/tier1-token-analysis.js.map +1 -0
  172. package/dist/prompts/tier2-account-setup.d.ts +24 -0
  173. package/dist/prompts/tier2-account-setup.d.ts.map +1 -0
  174. package/dist/prompts/tier2-account-setup.js +206 -0
  175. package/dist/prompts/tier2-account-setup.js.map +1 -0
  176. package/dist/prompts/tier2-advanced-liquidity.d.ts +24 -0
  177. package/dist/prompts/tier2-advanced-liquidity.d.ts.map +1 -0
  178. package/dist/prompts/tier2-advanced-liquidity.js +298 -0
  179. package/dist/prompts/tier2-advanced-liquidity.js.map +1 -0
  180. package/dist/prompts/tier2-asset-management.d.ts +25 -0
  181. package/dist/prompts/tier2-asset-management.d.ts.map +1 -0
  182. package/dist/prompts/tier2-asset-management.js +246 -0
  183. package/dist/prompts/tier2-asset-management.js.map +1 -0
  184. package/dist/prompts/tier2-token-lifecycle.d.ts +25 -0
  185. package/dist/prompts/tier2-token-lifecycle.d.ts.map +1 -0
  186. package/dist/prompts/tier2-token-lifecycle.js +241 -0
  187. package/dist/prompts/tier2-token-lifecycle.js.map +1 -0
  188. package/dist/prompts/tier3-community-engagement.d.ts +26 -0
  189. package/dist/prompts/tier3-community-engagement.d.ts.map +1 -0
  190. package/dist/prompts/tier3-community-engagement.js +610 -0
  191. package/dist/prompts/tier3-community-engagement.js.map +1 -0
  192. package/dist/prompts/tier3-moderation-workflows.d.ts +31 -0
  193. package/dist/prompts/tier3-moderation-workflows.d.ts.map +1 -0
  194. package/dist/prompts/tier3-moderation-workflows.js +511 -0
  195. package/dist/prompts/tier3-moderation-workflows.js.map +1 -0
  196. package/dist/prompts/tier3-streaming-management.d.ts +26 -0
  197. package/dist/prompts/tier3-streaming-management.d.ts.map +1 -0
  198. package/dist/prompts/tier3-streaming-management.js +797 -0
  199. package/dist/prompts/tier3-streaming-management.js.map +1 -0
  200. package/dist/prompts/token-bans.d.ts +27 -0
  201. package/dist/prompts/token-bans.d.ts.map +1 -0
  202. package/dist/prompts/token-bans.js +77 -0
  203. package/dist/prompts/token-bans.js.map +1 -0
  204. package/dist/prompts/trades.d.ts +22 -0
  205. package/dist/prompts/trades.d.ts.map +1 -0
  206. package/dist/prompts/trades.js +107 -0
  207. package/dist/prompts/trades.js.map +1 -0
  208. package/dist/prompts/trading-calculations.d.ts +3 -1
  209. package/dist/prompts/trading-calculations.d.ts.map +1 -1
  210. package/dist/prompts/trading-calculations.js +134 -270
  211. package/dist/prompts/trading-calculations.js.map +1 -1
  212. package/dist/prompts/trading.d.ts +10 -1
  213. package/dist/prompts/trading.d.ts.map +1 -1
  214. package/dist/prompts/trading.js +128 -2
  215. package/dist/prompts/trading.js.map +1 -1
  216. package/dist/prompts/transfers.d.ts +2 -1
  217. package/dist/prompts/transfers.d.ts.map +1 -1
  218. package/dist/prompts/transfers.js +26 -30
  219. package/dist/prompts/transfers.js.map +1 -1
  220. package/dist/prompts/uploads.d.ts +19 -0
  221. package/dist/prompts/uploads.d.ts.map +1 -0
  222. package/dist/prompts/uploads.js +114 -0
  223. package/dist/prompts/uploads.js.map +1 -0
  224. package/dist/prompts/utility-tools.d.ts.map +1 -1
  225. package/dist/prompts/utility-tools.js +27 -18
  226. package/dist/prompts/utility-tools.js.map +1 -1
  227. package/dist/prompts/utils/index.d.ts +21 -0
  228. package/dist/prompts/utils/index.d.ts.map +1 -0
  229. package/dist/prompts/utils/index.js +38 -0
  230. package/dist/prompts/utils/index.js.map +1 -0
  231. package/dist/prompts/utils/pagination-helpers.d.ts +95 -0
  232. package/dist/prompts/utils/pagination-helpers.d.ts.map +1 -0
  233. package/dist/prompts/utils/pagination-helpers.js +121 -0
  234. package/dist/prompts/utils/pagination-helpers.js.map +1 -0
  235. package/dist/prompts/utils/workflowTemplates.d.ts.map +1 -1
  236. package/dist/prompts/utils/workflowTemplates.js +4 -3
  237. package/dist/prompts/utils/workflowTemplates.js.map +1 -1
  238. package/dist/prompts/wallet.d.ts +24 -0
  239. package/dist/prompts/wallet.d.ts.map +1 -0
  240. package/dist/prompts/wallet.js +139 -0
  241. package/dist/prompts/wallet.js.map +1 -0
  242. package/dist/schemas/common-schemas.d.ts +890 -0
  243. package/dist/schemas/common-schemas.d.ts.map +1 -1
  244. package/dist/schemas/common-schemas.js +853 -1
  245. package/dist/schemas/common-schemas.js.map +1 -1
  246. package/dist/server.d.ts +31 -3
  247. package/dist/server.d.ts.map +1 -1
  248. package/dist/server.js +68 -7
  249. package/dist/server.js.map +1 -1
  250. package/dist/tools/api-keys/index.d.ts +41 -0
  251. package/dist/tools/api-keys/index.d.ts.map +1 -0
  252. package/dist/tools/api-keys/index.js +245 -0
  253. package/dist/tools/api-keys/index.js.map +1 -0
  254. package/dist/tools/auth/index.d.ts +19 -0
  255. package/dist/tools/auth/index.d.ts.map +1 -0
  256. package/dist/tools/auth/index.js +138 -0
  257. package/dist/tools/auth/index.js.map +1 -0
  258. package/dist/tools/balance/helpers/format-balance.d.ts +86 -0
  259. package/dist/tools/balance/helpers/format-balance.d.ts.map +1 -0
  260. package/dist/tools/balance/helpers/format-balance.js +87 -0
  261. package/dist/tools/balance/helpers/format-balance.js.map +1 -0
  262. package/dist/tools/balance/index.d.ts +4 -4
  263. package/dist/tools/balance/index.d.ts.map +1 -1
  264. package/dist/tools/balance/index.js +64 -176
  265. package/dist/tools/balance/index.js.map +1 -1
  266. package/dist/tools/ban/index.d.ts +37 -0
  267. package/dist/tools/ban/index.d.ts.map +1 -0
  268. package/dist/tools/ban/index.js +206 -0
  269. package/dist/tools/ban/index.js.map +1 -0
  270. package/dist/tools/bridge/helpers/bridgeable-token-tools.d.ts +87 -0
  271. package/dist/tools/bridge/helpers/bridgeable-token-tools.d.ts.map +1 -0
  272. package/dist/tools/bridge/helpers/bridgeable-token-tools.js +130 -0
  273. package/dist/tools/bridge/helpers/bridgeable-token-tools.js.map +1 -0
  274. package/dist/tools/bridge/helpers/external-chain-balance-tools.d.ts +87 -0
  275. package/dist/tools/bridge/helpers/external-chain-balance-tools.d.ts.map +1 -0
  276. package/dist/tools/bridge/helpers/external-chain-balance-tools.js +167 -0
  277. package/dist/tools/bridge/helpers/external-chain-balance-tools.js.map +1 -0
  278. package/dist/tools/bridge/index.d.ts +3 -7
  279. package/dist/tools/bridge/index.d.ts.map +1 -1
  280. package/dist/tools/bridge/index.js +89 -371
  281. package/dist/tools/bridge/index.js.map +1 -1
  282. package/dist/tools/burns/index.d.ts.map +1 -1
  283. package/dist/tools/burns/index.js +8 -36
  284. package/dist/tools/burns/index.js.map +1 -1
  285. package/dist/tools/chat/getPinnedChatMessage.d.ts +15 -0
  286. package/dist/tools/chat/getPinnedChatMessage.d.ts.map +1 -0
  287. package/dist/tools/chat/getPinnedChatMessage.js +37 -0
  288. package/dist/tools/chat/getPinnedChatMessage.js.map +1 -0
  289. package/dist/tools/chat/index.d.ts +73 -0
  290. package/dist/tools/chat/index.d.ts.map +1 -0
  291. package/dist/tools/chat/index.js +359 -0
  292. package/dist/tools/chat/index.js.map +1 -0
  293. package/dist/tools/chat/pinChatMessage.d.ts +16 -0
  294. package/dist/tools/chat/pinChatMessage.d.ts.map +1 -0
  295. package/dist/tools/chat/pinChatMessage.js +51 -0
  296. package/dist/tools/chat/pinChatMessage.js.map +1 -0
  297. package/dist/tools/chat/unpinChatMessage.d.ts +16 -0
  298. package/dist/tools/chat/unpinChatMessage.d.ts.map +1 -0
  299. package/dist/tools/chat/unpinChatMessage.js +39 -0
  300. package/dist/tools/chat/unpinChatMessage.js.map +1 -0
  301. package/dist/tools/chat-messages/index.d.ts +35 -0
  302. package/dist/tools/chat-messages/index.d.ts.map +1 -0
  303. package/dist/tools/chat-messages/index.js +165 -0
  304. package/dist/tools/chat-messages/index.js.map +1 -0
  305. package/dist/tools/comments/index.d.ts +44 -0
  306. package/dist/tools/comments/index.d.ts.map +1 -0
  307. package/dist/tools/comments/index.js +171 -0
  308. package/dist/tools/comments/index.js.map +1 -0
  309. package/dist/tools/content-flags/index.d.ts +38 -0
  310. package/dist/tools/content-flags/index.d.ts.map +1 -0
  311. package/dist/tools/content-flags/index.js +282 -0
  312. package/dist/tools/content-flags/index.js.map +1 -0
  313. package/dist/tools/content-reactions/index.d.ts +43 -0
  314. package/dist/tools/content-reactions/index.d.ts.map +1 -0
  315. package/dist/tools/content-reactions/index.js +135 -0
  316. package/dist/tools/content-reactions/index.js.map +1 -0
  317. package/dist/tools/creation/index.d.ts.map +1 -1
  318. package/dist/tools/creation/index.js +2 -5
  319. package/dist/tools/creation/index.js.map +1 -1
  320. package/dist/tools/dex/fetchAllDexPools.d.ts.map +1 -1
  321. package/dist/tools/dex/fetchAllDexPools.js +5 -21
  322. package/dist/tools/dex/fetchAllDexPools.js.map +1 -1
  323. package/dist/tools/dex/fetchDexPools.d.ts.map +1 -1
  324. package/dist/tools/dex/fetchDexPools.js +11 -28
  325. package/dist/tools/dex/fetchDexPools.js.map +1 -1
  326. package/dist/tools/dex/helpers.d.ts +479 -0
  327. package/dist/tools/dex/helpers.d.ts.map +1 -0
  328. package/dist/tools/dex/helpers.js +570 -0
  329. package/dist/tools/dex/helpers.js.map +1 -0
  330. package/dist/tools/dex/index.d.ts +50 -11
  331. package/dist/tools/dex/index.d.ts.map +1 -1
  332. package/dist/tools/dex/index.js +124 -486
  333. package/dist/tools/dex/index.js.map +1 -1
  334. package/dist/tools/dex/leaderboard.d.ts.map +1 -1
  335. package/dist/tools/dex/leaderboard.js +5 -70
  336. package/dist/tools/dex/leaderboard.js.map +1 -1
  337. package/dist/tools/dex/liquidity-positions.d.ts.map +1 -1
  338. package/dist/tools/dex/liquidity-positions.js +20 -91
  339. package/dist/tools/dex/liquidity-positions.js.map +1 -1
  340. package/dist/tools/dex/volume.d.ts.map +1 -1
  341. package/dist/tools/dex/volume.js +6 -21
  342. package/dist/tools/dex/volume.js.map +1 -1
  343. package/dist/tools/dex-analytics/index.d.ts +48 -0
  344. package/dist/tools/dex-analytics/index.d.ts.map +1 -0
  345. package/dist/tools/dex-analytics/index.js +111 -0
  346. package/dist/tools/dex-analytics/index.js.map +1 -0
  347. package/dist/tools/dex-liquidity/index.d.ts +22 -0
  348. package/dist/tools/dex-liquidity/index.d.ts.map +1 -0
  349. package/dist/tools/dex-liquidity/index.js +384 -0
  350. package/dist/tools/dex-liquidity/index.js.map +1 -0
  351. package/dist/tools/dex-pools/index.d.ts +60 -0
  352. package/dist/tools/dex-pools/index.d.ts.map +1 -0
  353. package/dist/tools/dex-pools/index.js +231 -0
  354. package/dist/tools/dex-pools/index.js.map +1 -0
  355. package/dist/tools/handler-factories.d.ts +1401 -0
  356. package/dist/tools/handler-factories.d.ts.map +1 -0
  357. package/dist/tools/handler-factories.js +1680 -0
  358. package/dist/tools/handler-factories.js.map +1 -0
  359. package/dist/tools/index.d.ts +1 -11
  360. package/dist/tools/index.d.ts.map +1 -1
  361. package/dist/tools/index.js +171 -27
  362. package/dist/tools/index.js.map +1 -1
  363. package/dist/tools/locks/index.d.ts +2 -0
  364. package/dist/tools/locks/index.d.ts.map +1 -1
  365. package/dist/tools/locks/index.js +9 -86
  366. package/dist/tools/locks/index.js.map +1 -1
  367. package/dist/tools/moderators/index.d.ts +53 -0
  368. package/dist/tools/moderators/index.d.ts.map +1 -0
  369. package/dist/tools/moderators/index.js +258 -0
  370. package/dist/tools/moderators/index.js.map +1 -0
  371. package/dist/tools/overseers/getOverseerUserSummary.d.ts +15 -0
  372. package/dist/tools/overseers/getOverseerUserSummary.d.ts.map +1 -0
  373. package/dist/tools/overseers/getOverseerUserSummary.js +40 -0
  374. package/dist/tools/overseers/getOverseerUserSummary.js.map +1 -0
  375. package/dist/tools/overseers/index.d.ts +58 -0
  376. package/dist/tools/overseers/index.d.ts.map +1 -0
  377. package/dist/tools/overseers/index.js +325 -0
  378. package/dist/tools/overseers/index.js.map +1 -0
  379. package/dist/tools/overseers/listOverseerUsers.d.ts +15 -0
  380. package/dist/tools/overseers/listOverseerUsers.d.ts.map +1 -0
  381. package/dist/tools/overseers/listOverseerUsers.js +76 -0
  382. package/dist/tools/overseers/listOverseerUsers.js.map +1 -0
  383. package/dist/tools/pagination-handler-factory.d.ts +131 -0
  384. package/dist/tools/pagination-handler-factory.d.ts.map +1 -0
  385. package/dist/tools/pagination-handler-factory.js +159 -0
  386. package/dist/tools/pagination-handler-factory.js.map +1 -0
  387. package/dist/tools/pools/checkPoolExists.d.ts +16 -0
  388. package/dist/tools/pools/checkPoolExists.d.ts.map +1 -0
  389. package/dist/tools/pools/checkPoolExists.js +48 -0
  390. package/dist/tools/pools/checkPoolExists.js.map +1 -0
  391. package/dist/tools/pools/fetchAllPools.d.ts.map +1 -1
  392. package/dist/tools/pools/fetchAllPools.js +51 -11
  393. package/dist/tools/pools/fetchAllPools.js.map +1 -1
  394. package/dist/tools/pools/fetchAllPriceHistory.d.ts.map +1 -1
  395. package/dist/tools/pools/fetchAllPriceHistory.js +11 -51
  396. package/dist/tools/pools/fetchAllPriceHistory.js.map +1 -1
  397. package/dist/tools/pools/fetchPoolDetails.d.ts.map +1 -1
  398. package/dist/tools/pools/fetchPoolDetails.js +4 -11
  399. package/dist/tools/pools/fetchPoolDetails.js.map +1 -1
  400. package/dist/tools/pools/fetchPools.d.ts.map +1 -1
  401. package/dist/tools/pools/fetchPools.js +40 -20
  402. package/dist/tools/pools/fetchPools.js.map +1 -1
  403. package/dist/tools/pools/fetchPriceHistory.d.ts.map +1 -1
  404. package/dist/tools/pools/fetchPriceHistory.js +10 -51
  405. package/dist/tools/pools/fetchPriceHistory.js.map +1 -1
  406. package/dist/tools/pools/fetchTokenDetails.d.ts.map +1 -1
  407. package/dist/tools/pools/fetchTokenDetails.js +4 -35
  408. package/dist/tools/pools/fetchTokenDetails.js.map +1 -1
  409. package/dist/tools/pools/index.d.ts +2 -0
  410. package/dist/tools/pools/index.d.ts.map +1 -1
  411. package/dist/tools/pools/index.js +103 -35
  412. package/dist/tools/pools/index.js.map +1 -1
  413. package/dist/tools/pools/onDexPoolCreation.d.ts +1 -2
  414. package/dist/tools/pools/onDexPoolCreation.d.ts.map +1 -1
  415. package/dist/tools/pools/onDexPoolCreation.js +14 -48
  416. package/dist/tools/pools/onDexPoolCreation.js.map +1 -1
  417. package/dist/tools/pools/onLaunchpadTokenCreation.d.ts +1 -2
  418. package/dist/tools/pools/onLaunchpadTokenCreation.d.ts.map +1 -1
  419. package/dist/tools/pools/onLaunchpadTokenCreation.js +9 -42
  420. package/dist/tools/pools/onLaunchpadTokenCreation.js.map +1 -1
  421. package/dist/tools/pools/priceHistoryFactory.d.ts +44 -0
  422. package/dist/tools/pools/priceHistoryFactory.d.ts.map +1 -0
  423. package/dist/tools/pools/priceHistoryFactory.js +154 -0
  424. package/dist/tools/pools/priceHistoryFactory.js.map +1 -0
  425. package/dist/tools/pools/updateTokenSocials.d.ts +16 -0
  426. package/dist/tools/pools/updateTokenSocials.d.ts.map +1 -0
  427. package/dist/tools/pools/updateTokenSocials.js +84 -0
  428. package/dist/tools/pools/updateTokenSocials.js.map +1 -0
  429. package/dist/tools/referrals/index.d.ts +12 -0
  430. package/dist/tools/referrals/index.d.ts.map +1 -0
  431. package/dist/tools/referrals/index.js +110 -0
  432. package/dist/tools/referrals/index.js.map +1 -0
  433. package/dist/tools/streaming/index.d.ts +94 -0
  434. package/dist/tools/streaming/index.d.ts.map +1 -0
  435. package/dist/tools/streaming/index.js +549 -0
  436. package/dist/tools/streaming/index.js.map +1 -0
  437. package/dist/tools/streaming/setNextLiveStreamCountdown.d.ts +16 -0
  438. package/dist/tools/streaming/setNextLiveStreamCountdown.d.ts.map +1 -0
  439. package/dist/tools/streaming/setNextLiveStreamCountdown.js +62 -0
  440. package/dist/tools/streaming/setNextLiveStreamCountdown.js.map +1 -0
  441. package/dist/tools/token-ban/index.d.ts +39 -0
  442. package/dist/tools/token-ban/index.d.ts.map +1 -0
  443. package/dist/tools/token-ban/index.js +177 -0
  444. package/dist/tools/token-ban/index.js.map +1 -0
  445. package/dist/tools/tool-factory.d.ts +84 -0
  446. package/dist/tools/tool-factory.d.ts.map +1 -0
  447. package/dist/tools/tool-factory.js +135 -0
  448. package/dist/tools/tool-factory.js.map +1 -0
  449. package/dist/tools/trades/index.d.ts +20 -0
  450. package/dist/tools/trades/index.d.ts.map +1 -0
  451. package/dist/tools/trades/index.js +113 -0
  452. package/dist/tools/trades/index.js.map +1 -0
  453. package/dist/tools/trading/helpers/arg-extractors.d.ts +128 -0
  454. package/dist/tools/trading/helpers/arg-extractors.d.ts.map +1 -0
  455. package/dist/tools/trading/helpers/arg-extractors.js +215 -0
  456. package/dist/tools/trading/helpers/arg-extractors.js.map +1 -0
  457. package/dist/tools/trading/helpers/index.d.ts +8 -0
  458. package/dist/tools/trading/helpers/index.d.ts.map +1 -0
  459. package/dist/tools/trading/helpers/index.js +24 -0
  460. package/dist/tools/trading/helpers/index.js.map +1 -0
  461. package/dist/tools/trading/helpers/trading-schemas.d.ts +276 -0
  462. package/dist/tools/trading/helpers/trading-schemas.d.ts.map +1 -0
  463. package/dist/tools/trading/helpers/trading-schemas.js +310 -0
  464. package/dist/tools/trading/helpers/trading-schemas.js.map +1 -0
  465. package/dist/tools/trading/index.d.ts +2 -0
  466. package/dist/tools/trading/index.d.ts.map +1 -1
  467. package/dist/tools/trading/index.js +148 -371
  468. package/dist/tools/trading/index.js.map +1 -1
  469. package/dist/tools/transfers/index.d.ts +3 -0
  470. package/dist/tools/transfers/index.d.ts.map +1 -1
  471. package/dist/tools/transfers/index.js +72 -52
  472. package/dist/tools/transfers/index.js.map +1 -1
  473. package/dist/tools/utils/cleanup.d.ts.map +1 -1
  474. package/dist/tools/utils/cleanup.js +2 -9
  475. package/dist/tools/utils/cleanup.js.map +1 -1
  476. package/dist/tools/utils/clearCache.d.ts.map +1 -1
  477. package/dist/tools/utils/clearCache.js +5 -7
  478. package/dist/tools/utils/clearCache.js.map +1 -1
  479. package/dist/tools/utils/explainSdkUsage.d.ts +52 -0
  480. package/dist/tools/utils/explainSdkUsage.d.ts.map +1 -1
  481. package/dist/tools/utils/explainSdkUsage.js +1905 -93
  482. package/dist/tools/utils/explainSdkUsage.js.map +1 -1
  483. package/dist/tools/utils/getEthereumAddressFromPrivateKey.d.ts.map +1 -1
  484. package/dist/tools/utils/getEthereumAddressFromPrivateKey.js +2 -1
  485. package/dist/tools/utils/getEthereumAddressFromPrivateKey.js.map +1 -1
  486. package/dist/tools/utils/index.d.ts +2 -0
  487. package/dist/tools/utils/index.d.ts.map +1 -1
  488. package/dist/tools/utils/index.js +2 -12
  489. package/dist/tools/utils/index.js.map +1 -1
  490. package/dist/tools/wallet/index.d.ts +7 -0
  491. package/dist/tools/wallet/index.d.ts.map +1 -0
  492. package/dist/tools/wallet/index.js +24 -0
  493. package/dist/tools/wallet/index.js.map +1 -0
  494. package/dist/utils/date-converter.d.ts +58 -0
  495. package/dist/utils/date-converter.d.ts.map +1 -0
  496. package/dist/utils/date-converter.js +83 -0
  497. package/dist/utils/date-converter.js.map +1 -0
  498. package/dist/utils/pool-filter-builder.d.ts +78 -0
  499. package/dist/utils/pool-filter-builder.d.ts.map +1 -0
  500. package/dist/utils/pool-filter-builder.js +130 -0
  501. package/dist/utils/pool-filter-builder.js.map +1 -0
  502. package/dist/utils/safe-parsers.d.ts +87 -0
  503. package/dist/utils/safe-parsers.d.ts.map +1 -0
  504. package/dist/utils/safe-parsers.js +134 -0
  505. package/dist/utils/safe-parsers.js.map +1 -0
  506. package/dist/utils/validation.d.ts +5 -5
  507. package/dist/utils/validation.d.ts.map +1 -1
  508. package/dist/utils/validation.js +24 -21
  509. package/dist/utils/validation.js.map +1 -1
  510. package/package.json +23 -15
  511. package/.env.example +0 -21
  512. package/.eslintrc.json +0 -88
  513. package/CHANGELOG.md +0 -2161
  514. package/DOCS_AUDIT_REPORT.md +0 -189
  515. package/DRY_REFACTORING_GUIDE.md +0 -271
  516. package/MCP_COVERAGE_REPORT.md +0 -164
  517. package/MCP_TEST_ANALYSIS.md +0 -317
  518. package/jest.integration.config.js +0 -70
  519. package/scripts/inject-version.ts +0 -31
  520. package/scripts/validate-mcp-test-analysis.ts +0 -250
@@ -1 +1 @@
1
- {"version":3,"file":"fetchDexPools.js","sourceRoot":"","sources":["../../../src/tools/dex/fetchDexPools.ts"],"names":[],"mappings":";AAAA;;;;;GAKG;;;AAGH,6EAAkE;AAClE,mEAAiE;AAEpD,QAAA,iBAAiB,GAAY;IACxC,IAAI,EAAE,gCAAgC;IACtC,WAAW,EAAE,6FAA6F;IAC1G,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACV,MAAM,EAAE;gBACN,IAAI,EAAE,QAAQ;gBACd,SAAS,EAAE,CAAC;gBACZ,SAAS,EAAE,GAAG;gBACd,WAAW,EAAE,mJAAmJ;aACjK;YACD,MAAM,EAAE;gBACN,IAAI,EAAE,QAAQ;gBACd,IAAI,EAAE,CAAC,KAAK,EAAE,WAAW,EAAE,UAAU,CAAC;gBACtC,WAAW,EAAE,yCAAyC;aACvD;YACD,SAAS,EAAE;gBACT,IAAI,EAAE,QAAQ;gBACd,IAAI,EAAE,CAAC,KAAK,EAAE,MAAM,CAAC;gBACrB,WAAW,EAAE,sCAAsC;aACpD;YACD,IAAI,EAAE;gBACJ,IAAI,EAAE,QAAQ;gBACd,OAAO,EAAE,CAAC;gBACV,WAAW,EAAE,8CAA8C;aAC5D;YACD,KAAK,EAAE;gBACL,IAAI,EAAE,QAAQ;gBACd,OAAO,EAAE,CAAC;gBACV,OAAO,EAAE,EAAE;gBACX,WAAW,EAAE,uDAAuD;aACrE;SACF;KACF;IACD,OAAO,EAAE,IAAA,oCAAiB,EAAC,KAAK,EAAE,GAAG,EAAE,IAAI,EAAE,EAAE;QAC7C,MAAM,MAAM,GAAG,MAAM,GAAG,CAAC,aAAa,CAAC;YACrC,MAAM,EAAE,IAAI,CAAC,MAA4B;YACzC,MAAM,EAAG,IAAI,CAAC,MAAuD,IAAI,KAAK;YAC9E,SAAS,EAAG,IAAI,CAAC,SAAwC,IAAI,MAAM;YACnE,IAAI,EAAG,IAAI,CAAC,IAAe,IAAI,CAAC;YAChC,KAAK,EAAG,IAAI,CAAC,KAAgB,IAAI,EAAE;SACpC,CAAC,CAAC;QAEH,OAAO,IAAA,qCAAa,EAAC,MAAM,CAAC,CAAC;IAC/B,CAAC,CAAC;CACH,CAAC"}
1
+ {"version":3,"file":"fetchDexPools.js","sourceRoot":"","sources":["../../../src/tools/dex/fetchDexPools.ts"],"names":[],"mappings":";AAAA;;;;;GAKG;;;AAGH,uEAAwE;AACxE,qEAAmE;AACnE,kEAA8D;AAEjD,QAAA,iBAAiB,GAAY;IACxC,IAAI,EAAE,gCAAgC;IACtC,WAAW,EAAE,6FAA6F;IAC1G,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACV,GAAG,yCAAqB;YACxB,IAAI,EAAE;gBACJ,IAAI,EAAE,QAAQ;gBACd,OAAO,EAAE,CAAC;gBACV,WAAW,EAAE,8CAA8C;aAC5D;YACD,KAAK,EAAE;gBACL,IAAI,EAAE,QAAQ;gBACd,OAAO,EAAE,CAAC;gBACV,OAAO,EAAE,EAAE;gBACX,WAAW,EAAE,uDAAuD;aACrE;SACF;KACF;IACD,OAAO,EAAE,IAAA,0CAAmB,EAAC,eAAe,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;QACvD,MAAM,EAAE,IAAI,CAAC,MAA4B;QACzC,MAAM,EAAG,IAAI,CAAC,MAAuD,IAAI,KAAK;QAC9E,SAAS,EAAG,IAAI,CAAC,SAAwC,IAAI,MAAM;QACnE,IAAI,EAAG,IAAI,CAAC,IAAe,IAAI,sCAAkB,CAAC,IAAI;QACtD,KAAK,EAAG,IAAI,CAAC,KAAgB,IAAI,EAAE;KACpC,CAAC,CAAC;CACJ,CAAC"}
@@ -0,0 +1,479 @@
1
+ /**
2
+ * DEX Helper Utilities
3
+ *
4
+ * Shared formatting and validation functions for DEX tools.
5
+ * Reduces duplication across quote, position, volume, and swap tools.
6
+ *
7
+ * Contains:
8
+ * - Quote response formatting (SwapQuoteResult, DexPoolQuoteResult)
9
+ * - Liquidity position formatting
10
+ * - Wallet validation
11
+ * - Volume trend analysis
12
+ * - Token asset mapping
13
+ * - Handler factories for quote tools
14
+ */
15
+ import type { SwapQuoteResult, DexPoolQuoteResult, LaunchpadSDK, LiquidityPosition, DexToken, GetLiquidityPositionsResult, GSwapTokenAsset } from '@gala-chain/launchpad-sdk';
16
+ import type { MCPTool } from '../../types/mcp.js';
17
+ /**
18
+ * Format a swap quote response with standardized fields.
19
+ *
20
+ * Handles SwapQuoteResult (from getSwapQuote* methods).
21
+ * Adds optional calculationMode for context.
22
+ *
23
+ * @param quote - The quote result to format (SwapQuoteResult)
24
+ * @param mode - Optional calculation mode (e.g., 'local', 'external')
25
+ * @returns Formatted response object with common quote fields
26
+ */
27
+ export declare function formatQuoteResponse(quote: SwapQuoteResult, mode?: string): {
28
+ message: string;
29
+ calculationMode?: string | undefined;
30
+ fromToken: string;
31
+ toToken: string;
32
+ inputAmount: string;
33
+ estimatedOutput: string;
34
+ feeTier: number;
35
+ priceImpact: string;
36
+ executionPrice: string;
37
+ };
38
+ /**
39
+ * Format a DEX pool quote response with additional pool data.
40
+ *
41
+ * Handles DexPoolQuoteResult (from calculateDexPoolQuote* methods).
42
+ * Includes price tracking and optionally cached data indicator.
43
+ *
44
+ * @param quote - The pool quote result to format (DexPoolQuoteResult)
45
+ * @param tokens - Tuple of [fromToken, toToken] symbols
46
+ * @param mode - Calculation mode ('local' or 'external')
47
+ * @param usedCachedData - Whether cached pool data was used (optional)
48
+ * @returns Formatted response object with pool quote fields
49
+ */
50
+ export declare function formatDexPoolQuoteResponse(quote: DexPoolQuoteResult, tokens: [fromToken: string, toToken: string], mode: 'local' | 'external', usedCachedData?: boolean): {
51
+ message: string;
52
+ usedCachedData?: boolean | undefined;
53
+ mode: "local" | "external";
54
+ fromToken: string;
55
+ toToken: string;
56
+ inputAmount: string;
57
+ outputAmount: string;
58
+ currentSqrtPrice: string;
59
+ newSqrtPrice: string;
60
+ priceImpact: string | undefined;
61
+ executionPrice: string | undefined;
62
+ };
63
+ /**
64
+ * Options for formatting a position
65
+ */
66
+ export interface FormatPositionOptions {
67
+ /** Include owner address */
68
+ includeOwner?: boolean;
69
+ /** Include timestamps (createdAt, updatedAt) */
70
+ includeTimestamps?: boolean;
71
+ }
72
+ /**
73
+ * Formatted position data for MCP responses
74
+ */
75
+ export interface FormattedPosition {
76
+ positionId: string;
77
+ token0: string | Record<string, unknown>;
78
+ token1: string | Record<string, unknown>;
79
+ feeTier?: number;
80
+ liquidity: string;
81
+ amount0?: string;
82
+ amount1?: string;
83
+ feeAmount0?: string;
84
+ feeAmount1?: string;
85
+ tickLower: number;
86
+ tickUpper: number;
87
+ ownerAddress?: string;
88
+ createdAt?: string;
89
+ updatedAt?: string;
90
+ }
91
+ /**
92
+ * Format a single liquidity position for MCP response.
93
+ *
94
+ * Core formatting function used by all position-related tools.
95
+ * Extracts and maps position fields consistently with optional metadata.
96
+ *
97
+ * @param position - SDK position object (LiquidityPosition)
98
+ * @param options - Optional formatting options (includeOwner, includeTimestamps)
99
+ * @returns Formatted position object with standardized fields
100
+ *
101
+ * @example
102
+ * // Basic formatting (for list responses)
103
+ * formatPosition(pos);
104
+ *
105
+ * // With metadata (for detail responses)
106
+ * formatPosition(pos, { includeOwner: true, includeTimestamps: true });
107
+ */
108
+ export declare function formatPosition(position: LiquidityPosition, options?: FormatPositionOptions): FormattedPosition;
109
+ /**
110
+ * Format liquidity position data for MCP response.
111
+ *
112
+ * Convenience wrapper around formatPosition for array mapping.
113
+ * Handles null/undefined positions gracefully.
114
+ *
115
+ * @param positions - Array of position objects (LiquidityPosition) to format
116
+ * @param options - Optional formatting options passed to each position
117
+ * @returns Formatted positions array with standardized fields
118
+ */
119
+ export declare function formatPositions(positions: LiquidityPosition[], options?: FormatPositionOptions): FormattedPosition[];
120
+ /**
121
+ * Validate that a wallet is configured.
122
+ *
123
+ * Checks if SDK has a valid wallet address configured by attempting to get address.
124
+ * Used before wallet-required operations.
125
+ *
126
+ * @param sdk - LaunchpadSDK instance
127
+ * @throws Error if wallet not configured
128
+ */
129
+ export declare function validateWalletConfigured(sdk: LaunchpadSDK): void;
130
+ /**
131
+ * Format volume trend analysis.
132
+ *
133
+ * Extracts trend direction and percentage change for volume metrics.
134
+ * Used for consistent volume summary formatting across tools.
135
+ *
136
+ * @param volume1d - 1-day volume
137
+ * @param volume7d - 7-day volume
138
+ * @param volume30d - 30-day volume
139
+ * @param delta1d - 1-day delta change value
140
+ * @param delta7d - 7-day delta change value
141
+ * @param delta30d - 30-day delta change value
142
+ * @returns Formatted trend analysis object
143
+ */
144
+ export declare function formatVolumeTrends(volume1d: number, volume7d: number, volume30d: number, delta1d: number, delta7d: number, delta30d: number): {
145
+ analysis: {
146
+ volume1dTrend: string;
147
+ volume7dTrend: string;
148
+ volume30dTrend: string;
149
+ volume1dChangePercent: string;
150
+ volume7dChangePercent: string;
151
+ volume30dChangePercent: string;
152
+ };
153
+ formattedMetrics: {
154
+ volume1d: string;
155
+ volume7d: string;
156
+ volume30d: string;
157
+ };
158
+ };
159
+ /**
160
+ * Formatted asset data for MCP responses
161
+ */
162
+ interface FormattedAsset {
163
+ symbol: string;
164
+ name?: string;
165
+ description?: string;
166
+ image?: string;
167
+ balance: string;
168
+ decimals: number;
169
+ verified?: boolean;
170
+ compositeKey?: string;
171
+ }
172
+ /**
173
+ * Map token asset fields for consistent asset formatting.
174
+ *
175
+ * Extracts and formats token asset metadata with rich information.
176
+ * Used for consistent asset mapping across multiple tools.
177
+ *
178
+ * @param assets - Array of asset objects to map
179
+ * @returns Formatted assets array with standardized fields
180
+ */
181
+ export declare function mapTokenAssets(assets: GSwapTokenAsset[]): FormattedAsset[];
182
+ /**
183
+ * Valid GalaSwap fee tiers in basis points.
184
+ * Used for validation and display formatting.
185
+ */
186
+ export declare const VALID_FEE_TIERS: readonly [500, 3000, 10000];
187
+ /**
188
+ * Type representing a valid fee tier value.
189
+ */
190
+ export type FeeTier = (typeof VALID_FEE_TIERS)[number];
191
+ /**
192
+ * Format a fee tier as a percentage string.
193
+ *
194
+ * Converts basis points to percentage for human-readable display.
195
+ * Uses proper formula: fee / 10000 to get decimal, then format as percentage.
196
+ *
197
+ * @param fee - Fee tier in basis points (500, 3000, or 10000)
198
+ * @returns Formatted percentage string (e.g., "0.05%", "0.30%", "1.00%")
199
+ *
200
+ * @example
201
+ * formatFeeTierPercent(500) // "0.05%"
202
+ * formatFeeTierPercent(3000) // "0.30%"
203
+ * formatFeeTierPercent(10000) // "1.00%"
204
+ */
205
+ export declare function formatFeeTierPercent(fee: number): string;
206
+ /**
207
+ * Format an array of fee tiers as percentage strings.
208
+ *
209
+ * Convenience wrapper for formatting multiple fee tiers.
210
+ * Common use case: pool info response with available fee tiers.
211
+ *
212
+ * @param tiers - Array of fee tiers in basis points
213
+ * @returns Array of formatted percentage strings
214
+ *
215
+ * @example
216
+ * formatFeeTiersPercent([500, 3000, 10000])
217
+ * // ["0.05%", "0.30%", "1.00%"]
218
+ */
219
+ export declare function formatFeeTiersPercent(tiers: number[]): string[];
220
+ /**
221
+ * Validate that a fee tier is valid.
222
+ *
223
+ * Checks if the provided fee tier is one of the valid GalaSwap fee tiers.
224
+ * Throws an error with helpful message if invalid.
225
+ *
226
+ * @param fee - Fee tier to validate
227
+ * @throws Error if fee tier is not 500, 3000, or 10000
228
+ *
229
+ * @example
230
+ * validateFeeTier(3000); // OK
231
+ * validateFeeTier(1000); // throws Error
232
+ */
233
+ export declare function validateFeeTier(fee: number): asserts fee is FeeTier;
234
+ /**
235
+ * Token pair parameters extracted from MCP tool args.
236
+ */
237
+ export interface TokenPairParams {
238
+ token0: string;
239
+ token1: string;
240
+ fee: number;
241
+ }
242
+ /**
243
+ * Token pair with tick range parameters extracted from MCP tool args.
244
+ */
245
+ export interface TokenPairWithTicksParams extends TokenPairParams {
246
+ tickLower: number;
247
+ tickUpper: number;
248
+ }
249
+ /**
250
+ * Extract token pair parameters (token0, token1, fee) from MCP args.
251
+ *
252
+ * Eliminates repetitive type casting across DEX tools.
253
+ * Used in pool queries, quotes, and liquidity operations.
254
+ *
255
+ * @param args - MCP tool args object
256
+ * @returns Typed token pair parameters
257
+ *
258
+ * @example
259
+ * const { token0, token1, fee } = extractTokenPairParams(args);
260
+ * await sdk.fetchCompositePoolData({ token0, token1, fee });
261
+ */
262
+ export declare function extractTokenPairParams(args: Record<string, unknown>): TokenPairParams;
263
+ /**
264
+ * Extract token pair with tick range parameters from MCP args.
265
+ *
266
+ * Extends extractTokenPairParams with tick boundaries for concentrated liquidity.
267
+ * Used in position queries, liquidity add/remove, and fee estimation.
268
+ *
269
+ * @param args - MCP tool args object
270
+ * @returns Typed token pair with tick parameters
271
+ *
272
+ * @example
273
+ * const params = extractTokenPairWithTicksParams(args);
274
+ * await sdk.getSwapLiquidityPosition(owner, params);
275
+ */
276
+ export declare function extractTokenPairWithTicksParams(args: Record<string, unknown>): TokenPairWithTicksParams;
277
+ /**
278
+ * Formatted token metadata for MCP responses
279
+ */
280
+ interface FormattedTokenMetadata {
281
+ symbol: string;
282
+ name?: string;
283
+ description?: string;
284
+ image?: string;
285
+ decimals: number;
286
+ verified?: boolean;
287
+ compositeKey?: string;
288
+ category?: string;
289
+ type?: string;
290
+ collection?: string;
291
+ }
292
+ /**
293
+ * Map token metadata for DEX token discovery responses.
294
+ *
295
+ * Extracts common token metadata fields for consistent formatting.
296
+ * Used in fetchAvailableDexTokens and fetchAllAvailableDexTokens.
297
+ *
298
+ * @param token - SDK token metadata object
299
+ * @returns Formatted token metadata object
300
+ */
301
+ export declare function mapTokenMetadata(token: DexToken): FormattedTokenMetadata;
302
+ /**
303
+ * Map array of tokens for DEX token discovery responses.
304
+ *
305
+ * Convenience wrapper around mapTokenMetadata for array mapping.
306
+ *
307
+ * @param tokens - Array of SDK token metadata objects
308
+ * @returns Formatted token metadata array
309
+ *
310
+ * @example
311
+ * const tokens = await sdk.fetchAllAvailableDexTokens({ search });
312
+ * return formatSuccess({ tokens: mapTokenMetadataArray(tokens) });
313
+ */
314
+ export declare function mapTokenMetadataArray(tokens: DexToken[]): FormattedTokenMetadata[];
315
+ /**
316
+ * Parsed position list result from SDK.
317
+ *
318
+ * Normalizes the SDK response format which can be either:
319
+ * - Array of positions (legacy)
320
+ * - Object with items and prices (modern with pricing)
321
+ */
322
+ export interface ParsedPositionListResult {
323
+ /** Array of position objects */
324
+ positions: LiquidityPosition[];
325
+ /** Map of position prices (empty if pricing not requested) */
326
+ prices: Map<string, unknown>;
327
+ /** Number of positions with pricing data */
328
+ pricesCount: number;
329
+ }
330
+ /**
331
+ * SDK position list result - can be array (legacy) or object with items/prices (modern)
332
+ */
333
+ type PositionListInput = LiquidityPosition[] | GetLiquidityPositionsResult;
334
+ /**
335
+ * Parse SDK position list result into normalized format.
336
+ *
337
+ * Handles both array and object returns for backward compatibility.
338
+ * Used by getUserLiquidityPositions and getAllUserLiquidityPositions.
339
+ *
340
+ * @param result - Raw SDK result (array or object with items/prices)
341
+ * @returns Normalized result with positions, prices map, and count
342
+ *
343
+ * @example
344
+ * const { positions, prices, pricesCount } = parsePositionListResult(result);
345
+ */
346
+ export declare function parsePositionListResult(result: PositionListInput): ParsedPositionListResult;
347
+ /**
348
+ * Options for formatting position list response.
349
+ */
350
+ export interface PositionListResponseOptions {
351
+ /** Owner address for the positions */
352
+ ownerAddress: string;
353
+ /** Whether pricing was requested */
354
+ withPrices: boolean;
355
+ /** Optional suffix for the message (e.g., "(auto-paginated)") */
356
+ messageSuffix?: string;
357
+ }
358
+ /**
359
+ * Format position list response with consistent structure.
360
+ *
361
+ * Consolidates the common response formatting logic used by both
362
+ * getUserLiquidityPositions and getAllUserLiquidityPositions tools.
363
+ *
364
+ * @param parsed - Parsed position list result from parsePositionListResult
365
+ * @param options - Formatting options (ownerAddress, withPrices, messageSuffix)
366
+ * @returns Formatted response object ready for formatSuccess()
367
+ *
368
+ * @example
369
+ * const parsed = parsePositionListResult(result);
370
+ * return formatSuccess(formatPositionListResponse(parsed, {
371
+ * ownerAddress: args.ownerAddress,
372
+ * withPrices: !!args.withPrices,
373
+ * messageSuffix: '(auto-paginated)',
374
+ * }));
375
+ */
376
+ export declare function formatPositionListResponse(parsed: ParsedPositionListResult, options: PositionListResponseOptions): Record<string, unknown>;
377
+ /**
378
+ * SDK add liquidity result shape (common fields)
379
+ *
380
+ * Note: liquidity can be string, BigNumber, or bigint depending on SDK version.
381
+ * We use `unknown` for flexibility and pass through to response as-is.
382
+ *
383
+ * Exported for use in handler factories that need to type the responseBuilder parameter.
384
+ */
385
+ export interface AddLiquidityResult {
386
+ transactionId: string;
387
+ status?: string;
388
+ positionId?: string;
389
+ liquidity?: unknown;
390
+ amount0?: string;
391
+ amount1?: string;
392
+ }
393
+ /**
394
+ * Common add liquidity input args shape
395
+ */
396
+ interface AddLiquidityInputArgs {
397
+ token0: string;
398
+ token1: string;
399
+ amount0Desired: string;
400
+ amount1Desired: string;
401
+ }
402
+ /**
403
+ * Format add liquidity response with consistent structure.
404
+ *
405
+ * Consolidates the common response fields for addLiquidityByPrice and addLiquidityByTicks.
406
+ * Both operations return the same core fields, differing only in range representation.
407
+ *
408
+ * @param result - SDK add liquidity result
409
+ * @param inputArgs - Original input arguments (for fallback amounts)
410
+ * @param rangeField - Object with either priceRange or tickRange field
411
+ * @returns Formatted response object ready for formatSuccess()
412
+ *
413
+ * @example
414
+ * return formatSuccess(formatAddLiquidityResponse(result, typedArgs, {
415
+ * priceRange: `${typedArgs.minPrice} - ${typedArgs.maxPrice}`,
416
+ * }));
417
+ */
418
+ export declare function formatAddLiquidityResponse(result: AddLiquidityResult, inputArgs: AddLiquidityInputArgs, rangeField: {
419
+ priceRange: string;
420
+ } | {
421
+ tickRange: string;
422
+ }): Record<string, unknown>;
423
+ /**
424
+ * Quote handler configuration for creating swap quote tools
425
+ */
426
+ export interface SwapQuoteConfig {
427
+ /** Tool name (e.g., 'gala_launchpad_get_swap_quote_exact_input') */
428
+ name: string;
429
+ /** Tool description */
430
+ description: string;
431
+ /** Amount description override */
432
+ amountDescription: string;
433
+ /** SDK method to call */
434
+ sdkMethod: 'getSwapQuoteExactInput' | 'getSwapQuoteExactOutput';
435
+ }
436
+ /**
437
+ * Factory function to create swap quote tools with consistent structure.
438
+ *
439
+ * Eliminates duplication between exactInput and exactOutput quote tools.
440
+ * Both tools share identical schema and handler logic, differing only in
441
+ * the description and SDK method called.
442
+ *
443
+ * @param config - Configuration for the quote tool
444
+ * @returns MCPTool definition for the swap quote tool
445
+ *
446
+ * @example
447
+ * const exactInputTool = createSwapQuoteTool({
448
+ * name: 'gala_launchpad_get_swap_quote_exact_input',
449
+ * description: 'Get swap quote for exact input amount',
450
+ * amountDescription: 'Amount of source token to spend',
451
+ * sdkMethod: 'getSwapQuoteExactInput',
452
+ * });
453
+ */
454
+ export declare function createSwapQuoteTool(config: SwapQuoteConfig): MCPTool;
455
+ /**
456
+ * DEX pool quote handler configuration
457
+ */
458
+ export interface DexPoolQuoteConfig {
459
+ /** Tool name */
460
+ name: string;
461
+ /** Tool description */
462
+ description: string;
463
+ /** Calculation mode ('local' for offline, 'external' for blockchain) */
464
+ mode: 'local' | 'external';
465
+ /** Whether to include compositePoolData parameter (for local mode with caching) */
466
+ includeCachedDataParam?: boolean;
467
+ }
468
+ /**
469
+ * Factory function to create DEX pool quote tools.
470
+ *
471
+ * Eliminates duplication between local and external pool quote tools.
472
+ * Handles the composite pool data fetching and mode-specific SDK calls.
473
+ *
474
+ * @param config - Configuration for the pool quote tool
475
+ * @returns MCPTool definition for the DEX pool quote tool
476
+ */
477
+ export declare function createDexPoolQuoteTool(config: DexPoolQuoteConfig): MCPTool;
478
+ export {};
479
+ //# sourceMappingURL=helpers.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"helpers.d.ts","sourceRoot":"","sources":["../../../src/tools/dex/helpers.ts"],"names":[],"mappings":"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"}