dexbot 1.6.11 → 1.6.13

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 (398) hide show
  1. package/CHANGELOG.md +67 -4
  2. package/README.md +2 -1
  3. package/analysis/README.md +11 -11
  4. package/analysis/ama_fitting/README.md +5 -3
  5. package/analysis/tradingview/README.md +1 -1
  6. package/analysis/trend_detection/DYNAMIC_WEIGHT_RESEARCH.md +3 -3
  7. package/claw/README.md +1 -0
  8. package/claw/docs/AI_BOT_LIBRARY_API.md +2 -0
  9. package/claw/docs/DEXBOT2_TUNING_CHEAT_SHEET.md +4 -3
  10. package/claw/modules/chain_broadcast.ts +7 -1
  11. package/claw/modules/claw_bridge.ts +0 -3
  12. package/claw/modules/claw_launcher.ts +1 -1
  13. package/claw/modules/claw_skill_md.ts +1 -0
  14. package/claw/modules/launcher_mode_detector.ts +9 -2
  15. package/claw/package.json +3 -3
  16. package/claw/runtimes/openclaw-plugin/openclaw.plugin.json +1 -1
  17. package/claw/runtimes/openclaw-plugin/package.json +1 -1
  18. package/claw/tsconfig.json +2 -2
  19. package/dist/analysis/account_resolver.d.ts +1 -1
  20. package/dist/analysis/account_resolver.js +2 -1
  21. package/dist/analysis/ama_fitting/analyze_ama_price_changes.js +3 -4
  22. package/dist/analysis/ama_fitting/analyze_lambda_vs_slow.js +3 -21
  23. package/dist/analysis/ama_fitting/calibrate_convergence_er.js +0 -1
  24. package/dist/analysis/ama_fitting/fetch_lp_candles.js +55 -45
  25. package/dist/analysis/ama_fitting/generate_unified_comparison_chart.d.ts +1 -8
  26. package/dist/analysis/ama_fitting/generate_unified_comparison_chart.js +45 -24
  27. package/dist/analysis/ama_fitting/optimizer_high_resolution.js +34 -78
  28. package/dist/analysis/analyze_args.d.ts +43 -0
  29. package/dist/analysis/analyze_args.js +61 -0
  30. package/dist/analysis/analyze_dynamic_weight.js +7 -17
  31. package/dist/analysis/analyze_kalman.js +7 -17
  32. package/dist/analysis/analyze_regime.js +7 -17
  33. package/dist/analysis/analyze_regime_windows.js +8 -18
  34. package/dist/analysis/analyze_risk_profile.js +8 -18
  35. package/dist/analysis/analyze_trade_heatmap.js +7 -17
  36. package/dist/analysis/analyze_volatility.js +7 -17
  37. package/dist/analysis/bot_fitting/backtest_ama_sweep.d.ts +221 -28
  38. package/dist/analysis/bot_fitting/backtest_ama_sweep.js +23 -103
  39. package/dist/analysis/bot_fitting/backtest_bot_fitting.d.ts +34 -4
  40. package/dist/analysis/bot_fitting/backtest_bot_fitting.js +32 -150
  41. package/dist/analysis/bot_fitting/backtest_lookback_drawdown.js +19 -34
  42. package/dist/analysis/bot_fitting/shared_utils.d.ts +77 -9
  43. package/dist/analysis/bot_fitting/shared_utils.js +125 -9
  44. package/dist/analysis/bot_key_utils.d.ts +18 -10
  45. package/dist/analysis/bot_key_utils.js +7 -4
  46. package/dist/analysis/bot_usage/discover_bot_accounts.js +44 -47
  47. package/dist/analysis/bot_usage/kibana_bot_queries.d.ts +1 -21
  48. package/dist/analysis/chain_pool.d.ts +3 -1
  49. package/dist/analysis/chart_ui.d.ts +35 -3
  50. package/dist/analysis/chart_ui.js +43 -4
  51. package/dist/analysis/chart_utils.d.ts +5 -5
  52. package/dist/analysis/chart_utils.js +9 -0
  53. package/dist/analysis/fills_cache.d.ts +4 -24
  54. package/dist/analysis/fills_cache.js +3 -84
  55. package/dist/analysis/fills_source.d.ts +33 -3
  56. package/dist/analysis/fills_source.js +83 -13
  57. package/dist/analysis/grid_correction_check.d.ts +2 -24
  58. package/dist/analysis/grid_correction_check.js +27 -69
  59. package/dist/analysis/math_utils.d.ts +91 -6
  60. package/dist/analysis/math_utils.js +119 -7
  61. package/dist/analysis/pnl_report.js +29 -29
  62. package/dist/analysis/price_sources.d.ts +30 -9
  63. package/dist/analysis/price_sources.js +28 -4
  64. package/dist/analysis/resolve_bot_accounts.js +2 -2
  65. package/dist/analysis/resolve_source.d.ts +1 -1
  66. package/dist/analysis/resolve_source.js +31 -10
  67. package/dist/analysis/trade_profitability.d.ts +29 -2
  68. package/dist/analysis/trade_profitability.js +73 -147
  69. package/dist/analysis/tradingview/analyze_tradingview.d.ts +3 -8
  70. package/dist/analysis/tradingview/analyze_tradingview.js +7 -6
  71. package/dist/analysis/tradingview/grid_reset_config.d.ts +41 -32
  72. package/dist/analysis/tradingview/grid_reset_config.js +23 -11
  73. package/dist/analysis/tradingview/grid_reset_sim.d.ts +75 -9
  74. package/dist/analysis/tradingview/grid_reset_sim.js +4 -3
  75. package/dist/analysis/tradingview/tradingview_uplot_chart_generator.d.ts +69 -4
  76. package/dist/analysis/tradingview/tradingview_uplot_chart_generator.js +20 -34
  77. package/dist/analysis/trend_detection/backtest_ama_slope_huber.d.ts +1 -101
  78. package/dist/analysis/trend_detection/backtest_ama_slope_huber.js +26 -84
  79. package/dist/analysis/trend_detection/dynamic_weight_chart_generator.d.ts +63 -1
  80. package/dist/analysis/trend_detection/dynamic_weight_chart_generator.js +16 -41
  81. package/dist/analysis/trend_detection/huber_scale_variants.d.ts +9 -3
  82. package/dist/analysis/trend_detection/huber_scale_variants.js +4 -4
  83. package/dist/analysis/trend_detection/kalman_chart_generator.d.ts +30 -1
  84. package/dist/analysis/trend_detection/kalman_chart_generator.js +3 -3
  85. package/dist/analysis/trend_detection/regime_chart_generator.d.ts +31 -1
  86. package/dist/analysis/trend_detection/regime_chart_generator.js +2 -2
  87. package/dist/analysis/trend_detection/volatility_chart_generator.d.ts +33 -1
  88. package/dist/analysis/trend_detection/volatility_chart_generator.js +9 -10
  89. package/dist/analysis/worker_pool.d.ts +38 -0
  90. package/dist/analysis/worker_pool.js +67 -0
  91. package/dist/credential-daemon.js +34 -20
  92. package/dist/dexbot.js +78 -59
  93. package/dist/market_adapter/ama_signal_runner.js +21 -54
  94. package/dist/market_adapter/candle_utils.d.ts +29 -19
  95. package/dist/market_adapter/candle_utils.js +35 -21
  96. package/dist/market_adapter/cli_args.d.ts +22 -0
  97. package/dist/market_adapter/cli_args.js +30 -0
  98. package/dist/market_adapter/core/asymmetric_bounds.d.ts +13 -4
  99. package/dist/market_adapter/core/config_normalizers.d.ts +3 -3
  100. package/dist/market_adapter/core/config_normalizers.js +11 -6
  101. package/dist/market_adapter/core/kibana_candles.d.ts +56 -19
  102. package/dist/market_adapter/core/kibana_candles.js +12 -9
  103. package/dist/market_adapter/core/kibana_client.d.ts +9 -1
  104. package/dist/market_adapter/core/kibana_client.js +8 -7
  105. package/dist/market_adapter/core/kibana_market_candles.d.ts +3 -2
  106. package/dist/market_adapter/core/market_adapter_service.d.ts +320 -153
  107. package/dist/market_adapter/core/market_adapter_service.js +228 -269
  108. package/dist/market_adapter/core/signals/hurst_analyzer.d.ts +1 -6
  109. package/dist/market_adapter/core/signals/hurst_analyzer.js +1 -1
  110. package/dist/market_adapter/core/signals/permutation_entropy_analyzer.d.ts +1 -11
  111. package/dist/market_adapter/core/signals/permutation_entropy_analyzer.js +1 -1
  112. package/dist/market_adapter/core/strategies/ama.d.ts +10 -2
  113. package/dist/market_adapter/core/strategies/ama.js +2 -4
  114. package/dist/market_adapter/core/strategies/ama_slope_model.d.ts +14 -1
  115. package/dist/market_adapter/core/strategies/ama_slope_model.js +12 -34
  116. package/dist/market_adapter/core/strategies/atr/calculator.d.ts +7 -2
  117. package/dist/market_adapter/core/strategies/atr/calculator.js +2 -34
  118. package/dist/market_adapter/core/strategies/collateral_manager.d.ts +7 -1
  119. package/dist/market_adapter/core/strategies/collateral_manager.js +0 -22
  120. package/dist/market_adapter/core/strategies/dynamic_weight_series.d.ts +34 -6
  121. package/dist/market_adapter/core/strategies/dynamic_weight_series.js +7 -7
  122. package/dist/market_adapter/core/strategies/regime_gate.d.ts +24 -15
  123. package/dist/market_adapter/core/strategies/regime_gate.js +4 -31
  124. package/dist/market_adapter/core/strategies/regime_interp.d.ts +7 -1
  125. package/dist/market_adapter/core/strategies/regime_interp.js +14 -22
  126. package/dist/market_adapter/core/strategies/volatility_shift.d.ts +11 -1
  127. package/dist/market_adapter/core/strategies/volatility_shift.js +0 -13
  128. package/dist/market_adapter/inputs/cex_candle_parsing.d.ts +29 -0
  129. package/dist/market_adapter/inputs/cex_candle_parsing.js +52 -0
  130. package/dist/market_adapter/inputs/fetch_book_data.d.ts +20 -4
  131. package/dist/market_adapter/inputs/fetch_book_data.js +3 -2
  132. package/dist/market_adapter/inputs/fetch_cex_synthetic_data.js +160 -332
  133. package/dist/market_adapter/inputs/fetch_lp_data.d.ts +50 -8
  134. package/dist/market_adapter/inputs/fetch_lp_data.js +47 -22
  135. package/dist/market_adapter/inputs/kibana_feed_source.d.ts +74 -15
  136. package/dist/market_adapter/inputs/kibana_feed_source.js +26 -41
  137. package/dist/market_adapter/inputs/kibana_source.d.ts +25 -3
  138. package/dist/market_adapter/inputs/kibana_source.js +2 -2
  139. package/dist/market_adapter/inputs/window_cache.d.ts +93 -156
  140. package/dist/market_adapter/inputs/window_cache.js +59 -184
  141. package/dist/market_adapter/interval_utils.d.ts +15 -5
  142. package/dist/market_adapter/interval_utils.js +16 -1
  143. package/dist/market_adapter/log_format.d.ts +6 -6
  144. package/dist/market_adapter/log_format.js +28 -21
  145. package/dist/market_adapter/lp_chart_core.d.ts +22 -1
  146. package/dist/market_adapter/lp_chart_core.js +26 -192
  147. package/dist/market_adapter/lp_chart_runner.d.ts +10 -7
  148. package/dist/market_adapter/lp_chart_runner.js +37 -19
  149. package/dist/market_adapter/lp_chart_strategy_loader.d.ts +41 -6
  150. package/dist/market_adapter/lp_chart_strategy_loader.js +8 -7
  151. package/dist/market_adapter/market_adapter.d.ts +94 -32
  152. package/dist/market_adapter/market_adapter.js +94 -120
  153. package/dist/market_adapter/utils/adapter_client.d.ts +3 -3
  154. package/dist/market_adapter/utils/adapter_client.js +2 -2
  155. package/dist/market_adapter/utils/atomic_write.d.ts +8 -1
  156. package/dist/market_adapter/utils/chain.d.ts +50 -41
  157. package/dist/market_adapter/utils/chain.js +40 -46
  158. package/dist/market_adapter/utils/data_discovery.d.ts +49 -2
  159. package/dist/market_adapter/utils/data_discovery.js +220 -27
  160. package/dist/market_adapter/utils/dynamic_grid_snapshot.d.ts +12 -3
  161. package/dist/market_adapter/utils/file_json_cache.d.ts +2 -2
  162. package/dist/market_adapter/utils/file_lock.d.ts +28 -14
  163. package/dist/market_adapter/utils/file_lock.js +36 -32
  164. package/dist/market_adapter/utils/month_shards.d.ts +84 -0
  165. package/dist/market_adapter/utils/month_shards.js +237 -0
  166. package/dist/market_adapter/utils/native_history.d.ts +9 -2
  167. package/dist/market_adapter/utils/native_history.js +35 -28
  168. package/dist/modules/account_bots.d.ts +578 -21
  169. package/dist/modules/account_bots.js +272 -267
  170. package/dist/modules/account_orders.d.ts +79 -30
  171. package/dist/modules/account_orders.js +60 -64
  172. package/dist/modules/authority_resolver.d.ts +12 -2
  173. package/dist/modules/authority_resolver.js +15 -8
  174. package/dist/modules/bitshares-native/chain_client.d.ts +39 -4
  175. package/dist/modules/bitshares-native/chain_client.js +59 -59
  176. package/dist/modules/bitshares-native/crypto/ecc.browser.js +11 -171
  177. package/dist/modules/bitshares-native/crypto/ecc.js +13 -176
  178. package/dist/modules/bitshares-native/crypto/ecc_core.d.ts +33 -0
  179. package/dist/modules/bitshares-native/crypto/ecc_core.js +213 -0
  180. package/dist/modules/bitshares-native/crypto/ecc_selector.d.ts +2 -1
  181. package/dist/modules/bitshares-native/crypto/ecc_selector.js +1 -13
  182. package/dist/modules/bitshares-native/index.d.ts +1 -1
  183. package/dist/modules/bitshares-native/lru_cache.d.ts +7 -7
  184. package/dist/modules/bitshares-native/resolvers.d.ts +18 -6
  185. package/dist/modules/bitshares-native/resolvers.js +22 -25
  186. package/dist/modules/bitshares-native/serial/lazy_buffer.d.ts +4 -0
  187. package/dist/modules/bitshares-native/serial/lazy_buffer.js +21 -0
  188. package/dist/modules/bitshares-native/serial/operations.d.ts +1 -1
  189. package/dist/modules/bitshares-native/serial/serializer.d.ts +16 -12
  190. package/dist/modules/bitshares-native/serial/serializer.js +7 -13
  191. package/dist/modules/bitshares-native/serial/types.d.ts +25 -16
  192. package/dist/modules/bitshares-native/serial/types.js +73 -108
  193. package/dist/modules/bitshares-native/signing_client.d.ts +32 -2
  194. package/dist/modules/bitshares-native/signing_client.js +19 -14
  195. package/dist/modules/bitshares-native/subscriptions.d.ts +81 -1
  196. package/dist/modules/bitshares-native/subscriptions.js +12 -12
  197. package/dist/modules/bitshares-native/transport.d.ts +5 -4
  198. package/dist/modules/bitshares-native/transport.js +5 -4
  199. package/dist/modules/bitshares-native/tx/builder.d.ts +40 -5
  200. package/dist/modules/bitshares-native/tx/builder.js +4 -3
  201. package/dist/modules/bitshares-native/tx/tx_cache.d.ts +4 -4
  202. package/dist/modules/bitshares_client.d.ts +45 -13
  203. package/dist/modules/bitshares_client.js +28 -19
  204. package/dist/modules/bot_defaults.d.ts +8 -16
  205. package/dist/modules/bot_defaults.js +1 -5
  206. package/dist/modules/bot_settings.d.ts +44 -10
  207. package/dist/modules/bot_settings.js +11 -8
  208. package/dist/modules/bots_file_lock.d.ts +6 -6
  209. package/dist/modules/bots_file_lock.js +16 -12
  210. package/dist/modules/broadcast_failure.d.ts +4 -3
  211. package/dist/modules/broadcast_failure.js +5 -4
  212. package/dist/modules/chain_keys.d.ts +42 -40
  213. package/dist/modules/chain_keys.js +53 -45
  214. package/dist/modules/chain_orders.d.ts +94 -60
  215. package/dist/modules/chain_orders.js +81 -118
  216. package/dist/modules/cli_start_onboarding.d.ts +2 -1
  217. package/dist/modules/constants.d.ts +534 -32
  218. package/dist/modules/constants.js +35 -48
  219. package/dist/modules/cr_planner.d.ts +41 -3
  220. package/dist/modules/cr_planner.js +1 -5
  221. package/dist/modules/credential_policy.d.ts +68 -8
  222. package/dist/modules/credential_policy.js +37 -31
  223. package/dist/modules/credential_session_cache.d.ts +2 -2
  224. package/dist/modules/credit_pricing.d.ts +43 -6
  225. package/dist/modules/credit_pricing.js +70 -60
  226. package/dist/modules/credit_runtime.d.ts +283 -118
  227. package/dist/modules/credit_runtime.js +500 -231
  228. package/dist/modules/crypto/browser_provider.js +6 -4
  229. package/dist/modules/crypto/node_provider.js +1 -1
  230. package/dist/modules/crypto/pure_scrypt.js +35 -4
  231. package/dist/modules/crypto/pure_secp256k1.js +72 -26
  232. package/dist/modules/crypto/sync.d.ts +9 -9
  233. package/dist/modules/crypto/sync.js +16 -9
  234. package/dist/modules/daemon_node_health.d.ts +4 -3
  235. package/dist/modules/dexbot_class.d.ts +213 -146
  236. package/dist/modules/dexbot_class.js +183 -86
  237. package/dist/modules/dexbot_cow_runtime.d.ts +160 -87
  238. package/dist/modules/dexbot_cow_runtime.js +302 -234
  239. package/dist/modules/dexbot_credential_client.d.ts +19 -18
  240. package/dist/modules/dexbot_credential_client.js +1 -2
  241. package/dist/modules/dexbot_fill_runtime.d.ts +63 -49
  242. package/dist/modules/dexbot_fill_runtime.js +53 -47
  243. package/dist/modules/dexbot_maintenance_runtime.d.ts +127 -71
  244. package/dist/modules/dexbot_maintenance_runtime.js +187 -147
  245. package/dist/modules/dexbot_startup_runtime.d.ts +11 -11
  246. package/dist/modules/dexbot_startup_runtime.js +56 -57
  247. package/dist/modules/dexbot_state_recovery.d.ts +13 -12
  248. package/dist/modules/dexbot_state_recovery.js +18 -13
  249. package/dist/modules/fund_registry.d.ts +4 -2
  250. package/dist/modules/fund_registry.js +10 -10
  251. package/dist/modules/general_settings.d.ts +30 -4
  252. package/dist/modules/graceful_shutdown.d.ts +3 -3
  253. package/dist/modules/graceful_shutdown.js +19 -13
  254. package/dist/modules/grid_price_source.d.ts +1 -1
  255. package/dist/modules/key_store.d.ts +14 -8
  256. package/dist/modules/key_store.js +7 -7
  257. package/dist/modules/launcher/adapter_requirement.d.ts +11 -5
  258. package/dist/modules/launcher/adapter_requirement.js +5 -5
  259. package/dist/modules/launcher/bot_supervisor.d.ts +106 -24
  260. package/dist/modules/launcher/bot_supervisor.js +12 -11
  261. package/dist/modules/launcher/credential_bootstrap.d.ts +1 -1
  262. package/dist/modules/launcher/credential_bootstrap.js +1 -1
  263. package/dist/modules/launcher/credential_daemon.d.ts +4 -4
  264. package/dist/modules/launcher/credential_daemon.js +2 -2
  265. package/dist/modules/launcher/credential_secret.d.ts +1 -1
  266. package/dist/modules/launcher/foreign_cred_daemon.d.ts +2 -2
  267. package/dist/modules/launcher/market_adapter_runtime.d.ts +61 -6
  268. package/dist/modules/launcher/market_adapter_watchdog.d.ts +10 -2
  269. package/dist/modules/launcher/market_adapter_watchdog.js +4 -0
  270. package/dist/modules/launcher/monolithic_runtime.d.ts +18 -16
  271. package/dist/modules/launcher/status_reporting.d.ts +22 -14
  272. package/dist/modules/launcher/supervisor_control.d.ts +8 -1
  273. package/dist/modules/launcher/supervisor_control.js +4 -2
  274. package/dist/modules/lazy_shim.d.ts +11 -0
  275. package/dist/modules/lazy_shim.js +16 -0
  276. package/dist/modules/market_adapter_whitelist.d.ts +9 -3
  277. package/dist/modules/market_adapter_whitelist.js +15 -3
  278. package/dist/modules/node_connect_policy.d.ts +3 -2
  279. package/dist/modules/node_failure_ledger.d.ts +6 -5
  280. package/dist/modules/node_manager.d.ts +41 -11
  281. package/dist/modules/node_manager.js +5 -4
  282. package/dist/modules/order/accounting.d.ts +53 -24
  283. package/dist/modules/order/accounting.js +16 -15
  284. package/dist/modules/order/async_lock.d.ts +5 -2
  285. package/dist/modules/order/async_lock.js +1 -1
  286. package/dist/modules/order/export.d.ts +7 -6
  287. package/dist/modules/order/export.js +1 -7
  288. package/dist/modules/order/format.d.ts +16 -7
  289. package/dist/modules/order/format.js +15 -3
  290. package/dist/modules/order/genesis_policy.d.ts +24 -21
  291. package/dist/modules/order/genesis_policy.js +17 -10
  292. package/dist/modules/order/grid.d.ts +144 -36
  293. package/dist/modules/order/grid.js +226 -145
  294. package/dist/modules/order/grid_reconcile.d.ts +21 -20
  295. package/dist/modules/order/grid_reconcile.js +13 -12
  296. package/dist/modules/order/grid_reconcile_internal.d.ts +85 -72
  297. package/dist/modules/order/grid_reconcile_internal.js +28 -19
  298. package/dist/modules/order/index.d.ts +264 -1
  299. package/dist/modules/order/logger.d.ts +46 -19
  300. package/dist/modules/order/logger.js +38 -49
  301. package/dist/modules/order/logger_state.d.ts +4 -4
  302. package/dist/modules/order/manager.d.ts +232 -191
  303. package/dist/modules/order/manager.js +110 -130
  304. package/dist/modules/order/processed_fill_store.d.ts +18 -3
  305. package/dist/modules/order/processed_fill_store.js +16 -27
  306. package/dist/modules/order/strategy.d.ts +21 -13
  307. package/dist/modules/order/strategy.js +5 -6
  308. package/dist/modules/order/sync_engine.d.ts +91 -33
  309. package/dist/modules/order/sync_engine.js +84 -53
  310. package/dist/modules/order/utils/math.d.ts +157 -102
  311. package/dist/modules/order/utils/math.js +77 -38
  312. package/dist/modules/order/utils/order.d.ts +310 -110
  313. package/dist/modules/order/utils/order.js +153 -126
  314. package/dist/modules/order/utils/slot.d.ts +1 -1
  315. package/dist/modules/order/utils/system.d.ts +156 -26
  316. package/dist/modules/order/utils/system.js +103 -71
  317. package/dist/modules/order/utils/validate.d.ts +89 -41
  318. package/dist/modules/order/utils/validate.js +26 -24
  319. package/dist/modules/order/utils/withPoolRef.d.ts +6 -4
  320. package/dist/modules/order/utils/withPoolRef.js +18 -12
  321. package/dist/modules/order/working_grid.d.ts +14 -13
  322. package/dist/modules/paths.d.ts +1 -4
  323. package/dist/modules/paths.js +33 -61
  324. package/dist/modules/process_discovery.d.ts +1 -1
  325. package/dist/modules/process_discovery.js +2 -1
  326. package/dist/modules/runtime.d.ts +7 -3
  327. package/dist/modules/runtime.js +4 -3
  328. package/dist/modules/runtime_settings.d.ts +14 -11
  329. package/dist/modules/runtime_settings.js +30 -24
  330. package/dist/modules/settings_merge.d.ts +29 -3
  331. package/dist/modules/settings_merge.js +56 -78
  332. package/dist/modules/socket_json_client.d.ts +9 -5
  333. package/dist/modules/storage/browser_adapter.d.ts +38 -53
  334. package/dist/modules/storage/browser_adapter.js +7 -30
  335. package/dist/modules/storage/index.d.ts +1 -1
  336. package/dist/modules/storage/node_adapter.d.ts +45 -27
  337. package/dist/modules/storage/node_adapter.js +9 -9
  338. package/dist/modules/storage/types.d.ts +5 -4
  339. package/dist/modules/types.d.ts +1090 -6
  340. package/dist/modules/types.js +4 -1
  341. package/dist/modules/utils/asset_symbols.d.ts +2 -1
  342. package/dist/modules/utils/asset_symbols.js +2 -1
  343. package/dist/modules/utils/errors.d.ts +9 -0
  344. package/dist/modules/utils/errors.js +24 -4
  345. package/dist/modules/utils/time_range.d.ts +1 -12
  346. package/dist/modules/utils/time_range.js +1 -1
  347. package/dist/modules/validate_profiles.js +53 -43
  348. package/dist/modules/version_notice.d.ts +23 -11
  349. package/dist/modules/version_notice.js +6 -4
  350. package/dist/pm2.d.ts +28 -27
  351. package/dist/pm2.js +61 -40
  352. package/dist/scripts/analyze-credit.d.ts +2 -1
  353. package/dist/scripts/analyze-credit.js +23 -24
  354. package/dist/scripts/analyze-git.js +2 -15
  355. package/dist/scripts/analyze-orders.d.ts +77 -9
  356. package/dist/scripts/analyze-orders.js +65 -40
  357. package/dist/scripts/chart_command.d.ts +27 -18
  358. package/dist/scripts/chart_command.js +15 -13
  359. package/dist/scripts/check_any.d.ts +22 -0
  360. package/dist/scripts/check_any.js +158 -0
  361. package/dist/scripts/diagnose-pool-history.js +13 -13
  362. package/dist/scripts/print_grid.js +0 -1
  363. package/dist/scripts/run-tests.js +39 -8
  364. package/dist/scripts/runner.js +1 -1
  365. package/dist/scripts/sync-version.js +0 -10
  366. package/dist/scripts/test-credit-renewal.js +30 -21
  367. package/dist/scripts/update.d.ts +10 -5
  368. package/dist/scripts/update.js +168 -103
  369. package/dist/scripts/update_dist_freshness.js +1 -0
  370. package/dist/scripts/update_layout.d.ts +61 -0
  371. package/dist/scripts/update_layout.js +180 -0
  372. package/dist/scripts/validate_bots.js +2 -1
  373. package/dist/scripts/verify-browser-bundle.js +8 -0
  374. package/dist/unlock.d.ts +28 -3
  375. package/dist/unlock.js +63 -35
  376. package/docs/BITSHARES_ONBOARDING.md +10 -12
  377. package/docs/COPY_ON_WRITE_MASTER_PLAN.md +2 -2
  378. package/docs/COW_INVARIANTS.md +13 -6
  379. package/docs/DEXBOT_COMPARISON.md +8 -8
  380. package/docs/EVOLUTION.md +10 -8
  381. package/docs/FUND_MOVEMENT_AND_ACCOUNTING.md +5 -5
  382. package/docs/GRID_RECALCULATION.md +4 -2
  383. package/docs/GRID_RECONCILE.md +14 -3
  384. package/docs/LIFECYCLE.md +11 -11
  385. package/docs/MPA_CREDIT_USAGE.md +22 -3
  386. package/docs/README.md +14 -3
  387. package/docs/WORKFLOW.md +1 -0
  388. package/docs/architecture.md +31 -19
  389. package/docs/developer_guide.md +6 -6
  390. package/market_adapter/README.md +12 -5
  391. package/modules/README.md +4 -1
  392. package/package.json +9 -9
  393. package/scripts/README.md +43 -38
  394. package/tests/README.md +25 -10
  395. package/dist/scripts/diagnose-kibana-candles.d.ts +0 -3
  396. package/dist/scripts/diagnose-kibana-candles.js +0 -82
  397. package/scripts/git-viewer.sh +0 -489
  398. package/scripts/postinstall.js +0 -16
@@ -1,5 +1,6 @@
1
1
  'use strict';
2
2
  import fs from 'node:fs';
3
+ import path from 'node:path';
3
4
  import { getStorage } from '../modules/storage/index.js';
4
5
  const { readJSON } = getStorage();
5
6
  import { getCandleClose, getCandleTimestamp, normalizeCandle, } from '../market_adapter/candle_utils.js';
@@ -22,20 +23,131 @@ function calcStdDev(arr) {
22
23
  return Math.sqrt(sqDiffs / arr.length);
23
24
  }
24
25
  /**
25
- * Parse a candle JSON file with format detection:
26
- * flat array → {candles: [...]} → {data: [...]}
26
+ * Median of a numeric array (average of the two middle values for even
27
+ * lengths). Returns `null` for an empty array. Shared by the analysis
28
+ * backtests instead of each keeping a local copy.
27
29
  */
30
+ function median(values) {
31
+ if (values.length === 0)
32
+ return null;
33
+ const s = values.slice().sort((a, b) => a - b);
34
+ const mid = s.length >> 1;
35
+ return s.length % 2 ? s[mid] : (s[mid - 1] + s[mid]) / 2;
36
+ }
37
+ function percentile(values, p, { interpolation = 'linear', rounding = 'round', sorted = false, empty = null } = {}) {
38
+ if (values.length === 0)
39
+ return empty;
40
+ const s = sorted ? values : values.slice().sort((a, b) => a - b);
41
+ const pct = Math.max(0, Math.min(100, p));
42
+ const idx = (pct / 100) * (s.length - 1);
43
+ if (interpolation === 'linear') {
44
+ const lo = Math.floor(idx);
45
+ const hi = Math.ceil(idx);
46
+ if (lo === hi)
47
+ return s[lo];
48
+ const t = idx - lo;
49
+ return s[lo] * (1 - t) + s[hi] * t;
50
+ }
51
+ const i = rounding === 'floor' ? Math.floor(idx) : Math.round(idx);
52
+ return s[Math.min(s.length - 1, Math.max(0, i))];
53
+ }
54
+ /**
55
+ * Fixed-decimal number formatting with a non-finite fallback.
56
+ *
57
+ * Single home for the identical `fmt(x, d)` copies in backtest_ama_slope_huber
58
+ * and backtest_lookback_drawdown, plus the strict/padded variant in
59
+ * bot_fitting/shared_utils (`fmt(x, d, { fallback: ' n/a', strict: true })`).
60
+ */
61
+ function fmtNum(x, d = 2, { fallback = 'n/a', strict = false } = {}) {
62
+ const finite = strict ? Number.isFinite(x) : Number.isFinite(Number(x));
63
+ return finite ? Number(x).toFixed(d) : fallback;
64
+ }
65
+ function quantize(value, quantum) {
66
+ if (quantum == null || !Number.isFinite(quantum) || quantum <= 0)
67
+ return value;
68
+ return Math.round(value / quantum) * quantum;
69
+ }
70
+ /**
71
+ * Evenly spaced geometric progression from `min` to `max` (endpoints forced).
72
+ * Values are optionally snapped to `quantum` and clamped back into the range,
73
+ * rounded to `decimals`, deduped and sorted ascending. Single home for the
74
+ * helper previously copied into analyze_lambda_vs_slow and
75
+ * optimizer_high_resolution (which used different rounding precision).
76
+ */
77
+ function geometricRange(min, max, count, { decimals = 10, quantum = null } = {}) {
78
+ const out = [];
79
+ const ratio = Math.pow(max / min, 1 / (count - 1));
80
+ for (let i = 0; i < count; i++) {
81
+ let v = min * Math.pow(ratio, i);
82
+ if (i === 0)
83
+ v = min;
84
+ if (i === count - 1)
85
+ v = max;
86
+ v = quantize(v, quantum);
87
+ v = Math.max(min, Math.min(max, v));
88
+ out.push(parseFloat(v.toFixed(decimals)));
89
+ }
90
+ return [...new Set(out)].sort((a, b) => a - b);
91
+ }
28
92
  function loadCandleFile(filePath) {
29
93
  if (!filePath || !fs.existsSync(filePath))
30
94
  return { candles: [], meta: null };
31
95
  const raw = readJSON(filePath);
32
96
  if (Array.isArray(raw))
33
97
  return { candles: raw, meta: null };
34
- if (raw && Array.isArray(raw.candles))
35
- return { candles: raw.candles, meta: raw.meta || raw };
36
- if (raw && Array.isArray(raw.data))
37
- return { candles: raw.data, meta: raw };
98
+ const r = raw;
99
+ if (r && Array.isArray(r.candles))
100
+ return { candles: r.candles, meta: r.meta || r };
101
+ if (r && Array.isArray(r.data))
102
+ return { candles: r.data, meta: r };
38
103
  return { candles: [], meta: null };
39
104
  }
40
- export { range, calcStdDev, getCandleClose, getCandleTimestamp, normalizeCandle, loadCandleFile, };
105
+ /**
106
+ * Load candle records from a single JSON file or a directory of monthly JSON
107
+ * shards.
108
+ *
109
+ * Directory entries are filtered to `*.json` (manifests skipped) and sorted;
110
+ * shards are merged and deduped by candle time (a later file overwrites an
111
+ * earlier duplicate). Returns the merged candles, the first non-null `meta` and
112
+ * the file count. Single home for the loader previously copied into
113
+ * backtest_ama_slope_huber.
114
+ */
115
+ function loadCandleSeries(input) {
116
+ const resolved = path.resolve(input);
117
+ if (!fs.existsSync(resolved))
118
+ throw new Error(`Data path not found: ${resolved}`);
119
+ const stat = fs.statSync(resolved);
120
+ const files = stat.isDirectory()
121
+ ? fs.readdirSync(resolved)
122
+ .filter((name) => /\.json$/i.test(name) && !/manifest/i.test(name))
123
+ .map((name) => path.join(resolved, name))
124
+ .sort()
125
+ : [resolved];
126
+ const byTime = new Map();
127
+ let meta = null;
128
+ for (const file of files) {
129
+ let raw = null;
130
+ try {
131
+ raw = readJSON(file);
132
+ }
133
+ catch {
134
+ continue;
135
+ }
136
+ const arr = Array.isArray(raw?.candles) ? raw.candles : (Array.isArray(raw) ? raw : null);
137
+ if (!arr || arr.length === 0)
138
+ continue;
139
+ if (!meta && raw?.meta)
140
+ meta = raw.meta;
141
+ for (const c of arr) {
142
+ const n = normalizeCandle(c);
143
+ if (n)
144
+ byTime.set(n.time, { time: n.time, open: n.open, high: n.high, low: n.low, close: n.close, volume: n.volume });
145
+ }
146
+ }
147
+ const candles = [...byTime.values()].sort((a, b) => a.time - b.time);
148
+ if (candles.length === 0)
149
+ throw new Error(`No candles found under ${resolved}`);
150
+ return { candles, meta, files: files.length };
151
+ }
152
+ export { range, calcStdDev, geometricRange, median, percentile, fmtNum, getCandleClose, getCandleTimestamp, normalizeCandle, loadCandleFile, loadCandleSeries, };
41
153
  //# sourceMappingURL=math_utils.js.map
@@ -6,18 +6,18 @@ const MAX_DETAIL_ROWS = 2000;
6
6
  /**
7
7
  * Numbers go through the shared `formatFundsValue` (4 significant figures,
8
8
  * K/M compaction, significant trailing zeros kept) so the report matches
9
- * `dexbot order` instead of printing 8-decimal tails. The legacy `decimals`
10
- * argument is retained for call-site compatibility but ignored.
9
+ * `dexbot order` instead of printing 8-decimal tails. Per-value precision is
10
+ * fixed by the shared formatter, so callers pass no decimals.
11
11
  */
12
- function num(n, _decimals = 4) {
12
+ function num(n) {
13
13
  return Number.isFinite(n) ? formatFundsValue(n) : 'NaN';
14
14
  }
15
- function signed(n, decimals = 4) {
15
+ function signed(n) {
16
16
  if (!Number.isFinite(n))
17
17
  return 'NaN';
18
18
  if (n === 0)
19
- return num(0, decimals);
20
- return (n >= 0 ? '+' : '') + num(n, decimals);
19
+ return num(0);
20
+ return (n >= 0 ? '+' : '') + num(n);
21
21
  }
22
22
  function pct(n, decimals = 2) {
23
23
  if (!Number.isFinite(n))
@@ -63,17 +63,17 @@ function renderMetrics(metrics, quoteSymbol) {
63
63
  metricRow('Profit factor', ratio(metrics.profitFactor)),
64
64
  metricRow('Avg win / avg loss', ratio(metrics.avgWinLossRatio)),
65
65
  metricRow('Fee drag', metrics.feeDragPct > 0 ? metrics.feeDragPct.toFixed(2) + '% of gross profit' : '—'),
66
- metricRow('Expectancy (net)', `${num(metrics.netExpectancyBts, 4)} ${q} / trade`),
67
- metricRow('Expectancy (gross)', `${num(metrics.expectancyBts, 4)} ${q} (${pct(metrics.expectancyPct)})`),
66
+ metricRow('Expectancy (net)', `${num(metrics.netExpectancyBts)} ${q} / trade`),
67
+ metricRow('Expectancy (gross)', `${num(metrics.expectancyBts)} ${q} (${pct(metrics.expectancyPct)})`),
68
68
  metricRow('Expectancy (R)', metrics.expectancyR === Infinity ? '∞' : metrics.expectancyR.toFixed(3) + 'R'),
69
69
  ].join('');
70
70
  const risk = [
71
71
  metricRow('Sharpe (annualised)', `${ratio(metrics.sharpeAnn)}${Number.isFinite(metrics.sharpeAnnSE) ? ` ± ${metrics.sharpeAnnSE.toFixed(2)}` : ''}`, `${metrics.periodLabel} bins, n=${metrics.periodCount}`),
72
72
  metricRow('Sortino (annualised)', ratio(metrics.sortinoAnn) + (metrics.sortinoAnn === Infinity ? ' (no losing periods)' : '')),
73
- metricRow('Projected net PnL', `${num(metrics.projectedNetPnlAnn, 2)} ${q}/yr`, `${num(metrics.projectedNetPnlPerDay, 2)}/day`),
73
+ metricRow('Projected net PnL', `${num(metrics.projectedNetPnlAnn)} ${q}/yr`, `${num(metrics.projectedNetPnlPerDay)}/day`),
74
74
  metrics.mddHadStablePeak
75
- ? metricRow('Max drawdown', `${num(metrics.mddAbsBts, 4)} ${q} (${pct(metrics.mddPct)})`)
76
- : metricRow('Min equity', `${num(metrics.prePeakMinEquity, 4)} ${q}`),
75
+ ? metricRow('Max drawdown', `${num(metrics.mddAbsBts)} ${q} (${pct(metrics.mddPct)})`)
76
+ : metricRow('Min equity', `${num(metrics.prePeakMinEquity)} ${q}`),
77
77
  metricRow('Max recovery time', metrics.maxRecoveryDays > 0 ? metrics.maxRecoveryDays.toFixed(1) + ' days' + (metrics.isOngoingRecovery ? ' (ongoing)' : '') : '—'),
78
78
  metrics.currentDrawdownDays > 0
79
79
  ? metricRow('Current drawdown', metrics.currentDrawdownDays.toFixed(1) + ' days (active)')
@@ -95,7 +95,7 @@ function renderMetrics(metrics, quoteSymbol) {
95
95
  metricRow('Partial fills / order', `${metrics.fillsPerOrderMean.toFixed(2)} mean, ${metrics.fillsPerOrderMedian.toFixed(1)} med, ${metrics.fillsPerOrderMax} max`),
96
96
  metricRow('One-shot orders', `${(metrics.oneShotOrderRatio * 100).toFixed(0)}%`),
97
97
  metricRow('Fills / day', metrics.fillsPerDay.toFixed(2)),
98
- metricRow('Avg volume / day', `${num(metrics.avgVolumePerDay, 2)} ${q}`),
98
+ metricRow('Avg volume / day', `${num(metrics.avgVolumePerDay)} ${q}`),
99
99
  ].join('');
100
100
  return `
101
101
  <div class="metrics-grid">
@@ -117,14 +117,14 @@ function renderPairsTable(pair, quoteSymbol) {
117
117
  <td class="num">${i + 1}</td>
118
118
  <td>${escapeHtml((r.entryTime || '').slice(0, 19).replace('T', ' '))}</td>
119
119
  <td>${escapeHtml((r.exitTime || '').slice(0, 19).replace('T', ' '))}</td>
120
- <td class="num">${num(r.amount, 4)}</td>
121
- <td class="num">${num(r.buyPrice, 8)}</td>
122
- <td class="num">${num(r.sellPrice, 8)}</td>
123
- <td class="num ${pnlClass(r.pnl)}">${signed(r.pnl, 6)}</td>
120
+ <td class="num">${num(r.amount)}</td>
121
+ <td class="num">${num(r.buyPrice)}</td>
122
+ <td class="num">${num(r.sellPrice)}</td>
123
+ <td class="num ${pnlClass(r.pnl)}">${signed(r.pnl)}</td>
124
124
  <td class="num ${pnlClass(r.pnlPct)}">${pct(r.pnlPct)}</td>
125
- <td class="num">${num(r.marketFeeEntry + r.marketFeeExit, 4)}</td>
126
- <td class="num">${num(r.feeBts, 4)}</td>
127
- <td class="num ${pnlClass(net)}">${signed(net, 6)}</td>
125
+ <td class="num">${num(r.marketFeeEntry + r.marketFeeExit)}</td>
126
+ <td class="num">${num(r.feeBts)}</td>
127
+ <td class="num ${pnlClass(net)}">${signed(net)}</td>
128
128
  <td class="num ${pnlClass(r.pnlNetPct)}">${pct(r.pnlNetPct)}</td>
129
129
  <td class="center">${legs}</td>
130
130
  </tr>`;
@@ -165,25 +165,25 @@ function renderPairSection(entry) {
165
165
  const hasMarketFee = pair.totalMarketFees > 0.0001;
166
166
  const hasChainFee = pair.totalBlockchainFees > 0.0001;
167
167
  const feeCard = hasMarketFee && hasChainFee
168
- ? statCard('Fees', `${num(-pair.totalMarketFees, 4)} ${q}`, `op ${num(-pair.totalBlockchainFees, 4)} BTS`, 'neg')
168
+ ? statCard('Fees', `${num(-pair.totalMarketFees)} ${q}`, `op ${num(-pair.totalBlockchainFees)} BTS`, 'neg')
169
169
  : hasChainFee
170
- ? statCard('Blockchain fees', `${num(-pair.totalBlockchainFees, 4)} BTS`, '', 'neg')
170
+ ? statCard('Blockchain fees', `${num(-pair.totalBlockchainFees)} BTS`, '', 'neg')
171
171
  : hasMarketFee
172
- ? statCard('Market fees', `${num(-pair.totalMarketFees, 4)} ${q}`, '', 'neg')
172
+ ? statCard('Market fees', `${num(-pair.totalMarketFees)} ${q}`, '', 'neg')
173
173
  : '';
174
174
  // Two 2x2 blocks: PnL/volume/fees, then position/activity. A 2-column grid
175
175
  // keeps each card readable instead of squeezing six across one row.
176
176
  const pnlCards = [
177
- statCard('Gross PnL', `${signed(pair.totalRealizedPnl, 4)} ${q}`, '', pnlClass(pair.totalRealizedPnl)),
178
- statCard('Net PnL', `${signed(pair.totalRealizedPnlNet, 4)} ${q}`, 'after market + op fees', pnlClass(pair.totalRealizedPnlNet)),
179
- statCard('Volume', `${num(pair.totalBuyQuote + pair.totalSellQuote, 4)} ${q}`, `${num(pair.totalBuyQuote, 4)} bought · ${num(pair.totalSellQuote, 4)} sold`),
177
+ statCard('Gross PnL', `${signed(pair.totalRealizedPnl)} ${q}`, '', pnlClass(pair.totalRealizedPnl)),
178
+ statCard('Net PnL', `${signed(pair.totalRealizedPnlNet)} ${q}`, 'after market + op fees', pnlClass(pair.totalRealizedPnlNet)),
179
+ statCard('Volume', `${num(pair.totalBuyQuote + pair.totalSellQuote)} ${q}`, `${num(pair.totalBuyQuote)} bought · ${num(pair.totalSellQuote)} sold`),
180
180
  feeCard,
181
181
  ].filter(Boolean).join('');
182
182
  const positionCards = [
183
183
  statCard('Realized lots', String(pair.realizedPnls.length), `from ${pair.buys.length} buys · ${pair.sells.length} sells`),
184
- statCard('Net inventory \u0394', `${num(pair.netPosition, 4)} ${base}`, 'bought \u2212 sold in window'),
185
- statCard('Avg buy / sell', `${num(avgBuy, 8)} / ${num(avgSell, 8)}`, `in ${q} per ${base}`),
186
- pair.unmatchedSellBase > 0.0001 ? statCard('Unmatched sold', `${num(pair.unmatchedSellBase, 4)} ${base}`, 'inventory predates window', 'muted') : '',
184
+ statCard('Net inventory \u0394', `${num(pair.netPosition)} ${base}`, 'bought \u2212 sold in window'),
185
+ statCard('Avg buy / sell', `${num(avgBuy)} / ${num(avgSell)}`, `in ${q} per ${base}`),
186
+ pair.unmatchedSellBase > 0.0001 ? statCard('Unmatched sold', `${num(pair.unmatchedSellBase)} ${base}`, 'inventory predates window', 'muted') : '',
187
187
  ].filter(Boolean).join('');
188
188
  return `
189
189
  <article class="pair">
@@ -214,7 +214,7 @@ function renderTotals(pairs) {
214
214
  const fees = group.reduce((s, e) => s + e.pair.totalMarketFees, 0);
215
215
  const lots = group.reduce((s, e) => s + e.pair.realizedPnls.length, 0);
216
216
  const quote = escapeHtml(assetSymbol(quoteAsset));
217
- return statCard(`Total (${quote}) · ${group.length} pair${group.length === 1 ? '' : 's'}`, `${signed(net, 4)} ${quote}`, `gross ${signed(gross, 4)} · mkt fees ${num(fees, 4)} · ${lots} lots`, pnlClass(net));
217
+ return statCard(`Total (${quote}) · ${group.length} pair${group.length === 1 ? '' : 's'}`, `${signed(net)} ${quote}`, `gross ${signed(gross)} · mkt fees ${num(fees)} · ${lots} lots`, pnlClass(net));
218
218
  }).join('');
219
219
  return `<section class="totals"><div class="cards">${cards}</div></section>`;
220
220
  }
@@ -14,10 +14,31 @@ declare class JsonFileSource {
14
14
  filePath: string;
15
15
  name: string;
16
16
  constructor(config: JsonFileConfig);
17
- fetchCandles(): Promise<any[]>;
18
- extractMarketPrice(candle: any): {
19
- marketPrice: any;
20
- timestamp: any;
17
+ fetchCandles(): Promise<Record<string, unknown>[]>;
18
+ extractMarketPrice(candle: unknown): {
19
+ marketPrice: number;
20
+ timestamp: number;
21
+ };
22
+ }
23
+ interface InlineConfig {
24
+ candles: Record<string, unknown>[];
25
+ meta?: Record<string, unknown> | null;
26
+ name?: string;
27
+ }
28
+ /**
29
+ * In-memory candle series (no backing file). Used when discovery assembles a
30
+ * series across month shards, where there is no single whole-history file to
31
+ * hand JsonFileSource.
32
+ */
33
+ declare class InlineCandleSource {
34
+ candles: Record<string, unknown>[];
35
+ meta: Record<string, unknown> | null;
36
+ name: string;
37
+ constructor(config: InlineConfig);
38
+ fetchCandles(): Promise<Record<string, unknown>[]>;
39
+ extractMarketPrice(candle: unknown): {
40
+ marketPrice: number;
41
+ timestamp: number;
21
42
  };
22
43
  }
23
44
  interface MarketAdapterConfig {
@@ -30,12 +51,12 @@ declare class MarketAdapterSource {
30
51
  botKey: string;
31
52
  name: string;
32
53
  constructor(config: MarketAdapterConfig);
33
- fetchCandles(): Promise<any[]>;
34
- extractMarketPrice(candle: any): {
35
- marketPrice: any;
36
- timestamp: any;
54
+ fetchCandles(): Promise<Record<string, unknown>[]>;
55
+ extractMarketPrice(candle: unknown): {
56
+ marketPrice: number;
57
+ timestamp: number;
37
58
  };
38
59
  }
39
- declare function createSource(type: string, config: JsonFileConfig | MarketAdapterConfig): JsonFileSource | MarketAdapterSource;
60
+ declare function createSource(type: string, config: JsonFileConfig | InlineConfig | MarketAdapterConfig): JsonFileSource | InlineCandleSource | MarketAdapterSource;
40
61
  export { createSource };
41
62
  //# sourceMappingURL=price_sources.d.ts.map
@@ -23,10 +23,10 @@ class JsonFileSource {
23
23
  if (!Array.isArray(candles) || candles.length === 0) {
24
24
  throw new Error('Expected JSON array or object with .candles or .data property');
25
25
  }
26
- const intervalSeconds = meta?.intervalSeconds || 3600;
27
- const lookbackHours = meta?.lookbackHours;
26
+ const intervalSeconds = Number(meta?.intervalSeconds) || 3600;
27
+ const lookbackHours = Number(meta?.lookbackHours) || 0;
28
28
  if (lookbackHours && candles.length > 0) {
29
- const nowMs = new Date(meta.fetchedAt || Date.now()).getTime();
29
+ const nowMs = new Date(Number(meta?.fetchedAt) || Date.now()).getTime();
30
30
  const startTs = nowMs - (lookbackHours * 3600 * 1000);
31
31
  return fillCandleGaps(candles, intervalSeconds, startTs, nowMs);
32
32
  }
@@ -40,6 +40,27 @@ class JsonFileSource {
40
40
  return { marketPrice: getCandleClose(candle), timestamp: getCandleTimestamp(candle) };
41
41
  }
42
42
  }
43
+ /**
44
+ * In-memory candle series (no backing file). Used when discovery assembles a
45
+ * series across month shards, where there is no single whole-history file to
46
+ * hand JsonFileSource.
47
+ */
48
+ class InlineCandleSource {
49
+ candles;
50
+ meta;
51
+ name;
52
+ constructor(config) {
53
+ this.candles = config.candles || [];
54
+ this.meta = config.meta || null;
55
+ this.name = `inline:${config.name || 'lp-series'}`;
56
+ }
57
+ async fetchCandles() {
58
+ return this.candles;
59
+ }
60
+ extractMarketPrice(candle) {
61
+ return { marketPrice: getCandleClose(candle), timestamp: getCandleTimestamp(candle) };
62
+ }
63
+ }
43
64
  class MarketAdapterSource {
44
65
  stateDir;
45
66
  centersFile;
@@ -83,13 +104,16 @@ class MarketAdapterSource {
83
104
  }
84
105
  }
85
106
  extractMarketPrice(candle) {
86
- return { marketPrice: candle.close, timestamp: candle.timestamp };
107
+ const c = candle;
108
+ return { marketPrice: c.close, timestamp: c.timestamp };
87
109
  }
88
110
  }
89
111
  function createSource(type, config) {
90
112
  switch (type.toLowerCase()) {
91
113
  case 'json':
92
114
  return new JsonFileSource(config);
115
+ case 'inline':
116
+ return new InlineCandleSource(config);
93
117
  case 'market_adapter':
94
118
  return new MarketAdapterSource(config);
95
119
  default:
@@ -23,7 +23,7 @@
23
23
  import { loadBotSettings, computeBotKey, persistBotAccountId } from './bot_key_utils.js';
24
24
  import { setGlobalConsoleLevel, getGlobalConsoleLevel } from '../modules/order/logger.js';
25
25
  import { sleep } from '../modules/order/utils/system.js';
26
- import { getErrorMessage } from '../modules/utils/errors.js';
26
+ import { getErrorMessage, getErrorCode } from '../modules/utils/errors.js';
27
27
  const DEFAULT_TIMEOUT_MS = 20000;
28
28
  function printHelp() {
29
29
  console.log(`\
@@ -95,7 +95,7 @@ async function resolveWithTimeout(chainOrders, ref, timeoutMs) {
95
95
  return { id: null, reason: 'not-found' };
96
96
  }
97
97
  catch (err) {
98
- return { id: null, reason: err && err.code === 'ACCOUNT_LOOKUP_TIMEOUT' ? 'timeout' : 'error' };
98
+ return { id: null, reason: err && getErrorCode(err) === 'ACCOUNT_LOOKUP_TIMEOUT' ? 'timeout' : 'error' };
99
99
  }
100
100
  }
101
101
  async function main() {
@@ -14,7 +14,7 @@ interface SourceResolution {
14
14
  slowPeriod: number;
15
15
  };
16
16
  amaKey: string;
17
- meta: any;
17
+ meta: Record<string, unknown> | null;
18
18
  }
19
19
  declare function listAvailableBots(): void;
20
20
  declare function resolveSource(config: SourceConfig, options?: {
@@ -4,7 +4,7 @@ import { PATHS } from '../modules/paths.js';
4
4
  import { MARKET_ADAPTER } from '../modules/constants.js';
5
5
  import { createSource } from './price_sources.js';
6
6
  import { resolveCandleFile, resolveAmaConfig, resolveAmaKey, loadBotSettings, computeBotKey } from './bot_key_utils.js';
7
- import { findLatestLpData } from '../market_adapter/utils/data_discovery.js';
7
+ import { loadLatestLpSeries, loadLpSeriesFromPath } from '../market_adapter/utils/data_discovery.js';
8
8
  import { loadCandleFile } from './math_utils.js';
9
9
  const INTERVAL_LABEL = MARKET_ADAPTER.RUNTIME_DEFAULTS.intervalLabel;
10
10
  function listAvailableBots() {
@@ -51,19 +51,40 @@ function resolveSource(config, options = {}) {
51
51
  };
52
52
  }
53
53
  if (config.type === 'json') {
54
- let filePath = config.filePath;
54
+ const filePath = config.filePath;
55
55
  if (!filePath) {
56
- const autoFile = findLatestLpData();
57
- if (autoFile) {
58
- filePath = autoFile;
59
- if (!quiet)
60
- console.log(`[Source] Auto-discovered LP data: ${autoFile}`);
61
- }
62
- else {
56
+ const series = loadLatestLpSeries();
57
+ if (!series) {
63
58
  throw new Error('No --file provided and no LP data auto-discovered in market_adapter/data/lp');
64
59
  }
60
+ if (!quiet) {
61
+ console.log(`[Source] Auto-discovered LP data: ${series.path}${series.assembled ? ' (assembled from month shards)' : ''}`);
62
+ }
63
+ const source = createSource('inline', {
64
+ candles: series.candles,
65
+ meta: series.meta,
66
+ name: series.path,
67
+ });
68
+ if (config.botKey) {
69
+ return { source, botKey: config.botKey, amaConfig: resolveAmaConfig(config.botKey), amaKey: resolveAmaKey(config.botKey), meta: series.meta };
70
+ }
71
+ return { source, amaConfig: resolveAmaConfig(''), amaKey: 'AMA3', meta: series.meta };
72
+ }
73
+ const series = loadLpSeriesFromPath(path.resolve(filePath));
74
+ if (series && series.assembled) {
75
+ if (!quiet)
76
+ console.log(`[Source] Assembled ${path.basename(filePath)} across month shards`);
77
+ const source = createSource('inline', {
78
+ candles: series.candles,
79
+ meta: series.meta,
80
+ name: series.path,
81
+ });
82
+ if (config.botKey) {
83
+ return { source, botKey: config.botKey, amaConfig: resolveAmaConfig(config.botKey), amaKey: resolveAmaKey(config.botKey), meta: series.meta };
84
+ }
85
+ return { source, amaConfig: resolveAmaConfig(''), amaKey: 'AMA3', meta: series.meta };
65
86
  }
66
- const source = createSource('json', { filePath: filePath });
87
+ const source = createSource('json', { filePath });
67
88
  const meta = loadCandleFile(filePath).meta;
68
89
  if (config.botKey) {
69
90
  return { source, botKey: config.botKey, amaConfig: resolveAmaConfig(config.botKey), amaKey: resolveAmaKey(config.botKey), meta };
@@ -50,7 +50,34 @@ interface PairAnalysis {
50
50
  totalRealizedPnlNet: number;
51
51
  netPosition: number;
52
52
  }
53
- declare function parseArgs(argv?: string[]): any;
53
+ interface TradeProfitabilityOptions {
54
+ accountId: string;
55
+ hours: number | null;
56
+ months: number | null;
57
+ start: string | null;
58
+ end: string | null;
59
+ asset: string | null;
60
+ pair: string | {
61
+ base: string;
62
+ quote: string;
63
+ } | null;
64
+ refreshAccount: boolean;
65
+ csv: string | null;
66
+ json: string | null;
67
+ matchMode: string;
68
+ showPnlDetail: boolean;
69
+ verbose: boolean;
70
+ feePerOrder: number | null;
71
+ html: boolean;
72
+ report: string | null;
73
+ }
74
+ declare function parseArgs(argv?: string[]): TradeProfitabilityOptions;
75
+ /**
76
+ * Classify fills into trade records. Direction/base/quote resolution and the
77
+ * amount sanity check live in fills_source.classifyFill (single home, also used
78
+ * by grid_correction_check); this wrapper owns the PnL-specific market-fee
79
+ * handling, the asset/pair filters and the unknown-precision skip count.
80
+ */
54
81
  declare function classifyFills(fills: FillRecord[], filterAsset: string | null, pairFilter?: {
55
82
  base: string;
56
83
  quote: string;
@@ -117,7 +144,7 @@ interface TradingMetrics {
117
144
  }
118
145
  declare function computeMetrics(pair: PairAnalysis, window?: WindowRange): TradingMetrics;
119
146
  /** Auto-named report file: bot/account + pair filter + requested range. */
120
- declare function reportFileName(opts: any, accountRef: string, botName: string | null): string;
147
+ declare function reportFileName(opts: TradeProfitabilityOptions, accountRef: string, botName: string | null): string;
121
148
  declare function run(argv?: string[]): Promise<void>;
122
149
  export { analyzePair, classifyFills, computeMetrics, parseArgs, run, reportFileName, TradeFill, FillRecord, RealizedPnl, PairAnalysis, TradingMetrics, WindowRange };
123
150
  //# sourceMappingURL=trade_profitability.d.ts.map