@catalyst-team/poly-sdk 0.3.0 → 0.4.3

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 (317) hide show
  1. package/README.md +133 -1
  2. package/README.zh-CN.md +2 -0
  3. package/dist/scripts/dip-arb/auto-trade.d.ts +20 -0
  4. package/dist/scripts/dip-arb/auto-trade.d.ts.map +1 -0
  5. package/dist/scripts/dip-arb/auto-trade.js +373 -0
  6. package/dist/scripts/dip-arb/auto-trade.js.map +1 -0
  7. package/dist/scripts/dip-arb/example-basic.d.ts +30 -0
  8. package/dist/scripts/dip-arb/example-basic.d.ts.map +1 -0
  9. package/dist/scripts/dip-arb/example-basic.js +222 -0
  10. package/dist/scripts/dip-arb/example-basic.js.map +1 -0
  11. package/dist/scripts/dip-arb/redeem-positions.d.ts +11 -0
  12. package/dist/scripts/dip-arb/redeem-positions.d.ts.map +1 -0
  13. package/dist/scripts/dip-arb/redeem-positions.js +201 -0
  14. package/dist/scripts/dip-arb/redeem-positions.js.map +1 -0
  15. package/dist/scripts/dip-arb/scan-markets.d.ts +6 -0
  16. package/dist/scripts/dip-arb/scan-markets.d.ts.map +1 -0
  17. package/dist/scripts/dip-arb/scan-markets.js +73 -0
  18. package/dist/scripts/dip-arb/scan-markets.js.map +1 -0
  19. package/dist/src/__tests__/integration/arbitrage-service.integration.test.d.ts.map +1 -0
  20. package/dist/src/__tests__/integration/arbitrage-service.integration.test.js.map +1 -0
  21. package/dist/src/__tests__/integration/bridge-client.integration.test.d.ts.map +1 -0
  22. package/dist/src/__tests__/integration/bridge-client.integration.test.js.map +1 -0
  23. package/dist/src/__tests__/integration/ctf-client.integration.test.d.ts.map +1 -0
  24. package/dist/src/__tests__/integration/ctf-client.integration.test.js.map +1 -0
  25. package/dist/src/__tests__/integration/data-api.integration.test.d.ts.map +1 -0
  26. package/dist/{__tests__ → src/__tests__}/integration/data-api.integration.test.js +21 -18
  27. package/dist/src/__tests__/integration/data-api.integration.test.js.map +1 -0
  28. package/dist/src/__tests__/integration/gamma-api.integration.test.d.ts.map +1 -0
  29. package/dist/src/__tests__/integration/gamma-api.integration.test.js.map +1 -0
  30. package/dist/src/__tests__/integration/market-service.integration.test.d.ts.map +1 -0
  31. package/dist/{__tests__ → src/__tests__}/integration/market-service.integration.test.js +7 -0
  32. package/dist/src/__tests__/integration/market-service.integration.test.js.map +1 -0
  33. package/dist/src/__tests__/integration/realtime-service-v2.integration.test.d.ts.map +1 -0
  34. package/dist/src/__tests__/integration/realtime-service-v2.integration.test.js.map +1 -0
  35. package/dist/src/__tests__/integration/trading-service.integration.test.d.ts.map +1 -0
  36. package/dist/src/__tests__/integration/trading-service.integration.test.js.map +1 -0
  37. package/dist/src/__tests__/test-utils.d.ts.map +1 -0
  38. package/dist/src/__tests__/test-utils.js.map +1 -0
  39. package/dist/src/catalyst/catalyst-query-service.d.ts +109 -0
  40. package/dist/src/catalyst/catalyst-query-service.d.ts.map +1 -0
  41. package/dist/src/catalyst/catalyst-query-service.js +141 -0
  42. package/dist/src/catalyst/catalyst-query-service.js.map +1 -0
  43. package/dist/src/catalyst/catalyst-realtime-service.d.ts +40 -0
  44. package/dist/src/catalyst/catalyst-realtime-service.d.ts.map +1 -0
  45. package/dist/src/catalyst/catalyst-realtime-service.js +125 -0
  46. package/dist/src/catalyst/catalyst-realtime-service.js.map +1 -0
  47. package/dist/src/catalyst/index.d.ts +4 -0
  48. package/dist/src/catalyst/index.d.ts.map +1 -0
  49. package/dist/src/catalyst/index.js +4 -0
  50. package/dist/src/catalyst/index.js.map +1 -0
  51. package/dist/src/catalyst/types.d.ts +178 -0
  52. package/dist/src/catalyst/types.d.ts.map +1 -0
  53. package/dist/src/catalyst/types.js +2 -0
  54. package/dist/src/catalyst/types.js.map +1 -0
  55. package/dist/src/clients/bridge-client.d.ts.map +1 -0
  56. package/dist/src/clients/bridge-client.js.map +1 -0
  57. package/dist/{clients → src/clients}/ctf-client.d.ts +6 -4
  58. package/dist/src/clients/ctf-client.d.ts.map +1 -0
  59. package/dist/src/clients/ctf-client.js.map +1 -0
  60. package/dist/{clients → src/clients}/data-api.d.ts +94 -20
  61. package/dist/src/clients/data-api.d.ts.map +1 -0
  62. package/dist/{clients → src/clients}/data-api.js +119 -52
  63. package/dist/src/clients/data-api.js.map +1 -0
  64. package/dist/{clients → src/clients}/gamma-api.d.ts +74 -0
  65. package/dist/src/clients/gamma-api.d.ts.map +1 -0
  66. package/dist/{clients → src/clients}/gamma-api.js +7 -0
  67. package/dist/src/clients/gamma-api.js.map +1 -0
  68. package/dist/src/clients/subgraph.d.ts.map +1 -0
  69. package/dist/src/clients/subgraph.js.map +1 -0
  70. package/dist/src/core/cache-adapter-bridge.d.ts.map +1 -0
  71. package/dist/src/core/cache-adapter-bridge.js.map +1 -0
  72. package/dist/{core → src/core}/cache.d.ts +2 -0
  73. package/dist/src/core/cache.d.ts.map +1 -0
  74. package/dist/{core → src/core}/cache.js +4 -0
  75. package/dist/src/core/cache.js.map +1 -0
  76. package/dist/src/core/errors.d.ts.map +1 -0
  77. package/dist/src/core/errors.js.map +1 -0
  78. package/dist/{core → src/core}/rate-limiter.d.ts +2 -1
  79. package/dist/src/core/rate-limiter.d.ts.map +1 -0
  80. package/dist/{core → src/core}/rate-limiter.js +7 -0
  81. package/dist/src/core/rate-limiter.js.map +1 -0
  82. package/dist/{core → src/core}/types.d.ts +105 -1
  83. package/dist/src/core/types.d.ts.map +1 -0
  84. package/dist/src/core/types.js +49 -0
  85. package/dist/src/core/types.js.map +1 -0
  86. package/dist/src/core/types.test.d.ts.map +1 -0
  87. package/dist/src/core/types.test.js.map +1 -0
  88. package/dist/src/core/unified-cache.d.ts.map +1 -0
  89. package/dist/src/core/unified-cache.js.map +1 -0
  90. package/dist/{index.d.ts → src/index.d.ts} +24 -5
  91. package/dist/src/index.d.ts.map +1 -0
  92. package/dist/{index.js → src/index.js} +38 -4
  93. package/dist/src/index.js.map +1 -0
  94. package/dist/src/insider-scan/index.d.ts +3 -0
  95. package/dist/src/insider-scan/index.d.ts.map +1 -0
  96. package/dist/src/insider-scan/index.js +3 -0
  97. package/dist/src/insider-scan/index.js.map +1 -0
  98. package/dist/src/insider-scan/insider-scan-service.d.ts +63 -0
  99. package/dist/src/insider-scan/insider-scan-service.d.ts.map +1 -0
  100. package/dist/src/insider-scan/insider-scan-service.js +153 -0
  101. package/dist/src/insider-scan/insider-scan-service.js.map +1 -0
  102. package/dist/src/insider-scan/types.d.ts +205 -0
  103. package/dist/src/insider-scan/types.d.ts.map +1 -0
  104. package/dist/src/insider-scan/types.js +7 -0
  105. package/dist/src/insider-scan/types.js.map +1 -0
  106. package/dist/src/services/arbitrage-service.d.ts.map +1 -0
  107. package/dist/{services → src/services}/arbitrage-service.js +14 -4
  108. package/dist/src/services/arbitrage-service.js.map +1 -0
  109. package/dist/src/services/authorization-service.d.ts.map +1 -0
  110. package/dist/src/services/authorization-service.js.map +1 -0
  111. package/dist/src/services/binance-service.d.ts +154 -0
  112. package/dist/src/services/binance-service.d.ts.map +1 -0
  113. package/dist/src/services/binance-service.js +266 -0
  114. package/dist/src/services/binance-service.js.map +1 -0
  115. package/dist/src/services/dip-arb-service.d.ts +245 -0
  116. package/dist/src/services/dip-arb-service.d.ts.map +1 -0
  117. package/dist/src/services/dip-arb-service.js +1865 -0
  118. package/dist/src/services/dip-arb-service.js.map +1 -0
  119. package/dist/src/services/dip-arb-types.d.ts +553 -0
  120. package/dist/src/services/dip-arb-types.d.ts.map +1 -0
  121. package/dist/src/services/dip-arb-types.js +164 -0
  122. package/dist/src/services/dip-arb-types.js.map +1 -0
  123. package/dist/src/services/market-service.d.ts +431 -0
  124. package/dist/src/services/market-service.d.ts.map +1 -0
  125. package/dist/{services → src/services}/market-service.js +501 -17
  126. package/dist/src/services/market-service.js.map +1 -0
  127. package/dist/{services → src/services}/onchain-service.d.ts +10 -2
  128. package/dist/src/services/onchain-service.d.ts.map +1 -0
  129. package/dist/{services → src/services}/onchain-service.js +8 -0
  130. package/dist/src/services/onchain-service.js.map +1 -0
  131. package/dist/{services → src/services}/realtime-service-v2.d.ts +6 -0
  132. package/dist/src/services/realtime-service-v2.d.ts.map +1 -0
  133. package/dist/{services → src/services}/realtime-service-v2.js +44 -8
  134. package/dist/src/services/realtime-service-v2.js.map +1 -0
  135. package/dist/src/services/smart-money-service.d.ts +769 -0
  136. package/dist/src/services/smart-money-service.d.ts.map +1 -0
  137. package/dist/src/services/smart-money-service.js +1448 -0
  138. package/dist/src/services/smart-money-service.js.map +1 -0
  139. package/dist/src/services/swap-service.d.ts.map +1 -0
  140. package/dist/src/services/swap-service.js.map +1 -0
  141. package/dist/{services → src/services}/trading-service.d.ts +26 -0
  142. package/dist/src/services/trading-service.d.ts.map +1 -0
  143. package/dist/{services → src/services}/trading-service.js +72 -1
  144. package/dist/src/services/trading-service.js.map +1 -0
  145. package/dist/{services → src/services}/wallet-service.d.ts +81 -4
  146. package/dist/src/services/wallet-service.d.ts.map +1 -0
  147. package/dist/{services → src/services}/wallet-service.js +126 -8
  148. package/dist/src/services/wallet-service.js.map +1 -0
  149. package/dist/src/signal/index.d.ts +8 -0
  150. package/dist/src/signal/index.d.ts.map +1 -0
  151. package/dist/src/signal/index.js +7 -0
  152. package/dist/src/signal/index.js.map +1 -0
  153. package/dist/src/signal/signal-service.d.ts +89 -0
  154. package/dist/src/signal/signal-service.d.ts.map +1 -0
  155. package/dist/src/signal/signal-service.js +226 -0
  156. package/dist/src/signal/signal-service.js.map +1 -0
  157. package/dist/src/signal/types.d.ts +280 -0
  158. package/dist/src/signal/types.d.ts.map +1 -0
  159. package/dist/src/signal/types.js +7 -0
  160. package/dist/src/signal/types.js.map +1 -0
  161. package/dist/src/utils/price-utils.d.ts.map +1 -0
  162. package/dist/src/utils/price-utils.js.map +1 -0
  163. package/dist/src/utils/price-utils.test.d.ts.map +1 -0
  164. package/dist/src/utils/price-utils.test.js.map +1 -0
  165. package/dist/src/wallet-report/index.d.ts +3 -0
  166. package/dist/src/wallet-report/index.d.ts.map +1 -0
  167. package/dist/src/wallet-report/index.js +3 -0
  168. package/dist/src/wallet-report/index.js.map +1 -0
  169. package/dist/src/wallet-report/types.d.ts +187 -0
  170. package/dist/src/wallet-report/types.d.ts.map +1 -0
  171. package/dist/src/wallet-report/types.js +7 -0
  172. package/dist/src/wallet-report/types.js.map +1 -0
  173. package/dist/src/wallet-report/wallet-report-service.d.ts +91 -0
  174. package/dist/src/wallet-report/wallet-report-service.d.ts.map +1 -0
  175. package/dist/src/wallet-report/wallet-report-service.js +208 -0
  176. package/dist/src/wallet-report/wallet-report-service.js.map +1 -0
  177. package/dist/src/wallets/hot-wallet-service.d.ts +162 -0
  178. package/dist/src/wallets/hot-wallet-service.d.ts.map +1 -0
  179. package/dist/src/wallets/hot-wallet-service.js +251 -0
  180. package/dist/src/wallets/hot-wallet-service.js.map +1 -0
  181. package/dist/src/wallets/index.d.ts +15 -0
  182. package/dist/src/wallets/index.d.ts.map +1 -0
  183. package/dist/src/wallets/index.js +26 -0
  184. package/dist/src/wallets/index.js.map +1 -0
  185. package/package.json +7 -7
  186. package/dist/__tests__/clob-api.test.d.ts +0 -5
  187. package/dist/__tests__/clob-api.test.d.ts.map +0 -1
  188. package/dist/__tests__/clob-api.test.js +0 -240
  189. package/dist/__tests__/clob-api.test.js.map +0 -1
  190. package/dist/__tests__/integration/arbitrage-service.integration.test.d.ts.map +0 -1
  191. package/dist/__tests__/integration/arbitrage-service.integration.test.js.map +0 -1
  192. package/dist/__tests__/integration/bridge-client.integration.test.d.ts.map +0 -1
  193. package/dist/__tests__/integration/bridge-client.integration.test.js.map +0 -1
  194. package/dist/__tests__/integration/clob-api.integration.test.d.ts +0 -13
  195. package/dist/__tests__/integration/clob-api.integration.test.d.ts.map +0 -1
  196. package/dist/__tests__/integration/clob-api.integration.test.js +0 -170
  197. package/dist/__tests__/integration/clob-api.integration.test.js.map +0 -1
  198. package/dist/__tests__/integration/ctf-client.integration.test.d.ts.map +0 -1
  199. package/dist/__tests__/integration/ctf-client.integration.test.js.map +0 -1
  200. package/dist/__tests__/integration/data-api.integration.test.d.ts.map +0 -1
  201. package/dist/__tests__/integration/data-api.integration.test.js.map +0 -1
  202. package/dist/__tests__/integration/gamma-api.integration.test.d.ts.map +0 -1
  203. package/dist/__tests__/integration/gamma-api.integration.test.js.map +0 -1
  204. package/dist/__tests__/integration/market-service.integration.test.d.ts.map +0 -1
  205. package/dist/__tests__/integration/market-service.integration.test.js.map +0 -1
  206. package/dist/__tests__/integration/realtime-service-v2.integration.test.d.ts.map +0 -1
  207. package/dist/__tests__/integration/realtime-service-v2.integration.test.js.map +0 -1
  208. package/dist/__tests__/integration/trading-service.integration.test.d.ts.map +0 -1
  209. package/dist/__tests__/integration/trading-service.integration.test.js.map +0 -1
  210. package/dist/__tests__/test-utils.d.ts.map +0 -1
  211. package/dist/__tests__/test-utils.js.map +0 -1
  212. package/dist/clients/bridge-client.d.ts.map +0 -1
  213. package/dist/clients/bridge-client.js.map +0 -1
  214. package/dist/clients/clob-api.d.ts +0 -391
  215. package/dist/clients/clob-api.d.ts.map +0 -1
  216. package/dist/clients/clob-api.js +0 -448
  217. package/dist/clients/clob-api.js.map +0 -1
  218. package/dist/clients/ctf-client.d.ts.map +0 -1
  219. package/dist/clients/ctf-client.js.map +0 -1
  220. package/dist/clients/data-api.d.ts.map +0 -1
  221. package/dist/clients/data-api.js.map +0 -1
  222. package/dist/clients/gamma-api.d.ts.map +0 -1
  223. package/dist/clients/gamma-api.js.map +0 -1
  224. package/dist/clients/subgraph.d.ts.map +0 -1
  225. package/dist/clients/subgraph.js.map +0 -1
  226. package/dist/clients/trading-client.d.ts +0 -252
  227. package/dist/clients/trading-client.d.ts.map +0 -1
  228. package/dist/clients/trading-client.js +0 -543
  229. package/dist/clients/trading-client.js.map +0 -1
  230. package/dist/clients/websocket-manager.d.ts +0 -103
  231. package/dist/clients/websocket-manager.d.ts.map +0 -1
  232. package/dist/clients/websocket-manager.js +0 -200
  233. package/dist/clients/websocket-manager.js.map +0 -1
  234. package/dist/core/cache-adapter-bridge.d.ts.map +0 -1
  235. package/dist/core/cache-adapter-bridge.js.map +0 -1
  236. package/dist/core/cache.d.ts.map +0 -1
  237. package/dist/core/cache.js.map +0 -1
  238. package/dist/core/errors.d.ts.map +0 -1
  239. package/dist/core/errors.js.map +0 -1
  240. package/dist/core/rate-limiter.d.ts.map +0 -1
  241. package/dist/core/rate-limiter.js.map +0 -1
  242. package/dist/core/types.d.ts.map +0 -1
  243. package/dist/core/types.js +0 -19
  244. package/dist/core/types.js.map +0 -1
  245. package/dist/core/types.test.d.ts.map +0 -1
  246. package/dist/core/types.test.js.map +0 -1
  247. package/dist/core/unified-cache.d.ts.map +0 -1
  248. package/dist/core/unified-cache.js.map +0 -1
  249. package/dist/index.d.ts.map +0 -1
  250. package/dist/index.js.map +0 -1
  251. package/dist/services/arbitrage-service.d.ts.map +0 -1
  252. package/dist/services/arbitrage-service.js.map +0 -1
  253. package/dist/services/authorization-service.d.ts.map +0 -1
  254. package/dist/services/authorization-service.js.map +0 -1
  255. package/dist/services/market-service.d.ts +0 -208
  256. package/dist/services/market-service.d.ts.map +0 -1
  257. package/dist/services/market-service.js.map +0 -1
  258. package/dist/services/onchain-service.d.ts.map +0 -1
  259. package/dist/services/onchain-service.js.map +0 -1
  260. package/dist/services/realtime-service-v2.d.ts.map +0 -1
  261. package/dist/services/realtime-service-v2.js.map +0 -1
  262. package/dist/services/realtime-service.d.ts +0 -82
  263. package/dist/services/realtime-service.d.ts.map +0 -1
  264. package/dist/services/realtime-service.js +0 -182
  265. package/dist/services/realtime-service.js.map +0 -1
  266. package/dist/services/smart-money-service.d.ts +0 -196
  267. package/dist/services/smart-money-service.d.ts.map +0 -1
  268. package/dist/services/smart-money-service.js +0 -358
  269. package/dist/services/smart-money-service.js.map +0 -1
  270. package/dist/services/swap-service.d.ts.map +0 -1
  271. package/dist/services/swap-service.js.map +0 -1
  272. package/dist/services/trading-service.d.ts.map +0 -1
  273. package/dist/services/trading-service.js.map +0 -1
  274. package/dist/services/wallet-service.d.ts.map +0 -1
  275. package/dist/services/wallet-service.js.map +0 -1
  276. package/dist/utils/price-utils.d.ts.map +0 -1
  277. package/dist/utils/price-utils.js.map +0 -1
  278. package/dist/utils/price-utils.test.d.ts.map +0 -1
  279. package/dist/utils/price-utils.test.js.map +0 -1
  280. /package/dist/{__tests__ → src/__tests__}/integration/arbitrage-service.integration.test.d.ts +0 -0
  281. /package/dist/{__tests__ → src/__tests__}/integration/arbitrage-service.integration.test.js +0 -0
  282. /package/dist/{__tests__ → src/__tests__}/integration/bridge-client.integration.test.d.ts +0 -0
  283. /package/dist/{__tests__ → src/__tests__}/integration/bridge-client.integration.test.js +0 -0
  284. /package/dist/{__tests__ → src/__tests__}/integration/ctf-client.integration.test.d.ts +0 -0
  285. /package/dist/{__tests__ → src/__tests__}/integration/ctf-client.integration.test.js +0 -0
  286. /package/dist/{__tests__ → src/__tests__}/integration/data-api.integration.test.d.ts +0 -0
  287. /package/dist/{__tests__ → src/__tests__}/integration/gamma-api.integration.test.d.ts +0 -0
  288. /package/dist/{__tests__ → src/__tests__}/integration/gamma-api.integration.test.js +0 -0
  289. /package/dist/{__tests__ → src/__tests__}/integration/market-service.integration.test.d.ts +0 -0
  290. /package/dist/{__tests__ → src/__tests__}/integration/realtime-service-v2.integration.test.d.ts +0 -0
  291. /package/dist/{__tests__ → src/__tests__}/integration/realtime-service-v2.integration.test.js +0 -0
  292. /package/dist/{__tests__ → src/__tests__}/integration/trading-service.integration.test.d.ts +0 -0
  293. /package/dist/{__tests__ → src/__tests__}/integration/trading-service.integration.test.js +0 -0
  294. /package/dist/{__tests__ → src/__tests__}/test-utils.d.ts +0 -0
  295. /package/dist/{__tests__ → src/__tests__}/test-utils.js +0 -0
  296. /package/dist/{clients → src/clients}/bridge-client.d.ts +0 -0
  297. /package/dist/{clients → src/clients}/bridge-client.js +0 -0
  298. /package/dist/{clients → src/clients}/ctf-client.js +0 -0
  299. /package/dist/{clients → src/clients}/subgraph.d.ts +0 -0
  300. /package/dist/{clients → src/clients}/subgraph.js +0 -0
  301. /package/dist/{core → src/core}/cache-adapter-bridge.d.ts +0 -0
  302. /package/dist/{core → src/core}/cache-adapter-bridge.js +0 -0
  303. /package/dist/{core → src/core}/errors.d.ts +0 -0
  304. /package/dist/{core → src/core}/errors.js +0 -0
  305. /package/dist/{core → src/core}/types.test.d.ts +0 -0
  306. /package/dist/{core → src/core}/types.test.js +0 -0
  307. /package/dist/{core → src/core}/unified-cache.d.ts +0 -0
  308. /package/dist/{core → src/core}/unified-cache.js +0 -0
  309. /package/dist/{services → src/services}/arbitrage-service.d.ts +0 -0
  310. /package/dist/{services → src/services}/authorization-service.d.ts +0 -0
  311. /package/dist/{services → src/services}/authorization-service.js +0 -0
  312. /package/dist/{services → src/services}/swap-service.d.ts +0 -0
  313. /package/dist/{services → src/services}/swap-service.js +0 -0
  314. /package/dist/{utils → src/utils}/price-utils.d.ts +0 -0
  315. /package/dist/{utils → src/utils}/price-utils.js +0 -0
  316. /package/dist/{utils → src/utils}/price-utils.test.d.ts +0 -0
  317. /package/dist/{utils → src/utils}/price-utils.test.js +0 -0
@@ -0,0 +1,208 @@
1
+ /**
2
+ * WalletReportService
3
+ *
4
+ * Client for querying the WalletReportWorker API.
5
+ *
6
+ * @example
7
+ * ```typescript
8
+ * const service = new WalletReportService({
9
+ * baseUrl: 'http://localhost:8789',
10
+ * });
11
+ *
12
+ * // Get health status
13
+ * const health = await service.health();
14
+ *
15
+ * // Get or generate wallet report
16
+ * const report = await service.getWalletReport('0x...');
17
+ *
18
+ * // Get daily leaderboard
19
+ * const leaderboard = await service.getDailyLeaderboard();
20
+ * ```
21
+ */
22
+ export class WalletReportService {
23
+ baseUrl;
24
+ timeoutMs;
25
+ constructor(config) {
26
+ this.baseUrl = config.baseUrl.replace(/\/+$/, '');
27
+ this.timeoutMs = config.timeoutMs ?? 60_000;
28
+ }
29
+ // ============================================================================
30
+ // Health & Stats
31
+ // ============================================================================
32
+ /**
33
+ * Check worker health and get basic stats
34
+ */
35
+ async health() {
36
+ return this.fetchJson('/v1/health');
37
+ }
38
+ /**
39
+ * Get detailed statistics
40
+ */
41
+ async getStats() {
42
+ return this.fetchJson('/v1/stats');
43
+ }
44
+ // ============================================================================
45
+ // Wallet Reports
46
+ // ============================================================================
47
+ /**
48
+ * Get or generate a wallet report
49
+ *
50
+ * Returns cached report if available, otherwise generates a new one.
51
+ * Use forceRefresh to skip cache and generate a fresh report.
52
+ *
53
+ * @param address - Wallet address
54
+ * @param forceRefresh - Force regeneration even if cached (default: false)
55
+ */
56
+ async getWalletReport(address, forceRefresh = false) {
57
+ const query = forceRefresh ? '?refresh=true' : '';
58
+ return this.fetchJson(`/v1/wallets/${address.toLowerCase()}/report${query}`);
59
+ }
60
+ /**
61
+ * Get wallet report data directly (convenience method)
62
+ *
63
+ * Throws if report is still generating.
64
+ */
65
+ async getWalletReportData(address, forceRefresh = false) {
66
+ const response = await this.getWalletReport(address, forceRefresh);
67
+ if ('status' in response && response.status === 'generating') {
68
+ throw new Error('Report is still generating');
69
+ }
70
+ return response.report;
71
+ }
72
+ // ============================================================================
73
+ // Leaderboards
74
+ // ============================================================================
75
+ /**
76
+ * Get the latest daily leaderboard
77
+ */
78
+ async getDailyLeaderboard() {
79
+ try {
80
+ return await this.fetchJson('/v1/leaderboards/daily');
81
+ }
82
+ catch (error) {
83
+ if (error instanceof Error && error.message.includes('404')) {
84
+ return null;
85
+ }
86
+ throw error;
87
+ }
88
+ }
89
+ /**
90
+ * Get the latest weekly leaderboard
91
+ */
92
+ async getWeeklyLeaderboard() {
93
+ try {
94
+ return await this.fetchJson('/v1/leaderboards/weekly');
95
+ }
96
+ catch (error) {
97
+ if (error instanceof Error && error.message.includes('404')) {
98
+ return null;
99
+ }
100
+ throw error;
101
+ }
102
+ }
103
+ /**
104
+ * Get the latest monthly leaderboard
105
+ */
106
+ async getMonthlyLeaderboard() {
107
+ try {
108
+ return await this.fetchJson('/v1/leaderboards/monthly');
109
+ }
110
+ catch (error) {
111
+ if (error instanceof Error && error.message.includes('404')) {
112
+ return null;
113
+ }
114
+ throw error;
115
+ }
116
+ }
117
+ /**
118
+ * Get leaderboard report data directly (convenience method)
119
+ */
120
+ async getLeaderboardData(period) {
121
+ let response;
122
+ switch (period) {
123
+ case 'daily':
124
+ response = await this.getDailyLeaderboard();
125
+ break;
126
+ case 'weekly':
127
+ response = await this.getWeeklyLeaderboard();
128
+ break;
129
+ case 'monthly':
130
+ response = await this.getMonthlyLeaderboard();
131
+ break;
132
+ }
133
+ return response?.report ?? null;
134
+ }
135
+ /**
136
+ * Force generate a leaderboard report
137
+ */
138
+ async forceGenerateLeaderboard(type) {
139
+ await this.fetchJson(`/v1/leaderboards/${type}/generate`, { method: 'POST' });
140
+ }
141
+ // ============================================================================
142
+ // Report Management
143
+ // ============================================================================
144
+ /**
145
+ * List all reports
146
+ */
147
+ async listReports(params = {}) {
148
+ const query = new URLSearchParams();
149
+ if (params.type)
150
+ query.set('type', params.type);
151
+ if (params.status)
152
+ query.set('status', params.status);
153
+ if (params.limit != null)
154
+ query.set('limit', String(params.limit));
155
+ if (params.offset != null)
156
+ query.set('offset', String(params.offset));
157
+ const q = query.toString();
158
+ return this.fetchJson(`/v1/reports${q ? `?${q}` : ''}`);
159
+ }
160
+ /**
161
+ * Delete a report by ID
162
+ */
163
+ async deleteReport(id) {
164
+ try {
165
+ await this.fetchJson(`/v1/reports/${id}`, { method: 'DELETE' });
166
+ return true;
167
+ }
168
+ catch (error) {
169
+ if (error instanceof Error && error.message.includes('404')) {
170
+ return false;
171
+ }
172
+ throw error;
173
+ }
174
+ }
175
+ /**
176
+ * Cleanup expired reports
177
+ */
178
+ async cleanupExpired() {
179
+ const result = await this.fetchJson('/v1/reports/cleanup', { method: 'POST' });
180
+ return result.deletedCount;
181
+ }
182
+ // ============================================================================
183
+ // Private Methods
184
+ // ============================================================================
185
+ async fetchJson(path, options = {}) {
186
+ const controller = new AbortController();
187
+ const timeout = setTimeout(() => controller.abort(), this.timeoutMs);
188
+ try {
189
+ const res = await fetch(`${this.baseUrl}${path}`, {
190
+ ...options,
191
+ signal: controller.signal,
192
+ headers: {
193
+ 'Content-Type': 'application/json',
194
+ ...options.headers,
195
+ },
196
+ });
197
+ if (!res.ok) {
198
+ const text = await res.text().catch(() => '');
199
+ throw new Error(`WalletReportService HTTP ${res.status}: ${text || res.statusText}`);
200
+ }
201
+ return await res.json();
202
+ }
203
+ finally {
204
+ clearTimeout(timeout);
205
+ }
206
+ }
207
+ }
208
+ //# sourceMappingURL=wallet-report-service.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"wallet-report-service.js","sourceRoot":"","sources":["../../../src/wallet-report/wallet-report-service.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,162 @@
1
+ /**
2
+ * HotWalletService - 自管 Hot Wallet 服务
3
+ *
4
+ * 为每个用户创建专用的 hot wallet,私钥加密存储在服务端。
5
+ * 策略引擎可以完全自动执行所有链上操作。
6
+ *
7
+ * 安全措施:
8
+ * 1. 私钥使用 AES-256-GCM 加密存储
9
+ * 2. 加密密钥从环境变量读取(生产环境应使用 KMS)
10
+ * 3. 私钥解密后仅在内存中短暂存在
11
+ * 4. 操作完成后立即清除内存中的私钥
12
+ *
13
+ * @example
14
+ * ```typescript
15
+ * const hotWalletService = new HotWalletService({
16
+ * encryptionKey: process.env.WALLET_ENCRYPTION_KEY!,
17
+ * store: new UserStore(), // 实现 IWalletStore 接口
18
+ * });
19
+ *
20
+ * // 创建新钱包
21
+ * const { address, encryptedKey } = await hotWalletService.createWallet();
22
+ *
23
+ * // 执行操作
24
+ * await hotWalletService.executeWithWallet(userId, async (wallet) => {
25
+ * await wallet.sendTransaction({ to: '0x...', data: '0x...' });
26
+ * });
27
+ * ```
28
+ */
29
+ import { ethers } from 'ethers';
30
+ export interface HotWalletServiceConfig {
31
+ /** 32-byte hex string for AES-256 encryption */
32
+ encryptionKey: string;
33
+ /** Wallet store implementation */
34
+ store: IWalletStore;
35
+ /** RPC URL (default: Polygon mainnet) */
36
+ rpcUrl?: string;
37
+ /** Chain ID (default: 137) */
38
+ chainId?: number;
39
+ }
40
+ export interface IWalletStore {
41
+ /** Get encrypted private key by user ID */
42
+ getEncryptedKey(userId: string): Promise<string | null>;
43
+ /** Store encrypted private key for user */
44
+ setEncryptedKey(userId: string, encryptedKey: string, address: string): Promise<void>;
45
+ /** Get wallet address by user ID */
46
+ getWalletAddress(userId: string): Promise<string | null>;
47
+ /** Check if user has a wallet */
48
+ hasWallet(userId: string): Promise<boolean>;
49
+ }
50
+ export interface WalletInfo {
51
+ address: string;
52
+ encryptedKey: string;
53
+ }
54
+ export interface EncryptedData {
55
+ /** Initialization vector (hex) */
56
+ iv: string;
57
+ /** Auth tag for GCM (hex) */
58
+ authTag: string;
59
+ /** Encrypted data (hex) */
60
+ data: string;
61
+ }
62
+ export declare class HotWalletService {
63
+ private config;
64
+ private provider;
65
+ constructor(config: HotWalletServiceConfig);
66
+ /**
67
+ * 创建新的 Hot Wallet
68
+ *
69
+ * @returns 钱包地址和加密后的私钥
70
+ */
71
+ createWallet(): Promise<WalletInfo>;
72
+ /**
73
+ * 为用户创建并存储钱包
74
+ *
75
+ * @param userId - 用户 ID
76
+ * @returns 钱包地址
77
+ */
78
+ createWalletForUser(userId: string): Promise<string>;
79
+ /**
80
+ * 获取用户的钱包地址
81
+ *
82
+ * @param userId - 用户 ID
83
+ * @returns 钱包地址,如果没有则返回 null
84
+ */
85
+ getWalletAddress(userId: string): Promise<string | null>;
86
+ /**
87
+ * 检查用户是否有钱包
88
+ *
89
+ * @param userId - 用户 ID
90
+ */
91
+ hasWallet(userId: string): Promise<boolean>;
92
+ /**
93
+ * 使用用户钱包执行操作
94
+ *
95
+ * 私钥仅在回调执行期间存在于内存中,执行完毕后立即清除。
96
+ *
97
+ * @param userId - 用户 ID
98
+ * @param callback - 使用钱包执行的操作
99
+ * @returns 回调的返回值
100
+ */
101
+ executeWithWallet<T>(userId: string, callback: (wallet: ethers.Wallet) => Promise<T>): Promise<T>;
102
+ /**
103
+ * 获取用户钱包的私钥(危险操作,仅用于初始化 SDK)
104
+ *
105
+ * 调用者必须负责安全处理私钥!
106
+ *
107
+ * @param userId - 用户 ID
108
+ * @returns 私钥
109
+ */
110
+ getPrivateKey(userId: string): Promise<string>;
111
+ /**
112
+ * 获取用户钱包余额
113
+ *
114
+ * @param userId - 用户 ID
115
+ */
116
+ getBalance(userId: string): Promise<{
117
+ matic: string;
118
+ maticWei: string;
119
+ }>;
120
+ /**
121
+ * 发送交易
122
+ *
123
+ * @param userId - 用户 ID
124
+ * @param tx - 交易参数
125
+ */
126
+ sendTransaction(userId: string, tx: ethers.providers.TransactionRequest): Promise<ethers.providers.TransactionResponse>;
127
+ /**
128
+ * 签名消息
129
+ *
130
+ * @param userId - 用户 ID
131
+ * @param message - 消息
132
+ */
133
+ signMessage(userId: string, message: string): Promise<string>;
134
+ /**
135
+ * 签名 EIP-712 类型数据
136
+ *
137
+ * @param userId - 用户 ID
138
+ * @param domain - EIP-712 domain
139
+ * @param types - EIP-712 types
140
+ * @param value - 要签名的数据
141
+ */
142
+ signTypedData(userId: string, domain: ethers.TypedDataDomain, types: Record<string, ethers.TypedDataField[]>, value: Record<string, any>): Promise<string>;
143
+ /**
144
+ * 加密私钥
145
+ */
146
+ private encryptPrivateKey;
147
+ /**
148
+ * 解密私钥
149
+ */
150
+ private decryptPrivateKey;
151
+ /**
152
+ * 生成加密密钥
153
+ *
154
+ * 用于首次设置时生成 WALLET_ENCRYPTION_KEY
155
+ */
156
+ static generateEncryptionKey(): string;
157
+ /**
158
+ * 验证加密密钥格式
159
+ */
160
+ static validateEncryptionKey(key: string): boolean;
161
+ }
162
+ //# sourceMappingURL=hot-wallet-service.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"hot-wallet-service.d.ts","sourceRoot":"","sources":["../../../src/wallets/hot-wallet-service.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,251 @@
1
+ /**
2
+ * HotWalletService - 自管 Hot Wallet 服务
3
+ *
4
+ * 为每个用户创建专用的 hot wallet,私钥加密存储在服务端。
5
+ * 策略引擎可以完全自动执行所有链上操作。
6
+ *
7
+ * 安全措施:
8
+ * 1. 私钥使用 AES-256-GCM 加密存储
9
+ * 2. 加密密钥从环境变量读取(生产环境应使用 KMS)
10
+ * 3. 私钥解密后仅在内存中短暂存在
11
+ * 4. 操作完成后立即清除内存中的私钥
12
+ *
13
+ * @example
14
+ * ```typescript
15
+ * const hotWalletService = new HotWalletService({
16
+ * encryptionKey: process.env.WALLET_ENCRYPTION_KEY!,
17
+ * store: new UserStore(), // 实现 IWalletStore 接口
18
+ * });
19
+ *
20
+ * // 创建新钱包
21
+ * const { address, encryptedKey } = await hotWalletService.createWallet();
22
+ *
23
+ * // 执行操作
24
+ * await hotWalletService.executeWithWallet(userId, async (wallet) => {
25
+ * await wallet.sendTransaction({ to: '0x...', data: '0x...' });
26
+ * });
27
+ * ```
28
+ */
29
+ import { ethers } from 'ethers';
30
+ import * as crypto from 'crypto';
31
+ // ===== HotWalletService =====
32
+ export class HotWalletService {
33
+ config;
34
+ provider;
35
+ constructor(config) {
36
+ // Validate encryption key
37
+ if (!config.encryptionKey || config.encryptionKey.length !== 64) {
38
+ throw new Error('Invalid encryption key. Must be a 32-byte hex string (64 characters).');
39
+ }
40
+ this.config = {
41
+ rpcUrl: 'https://polygon-rpc.com',
42
+ chainId: 137,
43
+ ...config,
44
+ };
45
+ this.provider = new ethers.providers.JsonRpcProvider(this.config.rpcUrl, this.config.chainId);
46
+ }
47
+ // ===== Wallet Management =====
48
+ /**
49
+ * 创建新的 Hot Wallet
50
+ *
51
+ * @returns 钱包地址和加密后的私钥
52
+ */
53
+ async createWallet() {
54
+ // 生成新钱包
55
+ const wallet = ethers.Wallet.createRandom();
56
+ // 加密私钥
57
+ const encryptedKey = this.encryptPrivateKey(wallet.privateKey);
58
+ return {
59
+ address: wallet.address,
60
+ encryptedKey: JSON.stringify(encryptedKey),
61
+ };
62
+ }
63
+ /**
64
+ * 为用户创建并存储钱包
65
+ *
66
+ * @param userId - 用户 ID
67
+ * @returns 钱包地址
68
+ */
69
+ async createWalletForUser(userId) {
70
+ // 检查是否已有钱包
71
+ if (await this.config.store.hasWallet(userId)) {
72
+ const existingAddress = await this.config.store.getWalletAddress(userId);
73
+ if (existingAddress) {
74
+ return existingAddress;
75
+ }
76
+ }
77
+ // 创建新钱包
78
+ const { address, encryptedKey } = await this.createWallet();
79
+ // 存储
80
+ await this.config.store.setEncryptedKey(userId, encryptedKey, address);
81
+ return address;
82
+ }
83
+ /**
84
+ * 获取用户的钱包地址
85
+ *
86
+ * @param userId - 用户 ID
87
+ * @returns 钱包地址,如果没有则返回 null
88
+ */
89
+ async getWalletAddress(userId) {
90
+ return this.config.store.getWalletAddress(userId);
91
+ }
92
+ /**
93
+ * 检查用户是否有钱包
94
+ *
95
+ * @param userId - 用户 ID
96
+ */
97
+ async hasWallet(userId) {
98
+ return this.config.store.hasWallet(userId);
99
+ }
100
+ // ===== Wallet Operations =====
101
+ /**
102
+ * 使用用户钱包执行操作
103
+ *
104
+ * 私钥仅在回调执行期间存在于内存中,执行完毕后立即清除。
105
+ *
106
+ * @param userId - 用户 ID
107
+ * @param callback - 使用钱包执行的操作
108
+ * @returns 回调的返回值
109
+ */
110
+ async executeWithWallet(userId, callback) {
111
+ // 获取加密私钥
112
+ const encryptedKey = await this.config.store.getEncryptedKey(userId);
113
+ if (!encryptedKey) {
114
+ throw new Error(`No wallet found for user: ${userId}`);
115
+ }
116
+ // 解密私钥
117
+ let privateKey = null;
118
+ let wallet = null;
119
+ try {
120
+ const encrypted = JSON.parse(encryptedKey);
121
+ privateKey = this.decryptPrivateKey(encrypted);
122
+ // 创建钱包实例
123
+ wallet = new ethers.Wallet(privateKey, this.provider);
124
+ // 执行回调
125
+ return await callback(wallet);
126
+ }
127
+ finally {
128
+ // 清除内存中的敏感数据
129
+ if (privateKey) {
130
+ // 覆盖字符串内存(JavaScript 中的最佳努力)
131
+ privateKey = '0'.repeat(privateKey.length);
132
+ }
133
+ privateKey = null;
134
+ wallet = null;
135
+ }
136
+ }
137
+ /**
138
+ * 获取用户钱包的私钥(危险操作,仅用于初始化 SDK)
139
+ *
140
+ * 调用者必须负责安全处理私钥!
141
+ *
142
+ * @param userId - 用户 ID
143
+ * @returns 私钥
144
+ */
145
+ async getPrivateKey(userId) {
146
+ const encryptedKey = await this.config.store.getEncryptedKey(userId);
147
+ if (!encryptedKey) {
148
+ throw new Error(`No wallet found for user: ${userId}`);
149
+ }
150
+ const encrypted = JSON.parse(encryptedKey);
151
+ return this.decryptPrivateKey(encrypted);
152
+ }
153
+ // ===== Convenience Methods =====
154
+ /**
155
+ * 获取用户钱包余额
156
+ *
157
+ * @param userId - 用户 ID
158
+ */
159
+ async getBalance(userId) {
160
+ const address = await this.config.store.getWalletAddress(userId);
161
+ if (!address) {
162
+ throw new Error(`No wallet found for user: ${userId}`);
163
+ }
164
+ const balance = await this.provider.getBalance(address);
165
+ return {
166
+ matic: ethers.utils.formatEther(balance),
167
+ maticWei: balance.toString(),
168
+ };
169
+ }
170
+ /**
171
+ * 发送交易
172
+ *
173
+ * @param userId - 用户 ID
174
+ * @param tx - 交易参数
175
+ */
176
+ async sendTransaction(userId, tx) {
177
+ return this.executeWithWallet(userId, async (wallet) => {
178
+ return wallet.sendTransaction(tx);
179
+ });
180
+ }
181
+ /**
182
+ * 签名消息
183
+ *
184
+ * @param userId - 用户 ID
185
+ * @param message - 消息
186
+ */
187
+ async signMessage(userId, message) {
188
+ return this.executeWithWallet(userId, async (wallet) => {
189
+ return wallet.signMessage(message);
190
+ });
191
+ }
192
+ /**
193
+ * 签名 EIP-712 类型数据
194
+ *
195
+ * @param userId - 用户 ID
196
+ * @param domain - EIP-712 domain
197
+ * @param types - EIP-712 types
198
+ * @param value - 要签名的数据
199
+ */
200
+ async signTypedData(userId, domain, types, value) {
201
+ return this.executeWithWallet(userId, async (wallet) => {
202
+ return wallet._signTypedData(domain, types, value);
203
+ });
204
+ }
205
+ // ===== Encryption/Decryption =====
206
+ /**
207
+ * 加密私钥
208
+ */
209
+ encryptPrivateKey(privateKey) {
210
+ const key = Buffer.from(this.config.encryptionKey, 'hex');
211
+ const iv = crypto.randomBytes(16);
212
+ const cipher = crypto.createCipheriv('aes-256-gcm', key, iv);
213
+ let encrypted = cipher.update(privateKey, 'utf8', 'hex');
214
+ encrypted += cipher.final('hex');
215
+ const authTag = cipher.getAuthTag();
216
+ return {
217
+ iv: iv.toString('hex'),
218
+ authTag: authTag.toString('hex'),
219
+ data: encrypted,
220
+ };
221
+ }
222
+ /**
223
+ * 解密私钥
224
+ */
225
+ decryptPrivateKey(encrypted) {
226
+ const key = Buffer.from(this.config.encryptionKey, 'hex');
227
+ const iv = Buffer.from(encrypted.iv, 'hex');
228
+ const authTag = Buffer.from(encrypted.authTag, 'hex');
229
+ const decipher = crypto.createDecipheriv('aes-256-gcm', key, iv);
230
+ decipher.setAuthTag(authTag);
231
+ let decrypted = decipher.update(encrypted.data, 'hex', 'utf8');
232
+ decrypted += decipher.final('utf8');
233
+ return decrypted;
234
+ }
235
+ // ===== Static Helpers =====
236
+ /**
237
+ * 生成加密密钥
238
+ *
239
+ * 用于首次设置时生成 WALLET_ENCRYPTION_KEY
240
+ */
241
+ static generateEncryptionKey() {
242
+ return crypto.randomBytes(32).toString('hex');
243
+ }
244
+ /**
245
+ * 验证加密密钥格式
246
+ */
247
+ static validateEncryptionKey(key) {
248
+ return /^[a-f0-9]{64}$/i.test(key);
249
+ }
250
+ }
251
+ //# sourceMappingURL=hot-wallet-service.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"hot-wallet-service.js","sourceRoot":"","sources":["../../../src/wallets/hot-wallet-service.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,15 @@
1
+ /**
2
+ * Wallet Management Module
3
+ *
4
+ * Provides different wallet strategies for automated trading:
5
+ *
6
+ * 1. HotWalletService - Self-managed hot wallets with encrypted private keys
7
+ * - Best for: Full automation, strategy execution
8
+ * - Security: AES-256-GCM encryption, we manage keys
9
+ *
10
+ * 2. PrivyWallet - Privy Delegated Actions (future implementation)
11
+ * - Best for: When users prefer Privy key custody
12
+ * - Security: Privy manages keys with TEE + key sharding
13
+ */
14
+ export { HotWalletService, type HotWalletServiceConfig, type IWalletStore, type WalletInfo, type EncryptedData, } from './hot-wallet-service.js';
15
+ //# sourceMappingURL=index.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/wallets/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,EACL,gBAAgB,EAChB,KAAK,sBAAsB,EAC3B,KAAK,YAAY,EACjB,KAAK,UAAU,EACf,KAAK,aAAa,GACnB,MAAM,yBAAyB,CAAC"}