dexbot 1.6.11 → 1.6.13

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (398) hide show
  1. package/CHANGELOG.md +67 -4
  2. package/README.md +2 -1
  3. package/analysis/README.md +11 -11
  4. package/analysis/ama_fitting/README.md +5 -3
  5. package/analysis/tradingview/README.md +1 -1
  6. package/analysis/trend_detection/DYNAMIC_WEIGHT_RESEARCH.md +3 -3
  7. package/claw/README.md +1 -0
  8. package/claw/docs/AI_BOT_LIBRARY_API.md +2 -0
  9. package/claw/docs/DEXBOT2_TUNING_CHEAT_SHEET.md +4 -3
  10. package/claw/modules/chain_broadcast.ts +7 -1
  11. package/claw/modules/claw_bridge.ts +0 -3
  12. package/claw/modules/claw_launcher.ts +1 -1
  13. package/claw/modules/claw_skill_md.ts +1 -0
  14. package/claw/modules/launcher_mode_detector.ts +9 -2
  15. package/claw/package.json +3 -3
  16. package/claw/runtimes/openclaw-plugin/openclaw.plugin.json +1 -1
  17. package/claw/runtimes/openclaw-plugin/package.json +1 -1
  18. package/claw/tsconfig.json +2 -2
  19. package/dist/analysis/account_resolver.d.ts +1 -1
  20. package/dist/analysis/account_resolver.js +2 -1
  21. package/dist/analysis/ama_fitting/analyze_ama_price_changes.js +3 -4
  22. package/dist/analysis/ama_fitting/analyze_lambda_vs_slow.js +3 -21
  23. package/dist/analysis/ama_fitting/calibrate_convergence_er.js +0 -1
  24. package/dist/analysis/ama_fitting/fetch_lp_candles.js +55 -45
  25. package/dist/analysis/ama_fitting/generate_unified_comparison_chart.d.ts +1 -8
  26. package/dist/analysis/ama_fitting/generate_unified_comparison_chart.js +45 -24
  27. package/dist/analysis/ama_fitting/optimizer_high_resolution.js +34 -78
  28. package/dist/analysis/analyze_args.d.ts +43 -0
  29. package/dist/analysis/analyze_args.js +61 -0
  30. package/dist/analysis/analyze_dynamic_weight.js +7 -17
  31. package/dist/analysis/analyze_kalman.js +7 -17
  32. package/dist/analysis/analyze_regime.js +7 -17
  33. package/dist/analysis/analyze_regime_windows.js +8 -18
  34. package/dist/analysis/analyze_risk_profile.js +8 -18
  35. package/dist/analysis/analyze_trade_heatmap.js +7 -17
  36. package/dist/analysis/analyze_volatility.js +7 -17
  37. package/dist/analysis/bot_fitting/backtest_ama_sweep.d.ts +221 -28
  38. package/dist/analysis/bot_fitting/backtest_ama_sweep.js +23 -103
  39. package/dist/analysis/bot_fitting/backtest_bot_fitting.d.ts +34 -4
  40. package/dist/analysis/bot_fitting/backtest_bot_fitting.js +32 -150
  41. package/dist/analysis/bot_fitting/backtest_lookback_drawdown.js +19 -34
  42. package/dist/analysis/bot_fitting/shared_utils.d.ts +77 -9
  43. package/dist/analysis/bot_fitting/shared_utils.js +125 -9
  44. package/dist/analysis/bot_key_utils.d.ts +18 -10
  45. package/dist/analysis/bot_key_utils.js +7 -4
  46. package/dist/analysis/bot_usage/discover_bot_accounts.js +44 -47
  47. package/dist/analysis/bot_usage/kibana_bot_queries.d.ts +1 -21
  48. package/dist/analysis/chain_pool.d.ts +3 -1
  49. package/dist/analysis/chart_ui.d.ts +35 -3
  50. package/dist/analysis/chart_ui.js +43 -4
  51. package/dist/analysis/chart_utils.d.ts +5 -5
  52. package/dist/analysis/chart_utils.js +9 -0
  53. package/dist/analysis/fills_cache.d.ts +4 -24
  54. package/dist/analysis/fills_cache.js +3 -84
  55. package/dist/analysis/fills_source.d.ts +33 -3
  56. package/dist/analysis/fills_source.js +83 -13
  57. package/dist/analysis/grid_correction_check.d.ts +2 -24
  58. package/dist/analysis/grid_correction_check.js +27 -69
  59. package/dist/analysis/math_utils.d.ts +91 -6
  60. package/dist/analysis/math_utils.js +119 -7
  61. package/dist/analysis/pnl_report.js +29 -29
  62. package/dist/analysis/price_sources.d.ts +30 -9
  63. package/dist/analysis/price_sources.js +28 -4
  64. package/dist/analysis/resolve_bot_accounts.js +2 -2
  65. package/dist/analysis/resolve_source.d.ts +1 -1
  66. package/dist/analysis/resolve_source.js +31 -10
  67. package/dist/analysis/trade_profitability.d.ts +29 -2
  68. package/dist/analysis/trade_profitability.js +73 -147
  69. package/dist/analysis/tradingview/analyze_tradingview.d.ts +3 -8
  70. package/dist/analysis/tradingview/analyze_tradingview.js +7 -6
  71. package/dist/analysis/tradingview/grid_reset_config.d.ts +41 -32
  72. package/dist/analysis/tradingview/grid_reset_config.js +23 -11
  73. package/dist/analysis/tradingview/grid_reset_sim.d.ts +75 -9
  74. package/dist/analysis/tradingview/grid_reset_sim.js +4 -3
  75. package/dist/analysis/tradingview/tradingview_uplot_chart_generator.d.ts +69 -4
  76. package/dist/analysis/tradingview/tradingview_uplot_chart_generator.js +20 -34
  77. package/dist/analysis/trend_detection/backtest_ama_slope_huber.d.ts +1 -101
  78. package/dist/analysis/trend_detection/backtest_ama_slope_huber.js +26 -84
  79. package/dist/analysis/trend_detection/dynamic_weight_chart_generator.d.ts +63 -1
  80. package/dist/analysis/trend_detection/dynamic_weight_chart_generator.js +16 -41
  81. package/dist/analysis/trend_detection/huber_scale_variants.d.ts +9 -3
  82. package/dist/analysis/trend_detection/huber_scale_variants.js +4 -4
  83. package/dist/analysis/trend_detection/kalman_chart_generator.d.ts +30 -1
  84. package/dist/analysis/trend_detection/kalman_chart_generator.js +3 -3
  85. package/dist/analysis/trend_detection/regime_chart_generator.d.ts +31 -1
  86. package/dist/analysis/trend_detection/regime_chart_generator.js +2 -2
  87. package/dist/analysis/trend_detection/volatility_chart_generator.d.ts +33 -1
  88. package/dist/analysis/trend_detection/volatility_chart_generator.js +9 -10
  89. package/dist/analysis/worker_pool.d.ts +38 -0
  90. package/dist/analysis/worker_pool.js +67 -0
  91. package/dist/credential-daemon.js +34 -20
  92. package/dist/dexbot.js +78 -59
  93. package/dist/market_adapter/ama_signal_runner.js +21 -54
  94. package/dist/market_adapter/candle_utils.d.ts +29 -19
  95. package/dist/market_adapter/candle_utils.js +35 -21
  96. package/dist/market_adapter/cli_args.d.ts +22 -0
  97. package/dist/market_adapter/cli_args.js +30 -0
  98. package/dist/market_adapter/core/asymmetric_bounds.d.ts +13 -4
  99. package/dist/market_adapter/core/config_normalizers.d.ts +3 -3
  100. package/dist/market_adapter/core/config_normalizers.js +11 -6
  101. package/dist/market_adapter/core/kibana_candles.d.ts +56 -19
  102. package/dist/market_adapter/core/kibana_candles.js +12 -9
  103. package/dist/market_adapter/core/kibana_client.d.ts +9 -1
  104. package/dist/market_adapter/core/kibana_client.js +8 -7
  105. package/dist/market_adapter/core/kibana_market_candles.d.ts +3 -2
  106. package/dist/market_adapter/core/market_adapter_service.d.ts +320 -153
  107. package/dist/market_adapter/core/market_adapter_service.js +228 -269
  108. package/dist/market_adapter/core/signals/hurst_analyzer.d.ts +1 -6
  109. package/dist/market_adapter/core/signals/hurst_analyzer.js +1 -1
  110. package/dist/market_adapter/core/signals/permutation_entropy_analyzer.d.ts +1 -11
  111. package/dist/market_adapter/core/signals/permutation_entropy_analyzer.js +1 -1
  112. package/dist/market_adapter/core/strategies/ama.d.ts +10 -2
  113. package/dist/market_adapter/core/strategies/ama.js +2 -4
  114. package/dist/market_adapter/core/strategies/ama_slope_model.d.ts +14 -1
  115. package/dist/market_adapter/core/strategies/ama_slope_model.js +12 -34
  116. package/dist/market_adapter/core/strategies/atr/calculator.d.ts +7 -2
  117. package/dist/market_adapter/core/strategies/atr/calculator.js +2 -34
  118. package/dist/market_adapter/core/strategies/collateral_manager.d.ts +7 -1
  119. package/dist/market_adapter/core/strategies/collateral_manager.js +0 -22
  120. package/dist/market_adapter/core/strategies/dynamic_weight_series.d.ts +34 -6
  121. package/dist/market_adapter/core/strategies/dynamic_weight_series.js +7 -7
  122. package/dist/market_adapter/core/strategies/regime_gate.d.ts +24 -15
  123. package/dist/market_adapter/core/strategies/regime_gate.js +4 -31
  124. package/dist/market_adapter/core/strategies/regime_interp.d.ts +7 -1
  125. package/dist/market_adapter/core/strategies/regime_interp.js +14 -22
  126. package/dist/market_adapter/core/strategies/volatility_shift.d.ts +11 -1
  127. package/dist/market_adapter/core/strategies/volatility_shift.js +0 -13
  128. package/dist/market_adapter/inputs/cex_candle_parsing.d.ts +29 -0
  129. package/dist/market_adapter/inputs/cex_candle_parsing.js +52 -0
  130. package/dist/market_adapter/inputs/fetch_book_data.d.ts +20 -4
  131. package/dist/market_adapter/inputs/fetch_book_data.js +3 -2
  132. package/dist/market_adapter/inputs/fetch_cex_synthetic_data.js +160 -332
  133. package/dist/market_adapter/inputs/fetch_lp_data.d.ts +50 -8
  134. package/dist/market_adapter/inputs/fetch_lp_data.js +47 -22
  135. package/dist/market_adapter/inputs/kibana_feed_source.d.ts +74 -15
  136. package/dist/market_adapter/inputs/kibana_feed_source.js +26 -41
  137. package/dist/market_adapter/inputs/kibana_source.d.ts +25 -3
  138. package/dist/market_adapter/inputs/kibana_source.js +2 -2
  139. package/dist/market_adapter/inputs/window_cache.d.ts +93 -156
  140. package/dist/market_adapter/inputs/window_cache.js +59 -184
  141. package/dist/market_adapter/interval_utils.d.ts +15 -5
  142. package/dist/market_adapter/interval_utils.js +16 -1
  143. package/dist/market_adapter/log_format.d.ts +6 -6
  144. package/dist/market_adapter/log_format.js +28 -21
  145. package/dist/market_adapter/lp_chart_core.d.ts +22 -1
  146. package/dist/market_adapter/lp_chart_core.js +26 -192
  147. package/dist/market_adapter/lp_chart_runner.d.ts +10 -7
  148. package/dist/market_adapter/lp_chart_runner.js +37 -19
  149. package/dist/market_adapter/lp_chart_strategy_loader.d.ts +41 -6
  150. package/dist/market_adapter/lp_chart_strategy_loader.js +8 -7
  151. package/dist/market_adapter/market_adapter.d.ts +94 -32
  152. package/dist/market_adapter/market_adapter.js +94 -120
  153. package/dist/market_adapter/utils/adapter_client.d.ts +3 -3
  154. package/dist/market_adapter/utils/adapter_client.js +2 -2
  155. package/dist/market_adapter/utils/atomic_write.d.ts +8 -1
  156. package/dist/market_adapter/utils/chain.d.ts +50 -41
  157. package/dist/market_adapter/utils/chain.js +40 -46
  158. package/dist/market_adapter/utils/data_discovery.d.ts +49 -2
  159. package/dist/market_adapter/utils/data_discovery.js +220 -27
  160. package/dist/market_adapter/utils/dynamic_grid_snapshot.d.ts +12 -3
  161. package/dist/market_adapter/utils/file_json_cache.d.ts +2 -2
  162. package/dist/market_adapter/utils/file_lock.d.ts +28 -14
  163. package/dist/market_adapter/utils/file_lock.js +36 -32
  164. package/dist/market_adapter/utils/month_shards.d.ts +84 -0
  165. package/dist/market_adapter/utils/month_shards.js +237 -0
  166. package/dist/market_adapter/utils/native_history.d.ts +9 -2
  167. package/dist/market_adapter/utils/native_history.js +35 -28
  168. package/dist/modules/account_bots.d.ts +578 -21
  169. package/dist/modules/account_bots.js +272 -267
  170. package/dist/modules/account_orders.d.ts +79 -30
  171. package/dist/modules/account_orders.js +60 -64
  172. package/dist/modules/authority_resolver.d.ts +12 -2
  173. package/dist/modules/authority_resolver.js +15 -8
  174. package/dist/modules/bitshares-native/chain_client.d.ts +39 -4
  175. package/dist/modules/bitshares-native/chain_client.js +59 -59
  176. package/dist/modules/bitshares-native/crypto/ecc.browser.js +11 -171
  177. package/dist/modules/bitshares-native/crypto/ecc.js +13 -176
  178. package/dist/modules/bitshares-native/crypto/ecc_core.d.ts +33 -0
  179. package/dist/modules/bitshares-native/crypto/ecc_core.js +213 -0
  180. package/dist/modules/bitshares-native/crypto/ecc_selector.d.ts +2 -1
  181. package/dist/modules/bitshares-native/crypto/ecc_selector.js +1 -13
  182. package/dist/modules/bitshares-native/index.d.ts +1 -1
  183. package/dist/modules/bitshares-native/lru_cache.d.ts +7 -7
  184. package/dist/modules/bitshares-native/resolvers.d.ts +18 -6
  185. package/dist/modules/bitshares-native/resolvers.js +22 -25
  186. package/dist/modules/bitshares-native/serial/lazy_buffer.d.ts +4 -0
  187. package/dist/modules/bitshares-native/serial/lazy_buffer.js +21 -0
  188. package/dist/modules/bitshares-native/serial/operations.d.ts +1 -1
  189. package/dist/modules/bitshares-native/serial/serializer.d.ts +16 -12
  190. package/dist/modules/bitshares-native/serial/serializer.js +7 -13
  191. package/dist/modules/bitshares-native/serial/types.d.ts +25 -16
  192. package/dist/modules/bitshares-native/serial/types.js +73 -108
  193. package/dist/modules/bitshares-native/signing_client.d.ts +32 -2
  194. package/dist/modules/bitshares-native/signing_client.js +19 -14
  195. package/dist/modules/bitshares-native/subscriptions.d.ts +81 -1
  196. package/dist/modules/bitshares-native/subscriptions.js +12 -12
  197. package/dist/modules/bitshares-native/transport.d.ts +5 -4
  198. package/dist/modules/bitshares-native/transport.js +5 -4
  199. package/dist/modules/bitshares-native/tx/builder.d.ts +40 -5
  200. package/dist/modules/bitshares-native/tx/builder.js +4 -3
  201. package/dist/modules/bitshares-native/tx/tx_cache.d.ts +4 -4
  202. package/dist/modules/bitshares_client.d.ts +45 -13
  203. package/dist/modules/bitshares_client.js +28 -19
  204. package/dist/modules/bot_defaults.d.ts +8 -16
  205. package/dist/modules/bot_defaults.js +1 -5
  206. package/dist/modules/bot_settings.d.ts +44 -10
  207. package/dist/modules/bot_settings.js +11 -8
  208. package/dist/modules/bots_file_lock.d.ts +6 -6
  209. package/dist/modules/bots_file_lock.js +16 -12
  210. package/dist/modules/broadcast_failure.d.ts +4 -3
  211. package/dist/modules/broadcast_failure.js +5 -4
  212. package/dist/modules/chain_keys.d.ts +42 -40
  213. package/dist/modules/chain_keys.js +53 -45
  214. package/dist/modules/chain_orders.d.ts +94 -60
  215. package/dist/modules/chain_orders.js +81 -118
  216. package/dist/modules/cli_start_onboarding.d.ts +2 -1
  217. package/dist/modules/constants.d.ts +534 -32
  218. package/dist/modules/constants.js +35 -48
  219. package/dist/modules/cr_planner.d.ts +41 -3
  220. package/dist/modules/cr_planner.js +1 -5
  221. package/dist/modules/credential_policy.d.ts +68 -8
  222. package/dist/modules/credential_policy.js +37 -31
  223. package/dist/modules/credential_session_cache.d.ts +2 -2
  224. package/dist/modules/credit_pricing.d.ts +43 -6
  225. package/dist/modules/credit_pricing.js +70 -60
  226. package/dist/modules/credit_runtime.d.ts +283 -118
  227. package/dist/modules/credit_runtime.js +500 -231
  228. package/dist/modules/crypto/browser_provider.js +6 -4
  229. package/dist/modules/crypto/node_provider.js +1 -1
  230. package/dist/modules/crypto/pure_scrypt.js +35 -4
  231. package/dist/modules/crypto/pure_secp256k1.js +72 -26
  232. package/dist/modules/crypto/sync.d.ts +9 -9
  233. package/dist/modules/crypto/sync.js +16 -9
  234. package/dist/modules/daemon_node_health.d.ts +4 -3
  235. package/dist/modules/dexbot_class.d.ts +213 -146
  236. package/dist/modules/dexbot_class.js +183 -86
  237. package/dist/modules/dexbot_cow_runtime.d.ts +160 -87
  238. package/dist/modules/dexbot_cow_runtime.js +302 -234
  239. package/dist/modules/dexbot_credential_client.d.ts +19 -18
  240. package/dist/modules/dexbot_credential_client.js +1 -2
  241. package/dist/modules/dexbot_fill_runtime.d.ts +63 -49
  242. package/dist/modules/dexbot_fill_runtime.js +53 -47
  243. package/dist/modules/dexbot_maintenance_runtime.d.ts +127 -71
  244. package/dist/modules/dexbot_maintenance_runtime.js +187 -147
  245. package/dist/modules/dexbot_startup_runtime.d.ts +11 -11
  246. package/dist/modules/dexbot_startup_runtime.js +56 -57
  247. package/dist/modules/dexbot_state_recovery.d.ts +13 -12
  248. package/dist/modules/dexbot_state_recovery.js +18 -13
  249. package/dist/modules/fund_registry.d.ts +4 -2
  250. package/dist/modules/fund_registry.js +10 -10
  251. package/dist/modules/general_settings.d.ts +30 -4
  252. package/dist/modules/graceful_shutdown.d.ts +3 -3
  253. package/dist/modules/graceful_shutdown.js +19 -13
  254. package/dist/modules/grid_price_source.d.ts +1 -1
  255. package/dist/modules/key_store.d.ts +14 -8
  256. package/dist/modules/key_store.js +7 -7
  257. package/dist/modules/launcher/adapter_requirement.d.ts +11 -5
  258. package/dist/modules/launcher/adapter_requirement.js +5 -5
  259. package/dist/modules/launcher/bot_supervisor.d.ts +106 -24
  260. package/dist/modules/launcher/bot_supervisor.js +12 -11
  261. package/dist/modules/launcher/credential_bootstrap.d.ts +1 -1
  262. package/dist/modules/launcher/credential_bootstrap.js +1 -1
  263. package/dist/modules/launcher/credential_daemon.d.ts +4 -4
  264. package/dist/modules/launcher/credential_daemon.js +2 -2
  265. package/dist/modules/launcher/credential_secret.d.ts +1 -1
  266. package/dist/modules/launcher/foreign_cred_daemon.d.ts +2 -2
  267. package/dist/modules/launcher/market_adapter_runtime.d.ts +61 -6
  268. package/dist/modules/launcher/market_adapter_watchdog.d.ts +10 -2
  269. package/dist/modules/launcher/market_adapter_watchdog.js +4 -0
  270. package/dist/modules/launcher/monolithic_runtime.d.ts +18 -16
  271. package/dist/modules/launcher/status_reporting.d.ts +22 -14
  272. package/dist/modules/launcher/supervisor_control.d.ts +8 -1
  273. package/dist/modules/launcher/supervisor_control.js +4 -2
  274. package/dist/modules/lazy_shim.d.ts +11 -0
  275. package/dist/modules/lazy_shim.js +16 -0
  276. package/dist/modules/market_adapter_whitelist.d.ts +9 -3
  277. package/dist/modules/market_adapter_whitelist.js +15 -3
  278. package/dist/modules/node_connect_policy.d.ts +3 -2
  279. package/dist/modules/node_failure_ledger.d.ts +6 -5
  280. package/dist/modules/node_manager.d.ts +41 -11
  281. package/dist/modules/node_manager.js +5 -4
  282. package/dist/modules/order/accounting.d.ts +53 -24
  283. package/dist/modules/order/accounting.js +16 -15
  284. package/dist/modules/order/async_lock.d.ts +5 -2
  285. package/dist/modules/order/async_lock.js +1 -1
  286. package/dist/modules/order/export.d.ts +7 -6
  287. package/dist/modules/order/export.js +1 -7
  288. package/dist/modules/order/format.d.ts +16 -7
  289. package/dist/modules/order/format.js +15 -3
  290. package/dist/modules/order/genesis_policy.d.ts +24 -21
  291. package/dist/modules/order/genesis_policy.js +17 -10
  292. package/dist/modules/order/grid.d.ts +144 -36
  293. package/dist/modules/order/grid.js +226 -145
  294. package/dist/modules/order/grid_reconcile.d.ts +21 -20
  295. package/dist/modules/order/grid_reconcile.js +13 -12
  296. package/dist/modules/order/grid_reconcile_internal.d.ts +85 -72
  297. package/dist/modules/order/grid_reconcile_internal.js +28 -19
  298. package/dist/modules/order/index.d.ts +264 -1
  299. package/dist/modules/order/logger.d.ts +46 -19
  300. package/dist/modules/order/logger.js +38 -49
  301. package/dist/modules/order/logger_state.d.ts +4 -4
  302. package/dist/modules/order/manager.d.ts +232 -191
  303. package/dist/modules/order/manager.js +110 -130
  304. package/dist/modules/order/processed_fill_store.d.ts +18 -3
  305. package/dist/modules/order/processed_fill_store.js +16 -27
  306. package/dist/modules/order/strategy.d.ts +21 -13
  307. package/dist/modules/order/strategy.js +5 -6
  308. package/dist/modules/order/sync_engine.d.ts +91 -33
  309. package/dist/modules/order/sync_engine.js +84 -53
  310. package/dist/modules/order/utils/math.d.ts +157 -102
  311. package/dist/modules/order/utils/math.js +77 -38
  312. package/dist/modules/order/utils/order.d.ts +310 -110
  313. package/dist/modules/order/utils/order.js +153 -126
  314. package/dist/modules/order/utils/slot.d.ts +1 -1
  315. package/dist/modules/order/utils/system.d.ts +156 -26
  316. package/dist/modules/order/utils/system.js +103 -71
  317. package/dist/modules/order/utils/validate.d.ts +89 -41
  318. package/dist/modules/order/utils/validate.js +26 -24
  319. package/dist/modules/order/utils/withPoolRef.d.ts +6 -4
  320. package/dist/modules/order/utils/withPoolRef.js +18 -12
  321. package/dist/modules/order/working_grid.d.ts +14 -13
  322. package/dist/modules/paths.d.ts +1 -4
  323. package/dist/modules/paths.js +33 -61
  324. package/dist/modules/process_discovery.d.ts +1 -1
  325. package/dist/modules/process_discovery.js +2 -1
  326. package/dist/modules/runtime.d.ts +7 -3
  327. package/dist/modules/runtime.js +4 -3
  328. package/dist/modules/runtime_settings.d.ts +14 -11
  329. package/dist/modules/runtime_settings.js +30 -24
  330. package/dist/modules/settings_merge.d.ts +29 -3
  331. package/dist/modules/settings_merge.js +56 -78
  332. package/dist/modules/socket_json_client.d.ts +9 -5
  333. package/dist/modules/storage/browser_adapter.d.ts +38 -53
  334. package/dist/modules/storage/browser_adapter.js +7 -30
  335. package/dist/modules/storage/index.d.ts +1 -1
  336. package/dist/modules/storage/node_adapter.d.ts +45 -27
  337. package/dist/modules/storage/node_adapter.js +9 -9
  338. package/dist/modules/storage/types.d.ts +5 -4
  339. package/dist/modules/types.d.ts +1090 -6
  340. package/dist/modules/types.js +4 -1
  341. package/dist/modules/utils/asset_symbols.d.ts +2 -1
  342. package/dist/modules/utils/asset_symbols.js +2 -1
  343. package/dist/modules/utils/errors.d.ts +9 -0
  344. package/dist/modules/utils/errors.js +24 -4
  345. package/dist/modules/utils/time_range.d.ts +1 -12
  346. package/dist/modules/utils/time_range.js +1 -1
  347. package/dist/modules/validate_profiles.js +53 -43
  348. package/dist/modules/version_notice.d.ts +23 -11
  349. package/dist/modules/version_notice.js +6 -4
  350. package/dist/pm2.d.ts +28 -27
  351. package/dist/pm2.js +61 -40
  352. package/dist/scripts/analyze-credit.d.ts +2 -1
  353. package/dist/scripts/analyze-credit.js +23 -24
  354. package/dist/scripts/analyze-git.js +2 -15
  355. package/dist/scripts/analyze-orders.d.ts +77 -9
  356. package/dist/scripts/analyze-orders.js +65 -40
  357. package/dist/scripts/chart_command.d.ts +27 -18
  358. package/dist/scripts/chart_command.js +15 -13
  359. package/dist/scripts/check_any.d.ts +22 -0
  360. package/dist/scripts/check_any.js +158 -0
  361. package/dist/scripts/diagnose-pool-history.js +13 -13
  362. package/dist/scripts/print_grid.js +0 -1
  363. package/dist/scripts/run-tests.js +39 -8
  364. package/dist/scripts/runner.js +1 -1
  365. package/dist/scripts/sync-version.js +0 -10
  366. package/dist/scripts/test-credit-renewal.js +30 -21
  367. package/dist/scripts/update.d.ts +10 -5
  368. package/dist/scripts/update.js +168 -103
  369. package/dist/scripts/update_dist_freshness.js +1 -0
  370. package/dist/scripts/update_layout.d.ts +61 -0
  371. package/dist/scripts/update_layout.js +180 -0
  372. package/dist/scripts/validate_bots.js +2 -1
  373. package/dist/scripts/verify-browser-bundle.js +8 -0
  374. package/dist/unlock.d.ts +28 -3
  375. package/dist/unlock.js +63 -35
  376. package/docs/BITSHARES_ONBOARDING.md +10 -12
  377. package/docs/COPY_ON_WRITE_MASTER_PLAN.md +2 -2
  378. package/docs/COW_INVARIANTS.md +13 -6
  379. package/docs/DEXBOT_COMPARISON.md +8 -8
  380. package/docs/EVOLUTION.md +10 -8
  381. package/docs/FUND_MOVEMENT_AND_ACCOUNTING.md +5 -5
  382. package/docs/GRID_RECALCULATION.md +4 -2
  383. package/docs/GRID_RECONCILE.md +14 -3
  384. package/docs/LIFECYCLE.md +11 -11
  385. package/docs/MPA_CREDIT_USAGE.md +22 -3
  386. package/docs/README.md +14 -3
  387. package/docs/WORKFLOW.md +1 -0
  388. package/docs/architecture.md +31 -19
  389. package/docs/developer_guide.md +6 -6
  390. package/market_adapter/README.md +12 -5
  391. package/modules/README.md +4 -1
  392. package/package.json +9 -9
  393. package/scripts/README.md +43 -38
  394. package/tests/README.md +25 -10
  395. package/dist/scripts/diagnose-kibana-candles.d.ts +0 -3
  396. package/dist/scripts/diagnose-kibana-candles.js +0 -82
  397. package/scripts/git-viewer.sh +0 -489
  398. package/scripts/postinstall.js +0 -16
@@ -4,8 +4,9 @@ import fs from 'node:fs';
4
4
  import path from 'node:path';
5
5
  import { pathToFileURL } from 'node:url';
6
6
  import { resolveAccountRef } from './account_resolver.js';
7
- import { BTS_ID, assetPrec as getPrec, assetSymbol, resolveAssetPrecisions, toReal, } from './fills_source.js';
7
+ import { BTS_ID, assetPrec as getPrec, assetSymbol, resolveAssetPrecisions, classifyFill, matchesAssetRef, } from './fills_source.js';
8
8
  import { writePnlReport } from './pnl_report.js';
9
+ import { percentile } from './math_utils.js';
9
10
  import { fetchFillsCached } from './fills_cache.js';
10
11
  import { toFileUrl } from './chart_utils.js';
11
12
  import { PATHS } from '../modules/paths.js';
@@ -202,101 +203,39 @@ function parseArgs(argv = process.argv.slice(2)) {
202
203
  }
203
204
  // ─── Fill Classification ─────────────────────────────────────────────────────
204
205
  /**
205
- * A fill needs strictly positive, finite amounts on both legs. A zero base
206
- * amount would produce an infinite price (quoteAmount / 0) that poisons
207
- * downstream inventory lots and PnL aggregates.
206
+ * Classify fills into trade records. Direction/base/quote resolution and the
207
+ * amount sanity check live in fills_source.classifyFill (single home, also used
208
+ * by grid_correction_check); this wrapper owns the PnL-specific market-fee
209
+ * handling, the asset/pair filters and the unknown-precision skip count.
208
210
  */
209
- function isValidFillAmounts(baseAmount, quoteAmount) {
210
- return Number.isFinite(baseAmount) && Number.isFinite(quoteAmount)
211
- && baseAmount > 0 && quoteAmount > 0;
212
- }
213
- /** Match a user-supplied pair leg against a chain asset id or its symbol. */
214
- function matchesAssetRef(ref, assetId) {
215
- const want = String(ref).trim().toUpperCase();
216
- if (!want)
217
- return false;
218
- return assetId.toUpperCase() === want || assetSymbol(assetId).toUpperCase() === want;
219
- }
220
211
  function classifyFills(fills, filterAsset, pairFilter = null) {
221
212
  const trades = [];
222
213
  const pairs = new Set();
223
214
  let skipped = 0;
224
215
  for (const f of fills) {
225
- const pAsset = f.pays.asset_id;
226
- const rAsset = f.receives.asset_id;
227
- let direction;
228
- let baseAsset;
229
- let quoteAsset;
230
- let baseAmount;
231
- let quoteAmount;
232
- let price;
233
- let marketFeeReal;
234
- let marketFeeAsset;
216
+ const c = classifyFill(f);
217
+ if (!c) {
218
+ skipped++;
219
+ continue;
220
+ }
221
+ // Market fee is always deducted from receives; an unknown fee asset
222
+ // precision makes the fee (and therefore net PnL) uncomputable.
235
223
  const feePrec = getPrec(f.fee.asset_id);
236
224
  if (feePrec === undefined || isNaN(f.fee.amount)) {
237
225
  skipped++;
238
226
  continue;
239
227
  }
240
- const feeReal = f.fee.amount / Math.pow(10, feePrec);
241
- if (pAsset === BTS_ID && rAsset !== BTS_ID) {
242
- direction = 'buy';
243
- baseAsset = rAsset;
244
- quoteAsset = BTS_ID;
245
- baseAmount = toReal(f.receives.amount, rAsset);
246
- quoteAmount = toReal(f.pays.amount, BTS_ID);
247
- if (!isValidFillAmounts(baseAmount, quoteAmount)) {
248
- skipped++;
249
- continue;
250
- }
251
- price = quoteAmount / baseAmount;
252
- marketFeeReal = feeReal;
253
- marketFeeAsset = f.fee.asset_id;
254
- }
255
- else if (rAsset === BTS_ID && pAsset !== BTS_ID) {
256
- direction = 'sell';
257
- baseAsset = pAsset;
258
- quoteAsset = BTS_ID;
259
- baseAmount = toReal(f.pays.amount, pAsset);
260
- quoteAmount = toReal(f.receives.amount, BTS_ID);
261
- if (!isValidFillAmounts(baseAmount, quoteAmount)) {
262
- skipped++;
263
- continue;
264
- }
265
- price = quoteAmount / baseAmount;
266
- marketFeeReal = feeReal;
267
- marketFeeAsset = f.fee.asset_id;
268
- }
269
- else {
270
- // Non-BTS cross-pair: use consistent ordering (lower asset ID = base)
271
- const baseForCheck = pAsset < rAsset ? pAsset : rAsset;
272
- const quoteForCheck = pAsset < rAsset ? rAsset : pAsset;
273
- // Skip if either asset precision is unknown
274
- if (getPrec(baseForCheck) === undefined || getPrec(quoteForCheck) === undefined) {
275
- skipped++;
276
- continue;
277
- }
278
- const isSell = pAsset < rAsset;
279
- direction = isSell ? 'sell' : 'buy';
280
- baseAsset = isSell ? pAsset : rAsset;
281
- quoteAsset = isSell ? rAsset : pAsset;
282
- baseAmount = toReal(isSell ? f.pays.amount : f.receives.amount, baseAsset);
283
- quoteAmount = toReal(isSell ? f.receives.amount : f.pays.amount, quoteAsset);
284
- if (!isValidFillAmounts(baseAmount, quoteAmount)) {
285
- skipped++;
286
- continue;
287
- }
288
- price = quoteAmount / baseAmount;
289
- marketFeeReal = feeReal;
290
- marketFeeAsset = f.fee.asset_id;
291
- }
228
+ const marketFeeReal = f.fee.amount / Math.pow(10, feePrec);
229
+ const marketFeeAsset = f.fee.asset_id;
230
+ const { direction, baseAsset, quoteAsset, baseAmount, quoteAmount, price } = c;
292
231
  if (filterAsset && baseAsset !== filterAsset)
293
232
  continue;
294
233
  if (pairFilter && !(matchesAssetRef(pairFilter.base, baseAsset) && matchesAssetRef(pairFilter.quote, quoteAsset)))
295
234
  continue;
296
235
  // Validate market fee asset: fee is always deducted from receives
297
236
  // (base for buys, quote for sells). Warn if unexpected.
298
- if (marketFeeReal > 0 && marketFeeAsset !== '' && marketFeeAsset !== rAsset) {
299
- console.warn(` [warn] Fill ${f.orderId}: fee asset ${marketFeeAsset} ≠ receives asset ${rAsset}. Market fee PnL may be incorrect.`);
237
+ if (marketFeeReal > 0 && marketFeeAsset !== '' && marketFeeAsset !== f.receives.asset_id) {
238
+ console.warn(` [warn] Fill ${f.orderId}: fee asset ${marketFeeAsset} ≠ receives asset ${f.receives.asset_id}. Market fee PnL may be incorrect.`);
300
239
  }
301
240
  const pairKey = `${baseAsset}:${quoteAsset}`;
302
241
  pairs.add(pairKey);
@@ -475,7 +414,7 @@ function analyzePair(trades, matchMode = 'sequential') {
475
414
  };
476
415
  }
477
416
  // ─── Output Helpers ──────────────────────────────────────────────────────────
478
- function fmt(n, _decimals = 4) {
417
+ function fmt(n) {
479
418
  // Shared 4-significant-figure formatter (see modules/order/format.ts) so
480
419
  // terminal output matches the HTML report and `dexbot order`.
481
420
  return Number.isFinite(n) ? formatFundsValue(n) : 'NaN';
@@ -488,7 +427,18 @@ function fmtPct(n) {
488
427
  function fmtAsset(id) {
489
428
  return assetSymbol(id);
490
429
  }
491
- function printSummary(pairs, _accountId, _start, _end, _matchMode = 'sequential') {
430
+ /** Group pairs by quote asset for the grand-total sections. */
431
+ function groupPairsByQuote(pairs) {
432
+ const quoteGroups = new Map();
433
+ for (const p of pairs) {
434
+ const q = p.quoteAsset;
435
+ if (!quoteGroups.has(q))
436
+ quoteGroups.set(q, []);
437
+ quoteGroups.get(q).push(p);
438
+ }
439
+ return quoteGroups;
440
+ }
441
+ function printSummary(pairs) {
492
442
  console.log('');
493
443
  for (const pair of pairs) {
494
444
  const pairLabel = `${fmtAsset(pair.baseAsset)}/${fmtAsset(pair.quoteAsset)}`;
@@ -497,36 +447,30 @@ function printSummary(pairs, _accountId, _start, _end, _matchMode = 'sequential'
497
447
  const avgBuy = pair.totalBuyBase > 0 ? pair.totalBuyQuote / pair.totalBuyBase : 0;
498
448
  const avgSell = pair.totalSellBase > 0 ? pair.totalSellQuote / pair.totalSellBase : 0;
499
449
  console.log(` ── ${pairLabel}`);
500
- console.log(` Buys: ${fmt(totalBought, 4)} @ ${fmt(avgBuy, 6)} = ${fmt(pair.totalBuyQuote, 4)} ${fmtAsset(pair.quoteAsset)}`);
501
- console.log(` Sells: ${fmt(totalSold, 4)} @ ${fmt(avgSell, 6)} = ${fmt(pair.totalSellQuote, 4)} ${fmtAsset(pair.quoteAsset)}`);
502
- console.log(` Net inventory \u0394: ${fmt(pair.netPosition, 4)} ${fmtAsset(pair.baseAsset)} (bought \u2212 sold in window)`);
450
+ console.log(` Buys: ${fmt(totalBought)} @ ${fmt(avgBuy)} = ${fmt(pair.totalBuyQuote)} ${fmtAsset(pair.quoteAsset)}`);
451
+ console.log(` Sells: ${fmt(totalSold)} @ ${fmt(avgSell)} = ${fmt(pair.totalSellQuote)} ${fmtAsset(pair.quoteAsset)}`);
452
+ console.log(` Net inventory \u0394: ${fmt(pair.netPosition)} ${fmtAsset(pair.baseAsset)} (bought \u2212 sold in window)`);
503
453
  console.log(` Trades: ${pair.realizedPnls.length} realized lots, ${pair.buys.length} buys, ${pair.sells.length} sells`);
504
454
  if (pair.unmatchedSellBase > 0.0001) {
505
- console.log(` Unmatched: ${fmt(pair.unmatchedSellBase, 4)} ${fmtAsset(pair.baseAsset)} (sold without prior buy in window — expected if inventory predates window)`);
455
+ console.log(` Unmatched: ${fmt(pair.unmatchedSellBase)} ${fmtAsset(pair.baseAsset)} (sold without prior buy in window — expected if inventory predates window)`);
506
456
  }
507
- console.log(` Gross PnL: ${fmtAsset(pair.quoteAsset)} ${fmt(pair.totalRealizedPnl, 4)}`);
457
+ console.log(` Gross PnL: ${fmtAsset(pair.quoteAsset)} ${fmt(pair.totalRealizedPnl)}`);
508
458
  const mktFee = pair.totalMarketFees;
509
459
  const blkFee = pair.totalBlockchainFees;
510
460
  if (mktFee > 0.0001) {
511
- console.log(` Market fees: ${fmtAsset(pair.quoteAsset)} ${fmt(-mktFee, 4)}`);
461
+ console.log(` Market fees: ${fmtAsset(pair.quoteAsset)} ${fmt(-mktFee)}`);
512
462
  }
513
463
  if (blkFee > 0.0001) {
514
- console.log(` Blockchain: BTS ${fmt(-blkFee, 4)}`);
464
+ console.log(` Blockchain: BTS ${fmt(-blkFee)}`);
515
465
  }
516
- console.log(` Net PnL: ${fmtAsset(pair.quoteAsset)} ${fmt(pair.totalRealizedPnlNet, 4)}`);
466
+ console.log(` Net PnL: ${fmtAsset(pair.quoteAsset)} ${fmt(pair.totalRealizedPnlNet)}`);
517
467
  if (pair.quoteAsset !== BTS_ID) {
518
468
  console.log(` ⚠ Non-BTS quote — PnL is in ${fmtAsset(pair.quoteAsset)}, not BTS`);
519
469
  }
520
470
  console.log('');
521
471
  }
522
472
  // Grand totals grouped by quote asset
523
- const quoteGroups = new Map();
524
- for (const p of pairs) {
525
- const q = p.quoteAsset;
526
- if (!quoteGroups.has(q))
527
- quoteGroups.set(q, []);
528
- quoteGroups.get(q).push(p);
529
- }
473
+ const quoteGroups = groupPairsByQuote(pairs);
530
474
  if (pairs.length > 1 && quoteGroups.size > 0) {
531
475
  for (const [quoteAsset, group] of quoteGroups) {
532
476
  const groupPnl = group.reduce((s, p) => s + p.totalRealizedPnl, 0);
@@ -536,15 +480,15 @@ function printSummary(pairs, _accountId, _start, _end, _matchMode = 'sequential'
536
480
  const groupVol = group.reduce((s, p) => s + p.totalBuyQuote + p.totalSellQuote, 0);
537
481
  const qSymbol = fmtAsset(quoteAsset);
538
482
  console.log(` ── TOTAL (${qSymbol}) — ${group.length} pair(s)`);
539
- console.log(` Gross PnL: ${fmtAsset(quoteAsset)} ${fmt(groupPnl, 4)}`);
483
+ console.log(` Gross PnL: ${fmtAsset(quoteAsset)} ${fmt(groupPnl)}`);
540
484
  if (groupMktFees > 0.0001) {
541
- console.log(` Market fees: ${fmtAsset(quoteAsset)} ${fmt(-groupMktFees, 4)}`);
485
+ console.log(` Market fees: ${fmtAsset(quoteAsset)} ${fmt(-groupMktFees)}`);
542
486
  }
543
487
  if (groupBlkFees > 0.0001) {
544
- console.log(` Blockchain: BTS ${fmt(-groupBlkFees, 4)}`);
488
+ console.log(` Blockchain: BTS ${fmt(-groupBlkFees)}`);
545
489
  }
546
- console.log(` Net PnL: ${fmtAsset(quoteAsset)} ${fmt(groupNet, 4)}`);
547
- console.log(` Volume: ${fmt(groupVol, 4)} ${qSymbol}`);
490
+ console.log(` Net PnL: ${fmtAsset(quoteAsset)} ${fmt(groupNet)}`);
491
+ console.log(` Volume: ${fmt(groupVol)} ${qSymbol}`);
548
492
  console.log('');
549
493
  }
550
494
  }
@@ -572,15 +516,15 @@ function printPnlDetail(pairs) {
572
516
  for (let i = 0; i < pair.realizedPnls.length; i++) {
573
517
  const r = pair.realizedPnls[i];
574
518
  const idx = String(i + 1).padStart(2);
575
- const bp = fmt(r.buyPrice, 8).padStart(11);
576
- const ep = fmt(r.effPrice, 8).padStart(11);
577
- const sp = fmt(r.sellPrice, 8).padStart(11);
578
- const amt = fmt(r.amount, 4).padStart(9);
579
- const pnlStr = fmt(r.pnl, 6).padStart(9);
519
+ const bp = fmt(r.buyPrice).padStart(11);
520
+ const ep = fmt(r.effPrice).padStart(11);
521
+ const sp = fmt(r.sellPrice).padStart(11);
522
+ const amt = fmt(r.amount).padStart(9);
523
+ const pnlStr = fmt(r.pnl).padStart(9);
580
524
  const pctStr = fmtPct(r.pnlPct).padStart(8);
581
- const mktFeeStr = fmt(r.marketFeeEntry + r.marketFeeExit, 4).padStart(8);
582
- const feeStr = fmt(r.feeBts, 4).padStart(8);
583
- const netStr = fmt(r.pnlNet, 6).padStart(10);
525
+ const mktFeeStr = fmt(r.marketFeeEntry + r.marketFeeExit).padStart(8);
526
+ const feeStr = fmt(r.feeBts).padStart(8);
527
+ const netStr = fmt(r.pnlNet).padStart(10);
584
528
  const netPctStr = fmtPct(r.pnlNetPct).padStart(8);
585
529
  const mk = (r.entryIsMaker ? 'M' : 'T') + '/' + (r.exitIsMaker ? 'M' : 'T') + ' ';
586
530
  const et = (r.entryTime || '').slice(0, 22).padEnd(22);
@@ -590,19 +534,6 @@ function printPnlDetail(pairs) {
590
534
  console.log('');
591
535
  }
592
536
  }
593
- function percentile(sorted, p) {
594
- const n = sorted.length;
595
- if (n === 0)
596
- return 0;
597
- if (n === 1)
598
- return sorted[0];
599
- const k = (p / 100) * (n - 1);
600
- const f = Math.floor(k);
601
- const c = Math.ceil(k);
602
- if (f === c)
603
- return sorted[f];
604
- return sorted[f] * (c - k) + sorted[c] * (k - f);
605
- }
606
537
  function computeMetrics(pair, window) {
607
538
  const pnls = pair.realizedPnls;
608
539
  const total = pnls.length;
@@ -752,7 +683,7 @@ function computeMetrics(pair, window) {
752
683
  ? fillCounts.reduce((a, b) => Math.max(a, b), 0)
753
684
  : 0;
754
685
  const sortedCounts = [...fillCounts].sort((a, b) => a - b);
755
- const fillsPerOrderMedian = sellOrdersFilled > 0 ? percentile(sortedCounts, 50) : 0;
686
+ const fillsPerOrderMedian = sellOrdersFilled > 0 ? percentile(sortedCounts, 50, { sorted: true, empty: 0 }) : 0;
756
687
  const oneShotOrderRatio = sellOrdersFilled > 0
757
688
  ? fillCounts.filter(c => c === 1).length / sellOrdersFilled
758
689
  : 0;
@@ -885,15 +816,15 @@ function computeMetrics(pair, window) {
885
816
  }
886
817
  // Payoff distribution stats
887
818
  const pnlPcts = [...pnls.map(r => r.pnlPct)].sort((a, b) => a - b);
888
- const medianPnlPct = percentile(pnlPcts, 50);
889
- const p25PnlPct = percentile(pnlPcts, 25);
890
- const p75PnlPct = percentile(pnlPcts, 75);
819
+ const medianPnlPct = percentile(pnlPcts, 50, { sorted: true, empty: 0 });
820
+ const p25PnlPct = percentile(pnlPcts, 25, { sorted: true, empty: 0 });
821
+ const p75PnlPct = percentile(pnlPcts, 75, { sorted: true, empty: 0 });
891
822
  const absAvgLoss = Math.abs(avgLoss);
892
823
  let rValues = [];
893
824
  if (absAvgLoss > 0) {
894
825
  rValues = pnls.map(r => r.pnl / absAvgLoss).sort((a, b) => a - b);
895
826
  }
896
- const medianR = rValues.length > 0 ? percentile(rValues, 50) : 0;
827
+ const medianR = rValues.length > 0 ? percentile(rValues, 50, { sorted: true, empty: 0 }) : 0;
897
828
  const pctRGreater1 = rValues.length > 0 ? rValues.filter(r => r > 1).length / rValues.length : 0;
898
829
  const pctRGreater2 = rValues.length > 0 ? rValues.filter(r => r > 2).length / rValues.length : 0;
899
830
  const pctRLessNeg1 = rValues.length > 0 ? rValues.filter(r => r < -1).length / rValues.length : 0;
@@ -962,15 +893,15 @@ function printMetrics(pairs, window) {
962
893
  // Edge
963
894
  console.log(` Win Rate: ${(m.winRate * 100).toFixed(1)}%`);
964
895
  console.log(` Profit Factor: ${m.profitFactor === Infinity ? '∞' : m.profitFactor.toFixed(2)}`);
965
- const mktFeeStr = pair.totalMarketFees > 0.0001 ? ` (market ${fmt(pair.totalMarketFees, 4)})` : '';
966
- const blkFeeStr = pair.totalBlockchainFees > 0.0001 ? ` (op ${fmt(pair.totalBlockchainFees, 4)} BTS)` : '';
896
+ const mktFeeStr = pair.totalMarketFees > 0.0001 ? ` (market ${fmt(pair.totalMarketFees)})` : '';
897
+ const blkFeeStr = pair.totalBlockchainFees > 0.0001 ? ` (op ${fmt(pair.totalBlockchainFees)} BTS)` : '';
967
898
  console.log(` Fee Drag: ${m.feeDragPct > 0 ? m.feeDragPct.toFixed(2) + '% of gross profit' + mktFeeStr + blkFeeStr : '—'}`);
968
899
  console.log(` Avg Win / Avg Loss: ${m.avgWinLossRatio === Infinity ? '∞' : m.avgWinLossRatio.toFixed(2)}`);
969
900
  const qSymbol = fmtAsset(pair.quoteAsset);
970
- console.log(` Expectancy (gross): ${fmt(m.expectancyBts, 4)} ${qSymbol} (${fmtPct(m.expectancyPct)}) per trade`);
901
+ console.log(` Expectancy (gross): ${fmt(m.expectancyBts)} ${qSymbol} (${fmtPct(m.expectancyPct)}) per trade`);
971
902
  const rDisplay = m.expectancyR === Infinity ? '∞' : m.expectancyR.toFixed(3) + 'R';
972
903
  console.log(` Expectancy (R): ${rDisplay}`);
973
- console.log(` Expectancy (net): ${fmt(m.netExpectancyBts, 4)} ${qSymbol} per trade`);
904
+ console.log(` Expectancy (net): ${fmt(m.netExpectancyBts)} ${qSymbol} per trade`);
974
905
  console.log('');
975
906
  // Edge quality
976
907
  console.log(` Median R: ${m.medianR.toFixed(2)}`);
@@ -995,14 +926,14 @@ function printMetrics(pairs, window) {
995
926
  const spanStr = m.scoredSpanDays < m.periodSpanDays - 1e-9
996
927
  ? `${m.scoredSpanDays.toFixed(1)}d scored of ${m.periodSpanDays.toFixed(1)}d window`
997
928
  : `${m.periodSpanDays.toFixed(1)}d`;
998
- console.log(` Projected net PnL: ${fmt(m.projectedNetPnlAnn, 2)} ${qSymbol}/yr (${fmt(m.projectedNetPnlPerDay, 2)}/day over ${spanStr})`);
929
+ console.log(` Projected net PnL: ${fmt(m.projectedNetPnlAnn)} ${qSymbol}/yr (${fmt(m.projectedNetPnlPerDay)}/day over ${spanStr})`);
999
930
  console.log('');
1000
931
  // Tail risk
1001
932
  if (m.mddHadStablePeak) {
1002
- console.log(` Max Drawdown: ${fmt(m.mddAbsBts, 4)} ${qSymbol} (${fmtPct(m.mddPct)} of peak cumulative profit)`);
933
+ console.log(` Max Drawdown: ${fmt(m.mddAbsBts)} ${qSymbol} (${fmtPct(m.mddPct)} of peak cumulative profit)`);
1003
934
  }
1004
935
  else {
1005
- console.log(` Min Equity: ${fmt(m.prePeakMinEquity, 4)} ${fmtAsset(pair.quoteAsset)}`);
936
+ console.log(` Min Equity: ${fmt(m.prePeakMinEquity)} ${fmtAsset(pair.quoteAsset)}`);
1006
937
  }
1007
938
  const recLabel = m.maxRecoveryDays > 0 ? m.maxRecoveryDays.toFixed(1) + ' days' + (m.isOngoingRecovery ? ' (ongoing)' : '') : '—';
1008
939
  console.log(` Max Recovery Time: ${recLabel}`);
@@ -1021,17 +952,11 @@ function printMetrics(pairs, window) {
1021
952
  console.log(` Partial fills/order: ${m.fillsPerOrderMean.toFixed(2)} mean, ${m.fillsPerOrderMedian.toFixed(1)} med, ${m.fillsPerOrderMax} max`);
1022
953
  console.log(` One-shot orders: ${(m.oneShotOrderRatio * 100).toFixed(0)}%`);
1023
954
  console.log(` Fills/day: ${m.fillsPerDay.toFixed(2)}`);
1024
- console.log(` Avg vol/day: ${fmt(m.avgVolumePerDay, 2)} ${fmtAsset(pair.quoteAsset)}`);
955
+ console.log(` Avg vol/day: ${fmt(m.avgVolumePerDay)} ${fmtAsset(pair.quoteAsset)}`);
1025
956
  console.log('');
1026
957
  }
1027
958
  // Grand totals grouped by quote asset
1028
- const quoteGroups = new Map();
1029
- for (const p of pairs) {
1030
- const q = p.quoteAsset;
1031
- if (!quoteGroups.has(q))
1032
- quoteGroups.set(q, []);
1033
- quoteGroups.get(q).push(p);
1034
- }
959
+ const quoteGroups = groupPairsByQuote(pairs);
1035
960
  if (pairs.length > 1 && quoteGroups.size > 0) {
1036
961
  for (const [quoteAsset, group] of quoteGroups) {
1037
962
  const totalLots = group.reduce((s, p) => s + p.realizedPnls.length, 0);
@@ -1043,11 +968,11 @@ function printMetrics(pairs, window) {
1043
968
  console.log(` Lots: ${totalLots}`);
1044
969
  const feeParts = [];
1045
970
  if (totalMktFees > 0.0001)
1046
- feeParts.push(`market ${fmt(totalMktFees, 4)} ${qSymbol}`);
971
+ feeParts.push(`market ${fmt(totalMktFees)} ${qSymbol}`);
1047
972
  if (totalBlkFees > 0.0001)
1048
- feeParts.push(`op ${fmt(totalBlkFees, 4)} BTS`);
973
+ feeParts.push(`op ${fmt(totalBlkFees)} BTS`);
1049
974
  const feeSuffix = feeParts.length > 0 ? ` (${feeParts.join(', ')})` : '';
1050
- console.log(` Net PnL: ${fmtAsset(quoteAsset)} ${fmt(totalNet, 4)}${feeSuffix}`);
975
+ console.log(` Net PnL: ${fmtAsset(quoteAsset)} ${fmt(totalNet)}${feeSuffix}`);
1051
976
  console.log('');
1052
977
  }
1053
978
  }
@@ -1133,7 +1058,8 @@ function normalizeTimeBound(raw, isEnd) {
1133
1058
  /** Auto-named report file: bot/account + pair filter + requested range. */
1134
1059
  function reportFileName(opts, accountRef, botName) {
1135
1060
  const slugBase = botName ? sanitizeKey(botName) : sanitizeKey(accountRef);
1136
- const pairSlug = opts.pair ? `_${sanitizeKey(opts.pair.base)}-${sanitizeKey(opts.pair.quote)}` : '';
1061
+ const pair = opts.pair;
1062
+ const pairSlug = pair ? `_${sanitizeKey(pair.base)}-${sanitizeKey(pair.quote)}` : '';
1137
1063
  let rangeSlug;
1138
1064
  if (opts.months != null)
1139
1065
  rangeSlug = `_${String(opts.months).replace('.', 'p')}m`;
@@ -1253,7 +1179,7 @@ async function run(argv = process.argv.slice(2)) {
1253
1179
  }
1254
1180
  else {
1255
1181
  // Output: summaries → grand total → per-match detail
1256
- printSummary(analyses, accountId, gte, lte, opts.matchMode);
1182
+ printSummary(analyses);
1257
1183
  if (opts.showPnlDetail) {
1258
1184
  printPnlDetail(analyses);
1259
1185
  }
@@ -3,8 +3,8 @@ declare function parseArgs(): {
3
3
  source: {
4
4
  type: string;
5
5
  config: {
6
- filePath: any;
7
- botKey?: any;
6
+ filePath?: string;
7
+ botKey?: string;
8
8
  };
9
9
  };
10
10
  chartFile: string;
@@ -30,11 +30,6 @@ declare function parseArgs(): {
30
30
  quiet: boolean;
31
31
  listBots: boolean;
32
32
  };
33
- declare function loadJsonMeta(filePath: any): {
34
- candles: any;
35
- meta: any;
36
- };
37
- declare function inferTitle(meta: any, fallback: string): string;
38
33
  declare function main(): Promise<void>;
39
- export { main, parseArgs, loadJsonMeta, inferTitle };
34
+ export { main, parseArgs };
40
35
  //# sourceMappingURL=analyze_tradingview.d.ts.map
@@ -201,7 +201,7 @@ function inferTitle(meta, fallback) {
201
201
  const b = meta?.assetB?.symbol || meta?.assetB?.id || null;
202
202
  const pair = a && b ? `${a}/${b}` : fallback;
203
203
  const label = pool || pair;
204
- const interval = Number(meta?.intervalSeconds) > 0 ? toIntervalLabel(meta.intervalSeconds) : '1h';
204
+ const interval = Number(meta?.intervalSeconds) > 0 ? toIntervalLabel(Number(meta?.intervalSeconds)) : '1h';
205
205
  return `${label} · ${interval} · TradingView`;
206
206
  }
207
207
  async function main() {
@@ -237,15 +237,16 @@ async function main() {
237
237
  // Bot grid bounds for the range highlight: mirrors the runtime grid
238
238
  // (center = AMA, min "Nx" = center/N, max "Nx" = center*N) with the
239
239
  // live asymmetric tilt. Null when no bot key (width% fallback in-page).
240
+ const asym = botMeta?.asymmetricBounds;
240
241
  const grid = botMeta?.minPrice != null && botMeta?.maxPrice != null ? {
241
242
  minPrice: botMeta.minPrice,
242
243
  maxPrice: botMeta.maxPrice,
243
244
  incrementPercent: Number(botMeta.incrementPercent) > 0 ? Number(botMeta.incrementPercent) : null,
244
- maxAsymmetryFactor: Number.isFinite(Number(botMeta?.asymmetricBounds?.maxAsymmetryFactor))
245
- ? Number(botMeta.asymmetricBounds.maxAsymmetryFactor)
245
+ maxAsymmetryFactor: Number.isFinite(Number(asym?.maxAsymmetryFactor))
246
+ ? Number(asym?.maxAsymmetryFactor)
246
247
  : null,
247
- minScaleSlots: Number.isFinite(Number(botMeta?.asymmetricBounds?.minScaleSlots))
248
- ? Number(botMeta.asymmetricBounds.minScaleSlots)
248
+ minScaleSlots: Number.isFinite(Number(asym?.minScaleSlots))
249
+ ? Number(asym?.minScaleSlots)
249
250
  : null,
250
251
  } : null;
251
252
  // Order overlay (canonical profiles/orders/<botKey>.json; silent when absent)
@@ -323,5 +324,5 @@ async function main() {
323
324
  }
324
325
  }
325
326
  main().catch((err) => { console.error(err); process.exit(1); });
326
- export { main, parseArgs, loadJsonMeta, inferTitle };
327
+ export { main, parseArgs };
327
328
  //# sourceMappingURL=analyze_tradingview.js.map
@@ -5,23 +5,32 @@
5
5
  * @param {Object|null} input.ama Resolved AMA config (er/fast/slow) the chart runs with.
6
6
  * @param {Object} [input.overrides] CLI overrides {priceDeltaThresholdPercent, slopeDeltaThresholdPercent, enabled}.
7
7
  */
8
- declare function resolveGridResetSimConfig({ botKey, bot, ama, overrides }?: any): {
8
+ declare function resolveGridResetSimConfig({ botKey, bot, ama, overrides }?: {
9
+ botKey?: string | null;
10
+ bot?: Record<string, unknown> | null;
11
+ ama?: {
12
+ erPeriod?: number;
13
+ fastPeriod?: number;
14
+ slowPeriod?: number;
15
+ } | null;
16
+ overrides?: Record<string, unknown>;
17
+ }): {
9
18
  enabled: boolean;
10
- botKey: any;
11
- priceDeltaThresholdPercent: any;
12
- priceSource: any;
13
- slopeDeltaThresholdPercent: any;
14
- slopeSource: any;
19
+ botKey: string | null;
20
+ priceDeltaThresholdPercent: number;
21
+ priceSource: string;
22
+ slopeDeltaThresholdPercent: number;
23
+ slopeSource: string;
15
24
  slopeEnabled: boolean;
16
25
  dynamicWeightEnabled: boolean;
17
- lookbackBars: any;
26
+ lookbackBars: number;
18
27
  slopePersistBars: number;
19
- maxSlopePct: any;
28
+ maxSlopePct: number;
20
29
  neutralZonePct: number;
21
- maxSlopeOffset: any;
30
+ maxSlopeOffset: number;
22
31
  clipPercentile: number;
23
- maxAsymmetryFactor: any;
24
- minScaleSlots: any;
32
+ maxAsymmetryFactor: number;
33
+ minScaleSlots: number;
25
34
  incrementPercent: number | null;
26
35
  erPeriod: number;
27
36
  warmupBars: number;
@@ -34,30 +43,30 @@ declare function resolveGridResetSimConfig({ botKey, bot, ama, overrides }?: any
34
43
  * Flatten the resolved config for the chart payload, dropping anything the page
35
44
  * must not see (e.g. Infinity from a disabled threshold).
36
45
  */
37
- declare function toGridSimPayload(cfg: any): {
46
+ declare function toGridSimPayload(cfg: Record<string, unknown> | null): {
38
47
  enabled: boolean;
39
- botKey: any;
40
- priceDeltaThresholdPercent: any;
41
- priceSource: any;
42
- slopeDeltaThresholdPercent: any;
43
- slopeSource: any;
48
+ botKey: {} | null;
49
+ priceDeltaThresholdPercent: unknown;
50
+ priceSource: {};
51
+ slopeDeltaThresholdPercent: unknown;
52
+ slopeSource: {};
44
53
  slopeEnabled: boolean;
45
54
  dynamicWeightEnabled: boolean;
46
- lookbackBars: any;
47
- slopePersistBars: any;
48
- maxSlopePct: any;
49
- neutralZonePct: any;
50
- maxSlopeOffset: any;
51
- clipPercentile: any;
52
- maxAsymmetryFactor: any;
53
- minScaleSlots: any;
54
- incrementPercent: any;
55
- erPeriod: any;
56
- warmupBars: any;
57
- warmupBarsOverride: any;
58
- clampMin: any;
59
- clampMax: any;
60
- notes: any;
55
+ lookbackBars: unknown;
56
+ slopePersistBars: unknown;
57
+ maxSlopePct: unknown;
58
+ neutralZonePct: unknown;
59
+ maxSlopeOffset: unknown;
60
+ clipPercentile: unknown;
61
+ maxAsymmetryFactor: unknown;
62
+ minScaleSlots: unknown;
63
+ incrementPercent: unknown;
64
+ erPeriod: unknown;
65
+ warmupBars: unknown;
66
+ warmupBarsOverride: unknown;
67
+ clampMin: unknown;
68
+ clampMax: unknown;
69
+ notes: any[];
61
70
  } | null;
62
71
  export { resolveGridResetSimConfig, toGridSimPayload };
63
72
  //# sourceMappingURL=grid_reset_config.d.ts.map
@@ -93,8 +93,11 @@ function resolveGridResetSimConfig({ botKey, bot, ama, overrides } = {}) {
93
93
  // ── 2. market_adapter_settings.json (globals → pair → bot)
94
94
  const botCfg = bot ? resolveBotCfg(bot, baseCfg) : baseCfg;
95
95
  const settings = loadMarketAdapterSettings();
96
- const pair = bot ? findPairForBot(bot, settings?.pairs) : null;
97
- const botOverride = pair?.botOverrides?.[bot?.name] || null;
96
+ const pair = bot ? findPairForBot(bot, Array.isArray(settings?.pairs) ? settings.pairs : []) : null;
97
+ const pairObj = pair;
98
+ const botOverride = pairObj?.botOverrides
99
+ ? (pairObj.botOverrides[String(bot?.name)] || null)
100
+ : null;
98
101
  const layers = [
99
102
  { name: SOURCE_ADAPTER_BOT, value: botOverride, keys: [['deltaThresholdPercent']] },
100
103
  { name: SOURCE_ADAPTER_PAIR, value: pair?.marketAdapterSettings, keys: [['deltaThresholdPercent']] },
@@ -147,12 +150,21 @@ function resolveGridResetSimConfig({ botKey, bot, ama, overrides } = {}) {
147
150
  // adapter service so the chart replay fires the same Δs resets production
148
151
  // does. Per-bot override wins; else the global enable + value; else legacy 1.
149
152
  const resolveSlopePersistBars = () => {
150
- const explicit = Number(botCfg?.amaSlope?.persistBars ?? botCfg?.amaSlopePersistBars);
151
- if (Number.isFinite(explicit) && explicit >= 1)
152
- return Math.round(explicit);
153
- const enabled = botCfg?.amaSlope?.persistEnabled === true
154
- || botCfg?.amaSlopePersistEnabled === true
155
- || MARKET_ADAPTER.AMA_SLOPE_PERSIST_ENABLED === true;
153
+ // Mirror resolveAmaSlopePersistBars (market_adapter_service): explicit
154
+ // `persistBars >= 1` wins, `0` disables, and `persistEnabled: false` is a
155
+ // real tri-state override that must beat the global `true`.
156
+ const rawBars = botCfg?.amaSlope?.persistBars ?? botCfg?.amaSlopePersistBars;
157
+ const explicit = (rawBars === null || rawBars === undefined) ? NaN : Number(rawBars);
158
+ if (Number.isFinite(explicit)) {
159
+ if (explicit >= 1)
160
+ return Math.round(explicit);
161
+ if (explicit === 0)
162
+ return 1;
163
+ }
164
+ const override = botCfg?.amaSlope?.persistEnabled ?? botCfg?.amaSlopePersistEnabled;
165
+ const enabled = override === false ? false
166
+ : override === true ? true
167
+ : MARKET_ADAPTER.AMA_SLOPE_PERSIST_ENABLED === true;
156
168
  if (!enabled)
157
169
  return 1;
158
170
  const bars = Number(MARKET_ADAPTER.AMA_SLOPE_PERSIST_BARS);
@@ -177,7 +189,7 @@ function resolveGridResetSimConfig({ botKey, bot, ama, overrides } = {}) {
177
189
  return null;
178
190
  try {
179
191
  const bound = resolveConfiguredPriceBound(raw, fallback, 1, mode);
180
- return Number.isFinite(bound) && bound > 0 ? Number(bound) : null;
192
+ return bound != null && Number.isFinite(bound) && bound > 0 ? Number(bound) : null;
181
193
  }
182
194
  catch (_err) {
183
195
  return null;
@@ -198,7 +210,7 @@ function resolveGridResetSimConfig({ botKey, bot, ama, overrides } = {}) {
198
210
  slopePersistBars: resolveSlopePersistBars(),
199
211
  maxSlopePct: firstPositive([botCfg?.amaSlope?.maxSlopePct], MARKET_ADAPTER.DYNAMIC_WEIGHT_AMA_MAX_SLOPE_PCT),
200
212
  neutralZonePct: Number.isFinite(Number(botCfg?.amaSlope?.neutralZonePct))
201
- ? Number(botCfg.amaSlope.neutralZonePct)
213
+ ? Number(botCfg?.amaSlope?.neutralZonePct)
202
214
  : MARKET_ADAPTER.DYNAMIC_WEIGHT_AMA_NEUTRAL_ZONE_PCT,
203
215
  maxSlopeOffset: firstPositive([botCfg?.maxSlopeOffset], MARKET_ADAPTER.DYNAMIC_WEIGHT_ASYMMETRIC_OFFSET_CLAMP),
204
216
  clipPercentile: Number.isFinite(Number(botCfg?.clipPercentile))
@@ -206,7 +218,7 @@ function resolveGridResetSimConfig({ botKey, bot, ama, overrides } = {}) {
206
218
  : MARKET_ADAPTER.DYNAMIC_WEIGHT_CLIP_PERCENTILE,
207
219
  maxAsymmetryFactor: firstPositive([bot?.asymmetricBounds?.maxAsymmetryFactor, botCfg?.asymmetricBounds?.maxAsymmetryFactor], MARKET_ADAPTER.ASYMMETRIC_BOUNDS_MAX_ASYMMETRY_FACTOR),
208
220
  minScaleSlots: firstPositive([botCfg?.asymmetricBounds?.minScaleSlots], MARKET_ADAPTER.ASYMMETRIC_BOUNDS_MIN_SCALE_SLOTS),
209
- incrementPercent: Number.isFinite(Number(bot?.incrementPercent)) ? Number(bot.incrementPercent) : null,
221
+ incrementPercent: Number.isFinite(Number(bot?.incrementPercent)) ? Number(bot?.incrementPercent) : null,
210
222
  erPeriod: Math.ceil(erPeriod),
211
223
  warmupBars,
212
224
  warmupBarsOverride: Number.isFinite(Number(opts.warmupBars)) && Number(opts.warmupBars) >= 0 ? Math.ceil(Number(opts.warmupBars)) : null,