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
@@ -32,8 +32,6 @@ function reconcileGridOrders(...args) { return require('./order/grid_reconcile')
32
32
  function botRetryLogger(bot) {
33
33
  return { log: (msg) => bot._log(msg) };
34
34
  }
35
- // Test seams: compiled ESM exports cannot be monkey-patched, so tests may
36
- // substitute grid/reconcile modules and chain reads at the bot level.
37
35
  function botGridModule(bot) {
38
36
  return (bot._gridModule && typeof bot._gridModule === 'object') ? bot._gridModule : Grid;
39
37
  }
@@ -54,7 +52,7 @@ const PROFILES_BOTS_FILE = PATHS.PROFILES.BOTS_JSON;
54
52
  * @returns {Promise<Object>} startupState
55
53
  */
56
54
  async function initializeStartupState(bot) {
57
- bot.accountOrders = new AccountOrders({ botKey: bot.config.botKey });
55
+ bot.accountOrders = new AccountOrders({ botKey: bot.config.botKey ?? '' });
58
56
  bot._processedFillStore.configure({
59
57
  accountOrders: bot.accountOrders
60
58
  });
@@ -112,15 +110,16 @@ async function initializeStartupState(bot) {
112
110
  if (persistedGrid && persistedGrid.length > 0) {
113
111
  let repairCount = 0;
114
112
  repairedGrid = persistedGrid.map((order) => {
115
- if (order && order.orderId && order.orderId === order.id) {
113
+ const ord = order;
114
+ if (ord && ord.orderId && ord.orderId === ord.id) {
116
115
  repairCount++;
117
- const repairedOrder = { ...order, orderId: '' };
116
+ const repairedOrder = { ...ord, orderId: '' };
118
117
  if (repairedOrder.state === ORDER_STATES.ACTIVE || repairedOrder.state === ORDER_STATES.PARTIAL) {
119
118
  repairedOrder.state = ORDER_STATES.VIRTUAL;
120
119
  }
121
120
  return repairedOrder;
122
121
  }
123
- return order;
122
+ return ord;
124
123
  });
125
124
  if (repairCount > 0) {
126
125
  bot._log(`[REPAIR] Stripped ${repairCount} fake orderId(s) from persisted grid to restore rebalancing logic.`);
@@ -157,8 +156,8 @@ async function initializeStartupState(bot) {
157
156
  * bot down and rethrows. Nothing is cancelled without an operator.
158
157
  *
159
158
  * @param {import('./dexbot_class.js').DEXBot} bot
160
- * @param {any[]} persistedGrid - Persisted grid array (non-empty).
161
- * @param {any} persistedGenesis - Persisted ladder row (may be null).
159
+ * @param {unknown[]} persistedGrid - Persisted grid array (non-empty).
160
+ * @param {unknown} persistedGenesis - Persisted ladder row (may be null).
162
161
  * @returns {{needsRebuild: boolean}}
163
162
  */
164
163
  function evaluateStartupGenesisGate(bot, persistedGrid, persistedGenesis) {
@@ -182,6 +181,27 @@ function evaluateStartupGenesisGate(bot, persistedGrid, persistedGenesis) {
182
181
  `and reconciles against the live book update-first`, 'warn');
183
182
  return { needsRebuild: true };
184
183
  }
184
+ /**
185
+ * Wire up the post-bootstrap subsystem intervals and run the startup dust
186
+ * health check. Shared by every startup path so the subsystem list stays in
187
+ * lockstep (add a subsystem once). finishBootstrap() is intentionally left to
188
+ * each caller — the bootstrap/try-finally ordering differs per path.
189
+ * @param {import('./dexbot_class.js').DEXBot} bot
190
+ */
191
+ async function startPostBootstrapSubsystems(bot) {
192
+ await bot._setupTriggerFileDetection();
193
+ await bot._setupCreditRuntime();
194
+ await bot._refreshAndSyncCreditRuntime();
195
+ await bot._runCreditRuntimeMaintenance('startup');
196
+ bot._setupBlockchainFetchInterval();
197
+ if (typeof bot._setupBotsConfigPollInterval === 'function')
198
+ bot._setupBotsConfigPollInterval();
199
+ bot._setupCreditWatchdogInterval();
200
+ bot._setupCredentialDaemonWatchdogInterval();
201
+ bot._setupDustHealthCheckInterval();
202
+ await bot._runDustHealthCheck();
203
+ bot._log('[DUST] Startup health check complete');
204
+ }
185
205
  /**
186
206
  * Finish the startup sequence: activate fill listener, reconcile grid, place initial orders.
187
207
  * @param {import('./dexbot_class.js').DEXBot} bot
@@ -248,7 +268,7 @@ async function finishStartupSequence(bot, startupState) {
248
268
  try {
249
269
  await Promise.race([
250
270
  workPromise,
251
- new Promise((_, reject) => {
271
+ new Promise((_resolve, reject) => {
252
272
  safetyNetTimer = setTimeout(() => reject(new Error(`Safety-net sync exceeded ${safetyNetTimeoutMs}ms cap`)), safetyNetTimeoutMs);
253
273
  })
254
274
  ]);
@@ -262,7 +282,7 @@ async function finishStartupSequence(bot, startupState) {
262
282
  bot._log(`Safety-net sync completed despite timeout — ignoring spurious error.`, 'info');
263
283
  }
264
284
  else {
265
- bot._warn(`Post-reconnect safety-net sync aborted: ${capErr?.message || capErr}`);
285
+ bot._warn(`Post-reconnect safety-net sync aborted: ${getErrorMessage(capErr)}`);
266
286
  }
267
287
  }
268
288
  finally {
@@ -274,7 +294,7 @@ async function finishStartupSequence(bot, startupState) {
274
294
  setImmediate(() => {
275
295
  runSafetyNetSync().catch((err) => {
276
296
  try {
277
- bot._warn('Post-reconnect safety-net sync failed: ' + (err?.message || err));
297
+ bot._warn('Post-reconnect safety-net sync failed: ' + (getErrorMessage(err)));
278
298
  }
279
299
  catch (_) {
280
300
  }
@@ -366,8 +386,8 @@ async function finishStartupSequence(bot, startupState) {
366
386
  await bot.manager.recalculateFunds();
367
387
  if (!postResetAborted && !postResetUnmatched) {
368
388
  const spreadResult = await bot.manager.checkSpreadCondition(BitShares, bot.updateOrdersOnChainPlan.bind(bot));
369
- if (spreadResult && spreadResult.ordersPlaced > 0) {
370
- bot._log(`✓ Spread correction after trigger reset: ${spreadResult.ordersPlaced} order(s) placed`);
389
+ if (spreadResult && (spreadResult.ordersPlaced ?? 0) > 0) {
390
+ bot._log(`✓ Spread correction after trigger reset: ${spreadResult.ordersPlaced ?? 0} order(s) placed`);
371
391
  await bot._persistAndRecoverIfNeeded();
372
392
  }
373
393
  }
@@ -385,18 +405,7 @@ async function finishStartupSequence(bot, startupState) {
385
405
  }
386
406
  bot._log('Bootstrap phase complete - fill processing resumed', 'info');
387
407
  });
388
- await bot._setupTriggerFileDetection();
389
- await bot._setupCreditRuntime();
390
- await bot._refreshAndSyncCreditRuntime();
391
- await bot._runCreditRuntimeMaintenance('startup');
392
- bot._setupBlockchainFetchInterval();
393
- if (typeof bot._setupBotsConfigPollInterval === 'function')
394
- bot._setupBotsConfigPollInterval();
395
- bot._setupCreditWatchdogInterval();
396
- bot._setupCredentialDaemonWatchdogInterval();
397
- bot._setupDustHealthCheckInterval();
398
- await bot._runDustHealthCheck();
399
- bot._log('[DUST] Startup health check complete');
408
+ await startPostBootstrapSubsystems(bot);
400
409
  bot.manager.finishBootstrap();
401
410
  if (bot._isOpenOrdersSyncLoopEnabled()) {
402
411
  bot._startOpenOrdersSyncLoop();
@@ -412,10 +421,11 @@ async function finishStartupSequence(bot, startupState) {
412
421
  });
413
422
  if (bot.config.assetA !== 'BTS' && bot.config.assetB !== 'BTS') {
414
423
  if (persistedBtsBalance && typeof persistedBtsBalance === 'object') {
424
+ const bal = persistedBtsBalance;
415
425
  bot.manager.btsBalance = {
416
- free: persistedBtsBalance.free || 0,
417
- total: persistedBtsBalance.total || 0,
418
- locked: persistedBtsBalance.locked || 0
426
+ free: bal.free || 0,
427
+ total: bal.total || 0,
428
+ locked: bal.locked || 0
419
429
  };
420
430
  }
421
431
  }
@@ -534,11 +544,12 @@ async function finishStartupSequence(bot, startupState) {
534
544
  }
535
545
  }
536
546
  if (!shouldRegenerate) {
537
- if (persistedBtsFeesOwed > 0) {
547
+ const btsFeesOwed = Number(persistedBtsFeesOwed);
548
+ if (btsFeesOwed > 0) {
538
549
  await bot.manager._fundLock.acquire(async () => {
539
- bot.manager.funds.btsFeesOwed = persistedBtsFeesOwed;
550
+ bot.manager.funds.btsFeesOwed = btsFeesOwed;
540
551
  });
541
- bot._log(`✓ Restored BTS fees owed: ${Format.formatAmount8(persistedBtsFeesOwed)} BTS`);
552
+ bot._log(`✓ Restored BTS fees owed: ${Format.formatAmount8(btsFeesOwed)} BTS`);
542
553
  }
543
554
  }
544
555
  else {
@@ -702,18 +713,7 @@ async function finishStartupSequence(bot, startupState) {
702
713
  bot.manager.finishBootstrap();
703
714
  }
704
715
  });
705
- await bot._setupTriggerFileDetection();
706
- await bot._setupCreditRuntime();
707
- await bot._refreshAndSyncCreditRuntime();
708
- await bot._runCreditRuntimeMaintenance('startup');
709
- bot._setupBlockchainFetchInterval();
710
- if (typeof bot._setupBotsConfigPollInterval === 'function')
711
- bot._setupBotsConfigPollInterval();
712
- bot._setupCreditWatchdogInterval();
713
- bot._setupCredentialDaemonWatchdogInterval();
714
- bot._setupDustHealthCheckInterval();
715
- await bot._runDustHealthCheck();
716
- bot._log('[DUST] Startup health check complete');
716
+ await startPostBootstrapSubsystems(bot);
717
717
  if (bot._isOpenOrdersSyncLoopEnabled()) {
718
718
  bot._startOpenOrdersSyncLoop();
719
719
  }
@@ -1,28 +1,29 @@
1
1
  /** State recovery runtime - grid persistence, recovery sync, size-drift repair */
2
+ import type { BotLike } from './types.js';
2
3
  /**
3
4
  * Persist the current grid state and trigger recovery if validation fails.
4
5
  * @param {import('./dexbot_class.js').DEXBot} bot
5
6
  */
6
- declare function persistAndRecoverIfNeeded(bot: any): Promise<void>;
7
+ declare function persistAndRecoverIfNeeded(bot: BotLike): Promise<void>;
7
8
  /**
8
9
  * Snapshot the recently queued fill keys as a plain object for crash-durable persistence.
9
10
  * @param {import('./dexbot_class.js').DEXBot} bot
10
11
  * @returns {Record<string, number>}
11
12
  */
12
- declare function getRecentFillKeysSnapshot(bot: any): Record<string, number>;
13
+ declare function getRecentFillKeysSnapshot(bot: BotLike): Record<string, number>;
13
14
  /**
14
15
  * Trigger a full state recovery sync (fetch chain + sync from open orders + persist).
15
16
  * @param {import('./dexbot_class.js').DEXBot} bot
16
17
  * @param {string} [reason='state recovery sync']
17
18
  */
18
- declare function triggerStateRecoverySync(bot: any, reason?: any): Promise<void>;
19
+ declare function triggerStateRecoverySync(bot: BotLike, reason?: string): Promise<void>;
19
20
  /**
20
21
  * Abort the current flow if an illegal state signal was raised.
21
22
  * @param {import('./dexbot_class.js').DEXBot} bot
22
23
  * @param {string} flowContext
23
24
  * @returns {Promise<boolean>}
24
25
  */
25
- declare function abortFlowIfIllegalState(bot: any, flowContext: any): Promise<boolean>;
26
+ declare function abortFlowIfIllegalState(bot: BotLike, flowContext: string): Promise<boolean>;
26
27
  /**
27
28
  * Handle a hard abort from batch processing due to illegal state or accounting failure.
28
29
  * @param {import('./dexbot_class.js').DEXBot} bot
@@ -31,7 +32,7 @@ declare function abortFlowIfIllegalState(bot: any, flowContext: any): Promise<bo
31
32
  * @param {number} [opsCount=0]
32
33
  * @returns {Promise<Object|null>}
33
34
  */
34
- declare function handleBatchHardAbort(bot: any, err: any, phase?: any, opsCount?: any): Promise<{
35
+ declare function handleBatchHardAbort(bot: BotLike, err: unknown, phase?: string, opsCount?: number): Promise<{
35
36
  abortedForAccountingFailure: boolean;
36
37
  executed: boolean;
37
38
  hadRotation: boolean;
@@ -47,7 +48,7 @@ declare function handleBatchHardAbort(bot: any, err: any, phase?: any, opsCount?
47
48
  * @param {string} [context='recoverable-grid-update']
48
49
  * @returns {Promise<number>}
49
50
  */
50
- declare function applyRecoverableGridUpdates(bot: any, updates: any, context?: any): Promise<number>;
51
+ declare function applyRecoverableGridUpdates(bot: BotLike, updates: unknown[], context?: string): Promise<number>;
51
52
  /**
52
53
  * Recover from explicit stale order errors by virtualizing affected grid slots.
53
54
  * @param {import('./dexbot_class.js').DEXBot} bot
@@ -55,7 +56,7 @@ declare function applyRecoverableGridUpdates(bot: any, updates: any, context?: a
55
56
  * @param {string} [reason='stale order cleanup']
56
57
  * @returns {Promise<Object>}
57
58
  */
58
- declare function recoverExplicitStaleOrders(bot: any, staleOrderIds: any, reason?: any): Promise<{
59
+ declare function recoverExplicitStaleOrders(bot: BotLike, staleOrderIds: unknown, reason?: string): Promise<{
59
60
  executed: boolean;
60
61
  hadRotation: boolean;
61
62
  stale: boolean;
@@ -73,7 +74,7 @@ declare function recoverExplicitStaleOrders(bot: any, staleOrderIds: any, reason
73
74
  * @param {Array<Object>} [opContexts=[]]
74
75
  * @returns {Promise<Object>}
75
76
  */
76
- declare function recoverBatchSizeDrift(bot: any, err: any, opContexts?: any): Promise<{
77
+ declare function recoverBatchSizeDrift(bot: BotLike, err: unknown, opContexts?: unknown): Promise<{
77
78
  executed: boolean;
78
79
  hadRotation: boolean;
79
80
  recoveredBySync: boolean;
@@ -84,7 +85,7 @@ declare function recoverBatchSizeDrift(bot: any, err: any, opContexts?: any): Pr
84
85
  * @param {import('./dexbot_class.js').DEXBot} bot
85
86
  * @returns {Promise<{success: boolean, reason?: string}>}
86
87
  */
87
- declare function recoverFromPersistedGrid(bot: any): Promise<{
88
+ declare function recoverFromPersistedGrid(bot: BotLike): Promise<{
88
89
  success: boolean;
89
90
  reason: string;
90
91
  halt?: undefined;
@@ -110,20 +111,20 @@ declare function recoverFromPersistedGrid(bot: any): Promise<{
110
111
  * @param {import('./dexbot_class.js').DEXBot} bot
111
112
  * @param {string} context - Label for logging
112
113
  */
113
- declare function _schedulePostRecoveryRebalance(bot: any, context: any): void;
114
+ declare function _schedulePostRecoveryRebalance(bot: BotLike, context: string): void;
114
115
  /**
115
116
  * Reject a corrupted grid snapshot when catastrophic fund drift is detected.
116
117
  * @param {import('./dexbot_class.js').DEXBot} bot
117
118
  * @param {'startup'|'recovery'} context
118
119
  * @returns {Promise<boolean>}
119
120
  */
120
- declare function rejectCorruptedGridSnapshot(bot: any, context: any): Promise<boolean>;
121
+ declare function rejectCorruptedGridSnapshot(bot: BotLike, context: string): Promise<boolean>;
121
122
  /**
122
123
  * Attempt to repair size-drift for specific order IDs from chain state.
123
124
  * @param {import('./dexbot_class.js').DEXBot} bot
124
125
  * @param {string[]} orderIds
125
126
  * @returns {Promise<boolean>}
126
127
  */
127
- declare function targetedOrderRepair(bot: any, orderIds: any): Promise<boolean>;
128
+ declare function targetedOrderRepair(bot: BotLike, orderIds: string[]): Promise<boolean>;
128
129
  export { persistAndRecoverIfNeeded, getRecentFillKeysSnapshot, triggerStateRecoverySync, abortFlowIfIllegalState, handleBatchHardAbort, applyRecoverableGridUpdates, recoverExplicitStaleOrders, recoverBatchSizeDrift, recoverFromPersistedGrid, rejectCorruptedGridSnapshot, targetedOrderRepair, _schedulePostRecoveryRebalance as schedulePostRecoveryRebalance };
129
130
  //# sourceMappingURL=dexbot_state_recovery.d.ts.map
@@ -323,7 +323,7 @@ async function recoverFromPersistedGrid(bot) {
323
323
  return { success: false, reason: `persisted boundary rejected (${check.reason})` };
324
324
  }
325
325
  }
326
- const persistedGenesis = bot.accountOrders.loadGenesis?.(true) ?? null;
326
+ const persistedGenesis = (bot.accountOrders.loadGenesis?.(true) ?? null);
327
327
  await grid.loadGrid(bot.manager, persistedGrid, boundaryIdx, persistedGenesis, { tolerateTransientStranding });
328
328
  // Restart resilience: same pruning rules as the startup path — streaks
329
329
  // only survive for slots that still exist in the reloaded grid.
@@ -379,18 +379,19 @@ async function recoverFromPersistedGrid(bot) {
379
379
  // path (adoptPlacedBatchFromChain reads by id immediately after
380
380
  // broadcast). When no known ids are available, still defer.
381
381
  const knownIds = (persistedGrid || [])
382
- .map((s) => s && s.orderId)
382
+ .map((s) => s?.orderId)
383
383
  .filter((id) => id && /^1\.7\.\d+$/.test(String(id)));
384
384
  let recoveredById = null;
385
385
  if (knownIds.length > 0 && typeof chainOrders.batchReadOrders === 'function') {
386
386
  try {
387
- const map = await chainOrders.batchReadOrders(knownIds);
387
+ const map = await Promise.resolve(chainOrders.batchReadOrders(knownIds));
388
388
  const byId = [];
389
389
  if (map && typeof map.forEach === 'function') {
390
390
  map.forEach((o) => { if (o)
391
391
  byId.push(o); });
392
392
  }
393
393
  recoveredById = byId;
394
+ recoveredById = byId;
394
395
  }
395
396
  catch (byIdErr) {
396
397
  bot.manager.logger.log(`[RECOVERY] ID-based fallback read failed: ${getErrorMessage(byIdErr)}`, 'warn');
@@ -404,6 +405,9 @@ async function recoverFromPersistedGrid(bot) {
404
405
  return { success: false, reason: 'truncated open-order read; full grid reload deferred' };
405
406
  }
406
407
  }
408
+ if (chainOpenOrders === null) {
409
+ return { success: false, reason: 'truncated open-order read; full grid reload deferred' };
410
+ }
407
411
  if (chainOpenOrders.length > 0 && bot.manager?.syncFromOpenOrders) {
408
412
  await bot.manager.syncFromOpenOrders(chainOpenOrders, {
409
413
  skipAccounting: true,
@@ -439,7 +443,7 @@ async function recoverFromPersistedGrid(bot) {
439
443
  }
440
444
  const ordersArr = Array.from(bot.manager.orders.values());
441
445
  const bloatPostRecovery = isGridBloated(bot.manager, ordersArr);
442
- if (bloatPostRecovery.bloated) {
446
+ if (bloatPostRecovery.bloated && bloatPostRecovery.details) {
443
447
  const d = bloatPostRecovery.details;
444
448
  bot.manager.logger.log(`[RECOVERY] Persisted grid reloaded but still bloated ` +
445
449
  `(${d.gridSize} slots, max ${d.maxAllowed}). Rejecting — full grid reset required.`, 'warn');
@@ -520,7 +524,7 @@ async function _rebalanceAfterRecovery(bot, context) {
520
524
  bot.manager?._popWorkingGridRef?.(rebalanceResult);
521
525
  return;
522
526
  }
523
- bot.manager.logger?.log?.(`[RECOVERY] Re-placing ${rebalanceResult.actions.length} missing rail(s) after ${context}`, 'info');
527
+ bot.manager.logger?.log?.(`[RECOVERY] Re-placing ${(rebalanceResult.actions ?? []).length} missing rail(s) after ${context}`, 'info');
524
528
  await bot.updateOrdersOnChainBatch(rebalanceResult);
525
529
  }
526
530
  catch (err) {
@@ -584,7 +588,7 @@ async function rejectCorruptedGridSnapshot(bot, context) {
584
588
  return false;
585
589
  const tag = context === 'recovery' ? '[RECOVERY][SNAPSHOT-REJECT]' : '[SNAPSHOT-REJECT]';
586
590
  bot._warn(`${tag} Corrupted grid snapshot detected: ` +
587
- `drift sell=${driftCheck.driftSell.toFixed(2)} buy=${driftCheck.driftBuy.toFixed(2)}. ` +
591
+ `drift sell=${Number(driftCheck.driftSell ?? 0).toFixed(2)} buy=${Number(driftCheck.driftBuy ?? 0).toFixed(2)}. ` +
588
592
  `Deleting corrupted snapshot.`);
589
593
  if (bot.accountOrders && typeof bot.accountOrders.clearGrid === 'function') {
590
594
  try {
@@ -592,30 +596,31 @@ async function rejectCorruptedGridSnapshot(bot, context) {
592
596
  bot._warn(`${tag} Corrupted grid snapshot deleted.`);
593
597
  }
594
598
  catch (clearErr) {
595
- bot._warn(`${tag} Failed to delete corrupted snapshot: ${clearErr?.message ?? clearErr}`);
599
+ bot._warn(`${tag} Failed to delete corrupted snapshot: ${getErrorMessage(clearErr)}`);
596
600
  }
597
601
  }
598
602
  // P4: clear in-memory boundary together with snapshot so a stale
599
603
  // restored value (e.g. 131 in the incident) is not reused for rebuild.
600
604
  // clearGrid() already wiped persisted boundaryIdx; also clear manager
601
605
  // state so P3 re-derivation starts from a clean null boundary.
606
+ const mgrRecovery = bot.manager;
602
607
  try {
603
- bot.manager._restoreBoundary?.(null);
608
+ mgrRecovery._restoreBoundary?.(null);
604
609
  }
605
610
  catch { }
606
- bot.manager.boundaryIdx = null;
611
+ mgrRecovery.boundaryIdx = null;
607
612
  // Owed crawls belonged to the rejected generation: the rebuild re-anchors
608
613
  // the boundary absolutely, so applying their relative deltas would
609
614
  // double-count the movement the new anchor already contains. clearGrid()
610
615
  // wiped the persisted copy; drop the in-memory record (marks the grid
611
616
  // dirty so the wipe reaches disk on the next flush too).
612
- bot.manager._clearPendingFillCrawls?.('grid snapshot rejected');
617
+ mgrRecovery._clearPendingFillCrawls?.('grid snapshot rejected');
613
618
  // The LAST-FILL-GUARD pivot was armed against the rejected generation's
614
619
  // geometry: drop it so the rebuild re-arms on a fresh fill instead of
615
620
  // vetoing placements against a boundary that no longer exists.
616
621
  try {
617
- if (typeof bot.manager._resetLastFillPivot === 'function') {
618
- bot.manager._resetLastFillPivot('grid snapshot rejected');
622
+ if (typeof mgrRecovery._resetLastFillPivot === 'function') {
623
+ mgrRecovery._resetLastFillPivot('grid snapshot rejected');
619
624
  }
620
625
  else {
621
626
  resetLastFillPivot(bot.manager, 'grid snapshot rejected');
@@ -669,7 +674,7 @@ async function targetedOrderRepair(bot, orderIds) {
669
674
  return true;
670
675
  }
671
676
  catch (err) {
672
- bot.manager.logger.log(`[COW] Targeted order repair failed: ${err?.message ?? err}`, 'debug');
677
+ bot.manager.logger.log(`[COW] Targeted order repair failed: ${getErrorMessage(err)}`, 'debug');
673
678
  return false;
674
679
  }
675
680
  }
@@ -1,3 +1,5 @@
1
+ /** Allocation value stored in the registry: a decimal number or a percentage string. */
2
+ type PercentageValue = number | string;
1
3
  /**
2
4
  * Register a bot's allocation on an account for a given side.
3
5
  * Called during bot startup.
@@ -6,7 +8,7 @@
6
8
  * @param {'buy'|'sell'} side - Trade side
7
9
  * @param {number|string} percentage - Percentage value (e.g., 1.0 or '100%')
8
10
  */
9
- declare function registerAllocation(account: string, botName: string, side: 'buy' | 'sell', percentage: any): Promise<void>;
11
+ declare function registerAllocation(account: string, botName: string, side: 'buy' | 'sell', percentage: PercentageValue): Promise<void>;
10
12
  /**
11
13
  * Register a credit bot's collateral allocation on an account for a given collateral asset.
12
14
  * Called during bot startup for bots with debtPolicy.lending entries.
@@ -15,7 +17,7 @@ declare function registerAllocation(account: string, botName: string, side: 'buy
15
17
  * @param {string} collateralAssetId - Canonical collateral asset ID (e.g., '1.3.0')
16
18
  * @param {number|string} percentage - Percentage value (e.g., 1.0 or '100%')
17
19
  */
18
- declare function registerCollateralAllocation(account: string, botName: string, collateralAssetId: string, percentage: any): Promise<void>;
20
+ declare function registerCollateralAllocation(account: string, botName: string, collateralAssetId: string, percentage: PercentageValue): Promise<void>;
19
21
  /**
20
22
  * Get the effective collateral allocation for a credit bot on a given account/collateral asset.
21
23
  * Returns chainTotal * (myPercent / sum(allPercentages)).
@@ -1,3 +1,4 @@
1
+ import { getErrorMessage } from './utils/errors.js';
1
2
  import { createRequire } from 'node:module';
2
3
  const require = createRequire(import.meta.url);
3
4
  import { getStorage } from './storage/index.js';
@@ -36,22 +37,21 @@ function _loadRegistry() {
36
37
  }
37
38
  if (_registry !== null)
38
39
  return _registry;
40
+ let loaded;
39
41
  try {
40
- if (storage.exists(REGISTRY_FILE)) {
41
- _registry = readJSON(REGISTRY_FILE);
42
- }
43
- else {
44
- _registry = {};
45
- }
42
+ loaded = storage.exists(REGISTRY_FILE)
43
+ ? readJSON(REGISTRY_FILE)
44
+ : {};
46
45
  }
47
46
  catch (err) {
48
- console.error(`[fund_registry] Failed to load ${REGISTRY_FILE} (${err?.message || err}); ` +
47
+ console.error(`[fund_registry] Failed to load ${REGISTRY_FILE} (${getErrorMessage(err)}); ` +
49
48
  `resetting to an empty registry — previously registered bot allocations are unavailable ` +
50
49
  `and will be overwritten on the next save. Restore the file from backup before restarting other bots.`);
51
- _registry = {};
50
+ loaded = {};
52
51
  }
52
+ _registry = loaded;
53
53
  _registryMtimeMs = _statMtimeMs(REGISTRY_FILE);
54
- return _registry;
54
+ return loaded;
55
55
  }
56
56
  function _saveRegistry() {
57
57
  writeJSON(REGISTRY_FILE, _registry);
@@ -225,7 +225,7 @@ async function releaseAllocation(account, botName) {
225
225
  }
226
226
  }
227
227
  }
228
- else {
228
+ else if (side === 'buy' || side === 'sell') {
229
229
  const pct = _parsePercentage(acc.bots[botName][side]);
230
230
  acc.totalAllocatedPct[side] = Math.max(0, (acc.totalAllocatedPct[side] || 0) - pct);
231
231
  }
@@ -4,7 +4,33 @@
4
4
  * Centralized management for application-wide settings stored in profiles/general.settings.json.
5
5
  * Provides read/write operations with fallback handling.
6
6
  */
7
+ import type { UnknownRecord } from './types.js';
7
8
  declare const SETTINGS_FILE: string;
9
+ /**
10
+ * The on-disk general settings document. Open-ended (dynamic top-level
11
+ * sections) but `NODES` is typed because several callers read it directly.
12
+ */
13
+ export interface GeneralSettingsDocument {
14
+ NODES?: {
15
+ enabled?: boolean;
16
+ list?: string[];
17
+ healthCheck?: {
18
+ enabled?: boolean;
19
+ intervalMs?: number;
20
+ timeoutMs?: number;
21
+ maxPingMs?: number;
22
+ blacklistThreshold?: number;
23
+ [key: string]: unknown;
24
+ };
25
+ selection?: {
26
+ strategy?: string;
27
+ preferredNode?: string | null;
28
+ [key: string]: unknown;
29
+ };
30
+ [key: string]: unknown;
31
+ };
32
+ [key: string]: unknown;
33
+ }
8
34
  /**
9
35
  * Read general application settings from file.
10
36
  * Returns fallback if file missing, empty, or parse fails.
@@ -15,9 +41,9 @@ declare const SETTINGS_FILE: string;
15
41
  * @returns {Object|*} Parsed settings object or fallback value
16
42
  */
17
43
  declare function readGeneralSettings({ fallback, onError }?: {
18
- fallback?: any;
19
- onError?: ((err: Error, filePath: string) => void) | null;
20
- }): any;
44
+ fallback?: GeneralSettingsDocument | null;
45
+ onError?: ((err: unknown, filePath: string) => void) | null;
46
+ }): GeneralSettingsDocument | null;
21
47
  /**
22
48
  * Write general application settings to file.
23
49
  * Creates profiles directory if it doesn't exist.
@@ -26,6 +52,6 @@ declare function readGeneralSettings({ fallback, onError }?: {
26
52
  * @param {Object} settings - Settings object to write
27
53
  * @throws {Error} If write operation fails
28
54
  */
29
- declare function writeGeneralSettings(settings: any): void;
55
+ declare function writeGeneralSettings(settings: UnknownRecord): void;
30
56
  export { SETTINGS_FILE, readGeneralSettings, writeGeneralSettings };
31
57
  //# sourceMappingURL=general_settings.d.ts.map
@@ -69,14 +69,14 @@
69
69
  * @param {string} name - Description used in shutdown logs
70
70
  * @param {Function} wipeFn - Synchronous function to execute last
71
71
  */
72
- declare function registerExitWipe(name: any, wipeFn: () => void): void;
72
+ declare function registerExitWipe(name: string, wipeFn: () => void): void;
73
73
  /**
74
74
  * Register a cleanup function to be called on graceful shutdown
75
75
  * Functions are called in LIFO order (last registered = first called)
76
76
  * @param {string} name - Name of the cleanup operation (for logging)
77
77
  * @param {Function} handler - Async or sync function to call on shutdown
78
78
  */
79
- declare function registerCleanup(name: any, handler: any): void;
79
+ declare function registerCleanup(name: string, handler: () => unknown): void;
80
80
  /**
81
81
  * Remove a previously registered cleanup function.
82
82
  * Use this when a component fails to initialize and its cleanup must not run
@@ -84,7 +84,7 @@ declare function registerCleanup(name: any, handler: any): void;
84
84
  * @param {string|Function} nameOrHandler - Cleanup name or handler reference
85
85
  * @returns {boolean} True when a handler was found and removed
86
86
  */
87
- declare function unregisterCleanup(nameOrHandler: any): boolean;
87
+ declare function unregisterCleanup(nameOrHandler: string | (() => unknown)): boolean;
88
88
  /**
89
89
  * Setup signal handlers for graceful shutdown
90
90
  * Should be called once at process startup
@@ -61,7 +61,7 @@
61
61
  */
62
62
  import Logger from './order/logger.js';
63
63
  import { runtime } from './runtime.js';
64
- import { getErrorMessage } from './utils/errors.js';
64
+ import { getErrorMessage, getErrorField } from './utils/errors.js';
65
65
  import { withTimeout } from './order/utils/timeout.js';
66
66
  const CLEANUP_HANDLER_TIMEOUT_MS = 10000;
67
67
  let cleanupHandlers = [];
@@ -200,7 +200,7 @@ function setupGracefulShutdown() {
200
200
  });
201
201
  // Handle unhandled rejections
202
202
  runtime.onSignal('unhandledRejection', async (reason, promise) => {
203
- shutdownLogger.error(`Unhandled rejection at: ${promise} reason: ${reason?.stack || reason}`);
203
+ shutdownLogger.error(`Unhandled rejection at: ${promise} reason: ${getErrorField(reason, 'stack') || reason}`);
204
204
  await executeCleanup();
205
205
  runtime.exitAfterStderrDrain(1);
206
206
  });
@@ -14,6 +14,6 @@
14
14
  * @param {Object} bot - Bot configuration object
15
15
  * @returns {boolean} True if gridPrice starts with 'ama' (ama, ama1..ama4)
16
16
  */
17
- declare function usesAmaGridPrice(bot: any): boolean;
17
+ declare function usesAmaGridPrice(bot: Record<string, unknown> | null | undefined): boolean;
18
18
  export { usesAmaGridPrice };
19
19
  //# sourceMappingURL=grid_price_source.d.ts.map
@@ -1,19 +1,25 @@
1
+ /** One chain operation to sign/broadcast. */
2
+ interface ChainOrderOperation {
3
+ op_name: string;
4
+ op_data: unknown;
5
+ }
1
6
  export interface SigningResult {
2
7
  success: boolean;
3
- raw?: any;
4
- operation_results?: any[];
8
+ raw?: unknown;
9
+ operation_results?: unknown[];
5
10
  }
6
11
  export interface KeyStore {
7
- resolveSigningKey(accountName: string, vaultSecret?: any, chainClient?: any): Promise<any>;
8
- isDaemonSigningKey(key: any): boolean;
9
- executeOperations(accountName: string, operations: any[], signingKey: any, extraOptions?: Record<string, any>): Promise<SigningResult>;
12
+ resolveSigningKey(accountName: string, vaultSecret?: unknown, chainClient?: unknown): Promise<unknown>;
13
+ isDaemonSigningKey(key: unknown): boolean;
14
+ executeOperations(accountName: string, operations: ChainOrderOperation[], signingKey: unknown, extraOptions?: Record<string, unknown>): Promise<SigningResult>;
10
15
  }
11
16
  export declare class DaemonKeyStore implements KeyStore {
12
- resolveSigningKey(accountName: string, vaultSecret?: any, chainClient?: any): Promise<any>;
13
- isDaemonSigningKey(key: any): boolean;
14
- executeOperations(accountName: string, operations: any[], signingKey: any, extraOptions?: Record<string, any>): Promise<SigningResult>;
17
+ resolveSigningKey(accountName: string, vaultSecret?: unknown, chainClient?: unknown): Promise<unknown>;
18
+ isDaemonSigningKey(key: unknown): boolean;
19
+ executeOperations(accountName: string, operations: ChainOrderOperation[], signingKey: unknown, extraOptions?: Record<string, unknown>): Promise<SigningResult>;
15
20
  }
16
21
  export declare function setKeyStore(impl: KeyStore | null): void;
17
22
  export declare function resetKeyStore(): void;
18
23
  export declare function getKeyStore(): KeyStore;
24
+ export {};
19
25
  //# sourceMappingURL=key_store.d.ts.map