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
@@ -86,7 +86,7 @@ import { getErrorMessage } from '../utils/errors.js';
86
86
  import { nowIso } from './utils/system.js';
87
87
  const _require = createRequire(import.meta.url);
88
88
  const storage = getStorage();
89
- let _readline;
89
+ let _readline = null;
90
90
  function getReadline() {
91
91
  if (!_readline && _require)
92
92
  _readline = _require('readline');
@@ -239,12 +239,6 @@ function deriveTradeFromFillBlock(block, ctx) {
239
239
  order_id: block.orderId || ''
240
240
  };
241
241
  }
242
- /**
243
- * Resolve offline asset metadata + grid price stats for a bot from its
244
- * persisted grid file (profiles/orders/<botKey>.json). Falls back to scanning
245
- * all persisted grids for a matching meta.key/meta.name. No chain access.
246
- * @returns ExportAssetContext or null when nothing usable was found
247
- */
248
242
  function resolveExportAssetContext(botKey, botConfig) {
249
243
  const readGridFile = (fileName) => {
250
244
  try {
@@ -147,15 +147,15 @@ declare function formatMetric2(value: number): string;
147
147
  * @param {*} value - Value to check
148
148
  * @returns {boolean} True if value is defined and finite
149
149
  */
150
- declare function isValidNumber(value: any): boolean;
150
+ declare function isValidNumber(value: unknown): boolean;
151
151
  /**
152
152
  * Safely convert a value to a finite number.
153
153
  *
154
154
  * IMPORTANT: passing `undefined` as defaultValue triggers the TS default of 0.
155
155
  * Pass `null` explicitly to get `null` back for non-finite values.
156
156
  */
157
- declare function toFiniteNumber(value: any, defaultValue?: number): number;
158
- declare function toFiniteNumber(value: any, defaultValue: number | null): number | null;
157
+ declare function toFiniteNumber(value: unknown, defaultValue?: number): number;
158
+ declare function toFiniteNumber(value: unknown, defaultValue: number | null): number | null;
159
159
  /**
160
160
  * Safely format a numeric value with specified decimals and fallback.
161
161
  *
@@ -164,6 +164,6 @@ declare function toFiniteNumber(value: any, defaultValue: number | null): number
164
164
  * @param {string} [fallback='N/A'] - Fallback value if format fails
165
165
  * @returns {string} Formatted value or fallback string
166
166
  */
167
- declare function safeFormat(value: any, decimals: number, fallback?: string): string;
167
+ declare function safeFormat(value: unknown, decimals: number, fallback?: string): string;
168
168
  export { formatAmount8, formatAmount, formatAmountByPrecision, formatSizeByOrderType, formatPrice, formatPrice6, formatPrice4, formatCurrency, formatFundsValue, formatPercent2, formatPercent, formatMetric2, isValidNumber, toFiniteNumber, safeFormat };
169
169
  //# sourceMappingURL=format.d.ts.map
@@ -33,6 +33,9 @@
33
33
  * live order tracking and persists a genesis the live grid does not match --
34
34
  * Option D ("always accept") in the paper, rejected as corruption risk.
35
35
  */
36
+ import type { GridConfig } from '../types.js';
37
+ import type { GridGenesis } from './utils/math.js';
38
+ import type { OrderManagerLike } from '../types.js';
36
39
  /** Why no ladder could be attached to a snapshot (paper T2-T4). */
37
40
  export declare const MISSING_GENESIS_REASON: {
38
41
  /** T2: the config-derived rail disagrees with >MISSING_GENESIS_MISMATCH_RATIO of the slots. */
@@ -65,24 +68,24 @@ export declare class MissingGenesisError extends Error {
65
68
  constructor(reason: string, detail: string, policy: OnMissingGenesisPolicy, mismatchRatio?: number | null);
66
69
  }
67
70
  /** True for a MissingGenesisError, including across module/realm duplication. */
68
- export declare function isMissingGenesisError(err: any): boolean;
71
+ export declare function isMissingGenesisError(err: unknown): err is MissingGenesisError;
69
72
  /**
70
73
  * True when `genesis` is a usable ladder: a non-empty priceLevels array. The
71
74
  * hash is deliberately not required here -- a tampered hash is warned about
72
75
  * and the ladder is still used for validation (the pre-existing contract), and
73
76
  * the persisted-row schema check lives at the source (`AccountOrders.loadGenesis`).
74
77
  */
75
- export declare function hasGenesisLadder(genesis: any): boolean;
78
+ export declare function hasGenesisLadder(genesis: unknown): genesis is GridGenesis;
76
79
  /**
77
80
  * Resolve the configured missing-genesis policy.
78
81
  * Unknown/absent values fall back to the default ('rebuild'); only an explicit
79
82
  * 'halt' opts into manual intervention.
80
- * @param {any} config - Bot/manager config (reads `gridLimits.MISSING_GENESIS_POLICY`).
83
+ * @param {unknown} config - Bot/manager config (reads `gridLimits.MISSING_GENESIS_POLICY`).
81
84
  * @returns {OnMissingGenesisPolicy}
82
85
  */
83
- export declare function resolveOnMissingGenesisPolicy(config: any): OnMissingGenesisPolicy;
86
+ export declare function resolveOnMissingGenesisPolicy(config: GridConfig | null | undefined): OnMissingGenesisPolicy;
84
87
  /** Ratio of persisted slots above which a config-derived rail is refused. */
85
- export declare function resolveMismatchRatioLimit(config: any): number;
88
+ export declare function resolveMismatchRatioLimit(config: GridConfig | null | undefined): number;
86
89
  /**
87
90
  * Build the migration ladder from the LIVE geometric rail
88
91
  * (startPrice/minPrice/maxPrice/incrementPercent). The geometry itself comes
@@ -94,9 +97,9 @@ export declare function resolveMismatchRatioLimit(config: any): number;
94
97
  * persisted array would permanently shrink the ladder.
95
98
  * @returns {{ok: true, genesis: any} | {ok: false, reason: string, detail: string}}
96
99
  */
97
- export declare function buildGenesisFromLiveRail(config: any): {
100
+ export declare function buildGenesisFromLiveRail(config: GridConfig | null | undefined): {
98
101
  ok: true;
99
- genesis: any;
102
+ genesis: GridGenesis;
100
103
  } | {
101
104
  ok: false;
102
105
  reason: string;
@@ -104,7 +107,7 @@ export declare function buildGenesisFromLiveRail(config: any): {
104
107
  };
105
108
  export type GenesisResolution = {
106
109
  ok: true;
107
- genesis: any;
110
+ genesis: GridGenesis | null;
108
111
  source: 'persisted' | 'in_memory' | 'migration';
109
112
  } | {
110
113
  ok: false;
@@ -130,19 +133,19 @@ export type GenesisResolution = {
130
133
  * verdict before it commits to a resume.
131
134
  *
132
135
  * @param {Object} params
133
- * @param {any} params.config - Live bot/manager config.
134
- * @param {any[]} params.grid - Persisted grid array (may be empty).
135
- * @param {any} [params.genesisInput] - Genesis supplied by the caller (snapshot row).
136
- * @param {any} [params.managerGenesis] - In-memory `manager._genesis`.
136
+ * @param {unknown} params.config - Live bot/manager config.
137
+ * @param {unknown[]} params.grid - Persisted grid array (may be empty).
138
+ * @param {unknown} [params.genesisInput] - Genesis supplied by the caller (snapshot row).
139
+ * @param {unknown} [params.managerGenesis] - In-memory `manager._genesis`.
137
140
  * @param {(msg: string, level?: string) => void} [params.log] - Logger sink for the cross-check verdict.
138
141
  * @param {string} [params.validationMode] - 'log' | 'enforce', for the warning text only.
139
142
  * @returns {GenesisResolution}
140
143
  */
141
144
  export declare function resolvePersistedGenesis({ config, grid, genesisInput, managerGenesis, log, validationMode }: {
142
- config: any;
143
- grid: any;
144
- genesisInput?: any;
145
- managerGenesis?: any;
145
+ config: GridConfig | null;
146
+ grid: unknown;
147
+ genesisInput?: unknown;
148
+ managerGenesis?: unknown;
146
149
  log?: (msg: string, level?: string) => void;
147
150
  validationMode?: string;
148
151
  }): GenesisResolution;
@@ -150,11 +153,11 @@ export declare function resolvePersistedGenesis({ config, grid, genesisInput, ma
150
153
  * Build the fault object for a refused snapshot, recording the policy and the
151
154
  * reason on the manager for observability (the soft half of the enforcement:
152
155
  * a counter/log is what tells an operator T2-T4 ever fire in the wild).
153
- * @param {any} manager
156
+ * @param {unknown} manager
154
157
  * @param {{reason: string, detail: string, mismatchRatio: number | null}} fault
155
158
  * @returns {MissingGenesisError}
156
159
  */
157
- export declare function recordMissingGenesisFault(manager: any, fault: {
160
+ export declare function recordMissingGenesisFault(manager: OrderManagerLike, fault: {
158
161
  reason: string;
159
162
  detail: string;
160
163
  mismatchRatio: number | null;
@@ -34,6 +34,7 @@
34
34
  * Option D ("always accept") in the paper, rejected as corruption risk.
35
35
  */
36
36
  import { GRID_LIMITS } from '../constants.js';
37
+ import { isUnknownRecord } from '../types.js';
37
38
  import { getErrorMessage } from '../utils/errors.js';
38
39
  import { assertSlotPriceInvariant, buildGenesisFromPriceLevels, calculateGapSlots, derivePriceLevels } from './utils/math.js';
39
40
  /** Why no ladder could be attached to a snapshot (paper T2-T4). */
@@ -77,7 +78,10 @@ export class MissingGenesisError extends Error {
77
78
  export function isMissingGenesisError(err) {
78
79
  if (err instanceof MissingGenesisError)
79
80
  return true;
80
- return !!err && typeof err === 'object' && err.name === 'MissingGenesisError' && typeof err.reason === 'string';
81
+ if (!err || typeof err !== 'object')
82
+ return false;
83
+ const candidate = err;
84
+ return candidate.name === 'MissingGenesisError' && typeof candidate.reason === 'string';
81
85
  }
82
86
  /**
83
87
  * True when `genesis` is a usable ladder: a non-empty priceLevels array. The
@@ -86,13 +90,13 @@ export function isMissingGenesisError(err) {
86
90
  * the persisted-row schema check lives at the source (`AccountOrders.loadGenesis`).
87
91
  */
88
92
  export function hasGenesisLadder(genesis) {
89
- return !!genesis && Array.isArray(genesis.priceLevels) && genesis.priceLevels.length > 0;
93
+ return !!genesis && isUnknownRecord(genesis) && Array.isArray(genesis.priceLevels) && genesis.priceLevels.length > 0;
90
94
  }
91
95
  /**
92
96
  * Resolve the configured missing-genesis policy.
93
97
  * Unknown/absent values fall back to the default ('rebuild'); only an explicit
94
98
  * 'halt' opts into manual intervention.
95
- * @param {any} config - Bot/manager config (reads `gridLimits.MISSING_GENESIS_POLICY`).
99
+ * @param {unknown} config - Bot/manager config (reads `gridLimits.MISSING_GENESIS_POLICY`).
96
100
  * @returns {OnMissingGenesisPolicy}
97
101
  */
98
102
  export function resolveOnMissingGenesisPolicy(config) {
@@ -171,10 +175,10 @@ export function buildGenesisFromLiveRail(config) {
171
175
  * verdict before it commits to a resume.
172
176
  *
173
177
  * @param {Object} params
174
- * @param {any} params.config - Live bot/manager config.
175
- * @param {any[]} params.grid - Persisted grid array (may be empty).
176
- * @param {any} [params.genesisInput] - Genesis supplied by the caller (snapshot row).
177
- * @param {any} [params.managerGenesis] - In-memory `manager._genesis`.
178
+ * @param {unknown} params.config - Live bot/manager config.
179
+ * @param {unknown[]} params.grid - Persisted grid array (may be empty).
180
+ * @param {unknown} [params.genesisInput] - Genesis supplied by the caller (snapshot row).
181
+ * @param {unknown} [params.managerGenesis] - In-memory `manager._genesis`.
178
182
  * @param {(msg: string, level?: string) => void} [params.log] - Logger sink for the cross-check verdict.
179
183
  * @param {string} [params.validationMode] - 'log' | 'enforce', for the warning text only.
180
184
  * @returns {GenesisResolution}
@@ -240,7 +244,7 @@ export function resolvePersistedGenesis({ config, grid, genesisInput = null, man
240
244
  * Build the fault object for a refused snapshot, recording the policy and the
241
245
  * reason on the manager for observability (the soft half of the enforcement:
242
246
  * a counter/log is what tells an operator T2-T4 ever fire in the wild).
243
- * @param {any} manager
247
+ * @param {unknown} manager
244
248
  * @param {{reason: string, detail: string, mismatchRatio: number | null}} fault
245
249
  * @returns {MissingGenesisError}
246
250
  */
@@ -87,19 +87,44 @@
87
87
  *
88
88
  * ===============================================================================
89
89
  */
90
+ interface SpreadCorrection {
91
+ ordersToPlace: ManagedOrder[];
92
+ ordersToUpdate: Array<{
93
+ partialOrder: ManagedOrder;
94
+ newSize: number;
95
+ }>;
96
+ boundaryIdx?: number;
97
+ origin?: string;
98
+ [key: string]: unknown;
99
+ }
90
100
  /**
91
101
  * Central resolution for the RMS structural-divergence threshold (percent).
92
102
  * Single source of truth: per-bot override wins, global GRID_COMPARISON default
93
103
  * is the fallback. Used by compareGrids() and re-exported for the maintenance
94
104
  * runtime so the reset log always shows the level that actually fired.
95
- * @param {any} manager - OrderManager instance (may be null)
105
+ * @param {unknown} manager - OrderManager instance (may be null)
96
106
  * @returns {number} Threshold in percent (0 = disabled)
97
107
  */
98
- export declare function resolveRmsThresholdPct(manager: any): number;
108
+ export declare function resolveRmsThresholdPct(manager: OrderManagerLike | null | undefined): number;
99
109
  import { calculateGapSlots as _mathGapSlots } from './utils/math.js';
110
+ import * as MathUtils from './utils/math.js';
111
+ import { WorkingGrid } from './working_grid.js';
112
+ import type { OrderManagerLike, ManagedOrder, GridConfig, OrderType, OrderState, CowAction } from '../types.js';
113
+ import type { GridGenesis } from './utils/math.js';
100
114
  declare const calculateGapSlots: typeof _mathGapSlots;
101
115
  export { calculateGapSlots };
102
- export declare function isGridBloated(manager: any, orders: any): any;
116
+ export declare function isGridBloated(manager: OrderManagerLike, orders: ManagedOrder[] | Map<string, ManagedOrder>): {
117
+ bloated: boolean;
118
+ details?: {
119
+ gridSize: number;
120
+ placedCount: number;
121
+ numBuyActive: number;
122
+ numSellActive: number;
123
+ gapSlots: number;
124
+ maxAllowed: number;
125
+ railEstimate: number;
126
+ };
127
+ };
103
128
  /**
104
129
  * Check whether the grid-bloat grace period is still active, i.e. a
105
130
  * bloat detection happened recently enough that a structural resync
@@ -113,13 +138,17 @@ export declare function isGridBloated(manager: any, orders: any): any;
113
138
  * @param {Object} manager - OrderManager instance.
114
139
  * @returns {{active: boolean, elapsed: number, graceMs: number}}
115
140
  */
116
- export declare function isGridBloatGraceActive(manager: any): any;
141
+ export declare function isGridBloatGraceActive(manager: OrderManagerLike): {
142
+ active: boolean;
143
+ elapsed: number;
144
+ graceMs: number;
145
+ };
117
146
  /**
118
147
  * Clear the grid-bloat detection timestamp once the grid size has
119
148
  * returned to normal. Shared so both call sites use the same key.
120
149
  * @param {Object} manager - OrderManager instance.
121
150
  */
122
- export declare function clearGridBloatFlag(manager: any): void;
151
+ export declare function clearGridBloatFlag(manager: OrderManagerLike): void;
123
152
  /**
124
153
  * Unifies budget calculation and fee deduction for all grid sizing scenarios.
125
154
  * Ensures consistent fund context (Allocated vs Total) across the bot.
@@ -129,12 +158,12 @@ export declare function clearGridBloatFlag(manager: any): void;
129
158
  * @returns {Promise<any|null>}
130
159
  * @private
131
160
  */
132
- export declare function _getSizingContext(manager: any, side: any, { skipRecalc }?: {
161
+ export declare function _getSizingContext(manager: OrderManagerLike, side: string, { skipRecalc }?: {
133
162
  skipRecalc?: boolean;
134
163
  }): Promise<{
135
- budget: any;
136
- precision: any;
137
- config: any;
164
+ budget: number;
165
+ precision: number;
166
+ config: GridConfig;
138
167
  } | null>;
139
168
  /**
140
169
  * Create the initial order grid structure based on configuration.
@@ -182,10 +211,26 @@ export declare function _getSizingContext(manager: any, side: any, { skipRecalc
182
211
  * - n = ceil(ln(1.02) / ln(1.005)) = ceil(3.98) = 4 steps
183
212
  * - G = max(2, 4) = 4 slots
184
213
  *
185
- * @param {any} config - Grid configuration
186
- * @returns {any}
214
+ * @param {unknown} config - Grid configuration
215
+ * @returns {unknown}
187
216
  */
188
- export declare function createOrderGrid(config: any): any;
217
+ export declare function createOrderGrid(config: GridConfig): {
218
+ orders: {
219
+ id: string;
220
+ price: number;
221
+ type: OrderType | null;
222
+ state: OrderState;
223
+ size: number;
224
+ }[];
225
+ boundaryIdx: number;
226
+ initialSpreadCount: {
227
+ buy: number;
228
+ sell: number;
229
+ };
230
+ gapSlots: number;
231
+ priceLevels: number[];
232
+ genesis: MathUtils.GridGenesis;
233
+ };
189
234
  /**
190
235
  * Restore a persisted grid snapshot onto a manager instance.
191
236
  *
@@ -201,16 +246,16 @@ export declare function createOrderGrid(config: any): any;
201
246
  * @param {number|null} [boundaryIdx=null] - The master boundary index.
202
247
  * @returns {Promise<void>}
203
248
  */
204
- export declare function loadGrid(manager: any, grid: any, boundaryIdx?: any, genesisInput?: any, options?: {
249
+ export declare function loadGrid(manager: OrderManagerLike, grid: ManagedOrder[], boundaryIdx?: number | null, genesisInput?: GridGenesis | null, options?: {
205
250
  tolerateTransientStranding?: boolean;
206
- }): Promise<any>;
251
+ }): Promise<void>;
207
252
  /**
208
253
  * Initialize and orchestrate the order grid.
209
254
  *
210
255
  * @return {Promise<void>}
211
256
  * @throws {Error} If initialization fails or account totals are missing.
212
257
  */
213
- export declare function initializeGrid(manager: any): Promise<void>;
258
+ export declare function initializeGrid(manager: OrderManagerLike): Promise<void>;
214
259
  /**
215
260
  * Full grid resynchronization from blockchain state.
216
261
  * @param {import('./types').OrderManager} manager - The manager instance.
@@ -221,14 +266,25 @@ export declare function initializeGrid(manager: any): Promise<void>;
221
266
  * @param {string} opts.privateKey - Private key.
222
267
  * @returns {Promise<void>}
223
268
  */
224
- export declare function recalculateGrid(manager: any, opts: any): Promise<void>;
269
+ export declare function recalculateGrid(manager: OrderManagerLike, opts: {
270
+ readOpenOrdersFn: () => Promise<unknown>;
271
+ chainOrders: unknown;
272
+ account: string;
273
+ privateKey: string;
274
+ [key: string]: unknown;
275
+ }): Promise<void>;
225
276
  /**
226
277
  * Check for grid divergence and trigger update if threshold is met.
227
278
  *
228
279
  * @param {import('./types').OrderManager} manager - Manager instance with order state
229
- * @returns {any}
280
+ * @returns {unknown}
230
281
  */
231
- export declare function checkAndUpdateGridIfNeeded(manager: any): any;
282
+ export declare function checkAndUpdateGridIfNeeded(manager: OrderManagerLike): {
283
+ buyUpdated: boolean;
284
+ sellUpdated: boolean;
285
+ buyShrink: boolean;
286
+ sellShrink: boolean;
287
+ };
232
288
  /**
233
289
  * Standardize grid sizes using blockchain total context.
234
290
  *
@@ -284,10 +340,10 @@ export declare function checkAndUpdateGridIfNeeded(manager: any): any;
284
340
  * @returns {Promise<{actions: Array, changed: boolean}|undefined>} - COW result or undefined
285
341
  * @private
286
342
  */
287
- export declare function _recalculateGridOrderSizesFromBlockchain(manager: any, orderType: any, options?: {
288
- workingGrid?: any;
343
+ export declare function _recalculateGridOrderSizesFromBlockchain(manager: OrderManagerLike, orderType: OrderType, options?: {
344
+ workingGrid?: WorkingGrid;
289
345
  }): Promise<{
290
- actions: any[];
346
+ actions: CowAction[];
291
347
  changed: boolean;
292
348
  } | undefined>;
293
349
  /**
@@ -301,11 +357,11 @@ export declare function _recalculateGridOrderSizesFromBlockchain(manager: any, o
301
357
  * @param {number|null} [overrideBoundaryIdx=null] - Optional override for boundary index
302
358
  * @returns {Promise<{actions: Array, workingGrid: import('./working_grid.js'), workingIndexes: Object, workingBoundary: number, hasWorkingChanges: boolean, aborted: boolean}|null>}
303
359
  */
304
- export declare function updateGridFromBlockchainSnapshot(manager: any, orderType?: any, fromBlockchainTimer?: any, overrideBoundaryIdx?: any): Promise<{
305
- actions: any[];
306
- workingGrid: any;
307
- workingIndexes: any;
308
- workingBoundary: any;
360
+ export declare function updateGridFromBlockchainSnapshot(manager: OrderManagerLike, orderType?: OrderType | 'both', fromBlockchainTimer?: boolean, overrideBoundaryIdx?: number | null): Promise<{
361
+ actions: CowAction[];
362
+ workingGrid: WorkingGrid;
363
+ workingIndexes: unknown;
364
+ workingBoundary: number | null;
309
365
  hasWorkingChanges: boolean;
310
366
  aborted: boolean;
311
367
  } | null>;
@@ -345,7 +401,18 @@ export declare function updateGridFromBlockchainSnapshot(manager: any, orderType
345
401
  * @param {import('./types').OrderManager|null} [manager=null] - Manager instance (for grid lock access)
346
402
  * @returns {Promise<any>}
347
403
  */
348
- export declare function compareGrids(calculatedGrid: any, persistedGrid: any, manager?: any): Promise<any>;
404
+ export declare function compareGrids(calculatedGrid: unknown[], persistedGrid: unknown[], manager?: OrderManagerLike | null): Promise<{
405
+ buy: {
406
+ metric: number;
407
+ updated: boolean;
408
+ };
409
+ sell: {
410
+ metric: number;
411
+ updated: boolean;
412
+ };
413
+ totalMetric?: number;
414
+ thresholdPct?: number;
415
+ }>;
349
416
  /**
350
417
  * Unified divergence monitoring.
351
418
  * Performs both Ratio-based and RMS-based divergence checks.
@@ -355,13 +422,31 @@ export declare function compareGrids(calculatedGrid: any, persistedGrid: any, ma
355
422
  * @param {Array<any>} persistedGrid - Current/persisted grid
356
423
  * @returns {Promise<any>}
357
424
  */
358
- export declare function monitorDivergence(manager: any, calculatedGrid: any, persistedGrid: any): Promise<any>;
425
+ export declare function monitorDivergence(manager: OrderManagerLike, calculatedGrid: unknown[], persistedGrid: unknown[]): Promise<{
426
+ needsUpdate: boolean;
427
+ buy: {
428
+ updated: boolean;
429
+ ratio: boolean;
430
+ rms: boolean;
431
+ metric: number;
432
+ shrink: boolean;
433
+ };
434
+ sell: {
435
+ updated: boolean;
436
+ ratio: boolean;
437
+ rms: boolean;
438
+ metric: number;
439
+ shrink: boolean;
440
+ };
441
+ orderType?: string | null;
442
+ thresholdPct?: number;
443
+ }>;
359
444
  /**
360
445
  * Calculate current market spread using on-chain orders.
361
446
  * @param {import('./types').OrderManager} manager - The manager instance.
362
447
  * @returns {number} The calculated spread percentage.
363
448
  */
364
- export declare function calculateCurrentSpread(manager: any): number;
449
+ export declare function calculateCurrentSpread(manager: OrderManagerLike): number;
365
450
  /**
366
451
  * Proactive spread correction check.
367
452
  *
@@ -385,7 +470,13 @@ export declare function calculateCurrentSpread(manager: any): number;
385
470
  * @param {Function|null} [updateOrdersOnChainBatch=null] - Optional batch update function
386
471
  * @returns {Promise<any>}
387
472
  */
388
- export declare function checkSpreadCondition(manager: any, _BitShares: any, updateOrdersOnChainBatch?: any): Promise<any>;
473
+ export declare function checkSpreadCondition(manager: OrderManagerLike, _BitShares: unknown, updateOrdersOnChainBatch?: ((correction: SpreadCorrection) => Promise<{
474
+ executed?: boolean;
475
+ }>) | null): Promise<{
476
+ ordersPlaced: number;
477
+ partialsMoved: number;
478
+ fundsExhausted?: boolean;
479
+ }>;
389
480
  /**
390
481
  * Grid health check for structural violations.
391
482
  * Monitors for "Dust Partials" that are too small to be traded on-chain,
@@ -399,7 +490,14 @@ export declare function checkSpreadCondition(manager: any, _BitShares: any, upda
399
490
  * @param {Function|null} [updateOrdersOnChainBatch=null] - Optional batch update function.
400
491
  * @returns {Promise<any>}
401
492
  */
402
- export declare function checkGridHealth(manager: any, _updateOrdersOnChainBatch?: any): Promise<any>;
493
+ export declare function checkGridHealth(manager: OrderManagerLike, _updateOrdersOnChainBatch?: ((correction: SpreadCorrection) => Promise<{
494
+ executed?: boolean;
495
+ }>) | null): Promise<{
496
+ buyDust: boolean;
497
+ sellDust: boolean;
498
+ buyDustOrders: unknown[];
499
+ sellDustOrders: unknown[];
500
+ }>;
403
501
  /**
404
502
  * Dust check covering all partial orders, with interior-only guard.
405
503
  *
@@ -421,7 +519,12 @@ export declare function checkGridHealth(manager: any, _updateOrdersOnChainBatch?
421
519
  * @param {import('./types').OrderManager} manager
422
520
  * @returns {Promise<any>}
423
521
  */
424
- export declare function checkWindowDust(manager: any): Promise<any>;
522
+ export declare function checkWindowDust(manager: OrderManagerLike): Promise<{
523
+ buyDust: boolean;
524
+ sellDust: boolean;
525
+ buyDustOrders: ManagedOrder[];
526
+ sellDustOrders: ManagedOrder[];
527
+ }>;
425
528
  /**
426
529
  * Public dust helper shared by StrategyEngine and Grid health checks.
427
530
  * @param {import('./types').OrderManager} manager
@@ -429,7 +532,7 @@ export declare function checkWindowDust(manager: any): Promise<any>;
429
532
  * @param {'buy'|'sell'} side
430
533
  * @returns {Promise<boolean>}
431
534
  */
432
- export declare function hasAnyDust(manager: any, partials: any, side: any): Promise<boolean>;
535
+ export declare function hasAnyDust(manager: OrderManagerLike, partials: ManagedOrder[], side: string): Promise<boolean>;
433
536
  /**
434
537
  * Public dust helper that returns the subset of candidate partials currently below
435
538
  * the configured dust threshold for the requested side.
@@ -438,7 +541,7 @@ export declare function hasAnyDust(manager: any, partials: any, side: any): Prom
438
541
  * @param {'buy'|'sell'} side
439
542
  * @returns {Promise<Array<any>>}
440
543
  */
441
- export declare function getDustOrders(manager: any, partials: any, side: any): Promise<any[]>;
544
+ export declare function getDustOrders(manager: OrderManagerLike, partials: ManagedOrder[], side: string): Promise<ManagedOrder[]>;
442
545
  /**
443
546
  * Determine which side has more available funds for spread correction.
444
547
  * @param {import('./types').OrderManager} manager - The manager instance.
@@ -446,7 +549,10 @@ export declare function getDustOrders(manager: any, partials: any, side: any): P
446
549
  * normalize sell-side funds into buy-side units for a fair cross-asset comparison.
447
550
  * @returns {{ side: import('./types').OrderType|null, reason: string }} The side to correct on, or null if insufficient funds.
448
551
  */
449
- export declare function determineOrderSideByFunds(manager: any, currentMarketPrice: any): any;
552
+ export declare function determineOrderSideByFunds(manager: OrderManagerLike, currentMarketPrice: number): {
553
+ side: OrderType | null;
554
+ reason: string;
555
+ };
450
556
  /**
451
557
  * Prepares one or more orders to correct a wide spread.
452
558
  * @param {import('./types').OrderManager} manager - The OrderManager instance.
@@ -454,5 +560,5 @@ export declare function determineOrderSideByFunds(manager: any, currentMarketPri
454
560
  * @returns {Promise<any>}
455
561
  * @throws {Error} If preferredSide is invalid.
456
562
  */
457
- export declare function prepareSpreadCorrectionOrders(manager: any, preferredSide: any, outOfSpread?: number): Promise<any>;
563
+ export declare function prepareSpreadCorrectionOrders(manager: OrderManagerLike, preferredSide: OrderType, outOfSpread?: number): Promise<SpreadCorrection | null>;
458
564
  //# sourceMappingURL=grid.d.ts.map