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,176 @@
1
+ 'use strict';
2
+ /**
3
+ * RESEARCH-ONLY scale variants for the canonical Huber AMA-slope estimator.
4
+ *
5
+ * `computeHuberWindowSlopePct` (market_adapter/core/strategies/dynamic_weight_series.ts)
6
+ * estimates the robust scale as a PLUG-IN `1.4826 * MAD` of the residuals of the
7
+ * current fit, recomputed each IRLS pass. Those residuals are shrunk relative to
8
+ * the true errors (n - 2 degrees of freedom), so the plug-in scale is biased low
9
+ * — measured ~0.93x sigma at a 16-bar window, ~0.86x at 8 bars — which lowers the
10
+ * effective Huber constant below the nominal 1.345 and makes short windows more
11
+ * conservative than intended.
12
+ *
13
+ * scikit-learn's `HuberRegressor` avoids this by optimizing sigma JOINTLY with the
14
+ * coefficients (sklearn/linear_model/_huber.py); its reference is Huber &
15
+ * Ronchetti, "Concomitant scale estimates", p. 172. This module reproduces the
16
+ * baseline exactly and offers two corrected scale estimates so the effect can be
17
+ * measured without touching production:
18
+ *
19
+ * 'none' — exact production behaviour (plug-in 1.4826 * MAD).
20
+ * 'df' — plug-in MAD inflated by the finite-sample factor sqrt(n / (n - 2)).
21
+ * 'mscale' — Huber proposal-2 M-scale: solve mean(rho_C(r_i / s)) = delta_C,
22
+ * where delta_C = E[rho_C(Z)] under N(0, 1), iterated with the fit.
23
+ *
24
+ * Also returns an outlier fraction (share of |residual| > C * s), the sklearn
25
+ * `outliers_` analogue, for observability.
26
+ *
27
+ * Not imported by production code and not embedded in any chart — a research
28
+ * harness for the scale-bias hypothesis only.
29
+ */
30
+ import { MARKET_ADAPTER } from '../../modules/constants.js';
31
+ // Abramowitz & Stegun 7.1.26 approximation — max abs error ~1.5e-7, ample for a
32
+ // consistency constant that only needs ~1e-6 relative accuracy.
33
+ function erf(x) {
34
+ const sign = x < 0 ? -1 : 1;
35
+ const ax = Math.abs(x);
36
+ const t = 1 / (1 + 0.3275911 * ax);
37
+ const poly = ((((1.061405429 * t - 1.453152027) * t + 1.421413741) * t - 0.284496736) * t + 0.254829592) * t;
38
+ return sign * (1 - poly * Math.exp(-ax * ax));
39
+ }
40
+ function standardNormalCdf(x) {
41
+ return 0.5 * (1 + erf(x / Math.SQRT2));
42
+ }
43
+ function standardNormalPdf(x) {
44
+ return Math.exp(-0.5 * x * x) / Math.sqrt(2 * Math.PI);
45
+ }
46
+ /** Huber rho: z^2 inside the band, linear beyond. */
47
+ function huberRho(z, c) {
48
+ const a = Math.abs(z);
49
+ return a <= c ? z * z : 2 * c * a - c * c;
50
+ }
51
+ /**
52
+ * delta_C = E[rho_C(Z)] for Z ~ N(0,1), the proposal-2 consistency constant:
53
+ * delta_C = 2*Phi(c) - 1 + 2*c*phi(c) - 2*c^2*(1 - Phi(c)).
54
+ */
55
+ export function huberConsistencyConstant(c) {
56
+ const Phi = standardNormalCdf(c);
57
+ const phi = standardNormalPdf(c);
58
+ return 2 * Phi - 1 + 2 * c * phi - 2 * c * c * (1 - Phi);
59
+ }
60
+ /**
61
+ * Proposal-2 M-scale: the s satisfying mean(rho_C(r_i / s)) = delta_C.
62
+ * Fixed-point iteration s <- s * sqrt(mean(rho_C(r / s)) / delta_C), seeded from
63
+ * the plug-in MAD so it starts near the answer.
64
+ */
65
+ function solveMScale(resid, c, seed, floor) {
66
+ const delta = huberConsistencyConstant(c);
67
+ let s = Math.max(seed, floor);
68
+ for (let it = 0; it < 60; it++) {
69
+ let acc = 0;
70
+ for (let i = 0; i < resid.length; i++)
71
+ acc += huberRho(resid[i] / s, c);
72
+ const ratio = acc / (resid.length * delta);
73
+ const next = s * Math.sqrt(Math.max(ratio, 1e-12));
74
+ if (!Number.isFinite(next))
75
+ return s;
76
+ if (Math.abs(next - s) <= 1e-13 * s)
77
+ return next;
78
+ s = next;
79
+ }
80
+ return s;
81
+ }
82
+ /**
83
+ * Core fit. Reproduces `computeHuberWindowSlopePct` byte-for-byte for
84
+ * `mode='none'`; the other modes change only the scale estimate fed to the
85
+ * Huber weight `min(1, C*s/|r|)`.
86
+ */
87
+ export function huberSlopeCore(amaValues, index, lookbackBars, mode = 'none', hub = MARKET_ADAPTER.DYNAMIC_WEIGHT_AMA_HUBER) {
88
+ const bars = Number.isFinite(lookbackBars) && Number(lookbackBars) > 0
89
+ ? Math.ceil(Number(lookbackBars))
90
+ : 0;
91
+ if (!Array.isArray(amaValues) || bars < 1)
92
+ return null;
93
+ if (!Number.isFinite(index) || index < bars || index >= amaValues.length)
94
+ return null;
95
+ const y = [];
96
+ for (let k = index - bars; k <= index; k++) {
97
+ const v = Number(amaValues[k]);
98
+ if (!Number.isFinite(v) || v <= 0)
99
+ return null;
100
+ y.push(Math.log(v));
101
+ }
102
+ const n = y.length;
103
+ const c = Number.isFinite(Number(hub?.C)) ? Number(hub.C) : 1.345;
104
+ const iterations = Number.isFinite(Number(hub?.ITERATIONS)) ? Number(hub.ITERATIONS) : 5;
105
+ const scaleFloor = Number.isFinite(Number(hub?.SCALE_FLOOR)) ? Number(hub.SCALE_FLOOR) : 1e-6;
106
+ const zeroEpsilon = Number.isFinite(Number(hub?.ZERO_EPSILON)) ? Number(hub.ZERO_EPSILON) : 1e-9;
107
+ const xMean = (n - 1) / 2;
108
+ const wls = (w) => {
109
+ let sw = 0, swx = 0, swy = 0, swxx = 0, swxy = 0;
110
+ for (let i = 0; i < n; i++) {
111
+ const xi = i - xMean;
112
+ sw += w[i];
113
+ swx += w[i] * xi;
114
+ swy += w[i] * y[i];
115
+ swxx += w[i] * xi * xi;
116
+ swxy += w[i] * xi * y[i];
117
+ }
118
+ const den = sw * swxx - swx * swx;
119
+ const b = den === 0 ? 0 : (sw * swxy - swx * swy) / den;
120
+ const a = sw === 0 ? 0 : (swy - b * swx) / sw;
121
+ return { a, b };
122
+ };
123
+ let fit = wls(new Array(n).fill(1));
124
+ let scale = scaleFloor;
125
+ for (let iter = 0; iter < iterations; iter++) {
126
+ const resid = y.map((v, i) => v - (fit.a + fit.b * (i - xMean)));
127
+ const abs = resid.map(Math.abs).sort((p, q) => p - q);
128
+ const mid = abs.length >> 1;
129
+ const mad = abs.length % 2 === 1 ? abs[mid] : (abs[mid - 1] + abs[mid]) / 2;
130
+ let s = 1.4826 * mad;
131
+ if (mode === 'df')
132
+ s = s * Math.sqrt(n / Math.max(1, n - 2));
133
+ else if (mode === 'mscale')
134
+ s = solveMScale(resid, c, s, scaleFloor);
135
+ s = Math.max(s, scaleFloor);
136
+ scale = s;
137
+ const w = resid.map((r) => Math.min(1, (c * s) / Math.max(Math.abs(r), 1e-12)));
138
+ const next = wls(w);
139
+ const moved = Math.abs(next.b - fit.b);
140
+ fit = next;
141
+ if (moved < 1e-12)
142
+ break;
143
+ }
144
+ // Outlier fraction at the final fit (sklearn outliers_ analogue).
145
+ let outliers = 0;
146
+ for (let i = 0; i < n; i++) {
147
+ const r = y[i] - (fit.a + fit.b * (i - xMean));
148
+ if (Math.abs(r) > c * scale)
149
+ outliers++;
150
+ }
151
+ let slope = fit.b * 100;
152
+ if (Number.isFinite(slope) && Math.abs(slope) < zeroEpsilon)
153
+ slope = 0;
154
+ if (!Number.isFinite(slope))
155
+ return null;
156
+ return { slopePct: slope, scale, outlierFraction: outliers / n };
157
+ }
158
+ /**
159
+ * Build the `(series, index, lookbackBars)` estimator the reset replay expects,
160
+ * accumulating the mean outlier fraction and scale across calls in `.stats`.
161
+ */
162
+ export function createHuberEstimator(mode = 'none', hub = MARKET_ADAPTER.DYNAMIC_WEIGHT_AMA_HUBER) {
163
+ const stats = { calls: 0, outlierFractionSum: 0, scaleSum: 0 };
164
+ const fn = ((amaValues, index, lookbackBars) => {
165
+ const d = huberSlopeCore(amaValues, index, lookbackBars, mode, hub);
166
+ if (d == null)
167
+ return null;
168
+ stats.calls++;
169
+ stats.outlierFractionSum += d.outlierFraction;
170
+ stats.scaleSum += d.scale;
171
+ return d.slopePct;
172
+ });
173
+ fn.stats = stats;
174
+ return fn;
175
+ }
176
+ //# sourceMappingURL=huber_scale_variants.js.map
@@ -1,3 +1,32 @@
1
- declare function generateHTML(data: any, title?: string): string;
1
+ interface KalmanRow {
2
+ [key: string]: unknown;
3
+ timestamp: string | number;
4
+ price: number;
5
+ kalmanPrice?: number | null;
6
+ modalPrice?: number | null;
7
+ signal?: string | null;
8
+ velocity?: number | null;
9
+ velocityFilteredPct?: number | null;
10
+ velocityPct?: number | null;
11
+ displacementRawPct?: number | null;
12
+ displacementPct?: number | null;
13
+ isReady?: boolean;
14
+ amaWeightOffset?: number | null;
15
+ beams?: Array<{
16
+ originX: number;
17
+ }>;
18
+ }
19
+ interface KalmanChartInput {
20
+ allResults?: KalmanRow[];
21
+ amaConfig?: {
22
+ erPeriod?: number;
23
+ fastPeriod?: number;
24
+ slowPeriod?: number;
25
+ };
26
+ clipPct?: number;
27
+ [key: string]: unknown;
28
+ }
29
+ declare function generateHTML(data: KalmanChartInput, title?: string): string;
2
30
  export { generateHTML };
31
+ export type { KalmanRow };
3
32
  //# sourceMappingURL=kalman_chart_generator.d.ts.map
@@ -72,10 +72,10 @@ function generateHTML(data, title = 'Kalman Trajectory Analysis') {
72
72
  if (idx % 15 === 0 || (r.beams && r.beams.length > 0 && r.beams[r.beams.length - 1].originX === idx)) {
73
73
  allBeams.push({
74
74
  x: dates[idx],
75
- y: r.kalmanPrice,
76
- v: r.velocity,
75
+ y: (r.kalmanPrice ?? 0),
76
+ v: (r.velocity ?? 0),
77
77
  endX: dates[idx] + (150 * interval),
78
- endY: r.kalmanPrice + (r.velocity * 150)
78
+ endY: (r.kalmanPrice ?? 0) + (r.velocity ?? 0) * 150
79
79
  });
80
80
  }
81
81
  });
@@ -1,3 +1,33 @@
1
- declare function generateRegimeHTML(data: any, title?: string): string;
1
+ interface RegimeRow {
2
+ [key: string]: unknown;
3
+ timestamp: string | number;
4
+ price: number;
5
+ ama3Price?: number | null;
6
+ hurstReady?: boolean;
7
+ hurst?: number | null;
8
+ peReady?: boolean;
9
+ normalizedEntropy?: number | null;
10
+ }
11
+ interface RegimeChartInput {
12
+ allResults?: RegimeRow[];
13
+ hurstConfig?: {
14
+ window?: number;
15
+ scales?: number[];
16
+ };
17
+ peConfig?: {
18
+ m?: number;
19
+ window?: number;
20
+ };
21
+ dates?: number[];
22
+ prices?: (number | null)[];
23
+ hurstArr?: (number | null)[];
24
+ peArr?: (number | null)[];
25
+ hurstSegments?: unknown[];
26
+ peSegments?: unknown[];
27
+ realBarCount?: number;
28
+ [key: string]: unknown;
29
+ }
30
+ declare function generateRegimeHTML(data: RegimeChartInput, title?: string): string;
2
31
  export { generateRegimeHTML };
32
+ export type { RegimeRow };
3
33
  //# sourceMappingURL=regime_chart_generator.d.ts.map
@@ -54,8 +54,8 @@ function generateRegimeHTML(data, title = 'Regime Analysis') {
54
54
  const dates = results.map((r, i) => toEpochSeconds(r.timestamp, i));
55
55
  const prices = results.map((r) => r.price);
56
56
  const ama3Prices = results.map((r) => r.ama3Price ?? null);
57
- const hurstArr = results.map((r) => r.hurstReady ? r.hurst : null);
58
- const peArr = results.map((r) => r.peReady ? r.normalizedEntropy : null);
57
+ const hurstArr = results.map((r) => r.hurstReady ? (r.hurst ?? null) : null);
58
+ const peArr = results.map((r) => r.peReady ? (r.normalizedEntropy ?? null) : null);
59
59
  const realBarCount = results.length;
60
60
  // Extend arrays with null padding so the last real bar is not glued to chart right edge
61
61
  const lastDate = dates[dates.length - 1];
@@ -1,3 +1,35 @@
1
- declare function generateHTML(data: any, title?: string): string;
1
+ interface VolatilityRow {
2
+ timestamp: string | number;
3
+ price: number;
4
+ ama3Price?: number | null;
5
+ atr?: number;
6
+ weightVariance?: number | null;
7
+ rawSymmetricDelta?: number;
8
+ symmetricDelta?: number;
9
+ effectiveWeight?: number;
10
+ sellW?: number;
11
+ buyW?: number;
12
+ }
13
+ interface VolatilityChartInput {
14
+ allResults?: VolatilityRow[];
15
+ volatilityConfig?: {
16
+ volatilityThreshold?: number;
17
+ atrPeriod?: number;
18
+ volatilityExponent?: number;
19
+ volatilityScaleX?: number;
20
+ volatilityClamp?: number;
21
+ };
22
+ volatilityThreshold?: number;
23
+ atrPeriod?: number;
24
+ volatilityExponent?: number;
25
+ volatilityScaleX?: number;
26
+ volatilityClamp?: number;
27
+ minWeight?: number;
28
+ maxWeight?: number;
29
+ candles?: unknown[];
30
+ [key: string]: unknown;
31
+ }
32
+ declare function generateHTML(data: VolatilityChartInput, title?: string): string;
2
33
  export { generateHTML };
34
+ export type { VolatilityRow };
3
35
  //# sourceMappingURL=volatility_chart_generator.d.ts.map
@@ -60,6 +60,7 @@
60
60
  *
61
61
  * ===============================================================================
62
62
  */
63
+ import { getErrorMessage, getErrorCode, getErrorField } from './modules/utils/errors.js';
63
64
  import { createRequire } from 'node:module';
64
65
  const require = createRequire(import.meta.url);
65
66
  const { setUmask } = require('./modules/config');
@@ -75,7 +76,7 @@ const { orderNodesForSettings } = require('./modules/node_health_cache');
75
76
  const credentialPolicy = require('./modules/credential_policy');
76
77
  const { getStorage } = require('./modules/storage');
77
78
  const storage = getStorage();
78
- let _nativeChainClient = null;
79
+ let _nativeChainClient;
79
80
  let _nativeNodeList = [];
80
81
  const native = require('./modules/bitshares-native');
81
82
  _nativeChainClient = native.createChainClient({ rpcTimeoutMs: TIMING.CONNECTION_TIMEOUT_MS, connectTimeoutMs: TIMING.CONNECTION_TIMEOUT_MS });
@@ -109,7 +110,6 @@ const { Config } = require('./modules/config');
109
110
  const daemonLogger = new Logger('credential-daemon');
110
111
  // Resolve project root — handles running from dist/ (compiled) vs source
111
112
  const { PATHS } = require('./modules/paths');
112
- const { getErrorMessage } = require('./modules/utils/errors');
113
113
  const { sleep } = require('./modules/order/utils/system');
114
114
  const { classifyBroadcastFailure } = require('./modules/broadcast_failure');
115
115
  // Unix sockets are required; only Unix-like systems are supported
@@ -219,7 +219,7 @@ function checkSessionValid(accountName, sessionId) {
219
219
  return false;
220
220
  }
221
221
  const session = activeSessions.get(sessionId);
222
- return session && session.accountName === accountName;
222
+ return Boolean(session && session.accountName === accountName);
223
223
  }
224
224
  function drainAuditLogQueue() {
225
225
  while (auditLogQueue.length > 0) {
@@ -366,7 +366,7 @@ async function loadCurrentPrivateKey(accountName) {
366
366
  });
367
367
  }
368
368
  async function executeOperationsWithClient(client, operations) {
369
- const ops = Array.isArray(operations) ? operations.filter(Boolean) : [];
369
+ const ops = (Array.isArray(operations) ? operations.filter(Boolean) : []);
370
370
  if (ops.length === 0) {
371
371
  return { success: true, operation_results: [], raw: null };
372
372
  }
@@ -387,10 +387,20 @@ async function executeOperationsWithClient(client, operations) {
387
387
  tx[op.op_name](op.op_data);
388
388
  }
389
389
  const result = await tx.broadcast();
390
- const operationResults = (result && Array.isArray(result.operation_results) && result.operation_results.length > 0 && result.operation_results) ||
391
- (result && result.trx && Array.isArray(result.trx.operation_results) && result.trx.operation_results.length > 0 && result.trx.operation_results) ||
392
- (Array.isArray(result) && result[0] && result[0].trx && Array.isArray(result[0].trx.operation_results) && result[0].trx.operation_results.length > 0 && result[0].trx.operation_results) ||
393
- [];
390
+ const r = result;
391
+ let operationResults = [];
392
+ if (r && !Array.isArray(r) && Array.isArray(r.operation_results) && r.operation_results.length > 0) {
393
+ operationResults = r.operation_results;
394
+ }
395
+ else if (r && !Array.isArray(r) && r.trx && Array.isArray(r.trx.operation_results) && r.trx.operation_results.length > 0) {
396
+ operationResults = r.trx.operation_results;
397
+ }
398
+ else if (Array.isArray(result) && result[0]) {
399
+ const first = result[0];
400
+ if (first.trx && Array.isArray(first.trx.operation_results) && first.trx.operation_results.length > 0) {
401
+ operationResults = first.trx.operation_results;
402
+ }
403
+ }
394
404
  return {
395
405
  success: true,
396
406
  raw: result,
@@ -457,7 +467,7 @@ function serializeBroadcast(fn, getWork) {
457
467
  function createBroadcastGuard(accountName, startedAt, deadlineMs) {
458
468
  let fired = false;
459
469
  let timer = null;
460
- let rejectGuard = null;
470
+ let rejectGuard = () => { };
461
471
  const promise = new Promise((_, reject) => {
462
472
  rejectGuard = reject;
463
473
  timer = setTimeout(() => {
@@ -689,7 +699,7 @@ async function broadcastWithDeadline(accountName, privateKey, broadcastFn, nodeU
689
699
  // propagate as uncertain immediately — they are never
690
700
  // retryable, even during the connect phase, and a retry
691
701
  // would just re-enter the same deadlined attempt.
692
- if (err?.code === DAEMON_CODES.BROADCAST_DEADLINE || err?.uncertain === true) {
702
+ if (getErrorCode(err) === DAEMON_CODES.BROADCAST_DEADLINE || getErrorField(err, 'uncertain') === true) {
693
703
  throw err;
694
704
  }
695
705
  // Connect-phase failures are always pre-transmit: no broadcast
@@ -794,8 +804,9 @@ function refreshNodeList() {
794
804
  const { createNodeHealthLedger } = require('./modules/daemon_node_health');
795
805
  const daemonNodeHealth = createNodeHealthLedger({ logger: daemonLogger });
796
806
  function getCredentialDaemonNodeRefreshIntervalMs(settings) {
797
- const configured = settings?.NODES?.credentialDaemonRefreshIntervalMs
798
- ?? settings?.NODES?.CREDENTIAL_DAEMON_NODE_REFRESH_INTERVAL_MS
807
+ const s = settings;
808
+ const configured = s?.NODES?.credentialDaemonRefreshIntervalMs
809
+ ?? s?.NODES?.CREDENTIAL_DAEMON_NODE_REFRESH_INTERVAL_MS
799
810
  ?? NODE_MANAGEMENT.CREDENTIAL_DAEMON_NODE_REFRESH_INTERVAL_MS;
800
811
  return Number.isFinite(configured) && configured > 0
801
812
  ? configured
@@ -933,8 +944,9 @@ async function initialize() {
933
944
  throw new Error(`Insecure credential runtime path detected: ${getErrorMessage(err)}`);
934
945
  }
935
946
  // Create server
936
- server = net.createServer(handleConnection);
937
- server.listen(SOCKET_PATH, () => {
947
+ const srv = net.createServer(handleConnection);
948
+ server = srv;
949
+ srv.listen(SOCKET_PATH, () => {
938
950
  try {
939
951
  storage.chmod(SOCKET_PATH, 0o600);
940
952
  assertPrivatePathSecurity(SOCKET_PATH, { expectedType: 'socket', requiredMode: 0o600 });
@@ -960,7 +972,7 @@ async function initialize() {
960
972
  return;
961
973
  }
962
974
  });
963
- server.on('error', (error) => {
975
+ srv.on('error', (error) => {
964
976
  daemonLogger.error(`Server error: ${getErrorMessage(error)}`);
965
977
  process.exit(1);
966
978
  });
@@ -976,7 +988,7 @@ async function initialize() {
976
988
  });
977
989
  }
978
990
  catch (error) {
979
- daemonLogger.error(`[credential-daemon] Startup failed: ${error.stack || getErrorMessage(error)}`);
991
+ daemonLogger.error(`[credential-daemon] Startup failed: ${getErrorField(error, 'stack') || getErrorMessage(error)}`);
980
992
  shutdown(1, 'startup failure');
981
993
  }
982
994
  }
@@ -1157,7 +1169,9 @@ function processRequest(requestStr, socket, activeGuards = new Set()) {
1157
1169
  signResult = await serializeBroadcast(() => broadcastWithDeadline(accountName, privateKey, (client) => executeOperationsWithClient(client, operations), broadcastNodeUrl, { guard: broadcastGuard, startedAt: broadcastStartedAt, workRef: broadcastWorkRef }), () => broadcastWorkRef.work || Promise.resolve());
1158
1170
  }
1159
1171
  catch (broadcastErr) {
1160
- if (broadcastErr && broadcastErr.code === DAEMON_CODES.BROADCAST_DEADLINE) {
1172
+ if (broadcastErr && getErrorCode(broadcastErr) === DAEMON_CODES.BROADCAST_DEADLINE) {
1173
+ const broadcastErrAgeMs = getErrorField(broadcastErr, 'ageMs');
1174
+ const broadcastErrStartedAt = getErrorField(broadcastErr, 'startedAt');
1161
1175
  appendAuditLog({
1162
1176
  event: 'sign_timeout',
1163
1177
  accountName,
@@ -1165,9 +1179,9 @@ function processRequest(requestStr, socket, activeGuards = new Set()) {
1165
1179
  nodeUrl: broadcastGuard.currentNode || broadcastNodeUrl,
1166
1180
  opCount: operations.length,
1167
1181
  opTypes: operations.map((o) => o && o.op_name).filter(Boolean),
1168
- ageMs: broadcastErr.ageMs,
1169
- startedAt: broadcastErr.startedAt
1170
- ? new Date(broadcastErr.startedAt).toISOString()
1182
+ ageMs: broadcastErrAgeMs,
1183
+ startedAt: broadcastErrStartedAt
1184
+ ? new Date(broadcastErrStartedAt).toISOString()
1171
1185
  : null,
1172
1186
  timestamp: new Date().toISOString(),
1173
1187
  });
package/dist/dexbot.js CHANGED
@@ -1,4 +1,5 @@
1
1
  #!/usr/bin/env node
2
+ import { getErrorMessage, getErrorCode } from './modules/utils/errors.js';
2
3
  import { fileURLToPath } from 'node:url';
3
4
  import { CLI_COLORS } from './modules/cli_colors.js';
4
5
  import { dirname as _esmDirname } from 'node:path';
@@ -125,7 +126,6 @@ const { parseWorkerArgs, LAUNCHER_WORKER_COMMAND } = require('./modules/launcher
125
126
  const { PATHS, getHomeProfilesDir, getRecalculateTriggerFile, printRelocationNotices } = require('./modules/paths');
126
127
  const credentialPolicy = require('./modules/credential_policy');
127
128
  const { Config } = require('./modules/config');
128
- const { getErrorMessage } = require('./modules/utils/errors');
129
129
  const { isSameBotName } = require('./modules/utils/sanitize_key');
130
130
  const { normalizeAssetRef } = require('./modules/utils/asset_symbols');
131
131
  // Setup graceful shutdown handlers
@@ -143,7 +143,7 @@ if (typeof credentialPolicy.checkPolicyFileSecurity === 'function')
143
143
  // Primary CLI driver that manages tracked bots and helper utilities such as key/bot editors.
144
144
  const PROFILES_BOTS_FILE = PATHS.PROFILES.BOTS_JSON;
145
145
  const PROFILES_DIR = PATHS.PROFILES_DIR;
146
- const CLI_COMMANDS = ['start', 'test', 'reset', 'default', 'disable', 'enable', 'drystart', 'key', 'bot', 'pm2', 'update', 'export', 'order', 'credit', 'tv', 'dw', 'clear', 'clear-orders', 'clear-market-adapter', 'clear-all', 'status', 'unlock', 'delete', 'stop', 'restart', 'reload', 'help'];
146
+ const CLI_COMMANDS = ['start', 'test', 'reset', 'default', 'disable', 'enable', 'drystart', 'key', 'bot', 'pm2', 'update', 'export', 'order', 'credit', 'tv', 'dw', 'pnl', 'clear', 'clear-orders', 'clear-market-adapter', 'clear-all', 'status', 'unlock', 'delete', 'stop', 'restart', 'reload', 'help'];
147
147
  const COMMAND_ALIASES = { orders: 'order', keys: 'key', bots: 'bot', stat: 'status', stats: 'status', start: 'unlock', defaults: 'default', stp: 'stop', stopall: 'stop', restartall: 'restart', reloadall: 'reload' };
148
148
  const CLI_HELP_FLAGS = ['-h', '--help'];
149
149
  const CLI_EXAMPLES_FLAG = '--cli-examples';
@@ -162,6 +162,7 @@ const CLI_EXAMPLES = [
162
162
  { title: 'Analyze persisted order grids', command: 'dexbot order', notes: 'Runs the order analyzer across the orders directory (<profiles>/orders) and prints spread/increment/funds/distribution metrics. Add a bot key to render only that bot, and --export for an HTML report.' },
163
163
  { title: 'Show live credit/MPA positions', command: 'dexbot credit', notes: 'Queries get_margin_positions + get_credit_deals_by_borrower per preferredAccount and prints debt/collateral sums plus one Curr. CR line per whitelisted pair (active CR, else borrow-now CR vs funds avail. on the offer) and one Avar. CR line per bot. CR covers only pairs whitelisted in bots.json and listed on the current credit offer. Add a bot key to render only that bot.' },
164
164
  { title: 'TradingView chart for a bot, pool, or pair', command: 'dexbot tv <bot|pool-id|AssetA/AssetB> --month 3', notes: 'Fetches 1h candles for N months (default 3, pool-first with orderbook fallback; --feed charts MPA price-feed history) and writes an auto-named HTML chart.' },
165
+ { title: 'PnL report for a bot or blockchain account', command: 'dexbot pnl <bot|account|1.2.x> --month 3 [--pair BASE/QUOTE]', notes: 'Resolves a local bot profile first, then the chain account, analyzes its fills for the requested window and writes a self-contained HTML PnL report.' },
165
166
  { title: 'Clear all bot log files', command: 'dexbot clear', notes: 'Runs scripts/clear-logs.sh to remove *.log, rotated *.log.N and *.jsonl* from the logs directory (<profiles>/logs), including the credential audit trail daemon-audit.jsonl and its rotated siblings (named in the preview). Offline only: the scripts warn when a live runtime is detected, but a running bot keeps writing to unlinked files and the space is not freed until it restarts; dexbot clear-orders / clear-market-adapter / clear-all are undone within seconds (grid state is re-persisted, the adapter rewrites its state file and lock). Stop first with dexbot stop / dexbot pm2 stop all.' },
166
167
  { title: 'Reset settings to defaults', command: 'dexbot default', notes: 'Runs scripts/reset-settings.sh to delete general.settings.json, market_profiles.json, and market_adapter_settings.json.' }
167
168
  ];
@@ -220,6 +221,7 @@ function printCLIUsage() {
220
221
  ['credit [<bot>]', 'Live summed MPA + borrowed-credit positions per asset per bot.'],
221
222
  ['tv <target>', 'TradingView chart: 1h candles for <bot|pool-id|AssetA/AssetB> over --month N (default 3).'],
222
223
  ['dw <target>', 'Dynamic-weight research chart: same targets/flags as tv (see analysis/).'],
224
+ ['pnl <account>', 'PnL HTML report for a bot/account over --month N, optional --pair BASE/QUOTE filter.'],
223
225
  ]],
224
226
  ['Files', [
225
227
  ['clear', 'Delete <profiles>/logs/*.log, *.log.N and *.jsonl* (audit trail included). Stop the runtime first.'],
@@ -259,7 +261,7 @@ if (cliArgs.some(arg => CLI_HELP_FLAGS.includes(arg))) {
259
261
  // so the script prints its usage. Only scripts with offline help handling
260
262
  // belong here — forwarding to a script without it could misinterpret the
261
263
  // flag as input (e.g. a bot-name filter triggering live work).
262
- const HELP_OWNING_COMMANDS = new Set(['credit', 'tv', 'dw']);
264
+ const HELP_OWNING_COMMANDS = new Set(['credit', 'tv', 'dw', 'pnl']);
263
265
  const requestedCommand = COMMAND_ALIASES[cliArgs[0]] ?? cliArgs[0];
264
266
  if (!HELP_OWNING_COMMANDS.has(requestedCommand)) {
265
267
  printCLIUsage();
@@ -567,7 +569,7 @@ async function runBotInstances(botEntries, { forceDryRun = false, sourceName = '
567
569
  if (entry.debtPolicy?.lending && (entry.preferredAccount && accountGroups[entry.preferredAccount]?.length > 1)) {
568
570
  for (const item of entry.debtPolicy.lending) {
569
571
  if (item.collateralAsset)
570
- allCollateralRefs.add(item.collateralAsset);
572
+ allCollateralRefs.add(String(item.collateralAsset));
571
573
  }
572
574
  }
573
575
  }
@@ -582,7 +584,7 @@ async function runBotInstances(botEntries, { forceDryRun = false, sourceName = '
582
584
  for (const side of sides) {
583
585
  const pct = entry.botFunds[side];
584
586
  if (pct !== undefined && pct !== null) {
585
- await fundRegistry.registerAllocation(account, botName, side, pct);
587
+ await fundRegistry.registerAllocation(account, botName, side, Number(pct));
586
588
  }
587
589
  }
588
590
  }
@@ -590,7 +592,7 @@ async function runBotInstances(botEntries, { forceDryRun = false, sourceName = '
590
592
  if (botName && entry.debtPolicy?.lending) {
591
593
  const dp = entry.debtPolicy;
592
594
  const globalPct = dp.maxCollateralAmount ?? '100%';
593
- for (const item of dp.lending) {
595
+ for (const item of dp.lending || []) {
594
596
  const collateralRef = item.collateralAsset;
595
597
  if (!collateralRef)
596
598
  continue;
@@ -690,7 +692,7 @@ async function startBotByName(botName, { dryRun = false } = {}) {
690
692
  }
691
693
  const match = entries.find((b) => isSameBotName(b.name, botName));
692
694
  if (!match) {
693
- console.error(startupError(`Could not find any bot named '${botName}' in the tracked settings.`));
695
+ console.error(startupError(`No bot named '${botName}' was found in the tracked settings.`));
694
696
  process.exit(1);
695
697
  }
696
698
  const entryCopy = JSON.parse(JSON.stringify(match));
@@ -736,7 +738,7 @@ async function setBotActiveState(botName, active) {
736
738
  }
737
739
  const match = entries.find((b) => isSameBotName(b.name, botName));
738
740
  if (!match) {
739
- console.error(startupError(`Could not find any bot named '${botName}' to ${action}.`));
741
+ console.error(startupError(`No bot named '${botName}' was found to ${action}.`));
740
742
  process.exit(1);
741
743
  }
742
744
  if ((match.active !== false) === active) {
@@ -770,7 +772,7 @@ async function resetBotByName(botName) {
770
772
  // Filter targets
771
773
  const targets = botName ? entries.filter((b) => isSameBotName(b.name, botName)) : entries.filter((b) => b.active);
772
774
  if (botName && targets.length === 0) {
773
- console.error(startupError(`Could not find any bot named '${botName}' to reset.`));
775
+ console.error(startupError(`No bot named '${botName}' was found to reset.`));
774
776
  process.exit(1);
775
777
  }
776
778
  console.log(`Setting regeneration trigger for ${targets.length} ${targets.length === 1 ? 'bot' : 'bots'}...`);
@@ -1008,7 +1010,8 @@ async function handleCLICommands() {
1008
1010
  return true;
1009
1011
  }
1010
1012
  case 'tv':
1011
- case 'dw': {
1013
+ case 'dw':
1014
+ case 'pnl': {
1012
1015
  const { spawnSync } = require('child_process');
1013
1016
  const scriptArgs = buildRuntimeScriptArgs({
1014
1017
  codeRoot: __dirname,
@@ -1137,11 +1140,11 @@ async function handleCLICommands() {
1137
1140
  unlockRunning = true;
1138
1141
  }
1139
1142
  catch (err) {
1140
- if (err.code === 'EACCES') {
1143
+ if (getErrorCode(err) === 'EACCES') {
1141
1144
  console.warn('[dexbot]', `process.kill(${pid}, 0) EACCES — process exists but permission denied`);
1142
1145
  unlockRunning = true;
1143
1146
  }
1144
- else if (err.code !== 'ESRCH') {
1147
+ else if (getErrorCode(err) !== 'ESRCH') {
1145
1148
  console.warn('[dexbot]', `process.kill(${pid}, 0) unexpected error: ${getErrorMessage(err)}`);
1146
1149
  }
1147
1150
  }
@@ -1165,7 +1168,7 @@ async function handleCLICommands() {
1165
1168
  unlockRunning = true;
1166
1169
  }
1167
1170
  catch (err) {
1168
- if (err.code === 'EACCES')
1171
+ if (getErrorCode(err) === 'EACCES')
1169
1172
  unlockRunning = true;
1170
1173
  }
1171
1174
  }
@@ -1327,7 +1330,7 @@ async function bootstrap() {
1327
1330
  isNewSetup = ensureProfilesDirectory(PROFILES_DIR);
1328
1331
  }
1329
1332
  catch (err) {
1330
- if (err && (err.code === 'EACCES' || err.code === 'EPERM' || err.code === 'EROFS')) {
1333
+ if (err && (getErrorCode(err) === 'EACCES' || getErrorCode(err) === 'EPERM' || getErrorCode(err) === 'EROFS')) {
1331
1334
  const { spawnSync: respawn } = require('child_process');
1332
1335
  const fallbackDir = getHomeProfilesDir();
1333
1336
  console.log(`Config directory not writable at: ${PROFILES_DIR}`);