dexbot 1.6.10 → 1.6.12

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 (365) hide show
  1. package/CHANGELOG.md +50 -3
  2. package/README.md +3 -1
  3. package/analysis/README.md +51 -11
  4. package/analysis/bot_fitting/README.md +12 -0
  5. package/analysis/tradingview/README.md +3 -3
  6. package/analysis/trend_detection/DYNAMIC_WEIGHT_RESEARCH.md +11 -37
  7. package/analysis/trend_detection/README.md +31 -0
  8. package/claw/docs/DEXBOT2_TUNING_CHEAT_SHEET.md +4 -3
  9. package/claw/modules/chain_broadcast.ts +7 -1
  10. package/claw/modules/claw_launcher.ts +1 -1
  11. package/claw/modules/launcher_mode_detector.ts +9 -2
  12. package/claw/package.json +1 -1
  13. package/claw/runtimes/openclaw-plugin/openclaw.plugin.json +1 -1
  14. package/claw/runtimes/openclaw-plugin/package.json +1 -1
  15. package/dist/analysis/account_resolver.d.ts +1 -1
  16. package/dist/analysis/account_resolver.js +15 -2
  17. package/dist/analysis/ama_fitting/analyze_ama_price_changes.js +3 -4
  18. package/dist/analysis/ama_fitting/analyze_lambda_vs_slow.js +2 -7
  19. package/dist/analysis/ama_fitting/calibrate_convergence_er.js +0 -1
  20. package/dist/analysis/ama_fitting/fetch_lp_candles.js +4 -4
  21. package/dist/analysis/ama_fitting/generate_unified_comparison_chart.d.ts +20 -4
  22. package/dist/analysis/ama_fitting/generate_unified_comparison_chart.js +9 -6
  23. package/dist/analysis/ama_fitting/optimizer_high_resolution.js +16 -12
  24. package/dist/analysis/analyze_args.d.ts +31 -0
  25. package/dist/analysis/analyze_args.js +41 -0
  26. package/dist/analysis/analyze_dynamic_weight.js +7 -20
  27. package/dist/analysis/analyze_kalman.js +7 -17
  28. package/dist/analysis/analyze_regime.js +7 -17
  29. package/dist/analysis/analyze_regime_windows.js +8 -18
  30. package/dist/analysis/analyze_risk_profile.js +8 -18
  31. package/dist/analysis/analyze_trade_heatmap.js +7 -17
  32. package/dist/analysis/analyze_volatility.js +7 -17
  33. package/dist/analysis/bot_fitting/backtest_ama_sweep.d.ts +220 -12
  34. package/dist/analysis/bot_fitting/backtest_ama_sweep.js +55 -10
  35. package/dist/analysis/bot_fitting/backtest_bot_fitting.d.ts +34 -4
  36. package/dist/analysis/bot_fitting/backtest_bot_fitting.js +72 -66
  37. package/dist/analysis/bot_fitting/backtest_lookback_drawdown.d.ts +21 -0
  38. package/dist/analysis/bot_fitting/backtest_lookback_drawdown.js +315 -0
  39. package/dist/analysis/bot_fitting/shared_utils.d.ts +7 -7
  40. package/dist/analysis/bot_fitting/shared_utils.js +2 -2
  41. package/dist/analysis/bot_key_utils.d.ts +18 -10
  42. package/dist/analysis/bot_key_utils.js +10 -17
  43. package/dist/analysis/bot_usage/discover_bot_accounts.js +44 -47
  44. package/dist/analysis/bot_usage/kibana_bot_queries.d.ts +1 -21
  45. package/dist/analysis/chain_pool.d.ts +3 -1
  46. package/dist/analysis/chart_ui.d.ts +5 -2
  47. package/dist/analysis/chart_ui.js +6 -3
  48. package/dist/analysis/chart_utils.d.ts +5 -5
  49. package/dist/analysis/chart_utils.js +9 -0
  50. package/dist/analysis/fills_cache.d.ts +64 -0
  51. package/dist/analysis/fills_cache.js +254 -0
  52. package/dist/analysis/fills_source.d.ts +2 -2
  53. package/dist/analysis/fills_source.js +19 -14
  54. package/dist/analysis/grid_correction_check.d.ts +1 -1
  55. package/dist/analysis/grid_correction_check.js +12 -11
  56. package/dist/analysis/math_utils.d.ts +7 -6
  57. package/dist/analysis/math_utils.js +5 -8
  58. package/dist/analysis/pnl_report.d.ts +39 -0
  59. package/dist/analysis/pnl_report.js +325 -0
  60. package/dist/analysis/price_sources.d.ts +8 -8
  61. package/dist/analysis/price_sources.js +5 -4
  62. package/dist/analysis/resolve_bot_accounts.js +2 -2
  63. package/dist/analysis/resolve_source.d.ts +1 -2
  64. package/dist/analysis/trade_profitability.d.ts +32 -2
  65. package/dist/analysis/trade_profitability.js +232 -106
  66. package/dist/analysis/tradingview/analyze_tradingview.d.ts +17 -6
  67. package/dist/analysis/tradingview/analyze_tradingview.js +9 -10
  68. package/dist/analysis/tradingview/grid_reset_config.d.ts +42 -31
  69. package/dist/analysis/tradingview/grid_reset_config.js +35 -6
  70. package/dist/analysis/tradingview/grid_reset_sim.d.ts +75 -8
  71. package/dist/analysis/tradingview/grid_reset_sim.js +42 -5
  72. package/dist/analysis/tradingview/tradingview_uplot_chart_generator.d.ts +69 -4
  73. package/dist/analysis/tradingview/tradingview_uplot_chart_generator.js +20 -20
  74. package/dist/analysis/trend_detection/backtest_ama_slope_huber.d.ts +102 -0
  75. package/dist/analysis/trend_detection/backtest_ama_slope_huber.js +725 -0
  76. package/dist/analysis/trend_detection/dynamic_weight_chart_generator.d.ts +63 -1
  77. package/dist/analysis/trend_detection/dynamic_weight_chart_generator.js +27 -112
  78. package/dist/analysis/trend_detection/huber_scale_variants.d.ts +40 -0
  79. package/dist/analysis/trend_detection/huber_scale_variants.js +176 -0
  80. package/dist/analysis/trend_detection/kalman_chart_generator.d.ts +30 -1
  81. package/dist/analysis/trend_detection/kalman_chart_generator.js +3 -3
  82. package/dist/analysis/trend_detection/regime_chart_generator.d.ts +31 -1
  83. package/dist/analysis/trend_detection/regime_chart_generator.js +2 -2
  84. package/dist/analysis/trend_detection/volatility_chart_generator.d.ts +33 -1
  85. package/dist/credential-daemon.js +34 -20
  86. package/dist/dexbot.js +17 -14
  87. package/dist/market_adapter/candle_utils.d.ts +22 -18
  88. package/dist/market_adapter/candle_utils.js +24 -20
  89. package/dist/market_adapter/core/asymmetric_bounds.d.ts +13 -4
  90. package/dist/market_adapter/core/config_normalizers.d.ts +3 -3
  91. package/dist/market_adapter/core/kibana_candles.d.ts +53 -18
  92. package/dist/market_adapter/core/kibana_candles.js +9 -7
  93. package/dist/market_adapter/core/kibana_client.d.ts +9 -1
  94. package/dist/market_adapter/core/kibana_client.js +8 -7
  95. package/dist/market_adapter/core/kibana_market_candles.d.ts +3 -2
  96. package/dist/market_adapter/core/market_adapter_service.d.ts +297 -115
  97. package/dist/market_adapter/core/market_adapter_service.js +184 -101
  98. package/dist/market_adapter/core/strategies/ama.d.ts +10 -2
  99. package/dist/market_adapter/core/strategies/ama.js +7 -32
  100. package/dist/market_adapter/core/strategies/ama_slope_model.d.ts +14 -1
  101. package/dist/market_adapter/core/strategies/ama_slope_model.js +12 -34
  102. package/dist/market_adapter/core/strategies/atr/calculator.d.ts +7 -2
  103. package/dist/market_adapter/core/strategies/atr/calculator.js +2 -34
  104. package/dist/market_adapter/core/strategies/collateral_manager.d.ts +7 -1
  105. package/dist/market_adapter/core/strategies/collateral_manager.js +0 -22
  106. package/dist/market_adapter/core/strategies/dynamic_weight_series.d.ts +36 -8
  107. package/dist/market_adapter/core/strategies/dynamic_weight_series.js +9 -9
  108. package/dist/market_adapter/core/strategies/regime_gate.d.ts +24 -15
  109. package/dist/market_adapter/core/strategies/regime_gate.js +4 -31
  110. package/dist/market_adapter/core/strategies/regime_interp.d.ts +7 -1
  111. package/dist/market_adapter/core/strategies/regime_interp.js +14 -22
  112. package/dist/market_adapter/core/strategies/volatility_shift.d.ts +11 -1
  113. package/dist/market_adapter/core/strategies/volatility_shift.js +0 -13
  114. package/dist/market_adapter/inputs/cex_candle_parsing.d.ts +29 -0
  115. package/dist/market_adapter/inputs/cex_candle_parsing.js +52 -0
  116. package/dist/market_adapter/inputs/fetch_book_data.d.ts +20 -4
  117. package/dist/market_adapter/inputs/fetch_book_data.js +3 -1
  118. package/dist/market_adapter/inputs/fetch_cex_synthetic_data.js +97 -226
  119. package/dist/market_adapter/inputs/fetch_lp_data.d.ts +42 -7
  120. package/dist/market_adapter/inputs/fetch_lp_data.js +22 -15
  121. package/dist/market_adapter/inputs/kibana_feed_source.d.ts +74 -15
  122. package/dist/market_adapter/inputs/kibana_feed_source.js +29 -22
  123. package/dist/market_adapter/inputs/kibana_source.d.ts +25 -3
  124. package/dist/market_adapter/inputs/kibana_source.js +2 -2
  125. package/dist/market_adapter/inputs/window_cache.d.ts +99 -94
  126. package/dist/market_adapter/inputs/window_cache.js +8 -8
  127. package/dist/market_adapter/interval_utils.d.ts +4 -4
  128. package/dist/market_adapter/log_format.d.ts +6 -6
  129. package/dist/market_adapter/log_format.js +28 -22
  130. package/dist/market_adapter/lp_chart_core.d.ts +22 -1
  131. package/dist/market_adapter/lp_chart_core.js +26 -192
  132. package/dist/market_adapter/lp_chart_runner.d.ts +7 -7
  133. package/dist/market_adapter/lp_chart_strategy_loader.d.ts +41 -6
  134. package/dist/market_adapter/lp_chart_strategy_loader.js +8 -7
  135. package/dist/market_adapter/market_adapter.d.ts +94 -33
  136. package/dist/market_adapter/market_adapter.js +69 -75
  137. package/dist/market_adapter/utils/adapter_client.d.ts +3 -3
  138. package/dist/market_adapter/utils/adapter_client.js +2 -2
  139. package/dist/market_adapter/utils/atomic_write.d.ts +8 -1
  140. package/dist/market_adapter/utils/chain.d.ts +50 -41
  141. package/dist/market_adapter/utils/chain.js +40 -46
  142. package/dist/market_adapter/utils/data_discovery.d.ts +4 -1
  143. package/dist/market_adapter/utils/dynamic_grid_snapshot.d.ts +12 -3
  144. package/dist/market_adapter/utils/file_json_cache.d.ts +2 -2
  145. package/dist/market_adapter/utils/file_lock.d.ts +28 -14
  146. package/dist/market_adapter/utils/file_lock.js +36 -32
  147. package/dist/market_adapter/utils/native_history.d.ts +9 -2
  148. package/dist/market_adapter/utils/native_history.js +35 -28
  149. package/dist/modules/account_bots.d.ts +577 -21
  150. package/dist/modules/account_bots.js +182 -158
  151. package/dist/modules/account_orders.d.ts +66 -30
  152. package/dist/modules/account_orders.js +22 -20
  153. package/dist/modules/authority_resolver.d.ts +12 -2
  154. package/dist/modules/authority_resolver.js +15 -8
  155. package/dist/modules/bitshares-native/chain_client.d.ts +38 -3
  156. package/dist/modules/bitshares-native/chain_client.js +45 -46
  157. package/dist/modules/bitshares-native/crypto/ecc.browser.js +11 -171
  158. package/dist/modules/bitshares-native/crypto/ecc.js +13 -176
  159. package/dist/modules/bitshares-native/crypto/ecc_core.d.ts +33 -0
  160. package/dist/modules/bitshares-native/crypto/ecc_core.js +213 -0
  161. package/dist/modules/bitshares-native/crypto/ecc_selector.d.ts +2 -1
  162. package/dist/modules/bitshares-native/crypto/ecc_selector.js +1 -13
  163. package/dist/modules/bitshares-native/index.d.ts +1 -1
  164. package/dist/modules/bitshares-native/lru_cache.d.ts +7 -7
  165. package/dist/modules/bitshares-native/resolvers.d.ts +18 -6
  166. package/dist/modules/bitshares-native/serial/lazy_buffer.d.ts +4 -0
  167. package/dist/modules/bitshares-native/serial/lazy_buffer.js +21 -0
  168. package/dist/modules/bitshares-native/serial/operations.d.ts +1 -1
  169. package/dist/modules/bitshares-native/serial/serializer.d.ts +16 -12
  170. package/dist/modules/bitshares-native/serial/serializer.js +7 -13
  171. package/dist/modules/bitshares-native/serial/types.d.ts +25 -16
  172. package/dist/modules/bitshares-native/serial/types.js +55 -62
  173. package/dist/modules/bitshares-native/signing_client.d.ts +32 -2
  174. package/dist/modules/bitshares-native/signing_client.js +19 -14
  175. package/dist/modules/bitshares-native/subscriptions.d.ts +81 -1
  176. package/dist/modules/bitshares-native/subscriptions.js +12 -12
  177. package/dist/modules/bitshares-native/transport.d.ts +5 -4
  178. package/dist/modules/bitshares-native/transport.js +5 -4
  179. package/dist/modules/bitshares-native/tx/builder.d.ts +40 -5
  180. package/dist/modules/bitshares-native/tx/builder.js +4 -3
  181. package/dist/modules/bitshares-native/tx/tx_cache.d.ts +4 -4
  182. package/dist/modules/bitshares_client.d.ts +45 -13
  183. package/dist/modules/bitshares_client.js +28 -19
  184. package/dist/modules/bot_defaults.d.ts +6 -15
  185. package/dist/modules/bot_defaults.js +1 -5
  186. package/dist/modules/bot_settings.d.ts +44 -10
  187. package/dist/modules/bot_settings.js +11 -8
  188. package/dist/modules/bots_file_lock.d.ts +6 -6
  189. package/dist/modules/bots_file_lock.js +16 -12
  190. package/dist/modules/broadcast_failure.d.ts +2 -2
  191. package/dist/modules/broadcast_failure.js +5 -4
  192. package/dist/modules/chain_keys.d.ts +42 -40
  193. package/dist/modules/chain_keys.js +53 -45
  194. package/dist/modules/chain_orders.d.ts +93 -59
  195. package/dist/modules/chain_orders.js +31 -23
  196. package/dist/modules/constants.d.ts +530 -32
  197. package/dist/modules/constants.js +52 -60
  198. package/dist/modules/cr_planner.d.ts +40 -2
  199. package/dist/modules/credential_policy.d.ts +68 -8
  200. package/dist/modules/credential_policy.js +37 -31
  201. package/dist/modules/credential_session_cache.d.ts +2 -2
  202. package/dist/modules/credit_pricing.d.ts +42 -6
  203. package/dist/modules/credit_pricing.js +44 -30
  204. package/dist/modules/credit_runtime.d.ts +276 -118
  205. package/dist/modules/credit_runtime.js +462 -165
  206. package/dist/modules/crypto/browser_provider.js +6 -4
  207. package/dist/modules/crypto/node_provider.js +1 -1
  208. package/dist/modules/crypto/pure_scrypt.js +35 -4
  209. package/dist/modules/crypto/pure_secp256k1.js +72 -26
  210. package/dist/modules/crypto/sync.d.ts +9 -9
  211. package/dist/modules/crypto/sync.js +16 -9
  212. package/dist/modules/dexbot_class.d.ts +195 -139
  213. package/dist/modules/dexbot_class.js +78 -28
  214. package/dist/modules/dexbot_cow_runtime.d.ts +167 -87
  215. package/dist/modules/dexbot_cow_runtime.js +248 -206
  216. package/dist/modules/dexbot_credential_client.d.ts +19 -11
  217. package/dist/modules/dexbot_fill_runtime.d.ts +63 -48
  218. package/dist/modules/dexbot_fill_runtime.js +48 -41
  219. package/dist/modules/dexbot_maintenance_runtime.d.ts +109 -70
  220. package/dist/modules/dexbot_maintenance_runtime.js +117 -80
  221. package/dist/modules/dexbot_startup_runtime.d.ts +11 -10
  222. package/dist/modules/dexbot_startup_runtime.js +43 -43
  223. package/dist/modules/dexbot_state_recovery.d.ts +13 -12
  224. package/dist/modules/dexbot_state_recovery.js +18 -13
  225. package/dist/modules/fund_registry.d.ts +4 -2
  226. package/dist/modules/fund_registry.js +10 -10
  227. package/dist/modules/general_settings.d.ts +30 -4
  228. package/dist/modules/graceful_shutdown.d.ts +3 -3
  229. package/dist/modules/graceful_shutdown.js +2 -2
  230. package/dist/modules/grid_price_source.d.ts +1 -1
  231. package/dist/modules/key_store.d.ts +14 -8
  232. package/dist/modules/key_store.js +7 -6
  233. package/dist/modules/launcher/adapter_requirement.d.ts +11 -5
  234. package/dist/modules/launcher/adapter_requirement.js +5 -5
  235. package/dist/modules/launcher/bot_supervisor.d.ts +106 -24
  236. package/dist/modules/launcher/bot_supervisor.js +12 -11
  237. package/dist/modules/launcher/credential_bootstrap.d.ts +1 -1
  238. package/dist/modules/launcher/credential_bootstrap.js +1 -1
  239. package/dist/modules/launcher/credential_daemon.d.ts +4 -4
  240. package/dist/modules/launcher/credential_daemon.js +2 -2
  241. package/dist/modules/launcher/credential_secret.d.ts +1 -1
  242. package/dist/modules/launcher/foreign_cred_daemon.d.ts +2 -2
  243. package/dist/modules/launcher/market_adapter_runtime.d.ts +61 -6
  244. package/dist/modules/launcher/market_adapter_watchdog.d.ts +10 -2
  245. package/dist/modules/launcher/market_adapter_watchdog.js +4 -0
  246. package/dist/modules/launcher/monolithic_runtime.d.ts +18 -16
  247. package/dist/modules/launcher/status_reporting.d.ts +22 -14
  248. package/dist/modules/launcher/supervisor_control.d.ts +8 -1
  249. package/dist/modules/launcher/supervisor_control.js +4 -2
  250. package/dist/modules/market_adapter_whitelist.d.ts +9 -3
  251. package/dist/modules/market_adapter_whitelist.js +15 -3
  252. package/dist/modules/node_manager.d.ts +41 -11
  253. package/dist/modules/node_manager.js +5 -4
  254. package/dist/modules/order/accounting.d.ts +53 -24
  255. package/dist/modules/order/accounting.js +40 -14
  256. package/dist/modules/order/async_lock.d.ts +5 -2
  257. package/dist/modules/order/async_lock.js +1 -1
  258. package/dist/modules/order/export.d.ts +7 -6
  259. package/dist/modules/order/export.js +1 -7
  260. package/dist/modules/order/format.d.ts +39 -19
  261. package/dist/modules/order/format.js +62 -16
  262. package/dist/modules/order/genesis_policy.d.ts +21 -18
  263. package/dist/modules/order/genesis_policy.js +12 -8
  264. package/dist/modules/order/grid.d.ts +142 -36
  265. package/dist/modules/order/grid.js +148 -123
  266. package/dist/modules/order/grid_reconcile.d.ts +21 -20
  267. package/dist/modules/order/grid_reconcile.js +13 -12
  268. package/dist/modules/order/grid_reconcile_internal.d.ts +85 -72
  269. package/dist/modules/order/grid_reconcile_internal.js +28 -19
  270. package/dist/modules/order/index.d.ts +263 -1
  271. package/dist/modules/order/logger.d.ts +45 -11
  272. package/dist/modules/order/logger.js +38 -40
  273. package/dist/modules/order/logger_state.d.ts +4 -4
  274. package/dist/modules/order/manager.d.ts +226 -180
  275. package/dist/modules/order/manager.js +101 -83
  276. package/dist/modules/order/processed_fill_store.d.ts +18 -3
  277. package/dist/modules/order/processed_fill_store.js +16 -27
  278. package/dist/modules/order/strategy.d.ts +21 -13
  279. package/dist/modules/order/strategy.js +5 -6
  280. package/dist/modules/order/sync_engine.d.ts +91 -33
  281. package/dist/modules/order/sync_engine.js +99 -54
  282. package/dist/modules/order/utils/math.d.ts +157 -102
  283. package/dist/modules/order/utils/math.js +77 -38
  284. package/dist/modules/order/utils/order.d.ts +326 -106
  285. package/dist/modules/order/utils/order.js +200 -99
  286. package/dist/modules/order/utils/slot.d.ts +1 -1
  287. package/dist/modules/order/utils/system.d.ts +176 -26
  288. package/dist/modules/order/utils/system.js +86 -69
  289. package/dist/modules/order/utils/validate.d.ts +89 -41
  290. package/dist/modules/order/utils/validate.js +24 -22
  291. package/dist/modules/order/utils/withPoolRef.d.ts +4 -3
  292. package/dist/modules/order/utils/withPoolRef.js +18 -12
  293. package/dist/modules/order/working_grid.d.ts +14 -13
  294. package/dist/modules/paths.d.ts +3 -4
  295. package/dist/modules/paths.js +3 -27
  296. package/dist/modules/process_discovery.d.ts +1 -1
  297. package/dist/modules/process_discovery.js +2 -1
  298. package/dist/modules/runtime.d.ts +7 -3
  299. package/dist/modules/runtime.js +4 -3
  300. package/dist/modules/runtime_settings.d.ts +15 -10
  301. package/dist/modules/runtime_settings.js +30 -24
  302. package/dist/modules/settings_merge.d.ts +29 -3
  303. package/dist/modules/settings_merge.js +56 -78
  304. package/dist/modules/socket_json_client.d.ts +7 -4
  305. package/dist/modules/storage/browser_adapter.d.ts +38 -53
  306. package/dist/modules/storage/browser_adapter.js +7 -30
  307. package/dist/modules/storage/index.d.ts +1 -1
  308. package/dist/modules/storage/node_adapter.d.ts +45 -27
  309. package/dist/modules/storage/node_adapter.js +9 -9
  310. package/dist/modules/storage/types.d.ts +5 -4
  311. package/dist/modules/types.d.ts +1071 -2
  312. package/dist/modules/types.js +4 -1
  313. package/dist/modules/utils/asset_symbols.d.ts +2 -1
  314. package/dist/modules/utils/asset_symbols.js +2 -1
  315. package/dist/modules/utils/errors.d.ts +9 -0
  316. package/dist/modules/utils/errors.js +23 -1
  317. package/dist/modules/utils/time_range.d.ts +4 -0
  318. package/dist/modules/utils/time_range.js +18 -0
  319. package/dist/modules/validate_profiles.js +53 -43
  320. package/dist/modules/version_notice.d.ts +14 -3
  321. package/dist/modules/version_notice.js +6 -4
  322. package/dist/pm2.d.ts +29 -27
  323. package/dist/pm2.js +5 -5
  324. package/dist/scripts/analyze-credit.d.ts +2 -1
  325. package/dist/scripts/analyze-credit.js +23 -24
  326. package/dist/scripts/analyze-orders.d.ts +77 -9
  327. package/dist/scripts/analyze-orders.js +66 -84
  328. package/dist/scripts/chart_command.d.ts +27 -18
  329. package/dist/scripts/chart_command.js +16 -15
  330. package/dist/scripts/check_any.d.ts +18 -0
  331. package/dist/scripts/check_any.js +126 -0
  332. package/dist/scripts/diagnose-pool-history.js +12 -7
  333. package/dist/scripts/pnl.d.ts +3 -0
  334. package/dist/scripts/pnl.js +40 -0
  335. package/dist/scripts/print_grid.js +0 -1
  336. package/dist/scripts/run-tests.js +39 -7
  337. package/dist/scripts/runner.js +1 -1
  338. package/dist/scripts/test-credit-renewal.js +30 -21
  339. package/dist/scripts/update.d.ts +10 -5
  340. package/dist/scripts/update.js +168 -103
  341. package/dist/scripts/update_dist_freshness.js +1 -0
  342. package/dist/scripts/update_layout.d.ts +61 -0
  343. package/dist/scripts/update_layout.js +180 -0
  344. package/dist/scripts/validate_bots.js +2 -1
  345. package/dist/scripts/verify-browser-bundle.js +8 -0
  346. package/dist/unlock.d.ts +28 -3
  347. package/dist/unlock.js +72 -10
  348. package/docs/BITSHARES_ONBOARDING.md +2 -0
  349. package/docs/COPY_ON_WRITE_MASTER_PLAN.md +1 -1
  350. package/docs/COW_INVARIANTS.md +13 -6
  351. package/docs/DEXBOT_COMPARISON.md +8 -8
  352. package/docs/EVOLUTION.md +12 -10
  353. package/docs/FUND_MOVEMENT_AND_ACCOUNTING.md +5 -5
  354. package/docs/GRID_RECALCULATION.md +15 -16
  355. package/docs/GRID_RECONCILE.md +14 -3
  356. package/docs/LIFECYCLE.md +11 -11
  357. package/docs/MPA_CREDIT_USAGE.md +22 -3
  358. package/docs/README.md +15 -4
  359. package/docs/WORKFLOW.md +1 -0
  360. package/docs/architecture.md +12 -9
  361. package/docs/developer_guide.md +6 -6
  362. package/market_adapter/README.md +9 -26
  363. package/modules/README.md +4 -1
  364. package/package.json +4 -1
  365. package/scripts/README.md +14 -0
@@ -0,0 +1,254 @@
1
+ 'use strict';
2
+ /**
3
+ * FILLS CACHE — persistent calendar-month shard cache for per-account
4
+ * `fill_order` fetches (`analysis/fills_source.ts`).
5
+ *
6
+ * `dexbot pnl` re-queries Kibana on every run; this layer lets a settled month
7
+ * be answered from disk. It mirrors the design principles of the candle cache
8
+ * (`market_adapter/inputs/window_cache.ts`) but is intentionally fills-specific:
9
+ * fills are sparse point events, so reuse is driven purely by recorded query
10
+ * COVERAGE (a month queried and found empty is still covered), not by a
11
+ * bucket-by-bucket presence grid.
12
+ *
13
+ * Storage: `<cacheDir>/fills/<accountId>.shard_YYYY-MM.json`, one file per UTC
14
+ * calendar month, holding `{ meta: { accountId, fetchedAt, queriedRanges },
15
+ * fills }`. `queriedRanges` records the spans actually queried together with
16
+ * `at` (when the query ran).
17
+ *
18
+ * Reuse rule: a recorded span is trusted only up to `at - TAIL_SETTLE_LAG_MS`,
19
+ * because Kibana indexes fills with a lag — a query cannot certify the last
20
+ * few hours before it ran. The unsettled tail is therefore re-queried on the
21
+ * next run (incremental refresh), while older settled spans are reused with
22
+ * zero queries and zero writes. `refresh` (from `--refresh-account`) ignores
23
+ * coverage and re-queries the whole requested range, but still merges what it
24
+ * gets back so a fresh query can never drop fills outside the requested span.
25
+ */
26
+ import path from 'node:path';
27
+ import { getStorage } from '../modules/storage/index.js';
28
+ import { PATHS } from '../modules/paths.js';
29
+ import { writeJsonAtomic } from '../market_adapter/utils/atomic_write.js';
30
+ import { fetchAllFills } from './fills_source.js';
31
+ const storage = getStorage();
32
+ const { readJSON } = storage;
33
+ /** How long after a query its trailing fills may still be late-indexed. */
34
+ const TAIL_SETTLE_LAG_MS = 6 * 3600 * 1000;
35
+ /** Upper bound on spans persisted per shard (keeps coverage bookkeeping small). */
36
+ const MAX_COVERAGE_SPANS = 64;
37
+ const SHARD_EXT = '.json';
38
+ const SHARD_MARKER = '.shard_';
39
+ function shardKeyForTimestamp(tsMs) {
40
+ const d = new Date(Number(tsMs));
41
+ return `${d.getUTCFullYear()}-${String(d.getUTCMonth() + 1).padStart(2, '0')}`;
42
+ }
43
+ function shardBoundsForKey(key) {
44
+ const parts = String(key).split('-').map(Number);
45
+ const start = Date.UTC(parts[0], parts[1] - 1, 1);
46
+ const end = parts[1] === 12 ? Date.UTC(parts[0] + 1, 0, 1) : Date.UTC(parts[0], parts[1], 1);
47
+ return { start, end };
48
+ }
49
+ function shardKeysForRange(gteMs, lteMs) {
50
+ const keys = [];
51
+ const cursor = new Date(Date.UTC(new Date(gteMs).getUTCFullYear(), new Date(gteMs).getUTCMonth(), 1));
52
+ const last = new Date(lteMs);
53
+ while (cursor <= last) {
54
+ keys.push(shardKeyForTimestamp(cursor.getTime()));
55
+ cursor.setUTCMonth(cursor.getUTCMonth() + 1);
56
+ }
57
+ return keys;
58
+ }
59
+ function accountFileBase(accountId) {
60
+ const s = String(accountId ?? '').trim();
61
+ if (/^1\.2\.\d+$/.test(s))
62
+ return s;
63
+ return s.replace(/[^a-zA-Z0-9._-]+/g, '-').replace(/^-+|-+$/g, '') || 'account';
64
+ }
65
+ function basePathFor(cacheDir, accountId) {
66
+ return path.join(cacheDir, 'fills', `${accountFileBase(accountId)}${SHARD_EXT}`);
67
+ }
68
+ function shardPathFor(basePath, shardKey) {
69
+ const parsed = path.parse(basePath);
70
+ return path.join(parsed.dir, `${parsed.name}${SHARD_MARKER}${shardKey}${parsed.ext}`);
71
+ }
72
+ function readShard(shardFile, accountId) {
73
+ try {
74
+ const parsed = readJSON(shardFile);
75
+ if (!parsed || parsed.meta?.accountId !== accountId)
76
+ return null;
77
+ if (!Array.isArray(parsed.fills))
78
+ return null;
79
+ return {
80
+ meta: {
81
+ accountId,
82
+ fetchedAt: String(parsed.meta?.fetchedAt || ''),
83
+ queriedRanges: Array.isArray(parsed.meta?.queriedRanges) ? parsed.meta.queriedRanges : [],
84
+ },
85
+ fills: parsed.fills,
86
+ };
87
+ }
88
+ catch (_) {
89
+ return null;
90
+ }
91
+ }
92
+ /** Sort, merge overlapping/adjacent same-`at` spans, cap the list length. */
93
+ function normalizeQueried(ranges) {
94
+ const clean = (ranges || [])
95
+ .filter((q) => q && Number.isFinite(Number(q.gte)) && Number.isFinite(Number(q.lte)) && Number(q.lte) >= Number(q.gte))
96
+ .map((q) => ({
97
+ gte: Number(q.gte),
98
+ lte: Number(q.lte),
99
+ at: Number.isFinite(Number(q.at)) ? Number(q.at) : null,
100
+ }))
101
+ .sort((a, b) => a.gte - b.gte || a.lte - b.lte);
102
+ const merged = [];
103
+ for (const q of clean) {
104
+ const top = merged[merged.length - 1];
105
+ if (top && q.gte <= top.lte + 1 && top.at === q.at) {
106
+ if (q.lte > top.lte)
107
+ top.lte = q.lte;
108
+ }
109
+ else {
110
+ merged.push({ ...q });
111
+ }
112
+ }
113
+ if (merged.length > MAX_COVERAGE_SPANS)
114
+ merged.splice(0, merged.length - MAX_COVERAGE_SPANS);
115
+ return merged;
116
+ }
117
+ /** Record a freshly queried span, dropping older spans it fully supersedes. */
118
+ function addCoverage(queried, span, atMs) {
119
+ const kept = queried.filter((q) => !(q.gte >= span.gte && q.lte <= span.lte));
120
+ return normalizeQueried([...kept, { gte: span.gte, lte: span.lte, at: atMs }]);
121
+ }
122
+ function mergeSpans(spans) {
123
+ const sorted = [...spans].sort((a, b) => a.gte - b.gte || a.lte - b.lte);
124
+ const merged = [];
125
+ for (const s of sorted) {
126
+ const top = merged[merged.length - 1];
127
+ if (top && s.gte <= top.lte + 1) {
128
+ if (s.lte > top.lte)
129
+ top.lte = s.lte;
130
+ }
131
+ else {
132
+ merged.push({ ...s });
133
+ }
134
+ }
135
+ return merged;
136
+ }
137
+ /**
138
+ * Portions of queried spans that are safe to reuse: the part up to
139
+ * `at - TAIL_SETTLE_LAG_MS`. A span with an unknown `at` certifies nothing.
140
+ */
141
+ function trustedSegments(queried, nowMs) {
142
+ const segs = [];
143
+ for (const q of queried) {
144
+ if (q.at == null)
145
+ continue;
146
+ const end = Math.min(q.lte, q.at - TAIL_SETTLE_LAG_MS, nowMs - TAIL_SETTLE_LAG_MS);
147
+ if (end >= q.gte)
148
+ segs.push({ gte: q.gte, lte: end });
149
+ }
150
+ return mergeSpans(segs);
151
+ }
152
+ /** `span` minus the union of `covered` (both as inclusive ms ranges). */
153
+ function subtractRanges(span, covered) {
154
+ let parts = [{ ...span }];
155
+ for (const c of mergeSpans(covered)) {
156
+ const next = [];
157
+ for (const p of parts) {
158
+ if (c.lte < p.gte || c.gte > p.lte) {
159
+ next.push(p);
160
+ continue;
161
+ }
162
+ if (c.gte > p.gte)
163
+ next.push({ gte: p.gte, lte: Math.min(p.lte, c.gte - 1) });
164
+ if (c.lte < p.lte)
165
+ next.push({ gte: Math.max(p.gte, c.lte + 1), lte: p.lte });
166
+ }
167
+ parts = next.filter(p => p.lte >= p.gte);
168
+ if (parts.length === 0)
169
+ break;
170
+ }
171
+ return parts;
172
+ }
173
+ function fillKey(f) {
174
+ return `${f.blockNum}:${f.opNum}`;
175
+ }
176
+ function compareFills(a, b) {
177
+ if (a.time !== b.time)
178
+ return a.time < b.time ? -1 : 1;
179
+ if (a.blockNum !== b.blockNum)
180
+ return a.blockNum - b.blockNum;
181
+ return a.opNum - b.opNum;
182
+ }
183
+ /** Union two fill lists, deduped by the unique operation identity. */
184
+ function mergeFills(existing, incoming) {
185
+ const byKey = new Map();
186
+ for (const f of existing)
187
+ byKey.set(fillKey(f), f);
188
+ for (const f of incoming)
189
+ byKey.set(fillKey(f), f);
190
+ return [...byKey.values()].sort(compareFills);
191
+ }
192
+ /**
193
+ * Fetch every fill_order for an account over [gteIso, lteIso], reusing cached
194
+ * month shards and querying only their missing spans. Falls back to a direct
195
+ * fetch when the range is malformed.
196
+ */
197
+ async function fetchFillsCached(config, accountId, gteIso, lteIso, options = {}) {
198
+ const gteMs = Date.parse(gteIso);
199
+ const lteMs = Date.parse(lteIso);
200
+ const doFetch = options.fetchRange ?? ((gte, lte) => fetchAllFills(config, accountId, gte, lte));
201
+ if (!Number.isFinite(gteMs) || !Number.isFinite(lteMs) || lteMs < gteMs) {
202
+ return doFetch(gteIso, lteIso);
203
+ }
204
+ const nowMs = options.nowMs ?? Date.now();
205
+ const cacheDir = options.cacheDir ?? PATHS.ANALYSIS.CACHE_DIR;
206
+ const basePath = basePathFor(cacheDir, accountId);
207
+ const collected = new Map();
208
+ let fetchedSpans = 0;
209
+ let queriedFills = 0;
210
+ let reusedMonths = 0;
211
+ for (const key of shardKeysForRange(gteMs, lteMs)) {
212
+ const { start, end } = shardBoundsForKey(key);
213
+ const shardGte = Math.max(gteMs, start);
214
+ const shardLte = Math.min(lteMs, end - 1);
215
+ if (shardLte < shardGte)
216
+ continue;
217
+ const shardFile = shardPathFor(basePath, key);
218
+ const shard = readShard(shardFile, accountId);
219
+ const existingQueried = shard ? normalizeQueried(shard.meta.queriedRanges) : [];
220
+ const trusted = options.refresh ? [] : trustedSegments(existingQueried, nowMs);
221
+ const missing = subtractRanges({ gte: shardGte, lte: shardLte }, trusted);
222
+ if (shard && missing.length === 0)
223
+ reusedMonths += 1;
224
+ let fills = shard ? shard.fills : [];
225
+ let queried = existingQueried;
226
+ let changed = false;
227
+ for (const span of missing) {
228
+ const incoming = await doFetch(new Date(span.gte).toISOString(), new Date(span.lte).toISOString());
229
+ queriedFills += incoming.length;
230
+ fetchedSpans += 1;
231
+ fills = mergeFills(fills, incoming);
232
+ queried = addCoverage(queried, span, nowMs);
233
+ changed = true;
234
+ }
235
+ for (const f of fills) {
236
+ const t = Date.parse(f.time);
237
+ if (Number.isFinite(t) && t >= gteMs && t <= lteMs)
238
+ collected.set(fillKey(f), f);
239
+ }
240
+ if (changed) {
241
+ writeJsonAtomic(shardFile, {
242
+ meta: { accountId, fetchedAt: new Date(nowMs).toISOString(), queriedRanges: queried },
243
+ fills,
244
+ });
245
+ }
246
+ }
247
+ if (!options.quiet && fetchedSpans > 0) {
248
+ const reuseNote = reusedMonths > 0 ? `; ${reusedMonths} month(s) reused from cache` : '';
249
+ console.log(` [cache] queried ${fetchedSpans} fill range(s) (${queriedFills} fill(s))${reuseNote}`);
250
+ }
251
+ return [...collected.values()].sort(compareFills);
252
+ }
253
+ export { fetchFillsCached, shardKeyForTimestamp, shardBoundsForKey, shardKeysForRange, basePathFor, shardPathFor, normalizeQueried, addCoverage, trustedSegments, subtractRanges, mergeFills, fillKey, TAIL_SETTLE_LAG_MS, MAX_COVERAGE_SPANS, };
254
+ //# sourceMappingURL=fills_cache.js.map
@@ -13,7 +13,7 @@ interface FillRecord {
13
13
  receives: AssetAmount;
14
14
  fee: AssetAmount;
15
15
  isMaker: boolean;
16
- sort: any[];
16
+ sort: unknown[];
17
17
  }
18
18
  declare function assetSymbol(id: string): string;
19
19
  declare function assetPrec(id: string): number | undefined;
@@ -24,6 +24,6 @@ declare function toReal(amount: number, assetId: string): number;
24
24
  */
25
25
  declare function resolveAssetPrecisions(fills: FillRecord[]): Promise<void>;
26
26
  /** Fetch every fill_order for an account in [gte, lte], paginated via search_after. */
27
- declare function fetchAllFills(config: any, accountId: string, gte: string, lte: string): Promise<FillRecord[]>;
27
+ declare function fetchAllFills(config: Record<string, unknown>, accountId: string, gte: string, lte: string): Promise<FillRecord[]>;
28
28
  export { BTS_ID, assetSymbol, assetPrec, toReal, resolveAssetPrecisions, fetchAllFills, FillRecord, };
29
29
  //# sourceMappingURL=fills_source.d.ts.map
@@ -8,6 +8,7 @@
8
8
  * of this (43-entry ASSETS table, toReal/assetPrec helpers, on-chain precision
9
9
  * resolution, query builder and paginated fetch); all of it lives here now.
10
10
  */
11
+ import { getErrorMessage } from '../modules/utils/errors.js';
11
12
  import * as KC from '../market_adapter/core/kibana_client.js';
12
13
  import { withReadOnlyClient } from './chain_pool.js';
13
14
  const { kibanaSearch, DEFAULT_CONFIG: BASE_CONFIG } = KC;
@@ -60,10 +61,11 @@ const ASSETS = {
60
61
  '1.3.6620': { symbol: 'XBTSX.A', precision: 6 },
61
62
  '1.3.6627': { symbol: 'XBTSX.LINK', precision: 6 },
62
63
  };
63
- /** Precisions learned on-chain this run (populated by resolveAssetPrecisions). */
64
+ /** Precisions/symbols learned on-chain this run (populated by resolveAssetPrecisions). */
64
65
  const resolvedPrecisions = {};
66
+ const resolvedSymbols = {};
65
67
  function assetSymbol(id) {
66
- return ASSETS[id]?.symbol ?? id;
68
+ return ASSETS[id]?.symbol ?? resolvedSymbols[id] ?? id;
67
69
  }
68
70
  function assetPrec(id) {
69
71
  return ASSETS[id]?.precision ?? resolvedPrecisions[id];
@@ -98,6 +100,8 @@ async function resolveAssetPrecisions(fills) {
98
100
  for (const asset of assets) {
99
101
  if (asset?.id && asset.precision != null) {
100
102
  resolvedPrecisions[asset.id] = asset.precision;
103
+ if (asset.symbol)
104
+ resolvedSymbols[asset.id] = String(asset.symbol);
101
105
  console.log(` ${asset.id} → ${asset.symbol || '?'} (precision ${asset.precision})`);
102
106
  }
103
107
  }
@@ -109,7 +113,7 @@ async function resolveAssetPrecisions(fills) {
109
113
  });
110
114
  }
111
115
  catch (e) {
112
- console.warn(` [warn] Asset resolution failed: ${e.message}. Fills with unknown assets will be skipped.`);
116
+ console.warn(` [warn] Asset resolution failed: ${getErrorMessage(e)}. Fills with unknown assets will be skipped.`);
113
117
  }
114
118
  }
115
119
  function buildFillQuery(accountId, gte, lte, size) {
@@ -156,27 +160,28 @@ async function fetchAllFills(config, accountId, gte, lte) {
156
160
  const hits = result?.hits?.hits ?? [];
157
161
  if (!hits.length)
158
162
  break;
159
- for (const hit of hits) {
163
+ for (const rawHit of hits) {
164
+ const hit = rawHit;
160
165
  const src = hit?._source;
161
166
  const op = src?.operation_history?.op_object;
162
167
  if (!op || !op.pays || !op.receives)
163
168
  continue;
164
169
  fills.push({
165
- time: src.block_data?.block_time ?? '',
166
- blockNum: src.block_data?.block_num ?? 0,
170
+ time: String(src.block_data?.block_time ?? ''),
171
+ blockNum: Number(src.block_data?.block_num ?? 0),
167
172
  opNum: Number(src.operation_id_num ?? 0),
168
- orderId: op.order_id ?? '',
169
- accountId: op.account_id ?? '',
170
- pays: { amount: Number(op.pays.amount ?? 0), asset_id: op.pays.asset_id ?? '' },
171
- receives: { amount: Number(op.receives.amount ?? 0), asset_id: op.receives.asset_id ?? '' },
172
- fee: { amount: Number(op.fee?.amount ?? 0), asset_id: op.fee?.asset_id ?? '' },
173
- isMaker: op.is_maker ?? false,
174
- sort: hit.sort,
173
+ orderId: String(op.order_id ?? ''),
174
+ accountId: String(op.account_id ?? ''),
175
+ pays: { amount: Number(op.pays.amount ?? 0), asset_id: String(op.pays.asset_id ?? '') },
176
+ receives: { amount: Number(op.receives.amount ?? 0), asset_id: String(op.receives.asset_id ?? '') },
177
+ fee: { amount: Number(op.fee?.amount ?? 0), asset_id: String(op.fee?.asset_id ?? '') },
178
+ isMaker: Boolean(op.is_maker ?? false),
179
+ sort: hit.sort ?? [],
175
180
  });
176
181
  }
177
182
  if (hits.length < pageSize)
178
183
  break;
179
- searchAfter = hits[hits.length - 1].sort;
184
+ searchAfter = hits[hits.length - 1].sort ?? null;
180
185
  if (!Array.isArray(searchAfter))
181
186
  break;
182
187
  }
@@ -54,7 +54,7 @@ interface AggregatedOrder {
54
54
  * @param {number|any} incrementPercent - Grid increment percent (e.g. 0.5). If not finite/<=0 falls back to DEFAULT_CONFIG.
55
55
  * @returns {{blocked: boolean, pivot: number|null, halfInc: number, threshold: number|null}}
56
56
  */
57
- declare function isLastFillGuardBlocked(price: any, type: any, lastPrice: any, lastType: any, incrementPercent: any): {
57
+ declare function isLastFillGuardBlocked(price: unknown, type: unknown, lastPrice: unknown, lastType: unknown, incrementPercent: unknown): {
58
58
  blocked: boolean;
59
59
  pivot: number | null;
60
60
  halfInc?: number;
@@ -31,6 +31,7 @@
31
31
  * node dist/analysis/grid_correction_check.js --bot-key <bot-key> --hours 720 --increment 0.5
32
32
  * node dist/analysis/grid_correction_check.js --list-bots
33
33
  */
34
+ import { getErrorMessage, getErrorField } from '../modules/utils/errors.js';
34
35
  import fs from 'node:fs';
35
36
  import { pathToFileURL } from 'node:url';
36
37
  import * as KC from '../market_adapter/core/kibana_client.js';
@@ -62,7 +63,7 @@ function isLastFillGuardBlocked(price, type, lastPrice, lastType, incrementPerce
62
63
  const pivot = Number(lastPrice);
63
64
  let inc = Number(incrementPercent);
64
65
  if (!Number.isFinite(inc) || inc <= 0) {
65
- inc = Number(C?.DEFAULT_CONFIG?.incrementPercent ?? 0.5);
66
+ inc = Number(C.DEFAULT_CONFIG?.incrementPercent ?? 0.5);
66
67
  }
67
68
  if (!Number.isFinite(inc) || inc <= 0)
68
69
  return { blocked: false, pivot: null };
@@ -82,7 +83,7 @@ function resolveIncrementPercent(botMeta, override) {
82
83
  const fromBot = Number(botMeta?.incrementPercent);
83
84
  if (Number.isFinite(fromBot) && fromBot > 0)
84
85
  return fromBot;
85
- const fromDefault = Number(C?.DEFAULT_CONFIG?.incrementPercent ?? 0.5);
86
+ const fromDefault = Number(C.DEFAULT_CONFIG?.incrementPercent ?? 0.5);
86
87
  if (Number.isFinite(fromDefault) && fromDefault > 0)
87
88
  return fromDefault;
88
89
  return 0.5;
@@ -111,7 +112,7 @@ Options:
111
112
  --refresh-account Force re-resolution of preferredAccount and update the
112
113
  stored accountId when it changed (default: reuse the
113
114
  stored accountId with no chain lookup)
114
- --increment <pct> Grid increment percent (default: from bot config or ${Number(C?.DEFAULT_CONFIG?.incrementPercent ?? 0.5)})
115
+ --increment <pct> Grid increment percent (default: from bot config or ${Number(C.DEFAULT_CONFIG?.incrementPercent ?? 0.5)})
115
116
  --tolerance <pct> Deprecated alias for --increment (kept for compat, prefer --increment)
116
117
  --per-fill Check at fill granularity (default: per-order aggregated)
117
118
  --include-cross-pair Check consecutive fills across different pairs (default: same pair only)
@@ -259,7 +260,7 @@ function resolveTimeRange(opts) {
259
260
  // ─── Account resolution errors ────────────────────────────────────────────────
260
261
  /** Map a shared account-resolver failure onto this tool's operator-facing hint. */
261
262
  function reportAccountFailure(resolved, opts) {
262
- switch (resolved.reason) {
263
+ switch (resolved?.reason) {
263
264
  case 'bot-not-found':
264
265
  console.error(`Error: bot key '${opts.botKey}' not found in profiles/bots.json and no --account provided.`);
265
266
  console.error('Use --list-bots to see available keys, or pass --account <1.2.x> explicitly.');
@@ -306,7 +307,7 @@ async function fetchAllOrderUpdates(config, accountId, gte, lte) {
306
307
  if (!hits.length)
307
308
  break;
308
309
  for (const hit of hits) {
309
- const source = hit?._source || {};
310
+ const source = (hit?._source || {});
310
311
  const op = source.operation_history?.op_object || {};
311
312
  const orderId = op.order;
312
313
  if (!orderId)
@@ -316,7 +317,7 @@ async function fetchAllOrderUpdates(config, accountId, gte, lte) {
316
317
  updates.push({ orderId, sequence: blockNum * 1e6 + opNum });
317
318
  }
318
319
  const last = hits[hits.length - 1];
319
- searchAfter = last?.sort;
320
+ searchAfter = last?.sort ?? null;
320
321
  if (!searchAfter || hits.length < pageSize)
321
322
  break;
322
323
  }
@@ -668,7 +669,7 @@ async function main() {
668
669
  const { gte, lte, label } = resolveTimeRange(opts);
669
670
  console.log(`\nLast-fill guard check — bot-key: ${opts.botKey}`);
670
671
  console.log(`Range: ${label}`);
671
- const resolvedAccount = await resolveBotAccount(opts.botKey, {
672
+ const resolvedAccount = await resolveBotAccount(String(opts.botKey), {
672
673
  overrideAccount: opts.account,
673
674
  refresh: opts.refreshAccount,
674
675
  });
@@ -721,9 +722,9 @@ async function main() {
721
722
  }
722
723
  const { violations, checkedTransitions } = detectViolations(items, opts.includeCrossPair, incrementPercent);
723
724
  const ordersForReport = opts.perFill ? null : items;
724
- printReport(trades, ordersForReport, violations, checkedTransitions, skipped, label, opts.botKey, accountId, botMeta, opts.perFill, opts.includeCrossPair, incrementPercent, gte, lte);
725
+ printReport(trades, ordersForReport, violations, checkedTransitions, skipped, label, String(opts.botKey), accountId, botMeta, opts.perFill, opts.includeCrossPair, incrementPercent, gte, lte);
725
726
  if (opts.json)
726
- exportJson(opts.json, violations, trades, label, opts.botKey, accountId, incrementPercent);
727
+ exportJson(opts.json, violations, trades, label, String(opts.botKey), accountId, incrementPercent);
727
728
  if (opts.csv)
728
729
  exportCsv(opts.csv, violations);
729
730
  process.exit(violations.length > 0 ? 2 : 0);
@@ -731,9 +732,9 @@ async function main() {
731
732
  export { isLastFillGuardBlocked, classifyFills, aggregateByOrder, detectViolations };
732
733
  if (process.argv[1] && import.meta.url === pathToFileURL(process.argv[1]).href) {
733
734
  main().catch(e => {
734
- console.error('\n[fatal]', e?.message ?? e);
735
+ console.error('\n[fatal]', getErrorMessage(e));
735
736
  if (process.env.DEBUG)
736
- console.error(e?.stack);
737
+ console.error(getErrorField(e, 'stack'));
737
738
  process.exit(1);
738
739
  });
739
740
  }
@@ -6,15 +6,16 @@ import { getCandleClose, getCandleTimestamp, normalizeCandle } from '../market_a
6
6
  * re-exported here so analysis tooling shares one logic path with the
7
7
  * live adapter and the browser-embedded chart scripts.
8
8
  */
9
- declare function range(min: number, max: number, step: number, decimals?: any): number[];
10
- declare function calcStdDev(arr: any): number;
9
+ declare function range(min: number, max: number, step: number, decimals?: number): number[];
10
+ declare function calcStdDev(arr: number[]): number;
11
11
  /**
12
12
  * Parse a candle JSON file with format detection:
13
13
  * flat array → {candles: [...]} → {data: [...]}
14
14
  */
15
- declare function loadCandleFile(filePath: any): {
16
- candles: any;
17
- meta: any;
18
- };
15
+ export interface CandleFile {
16
+ candles: Record<string, unknown>[];
17
+ meta: Record<string, unknown> | null;
18
+ }
19
+ declare function loadCandleFile(filePath: string): CandleFile;
19
20
  export { range, calcStdDev, getCandleClose, getCandleTimestamp, normalizeCandle, loadCandleFile, };
20
21
  //# sourceMappingURL=math_utils.d.ts.map
@@ -21,20 +21,17 @@ function calcStdDev(arr) {
21
21
  const sqDiffs = arr.reduce((sum, v) => sum + (v - mean) ** 2, 0);
22
22
  return Math.sqrt(sqDiffs / arr.length);
23
23
  }
24
- /**
25
- * Parse a candle JSON file with format detection:
26
- * flat array → {candles: [...]} → {data: [...]}
27
- */
28
24
  function loadCandleFile(filePath) {
29
25
  if (!filePath || !fs.existsSync(filePath))
30
26
  return { candles: [], meta: null };
31
27
  const raw = readJSON(filePath);
32
28
  if (Array.isArray(raw))
33
29
  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 };
30
+ const r = raw;
31
+ if (r && Array.isArray(r.candles))
32
+ return { candles: r.candles, meta: r.meta || r };
33
+ if (r && Array.isArray(r.data))
34
+ return { candles: r.data, meta: r };
38
35
  return { candles: [], meta: null };
39
36
  }
40
37
  export { range, calcStdDev, getCandleClose, getCandleTimestamp, normalizeCandle, loadCandleFile, };
@@ -0,0 +1,39 @@
1
+ /**
2
+ * PROFESSIONAL PnL REPORT (HTML)
3
+ *
4
+ * Renders the output of analysis/trade_profitability.ts (PairAnalysis +
5
+ * realized lots + performance metrics) into a single self-contained HTML
6
+ * report: no sibling assets, no CDN, no network — it opens from a file://
7
+ * link on any machine.
8
+ *
9
+ * Centralises the report so every consumer (the `dexbot pnl` command and
10
+ * direct `node dist/analysis/trade_profitability.js --html` runs) emits the
11
+ * exact same layout. The type-only import from trade_profitability is erased
12
+ * at compile time, so there is no runtime import cycle.
13
+ */
14
+ import type { PairAnalysis, TradingMetrics } from './trade_profitability.js';
15
+ interface PnlReportPair {
16
+ pair: PairAnalysis;
17
+ metrics: TradingMetrics;
18
+ }
19
+ interface PnlReportInput {
20
+ /** The reference the user typed (bot name, account name or 1.2.x id). */
21
+ accountRef: string;
22
+ /** Resolved chain account id (1.2.x). */
23
+ accountId: string;
24
+ /** Local bot profile name, when the reference resolved to one. */
25
+ botName?: string | null;
26
+ start: string;
27
+ end: string;
28
+ matchMode: string;
29
+ pairFilter?: string | null;
30
+ assetFilter?: string | null;
31
+ generatedAt?: string;
32
+ pairs: PnlReportPair[];
33
+ }
34
+ declare function renderPnlReportHtml(input: PnlReportInput): string;
35
+ /** Render + atomically write the report; returns the resolved file path. */
36
+ declare function writePnlReport(input: PnlReportInput, outputPath: string): string;
37
+ export { renderPnlReportHtml, writePnlReport };
38
+ export type { PnlReportInput, PnlReportPair };
39
+ //# sourceMappingURL=pnl_report.d.ts.map