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
@@ -63,85 +63,138 @@
63
63
  *
64
64
  * ===============================================================================
65
65
  */
66
- declare class DEXBot {
67
- config: any;
66
+ import * as DexbotStartupRuntime from './dexbot_startup_runtime.js';
67
+ import cowRuntime from './dexbot_cow_runtime.js';
68
+ import type { ChainOrderLike, CowResult, OpPhase } from './dexbot_cow_runtime.js';
69
+ import { normalizeBotEntry } from './bot_settings.js';
70
+ import type { FillOpLike, FillLike, ReplaySafeFillAccountingOptions } from './dexbot_fill_runtime.js';
71
+ import type { BotLike, AssetPair, IncomingFill, UnknownRecord, GridConfig, OrderManagerLike, AccountOrdersLike, BotMetrics, ProcessedFillStoreLike, CreditRuntimeLike, FillBatchResult, SigningToken, SpreadCorrectionStall } from './types.js';
72
+ declare class DEXBot implements BotLike {
73
+ static normalizeBotEntry: typeof normalizeBotEntry;
74
+ config: GridConfig;
68
75
  _baseWeightDistribution: {
69
76
  sell: number;
70
77
  buy: number;
71
78
  };
72
- account: any;
79
+ account: string | null;
73
80
  accountId: string | null;
74
- privateKey: any;
75
- manager: any;
76
- accountOrders: any;
81
+ privateKey: string | SigningToken | null;
82
+ manager: OrderManagerLike;
83
+ accountOrders: AccountOrdersLike;
77
84
  triggerFile: string;
78
- _recentlyQueuedFills: Map<any, any>;
85
+ _recentlyQueuedFills: Map<string, number>;
79
86
  _fillCleanupCounter: number;
80
87
  _fillDedupeWindowMs: number;
81
88
  _fillRecordRetentionMs: number;
82
89
  _processedFillPersistBatchMs: number;
83
90
  _processedFillPersistBatchSize: number;
84
- _processedFillStore: any;
85
- _recentlyProcessedFills: any;
86
- _pendingProcessedFillWrites: any;
87
- _incomingFillQueue: any[];
91
+ _processedFillStore: ProcessedFillStoreLike;
92
+ _recentlyProcessedFills: Map<string, number>;
93
+ _pendingProcessedFillWrites: unknown;
94
+ _incomingFillQueue: IncomingFill[];
88
95
  logPrefix: string;
89
- _credentialDaemonWatchdogInterval: any;
96
+ _credentialDaemonWatchdogInterval: ReturnType<typeof setInterval> | null;
90
97
  _credentialDaemonDown: boolean;
91
98
  _credentialRecoveryNeeded: boolean;
92
99
  _credentialRecoveryInFlight: boolean;
93
100
  _credentialDaemonWatchdogInFlight: boolean;
101
+ _credentialDaemonConsecutiveFailures: number;
94
102
  _staleCleanedOrderIds: Map<string, number>;
95
103
  _staleCleanupRetentionMs: number;
96
- _metrics: any;
104
+ _metrics: BotMetrics;
97
105
  _shuttingDown: boolean;
98
106
  _shutdownPromise: Promise<void> | null;
99
- _blockchainFetchInterval: any;
107
+ _blockchainFetchInterval: ReturnType<typeof setInterval> | null;
100
108
  _blockchainFetchInFlight: number;
101
- _botsConfigPollInterval: any;
109
+ _botsConfigPollInterval: ReturnType<typeof setInterval> | null;
102
110
  _botsConfigPollInFlight: boolean;
103
111
  _marketAdapterWatchdogFingerprint: string | null;
104
112
  _appliedBotConfigFingerprint: string | null;
105
- _appliedBotConfigEntry: any;
113
+ _appliedBotConfigEntry: unknown;
106
114
  _lastBotConfigHintFingerprint: string | null;
107
- _fillsUnsubscribe: any;
108
- _triggerWatcher: any;
109
- _triggerDebounceTimer: any;
110
- _deferredGridResyncTimer: any;
111
- _maintenanceIdleTimer: any;
115
+ _fillsUnsubscribe: (() => Promise<unknown>) | null;
116
+ _triggerWatcher: {
117
+ close?: () => void;
118
+ } | null;
119
+ _triggerDebounceTimer: ReturnType<typeof setTimeout> | null;
120
+ _deferredGridResyncTimer: ReturnType<typeof setTimeout> | null;
121
+ _maintenanceIdleTimer: ReturnType<typeof setTimeout> | null;
112
122
  _mainLoopActive: boolean;
113
- _mainLoopPromise: any;
114
- _creditRuntime: any;
115
- _creditWatchdogInterval: any;
123
+ _mainLoopPromise: Promise<unknown> | null;
124
+ _creditRuntime: CreditRuntimeLike | null;
125
+ _creditWatchdogInterval: ReturnType<typeof setInterval> | null;
116
126
  _batchInFlight: number;
117
127
  _cowBroadcastInFlight: boolean;
118
128
  _recoverySyncInFlight: number;
119
129
  _deferredFillsPending: boolean;
120
- _postRecoveryRebalanceTimer: any;
121
- _deferredFillRetryTimer: any;
130
+ _postRecoveryRebalanceTimer: ReturnType<typeof setTimeout> | null;
131
+ _deferredFillRetryTimer: ReturnType<typeof setTimeout> | null;
122
132
  _lastTargetedDriftSyncAt: number;
123
133
  _lightweightSyncCheckAt: number;
134
+ _lastUncertainResyncAt: number;
135
+ _lastResolvedPollIntervalMs: number;
136
+ _fillBroadcastDeferSince: number;
137
+ _fillBroadcastDeferRegionAt: number;
138
+ _fillTotalsParkedFills: IncomingFill[];
139
+ _fillTotalsRetryTimer: ReturnType<typeof setTimeout> | null;
140
+ _fillTotalsRetryDelayMs: number;
124
141
  _targetedDriftSyncCooldownMs: number;
125
142
  _maintenanceCooldownCycles: number;
126
143
  _lastGridActivityAt: number;
127
144
  _currentCycleId: number;
128
145
  _consecutiveConsumeFailures: number;
129
146
  _consumeFailureFirstAt: number;
130
- _reconnectUnregister: any;
131
- _credentialRecoveryDeferredTimer: any;
132
- _structuralGridResyncTimer: any;
147
+ _reconnectUnregister: (() => void) | null;
148
+ _credentialRecoveryDeferredTimer: ReturnType<typeof setTimeout> | null;
149
+ _structuralGridResyncTimer: ReturnType<typeof setTimeout> | null;
133
150
  _structuralGridResyncRunning: number;
134
- _dustHealthCheckTimer: any;
151
+ _dustHealthCheckTimer: ReturnType<typeof setInterval> | null;
135
152
  _lastBroadcastHeartbeatAt: number | undefined;
136
153
  _lastDeferredDustCount: number;
137
154
  _currentBatchId: string | number | null | undefined;
155
+ assets: AssetPair | null;
156
+ botKey: string;
157
+ name: string;
158
+ _blockchainFetchIntervalMin: number;
159
+ _deferredFillRetryDelayMs: number;
160
+ _deferredFillRetryWaits: number;
161
+ _fillTotalsRetryAttempt: number;
162
+ _gridLockHoldWarnAt: number;
163
+ _gridModule: unknown;
164
+ _gridPriceInvariantRejectStreak: Map<string, number>;
165
+ _gridReconcileModule: unknown;
166
+ _lastDeferredHoldResyncAt: number;
167
+ _lastGridPriceInvariantResyncAt: number;
168
+ _lastHeldChainOrderSignature: string | null;
169
+ _lastHeldChainOrderSignatureSince: number;
170
+ _lastHeldChainOrderWarnAt: number;
171
+ _lastSpreadStaleResyncAt: number;
172
+ _marketAdapterWatchdogInFlight: boolean;
173
+ _outOfSpreadSince: number;
174
+ _outOfSpreadStaleWarned: boolean;
175
+ _postRecoveryRebalanceDefers: number;
176
+ _skipEmptyReadConfirmDelay: boolean;
177
+ _spreadFundsExhausted: boolean;
178
+ _spreadCorrectionStall: SpreadCorrectionStall | null;
179
+ _strandedHoldSince: Map<string, number>;
180
+ _structuralGridResyncDeferCount: number;
181
+ _structuralGridResyncDeferStartedAt: number;
182
+ _testPollIntervalMs: number;
183
+ _getPm2ProcessNames: (...args: unknown[]) => Promise<string[]>;
184
+ _listenForFillsHook: (...args: unknown[]) => unknown;
185
+ _loadBotsConfigSnapshot: (...args: unknown[]) => unknown;
186
+ _readOpenOrdersHook: (...args: unknown[]) => unknown;
187
+ _startMarketAdapterPm2: (...args: unknown[]) => unknown;
188
+ _stopMarketAdapterPm2: (...args: unknown[]) => unknown;
189
+ _submitCancelOrder: (...args: unknown[]) => unknown;
190
+ _syncMarketAdapterHook: (...args: unknown[]) => unknown;
138
191
  /**
139
192
  * Create a new DEXBot instance
140
193
  * @param {Object} config - Bot configuration from profiles/bots.json
141
194
  * @param {Object} options - Optional settings
142
195
  * @param {string} options.logPrefix - Prefix for console logs (e.g., "[bot.js]")
143
196
  */
144
- constructor(config: any, options?: {
197
+ constructor(config: GridConfig, options?: {
145
198
  logPrefix?: string;
146
199
  });
147
200
  /**
@@ -151,20 +204,20 @@ declare class DEXBot {
151
204
  * @throws {Error} If critical validation fails
152
205
  * @private
153
206
  */
154
- _validateStartupConfig(config: any): void;
207
+ _validateStartupConfig(config: Record<string, unknown>): void;
155
208
  /**
156
209
  * Log a message to the console with the bot's prefix.
157
210
  * @param {string} msg - The message to log.
158
211
  * @param {string} [level='info'] - The log level ('debug', 'info', 'warn', 'error').
159
212
  * @private
160
213
  */
161
- _log(msg: any, level?: any): void;
214
+ _log(msg: unknown, level?: string): void;
162
215
  /**
163
216
  * Log a warning message to the console with the bot's prefix.
164
217
  * @param {string} msg - The message to log.
165
218
  * @private
166
219
  */
167
- _warn(msg: any): void;
220
+ _warn(msg: unknown): void;
168
221
  /**
169
222
  * Persist the grid and trigger immediate recovery if validation fails.
170
223
  * Used during startup to ensure bot begins in a stable state.
@@ -184,30 +237,30 @@ declare class DEXBot {
184
237
  * @returns {{incomingFillQueueLength: number, shadowLocks: number, batchInFlight: boolean, recoveryInFlight: boolean, broadcasting: boolean}}
185
238
  */
186
239
  _getPipelineSignals(): {
187
- incomingFillQueueLength: any;
188
- shadowLocks: any;
240
+ incomingFillQueueLength: number;
241
+ shadowLocks: number;
189
242
  batchInFlight: boolean;
190
243
  recoveryInFlight: boolean;
191
- broadcasting: any;
244
+ broadcasting: boolean;
192
245
  };
193
246
  /**
194
247
  * Mark that grid activity occurred (updates idle timer).
195
248
  * @param {string} [reason='activity'] - Reason for activity
196
249
  * @returns {void}
197
250
  */
198
- _markGridActivity(reason?: any): void;
251
+ _markGridActivity(reason?: string): void;
199
252
  /**
200
253
  * Trigger a full state recovery sync (fetch chain + sync from open orders + persist).
201
254
  * @param {string} [reason='state recovery sync'] - Reason for recovery
202
255
  * @returns {Promise<void>}
203
256
  */
204
- _triggerStateRecoverySync(reason?: any): Promise<void>;
257
+ _triggerStateRecoverySync(reason?: string): Promise<void>;
205
258
  /**
206
259
  * Abort the current flow if an illegal state signal was raised.
207
260
  * @param {string} flowContext - Description of the flow being aborted
208
261
  * @returns {Promise<boolean>} True if flow was aborted
209
262
  */
210
- _abortFlowIfIllegalState(flowContext: any): Promise<boolean>;
263
+ _abortFlowIfIllegalState(flowContext: string): Promise<boolean>;
211
264
  /**
212
265
  * Handle a hard abort from batch processing due to illegal state or accounting failure.
213
266
  * @param {Error} err - The error that triggered the abort
@@ -215,7 +268,7 @@ declare class DEXBot {
215
268
  * @param {number} [opsCount=0] - Number of operations in the batch
216
269
  * @returns {Promise<Object>} Abort result object
217
270
  */
218
- _handleBatchHardAbort(err: any, phase?: any, opsCount?: any): Promise<{
271
+ _handleBatchHardAbort(err: unknown, phase?: string, opsCount?: number): Promise<{
219
272
  abortedForAccountingFailure: boolean;
220
273
  executed: boolean;
221
274
  hadRotation: boolean;
@@ -230,14 +283,14 @@ declare class DEXBot {
230
283
  * @param {string} [context='recoverable-grid-update'] - Context label for logging
231
284
  * @returns {Promise<number>} Number of updates applied
232
285
  */
233
- _applyRecoverableGridUpdates(updates: any, context?: any): Promise<number>;
286
+ _applyRecoverableGridUpdates(updates: unknown[], context?: string): Promise<number>;
234
287
  /**
235
288
  * Recover from explicit stale order errors by virtualizing affected grid slots.
236
289
  * @param {Set<string>|string[]} staleOrderIds - Set or array of stale chain order IDs
237
290
  * @param {string} [reason='stale order cleanup'] - Reason for cleanup
238
291
  * @returns {Promise<{executed: boolean, hadRotation: boolean, stale: boolean, recoveredByVirtualization?: boolean}>}
239
292
  */
240
- _recoverExplicitStaleOrders(staleOrderIds: any, reason?: any): Promise<{
293
+ _recoverExplicitStaleOrders(staleOrderIds: unknown, reason?: string): Promise<{
241
294
  executed: boolean;
242
295
  hadRotation: boolean;
243
296
  stale: boolean;
@@ -253,7 +306,7 @@ declare class DEXBot {
253
306
  * @param {Error} err - The size drift error
254
307
  * @returns {Promise<{executed: boolean, hadRotation: boolean, recoveredBySync: boolean, reason: string}>}
255
308
  */
256
- _recoverBatchSizeDrift(err: any, opContexts?: any): Promise<{
309
+ _recoverBatchSizeDrift(err: unknown, opContexts?: unknown[]): Promise<{
257
310
  executed: boolean;
258
311
  hadRotation: boolean;
259
312
  recoveredBySync: boolean;
@@ -291,7 +344,7 @@ declare class DEXBot {
291
344
  * @param {'startup'|'recovery'} context - Controls log prefix.
292
345
  * @returns {Promise<boolean>} True if the snapshot was rejected (cleared).
293
346
  */
294
- _rejectCorruptedGridSnapshot(context: any): Promise<boolean>;
347
+ _rejectCorruptedGridSnapshot(context: string): Promise<boolean>;
295
348
  /**
296
349
  * Attempt to repair size-drift for specific order IDs by reading their
297
350
  * current on-chain state and correcting the local grid directly.
@@ -299,7 +352,7 @@ declare class DEXBot {
299
352
  * @param {string[]} orderIds
300
353
  * @returns {Promise<boolean>} True if all affected orders were repaired
301
354
  */
302
- _targetedOrderRepair(orderIds: any): Promise<boolean>;
355
+ _targetedOrderRepair(orderIds: string[]): Promise<boolean>;
303
356
  /**
304
357
  * Initialize bot state from storage and blockchain.
305
358
  * Consolidates common initialization logic for start() and startWithPrivateKey().
@@ -307,13 +360,13 @@ declare class DEXBot {
307
360
  * @private
308
361
  */
309
362
  _initializeStartupState(): Promise<{
310
- persistedGrid: any;
311
- persistedBtsFeesOwed: any;
312
- persistedBoundaryIdx: any;
313
- persistedBtsBalance: any;
314
- persistedRecentFillKeys: any;
315
- persistedGenesis: any;
316
- persistedGapEvacStreaks: any;
363
+ persistedGrid: unknown[] | null;
364
+ persistedBtsFeesOwed: unknown;
365
+ persistedBoundaryIdx: number | null;
366
+ persistedBtsBalance: unknown;
367
+ persistedRecentFillKeys: unknown;
368
+ persistedGenesis: {} | null;
369
+ persistedGapEvacStreaks: {} | null;
317
370
  }>;
318
371
  /**
319
372
  * Wire processed fill tracking into the manager.
@@ -326,7 +379,7 @@ declare class DEXBot {
326
379
  * @param {Object} [options={}] - Flush options
327
380
  * @returns {Promise<void>}
328
381
  */
329
- _flushProcessedFillPersistence(reason?: any, options?: any): Promise<void>;
382
+ _flushProcessedFillPersistence(reason?: string, options?: Record<string, unknown>): Promise<void>;
330
383
  /**
331
384
  * Flush persistence for specific fill keys.
332
385
  * @param {Set<string>|string[]} fillKeys - Fill keys to persist
@@ -334,18 +387,18 @@ declare class DEXBot {
334
387
  * @param {Object} [options={}] - Flush options
335
388
  * @returns {Promise<void>}
336
389
  */
337
- _flushProcessedFillPersistenceForKeys(fillKeys: any, reason?: any, options?: any): Promise<void>;
390
+ _flushProcessedFillPersistenceForKeys(fillKeys: string[] | Set<string>, reason?: string, options?: Record<string, unknown>): Promise<void>;
338
391
  /**
339
392
  * Build a fallback deduplication key for an orphan fill (when standard keys are unavailable).
340
393
  * @param {Object} fill - Fill event object
341
394
  * @returns {string|null} Fallback key or null
342
395
  */
343
- _buildOrphanFillFallbackKey(fill: any): string | null;
344
- _isNewFillKey(fillKey: any, processedFillKeys: any, label?: any, orderId?: any): boolean;
396
+ _buildOrphanFillFallbackKey(fill: FillLike): string | null;
397
+ _isNewFillKey(fillKey: string, processedFillKeys: Set<string>, label?: string, orderId?: string): boolean;
345
398
  /**
346
399
  * Apply replay-safe fill accounting for tracked fills (those with a valid grid order).
347
400
  * @param {Object} fill - Fill event object
348
- * @param {any} fillOp - Fill operation data
401
+ * @param {unknown} fillOp - Fill operation data
349
402
  * @param {Object} [options={}]
350
403
  * @param {string} [options.context]
351
404
  * @param {Object} [options.logger]
@@ -353,12 +406,7 @@ declare class DEXBot {
353
406
  * @param {string} [options.persistenceMode='batched']
354
407
  * @returns {Promise<any>}
355
408
  */
356
- _applyReplaySafeTrackedFillAccounting(fill: any, fillOp: any, { context, logger, replayMessage, persistenceMode }?: {
357
- context?: string;
358
- logger?: any;
359
- replayMessage?: any;
360
- persistenceMode?: any;
361
- }): Promise<{
409
+ _applyReplaySafeTrackedFillAccounting(fill: unknown, fillOp: FillOpLike, options?: ReplaySafeFillAccountingOptions): Promise<{
362
410
  status: string;
363
411
  fillKey: any;
364
412
  usedFallbackKey?: undefined;
@@ -371,13 +419,13 @@ declare class DEXBot {
371
419
  } | {
372
420
  status: string;
373
421
  fillKey: any;
374
- error: any;
422
+ error: unknown;
375
423
  usedFallbackKey?: undefined;
376
424
  }>;
377
425
  /**
378
426
  * Apply replay-safe fill accounting for orphan fills (grid order not found).
379
427
  * @param {Object} fill - Fill event object
380
- * @param {any} fillOp - Fill operation data
428
+ * @param {unknown} fillOp - Fill operation data
381
429
  * @param {Object} [options={}]
382
430
  * @param {string} [options.context]
383
431
  * @param {Object} [options.logger]
@@ -385,12 +433,7 @@ declare class DEXBot {
385
433
  * @param {string} [options.persistenceMode='batched']
386
434
  * @returns {Promise<any>}
387
435
  */
388
- _applyReplaySafeOrphanFillAccounting(fill: any, fillOp: any, { context, logger, replayMessage, persistenceMode }?: {
389
- context?: string;
390
- logger?: any;
391
- replayMessage?: any;
392
- persistenceMode?: any;
393
- }): Promise<{
436
+ _applyReplaySafeOrphanFillAccounting(fill: unknown, fillOp: FillOpLike, options?: ReplaySafeFillAccountingOptions): Promise<{
394
437
  status: string;
395
438
  fillKey: any;
396
439
  usedFallbackKey?: undefined;
@@ -403,7 +446,7 @@ declare class DEXBot {
403
446
  } | {
404
447
  status: string;
405
448
  fillKey: any;
406
- error: any;
449
+ error: unknown;
407
450
  usedFallbackKey?: undefined;
408
451
  }>;
409
452
  /**
@@ -411,7 +454,7 @@ declare class DEXBot {
411
454
  * @param {string} [context='runtime'] - Context label for logging
412
455
  * @returns {any|null}
413
456
  */
414
- _refreshDynamicWeightDistribution(context?: any): {
457
+ _refreshDynamicWeightDistribution(context?: string): {
415
458
  applied: boolean;
416
459
  source: string;
417
460
  weightDistribution: any;
@@ -420,7 +463,7 @@ declare class DEXBot {
420
463
  applied: boolean;
421
464
  source: string;
422
465
  weightDistribution: any;
423
- snapshotUpdatedAt: any;
466
+ snapshotUpdatedAt: {} | null;
424
467
  };
425
468
  /**
426
469
  * Finalize the bot startup after account and initial grid sync are complete.
@@ -428,7 +471,7 @@ declare class DEXBot {
428
471
  * @param {Object} startupState - The startup state from _initializeStartupState.
429
472
  * @private
430
473
  */
431
- _finishStartupSequence(startupState: any): Promise<void>;
474
+ _finishStartupSequence(startupState: Parameters<typeof DexbotStartupRuntime.finishStartupSequence>[1]): Promise<void>;
432
475
  /**
433
476
  * Create the fill callback for listenForFills.
434
477
  * Separated from start() to allow deferred activation after startup completes.
@@ -436,23 +479,23 @@ declare class DEXBot {
436
479
  * @returns {Function} Async callback for processing fills
437
480
  * @private
438
481
  */
439
- _createFillCallback(chainOrders: any): (fills: any) => Promise<void>;
482
+ _createFillCallback(chainOrders: typeof import('./chain_orders.js')): (fills: IncomingFill[]) => Promise<void>;
440
483
  /**
441
484
  * Read open orders from chain, sync with local state, and process any fills found.
442
485
  * Shared helper used by post-reset spread check and targeted drift reconciliation.
443
486
  * @param {string} tag - Context label for logging
444
487
  * @returns {Promise<{syncResult: Object|null, aborted: boolean, hasUnmatched: number, openOrders: Array|null}>}
445
488
  */
446
- _syncOpenOrdersAndProcessFills(tag: any): Promise<{
489
+ _syncOpenOrdersAndProcessFills(tag: string): Promise<{
447
490
  syncResult: null;
448
491
  aborted: boolean;
449
492
  hasUnmatched: number;
450
493
  openOrders: null;
451
494
  } | {
452
- syncResult: any;
495
+ syncResult: import("./types.js").SyncResult;
453
496
  aborted: boolean;
454
- hasUnmatched: any;
455
- openOrders: any[];
497
+ hasUnmatched: number;
498
+ openOrders: import("./types.js").ChainOrder[];
456
499
  }>;
457
500
  /**
458
501
  * Schedule the fill-consumer restart after the failure budget
@@ -462,7 +505,7 @@ declare class DEXBot {
462
505
  * @param {Object} chainOrders - Chain orders module for blockchain operations
463
506
  * @private
464
507
  */
465
- _scheduleFillConsumerRestart(chainOrders: any): void;
508
+ _scheduleFillConsumerRestart(chainOrders: typeof import('./chain_orders.js')): void;
466
509
  /**
467
510
  * Consume queued fills from incomingFillQueue and rebalance.
468
511
  *
@@ -476,7 +519,7 @@ declare class DEXBot {
476
519
  * @param {Object} chainOrders - Chain orders module for blockchain operations
477
520
  * @private
478
521
  */
479
- _consumeFillQueue(chainOrders: any): Promise<void>;
522
+ _consumeFillQueue(chainOrders: typeof import('./chain_orders.js')): Promise<void>;
480
523
  /**
481
524
  * Process fills during bootstrap phase using the standard fill pipeline.
482
525
  *
@@ -497,20 +540,20 @@ declare class DEXBot {
497
540
  * @param {Object} chainOrders - Chain orders instance for broadcasting
498
541
  * @returns {Promise<void>}
499
542
  */
500
- _processFillsWithBootstrapMode(chainOrders: any): Promise<void>;
543
+ _processFillsWithBootstrapMode(chainOrders: typeof import('./chain_orders.js')): Promise<void>;
501
544
  /**
502
545
  * Set up account identifier and configure global context.
503
546
  * @param {string} accountName - The name of the account to set up
504
547
  * @private
505
548
  */
506
- _setupAccountContext(accountName: any): Promise<void>;
549
+ _setupAccountContext(accountName: string): Promise<void>;
507
550
  /**
508
551
  * Initialize the bot by connecting to BitShares and setting up the account.
509
552
  * @param {string|Object|Buffer} [vaultSecret=null] - The unlock secret for authentication.
510
553
  * @returns {Promise<void>}
511
554
  * @throws {Error} If initialization fails or preferredAccount is missing.
512
555
  */
513
- initialize(vaultSecret?: any): Promise<void>;
556
+ initialize(vaultSecret?: string | null): Promise<void>;
514
557
  /**
515
558
  * Places initial orders on the blockchain.
516
559
  * @returns {Promise<void>}
@@ -521,13 +564,13 @@ declare class DEXBot {
521
564
  * @param {Array<Object>} orders - Array of order objects
522
565
  * @returns {Array<Array<Object>>} Grouped order arrays
523
566
  */
524
- _buildOutsideInPairGroupsForOrders(orders: any): any;
567
+ _buildOutsideInPairGroupsForOrders(orders: unknown[]): unknown[][];
525
568
  /**
526
569
  * Build outside-in pair groups for create entry contexts.
527
570
  * @param {Array<Object>} createEntries - Array of create entry objects with context.order
528
571
  * @returns {Array<Array<Object>>} Grouped entry arrays
529
572
  */
530
- _buildOutsideInPairGroupsForCreateEntries(createEntries: any): any;
573
+ _buildOutsideInPairGroupsForCreateEntries(createEntries: unknown[]): unknown[][];
531
574
  /**
532
575
  * Resolve the fill/broadcast batch size from the grid gap-slot count.
533
576
  *
@@ -578,14 +621,14 @@ declare class DEXBot {
578
621
  * @param {Array<{index:number, ctx:Object}>} missingCreateResults - Missing CREATE results.
579
622
  * @returns {void}
580
623
  */
581
- _markMissingCreateResultsAsStructuralBlocker(missingCreateResults: any): void;
624
+ _markMissingCreateResultsAsStructuralBlocker(missingCreateResults: unknown): void;
582
625
  /**
583
626
  * Format an unmatched chain order/blocker for COW logs.
584
627
  *
585
628
  * @param {Object} order - Unmatched chain order or structural blocker.
586
629
  * @returns {string} Compact human-readable diagnostic.
587
630
  */
588
- _formatUnmatchedChainOrderForLog(order: any): any;
631
+ _formatUnmatchedChainOrderForLog(order: unknown): string;
589
632
  /**
590
633
  * Record a pending CREATE broadcast on the manager.
591
634
  *
@@ -606,7 +649,7 @@ declare class DEXBot {
606
649
  * @param {Object} entry.finalInts - { amountToSell, minToReceive, ... } blockchain integers
607
650
  * @returns {void}
608
651
  */
609
- _recordPendingBroadcast(entry: any): string | null;
652
+ _recordPendingBroadcast(entry: unknown): string | null;
610
653
  /**
611
654
  * Clear the pending-broadcast cache.
612
655
  *
@@ -631,7 +674,7 @@ declare class DEXBot {
631
674
  * @param {Object} planned - { sell, receive, orderType } integers from the planned op
632
675
  * @returns {Object|null} Matching chain order, or null
633
676
  */
634
- _findChainOrderForSlot(chainOrders: any, slotId: any, planned: any): any;
677
+ _findChainOrderForSlot(chainOrders: ChainOrderLike[], slotId: string, planned: Parameters<typeof cowRuntime.findChainOrderForSlot>[3]): ChainOrderLike | null;
635
678
  /**
636
679
  * Reconcile a broadcast whose chain state is unknown.
637
680
  *
@@ -658,7 +701,12 @@ declare class DEXBot {
658
701
  * @param {Array<Object>} opContexts - Original opContexts from the failed batch
659
702
  * @returns {Promise<Object>} Result object compatible with batch return shape
660
703
  */
661
- _reconcileAfterUncertainBroadcast(err: any, opContexts: any, options?: Record<string, any>): Promise<any>;
704
+ _reconcileAfterUncertainBroadcast(err: unknown, opContexts: OpPhase[], options?: UnknownRecord): Promise<UnknownRecord | {
705
+ executed: boolean;
706
+ hadRotation: boolean;
707
+ uncertain: boolean;
708
+ ambiguousRead: boolean;
709
+ }>;
662
710
  /**
663
711
  * Execute operations with retry on BroadcastUncertainError.
664
712
  * The daemon already retries internally against a 25s deadline. If it
@@ -672,9 +720,9 @@ declare class DEXBot {
672
720
  * execution where earlier groups already committed). Re-broadcasting
673
721
  * the full operations array would duplicate those creates on chain.
674
722
  */
675
- _executeWithRetryOnUncertain(operations: any, opContexts: any): Promise<{
676
- result: any;
677
- opContexts: any;
723
+ _executeWithRetryOnUncertain(operations: unknown[], opContexts: OpPhase[]): Promise<{
724
+ result: unknown;
725
+ opContexts: OpPhase[];
678
726
  }>;
679
727
  /**
680
728
  * Execute operations with retry-on-uncertain semantics AND a per-broadcast
@@ -685,9 +733,9 @@ declare class DEXBot {
685
733
  * @param {Array<Object>} opContexts - Array of operation context metadata (1:1 with operations)
686
734
  * @returns {Promise<{result: Object, opContexts: Array}>} Execution result with contexts
687
735
  */
688
- _executeChunkedWithRetryOnUncertain(operations: any, opContexts: any): Promise<{
689
- result: any;
690
- opContexts: any;
736
+ _executeChunkedWithRetryOnUncertain(operations: unknown[], opContexts: OpPhase[]): Promise<{
737
+ result: unknown;
738
+ opContexts: OpPhase[];
691
739
  }>;
692
740
  /**
693
741
  * Execute a batch of order operations if the rebalance result has executable actions.
@@ -695,7 +743,7 @@ declare class DEXBot {
695
743
  * @param {string} [contextLabel='rebalance'] - Context label for logging
696
744
  * @returns {Promise<Object>} Batch execution result
697
745
  */
698
- _executeBatchIfNeeded(rebalanceResult: any, contextLabel?: any): Promise<any>;
746
+ _executeBatchIfNeeded(rebalanceResult: unknown, contextLabel?: unknown): Promise<unknown>;
699
747
  /**
700
748
  * Process filled orders in (gap-slot + 1)-sized batches per _getGapSlotBatchSize().
701
749
  * Each chunk triggers its own processFilledOrders → COW plan → broadcast cycle.
@@ -706,13 +754,7 @@ declare class DEXBot {
706
754
  * @param {Object} [options={}] - Passed through to processFilledOrders
707
755
  * @returns {{aborted: boolean}}
708
756
  */
709
- _processFillsWithBatching(fills: any, excl: any, contextLabel: any, options?: any): Promise<{
710
- aborted: boolean;
711
- deferred?: undefined;
712
- } | {
713
- aborted: boolean;
714
- deferred: boolean;
715
- }>;
757
+ _processFillsWithBatching(fills: unknown, excl: unknown, contextLabel: unknown, options?: UnknownRecord): Promise<FillBatchResult>;
716
758
  /**
717
759
  * Check if the bot requires credential daemon for write operations.
718
760
  * @returns {boolean}
@@ -723,26 +765,26 @@ declare class DEXBot {
723
765
  * @param {string} reason - Reason for suspension
724
766
  * @returns {void}
725
767
  */
726
- _suspendGridPersistenceForCredentialOutage(reason: any): void;
768
+ _suspendGridPersistenceForCredentialOutage(reason: unknown): void;
727
769
  /**
728
770
  * Resume grid persistence after credential daemon recovery.
729
771
  * @param {string} reason - Reason for resuming
730
772
  * @returns {void}
731
773
  */
732
- _resumeGridPersistenceAfterCredentialRecovery(reason: any): void;
774
+ _resumeGridPersistenceAfterCredentialRecovery(reason: unknown): void;
733
775
  /**
734
776
  * Ensure the credential daemon is writable before broadcasting operations.
735
777
  * @param {string} [contextLabel='write batch'] - Context label for logging
736
778
  * @returns {Promise<void>}
737
779
  * @throws {Error} With code CREDENTIAL_DAEMON_UNAVAILABLE if daemon is down
738
780
  */
739
- _ensureCredentialDaemonWritable(contextLabel?: any): Promise<void>;
781
+ _ensureCredentialDaemonWritable(contextLabel?: unknown): Promise<void>;
740
782
  /**
741
783
  * Check if an error is related to credential daemon unavailability.
742
784
  * @param {Error|*} err - Error to check
743
785
  * @returns {boolean}
744
786
  */
745
- _isCredentialDaemonError(err: any): boolean;
787
+ _isCredentialDaemonError(err: unknown): boolean;
746
788
  /**
747
789
  * Run state recovery after credential daemon is restored.
748
790
  * @returns {Promise<void>}
@@ -753,6 +795,25 @@ declare class DEXBot {
753
795
  * @returns {void}
754
796
  */
755
797
  _setupCredentialDaemonWatchdogInterval(): void;
798
+ /**
799
+ * Consecutive failed watchdog probes required before the credential daemon
800
+ * is declared down. One-liner so the startup log and the probe decision
801
+ * can never disagree about the threshold.
802
+ * @returns {number} Positive integer threshold
803
+ */
804
+ _credentialDaemonWatchdogFailureThreshold(): number;
805
+ /**
806
+ * Run a single credential-daemon watchdog health probe.
807
+ *
808
+ * A probe failure is only treated as a daemon outage after
809
+ * CREDENTIAL_DAEMON_WATCHDOG_FAILURE_THRESHOLD consecutive failures, so one
810
+ * transient timeout (daemon busy signing) never pauses writes or suspends
811
+ * grid persistence. A confirmed outage sets `_credentialRecoveryNeeded` so
812
+ * the successful-probe path CAN resume persistence — otherwise the
813
+ * suspension lasted until a process restart (production incident).
814
+ * @returns {Promise<void>}
815
+ */
816
+ _runCredentialDaemonWatchdogProbe(): Promise<void>;
756
817
  /**
757
818
  * Stop the credential daemon watchdog interval.
758
819
  * @returns {void}
@@ -764,27 +825,20 @@ declare class DEXBot {
764
825
  * @param {Object} rebalanceResult - COW result containing workingGrid + actions.
765
826
  * @returns {Promise<Object>} The batch result.
766
827
  */
767
- updateOrdersOnChainBatch(rebalanceResult: any): Promise<any>;
828
+ updateOrdersOnChainBatch(rebalanceResult: unknown): Promise<unknown>;
768
829
  /**
769
830
  * Converts simple plan payloads (place/update/rotate/cancel) into a COW batch.
770
831
  * Used by spread/divergence maintenance and bootstrap helpers.
771
832
  * @param {Object|Array} plan - Plan object or array of ordersToPlace
772
833
  * @returns {Promise<Object>} Batch execution result
773
834
  */
774
- updateOrdersOnChainPlan(plan: any): Promise<any>;
835
+ updateOrdersOnChainPlan(plan: UnknownRecord): Promise<UnknownRecord>;
775
836
  /**
776
837
  * Build a COW result object (workingGrid + actions) from a simple plan.
777
838
  * @param {Object|Array} plan - Plan object or array of ordersToPlace
778
839
  * @returns {{workingGrid: any, workingIndexes: Object, workingBoundary: number, actions: Array}}
779
840
  */
780
- _buildCowResultFromPlan(plan: any): {
781
- refillSlotIds?: any;
782
- workingGrid: any;
783
- workingIndexes: any;
784
- workingBoundary: any;
785
- actions: any[];
786
- origin: any;
787
- };
841
+ _buildCowResultFromPlan(plan: UnknownRecord): CowResult;
788
842
  /**
789
843
  * COW broadcast: Execute blockchain operations and commit working grid on success.
790
844
  * Master grid is ONLY updated after successful blockchain confirmation.
@@ -792,12 +846,8 @@ declare class DEXBot {
792
846
  * @returns {Promise<Object>} The batch result.
793
847
  * @private
794
848
  */
795
- _updateOrdersOnChainBatchCOW(cowResult: any, options?: any): Promise<any>;
796
- _processBatchResults(result: any, opContexts: any): Promise<{
797
- executed: boolean;
798
- hadRotation: boolean;
799
- updateOperationCount: number;
800
- }>;
849
+ _updateOrdersOnChainBatchCOW(cowResult: CowResult, options?: UnknownRecord): Promise<UnknownRecord>;
850
+ _processBatchResults(result: UnknownRecord, opContexts: OpPhase[]): Promise<UnknownRecord>;
801
851
  /**
802
852
  * Perform grid recalculation triggered by trigger file.
803
853
  * Reloads config from disk, recalculates grid, resets funds, and removes trigger file.
@@ -806,7 +856,7 @@ declare class DEXBot {
806
856
  * @returns {Promise<boolean>} True if resync succeeded
807
857
  * @private
808
858
  */
809
- _performGridResync(options?: any): Promise<boolean>;
859
+ _performGridResync(options?: UnknownRecord): Promise<unknown>;
810
860
  /**
811
861
  * Handle any pending trigger file reset at startup.
812
862
  * This is called FIRST during startup before any grid operations.
@@ -825,14 +875,14 @@ declare class DEXBot {
825
875
  * @param {string|Object|Buffer} [vaultSecret=null] - The unlock secret.
826
876
  * @returns {Promise<void>}
827
877
  */
828
- start(vaultSecret?: any): Promise<void>;
878
+ start(vaultSecret?: unknown): Promise<void>;
829
879
  /**
830
880
  * Start bot with a pre-decrypted private key.
831
881
  * Alternative to start(vaultSecret) when the signing secret is already available.
832
882
  * @param {string|Object} privateKey - Pre-decrypted private key or daemon signing token
833
883
  * @returns {Promise<void>}
834
884
  */
835
- startWithPrivateKey(privateKey: any): Promise<void>;
885
+ startWithPrivateKey(privateKey: unknown): Promise<void>;
836
886
  /**
837
887
  * Common startup sequence logic shared between start() and startWithPrivateKey().
838
888
  * @private
@@ -883,17 +933,17 @@ declare class DEXBot {
883
933
  * @private
884
934
  */
885
935
  _stopBotsConfigPollInterval(): void;
886
- _releaseMarketAdapterRuntime(context?: any): Promise<any>;
936
+ _releaseMarketAdapterRuntime(context?: unknown): Promise<any>;
887
937
  /**
888
938
  * Get or create the credit runtime for debt policy management.
889
939
  * @returns {import('./credit_runtime.js').CreditRuntime|null}
890
940
  */
891
- _getCreditRuntime(): any;
941
+ _getCreditRuntime(): CreditRuntimeLike | null;
892
942
  /**
893
943
  * Set up the credit runtime by loading its persisted state.
894
944
  * @returns {Promise<import('./credit_runtime.js').CreditRuntime|null>}
895
945
  */
896
- _setupCreditRuntime(): Promise<any>;
946
+ _setupCreditRuntime(): Promise<CreditRuntimeLike | null>;
897
947
  /**
898
948
  * Refresh credit runtime state from chain and sync internal tracking.
899
949
  * @returns {Promise<void>}
@@ -905,7 +955,7 @@ declare class DEXBot {
905
955
  * @param {Object} [options={}] - Maintenance options
906
956
  * @returns {Promise<*>} Maintenance result from runtime
907
957
  */
908
- _runCreditRuntimeMaintenance(context?: any, options?: any): Promise<any>;
958
+ _runCreditRuntimeMaintenance(context?: unknown, options?: UnknownRecord): Promise<unknown>;
909
959
  /**
910
960
  * Start the credit deal watchdog interval.
911
961
  * @returns {void}
@@ -916,10 +966,7 @@ declare class DEXBot {
916
966
  * @returns {void}
917
967
  */
918
968
  _stopCreditWatchdogInterval(): void;
919
- requestGridReset(reason?: any, options?: {
920
- refreshCenterPrice?: boolean;
921
- [key: string]: any;
922
- }): Promise<any>;
969
+ requestGridReset(reason?: unknown, options?: UnknownRecord): Promise<unknown>;
923
970
  _wireStructuralGridResyncRequest(): void;
924
971
  /**
925
972
  * Wire the manager's broadcast-region-end hook to drain the deferred fill
@@ -928,16 +975,33 @@ declare class DEXBot {
928
975
  * long region (e.g. the structural resync's Phase-2 placement) would
929
976
  * starve indefinitely — which also keeps the maintenance idle gate shut
930
977
  * forever (the queue-length check returns the full settle delay).
931
- * Registered via addBroadcastRegionEndListener (fan-out) rather than the
932
- * legacy single slot, so a second wirer can never silently displace the
933
- * drain. Re-entry safe: the marker keeps repeated wiring idempotent.
978
+ * Registered via addBroadcastRegionEndListener (fan-out) so a second wirer
979
+ * can never silently displace the drain. Re-entry safe: the marker keeps
980
+ * repeated wiring idempotent.
934
981
  */
935
982
  _wireBroadcastRegionEndDrain(): void;
936
983
  /**
937
984
  * Get current metrics for monitoring and debugging.
938
985
  * @returns {Object} Metrics snapshot
939
986
  */
940
- getMetrics(): any;
987
+ getMetrics(): {
988
+ queueDepth: number;
989
+ fillProcessingLockActive: boolean;
990
+ divergenceLockActive: boolean;
991
+ shadowLocksActive: number;
992
+ recoveryExhaustedAt: number | null;
993
+ recentFillsTracked: number;
994
+ unmatchedChainOrders: number;
995
+ heldChainOrders: number;
996
+ blockingChainOrders: number;
997
+ fillsProcessed: number;
998
+ batchesExecuted: number;
999
+ fillProcessingTimeMs: number;
1000
+ lockContentionEvents: number;
1001
+ maxQueueDepth: number;
1002
+ gridLockContention: number;
1003
+ fundRecalcCount: number;
1004
+ };
941
1005
  /**
942
1006
  * Execute grid maintenance checks in strict order with pipeline consensus.
943
1007
  *
@@ -969,7 +1033,7 @@ declare class DEXBot {
969
1033
  * @param {Object} context - Maintenance context for logging.
970
1034
  * @private
971
1035
  */
972
- _executeMaintenanceLogic(context: any): Promise<void>;
1036
+ _executeMaintenanceLogic(context: unknown): Promise<void>;
973
1037
  /**
974
1038
  * Cancel dust partial orders immediately — no maps, no timers, no delay.
975
1039
  * Each dust order is cancelled on chain and its slot rotated through the
@@ -978,13 +1042,16 @@ declare class DEXBot {
978
1042
  * @returns {Promise<{cancelledCount: number, batchResult: {aborted: boolean}|null}>}
979
1043
  * @private
980
1044
  */
981
- _cancelDustOrders({ buy: buyDust, sell: sellDust }?: any): Promise<{
1045
+ _cancelDustOrders({ buy: buyDust, sell: sellDust }?: {
1046
+ buy?: unknown[];
1047
+ sell?: unknown[];
1048
+ }): Promise<{
982
1049
  cancelledCount: number;
983
1050
  batchResult: null;
984
1051
  } | {
985
1052
  cancelledCount: number;
986
1053
  batchResult: {
987
- aborted: any;
1054
+ aborted: boolean | undefined;
988
1055
  };
989
1056
  }>;
990
1057
  /**
@@ -1027,7 +1094,7 @@ declare class DEXBot {
1027
1094
  * @param {Object} options - Maintenance options
1028
1095
  * @private
1029
1096
  */
1030
- _runGridMaintenance(context?: any, options?: any): Promise<void>;
1097
+ _runGridMaintenance(context?: unknown, options?: UnknownRecord): Promise<unknown>;
1031
1098
  /**
1032
1099
  * Gracefully shutdown the bot.
1033
1100
  * Waits for current fill processing to complete, persists state, and stops intervals.