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
@@ -128,7 +128,7 @@ export const lookupAsset = async (BitShares, s) => {
128
128
  let cached = null;
129
129
  if (BitShares?.assets) {
130
130
  try {
131
- cached = await BitShares.assets[s];
131
+ cached = (await BitShares.assets[s]);
132
132
  }
133
133
  catch (_) {
134
134
  systemLogger.debug(`lookupAsset: cache access failed for ${s}`);
@@ -138,16 +138,17 @@ export const lookupAsset = async (BitShares, s) => {
138
138
  return cached;
139
139
  }
140
140
  const methods = [
141
- () => BitShares.db.lookup_asset_symbols([s]),
142
- () => BitShares.db.get_assets([s])
141
+ () => BitShares.db?.lookup_asset_symbols?.([s]),
142
+ () => BitShares.db?.get_assets?.([s])
143
143
  ];
144
144
  for (const method of methods) {
145
145
  try {
146
146
  if (typeof method !== 'function')
147
147
  continue;
148
148
  const r = await method();
149
- if (r?.[0]?.id && typeof r[0].precision === 'number') {
150
- return { ...(cached || {}), ...r[0] };
149
+ const first = r?.[0];
150
+ if (first?.id && typeof first.precision === 'number') {
151
+ return { ...(cached || {}), ...first };
151
152
  }
152
153
  }
153
154
  catch (e) {
@@ -175,17 +176,20 @@ export const resolveAssetByRef = async (BitShares, ref) => {
175
176
  const method = /^1\.3\.\d+$/.test(cacheKey) ? 'get_assets' : 'lookup_asset_symbols';
176
177
  const camelMethod = method.replace(/_([a-z])/g, (_, c) => c.toUpperCase());
177
178
  try {
178
- if (typeof BitShares.db[camelMethod] === 'function') {
179
- const result = await BitShares.db[camelMethod]([cacheKey]);
180
- return Array.isArray(result) ? result[0] || null : null;
179
+ const camelFn = BitShares.db[camelMethod];
180
+ if (typeof camelFn === 'function') {
181
+ const result = await camelFn([cacheKey]);
182
+ return (Array.isArray(result) ? result[0] : null) || null;
181
183
  }
182
- if (typeof BitShares.db[method] === 'function') {
183
- const result = await BitShares.db[method]([cacheKey]);
184
- return Array.isArray(result) ? result[0] || null : null;
184
+ const snakeFn = BitShares.db[method];
185
+ if (typeof snakeFn === 'function') {
186
+ const result = await snakeFn([cacheKey]);
187
+ return (Array.isArray(result) ? result[0] : null) || null;
185
188
  }
186
- if (typeof BitShares.db.call === 'function') {
187
- const result = await BitShares.db.call(method, [[cacheKey]]);
188
- return Array.isArray(result) ? result[0] || null : null;
189
+ const callFn = BitShares.db.call;
190
+ if (typeof callFn === 'function') {
191
+ const result = await callFn(method, [[cacheKey]]);
192
+ return (Array.isArray(result) ? result[0] : null) || null;
189
193
  }
190
194
  }
191
195
  catch (e) {
@@ -217,8 +221,8 @@ export const deriveMarketPrice = async (BitShares, symA, symB) => {
217
221
  if (typeof BitShares.db?.get_order_book === 'function') {
218
222
  try {
219
223
  const ob = await BitShares.db.get_order_book(baseId, quoteId, API_LIMITS.ORDERBOOK_DEPTH);
220
- const bestBid = isValidNumber(ob.bids?.[0]?.price) ? toFiniteNumber(ob.bids[0].price) : null;
221
- const bestAsk = isValidNumber(ob.asks?.[0]?.price) ? toFiniteNumber(ob.asks[0].price) : null;
224
+ const bestBid = isValidNumber(ob.bids?.[0]?.price) ? toFiniteNumber(ob.bids?.[0]?.price) : null;
225
+ const bestAsk = isValidNumber(ob.asks?.[0]?.price) ? toFiniteNumber(ob.asks?.[0]?.price) : null;
222
226
  if (bestBid !== null && bestAsk !== null)
223
227
  mid = (bestBid + bestAsk) / 2;
224
228
  }
@@ -327,7 +331,7 @@ export const derivePoolPrice = async (BitShares, symA, symB) => {
327
331
  break;
328
332
  }
329
333
  else {
330
- startId = pools[pools.length - 1].id;
334
+ startId = String(pools[pools.length - 1].id);
331
335
  }
332
336
  }
333
337
  if (allMatches.length) {
@@ -336,7 +340,8 @@ export const derivePoolPrice = async (BitShares, symA, symB) => {
336
340
  const getBal = (p) => toFiniteNumber(String(p.asset_a) === String(aMeta.id) ? p.balance_a : p.balance_b);
337
341
  return getBal(b) - getBal(a);
338
342
  })[0];
339
- poolIdCache.set(cacheKey, chosen.id);
343
+ if (chosen)
344
+ poolIdCache.set(cacheKey, chosen.id);
340
345
  }
341
346
  }
342
347
  catch (e) {
@@ -377,8 +382,8 @@ export const derivePoolPrice = async (BitShares, symA, symB) => {
377
382
  const resA = chosen.reserves.find((r) => String(r.asset_id) === String(aMeta.id));
378
383
  const resB = chosen.reserves.find((r) => String(r.asset_id) === String(bMeta.id));
379
384
  if (resA && resB) {
380
- amtA = resA.amount;
381
- amtB = resB.amount;
385
+ amtA = Number(resA.amount);
386
+ amtB = Number(resB.amount);
382
387
  }
383
388
  }
384
389
  if (!isValidNumber(amtA) || !isValidNumber(amtB) || toFiniteNumber(amtB) === 0)
@@ -559,7 +564,7 @@ async function getAssetCurrentSupply(BitShares, assetRef) {
559
564
  }
560
565
  const hasDirectSupply = asset.current_supply != null;
561
566
  const directSupply = hasDirectSupply
562
- ? toFiniteNumber(asset.current_supply?.amount ?? asset.current_supply, -1)
567
+ ? toFiniteNumber(typeof asset.current_supply === 'object' ? asset.current_supply?.amount : asset.current_supply, -1)
563
568
  : -1;
564
569
  if (hasDirectSupply && Number.isFinite(directSupply) && directSupply >= 0) {
565
570
  return directSupply;
@@ -572,10 +577,10 @@ async function getAssetCurrentSupply(BitShares, assetRef) {
572
577
  systemLogger.debug(`getAssetCurrentSupply: get_objects failed for ${dynamicId}: ${getErrorMessage(e)}`);
573
578
  return null;
574
579
  });
575
- const dynamicData = Array.isArray(objects) ? objects[0] : null;
576
- const supply = toFiniteNumber(dynamicData?.current_supply?.amount
577
- ?? dynamicData?.current_supply?.value
578
- ?? dynamicData?.current_supply, undefined);
580
+ const dynamicData = (Array.isArray(objects) ? objects[0] : null);
581
+ const supply = toFiniteNumber(typeof dynamicData?.current_supply === 'object'
582
+ ? (dynamicData.current_supply?.amount ?? dynamicData.current_supply?.value)
583
+ : dynamicData?.current_supply, undefined);
579
584
  return Number.isFinite(supply) && supply >= 0 ? supply : null;
580
585
  }
581
586
  /**
@@ -607,11 +612,11 @@ export async function deriveLiquidityPoolTokenValue(BitShares, shareAssetRef, de
607
612
  return null;
608
613
  }
609
614
  const [assetA, assetB, supply] = await Promise.all([
610
- lookupAsset(BitShares, poolInfo.pool.asset_a),
611
- lookupAsset(BitShares, poolInfo.pool.asset_b),
615
+ lookupAsset(BitShares, poolInfo.pool.asset_a ?? ''),
616
+ lookupAsset(BitShares, poolInfo.pool.asset_b ?? ''),
612
617
  getAssetCurrentSupply(BitShares, shareAsset),
613
618
  ]);
614
- if (!assetA?.id || !assetB?.id || !Number.isFinite(supply) || supply <= 0) {
619
+ if (!assetA?.id || !assetB?.id || supply == null || !Number.isFinite(supply) || supply <= 0) {
615
620
  return null;
616
621
  }
617
622
  const reserveA = MathUtils.blockchainToFloat(poolInfo.pool.balance_a, assetA.precision);
@@ -660,21 +665,6 @@ export async function deriveLiquidityPoolTokenValue(BitShares, shareAssetRef, de
660
665
  return null;
661
666
  }
662
667
  }
663
- /**
664
- * Load the full dynamic grid snapshot written by market_adapter for a bot.
665
- * The snapshot is stored atomically at profiles/orders/<botKey>.dynamicgrid.json
666
- * and is updated every market adapter cycle. It contains the persisted grid
667
- * center and, for dynamic-weight-whitelisted bots, any computed effective weight offsets.
668
- * On full grid resets the bot may rewrite gridCenterPrice to the latest AMA baseline, but
669
- * amaCenterPrice remains the raw AMA output for diagnostics and comparison.
670
- * The snapshot may also expose AMA slope diagnostics and a gridPriceOffsetPct
671
- * that downstream grid initialization can apply to the raw center price.
672
- * Called by initializeGrid() when manager.config.gridPrice uses an AMA keyword,
673
- * by performGridResync(), and by refreshDynamicWeightDistribution() before every
674
- * rebalance so new orders use live weights — not only on grid reset.
675
- * @param {string} botKey - Bot key (e.g. "iob-aaa-bbb-0")
676
- * @returns {Object|null} Snapshot with center and optional dynamicWeights fields, or null if invalid
677
- */
678
668
  export function loadAmaCenterSnapshot(botKey) {
679
669
  try {
680
670
  const gridPriceFile = path.join(PATHS.ORDERS_DIR, `${botKey}.dynamicgrid.json`);
@@ -784,10 +774,12 @@ export async function initializeFeeCache(botsConfig, BitShares) {
784
774
  for (let attempt = 1; attempt <= maxAttempts; attempt++) {
785
775
  try {
786
776
  if (assetSymbol === 'BTS') {
777
+ if (typeof BitShares.db?.getGlobalProperties !== 'function')
778
+ throw new Error('getGlobalProperties unavailable');
787
779
  const globalProps = await BitShares.db.getGlobalProperties();
788
- const currentFees = globalProps.parameters.current_fees.parameters;
780
+ const currentFees = globalProps.parameters?.current_fees?.parameters;
789
781
  const findFee = (opCode) => {
790
- const param = currentFees.find((p) => p[0] === opCode);
782
+ const param = currentFees?.find((p) => p[0] === opCode);
791
783
  const fee = param?.[1]?.fee;
792
784
  const feeNum = toFiniteNumber(fee);
793
785
  return {
@@ -806,7 +798,9 @@ export async function initializeFeeCache(botsConfig, BitShares) {
806
798
  }
807
799
  else {
808
800
  const fullAsset = await lookupAsset(BitShares, assetSymbol);
809
- const options = fullAsset.options || {};
801
+ if (!fullAsset)
802
+ throw new Error(`asset ${assetSymbol} not found`);
803
+ const options = (fullAsset.options ?? {});
810
804
  cache[assetSymbol] = {
811
805
  assetId: fullAsset.id,
812
806
  symbol: assetSymbol,
@@ -968,7 +962,7 @@ export function restoreGapEvacStreaks(manager, persisted) {
968
962
  function buildLastFillPivotPayload(manager) {
969
963
  const price = Number(manager?._lastFilledPrice);
970
964
  const type = manager?._lastFilledType;
971
- if (manager?.lastFillPivotSource !== 'fill')
965
+ if (manager.lastFillPivotSource !== 'fill')
972
966
  return null;
973
967
  if (!Number.isFinite(price) || price <= 0)
974
968
  return null;
@@ -993,16 +987,17 @@ function buildLastFillPivotPayload(manager) {
993
987
  * - finite fillsAt > 0
994
988
  * - non-empty string genesisHash
995
989
  *
996
- * @param {any} row - Raw candidate row
990
+ * @param {unknown} row - Raw candidate row
997
991
  * @returns {Object|null} Normalized row or null
998
992
  */
999
993
  export function normalizeLastFillPivot(row) {
1000
994
  if (!row || typeof row !== 'object')
1001
995
  return null;
1002
- const price = Number(row.price);
1003
- const type = row.type;
1004
- const fillsAt = Number(row.fillsAt);
1005
- const genesisHash = row.genesisHash;
996
+ const r = row;
997
+ const price = Number(r.price);
998
+ const type = r.type;
999
+ const fillsAt = Number(r.fillsAt);
1000
+ const genesisHash = r.genesisHash;
1006
1001
  if (!Number.isFinite(price) || price <= 0)
1007
1002
  return null;
1008
1003
  if (type !== ORDER_TYPES.BUY && type !== ORDER_TYPES.SELL)
@@ -1308,8 +1303,9 @@ export async function applyGridDivergenceCorrections(manager, accountOrders, _bo
1308
1303
  .filter(inRailByType(orderType))
1309
1304
  .sort((a, b) => sideName === 'buy' ? b.price - a.price : a.price - b.price);
1310
1305
  // Calculate target count
1311
- const baseTargetCount = (manager.config.activeOrders && Number.isFinite(manager.config.activeOrders[sideName]))
1312
- ? Math.max(1, manager.config.activeOrders[sideName])
1306
+ const activeOrdersCfg = manager.config.activeOrders;
1307
+ const baseTargetCount = (activeOrdersCfg && typeof activeOrdersCfg === 'object' && Number.isFinite(Number(activeOrdersCfg[sideName])))
1308
+ ? Math.max(1, Number(activeOrdersCfg[sideName]))
1313
1309
  : currentOnChainOrders.length;
1314
1310
  const targetCount = baseTargetCount;
1315
1311
  // Determine desired slots (closest to market) + edge-pinned reserves.
@@ -1337,7 +1333,24 @@ export async function applyGridDivergenceCorrections(manager, accountOrders, _bo
1337
1333
  const slot = workingGrid.get(onChainOrder.id);
1338
1334
  const isDesired = desiredSlotIds.has(onChainOrder.id);
1339
1335
  if (!isDesired || !slot || !(toFiniteNumber(slot.size) > 0)) {
1336
+ // Update removal is intentional, before the fresh check:
1337
+ // the slot reached this branch because it is not desired /
1338
+ // size 0, so a surviving Phase-1 committed-size UPDATE
1339
+ // could emit a stale target or a size-to-zero op on a live
1340
+ // fresh order ("surplus is never updated to size 0"
1341
+ // invariant). Dropping it with the deferred cancel keeps
1342
+ // the slot exactly as master holds it for the cycle; the
1343
+ // resize is re-derived next tick.
1340
1344
  removeActionsForOrder(actions, COW_ACTIONS.UPDATE, onChainOrder);
1345
+ // Fresh-placement grace: a surplus placed seconds ago must
1346
+ // not be cancelled here (fee bleed, empty level, no net
1347
+ // change). Leave it active in the working grid; the
1348
+ // surplus is re-derived next cycle once the order has had
1349
+ // time to prove itself.
1350
+ if (onChainOrder.orderId && OrderUtils.isFreshlyPlacedOrder(manager, onChainOrder.orderId)) {
1351
+ manager.logger.log(`[DIVERGENCE-COW] Deferring cancel of freshly placed ${onChainOrder.orderId} (${onChainOrder.id}) — inside grace window`, 'info');
1352
+ continue;
1353
+ }
1341
1354
  const hasQueuedCancel = hasActionForOrder(actions, COW_ACTIONS.CANCEL, onChainOrder);
1342
1355
  if (!hasQueuedCancel) {
1343
1356
  manager.logger.log(`[DIVERGENCE-COW] Queueing cancel for surplus ${onChainOrder.id} (chain id ${onChainOrder.orderId})`, 'info');
@@ -1461,11 +1474,12 @@ export async function applyGridDivergenceCorrections(manager, accountOrders, _bo
1461
1474
  }
1462
1475
  });
1463
1476
  // Phase 3: Execute corrections via COW batch
1464
- if (cowResult && !cowResult.aborted) {
1477
+ const committedCow = cowResult;
1478
+ if (committedCow && !committedCow.aborted) {
1465
1479
  try {
1466
1480
  let result = null;
1467
- if (cowResult.localOnly) {
1468
- const committed = await manager._commitWorkingGrid(cowResult.workingGrid, cowResult.workingIndexes, cowResult.workingBoundary);
1481
+ if (committedCow.localOnly) {
1482
+ const committed = await manager._commitWorkingGrid(committedCow.workingGrid, committedCow.workingIndexes, committedCow.workingBoundary);
1469
1483
  if (committed) {
1470
1484
  if (typeof manager.persistGrid === 'function') {
1471
1485
  await manager.persistGrid();
@@ -1482,7 +1496,7 @@ export async function applyGridDivergenceCorrections(manager, accountOrders, _bo
1482
1496
  }
1483
1497
  }
1484
1498
  else {
1485
- result = await updateOrdersOnChainBatchFn(cowResult);
1499
+ result = await updateOrdersOnChainBatchFn(committedCow);
1486
1500
  }
1487
1501
  if (result && result.executed) {
1488
1502
  manager.logger.log(`[DIVERGENCE-COW] Successfully applied divergence corrections`, 'info');
@@ -1571,11 +1585,11 @@ export function readInput(prompt, options = {}) {
1571
1585
  let escBuf = '';
1572
1586
  let escTimer = null;
1573
1587
  stdout.write(prompt);
1574
- const isRaw = stdin.isRaw;
1588
+ const isRaw = stdin.isRaw ?? false;
1575
1589
  if (stdin.isTTY)
1576
- stdin.setRawMode(true);
1590
+ stdin.setRawMode?.(true);
1577
1591
  stdin.resume();
1578
- stdin.setEncoding('utf8');
1592
+ stdin.setEncoding?.('utf8');
1579
1593
  function redraw() {
1580
1594
  const shouldMask = options.hideEchoBack || typeof options.mask === 'string';
1581
1595
  const maskChar = options.mask || '*';
@@ -1687,7 +1701,8 @@ export function readInput(prompt, options = {}) {
1687
1701
  if (escBuf.length === 2 && escBuf[1] === '[')
1688
1702
  continue;
1689
1703
  if (escBuf.length > 2 && ch >= '@' && ch <= '~') {
1690
- clearTimeout(escTimer);
1704
+ if (escTimer)
1705
+ clearTimeout(escTimer);
1691
1706
  processEscBuf();
1692
1707
  }
1693
1708
  continue;
@@ -1701,8 +1716,9 @@ export function readInput(prompt, options = {}) {
1701
1716
  handleChar(ch);
1702
1717
  }
1703
1718
  };
1704
- const cleanup = () => { clearTimeout(escTimer); escBuf = ''; stdin.removeListener('data', onData); if (stdin.isTTY)
1705
- stdin.setRawMode(isRaw); };
1719
+ const cleanup = () => { if (escTimer)
1720
+ clearTimeout(escTimer); escBuf = ''; stdin.removeListener('data', onData); if (stdin.isTTY)
1721
+ stdin.setRawMode?.(isRaw); };
1706
1722
  stdin.on('data', onData);
1707
1723
  });
1708
1724
  }
@@ -1846,12 +1862,13 @@ export function deepFreeze(obj) {
1846
1862
  if (obj === null || typeof obj !== 'object')
1847
1863
  return obj;
1848
1864
  Object.freeze(obj);
1865
+ const rec = obj;
1849
1866
  Object.getOwnPropertyNames(obj).forEach((prop) => {
1850
1867
  if (Object.prototype.hasOwnProperty.call(obj, prop) &&
1851
- obj[prop] !== null &&
1852
- (typeof obj[prop] === 'object' || typeof obj[prop] === 'function') &&
1853
- !Object.isFrozen(obj[prop])) {
1854
- deepFreeze(obj[prop]);
1868
+ rec[prop] !== null &&
1869
+ (typeof rec[prop] === 'object' || typeof rec[prop] === 'function') &&
1870
+ !Object.isFrozen(rec[prop])) {
1871
+ deepFreeze(rec[prop]);
1855
1872
  }
1856
1873
  });
1857
1874
  return obj;
@@ -1918,7 +1935,7 @@ export async function applyPersistedPendingCrawls(bot, options = {}) {
1918
1935
  if (Array.isArray(persisted) && persisted.length > 0 && Array.isArray(bot?.manager?._pendingFillCrawls)) {
1919
1936
  bot.manager._pendingFillCrawls = persisted;
1920
1937
  }
1921
- const result = OrderUtils.consumePendingFillCrawls(bot?.manager);
1938
+ const result = OrderUtils.consumePendingFillCrawls(bot.manager);
1922
1939
  if (result?.applied) {
1923
1940
  log(`[BOUNDARY] Applied ${result.count} pending fill crawl(s): boundary ${result.from} -> ${result.to}; ` +
1924
1941
  `persisting before reconcile`, 'warn');
@@ -30,6 +30,34 @@
30
30
  *
31
31
  * ===============================================================================
32
32
  */
33
+ import type { ManagedOrder, AccountTotals, AssetPair, GridLimitsLike, LogFn, ValidationIssue, FundShortfall, CowAction, CreateTargetViolation, FundPrecisions, ProjectedFunds, UnmatchedChainOrder } from '../../types.js';
34
+ import type { WorkingGrid } from '../working_grid.js';
35
+ interface ReconcileGridOptions {
36
+ logger?: LogFn | null;
37
+ dustThresholdPercent?: number;
38
+ gapSlots?: number;
39
+ assets?: AssetPair | null;
40
+ evacStreaks?: Map<string, number>;
41
+ [key: string]: unknown;
42
+ }
43
+ interface OptimizeActionsOptions {
44
+ logger?: LogFn | null;
45
+ boundaryIdx?: number;
46
+ gapSlots?: number;
47
+ assets?: AssetPair | null;
48
+ [key: string]: unknown;
49
+ }
50
+ interface ProjectTargetOptions {
51
+ actions?: CowAction[];
52
+ [key: string]: unknown;
53
+ }
54
+ interface EvaluateCommitOptions {
55
+ hasLock?: boolean;
56
+ currentVersion?: number;
57
+ masterGrid?: Map<string, ManagedOrder> | null;
58
+ comparePrecisions?: Record<string, number> | null;
59
+ [key: string]: unknown;
60
+ }
33
61
  /**
34
62
  * Validate a complete order object
35
63
  * @param {Object} order - Order to validate
@@ -37,11 +65,16 @@
37
65
  * @param {string} context - Operation context for error messages
38
66
  * @returns {Object} Validation result
39
67
  */
40
- declare function validateOrder(order: any, oldOrder?: any, context?: any): {
68
+ declare function validateOrder(order: Partial<ManagedOrder> | null | undefined, oldOrder?: Partial<ManagedOrder> | null, context?: string): {
41
69
  isValid: boolean;
42
- errors: any[];
43
- warnings: any[];
44
- normalizedOrder: any;
70
+ errors: ValidationIssue[];
71
+ warnings: ValidationIssue[];
72
+ normalizedOrder: null;
73
+ } | {
74
+ isValid: boolean;
75
+ errors: ValidationIssue[];
76
+ warnings: ValidationIssue[];
77
+ normalizedOrder: Partial<ManagedOrder>;
45
78
  };
46
79
  /**
47
80
  * Validate grid state for persistence
@@ -49,7 +82,7 @@ declare function validateOrder(order: any, oldOrder?: any, context?: any): {
49
82
  * @param {Object} accountTotals - Current account totals
50
83
  * @returns {Object} Validation result
51
84
  */
52
- declare function validateGridForPersistence(orders: any, accountTotals: any): {
85
+ declare function validateGridForPersistence(orders: Map<string, ManagedOrder>, accountTotals: AccountTotals | null): {
53
86
  isValid: boolean;
54
87
  reason: string;
55
88
  } | {
@@ -64,10 +97,10 @@ declare function validateGridForPersistence(orders: any, accountTotals: any): {
64
97
  * @param {Object} assets - Asset metadata
65
98
  * @returns {Object} Validation result
66
99
  */
67
- declare function validateWorkingGridFunds(workingGrid: any, projectedFunds: any, precisions?: Record<string, any>, assets?: any): {
100
+ declare function validateWorkingGridFunds(workingGrid: Map<string, ManagedOrder> | WorkingGrid, projectedFunds: ProjectedFunds | null | undefined, precisions?: FundPrecisions, assets?: AssetPair | null): {
68
101
  isValid: boolean;
69
102
  reason: string | null;
70
- shortfalls: any[];
103
+ shortfalls: FundShortfall[];
71
104
  required: {
72
105
  buyInt: number;
73
106
  sellInt: number;
@@ -86,7 +119,7 @@ declare function validateWorkingGridFunds(workingGrid: any, projectedFunds: any,
86
119
  * @param {Object} assets - Asset metadata
87
120
  * @returns {Object} Drift check result
88
121
  */
89
- declare function checkFundDrift(orders: Map<string, any>, accountTotals: any, assets?: any, gridLimits?: any): {
122
+ declare function checkFundDrift(orders: Map<string, ManagedOrder>, accountTotals: AccountTotals | null, assets?: AssetPair | null, gridLimits?: GridLimitsLike | null): {
90
123
  isValid: boolean;
91
124
  reason: string;
92
125
  driftBuy: number;
@@ -124,7 +157,7 @@ declare function checkFundDrift(orders: Map<string, any>, accountTotals: any, as
124
157
  * @param {number} frozenGapSlots - Plan-build gap slot count
125
158
  * @returns {Object} The action, stamped when it qualifies
126
159
  */
127
- declare function stampGapEvacuationRotation(action: any, sourceMaster: any, destPrice: any, destSize: any, type: any, frozenBoundary: any, frozenGapSlots: any, assets?: any): any;
160
+ declare function stampGapEvacuationRotation(action: CowAction, sourceMaster: ManagedOrder | null, destPrice: number | string, destSize: number, type: string, frozenBoundary: number | string | null, frozenGapSlots: number | string, assets?: AssetPair | null): CowAction;
128
161
  /**
129
162
  * Reconcile target grid against master state
130
163
  * @param {Map} masterGrid - Current master grid
@@ -133,16 +166,18 @@ declare function stampGapEvacuationRotation(action: any, sourceMaster: any, dest
133
166
  * @param {Object} options - Options
134
167
  * @returns {Object} Reconciliation result with actions
135
168
  */
136
- declare function reconcileGrid(masterGrid: any, targetGrid: any, targetBoundary: any, options?: Record<string, any>): {
137
- actions: any[];
169
+ declare function reconcileGrid(masterGrid: Map<string, ManagedOrder>, targetGrid: Map<string, ManagedOrder>, targetBoundary: number | null, options?: ReconcileGridOptions): {
170
+ actions: CowAction[];
138
171
  aborted: boolean;
139
- boundaryIdx: any;
140
- evacReady: any[];
172
+ boundaryIdx: number | null;
173
+ evacReady: {
174
+ id: string;
175
+ }[];
141
176
  summary: {
142
- total: any;
143
- creates: any;
144
- cancels: any;
145
- updates: any;
177
+ total: number;
178
+ creates: number;
179
+ cancels: number;
180
+ updates: number;
146
181
  };
147
182
  };
148
183
  /**
@@ -154,14 +189,14 @@ declare function reconcileGrid(masterGrid: any, targetGrid: any, targetBoundary:
154
189
  * @param {Map} masterGrid - Current master grid
155
190
  * @returns {Array<Object>} Optimized action list
156
191
  */
157
- declare function optimizeRebalanceActions(actions: any, masterGrid: any, options?: Record<string, any>): any[];
192
+ declare function optimizeRebalanceActions(actions: CowAction[], masterGrid: Map<string, ManagedOrder>, options?: OptimizeActionsOptions): CowAction[];
158
193
  /**
159
194
  * Check if a rebalance result has executable actions.
160
195
  *
161
- * @param {any} rebalanceResult - Rebalance result to check
196
+ * @param {unknown} rebalanceResult - Rebalance result to check
162
197
  * @returns {boolean} True if actions array is non-empty
163
198
  */
164
- declare function hasExecutableActions(rebalanceResult: any): boolean;
199
+ declare function hasExecutableActions(rebalanceResult: unknown): boolean;
165
200
  /**
166
201
  * Validate that CREATE actions target slots that are not already occupied on-chain
167
202
  * and that no CREATE price collides with an existing placed order or unmatched
@@ -178,17 +213,17 @@ declare function hasExecutableActions(rebalanceResult: any): boolean;
178
213
  * Returns violating target IDs alongside violations so the caller can skip
179
214
  * individual violating CREATEs instead of aborting the entire batch.
180
215
  *
181
- * @param {Array<any>} actions - List of COW actions
216
+ * @param {Array<CowAction>} actions - List of COW actions
182
217
  * @param {Map} orders - Current order grid
183
218
  * @param {Object|null} [assets=null] - Asset metadata for tolerance calculation
184
219
  * @param {Array<Object>} [chainOrderCandidates=[]] - Unmatched on-chain orders
185
220
  * with {chainOrderId, price, size, type} to check beyond the grid
186
221
  * @returns {{isValid: boolean, violations: Array<Object>, violatingTargetIds: Set<string>}} Validation result
187
222
  */
188
- declare function validateCreateTargetSlots(actions: any, orders: any, _assets?: any, chainOrderCandidates?: any[]): {
223
+ declare function validateCreateTargetSlots(actions: CowAction[], orders: Map<string, ManagedOrder>, _assets?: AssetPair | null, chainOrderCandidates?: UnmatchedChainOrder[]): {
189
224
  isValid: boolean;
190
- violations: any[];
191
- violatingTargetIds: Set<any>;
225
+ violations: CreateTargetViolation[];
226
+ violatingTargetIds: Set<string>;
192
227
  };
193
228
  /**
194
229
  * Check if an action list already contains a matching action for an order.
@@ -198,7 +233,10 @@ declare function validateCreateTargetSlots(actions: any, orders: any, _assets?:
198
233
  * @param {Object} orderRef - Reference with id/orderId
199
234
  * @returns {boolean}
200
235
  */
201
- declare function hasActionForOrder(actions: any, actionType: any, orderRef: any): boolean;
236
+ declare function hasActionForOrder(actions: CowAction[], actionType: string | null, orderRef: {
237
+ id?: string | null;
238
+ orderId?: string | null;
239
+ }): boolean;
202
240
  /**
203
241
  * Remove matching actions for an order from action list in-place.
204
242
  *
@@ -207,29 +245,32 @@ declare function hasActionForOrder(actions: any, actionType: any, orderRef: any)
207
245
  * @param {Object} orderRef - Reference with id/orderId
208
246
  * @returns {number} Number of removed actions
209
247
  */
210
- declare function removeActionsForOrder(actions: any, actionType: any, orderRef: any): number;
248
+ declare function removeActionsForOrder(actions: CowAction[], actionType: string | null, orderRef: {
249
+ id?: string | null;
250
+ orderId?: string | null;
251
+ }): number;
211
252
  /**
212
253
  * Project target grid into working grid
213
- * @param {any} workingGrid - Working grid to modify
254
+ * @param {unknown} workingGrid - Working grid to modify
214
255
  * @param {Map} targetGrid - Target state
215
256
  * @param {Object} [options] - Optional parameters
216
257
  * @param {Array} [options.actions] - Pre-existing COW actions to consider
217
258
  * @returns {void}
218
259
  */
219
- declare function projectTargetToWorkingGrid(workingGrid: any, targetGrid: any, options?: Record<string, any>): void;
260
+ declare function projectTargetToWorkingGrid(workingGrid: WorkingGrid, targetGrid: Map<string, ManagedOrder>, options?: ProjectTargetOptions): void;
220
261
  /**
221
262
  * Build optimistic state updates from rebalance actions
222
263
  * @param {Array<Object>} actions - Array of rebalance action objects
223
264
  * @param {Map} masterGrid - Master grid Map containing current order states
224
265
  * @returns {Array<Object>} State update objects for optimistic rendering
225
266
  */
226
- declare function buildStateUpdates(actions: any, masterGrid: any): any[];
267
+ declare function buildStateUpdates(actions: CowAction[], masterGrid: Map<string, ManagedOrder>): ManagedOrder[];
227
268
  /**
228
269
  * Build an aborted COW result
229
270
  * @param {string} reason - Abort reason
230
271
  * @returns {Object} Aborted result object
231
272
  */
232
- declare function buildAbortedResult(reason: any): {
273
+ declare function buildAbortedResult(reason: string | null | undefined): {
233
274
  actions: never[];
234
275
  stateUpdates: never[];
235
276
  hadRotation: boolean;
@@ -238,23 +279,30 @@ declare function buildAbortedResult(reason: any): {
238
279
  workingBoundary: null;
239
280
  planningDuration: number;
240
281
  aborted: boolean;
241
- reason: any;
282
+ reason: string | null | undefined;
242
283
  };
243
284
  /**
244
285
  * Build successful COW result
245
286
  * @param {Object} params - Result parameters
246
287
  * @returns {Object} Success result object
247
288
  */
248
- declare function buildSuccessResult({ actions, stateUpdates, workingGrid, workingBoundary, planningDuration, refillSlotIds }: any): {
289
+ declare function buildSuccessResult({ actions, stateUpdates, workingGrid, workingBoundary, planningDuration, refillSlotIds }: {
290
+ actions: CowAction[];
291
+ stateUpdates: ManagedOrder[];
292
+ workingGrid: WorkingGrid;
293
+ workingBoundary: number | null;
294
+ planningDuration: number;
295
+ refillSlotIds?: unknown;
296
+ }): {
249
297
  aborted: boolean;
250
- refillSlotIds?: any;
251
- actions: any;
252
- stateUpdates: any;
253
- hadRotation: any;
254
- workingGrid: any;
255
- workingIndexes: any;
256
- workingBoundary: any;
257
- planningDuration: any;
298
+ refillSlotIds?: {} | null | undefined;
299
+ actions: CowAction[];
300
+ stateUpdates: ManagedOrder[];
301
+ hadRotation: boolean;
302
+ workingGrid: WorkingGrid;
303
+ workingIndexes: unknown;
304
+ workingBoundary: number | null;
305
+ planningDuration: number;
258
306
  };
259
307
  /**
260
308
  * Evaluate if a working grid can be committed
@@ -262,7 +310,7 @@ declare function buildSuccessResult({ actions, stateUpdates, workingGrid, workin
262
310
  * @param {Object} options - Evaluation options
263
311
  * @returns {Object} Evaluation result
264
312
  */
265
- declare function evaluateCommit(workingGrid: any, options?: any): {
313
+ declare function evaluateCommit(workingGrid: WorkingGrid | null | undefined, options?: EvaluateCommitOptions | boolean): {
266
314
  canCommit: boolean;
267
315
  reason: string;
268
316
  level: string;