dexbot 1.6.11 → 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 (354) hide show
  1. package/CHANGELOG.md +35 -4
  2. package/README.md +2 -1
  3. package/analysis/README.md +2 -0
  4. package/analysis/tradingview/README.md +1 -1
  5. package/analysis/trend_detection/DYNAMIC_WEIGHT_RESEARCH.md +3 -3
  6. package/claw/docs/DEXBOT2_TUNING_CHEAT_SHEET.md +4 -3
  7. package/claw/modules/chain_broadcast.ts +7 -1
  8. package/claw/modules/claw_launcher.ts +1 -1
  9. package/claw/modules/launcher_mode_detector.ts +9 -2
  10. package/claw/package.json +1 -1
  11. package/claw/runtimes/openclaw-plugin/openclaw.plugin.json +1 -1
  12. package/claw/runtimes/openclaw-plugin/package.json +1 -1
  13. package/dist/analysis/account_resolver.d.ts +1 -1
  14. package/dist/analysis/account_resolver.js +2 -1
  15. package/dist/analysis/ama_fitting/analyze_ama_price_changes.js +3 -4
  16. package/dist/analysis/ama_fitting/analyze_lambda_vs_slow.js +2 -7
  17. package/dist/analysis/ama_fitting/calibrate_convergence_er.js +0 -1
  18. package/dist/analysis/ama_fitting/fetch_lp_candles.js +4 -4
  19. package/dist/analysis/ama_fitting/generate_unified_comparison_chart.d.ts +20 -4
  20. package/dist/analysis/ama_fitting/generate_unified_comparison_chart.js +9 -6
  21. package/dist/analysis/ama_fitting/optimizer_high_resolution.js +16 -12
  22. package/dist/analysis/analyze_args.d.ts +31 -0
  23. package/dist/analysis/analyze_args.js +41 -0
  24. package/dist/analysis/analyze_dynamic_weight.js +7 -17
  25. package/dist/analysis/analyze_kalman.js +7 -17
  26. package/dist/analysis/analyze_regime.js +7 -17
  27. package/dist/analysis/analyze_regime_windows.js +8 -18
  28. package/dist/analysis/analyze_risk_profile.js +8 -18
  29. package/dist/analysis/analyze_trade_heatmap.js +7 -17
  30. package/dist/analysis/analyze_volatility.js +7 -17
  31. package/dist/analysis/bot_fitting/backtest_ama_sweep.d.ts +220 -12
  32. package/dist/analysis/bot_fitting/backtest_ama_sweep.js +6 -5
  33. package/dist/analysis/bot_fitting/backtest_bot_fitting.d.ts +34 -4
  34. package/dist/analysis/bot_fitting/backtest_bot_fitting.js +11 -63
  35. package/dist/analysis/bot_fitting/shared_utils.d.ts +7 -7
  36. package/dist/analysis/bot_fitting/shared_utils.js +2 -2
  37. package/dist/analysis/bot_key_utils.d.ts +18 -10
  38. package/dist/analysis/bot_key_utils.js +7 -4
  39. package/dist/analysis/bot_usage/discover_bot_accounts.js +44 -47
  40. package/dist/analysis/bot_usage/kibana_bot_queries.d.ts +1 -21
  41. package/dist/analysis/chain_pool.d.ts +3 -1
  42. package/dist/analysis/chart_ui.d.ts +5 -2
  43. package/dist/analysis/chart_ui.js +6 -3
  44. package/dist/analysis/chart_utils.d.ts +5 -5
  45. package/dist/analysis/chart_utils.js +9 -0
  46. package/dist/analysis/fills_cache.d.ts +1 -1
  47. package/dist/analysis/fills_source.d.ts +2 -2
  48. package/dist/analysis/fills_source.js +14 -12
  49. package/dist/analysis/grid_correction_check.d.ts +1 -1
  50. package/dist/analysis/grid_correction_check.js +12 -11
  51. package/dist/analysis/math_utils.d.ts +7 -6
  52. package/dist/analysis/math_utils.js +5 -8
  53. package/dist/analysis/pnl_report.js +29 -29
  54. package/dist/analysis/price_sources.d.ts +8 -8
  55. package/dist/analysis/price_sources.js +5 -4
  56. package/dist/analysis/resolve_bot_accounts.js +2 -2
  57. package/dist/analysis/resolve_source.d.ts +1 -1
  58. package/dist/analysis/trade_profitability.d.ts +23 -2
  59. package/dist/analysis/trade_profitability.js +50 -50
  60. package/dist/analysis/tradingview/analyze_tradingview.d.ts +17 -6
  61. package/dist/analysis/tradingview/analyze_tradingview.js +6 -5
  62. package/dist/analysis/tradingview/grid_reset_config.d.ts +41 -32
  63. package/dist/analysis/tradingview/grid_reset_config.js +23 -11
  64. package/dist/analysis/tradingview/grid_reset_sim.d.ts +75 -9
  65. package/dist/analysis/tradingview/grid_reset_sim.js +4 -3
  66. package/dist/analysis/tradingview/tradingview_uplot_chart_generator.d.ts +69 -4
  67. package/dist/analysis/tradingview/tradingview_uplot_chart_generator.js +18 -19
  68. package/dist/analysis/trend_detection/backtest_ama_slope_huber.d.ts +1 -1
  69. package/dist/analysis/trend_detection/backtest_ama_slope_huber.js +5 -5
  70. package/dist/analysis/trend_detection/dynamic_weight_chart_generator.d.ts +63 -1
  71. package/dist/analysis/trend_detection/dynamic_weight_chart_generator.js +5 -4
  72. package/dist/analysis/trend_detection/huber_scale_variants.d.ts +9 -3
  73. package/dist/analysis/trend_detection/huber_scale_variants.js +4 -4
  74. package/dist/analysis/trend_detection/kalman_chart_generator.d.ts +30 -1
  75. package/dist/analysis/trend_detection/kalman_chart_generator.js +3 -3
  76. package/dist/analysis/trend_detection/regime_chart_generator.d.ts +31 -1
  77. package/dist/analysis/trend_detection/regime_chart_generator.js +2 -2
  78. package/dist/analysis/trend_detection/volatility_chart_generator.d.ts +33 -1
  79. package/dist/credential-daemon.js +34 -20
  80. package/dist/dexbot.js +11 -11
  81. package/dist/market_adapter/candle_utils.d.ts +22 -18
  82. package/dist/market_adapter/candle_utils.js +24 -20
  83. package/dist/market_adapter/core/asymmetric_bounds.d.ts +13 -4
  84. package/dist/market_adapter/core/config_normalizers.d.ts +3 -3
  85. package/dist/market_adapter/core/kibana_candles.d.ts +53 -18
  86. package/dist/market_adapter/core/kibana_candles.js +9 -7
  87. package/dist/market_adapter/core/kibana_client.d.ts +9 -1
  88. package/dist/market_adapter/core/kibana_client.js +8 -7
  89. package/dist/market_adapter/core/kibana_market_candles.d.ts +3 -2
  90. package/dist/market_adapter/core/market_adapter_service.d.ts +284 -117
  91. package/dist/market_adapter/core/market_adapter_service.js +137 -113
  92. package/dist/market_adapter/core/strategies/ama.d.ts +10 -2
  93. package/dist/market_adapter/core/strategies/ama.js +2 -4
  94. package/dist/market_adapter/core/strategies/ama_slope_model.d.ts +14 -1
  95. package/dist/market_adapter/core/strategies/ama_slope_model.js +12 -34
  96. package/dist/market_adapter/core/strategies/atr/calculator.d.ts +7 -2
  97. package/dist/market_adapter/core/strategies/atr/calculator.js +2 -34
  98. package/dist/market_adapter/core/strategies/collateral_manager.d.ts +7 -1
  99. package/dist/market_adapter/core/strategies/collateral_manager.js +0 -22
  100. package/dist/market_adapter/core/strategies/dynamic_weight_series.d.ts +34 -6
  101. package/dist/market_adapter/core/strategies/dynamic_weight_series.js +7 -7
  102. package/dist/market_adapter/core/strategies/regime_gate.d.ts +24 -15
  103. package/dist/market_adapter/core/strategies/regime_gate.js +4 -31
  104. package/dist/market_adapter/core/strategies/regime_interp.d.ts +7 -1
  105. package/dist/market_adapter/core/strategies/regime_interp.js +14 -22
  106. package/dist/market_adapter/core/strategies/volatility_shift.d.ts +11 -1
  107. package/dist/market_adapter/core/strategies/volatility_shift.js +0 -13
  108. package/dist/market_adapter/inputs/cex_candle_parsing.d.ts +29 -0
  109. package/dist/market_adapter/inputs/cex_candle_parsing.js +52 -0
  110. package/dist/market_adapter/inputs/fetch_book_data.d.ts +20 -4
  111. package/dist/market_adapter/inputs/fetch_book_data.js +3 -1
  112. package/dist/market_adapter/inputs/fetch_cex_synthetic_data.js +96 -224
  113. package/dist/market_adapter/inputs/fetch_lp_data.d.ts +42 -7
  114. package/dist/market_adapter/inputs/fetch_lp_data.js +22 -15
  115. package/dist/market_adapter/inputs/kibana_feed_source.d.ts +74 -15
  116. package/dist/market_adapter/inputs/kibana_feed_source.js +29 -22
  117. package/dist/market_adapter/inputs/kibana_source.d.ts +25 -3
  118. package/dist/market_adapter/inputs/kibana_source.js +2 -2
  119. package/dist/market_adapter/inputs/window_cache.d.ts +99 -94
  120. package/dist/market_adapter/inputs/window_cache.js +8 -8
  121. package/dist/market_adapter/interval_utils.d.ts +4 -4
  122. package/dist/market_adapter/log_format.d.ts +6 -6
  123. package/dist/market_adapter/log_format.js +28 -21
  124. package/dist/market_adapter/lp_chart_core.d.ts +22 -1
  125. package/dist/market_adapter/lp_chart_core.js +26 -192
  126. package/dist/market_adapter/lp_chart_runner.d.ts +7 -7
  127. package/dist/market_adapter/lp_chart_strategy_loader.d.ts +41 -6
  128. package/dist/market_adapter/lp_chart_strategy_loader.js +8 -7
  129. package/dist/market_adapter/market_adapter.d.ts +94 -32
  130. package/dist/market_adapter/market_adapter.js +67 -48
  131. package/dist/market_adapter/utils/adapter_client.d.ts +3 -3
  132. package/dist/market_adapter/utils/adapter_client.js +2 -2
  133. package/dist/market_adapter/utils/atomic_write.d.ts +8 -1
  134. package/dist/market_adapter/utils/chain.d.ts +50 -41
  135. package/dist/market_adapter/utils/chain.js +40 -46
  136. package/dist/market_adapter/utils/data_discovery.d.ts +4 -1
  137. package/dist/market_adapter/utils/dynamic_grid_snapshot.d.ts +12 -3
  138. package/dist/market_adapter/utils/file_json_cache.d.ts +2 -2
  139. package/dist/market_adapter/utils/file_lock.d.ts +28 -14
  140. package/dist/market_adapter/utils/file_lock.js +36 -32
  141. package/dist/market_adapter/utils/native_history.d.ts +9 -2
  142. package/dist/market_adapter/utils/native_history.js +35 -28
  143. package/dist/modules/account_bots.d.ts +577 -21
  144. package/dist/modules/account_bots.js +182 -158
  145. package/dist/modules/account_orders.d.ts +66 -30
  146. package/dist/modules/account_orders.js +22 -20
  147. package/dist/modules/authority_resolver.d.ts +12 -2
  148. package/dist/modules/authority_resolver.js +15 -8
  149. package/dist/modules/bitshares-native/chain_client.d.ts +38 -3
  150. package/dist/modules/bitshares-native/chain_client.js +45 -46
  151. package/dist/modules/bitshares-native/crypto/ecc.browser.js +11 -171
  152. package/dist/modules/bitshares-native/crypto/ecc.js +13 -176
  153. package/dist/modules/bitshares-native/crypto/ecc_core.d.ts +33 -0
  154. package/dist/modules/bitshares-native/crypto/ecc_core.js +213 -0
  155. package/dist/modules/bitshares-native/crypto/ecc_selector.d.ts +2 -1
  156. package/dist/modules/bitshares-native/crypto/ecc_selector.js +1 -13
  157. package/dist/modules/bitshares-native/index.d.ts +1 -1
  158. package/dist/modules/bitshares-native/lru_cache.d.ts +7 -7
  159. package/dist/modules/bitshares-native/resolvers.d.ts +18 -6
  160. package/dist/modules/bitshares-native/serial/lazy_buffer.d.ts +4 -0
  161. package/dist/modules/bitshares-native/serial/lazy_buffer.js +21 -0
  162. package/dist/modules/bitshares-native/serial/operations.d.ts +1 -1
  163. package/dist/modules/bitshares-native/serial/serializer.d.ts +16 -12
  164. package/dist/modules/bitshares-native/serial/serializer.js +7 -13
  165. package/dist/modules/bitshares-native/serial/types.d.ts +25 -16
  166. package/dist/modules/bitshares-native/serial/types.js +55 -62
  167. package/dist/modules/bitshares-native/signing_client.d.ts +32 -2
  168. package/dist/modules/bitshares-native/signing_client.js +19 -14
  169. package/dist/modules/bitshares-native/subscriptions.d.ts +81 -1
  170. package/dist/modules/bitshares-native/subscriptions.js +12 -12
  171. package/dist/modules/bitshares-native/transport.d.ts +5 -4
  172. package/dist/modules/bitshares-native/transport.js +5 -4
  173. package/dist/modules/bitshares-native/tx/builder.d.ts +40 -5
  174. package/dist/modules/bitshares-native/tx/builder.js +4 -3
  175. package/dist/modules/bitshares-native/tx/tx_cache.d.ts +4 -4
  176. package/dist/modules/bitshares_client.d.ts +45 -13
  177. package/dist/modules/bitshares_client.js +28 -19
  178. package/dist/modules/bot_defaults.d.ts +6 -15
  179. package/dist/modules/bot_defaults.js +1 -5
  180. package/dist/modules/bot_settings.d.ts +44 -10
  181. package/dist/modules/bot_settings.js +11 -8
  182. package/dist/modules/bots_file_lock.d.ts +6 -6
  183. package/dist/modules/bots_file_lock.js +16 -12
  184. package/dist/modules/broadcast_failure.d.ts +2 -2
  185. package/dist/modules/broadcast_failure.js +5 -4
  186. package/dist/modules/chain_keys.d.ts +42 -40
  187. package/dist/modules/chain_keys.js +53 -45
  188. package/dist/modules/chain_orders.d.ts +93 -59
  189. package/dist/modules/chain_orders.js +31 -23
  190. package/dist/modules/constants.d.ts +527 -31
  191. package/dist/modules/constants.js +15 -47
  192. package/dist/modules/cr_planner.d.ts +40 -2
  193. package/dist/modules/credential_policy.d.ts +68 -8
  194. package/dist/modules/credential_policy.js +37 -31
  195. package/dist/modules/credential_session_cache.d.ts +2 -2
  196. package/dist/modules/credit_pricing.d.ts +42 -6
  197. package/dist/modules/credit_pricing.js +44 -30
  198. package/dist/modules/credit_runtime.d.ts +276 -118
  199. package/dist/modules/credit_runtime.js +462 -165
  200. package/dist/modules/crypto/browser_provider.js +6 -4
  201. package/dist/modules/crypto/node_provider.js +1 -1
  202. package/dist/modules/crypto/pure_scrypt.js +35 -4
  203. package/dist/modules/crypto/pure_secp256k1.js +72 -26
  204. package/dist/modules/crypto/sync.d.ts +9 -9
  205. package/dist/modules/crypto/sync.js +16 -9
  206. package/dist/modules/dexbot_class.d.ts +195 -139
  207. package/dist/modules/dexbot_class.js +78 -28
  208. package/dist/modules/dexbot_cow_runtime.d.ts +167 -87
  209. package/dist/modules/dexbot_cow_runtime.js +248 -206
  210. package/dist/modules/dexbot_credential_client.d.ts +19 -11
  211. package/dist/modules/dexbot_fill_runtime.d.ts +63 -48
  212. package/dist/modules/dexbot_fill_runtime.js +48 -41
  213. package/dist/modules/dexbot_maintenance_runtime.d.ts +109 -70
  214. package/dist/modules/dexbot_maintenance_runtime.js +108 -83
  215. package/dist/modules/dexbot_startup_runtime.d.ts +11 -10
  216. package/dist/modules/dexbot_startup_runtime.js +43 -43
  217. package/dist/modules/dexbot_state_recovery.d.ts +13 -12
  218. package/dist/modules/dexbot_state_recovery.js +18 -13
  219. package/dist/modules/fund_registry.d.ts +4 -2
  220. package/dist/modules/fund_registry.js +10 -10
  221. package/dist/modules/general_settings.d.ts +30 -4
  222. package/dist/modules/graceful_shutdown.d.ts +3 -3
  223. package/dist/modules/graceful_shutdown.js +2 -2
  224. package/dist/modules/grid_price_source.d.ts +1 -1
  225. package/dist/modules/key_store.d.ts +14 -8
  226. package/dist/modules/key_store.js +7 -6
  227. package/dist/modules/launcher/adapter_requirement.d.ts +11 -5
  228. package/dist/modules/launcher/adapter_requirement.js +5 -5
  229. package/dist/modules/launcher/bot_supervisor.d.ts +106 -24
  230. package/dist/modules/launcher/bot_supervisor.js +12 -11
  231. package/dist/modules/launcher/credential_bootstrap.d.ts +1 -1
  232. package/dist/modules/launcher/credential_bootstrap.js +1 -1
  233. package/dist/modules/launcher/credential_daemon.d.ts +4 -4
  234. package/dist/modules/launcher/credential_daemon.js +2 -2
  235. package/dist/modules/launcher/credential_secret.d.ts +1 -1
  236. package/dist/modules/launcher/foreign_cred_daemon.d.ts +2 -2
  237. package/dist/modules/launcher/market_adapter_runtime.d.ts +61 -6
  238. package/dist/modules/launcher/market_adapter_watchdog.d.ts +10 -2
  239. package/dist/modules/launcher/market_adapter_watchdog.js +4 -0
  240. package/dist/modules/launcher/monolithic_runtime.d.ts +18 -16
  241. package/dist/modules/launcher/status_reporting.d.ts +22 -14
  242. package/dist/modules/launcher/supervisor_control.d.ts +8 -1
  243. package/dist/modules/launcher/supervisor_control.js +4 -2
  244. package/dist/modules/market_adapter_whitelist.d.ts +9 -3
  245. package/dist/modules/market_adapter_whitelist.js +15 -3
  246. package/dist/modules/node_manager.d.ts +41 -11
  247. package/dist/modules/node_manager.js +5 -4
  248. package/dist/modules/order/accounting.d.ts +53 -24
  249. package/dist/modules/order/accounting.js +16 -15
  250. package/dist/modules/order/async_lock.d.ts +5 -2
  251. package/dist/modules/order/async_lock.js +1 -1
  252. package/dist/modules/order/export.d.ts +7 -6
  253. package/dist/modules/order/export.js +1 -7
  254. package/dist/modules/order/format.d.ts +4 -4
  255. package/dist/modules/order/genesis_policy.d.ts +21 -18
  256. package/dist/modules/order/genesis_policy.js +12 -8
  257. package/dist/modules/order/grid.d.ts +142 -36
  258. package/dist/modules/order/grid.js +148 -123
  259. package/dist/modules/order/grid_reconcile.d.ts +21 -20
  260. package/dist/modules/order/grid_reconcile.js +13 -12
  261. package/dist/modules/order/grid_reconcile_internal.d.ts +85 -72
  262. package/dist/modules/order/grid_reconcile_internal.js +28 -19
  263. package/dist/modules/order/index.d.ts +263 -1
  264. package/dist/modules/order/logger.d.ts +45 -11
  265. package/dist/modules/order/logger.js +38 -40
  266. package/dist/modules/order/logger_state.d.ts +4 -4
  267. package/dist/modules/order/manager.d.ts +225 -180
  268. package/dist/modules/order/manager.js +80 -83
  269. package/dist/modules/order/processed_fill_store.d.ts +18 -3
  270. package/dist/modules/order/processed_fill_store.js +16 -27
  271. package/dist/modules/order/strategy.d.ts +21 -13
  272. package/dist/modules/order/strategy.js +5 -6
  273. package/dist/modules/order/sync_engine.d.ts +91 -33
  274. package/dist/modules/order/sync_engine.js +84 -53
  275. package/dist/modules/order/utils/math.d.ts +157 -102
  276. package/dist/modules/order/utils/math.js +77 -38
  277. package/dist/modules/order/utils/order.d.ts +310 -110
  278. package/dist/modules/order/utils/order.js +122 -99
  279. package/dist/modules/order/utils/slot.d.ts +1 -1
  280. package/dist/modules/order/utils/system.d.ts +176 -26
  281. package/dist/modules/order/utils/system.js +86 -69
  282. package/dist/modules/order/utils/validate.d.ts +89 -41
  283. package/dist/modules/order/utils/validate.js +24 -22
  284. package/dist/modules/order/utils/withPoolRef.d.ts +4 -3
  285. package/dist/modules/order/utils/withPoolRef.js +18 -12
  286. package/dist/modules/order/working_grid.d.ts +14 -13
  287. package/dist/modules/paths.d.ts +1 -4
  288. package/dist/modules/paths.js +1 -27
  289. package/dist/modules/process_discovery.d.ts +1 -1
  290. package/dist/modules/process_discovery.js +2 -1
  291. package/dist/modules/runtime.d.ts +7 -3
  292. package/dist/modules/runtime.js +4 -3
  293. package/dist/modules/runtime_settings.d.ts +15 -10
  294. package/dist/modules/runtime_settings.js +30 -24
  295. package/dist/modules/settings_merge.d.ts +29 -3
  296. package/dist/modules/settings_merge.js +56 -78
  297. package/dist/modules/socket_json_client.d.ts +7 -4
  298. package/dist/modules/storage/browser_adapter.d.ts +38 -53
  299. package/dist/modules/storage/browser_adapter.js +7 -30
  300. package/dist/modules/storage/index.d.ts +1 -1
  301. package/dist/modules/storage/node_adapter.d.ts +45 -27
  302. package/dist/modules/storage/node_adapter.js +9 -9
  303. package/dist/modules/storage/types.d.ts +5 -4
  304. package/dist/modules/types.d.ts +1071 -2
  305. package/dist/modules/types.js +4 -1
  306. package/dist/modules/utils/asset_symbols.d.ts +2 -1
  307. package/dist/modules/utils/asset_symbols.js +2 -1
  308. package/dist/modules/utils/errors.d.ts +9 -0
  309. package/dist/modules/utils/errors.js +23 -1
  310. package/dist/modules/utils/time_range.d.ts +1 -12
  311. package/dist/modules/utils/time_range.js +1 -1
  312. package/dist/modules/validate_profiles.js +53 -43
  313. package/dist/modules/version_notice.d.ts +14 -3
  314. package/dist/modules/version_notice.js +6 -4
  315. package/dist/pm2.d.ts +29 -27
  316. package/dist/pm2.js +5 -5
  317. package/dist/scripts/analyze-credit.d.ts +2 -1
  318. package/dist/scripts/analyze-credit.js +23 -24
  319. package/dist/scripts/analyze-orders.d.ts +77 -9
  320. package/dist/scripts/analyze-orders.js +65 -40
  321. package/dist/scripts/chart_command.d.ts +27 -18
  322. package/dist/scripts/chart_command.js +13 -11
  323. package/dist/scripts/check_any.d.ts +18 -0
  324. package/dist/scripts/check_any.js +126 -0
  325. package/dist/scripts/diagnose-pool-history.js +12 -7
  326. package/dist/scripts/print_grid.js +0 -1
  327. package/dist/scripts/run-tests.js +39 -7
  328. package/dist/scripts/runner.js +1 -1
  329. package/dist/scripts/test-credit-renewal.js +30 -21
  330. package/dist/scripts/update.d.ts +10 -5
  331. package/dist/scripts/update.js +168 -103
  332. package/dist/scripts/update_dist_freshness.js +1 -0
  333. package/dist/scripts/update_layout.d.ts +61 -0
  334. package/dist/scripts/update_layout.js +180 -0
  335. package/dist/scripts/validate_bots.js +2 -1
  336. package/dist/scripts/verify-browser-bundle.js +8 -0
  337. package/dist/unlock.d.ts +28 -3
  338. package/dist/unlock.js +63 -35
  339. package/docs/BITSHARES_ONBOARDING.md +2 -0
  340. package/docs/COPY_ON_WRITE_MASTER_PLAN.md +1 -1
  341. package/docs/COW_INVARIANTS.md +13 -6
  342. package/docs/DEXBOT_COMPARISON.md +8 -8
  343. package/docs/EVOLUTION.md +10 -9
  344. package/docs/FUND_MOVEMENT_AND_ACCOUNTING.md +5 -5
  345. package/docs/GRID_RECALCULATION.md +4 -2
  346. package/docs/GRID_RECONCILE.md +14 -3
  347. package/docs/LIFECYCLE.md +11 -11
  348. package/docs/MPA_CREDIT_USAGE.md +22 -3
  349. package/docs/README.md +14 -3
  350. package/docs/architecture.md +12 -9
  351. package/docs/developer_guide.md +6 -6
  352. package/market_adapter/README.md +6 -1
  353. package/modules/README.md +4 -1
  354. package/package.json +4 -1
@@ -82,7 +82,7 @@ import cowRuntime from './dexbot_cow_runtime.js';
82
82
  import { ProcessedFillStore, PROCESSED_FILL_PERSISTENCE_MODES } from './order/processed_fill_store.js';
83
83
  import { TIMING, DAEMON_CODES, } from './constants.js';
84
84
  import { normalizeBotEntry } from './bot_settings.js';
85
- import { getErrorMessage } from './utils/errors.js';
85
+ import { getErrorMessage, getErrorCode } from './utils/errors.js';
86
86
  function waitForConnected(...args) { return require('./bitshares_client').waitForConnected(...args); }
87
87
  function getKeyStore(...args) { return require('./key_store').getKeyStore(...args); }
88
88
  function hasExecutableActions(...args) { return require('./order/utils/validate').hasExecutableActions(...args); }
@@ -90,6 +90,7 @@ function getRecalculateTriggerFile(...args) { return require('./paths').getRecal
90
90
  function cloneWeightDistribution(...args) { return require('./order/utils/math').cloneWeightDistribution(...args); }
91
91
  function resolveBotRuntimeSettings(...args) { return require('./runtime_settings').resolveBotRuntimeSettings(...args); }
92
92
  class DEXBot {
93
+ static normalizeBotEntry;
93
94
  config;
94
95
  _baseWeightDistribution;
95
96
  account;
@@ -148,6 +149,13 @@ class DEXBot {
148
149
  _deferredFillRetryTimer;
149
150
  _lastTargetedDriftSyncAt;
150
151
  _lightweightSyncCheckAt;
152
+ _lastUncertainResyncAt;
153
+ _lastResolvedPollIntervalMs;
154
+ _fillBroadcastDeferSince;
155
+ _fillBroadcastDeferRegionAt;
156
+ _fillTotalsParkedFills;
157
+ _fillTotalsRetryTimer;
158
+ _fillTotalsRetryDelayMs;
151
159
  _targetedDriftSyncCooldownMs;
152
160
  _maintenanceCooldownCycles;
153
161
  _lastGridActivityAt;
@@ -162,6 +170,42 @@ class DEXBot {
162
170
  _lastBroadcastHeartbeatAt;
163
171
  _lastDeferredDustCount;
164
172
  _currentBatchId;
173
+ // --- runtime-assigned members (declared so DEXBot structurally satisfies BotLike) ---
174
+ assets;
175
+ botKey;
176
+ name;
177
+ _blockchainFetchIntervalMin;
178
+ _deferredFillRetryDelayMs;
179
+ _deferredFillRetryWaits;
180
+ _fillTotalsRetryAttempt;
181
+ _gridLockHoldWarnAt;
182
+ _gridModule;
183
+ _gridPriceInvariantRejectStreak;
184
+ _gridReconcileModule;
185
+ _lastDeferredHoldResyncAt;
186
+ _lastGridPriceInvariantResyncAt;
187
+ _lastHeldChainOrderSignature;
188
+ _lastHeldChainOrderSignatureSince;
189
+ _lastHeldChainOrderWarnAt;
190
+ _lastSpreadStaleResyncAt;
191
+ _marketAdapterWatchdogInFlight;
192
+ _outOfSpreadSince;
193
+ _outOfSpreadStaleWarned;
194
+ _postRecoveryRebalanceDefers;
195
+ _skipEmptyReadConfirmDelay;
196
+ _spreadFundsExhausted;
197
+ _strandedHoldSince;
198
+ _structuralGridResyncDeferCount;
199
+ _structuralGridResyncDeferStartedAt;
200
+ _testPollIntervalMs;
201
+ _getPm2ProcessNames;
202
+ _listenForFillsHook;
203
+ _loadBotsConfigSnapshot;
204
+ _readOpenOrdersHook;
205
+ _startMarketAdapterPm2;
206
+ _stopMarketAdapterPm2;
207
+ _submitCancelOrder;
208
+ _syncMarketAdapterHook;
165
209
  /**
166
210
  * Create a new DEXBot instance
167
211
  * @param {Object} config - Bot configuration from profiles/bots.json
@@ -188,8 +232,8 @@ class DEXBot {
188
232
  this.config.cowPerformance = rs.cowPerformance;
189
233
  this.config.pipelineTiming = rs.pipelineTiming;
190
234
  this.config.logging = rs.logging;
191
- this._fillDedupeWindowMs = this.config.timing.FILL_DEDUPE_WINDOW_MS;
192
- this._fillRecordRetentionMs = this.config.timing.FILL_RECORD_RETENTION_MS;
235
+ this._fillDedupeWindowMs = this.config.timing?.FILL_DEDUPE_WINDOW_MS;
236
+ this._fillRecordRetentionMs = this.config.timing?.FILL_RECORD_RETENTION_MS;
193
237
  this._processedFillPersistBatchMs = TIMING.PROCESSED_FILL_PERSIST_BATCH_MS;
194
238
  this._processedFillPersistBatchSize = TIMING.PROCESSED_FILL_PERSIST_BATCH_SIZE;
195
239
  this._processedFillStore = new ProcessedFillStore({
@@ -217,6 +261,8 @@ class DEXBot {
217
261
  fillProcessingTimeMs: 0,
218
262
  batchesExecuted: 0,
219
263
  lockContentionEvents: 0,
264
+ gridLockContention: 0,
265
+ fundRecalcCount: 0,
220
266
  maxQueueDepth: 0
221
267
  };
222
268
  // Shutdown state
@@ -261,7 +307,7 @@ class DEXBot {
261
307
  this._deferredFillRetryTimer = null;
262
308
  this._lastTargetedDriftSyncAt = 0;
263
309
  this._lightweightSyncCheckAt = 0;
264
- this._targetedDriftSyncCooldownMs = this.config.timing.TARGETED_DRIFT_SYNC_COOLDOWN_MS;
310
+ this._targetedDriftSyncCooldownMs = this.config.timing?.TARGETED_DRIFT_SYNC_COOLDOWN_MS;
265
311
  this._maintenanceCooldownCycles = 0;
266
312
  this._lastGridActivityAt = 0;
267
313
  this._lastDeferredDustCount = 0;
@@ -302,7 +348,7 @@ class DEXBot {
302
348
  errors.push(`assetB must be a non-empty string, got: ${config.assetB}`);
303
349
  }
304
350
  // Validate incrementPercent
305
- const increment = config.incrementPercent;
351
+ const increment = Number(config.incrementPercent);
306
352
  if (!Number.isFinite(increment) || increment <= 0 || increment > 100) {
307
353
  errors.push(`incrementPercent must be between 0 and 100, got: ${increment}`);
308
354
  }
@@ -323,7 +369,7 @@ class DEXBot {
323
369
  this._warn(msg);
324
370
  return;
325
371
  }
326
- const line = this.logPrefix ? `${this.logPrefix} ${msg}` : msg;
372
+ const line = String(this.logPrefix ? `${this.logPrefix} ${msg}` : msg);
327
373
  const logger = this.manager?.logger;
328
374
  if (logger && typeof logger.log === 'function') {
329
375
  logger.log(line, level);
@@ -341,7 +387,7 @@ class DEXBot {
341
387
  * @private
342
388
  */
343
389
  _warn(msg) {
344
- const line = this.logPrefix ? `${this.logPrefix} ${msg}` : msg;
390
+ const line = String(this.logPrefix ? `${this.logPrefix} ${msg}` : msg);
345
391
  const logger = this.manager?.logger;
346
392
  if (logger && typeof logger.log === 'function') {
347
393
  logger.log(line, 'warn');
@@ -520,7 +566,7 @@ class DEXBot {
520
566
  _isNewFillKey(fillKey, processedFillKeys, label = '', orderId = '') {
521
567
  const now = Date.now();
522
568
  if (this._recentlyQueuedFills.has(fillKey)) {
523
- const lastProcessed = this._recentlyQueuedFills.get(fillKey);
569
+ const lastProcessed = this._recentlyQueuedFills.get(fillKey) ?? 0;
524
570
  if (now - lastProcessed < this._fillDedupeWindowMs) {
525
571
  if (label) {
526
572
  const idSuffix = orderId ? ` for ${orderId}` : '';
@@ -538,7 +584,7 @@ class DEXBot {
538
584
  /**
539
585
  * Apply replay-safe fill accounting for tracked fills (those with a valid grid order).
540
586
  * @param {Object} fill - Fill event object
541
- * @param {any} fillOp - Fill operation data
587
+ * @param {unknown} fillOp - Fill operation data
542
588
  * @param {Object} [options={}]
543
589
  * @param {string} [options.context]
544
590
  * @param {Object} [options.logger]
@@ -557,7 +603,7 @@ class DEXBot {
557
603
  /**
558
604
  * Apply replay-safe fill accounting for orphan fills (grid order not found).
559
605
  * @param {Object} fill - Fill event object
560
- * @param {any} fillOp - Fill operation data
606
+ * @param {unknown} fillOp - Fill operation data
561
607
  * @param {Object} [options={}]
562
608
  * @param {string} [options.context]
563
609
  * @param {Object} [options.logger]
@@ -949,14 +995,15 @@ class DEXBot {
949
995
  // boundary, rail-edge target, over-distance rotations): the plan
950
996
  // was refused before broadcast, so trigger the rebuild here where
951
997
  // bot context (and the wired resync entry point) exists.
952
- if (rebalanceResult?.needsResync && typeof this.manager?.requestStructuralGridResync === 'function') {
953
- const reason = String(rebalanceResult?.resyncReason || rebalanceResult?.reason || 'plan-refused');
998
+ const rbResult = rebalanceResult;
999
+ if (rbResult?.needsResync && typeof this.manager?.requestStructuralGridResync === 'function') {
1000
+ const reason = String(rbResult.resyncReason || rbResult.reason || 'plan-refused');
954
1001
  this.manager?.logger?.log?.(`[COW] Requesting structural resync: ${reason}`, 'warn');
955
1002
  try {
956
1003
  await this.manager.requestStructuralGridResync(reason, { reason });
957
1004
  }
958
1005
  catch (err) {
959
- this.manager?.logger?.log?.(`[COW] Structural resync request failed: ${err?.message || err}`, 'warn');
1006
+ this.manager?.logger?.log?.(`[COW] Structural resync request failed: ${getErrorMessage(err)}`, 'warn');
960
1007
  }
961
1008
  }
962
1009
  // Clear REBALANCING state even when there are no actions to execute.
@@ -1005,12 +1052,13 @@ class DEXBot {
1005
1052
  * @returns {{aborted: boolean}}
1006
1053
  */
1007
1054
  async _processFillsWithBatching(fills, excl, contextLabel, options = {}) {
1008
- if (!fills || fills.length === 0) {
1055
+ const fillList = fills || [];
1056
+ if (fillList.length === 0) {
1009
1057
  return { aborted: false };
1010
1058
  }
1011
1059
  const managerLog = this.manager?.logger?.log?.bind(this.manager.logger) || (() => { });
1012
1060
  const maxBatch = this._getMaxFillBatchSize();
1013
- const totalFills = fills.length;
1061
+ const totalFills = fillList.length;
1014
1062
  const useUnifiedPlan = totalFills <= maxBatch;
1015
1063
  const modeLabel = useUnifiedPlan ? 'unified' : 'chunked';
1016
1064
  managerLog(`Processing ${totalFills} filled orders (${modeLabel}, baseBatch=${useUnifiedPlan ? totalFills : maxBatch})...`, 'info');
@@ -1037,7 +1085,7 @@ class DEXBot {
1037
1085
  const remaining = totalFills - i;
1038
1086
  const currentBatchSize = useUnifiedPlan ? remaining : Math.min(maxBatch, remaining);
1039
1087
  const batchEnd = Math.min(i + currentBatchSize, totalFills);
1040
- const fillBatch = fills.slice(i, batchEnd);
1088
+ const fillBatch = fillList.slice(i, batchEnd);
1041
1089
  i = batchEnd;
1042
1090
  // Refresh the LAST-FILL guard pivot for this chunk's broadcast:
1043
1091
  // recordLastFilledPrices walks the batch in order, so the pivot
@@ -1050,11 +1098,11 @@ class DEXBot {
1050
1098
  const batchIds = fillBatch.map((f) => f.id).join(', ');
1051
1099
  const label = `${contextLabel} [${batchIds}]`;
1052
1100
  managerLog(`>>> Processing fill set ${label} (${i}/${totalFills})`, 'info');
1053
- let fullExcludeSet = excl || new Set();
1101
+ let fullExcludeSet = new Set((excl || []));
1054
1102
  if (!useUnifiedPlan) {
1055
1103
  const batchIdSet = new Set(fillBatch.map((f) => f.id));
1056
- fullExcludeSet = new Set(excl || []);
1057
- for (const other of fills) {
1104
+ fullExcludeSet = new Set((excl || []));
1105
+ for (const other of fillList) {
1058
1106
  if (batchIdSet.has(other.id))
1059
1107
  continue;
1060
1108
  if (other.orderId)
@@ -1081,7 +1129,7 @@ class DEXBot {
1081
1129
  managerLog(`[COW] ${label} rebalance deferred (broadcast active); accounting applied, boundary re-derives after the region ends`, 'debug');
1082
1130
  continue;
1083
1131
  }
1084
- const batchResult = await this._executeBatchIfNeeded(rebalanceResult, label);
1132
+ const batchResult = (await this._executeBatchIfNeeded(rebalanceResult, label));
1085
1133
  if (batchResult?.abortedForIllegalState || batchResult?.abortedForAccountingFailure) {
1086
1134
  managerLog(`[HARD-ABORT] ${label} aborted due to critical state. Skipping remaining fills.`, 'error');
1087
1135
  return { aborted: true };
@@ -1163,8 +1211,9 @@ class DEXBot {
1163
1211
  return;
1164
1212
  }
1165
1213
  try {
1166
- if (this.privateKey && getKeyStore().isDaemonSigningKey(this.privateKey)) {
1167
- await chainKeys.pingDaemon(this.privateKey.accountName, Math.min(TIMING.DAEMON_PING_TIMEOUT_MS, TIMING.DAEMON_STARTUP_TIMEOUT_MS), { socketPath: this.privateKey.socketPath });
1214
+ const signingToken = this.privateKey;
1215
+ if (signingToken && getKeyStore().isDaemonSigningKey(signingToken)) {
1216
+ await chainKeys.pingDaemon(signingToken.accountName, Math.min(TIMING.DAEMON_PING_TIMEOUT_MS, TIMING.DAEMON_STARTUP_TIMEOUT_MS), { socketPath: signingToken.socketPath });
1168
1217
  }
1169
1218
  }
1170
1219
  catch (err) {
@@ -1187,7 +1236,7 @@ class DEXBot {
1187
1236
  _isCredentialDaemonError(err) {
1188
1237
  if (!err)
1189
1238
  return false;
1190
- if (err.code === DAEMON_CODES.CREDENTIAL_DAEMON_UNAVAILABLE)
1239
+ if (getErrorCode(err) === DAEMON_CODES.CREDENTIAL_DAEMON_UNAVAILABLE)
1191
1240
  return true;
1192
1241
  const message = String(getErrorMessage(err) || '');
1193
1242
  return /Credential daemon|Daemon connection failed|daemon .*unavailable|dexbot-cred-daemon\.sock|ECONNREFUSED|ENOENT/.test(message);
@@ -1330,12 +1379,13 @@ class DEXBot {
1330
1379
  * @returns {Promise<Object>} The batch result.
1331
1380
  */
1332
1381
  async updateOrdersOnChainBatch(rebalanceResult) {
1333
- if (!rebalanceResult || !rebalanceResult.workingGrid) {
1382
+ const rb = rebalanceResult;
1383
+ if (!rb || !rb.workingGrid) {
1334
1384
  const reason = 'NON_COW_PAYLOAD';
1335
1385
  this.manager?.logger?.log?.(`[COW] Rejected non-COW batch payload. Use updateOrdersOnChainPlan() for plan inputs.`, 'error');
1336
1386
  return { executed: false, aborted: true, reason };
1337
1387
  }
1338
- return await this._updateOrdersOnChainBatchCOW(rebalanceResult);
1388
+ return await this._updateOrdersOnChainBatchCOW(rb);
1339
1389
  }
1340
1390
  /**
1341
1391
  * Converts simple plan payloads (place/update/rotate/cancel) into a COW batch.
@@ -1517,7 +1567,7 @@ class DEXBot {
1517
1567
  return DexbotMaintenanceRuntime.stopBotsConfigPollInterval(this);
1518
1568
  }
1519
1569
  async _releaseMarketAdapterRuntime(context = 'shutdown') {
1520
- return DexbotMaintenanceRuntime.releaseMarketAdapterRuntime(this, this.config?.botKey || this.config?.name, context);
1570
+ return DexbotMaintenanceRuntime.releaseMarketAdapterRuntime(this, (this.config?.botKey || this.config?.name), context);
1521
1571
  }
1522
1572
  /**
1523
1573
  * Get or create the credit runtime for debt policy management.
@@ -1673,7 +1723,7 @@ class DEXBot {
1673
1723
  const existing = Array.isArray(manager._onBroadcastRegionEndListeners)
1674
1724
  ? manager._onBroadcastRegionEndListeners
1675
1725
  : [];
1676
- if (!existing.some((fn) => fn && fn._isRegionEndDrain)) {
1726
+ if (!existing.some((fn) => !!fn._isRegionEndDrain)) {
1677
1727
  manager.addBroadcastRegionEndListener(regionEndHandler);
1678
1728
  }
1679
1729
  }
@@ -1976,7 +2026,7 @@ class DEXBot {
1976
2026
  `avgProcessingTime=${metrics.fillsProcessed > 0 ? Format.formatMetric2(metrics.fillProcessingTimeMs / metrics.fillsProcessed) : 0}ms, ` +
1977
2027
  `lockContentions=${metrics.lockContentionEvents}, maxQueueDepth=${metrics.maxQueueDepth}, ` +
1978
2028
  `heldChainOrders=${metrics.heldChainOrders ?? 0}, blockingChainOrders=${metrics.blockingChainOrders ?? 0}`);
1979
- await this.manager?.logger?.flush();
2029
+ await this.manager?.logger?.flush?.();
1980
2030
  }
1981
2031
  }
1982
2032
  DEXBot.normalizeBotEntry = normalizeBotEntry;