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,325 @@
1
+ 'use strict';
2
+ import { escapeHtml, writeChartFile } from './chart_utils.js';
3
+ import { assetSymbol } from './fills_source.js';
4
+ import { formatFundsValue } from '../modules/order/format.js';
5
+ const MAX_DETAIL_ROWS = 2000;
6
+ /**
7
+ * Numbers go through the shared `formatFundsValue` (4 significant figures,
8
+ * K/M compaction, significant trailing zeros kept) so the report matches
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
+ */
12
+ function num(n) {
13
+ return Number.isFinite(n) ? formatFundsValue(n) : 'NaN';
14
+ }
15
+ function signed(n) {
16
+ if (!Number.isFinite(n))
17
+ return 'NaN';
18
+ if (n === 0)
19
+ return num(0);
20
+ return (n >= 0 ? '+' : '') + num(n);
21
+ }
22
+ function pct(n, decimals = 2) {
23
+ if (!Number.isFinite(n))
24
+ return 'NaN%';
25
+ return (n >= 0 ? '+' : '') + n.toFixed(decimals) + '%';
26
+ }
27
+ function ratio(n) {
28
+ if (n === Infinity)
29
+ return '∞';
30
+ if (Number.isNaN(n))
31
+ return '—';
32
+ return n.toFixed(2);
33
+ }
34
+ /** Signed-value CSS class used for colouring. */
35
+ function pnlClass(n) {
36
+ if (!Number.isFinite(n) || n === 0)
37
+ return 'muted';
38
+ return n > 0 ? 'pos' : 'neg';
39
+ }
40
+ function asset(id) {
41
+ return escapeHtml(assetSymbol(id));
42
+ }
43
+ function statCard(label, value, sub = '', cls = '') {
44
+ return `<div class="card ${cls}">
45
+ <div class="card-label">${escapeHtml(label)}</div>
46
+ <div class="card-value ${cls}">${value}</div>
47
+ ${sub ? `<div class="card-sub">${sub}</div>` : ''}
48
+ </div>`;
49
+ }
50
+ function metricRow(label, value, hint = '') {
51
+ return `<div class="metric">
52
+ <span class="metric-label">${escapeHtml(label)}</span>
53
+ <span class="metric-value"${hint ? ` title="${escapeHtml(hint)}"` : ''}>${value}</span>
54
+ </div>`;
55
+ }
56
+ function renderMetrics(metrics, quoteSymbol) {
57
+ const q = escapeHtml(quoteSymbol);
58
+ if (metrics.totalLots === 0) {
59
+ return '<p class="empty">No realized lots in the selected window — no performance metrics to compute.</p>';
60
+ }
61
+ const edge = [
62
+ metricRow('Win rate', (metrics.winRate * 100).toFixed(1) + '%'),
63
+ metricRow('Profit factor', ratio(metrics.profitFactor)),
64
+ metricRow('Avg win / avg loss', ratio(metrics.avgWinLossRatio)),
65
+ metricRow('Fee drag', metrics.feeDragPct > 0 ? metrics.feeDragPct.toFixed(2) + '% of gross profit' : '—'),
66
+ metricRow('Expectancy (net)', `${num(metrics.netExpectancyBts)} ${q} / trade`),
67
+ metricRow('Expectancy (gross)', `${num(metrics.expectancyBts)} ${q} (${pct(metrics.expectancyPct)})`),
68
+ metricRow('Expectancy (R)', metrics.expectancyR === Infinity ? '∞' : metrics.expectancyR.toFixed(3) + 'R'),
69
+ ].join('');
70
+ const risk = [
71
+ metricRow('Sharpe (annualised)', `${ratio(metrics.sharpeAnn)}${Number.isFinite(metrics.sharpeAnnSE) ? ` ± ${metrics.sharpeAnnSE.toFixed(2)}` : ''}`, `${metrics.periodLabel} bins, n=${metrics.periodCount}`),
72
+ metricRow('Sortino (annualised)', ratio(metrics.sortinoAnn) + (metrics.sortinoAnn === Infinity ? ' (no losing periods)' : '')),
73
+ metricRow('Projected net PnL', `${num(metrics.projectedNetPnlAnn)} ${q}/yr`, `${num(metrics.projectedNetPnlPerDay)}/day`),
74
+ metrics.mddHadStablePeak
75
+ ? metricRow('Max drawdown', `${num(metrics.mddAbsBts)} ${q} (${pct(metrics.mddPct)})`)
76
+ : metricRow('Min equity', `${num(metrics.prePeakMinEquity)} ${q}`),
77
+ metricRow('Max recovery time', metrics.maxRecoveryDays > 0 ? metrics.maxRecoveryDays.toFixed(1) + ' days' + (metrics.isOngoingRecovery ? ' (ongoing)' : '') : '—'),
78
+ metrics.currentDrawdownDays > 0
79
+ ? metricRow('Current drawdown', metrics.currentDrawdownDays.toFixed(1) + ' days (active)')
80
+ : '',
81
+ ].join('');
82
+ const distribution = [
83
+ metricRow('Median PnL', pct(metrics.medianPnlPct)),
84
+ metricRow('P25 / P75', `${pct(metrics.p25PnlPct)} / ${pct(metrics.p75PnlPct)}`),
85
+ metricRow('Best / worst trade', `${pct(metrics.bestTradePct)} / ${pct(metrics.worstTradePct)}`),
86
+ metricRow('Median R', metrics.medianR.toFixed(2)),
87
+ metricRow('Trades > 1R / > 2R', `${(metrics.pctRGreater1 * 100).toFixed(1)}% / ${(metrics.pctRGreater2 * 100).toFixed(1)}%`),
88
+ metricRow('Trades < -1R', `${(metrics.pctRLessNeg1 * 100).toFixed(1)}%`),
89
+ ].join('');
90
+ const behavior = [
91
+ metricRow('Max consecutive W / L', `${metrics.maxConsecWins} / ${metrics.maxConsecLosses}`),
92
+ metricRow('Avg hold time', metrics.avgHoldHours > 0 ? metrics.avgHoldHours.toFixed(1) + ' h' : '—'),
93
+ metricRow('Maker / taker', `${(metrics.limitOrderRatio * 100).toFixed(1)}% / ${((1 - metrics.limitOrderRatio) * 100).toFixed(1)}%`),
94
+ metricRow('Sell orders filled', String(metrics.sellOrdersFilled)),
95
+ metricRow('Partial fills / order', `${metrics.fillsPerOrderMean.toFixed(2)} mean, ${metrics.fillsPerOrderMedian.toFixed(1)} med, ${metrics.fillsPerOrderMax} max`),
96
+ metricRow('One-shot orders', `${(metrics.oneShotOrderRatio * 100).toFixed(0)}%`),
97
+ metricRow('Fills / day', metrics.fillsPerDay.toFixed(2)),
98
+ metricRow('Avg volume / day', `${num(metrics.avgVolumePerDay)} ${q}`),
99
+ ].join('');
100
+ return `
101
+ <div class="metrics-grid">
102
+ <div class="metrics-col"><h4>Edge</h4>${edge}</div>
103
+ <div class="metrics-col"><h4>Risk</h4>${risk}</div>
104
+ <div class="metrics-col"><h4>Distribution</h4>${distribution}</div>
105
+ <div class="metrics-col"><h4>Behavior &amp; activity</h4>${behavior}</div>
106
+ </div>`;
107
+ }
108
+ function renderPairsTable(pair, quoteSymbol) {
109
+ const lots = pair.realizedPnls;
110
+ if (lots.length === 0)
111
+ return '';
112
+ const shown = lots.slice(0, MAX_DETAIL_ROWS);
113
+ const rows = shown.map((r, i) => {
114
+ const net = r.pnlNet;
115
+ const legs = `${r.entryIsMaker ? 'M' : 'T'}/${r.exitIsMaker ? 'M' : 'T'}`;
116
+ return `<tr>
117
+ <td class="num">${i + 1}</td>
118
+ <td>${escapeHtml((r.entryTime || '').slice(0, 19).replace('T', ' '))}</td>
119
+ <td>${escapeHtml((r.exitTime || '').slice(0, 19).replace('T', ' '))}</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
+ <td class="num ${pnlClass(r.pnlPct)}">${pct(r.pnlPct)}</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
+ <td class="num ${pnlClass(r.pnlNetPct)}">${pct(r.pnlNetPct)}</td>
129
+ <td class="center">${legs}</td>
130
+ </tr>`;
131
+ }).join('');
132
+ const truncated = lots.length > shown.length
133
+ ? `<p class="empty">Showing the first ${shown.length.toLocaleString('en-US')} of ${lots.length.toLocaleString('en-US')} lots — use <code>--csv</code> for the full list.</p>`
134
+ : '';
135
+ return `
136
+ <details class="lots">
137
+ <summary>Realized lots (${lots.length.toLocaleString('en-US')})</summary>
138
+ <div class="table-wrap">
139
+ <table>
140
+ <thead><tr>
141
+ <th>#</th><th>Entry time</th><th>Exit time</th>
142
+ <th>Amount</th><th>Buy</th><th>Sell</th>
143
+ <th>Gross PnL</th><th>Gross %</th>
144
+ <th>Mkt fee</th><th>Op fee (BTS)</th>
145
+ <th>Net PnL</th><th>Net %</th><th>Legs</th>
146
+ </tr></thead>
147
+ <tbody>${rows}</tbody>
148
+ </table>
149
+ </div>
150
+ ${truncated}
151
+ <p class="empty">All PnL values are in ${escapeHtml(quoteSymbol)} unless marked BTS.</p>
152
+ </details>`;
153
+ }
154
+ function renderPairSection(entry) {
155
+ const { pair, metrics } = entry;
156
+ const base = asset(pair.baseAsset);
157
+ const quote = asset(pair.quoteAsset);
158
+ const quoteSymbol = assetSymbol(pair.quoteAsset);
159
+ const avgBuy = pair.totalBuyBase > 0 ? pair.totalBuyQuote / pair.totalBuyBase : 0;
160
+ const avgSell = pair.totalSellBase > 0 ? pair.totalSellQuote / pair.totalSellBase : 0;
161
+ const q = escapeHtml(quoteSymbol);
162
+ // Exactly one fee card keeps the left block a clean 2x2 when both fee
163
+ // kinds are present. Two currencies can't be summed, so the market fee is
164
+ // the headline and the op fee sits in the sub-line.
165
+ const hasMarketFee = pair.totalMarketFees > 0.0001;
166
+ const hasChainFee = pair.totalBlockchainFees > 0.0001;
167
+ const feeCard = hasMarketFee && hasChainFee
168
+ ? statCard('Fees', `${num(-pair.totalMarketFees)} ${q}`, `op ${num(-pair.totalBlockchainFees)} BTS`, 'neg')
169
+ : hasChainFee
170
+ ? statCard('Blockchain fees', `${num(-pair.totalBlockchainFees)} BTS`, '', 'neg')
171
+ : hasMarketFee
172
+ ? statCard('Market fees', `${num(-pair.totalMarketFees)} ${q}`, '', 'neg')
173
+ : '';
174
+ // Two 2x2 blocks: PnL/volume/fees, then position/activity. A 2-column grid
175
+ // keeps each card readable instead of squeezing six across one row.
176
+ const pnlCards = [
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
+ feeCard,
181
+ ].filter(Boolean).join('');
182
+ const positionCards = [
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)} ${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
+ ].filter(Boolean).join('');
188
+ return `
189
+ <article class="pair">
190
+ <header class="pair-head">
191
+ <h2>${base}<span class="slash">/</span>${quote}</h2>
192
+ </header>
193
+ <div class="cards-row">
194
+ <div class="cards two-col">${pnlCards}</div>
195
+ <div class="cards two-col">${positionCards}</div>
196
+ </div>
197
+ ${renderMetrics(metrics, quoteSymbol)}
198
+ ${renderPairsTable(pair, quoteSymbol)}
199
+ </article>`;
200
+ }
201
+ function renderTotals(pairs) {
202
+ if (pairs.length <= 1)
203
+ return '';
204
+ const groups = new Map();
205
+ for (const e of pairs) {
206
+ const q = e.pair.quoteAsset;
207
+ if (!groups.has(q))
208
+ groups.set(q, []);
209
+ groups.get(q).push(e);
210
+ }
211
+ const cards = [...groups.entries()].map(([quoteAsset, group]) => {
212
+ const gross = group.reduce((s, e) => s + e.pair.totalRealizedPnl, 0);
213
+ const net = group.reduce((s, e) => s + e.pair.totalRealizedPnlNet, 0);
214
+ const fees = group.reduce((s, e) => s + e.pair.totalMarketFees, 0);
215
+ const lots = group.reduce((s, e) => s + e.pair.realizedPnls.length, 0);
216
+ const quote = escapeHtml(assetSymbol(quoteAsset));
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
+ }).join('');
219
+ return `<section class="totals"><div class="cards">${cards}</div></section>`;
220
+ }
221
+ const REPORT_CSS = `
222
+ :root {
223
+ --bg: #0d1117; --panel: #161b22; --panel-2: #1c2230; --border: #30363d;
224
+ --text: #c9d1d9; --muted: #8b949e; --accent: #58a6ff;
225
+ --pos: #3fb950; --neg: #f85149;
226
+ }
227
+ *, *::before, *::after { box-sizing: border-box; }
228
+ html, body { margin: 0; padding: 0; }
229
+ body { background: var(--bg); color: var(--text);
230
+ font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', Helvetica, Arial, sans-serif;
231
+ font-size: 14px; line-height: 1.5; }
232
+ code { font-family: ui-monospace, SFMono-Regular, 'SF Mono', Menlo, Consolas, monospace; background: var(--panel-2); padding: 1px 5px; border-radius: 4px; }
233
+ .hero { display: flex; flex-wrap: wrap; gap: 16px; justify-content: space-between; align-items: flex-end;
234
+ padding: 28px 32px; border-bottom: 1px solid var(--border); background: linear-gradient(180deg, #161b22 0%, #0d1117 100%); }
235
+ .hero h1 { margin: 0; font-size: 24px; letter-spacing: .2px; color: #f0f6fc; }
236
+ .hero .sub { margin: 6px 0 0; color: var(--muted); font-size: 13px; }
237
+ .hero .sub b { color: var(--text); font-weight: 600; }
238
+ .generated { color: var(--muted); font-size: 12px; text-align: right; }
239
+ main { padding: 24px 32px 48px; max-width: 1500px; margin: 0 auto; }
240
+ .cards { display: grid; grid-template-columns: repeat(auto-fit, minmax(200px, 1fr)); gap: 12px; }
241
+ .cards-row { display: grid; grid-template-columns: 1fr 1fr; gap: 12px; }
242
+ .cards.two-col { grid-template-columns: repeat(2, minmax(0, 1fr)); }
243
+ .card { background: var(--panel); border: 1px solid var(--border); border-radius: 10px; padding: 14px 16px; }
244
+ .card-label { color: var(--muted); font-size: 11px; text-transform: uppercase; letter-spacing: .6px; }
245
+ .card-value { font-size: 20px; font-weight: 600; margin-top: 6px; font-variant-numeric: tabular-nums; }
246
+ .card-sub { color: var(--muted); font-size: 12px; margin-top: 4px; }
247
+ .card-value.pos, .pos { color: var(--pos); }
248
+ .card-value.neg, .neg { color: var(--neg); }
249
+ .muted, .card-value.muted { color: var(--muted); }
250
+ .totals { margin-bottom: 24px; }
251
+ .pair { background: var(--panel); border: 1px solid var(--border); border-radius: 12px; padding: 20px 22px; margin-bottom: 20px; }
252
+ .pair-head { display: flex; align-items: center; justify-content: space-between; margin-bottom: 16px; }
253
+ .pair-head h2 { margin: 0; font-size: 18px; color: #f0f6fc; }
254
+ .pair-head .slash { color: var(--muted); margin: 0 2px; }
255
+ .metrics-grid { display: grid; grid-template-columns: repeat(auto-fit, minmax(280px, 1fr)); gap: 18px 28px; margin: 20px 0 4px; }
256
+ .metrics-col h4 { margin: 0 0 8px; font-size: 12px; text-transform: uppercase; letter-spacing: .7px; color: var(--accent); border-bottom: 1px solid var(--border); padding-bottom: 6px; }
257
+ .metric { display: flex; justify-content: space-between; gap: 12px; padding: 3px 0; border-bottom: 1px dashed rgba(48,54,61,.5); }
258
+ .metric-label { color: var(--muted); font-size: 13px; }
259
+ .metric-value { font-variant-numeric: tabular-nums; font-size: 13px; text-align: right; }
260
+ details.lots { margin-top: 18px; }
261
+ details.lots > summary { cursor: pointer; color: var(--accent); font-weight: 600; font-size: 13px; padding: 6px 0; user-select: none; }
262
+ .table-wrap { overflow-x: auto; margin-top: 10px; border: 1px solid var(--border); border-radius: 8px; }
263
+ table { border-collapse: collapse; width: 100%; font-size: 12px; font-variant-numeric: tabular-nums; }
264
+ th, td { padding: 6px 10px; text-align: right; white-space: nowrap; border-bottom: 1px solid var(--border); }
265
+ th { position: sticky; top: 0; background: var(--panel-2); color: var(--muted); text-transform: uppercase; font-size: 10px; letter-spacing: .5px; z-index: 1; }
266
+ td:first-child, th:first-child, td:nth-child(2), th:nth-child(2), td:nth-child(3), th:nth-child(3) { text-align: left; }
267
+ td.center, th.center { text-align: center; }
268
+ tbody tr:hover { background: rgba(88,166,255,.06); }
269
+ .empty { color: var(--muted); font-size: 13px; margin: 10px 0; }
270
+ footer { border-top: 1px solid var(--border); padding: 18px 32px 40px; color: var(--muted); font-size: 12px; max-width: 1500px; margin: 0 auto; }
271
+ footer p { margin: 4px 0; }
272
+ @media (max-width: 900px) { .cards-row { grid-template-columns: 1fr; } }
273
+ @media (max-width: 640px) { main, .hero, footer { padding-left: 16px; padding-right: 16px; } .generated { text-align: left; } .cards.two-col { grid-template-columns: 1fr; } }
274
+ `;
275
+ function renderPnlReportHtml(input) {
276
+ const accountLabel = input.botName
277
+ ? `${input.botName} (${input.accountId})`
278
+ : input.accountId;
279
+ const filters = [];
280
+ if (input.pairFilter)
281
+ filters.push(`pair ${input.pairFilter}`);
282
+ if (input.assetFilter)
283
+ filters.push(`asset ${input.assetFilter}`);
284
+ const filterLabel = filters.length > 0 ? ` · filter: ${filters.join(', ')}` : '';
285
+ const generatedAt = input.generatedAt ?? new Date().toISOString();
286
+ const totalLots = input.pairs.reduce((s, e) => s + e.pair.realizedPnls.length, 0);
287
+ const pairsBody = input.pairs.map(renderPairSection).join('\n');
288
+ const periodLabel = `${escapeHtml(input.start.slice(0, 10))} → ${escapeHtml(input.end.slice(0, 10))}`;
289
+ return `<!DOCTYPE html>
290
+ <html lang="en">
291
+ <head>
292
+ <meta charset="UTF-8">
293
+ <meta name="viewport" content="width=device-width, initial-scale=1.0">
294
+ <meta name="darkreader-lock">
295
+ <title>PnL Report · ${escapeHtml(accountLabel)}</title>
296
+ <style>${REPORT_CSS}</style>
297
+ </head>
298
+ <body>
299
+ <header class="hero">
300
+ <div>
301
+ <h1>PnL Report</h1>
302
+ <p class="sub">Account <b>${escapeHtml(accountLabel)}</b> · ${periodLabel} · ${input.pairs.length} pair${input.pairs.length === 1 ? '' : 's'} · ${totalLots} realized lot${totalLots === 1 ? '' : 's'} · match mode <b>${escapeHtml(input.matchMode)}</b>${escapeHtml(filterLabel)}</p>
303
+ </div>
304
+ <div class="generated">Generated ${escapeHtml(generatedAt.replace('T', ' ').slice(0, 19))} UTC</div>
305
+ </header>
306
+ <main>
307
+ ${renderTotals(input.pairs)}
308
+ ${pairsBody || '<p class="empty">No classified trades in the selected window.</p>'}
309
+ </main>
310
+ <footer>
311
+ <p>PnL uses gross fill prices. Net PnL deducts market fees (issuer + network portions, converted to the pair's quote asset) and blockchain operation fees (BTS per limit_order_create). Buy lots enter at net receives, so inventory matching reflects what the account actually held.</p>
312
+ <p>If inventory predates the window or crosses asset pairs, realized lots may not reflect true trade economics. Non-BTS quote pairs report PnL in that quote asset, not BTS.</p>
313
+ <p>Amounts are shown with 4 significant figures (compact K/M) for readability.</p>
314
+ <p>Generated by DEXBot2 · <code>dexbot pnl</code></p>
315
+ </footer>
316
+ </body>
317
+ </html>`;
318
+ }
319
+ /** Render + atomically write the report; returns the resolved file path. */
320
+ function writePnlReport(input, outputPath) {
321
+ writeChartFile(outputPath, renderPnlReportHtml(input));
322
+ return outputPath;
323
+ }
324
+ export { renderPnlReportHtml, writePnlReport };
325
+ //# sourceMappingURL=pnl_report.js.map
@@ -14,10 +14,10 @@ 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
21
  };
22
22
  }
23
23
  interface MarketAdapterConfig {
@@ -30,10 +30,10 @@ declare class MarketAdapterSource {
30
30
  botKey: string;
31
31
  name: string;
32
32
  constructor(config: MarketAdapterConfig);
33
- fetchCandles(): Promise<any[]>;
34
- extractMarketPrice(candle: any): {
35
- marketPrice: any;
36
- timestamp: any;
33
+ fetchCandles(): Promise<Record<string, unknown>[]>;
34
+ extractMarketPrice(candle: unknown): {
35
+ marketPrice: number;
36
+ timestamp: number;
37
37
  };
38
38
  }
39
39
  declare function createSource(type: string, config: JsonFileConfig | MarketAdapterConfig): JsonFileSource | MarketAdapterSource;
@@ -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
  }
@@ -83,7 +83,8 @@ class MarketAdapterSource {
83
83
  }
84
84
  }
85
85
  extractMarketPrice(candle) {
86
- return { marketPrice: candle.close, timestamp: candle.timestamp };
86
+ const c = candle;
87
+ return { marketPrice: c.close, timestamp: c.timestamp };
87
88
  }
88
89
  }
89
90
  function createSource(type, config) {
@@ -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() {
@@ -12,10 +12,9 @@ interface SourceResolution {
12
12
  erPeriod: number;
13
13
  fastPeriod: number;
14
14
  slowPeriod: number;
15
- erSmoothPeriod: number;
16
15
  };
17
16
  amaKey: string;
18
- meta: any;
17
+ meta: Record<string, unknown> | null;
19
18
  }
20
19
  declare function listAvailableBots(): void;
21
20
  declare function resolveSource(config: SourceConfig, options?: {
@@ -50,7 +50,32 @@ interface PairAnalysis {
50
50
  totalRealizedPnlNet: number;
51
51
  netPosition: number;
52
52
  }
53
- declare function classifyFills(fills: FillRecord[], filterAsset: string | null): {
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
+ declare function classifyFills(fills: FillRecord[], filterAsset: string | null, pairFilter?: {
76
+ base: string;
77
+ quote: string;
78
+ } | null): {
54
79
  trades: TradeFill[];
55
80
  pairs: Set<string>;
56
81
  };
@@ -89,6 +114,8 @@ interface TradingMetrics {
89
114
  worstTradePct: number;
90
115
  mddPct: number;
91
116
  mddAbsBts: number;
117
+ /** Lowest cumulative equity before a stable peak formed (quote asset); 0 when a peak existed. */
118
+ prePeakMinEquity: number;
92
119
  mddHadStablePeak: boolean;
93
120
  isOngoingRecovery: boolean;
94
121
  currentDrawdownDays: number;
@@ -110,5 +137,8 @@ interface TradingMetrics {
110
137
  pctRLessNeg1: number;
111
138
  }
112
139
  declare function computeMetrics(pair: PairAnalysis, window?: WindowRange): TradingMetrics;
113
- export { analyzePair, classifyFills, computeMetrics, TradeFill, FillRecord, RealizedPnl, PairAnalysis, TradingMetrics };
140
+ /** Auto-named report file: bot/account + pair filter + requested range. */
141
+ declare function reportFileName(opts: TradeProfitabilityOptions, accountRef: string, botName: string | null): string;
142
+ declare function run(argv?: string[]): Promise<void>;
143
+ export { analyzePair, classifyFills, computeMetrics, parseArgs, run, reportFileName, TradeFill, FillRecord, RealizedPnl, PairAnalysis, TradingMetrics, WindowRange };
114
144
  //# sourceMappingURL=trade_profitability.d.ts.map