dexbot 1.6.10 → 1.6.12

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (365) hide show
  1. package/CHANGELOG.md +50 -3
  2. package/README.md +3 -1
  3. package/analysis/README.md +51 -11
  4. package/analysis/bot_fitting/README.md +12 -0
  5. package/analysis/tradingview/README.md +3 -3
  6. package/analysis/trend_detection/DYNAMIC_WEIGHT_RESEARCH.md +11 -37
  7. package/analysis/trend_detection/README.md +31 -0
  8. package/claw/docs/DEXBOT2_TUNING_CHEAT_SHEET.md +4 -3
  9. package/claw/modules/chain_broadcast.ts +7 -1
  10. package/claw/modules/claw_launcher.ts +1 -1
  11. package/claw/modules/launcher_mode_detector.ts +9 -2
  12. package/claw/package.json +1 -1
  13. package/claw/runtimes/openclaw-plugin/openclaw.plugin.json +1 -1
  14. package/claw/runtimes/openclaw-plugin/package.json +1 -1
  15. package/dist/analysis/account_resolver.d.ts +1 -1
  16. package/dist/analysis/account_resolver.js +15 -2
  17. package/dist/analysis/ama_fitting/analyze_ama_price_changes.js +3 -4
  18. package/dist/analysis/ama_fitting/analyze_lambda_vs_slow.js +2 -7
  19. package/dist/analysis/ama_fitting/calibrate_convergence_er.js +0 -1
  20. package/dist/analysis/ama_fitting/fetch_lp_candles.js +4 -4
  21. package/dist/analysis/ama_fitting/generate_unified_comparison_chart.d.ts +20 -4
  22. package/dist/analysis/ama_fitting/generate_unified_comparison_chart.js +9 -6
  23. package/dist/analysis/ama_fitting/optimizer_high_resolution.js +16 -12
  24. package/dist/analysis/analyze_args.d.ts +31 -0
  25. package/dist/analysis/analyze_args.js +41 -0
  26. package/dist/analysis/analyze_dynamic_weight.js +7 -20
  27. package/dist/analysis/analyze_kalman.js +7 -17
  28. package/dist/analysis/analyze_regime.js +7 -17
  29. package/dist/analysis/analyze_regime_windows.js +8 -18
  30. package/dist/analysis/analyze_risk_profile.js +8 -18
  31. package/dist/analysis/analyze_trade_heatmap.js +7 -17
  32. package/dist/analysis/analyze_volatility.js +7 -17
  33. package/dist/analysis/bot_fitting/backtest_ama_sweep.d.ts +220 -12
  34. package/dist/analysis/bot_fitting/backtest_ama_sweep.js +55 -10
  35. package/dist/analysis/bot_fitting/backtest_bot_fitting.d.ts +34 -4
  36. package/dist/analysis/bot_fitting/backtest_bot_fitting.js +72 -66
  37. package/dist/analysis/bot_fitting/backtest_lookback_drawdown.d.ts +21 -0
  38. package/dist/analysis/bot_fitting/backtest_lookback_drawdown.js +315 -0
  39. package/dist/analysis/bot_fitting/shared_utils.d.ts +7 -7
  40. package/dist/analysis/bot_fitting/shared_utils.js +2 -2
  41. package/dist/analysis/bot_key_utils.d.ts +18 -10
  42. package/dist/analysis/bot_key_utils.js +10 -17
  43. package/dist/analysis/bot_usage/discover_bot_accounts.js +44 -47
  44. package/dist/analysis/bot_usage/kibana_bot_queries.d.ts +1 -21
  45. package/dist/analysis/chain_pool.d.ts +3 -1
  46. package/dist/analysis/chart_ui.d.ts +5 -2
  47. package/dist/analysis/chart_ui.js +6 -3
  48. package/dist/analysis/chart_utils.d.ts +5 -5
  49. package/dist/analysis/chart_utils.js +9 -0
  50. package/dist/analysis/fills_cache.d.ts +64 -0
  51. package/dist/analysis/fills_cache.js +254 -0
  52. package/dist/analysis/fills_source.d.ts +2 -2
  53. package/dist/analysis/fills_source.js +19 -14
  54. package/dist/analysis/grid_correction_check.d.ts +1 -1
  55. package/dist/analysis/grid_correction_check.js +12 -11
  56. package/dist/analysis/math_utils.d.ts +7 -6
  57. package/dist/analysis/math_utils.js +5 -8
  58. package/dist/analysis/pnl_report.d.ts +39 -0
  59. package/dist/analysis/pnl_report.js +325 -0
  60. package/dist/analysis/price_sources.d.ts +8 -8
  61. package/dist/analysis/price_sources.js +5 -4
  62. package/dist/analysis/resolve_bot_accounts.js +2 -2
  63. package/dist/analysis/resolve_source.d.ts +1 -2
  64. package/dist/analysis/trade_profitability.d.ts +32 -2
  65. package/dist/analysis/trade_profitability.js +232 -106
  66. package/dist/analysis/tradingview/analyze_tradingview.d.ts +17 -6
  67. package/dist/analysis/tradingview/analyze_tradingview.js +9 -10
  68. package/dist/analysis/tradingview/grid_reset_config.d.ts +42 -31
  69. package/dist/analysis/tradingview/grid_reset_config.js +35 -6
  70. package/dist/analysis/tradingview/grid_reset_sim.d.ts +75 -8
  71. package/dist/analysis/tradingview/grid_reset_sim.js +42 -5
  72. package/dist/analysis/tradingview/tradingview_uplot_chart_generator.d.ts +69 -4
  73. package/dist/analysis/tradingview/tradingview_uplot_chart_generator.js +20 -20
  74. package/dist/analysis/trend_detection/backtest_ama_slope_huber.d.ts +102 -0
  75. package/dist/analysis/trend_detection/backtest_ama_slope_huber.js +725 -0
  76. package/dist/analysis/trend_detection/dynamic_weight_chart_generator.d.ts +63 -1
  77. package/dist/analysis/trend_detection/dynamic_weight_chart_generator.js +27 -112
  78. package/dist/analysis/trend_detection/huber_scale_variants.d.ts +40 -0
  79. package/dist/analysis/trend_detection/huber_scale_variants.js +176 -0
  80. package/dist/analysis/trend_detection/kalman_chart_generator.d.ts +30 -1
  81. package/dist/analysis/trend_detection/kalman_chart_generator.js +3 -3
  82. package/dist/analysis/trend_detection/regime_chart_generator.d.ts +31 -1
  83. package/dist/analysis/trend_detection/regime_chart_generator.js +2 -2
  84. package/dist/analysis/trend_detection/volatility_chart_generator.d.ts +33 -1
  85. package/dist/credential-daemon.js +34 -20
  86. package/dist/dexbot.js +17 -14
  87. package/dist/market_adapter/candle_utils.d.ts +22 -18
  88. package/dist/market_adapter/candle_utils.js +24 -20
  89. package/dist/market_adapter/core/asymmetric_bounds.d.ts +13 -4
  90. package/dist/market_adapter/core/config_normalizers.d.ts +3 -3
  91. package/dist/market_adapter/core/kibana_candles.d.ts +53 -18
  92. package/dist/market_adapter/core/kibana_candles.js +9 -7
  93. package/dist/market_adapter/core/kibana_client.d.ts +9 -1
  94. package/dist/market_adapter/core/kibana_client.js +8 -7
  95. package/dist/market_adapter/core/kibana_market_candles.d.ts +3 -2
  96. package/dist/market_adapter/core/market_adapter_service.d.ts +297 -115
  97. package/dist/market_adapter/core/market_adapter_service.js +184 -101
  98. package/dist/market_adapter/core/strategies/ama.d.ts +10 -2
  99. package/dist/market_adapter/core/strategies/ama.js +7 -32
  100. package/dist/market_adapter/core/strategies/ama_slope_model.d.ts +14 -1
  101. package/dist/market_adapter/core/strategies/ama_slope_model.js +12 -34
  102. package/dist/market_adapter/core/strategies/atr/calculator.d.ts +7 -2
  103. package/dist/market_adapter/core/strategies/atr/calculator.js +2 -34
  104. package/dist/market_adapter/core/strategies/collateral_manager.d.ts +7 -1
  105. package/dist/market_adapter/core/strategies/collateral_manager.js +0 -22
  106. package/dist/market_adapter/core/strategies/dynamic_weight_series.d.ts +36 -8
  107. package/dist/market_adapter/core/strategies/dynamic_weight_series.js +9 -9
  108. package/dist/market_adapter/core/strategies/regime_gate.d.ts +24 -15
  109. package/dist/market_adapter/core/strategies/regime_gate.js +4 -31
  110. package/dist/market_adapter/core/strategies/regime_interp.d.ts +7 -1
  111. package/dist/market_adapter/core/strategies/regime_interp.js +14 -22
  112. package/dist/market_adapter/core/strategies/volatility_shift.d.ts +11 -1
  113. package/dist/market_adapter/core/strategies/volatility_shift.js +0 -13
  114. package/dist/market_adapter/inputs/cex_candle_parsing.d.ts +29 -0
  115. package/dist/market_adapter/inputs/cex_candle_parsing.js +52 -0
  116. package/dist/market_adapter/inputs/fetch_book_data.d.ts +20 -4
  117. package/dist/market_adapter/inputs/fetch_book_data.js +3 -1
  118. package/dist/market_adapter/inputs/fetch_cex_synthetic_data.js +97 -226
  119. package/dist/market_adapter/inputs/fetch_lp_data.d.ts +42 -7
  120. package/dist/market_adapter/inputs/fetch_lp_data.js +22 -15
  121. package/dist/market_adapter/inputs/kibana_feed_source.d.ts +74 -15
  122. package/dist/market_adapter/inputs/kibana_feed_source.js +29 -22
  123. package/dist/market_adapter/inputs/kibana_source.d.ts +25 -3
  124. package/dist/market_adapter/inputs/kibana_source.js +2 -2
  125. package/dist/market_adapter/inputs/window_cache.d.ts +99 -94
  126. package/dist/market_adapter/inputs/window_cache.js +8 -8
  127. package/dist/market_adapter/interval_utils.d.ts +4 -4
  128. package/dist/market_adapter/log_format.d.ts +6 -6
  129. package/dist/market_adapter/log_format.js +28 -22
  130. package/dist/market_adapter/lp_chart_core.d.ts +22 -1
  131. package/dist/market_adapter/lp_chart_core.js +26 -192
  132. package/dist/market_adapter/lp_chart_runner.d.ts +7 -7
  133. package/dist/market_adapter/lp_chart_strategy_loader.d.ts +41 -6
  134. package/dist/market_adapter/lp_chart_strategy_loader.js +8 -7
  135. package/dist/market_adapter/market_adapter.d.ts +94 -33
  136. package/dist/market_adapter/market_adapter.js +69 -75
  137. package/dist/market_adapter/utils/adapter_client.d.ts +3 -3
  138. package/dist/market_adapter/utils/adapter_client.js +2 -2
  139. package/dist/market_adapter/utils/atomic_write.d.ts +8 -1
  140. package/dist/market_adapter/utils/chain.d.ts +50 -41
  141. package/dist/market_adapter/utils/chain.js +40 -46
  142. package/dist/market_adapter/utils/data_discovery.d.ts +4 -1
  143. package/dist/market_adapter/utils/dynamic_grid_snapshot.d.ts +12 -3
  144. package/dist/market_adapter/utils/file_json_cache.d.ts +2 -2
  145. package/dist/market_adapter/utils/file_lock.d.ts +28 -14
  146. package/dist/market_adapter/utils/file_lock.js +36 -32
  147. package/dist/market_adapter/utils/native_history.d.ts +9 -2
  148. package/dist/market_adapter/utils/native_history.js +35 -28
  149. package/dist/modules/account_bots.d.ts +577 -21
  150. package/dist/modules/account_bots.js +182 -158
  151. package/dist/modules/account_orders.d.ts +66 -30
  152. package/dist/modules/account_orders.js +22 -20
  153. package/dist/modules/authority_resolver.d.ts +12 -2
  154. package/dist/modules/authority_resolver.js +15 -8
  155. package/dist/modules/bitshares-native/chain_client.d.ts +38 -3
  156. package/dist/modules/bitshares-native/chain_client.js +45 -46
  157. package/dist/modules/bitshares-native/crypto/ecc.browser.js +11 -171
  158. package/dist/modules/bitshares-native/crypto/ecc.js +13 -176
  159. package/dist/modules/bitshares-native/crypto/ecc_core.d.ts +33 -0
  160. package/dist/modules/bitshares-native/crypto/ecc_core.js +213 -0
  161. package/dist/modules/bitshares-native/crypto/ecc_selector.d.ts +2 -1
  162. package/dist/modules/bitshares-native/crypto/ecc_selector.js +1 -13
  163. package/dist/modules/bitshares-native/index.d.ts +1 -1
  164. package/dist/modules/bitshares-native/lru_cache.d.ts +7 -7
  165. package/dist/modules/bitshares-native/resolvers.d.ts +18 -6
  166. package/dist/modules/bitshares-native/serial/lazy_buffer.d.ts +4 -0
  167. package/dist/modules/bitshares-native/serial/lazy_buffer.js +21 -0
  168. package/dist/modules/bitshares-native/serial/operations.d.ts +1 -1
  169. package/dist/modules/bitshares-native/serial/serializer.d.ts +16 -12
  170. package/dist/modules/bitshares-native/serial/serializer.js +7 -13
  171. package/dist/modules/bitshares-native/serial/types.d.ts +25 -16
  172. package/dist/modules/bitshares-native/serial/types.js +55 -62
  173. package/dist/modules/bitshares-native/signing_client.d.ts +32 -2
  174. package/dist/modules/bitshares-native/signing_client.js +19 -14
  175. package/dist/modules/bitshares-native/subscriptions.d.ts +81 -1
  176. package/dist/modules/bitshares-native/subscriptions.js +12 -12
  177. package/dist/modules/bitshares-native/transport.d.ts +5 -4
  178. package/dist/modules/bitshares-native/transport.js +5 -4
  179. package/dist/modules/bitshares-native/tx/builder.d.ts +40 -5
  180. package/dist/modules/bitshares-native/tx/builder.js +4 -3
  181. package/dist/modules/bitshares-native/tx/tx_cache.d.ts +4 -4
  182. package/dist/modules/bitshares_client.d.ts +45 -13
  183. package/dist/modules/bitshares_client.js +28 -19
  184. package/dist/modules/bot_defaults.d.ts +6 -15
  185. package/dist/modules/bot_defaults.js +1 -5
  186. package/dist/modules/bot_settings.d.ts +44 -10
  187. package/dist/modules/bot_settings.js +11 -8
  188. package/dist/modules/bots_file_lock.d.ts +6 -6
  189. package/dist/modules/bots_file_lock.js +16 -12
  190. package/dist/modules/broadcast_failure.d.ts +2 -2
  191. package/dist/modules/broadcast_failure.js +5 -4
  192. package/dist/modules/chain_keys.d.ts +42 -40
  193. package/dist/modules/chain_keys.js +53 -45
  194. package/dist/modules/chain_orders.d.ts +93 -59
  195. package/dist/modules/chain_orders.js +31 -23
  196. package/dist/modules/constants.d.ts +530 -32
  197. package/dist/modules/constants.js +52 -60
  198. package/dist/modules/cr_planner.d.ts +40 -2
  199. package/dist/modules/credential_policy.d.ts +68 -8
  200. package/dist/modules/credential_policy.js +37 -31
  201. package/dist/modules/credential_session_cache.d.ts +2 -2
  202. package/dist/modules/credit_pricing.d.ts +42 -6
  203. package/dist/modules/credit_pricing.js +44 -30
  204. package/dist/modules/credit_runtime.d.ts +276 -118
  205. package/dist/modules/credit_runtime.js +462 -165
  206. package/dist/modules/crypto/browser_provider.js +6 -4
  207. package/dist/modules/crypto/node_provider.js +1 -1
  208. package/dist/modules/crypto/pure_scrypt.js +35 -4
  209. package/dist/modules/crypto/pure_secp256k1.js +72 -26
  210. package/dist/modules/crypto/sync.d.ts +9 -9
  211. package/dist/modules/crypto/sync.js +16 -9
  212. package/dist/modules/dexbot_class.d.ts +195 -139
  213. package/dist/modules/dexbot_class.js +78 -28
  214. package/dist/modules/dexbot_cow_runtime.d.ts +167 -87
  215. package/dist/modules/dexbot_cow_runtime.js +248 -206
  216. package/dist/modules/dexbot_credential_client.d.ts +19 -11
  217. package/dist/modules/dexbot_fill_runtime.d.ts +63 -48
  218. package/dist/modules/dexbot_fill_runtime.js +48 -41
  219. package/dist/modules/dexbot_maintenance_runtime.d.ts +109 -70
  220. package/dist/modules/dexbot_maintenance_runtime.js +117 -80
  221. package/dist/modules/dexbot_startup_runtime.d.ts +11 -10
  222. package/dist/modules/dexbot_startup_runtime.js +43 -43
  223. package/dist/modules/dexbot_state_recovery.d.ts +13 -12
  224. package/dist/modules/dexbot_state_recovery.js +18 -13
  225. package/dist/modules/fund_registry.d.ts +4 -2
  226. package/dist/modules/fund_registry.js +10 -10
  227. package/dist/modules/general_settings.d.ts +30 -4
  228. package/dist/modules/graceful_shutdown.d.ts +3 -3
  229. package/dist/modules/graceful_shutdown.js +2 -2
  230. package/dist/modules/grid_price_source.d.ts +1 -1
  231. package/dist/modules/key_store.d.ts +14 -8
  232. package/dist/modules/key_store.js +7 -6
  233. package/dist/modules/launcher/adapter_requirement.d.ts +11 -5
  234. package/dist/modules/launcher/adapter_requirement.js +5 -5
  235. package/dist/modules/launcher/bot_supervisor.d.ts +106 -24
  236. package/dist/modules/launcher/bot_supervisor.js +12 -11
  237. package/dist/modules/launcher/credential_bootstrap.d.ts +1 -1
  238. package/dist/modules/launcher/credential_bootstrap.js +1 -1
  239. package/dist/modules/launcher/credential_daemon.d.ts +4 -4
  240. package/dist/modules/launcher/credential_daemon.js +2 -2
  241. package/dist/modules/launcher/credential_secret.d.ts +1 -1
  242. package/dist/modules/launcher/foreign_cred_daemon.d.ts +2 -2
  243. package/dist/modules/launcher/market_adapter_runtime.d.ts +61 -6
  244. package/dist/modules/launcher/market_adapter_watchdog.d.ts +10 -2
  245. package/dist/modules/launcher/market_adapter_watchdog.js +4 -0
  246. package/dist/modules/launcher/monolithic_runtime.d.ts +18 -16
  247. package/dist/modules/launcher/status_reporting.d.ts +22 -14
  248. package/dist/modules/launcher/supervisor_control.d.ts +8 -1
  249. package/dist/modules/launcher/supervisor_control.js +4 -2
  250. package/dist/modules/market_adapter_whitelist.d.ts +9 -3
  251. package/dist/modules/market_adapter_whitelist.js +15 -3
  252. package/dist/modules/node_manager.d.ts +41 -11
  253. package/dist/modules/node_manager.js +5 -4
  254. package/dist/modules/order/accounting.d.ts +53 -24
  255. package/dist/modules/order/accounting.js +40 -14
  256. package/dist/modules/order/async_lock.d.ts +5 -2
  257. package/dist/modules/order/async_lock.js +1 -1
  258. package/dist/modules/order/export.d.ts +7 -6
  259. package/dist/modules/order/export.js +1 -7
  260. package/dist/modules/order/format.d.ts +39 -19
  261. package/dist/modules/order/format.js +62 -16
  262. package/dist/modules/order/genesis_policy.d.ts +21 -18
  263. package/dist/modules/order/genesis_policy.js +12 -8
  264. package/dist/modules/order/grid.d.ts +142 -36
  265. package/dist/modules/order/grid.js +148 -123
  266. package/dist/modules/order/grid_reconcile.d.ts +21 -20
  267. package/dist/modules/order/grid_reconcile.js +13 -12
  268. package/dist/modules/order/grid_reconcile_internal.d.ts +85 -72
  269. package/dist/modules/order/grid_reconcile_internal.js +28 -19
  270. package/dist/modules/order/index.d.ts +263 -1
  271. package/dist/modules/order/logger.d.ts +45 -11
  272. package/dist/modules/order/logger.js +38 -40
  273. package/dist/modules/order/logger_state.d.ts +4 -4
  274. package/dist/modules/order/manager.d.ts +226 -180
  275. package/dist/modules/order/manager.js +101 -83
  276. package/dist/modules/order/processed_fill_store.d.ts +18 -3
  277. package/dist/modules/order/processed_fill_store.js +16 -27
  278. package/dist/modules/order/strategy.d.ts +21 -13
  279. package/dist/modules/order/strategy.js +5 -6
  280. package/dist/modules/order/sync_engine.d.ts +91 -33
  281. package/dist/modules/order/sync_engine.js +99 -54
  282. package/dist/modules/order/utils/math.d.ts +157 -102
  283. package/dist/modules/order/utils/math.js +77 -38
  284. package/dist/modules/order/utils/order.d.ts +326 -106
  285. package/dist/modules/order/utils/order.js +200 -99
  286. package/dist/modules/order/utils/slot.d.ts +1 -1
  287. package/dist/modules/order/utils/system.d.ts +176 -26
  288. package/dist/modules/order/utils/system.js +86 -69
  289. package/dist/modules/order/utils/validate.d.ts +89 -41
  290. package/dist/modules/order/utils/validate.js +24 -22
  291. package/dist/modules/order/utils/withPoolRef.d.ts +4 -3
  292. package/dist/modules/order/utils/withPoolRef.js +18 -12
  293. package/dist/modules/order/working_grid.d.ts +14 -13
  294. package/dist/modules/paths.d.ts +3 -4
  295. package/dist/modules/paths.js +3 -27
  296. package/dist/modules/process_discovery.d.ts +1 -1
  297. package/dist/modules/process_discovery.js +2 -1
  298. package/dist/modules/runtime.d.ts +7 -3
  299. package/dist/modules/runtime.js +4 -3
  300. package/dist/modules/runtime_settings.d.ts +15 -10
  301. package/dist/modules/runtime_settings.js +30 -24
  302. package/dist/modules/settings_merge.d.ts +29 -3
  303. package/dist/modules/settings_merge.js +56 -78
  304. package/dist/modules/socket_json_client.d.ts +7 -4
  305. package/dist/modules/storage/browser_adapter.d.ts +38 -53
  306. package/dist/modules/storage/browser_adapter.js +7 -30
  307. package/dist/modules/storage/index.d.ts +1 -1
  308. package/dist/modules/storage/node_adapter.d.ts +45 -27
  309. package/dist/modules/storage/node_adapter.js +9 -9
  310. package/dist/modules/storage/types.d.ts +5 -4
  311. package/dist/modules/types.d.ts +1071 -2
  312. package/dist/modules/types.js +4 -1
  313. package/dist/modules/utils/asset_symbols.d.ts +2 -1
  314. package/dist/modules/utils/asset_symbols.js +2 -1
  315. package/dist/modules/utils/errors.d.ts +9 -0
  316. package/dist/modules/utils/errors.js +23 -1
  317. package/dist/modules/utils/time_range.d.ts +4 -0
  318. package/dist/modules/utils/time_range.js +18 -0
  319. package/dist/modules/validate_profiles.js +53 -43
  320. package/dist/modules/version_notice.d.ts +14 -3
  321. package/dist/modules/version_notice.js +6 -4
  322. package/dist/pm2.d.ts +29 -27
  323. package/dist/pm2.js +5 -5
  324. package/dist/scripts/analyze-credit.d.ts +2 -1
  325. package/dist/scripts/analyze-credit.js +23 -24
  326. package/dist/scripts/analyze-orders.d.ts +77 -9
  327. package/dist/scripts/analyze-orders.js +66 -84
  328. package/dist/scripts/chart_command.d.ts +27 -18
  329. package/dist/scripts/chart_command.js +16 -15
  330. package/dist/scripts/check_any.d.ts +18 -0
  331. package/dist/scripts/check_any.js +126 -0
  332. package/dist/scripts/diagnose-pool-history.js +12 -7
  333. package/dist/scripts/pnl.d.ts +3 -0
  334. package/dist/scripts/pnl.js +40 -0
  335. package/dist/scripts/print_grid.js +0 -1
  336. package/dist/scripts/run-tests.js +39 -7
  337. package/dist/scripts/runner.js +1 -1
  338. package/dist/scripts/test-credit-renewal.js +30 -21
  339. package/dist/scripts/update.d.ts +10 -5
  340. package/dist/scripts/update.js +168 -103
  341. package/dist/scripts/update_dist_freshness.js +1 -0
  342. package/dist/scripts/update_layout.d.ts +61 -0
  343. package/dist/scripts/update_layout.js +180 -0
  344. package/dist/scripts/validate_bots.js +2 -1
  345. package/dist/scripts/verify-browser-bundle.js +8 -0
  346. package/dist/unlock.d.ts +28 -3
  347. package/dist/unlock.js +72 -10
  348. package/docs/BITSHARES_ONBOARDING.md +2 -0
  349. package/docs/COPY_ON_WRITE_MASTER_PLAN.md +1 -1
  350. package/docs/COW_INVARIANTS.md +13 -6
  351. package/docs/DEXBOT_COMPARISON.md +8 -8
  352. package/docs/EVOLUTION.md +12 -10
  353. package/docs/FUND_MOVEMENT_AND_ACCOUNTING.md +5 -5
  354. package/docs/GRID_RECALCULATION.md +15 -16
  355. package/docs/GRID_RECONCILE.md +14 -3
  356. package/docs/LIFECYCLE.md +11 -11
  357. package/docs/MPA_CREDIT_USAGE.md +22 -3
  358. package/docs/README.md +15 -4
  359. package/docs/WORKFLOW.md +1 -0
  360. package/docs/architecture.md +12 -9
  361. package/docs/developer_guide.md +6 -6
  362. package/market_adapter/README.md +9 -26
  363. package/modules/README.md +4 -1
  364. package/package.json +4 -1
  365. package/scripts/README.md +14 -0
@@ -7,6 +7,7 @@
7
7
  * Each function takes the DEXBot instance as its first parameter, following
8
8
  * the same pattern as dexbot_fill_runtime.ts.
9
9
  */
10
+ import * as chainOrdersModule from './chain_orders.js';
10
11
  /**
11
12
  * Re-verify a B-stamped gap-evacuation rotation against the LIVE committed
12
13
  * geometry (boundaryIdx/_gapSlots at execution time). The stamp freezes
@@ -17,19 +18,100 @@
17
18
  * last-fill guard. Non-finite live geometry cannot disprove the stamp and
18
19
  * keeps the plan-build authority (fail-open to the stamp, never to the guard).
19
20
  */
20
- export declare function isEvacuationStampStillValid(liveBoundary: any, liveGapSlots: any, sourceId: any, destId: any, orderType: any): boolean;
21
+ export declare function isEvacuationStampStillValid(liveBoundary: unknown, liveGapSlots: unknown, sourceId: unknown, destId: unknown, orderType: unknown): boolean;
22
+ import * as workingGridModule from './order/working_grid.js';
23
+ declare const WorkingGrid: typeof workingGridModule.WorkingGrid;
24
+ import type { BotLike, OrderManagerLike, ManagedOrder, ChainOrder, UnknownRecord, AssetInfo, CowAction } from './types.js';
25
+ /** Loose JSON-object view. */
26
+ type JsonObj = UnknownRecord;
27
+ /** Final integer tuple for a planned order op. */
28
+ interface FinalInts {
29
+ sell: number;
30
+ receive: number;
31
+ sellAssetId: string;
32
+ receiveAssetId: string;
33
+ [key: string]: unknown;
34
+ }
35
+ /** A pending-broadcast entry recorded before chain submission. */
36
+ interface PendingEntry {
37
+ slotId?: unknown;
38
+ finalInts?: FinalInts;
39
+ orderType?: unknown;
40
+ fingerprint?: unknown;
41
+ order?: ManagedOrder;
42
+ context?: JsonObj;
43
+ ctxIndex?: number;
44
+ opIndex?: number;
45
+ [key: string]: unknown;
46
+ }
47
+ /**
48
+ * The COW plan result: a projected working grid plus the actions to execute.
49
+ * Produced by `buildCowResultFromPlan` and threaded through the pre-broadcast
50
+ * guards and the batch executor.
51
+ */
52
+ export interface CowResult extends JsonObj {
53
+ actions: CowAction[];
54
+ workingBoundary: number;
55
+ workingGrid: InstanceType<typeof WorkingGrid>;
56
+ workingIndexes: unknown;
57
+ origin?: string;
58
+ refillSlotIds?: string[];
59
+ fills?: unknown[];
60
+ }
61
+ /** Result of the pre-broadcast guard chain. */
62
+ export interface PreBroadcastGuardResult extends JsonObj {
63
+ proceed: boolean;
64
+ result?: JsonObj;
65
+ crossingCandidates?: unknown[];
66
+ intraBatchCandidates?: unknown[];
67
+ }
68
+ /** A CREATE op context with its resolved order + integer tuple. */
69
+ type CreateContext = OpPhase & {
70
+ finalInts: FinalInts;
71
+ order: ManagedOrder;
72
+ };
73
+ /** A chain order enriched with the loose fields COW recovery reads. */
74
+ export interface ChainOrderLike extends ChainOrder {
75
+ type?: unknown;
76
+ sellInt?: unknown;
77
+ receiveInt?: unknown;
78
+ sell?: unknown;
79
+ receive?: unknown;
80
+ orderId?: unknown;
81
+ slotId?: unknown;
82
+ chainOrderId?: unknown;
83
+ price?: unknown;
84
+ order?: JsonObj;
85
+ }
86
+ /** Normalized integer tuple used by pending-broadcast recovery. */
87
+ interface NormalizedChainOrder {
88
+ side: string;
89
+ assetA: string;
90
+ assetB: string;
91
+ sellInt: number;
92
+ receiveInt: number;
93
+ }
94
+ /** A COW operation context (create/update/cancel/rotation). */
95
+ export interface OpPhase extends JsonObj {
96
+ kind?: unknown;
97
+ id?: unknown;
98
+ order?: ManagedOrder;
99
+ finalInts?: FinalInts;
100
+ updateInfo?: JsonObj;
101
+ rotation?: JsonObj;
102
+ }
21
103
  /**
22
104
  * Group orders into outside-in pairs for atomic create execution.
23
105
  * @param {Array} orders
24
106
  * @returns {Array<Array>}
25
107
  */
26
- declare function buildOutsideInPairGroupsForOrders(orders: any): any;
108
+ declare function buildOutsideInPairGroupsForOrders(orders: ManagedOrder[]): unknown[][];
27
109
  /**
28
110
  * Build outside-in pair groups for create entry contexts.
29
111
  * @param {Array} createEntries
30
112
  * @returns {Array<Array>}
31
113
  */
32
- declare function buildOutsideInPairGroupsForCreateEntries(createEntries: any): any;
114
+ declare function buildOutsideInPairGroupsForCreateEntries(createEntries: PendingEntry[]): unknown[][];
33
115
  /**
34
116
  * Extract operation results from a batch transaction result.
35
117
  * @param {Object|Array|null} result
@@ -37,29 +119,32 @@ declare function buildOutsideInPairGroupsForCreateEntries(createEntries: any): a
37
119
  * @param {Function} [logFn] - Optional logger function, called with (msg, level) on unrecognized shape
38
120
  * @returns {Array}
39
121
  */
40
- declare function extractOperationResults(result: any, warnContext?: any, logFn?: Function | null): any[];
122
+ declare function extractOperationResults(result: unknown, warnContext?: string, logFn?: ((message: string, level?: string) => void) | null): unknown[];
41
123
  /**
42
124
  * Find CREATE operation contexts whose broadcast result did not include a chain order id.
43
125
  * @param {Array} operationResults
44
126
  * @param {Array} opContexts
45
127
  * @returns {Array<{index:number, ctx:Object}>}
46
128
  */
47
- declare function findMissingCreateResultContexts(operationResults: any, opContexts: any): {
129
+ declare function findMissingCreateResultContexts(operationResults: unknown, opContexts: unknown): {
48
130
  index: number;
49
- ctx: any;
131
+ ctx: OpPhase;
50
132
  }[];
51
133
  /**
52
134
  * Merge missing CREATE result contexts into manager._lastUnmatchedChainOrders.
53
135
  * @param {import('./dexbot_class.js').DEXBot} bot
54
136
  * @param {Array<{index:number, ctx:Object}>} missingCreateResults
55
137
  */
56
- declare function markMissingCreateResultsAsStructuralBlocker(bot: any, missingCreateResults: any): void;
138
+ declare function markMissingCreateResultsAsStructuralBlocker(bot: BotLike, missingCreateResults: {
139
+ index: number;
140
+ ctx: OpPhase;
141
+ }[]): void;
57
142
  /**
58
143
  * Format an unmatched chain order for COW logs.
59
144
  * @param {Object} order
60
145
  * @returns {string}
61
146
  */
62
- declare function formatUnmatchedChainOrderForLog(order: any): any;
147
+ declare function formatUnmatchedChainOrderForLog(order: JsonObj): string;
63
148
  /**
64
149
  * Record a pending CREATE broadcast on the manager.
65
150
  * @param {import('./dexbot_class.js').DEXBot} bot
@@ -71,12 +156,15 @@ declare function formatUnmatchedChainOrderForLog(order: any): any;
71
156
  * entry.batchId is unreliable because _currentBatchId is never populated
72
157
  * in production (always null), so batchId scoping cannot discriminate.
73
158
  */
74
- declare function recordPendingBroadcast(bot: any, entry: any): string | null;
159
+ declare function recordPendingBroadcast(bot: BotLike, entry: PendingEntry & {
160
+ opIndex?: unknown;
161
+ ctxIndex?: unknown;
162
+ }): string | null;
75
163
  /**
76
164
  * Clear the pending-broadcast cache.
77
165
  * @param {Map} pendingBroadcasts
78
166
  */
79
- declare function clearPendingBroadcasts(pendingBroadcasts: any): void;
167
+ declare function clearPendingBroadcasts(pendingBroadcasts: unknown): void;
80
168
  /**
81
169
  * Drop only the pending-broadcast entries for the given CREATE slots.
82
170
  *
@@ -91,7 +179,7 @@ declare function clearPendingBroadcasts(pendingBroadcasts: any): void;
91
179
  * @param {import('./dexbot_class.js').DEXBot} bot
92
180
  * @param {Array} actions - The abandoned batch's actions (COW_ACTIONS)
93
181
  */
94
- declare function clearPendingBroadcastsForSlots(bot: any, actions: any): void;
182
+ declare function clearPendingBroadcastsForSlots(bot: BotLike, actions: JsonObj[]): void;
95
183
  /**
96
184
  * Pop a pushed working-grid stack entry exactly once, guarded on the push
97
185
  * marker (manager-owned discipline — see OrderManager._pushWorkingGridRef /
@@ -102,7 +190,7 @@ declare function clearPendingBroadcastsForSlots(bot: any, actions: any): void;
102
190
  * @param {import('./dexbot_class.js').DEXBot} bot
103
191
  * @param {Object} cowResult - Rebalance/COW result carrying _workingGridPushed
104
192
  */
105
- declare function popPushedWorkingGrid(bot: any, cowResult: any): void;
193
+ declare function popPushedWorkingGrid(bot: BotLike, cowResult: JsonObj): void;
106
194
  /**
107
195
  * Build a fingerprint for an on-chain order so it can be matched against
108
196
  * the pending-broadcast cache.
@@ -111,7 +199,7 @@ declare function popPushedWorkingGrid(bot: any, cowResult: any): void;
111
199
  * @param {string} slotId
112
200
  * @returns {string|null}
113
201
  */
114
- declare function buildChainOrderFingerprint(bot: any, chainOrder: any, slotId: any): any;
202
+ declare function buildChainOrderFingerprint(bot: BotLike, chainOrder: ChainOrderLike, slotId: string): string | null;
115
203
  /**
116
204
  * Normalize raw BitShares limit_order_object data into the integer tuple
117
205
  * used by pending-broadcast recovery.
@@ -119,13 +207,7 @@ declare function buildChainOrderFingerprint(bot: any, chainOrder: any, slotId: a
119
207
  * @param {Object} chainOrder
120
208
  * @returns {{side: string, assetA: string, assetB: string, sellInt: number, receiveInt: number}|null}
121
209
  */
122
- declare function normalizeChainOrderForPendingMatch(bot: any, chainOrder: any): {
123
- side: any;
124
- assetA: any;
125
- assetB: any;
126
- sellInt: number;
127
- receiveInt: number;
128
- } | null;
210
+ declare function normalizeChainOrderForPendingMatch(bot: BotLike, chainOrder: ChainOrderLike): NormalizedChainOrder | null;
129
211
  /**
130
212
  * Find a chain order that matches a planned slot using price+size proximity.
131
213
  * @param {import('./dexbot_class.js').DEXBot} bot
@@ -134,7 +216,13 @@ declare function normalizeChainOrderForPendingMatch(bot: any, chainOrder: any):
134
216
  * @param {Object} planned - { sell, receive, orderType } integers from the planned op
135
217
  * @returns {Object|null} Matching chain order, or null
136
218
  */
137
- declare function findChainOrderForSlot(bot: any, chainOrders: any, slotId: any, planned: any): any;
219
+ declare function findChainOrderForSlot(bot: BotLike, chainOrders: ChainOrderLike[], slotId: string, planned: {
220
+ sell?: unknown;
221
+ receive?: unknown;
222
+ orderType?: unknown;
223
+ side?: unknown;
224
+ fingerprint?: unknown;
225
+ } | null | undefined): ChainOrderLike | null;
138
226
  /**
139
227
  * Reconcile a broadcast whose chain state is unknown.
140
228
  * Thin wrapper that optionally acquires _fillProcessingLock before delegating.
@@ -144,7 +232,12 @@ declare function findChainOrderForSlot(bot: any, chainOrders: any, slotId: any,
144
232
  * @param {Object} [options]
145
233
  * @returns {Promise<Object>}
146
234
  */
147
- declare function reconcileAfterUncertainBroadcast(bot: any, err: any, opContexts: any, options?: Record<string, any>): Promise<any>;
235
+ declare function reconcileAfterUncertainBroadcast(bot: BotLike, err: unknown, opContexts: OpPhase[], options?: JsonObj): Promise<UnknownRecord | {
236
+ executed: boolean;
237
+ hadRotation: boolean;
238
+ uncertain: boolean;
239
+ ambiguousRead: boolean;
240
+ }>;
148
241
  /**
149
242
  * Restore discarded CREATE slots to creation-uncertain state and clear
150
243
  * their pending entries; residual pending entries that survive the
@@ -154,7 +247,7 @@ declare function reconcileAfterUncertainBroadcast(bot: any, err: any, opContexts
154
247
  * @param {Array} opContexts
155
248
  * @returns {Promise<number>} discardedCount
156
249
  */
157
- declare function restoreDiscardedCreates(bot: any, discarded: any[], opContexts: any): Promise<number>;
250
+ declare function restoreDiscardedCreates(bot: BotLike, discarded: PendingEntry[], opContexts: OpPhase[]): Promise<number>;
158
251
  /**
159
252
  * Reconcile a broadcast whose chain state is unknown (implementation).
160
253
  * @param {import('./dexbot_class.js').DEXBot} bot
@@ -163,14 +256,19 @@ declare function restoreDiscardedCreates(bot: any, discarded: any[], opContexts:
163
256
  * @param {Object} options
164
257
  * @returns {Promise<Object>}
165
258
  */
166
- declare function reconcileAfterUncertainBroadcastImpl(bot: any, err: any, opContexts: any, _options: any): Promise<any>;
259
+ declare function reconcileAfterUncertainBroadcastImpl(bot: BotLike, err: unknown, opContexts: OpPhase[], _options: JsonObj): Promise<UnknownRecord | {
260
+ executed: boolean;
261
+ hadRotation: boolean;
262
+ uncertain: boolean;
263
+ ambiguousRead: boolean;
264
+ }>;
167
265
  /**
168
266
  * Check whether to execute creates in outside-in pair mode.
169
267
  * @param {import('./dexbot_class.js').DEXBot} bot
170
268
  * @param {Array} opContexts
171
269
  * @returns {boolean}
172
270
  */
173
- declare function shouldExecuteCreatePairMode(_bot: any, opContexts: any): boolean;
271
+ declare function shouldExecuteCreatePairMode(_bot: unknown, opContexts: OpPhase[]): boolean;
174
272
  /**
175
273
  * Execute operations with retry on BroadcastUncertainError.
176
274
  *
@@ -189,9 +287,9 @@ declare function shouldExecuteCreatePairMode(_bot: any, opContexts: any): boolea
189
287
  * @param {Array} opContexts
190
288
  * @returns {Promise<{result: Object, opContexts: Array}>}
191
289
  */
192
- declare function executeWithRetryOnUncertain(bot: any, operations: any, opContexts: any): Promise<{
193
- result: any;
194
- opContexts: any;
290
+ declare function executeWithRetryOnUncertain(bot: BotLike, operations: unknown[], opContexts: OpPhase[]): Promise<{
291
+ result: unknown;
292
+ opContexts: OpPhase[];
195
293
  }>;
196
294
  /**
197
295
  * Summarize a partial (non-atomic) broadcast for the batch-failure catch log.
@@ -203,7 +301,7 @@ declare function executeWithRetryOnUncertain(bot: any, operations: any, opContex
203
301
  * @param {Error} err - The partial-state error thrown by the execution path
204
302
  * @returns {string} e.g. "1/3 chunks broadcast" or "1/2 groups broadcast"
205
303
  */
206
- declare function formatPartialBroadcastSummary(err: any): string;
304
+ declare function formatPartialBroadcastSummary(err: unknown): string;
207
305
  /**
208
306
  * Execute a batch with retry-on-uncertain semantics, enforcing a gap-slot
209
307
  * per-broadcast operation cap (_getGapSlotBatchSize = gapSlots + 1). When the
@@ -235,20 +333,9 @@ declare function formatPartialBroadcastSummary(err: any): string;
235
333
  * @param {Array} opContexts
236
334
  * @returns {Promise<{result: Object, opContexts: Array}>}
237
335
  */
238
- declare function executeChunkedWithRetryOnUncertain(bot: any, operations: any, opContexts: any): Promise<{
239
- result: any;
240
- opContexts: any;
241
- }>;
242
- /**
243
- * Execute blockchain operations with appropriate strategy (single batch or pair mode).
244
- * @param {import('./dexbot_class.js').DEXBot} bot
245
- * @param {Array} operations
246
- * @param {Array} opContexts
247
- * @returns {Promise<{result: Object, opContexts: Array}>}
248
- */
249
- declare function executeOperationsWithStrategy(bot: any, operations: any, opContexts: any): Promise<{
250
- result: any;
251
- opContexts: any;
336
+ declare function executeChunkedWithRetryOnUncertain(bot: BotLike, operations: unknown[], opContexts: OpPhase[]): Promise<{
337
+ result: unknown;
338
+ opContexts: OpPhase[];
252
339
  }>;
253
340
  /**
254
341
  * Validate that operations can be executed with available funds before broadcasting.
@@ -258,14 +345,10 @@ declare function executeOperationsWithStrategy(bot: any, operations: any, opCont
258
345
  * @param {Object} assetB
259
346
  * @returns {Object} { isValid: boolean, summary: string }
260
347
  */
261
- declare function validateOperationFunds(bot: any, operations: any, assetA: any, assetB: any): {
262
- isValid: boolean;
263
- summary: string;
264
- violations?: undefined;
265
- } | {
348
+ declare function validateOperationFunds(bot: BotLike, operations: JsonObj[], assetA: AssetInfo, assetB: AssetInfo): {
266
349
  isValid: boolean;
267
350
  summary: string;
268
- violations: any[];
351
+ violations?: JsonObj[];
269
352
  };
270
353
  /**
271
354
  * Resolve the ideal size from an order-like object with fallback.
@@ -274,7 +357,7 @@ declare function validateOperationFunds(bot: any, operations: any, assetA: any,
274
357
  * @param {number|null} [fallbackSize=null]
275
358
  * @returns {number|null}
276
359
  */
277
- declare function resolveIdealSizeForValidation(_bot: any, orderLike: any, fallbackSize?: any): number | null;
360
+ declare function resolveIdealSizeForValidation(_bot: unknown, orderLike: JsonObj | null | undefined, fallbackSize?: number | null): number | null;
278
361
  /**
279
362
  * Validate that an order size is safe to execute.
280
363
  * @param {import('./dexbot_class.js').DEXBot} bot
@@ -282,10 +365,15 @@ declare function resolveIdealSizeForValidation(_bot: any, orderLike: any, fallba
282
365
  * @param {string} type
283
366
  * @param {Object|null} [orderLike=null]
284
367
  * @param {number|null} [fallbackSize=null]
285
- * @returns {any}
368
+ * @returns {unknown}
286
369
  */
287
- declare function validateOrderSizeForExecution(bot: any, size: any, type: any, orderLike?: any, fallbackSize?: any): any;
288
- declare function checkGridPriceInvariant(slotId: any, price: any, genesis: any): {
370
+ declare function validateOrderSizeForExecution(bot: BotLike, size: number, type: string, orderLike?: JsonObj | null, fallbackSize?: number | null): {
371
+ isValid: boolean;
372
+ reason: string | null;
373
+ minAbsoluteSize: number;
374
+ minDustSize: number | null;
375
+ };
376
+ declare function checkGridPriceInvariant(slotId: unknown, price: unknown, genesis: unknown): {
289
377
  ok: boolean;
290
378
  reason: string;
291
379
  expected: number | null;
@@ -306,7 +394,7 @@ declare function checkGridPriceInvariant(slotId: any, price: any, genesis: any):
306
394
  * genesis ladder / no parseable destination index (caller falls back to the
307
395
  * planned price — an undefined grid, which the load and sync gates refuse).
308
396
  */
309
- declare function deriveRotationPrice(bot: any, newGridId: any): number;
397
+ declare function deriveRotationPrice(bot: BotLike, newGridId: unknown): number;
310
398
  /**
311
399
  * LAST-FILL-GUARD helper — pivot ± halfIncrement (replaces price-tolerance).
312
400
  * last fill @x with increment i: BUY < x*(1 - i/2/100), SELL > x*(1 + i/2/100)
@@ -327,7 +415,7 @@ declare function deriveRotationPrice(bot: any, newGridId: any): number;
327
415
  * @param {number|any} incrementPercent - Grid increment percent (e.g. 0.5). If assets object passed, falls back to default.
328
416
  * @returns {{blocked: boolean, pivot: number|null, halfInc: number, threshold: number|null}}
329
417
  */
330
- declare function isLastFillGuardBlocked(price: any, _size: any, type: any, lastPrice: any, lastType: any, incrementPercent: any): {
418
+ declare function isLastFillGuardBlocked(price: number, _size: number, type: unknown, lastPrice: number | null, lastType: string | null, incrementPercent: number): {
331
419
  blocked: boolean;
332
420
  pivot: number | null;
333
421
  halfInc?: number;
@@ -348,28 +436,21 @@ declare function isLastFillGuardBlocked(price: any, _size: any, type: any, lastP
348
436
  * @param {import('./dexbot_class.js').DEXBot} bot
349
437
  * @returns {boolean} True when the pivot was refreshed from queued fills
350
438
  */
351
- declare function refreshLastFillPivotFromQueue(bot: any): boolean;
439
+ declare function refreshLastFillPivotFromQueue(bot: BotLike): boolean;
352
440
  /**
353
441
  * Build COW actions array from a simple plan object.
354
442
  * @param {import('./dexbot_class.js').DEXBot} bot
355
443
  * @param {Object|Array} plan
356
444
  * @returns {Array}
357
445
  */
358
- declare function buildActionsFromPlan(_bot: any, plan: any): any[];
446
+ declare function buildActionsFromPlan(_bot: BotLike, plan: JsonObj | JsonObj[]): CowAction[];
359
447
  /**
360
448
  * Build a COW result object (workingGrid + actions) from a simple plan.
361
449
  * @param {import('./dexbot_class.js').DEXBot} bot
362
450
  * @param {Object|Array} plan
363
451
  * @returns {{workingGrid: any, workingIndexes: Object, workingBoundary: number, actions: Array}}
364
452
  */
365
- declare function buildCowResultFromPlan(bot: any, plan: any): {
366
- refillSlotIds?: any;
367
- workingGrid: any;
368
- workingIndexes: any;
369
- workingBoundary: any;
370
- actions: any[];
371
- origin: any;
372
- };
453
+ declare function buildCowResultFromPlan(bot: BotLike, plan: JsonObj): CowResult;
373
454
  /**
374
455
  * Pre-apply rotation state transitions to the working grid before commit.
375
456
  * This makes the COW commit truly atomic for structural changes — source slots
@@ -380,7 +461,7 @@ declare function buildCowResultFromPlan(bot: any, plan: any): {
380
461
  * Only slot-to-slot rotations (newGridId exists) need pre-application;
381
462
  * in-place rotations already have their size/price changes in the working grid.
382
463
  */
383
- declare function applyRotationTransitionsToWorkingGrid(bot: any, workingGrid: any, executedContexts: any): void;
464
+ declare function applyRotationTransitionsToWorkingGrid(bot: BotLike, workingGrid: InstanceType<typeof WorkingGrid>, executedContexts: OpPhase[]): void;
384
465
  /**
385
466
  * Poll the chain after an uncertain broadcast to check if CREATE operations
386
467
  * were actually accepted. Uses fingerprint matching against readOpenOrders.
@@ -397,17 +478,17 @@ declare function applyRotationTransitionsToWorkingGrid(bot: any, workingGrid: an
397
478
  * to skip the production 1.5s pacing without changing the poll semantics
398
479
  * @returns {{ allConfirmed: boolean, confirmed: Array, unconfirmed: Array }}
399
480
  */
400
- declare function pollChainForConfirmation(bot: any, opContexts: any, options?: any): Promise<{
481
+ declare function pollChainForConfirmation(bot: BotLike, opContexts: OpPhase[], options?: JsonObj): Promise<{
401
482
  allConfirmed: boolean;
402
- confirmed: any[];
403
- unconfirmed: any[];
483
+ confirmed: CreateContext[];
484
+ unconfirmed: OpPhase[];
404
485
  confirmedChainIds: string[];
405
486
  }>;
406
487
  /**
407
488
  * Normalize a producer-supplied refillSlotIds wire into a Set.
408
489
  * Absent/empty/non-array => empty (guarded default, never fail-open).
409
490
  */
410
- declare function toRefillSlotIdSet(refillSlotIds: any): Set<string>;
491
+ declare function toRefillSlotIdSet(refillSlotIds: unknown): Set<string>;
411
492
  /**
412
493
  * Boundary-hold decision for guard-skipped refills.
413
494
  * When a skipped slot is one of the plan's refill slots — a hole-CREATE that
@@ -419,8 +500,8 @@ declare function toRefillSlotIdSet(refillSlotIds: any): Set<string>;
419
500
  * The grid still commits; only the boundary value is held (same discipline
420
501
  * as the overrun-hold in validateBoundaryCommit).
421
502
  */
422
- declare function resolveRefillBoundaryHold(workingBoundary: any, committedBoundary: any, skippedUpdateSlotIds: any, clampedUpdateSlotIds: any, refillSlotIds: any, skippedCreateSlotIds?: any): {
423
- effectiveBoundary: any;
503
+ declare function resolveRefillBoundaryHold(workingBoundary: unknown, committedBoundary: unknown, skippedUpdateSlotIds: Iterable<string> | null | undefined, clampedUpdateSlotIds: Iterable<string> | null | undefined, refillSlotIds: unknown, skippedCreateSlotIds?: Iterable<string> | null | undefined): {
504
+ effectiveBoundary: unknown;
424
505
  heldRefillSlotIds: string[];
425
506
  };
426
507
  /**
@@ -439,24 +520,24 @@ declare function resolveRefillBoundaryHold(workingBoundary: any, committedBounda
439
520
  * re-plan from unchanged master re-derives the identical plan and re-hits
440
521
  * the identical guard blocks, so it is suppressed rather than re-broadcast;
441
522
  * the heal path is a fresh fill-driven plan or the re-center.
442
- * @param {any} manager - Order manager (mutable tracking fields)
523
+ * @param {unknown} manager - Order manager (mutable tracking fields)
443
524
  * @param {boolean} held - Whether this batch held the boundary
444
- * @param {any} keptBoundary - Committed boundary that was kept
445
- * @param {any} plannedBoundary - Boundary the plan wanted
525
+ * @param {unknown} keptBoundary - Committed boundary that was kept
526
+ * @param {unknown} plannedBoundary - Boundary the plan wanted
446
527
  * @param {string[]} heldSlotIds - Refill slots skipped this batch
447
528
  * @returns {number} Consecutive-hold count after this batch (0 when clear)
448
529
  */
449
- declare function trackBoundaryHold(manager: any, held: boolean, keptBoundary: any, plannedBoundary: any, heldSlotIds: any): number;
530
+ declare function trackBoundaryHold(manager: OrderManagerLike, held: boolean, keptBoundary: unknown, plannedBoundary: unknown, heldSlotIds: string[]): number;
450
531
  /**
451
532
  * Restore skipped update slots in the working grid to master state.
452
533
  * @param {import('./dexbot_class.js').DEXBot} bot
453
- * @param {any} workingGrid
534
+ * @param {unknown} workingGrid
454
535
  * @param {Set<string>} skippedSlotIds
455
536
  * @param {number} [skippedCount=0]
456
537
  */
457
- declare function restoreSkippedUpdateSlotsInWorkingGrid(bot: any, workingGrid: any, skippedSlotIds: any, skippedCount?: any): void;
458
- declare function updateOrdersOnChainBatchCOW(bot: any, cowResult: any, options?: any): Promise<any>;
459
- declare function adoptPlacedBatchFromChain(bot: any, chainOrders: any, logPrefix: string, opts?: any): Promise<boolean>;
538
+ declare function restoreSkippedUpdateSlotsInWorkingGrid(bot: BotLike, workingGrid: InstanceType<typeof WorkingGrid>, skippedSlotIds: Set<string> | null | undefined, skippedCount?: number): void;
539
+ declare function updateOrdersOnChainBatchCOW(bot: BotLike, cowResult: CowResult, options?: JsonObj): Promise<JsonObj>;
540
+ declare function adoptPlacedBatchFromChain(bot: BotLike, chainOrders: typeof chainOrdersModule, logPrefix: string, opts?: JsonObj): Promise<boolean>;
460
541
  /**
461
542
  * Resolve the LAST-FILL guard pivot to an ON-GRID price.
462
543
  *
@@ -472,11 +553,11 @@ declare function adoptPlacedBatchFromChain(bot: any, chainOrders: any, logPrefix
472
553
  * startup), so the guard degrades to its previous behaviour rather than
473
554
  * silently disabling. Never throws.
474
555
  *
475
- * @param {any} manager
556
+ * @param {unknown} manager
476
557
  * @param {number|null|undefined} rawPrice
477
558
  * @returns {{price: number|null, snapped: boolean, idx: number|null, nearestDrift: number|null}}
478
559
  */
479
- declare function resolveOnGridPivot(manager: any, rawPrice: any): {
560
+ declare function resolveOnGridPivot(manager: OrderManagerLike, rawPrice: unknown): {
480
561
  price: number | null;
481
562
  snapped: boolean;
482
563
  idx: number | null;
@@ -549,8 +630,8 @@ declare function resolveOnGridPivot(manager: any, rawPrice: any): {
549
630
  * skippedUpdateCountRef: { count }, freezeQueueDepth, batchPendingFps }
550
631
  * @returns {{ dropped: Array, pivotChanged: boolean, refreshed: boolean }}
551
632
  */
552
- declare function runFinalPivotGate(bot: any, operations: any[], opContexts: any[], opts?: any): {
553
- dropped: Array<any>;
633
+ declare function runFinalPivotGate(bot: BotLike, operations: unknown[], opContexts: OpPhase[], opts?: JsonObj): {
634
+ dropped: JsonObj[];
554
635
  pivotChanged: boolean;
555
636
  refreshed: boolean;
556
637
  };
@@ -562,12 +643,12 @@ declare function runFinalPivotGate(bot: any, operations: any[], opContexts: any[
562
643
  * @param {Array} opContexts
563
644
  * @returns {Object} Result with { executed: boolean, hadRotation: boolean }
564
645
  */
565
- declare function processBatchResults(bot: any, result: any, opContexts: any): Promise<{
646
+ declare function processBatchResults(bot: BotLike, result: JsonObj, opContexts: OpPhase[]): Promise<{
566
647
  executed: boolean;
567
648
  hadRotation: boolean;
568
649
  updateOperationCount: number;
569
650
  }>;
570
- export { isLastFillGuardBlocked, resolveOnGridPivot, checkGridPriceInvariant, deriveRotationPrice, refreshLastFillPivotFromQueue, runFinalPivotGate, buildOutsideInPairGroupsForOrders, buildOutsideInPairGroupsForCreateEntries, markMissingCreateResultsAsStructuralBlocker, formatUnmatchedChainOrderForLog, recordPendingBroadcast, clearPendingBroadcasts, popPushedWorkingGrid, findChainOrderForSlot, reconcileAfterUncertainBroadcast, reconcileAfterUncertainBroadcastImpl, executeWithRetryOnUncertain, executeChunkedWithRetryOnUncertain, formatPartialBroadcastSummary, executeOperationsWithStrategy, buildActionsFromPlan, buildCowResultFromPlan, applyRotationTransitionsToWorkingGrid, pollChainForConfirmation, updateOrdersOnChainBatchCOW, processBatchResults, adoptPlacedBatchFromChain, resolveRefillBoundaryHold, toRefillSlotIdSet, trackBoundaryHold };
651
+ export { isLastFillGuardBlocked, resolveOnGridPivot, checkGridPriceInvariant, deriveRotationPrice, refreshLastFillPivotFromQueue, runFinalPivotGate, buildOutsideInPairGroupsForOrders, buildOutsideInPairGroupsForCreateEntries, markMissingCreateResultsAsStructuralBlocker, formatUnmatchedChainOrderForLog, recordPendingBroadcast, clearPendingBroadcasts, popPushedWorkingGrid, findChainOrderForSlot, reconcileAfterUncertainBroadcast, reconcileAfterUncertainBroadcastImpl, executeWithRetryOnUncertain, executeChunkedWithRetryOnUncertain, formatPartialBroadcastSummary, buildActionsFromPlan, buildCowResultFromPlan, applyRotationTransitionsToWorkingGrid, pollChainForConfirmation, updateOrdersOnChainBatchCOW, processBatchResults, adoptPlacedBatchFromChain, resolveRefillBoundaryHold, toRefillSlotIdSet, trackBoundaryHold };
571
652
  export { restoreDiscardedCreates };
572
653
  declare const _default: {
573
654
  buildOutsideInPairGroupsForOrders: typeof buildOutsideInPairGroupsForOrders;
@@ -589,7 +670,6 @@ declare const _default: {
589
670
  executeWithRetryOnUncertain: typeof executeWithRetryOnUncertain;
590
671
  executeChunkedWithRetryOnUncertain: typeof executeChunkedWithRetryOnUncertain;
591
672
  formatPartialBroadcastSummary: typeof formatPartialBroadcastSummary;
592
- executeOperationsWithStrategy: typeof executeOperationsWithStrategy;
593
673
  validateOperationFunds: typeof validateOperationFunds;
594
674
  resolveIdealSizeForValidation: typeof resolveIdealSizeForValidation;
595
675
  validateOrderSizeForExecution: typeof validateOrderSizeForExecution;