dexbot 1.6.11 → 1.6.13

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (398) hide show
  1. package/CHANGELOG.md +67 -4
  2. package/README.md +2 -1
  3. package/analysis/README.md +11 -11
  4. package/analysis/ama_fitting/README.md +5 -3
  5. package/analysis/tradingview/README.md +1 -1
  6. package/analysis/trend_detection/DYNAMIC_WEIGHT_RESEARCH.md +3 -3
  7. package/claw/README.md +1 -0
  8. package/claw/docs/AI_BOT_LIBRARY_API.md +2 -0
  9. package/claw/docs/DEXBOT2_TUNING_CHEAT_SHEET.md +4 -3
  10. package/claw/modules/chain_broadcast.ts +7 -1
  11. package/claw/modules/claw_bridge.ts +0 -3
  12. package/claw/modules/claw_launcher.ts +1 -1
  13. package/claw/modules/claw_skill_md.ts +1 -0
  14. package/claw/modules/launcher_mode_detector.ts +9 -2
  15. package/claw/package.json +3 -3
  16. package/claw/runtimes/openclaw-plugin/openclaw.plugin.json +1 -1
  17. package/claw/runtimes/openclaw-plugin/package.json +1 -1
  18. package/claw/tsconfig.json +2 -2
  19. package/dist/analysis/account_resolver.d.ts +1 -1
  20. package/dist/analysis/account_resolver.js +2 -1
  21. package/dist/analysis/ama_fitting/analyze_ama_price_changes.js +3 -4
  22. package/dist/analysis/ama_fitting/analyze_lambda_vs_slow.js +3 -21
  23. package/dist/analysis/ama_fitting/calibrate_convergence_er.js +0 -1
  24. package/dist/analysis/ama_fitting/fetch_lp_candles.js +55 -45
  25. package/dist/analysis/ama_fitting/generate_unified_comparison_chart.d.ts +1 -8
  26. package/dist/analysis/ama_fitting/generate_unified_comparison_chart.js +45 -24
  27. package/dist/analysis/ama_fitting/optimizer_high_resolution.js +34 -78
  28. package/dist/analysis/analyze_args.d.ts +43 -0
  29. package/dist/analysis/analyze_args.js +61 -0
  30. package/dist/analysis/analyze_dynamic_weight.js +7 -17
  31. package/dist/analysis/analyze_kalman.js +7 -17
  32. package/dist/analysis/analyze_regime.js +7 -17
  33. package/dist/analysis/analyze_regime_windows.js +8 -18
  34. package/dist/analysis/analyze_risk_profile.js +8 -18
  35. package/dist/analysis/analyze_trade_heatmap.js +7 -17
  36. package/dist/analysis/analyze_volatility.js +7 -17
  37. package/dist/analysis/bot_fitting/backtest_ama_sweep.d.ts +221 -28
  38. package/dist/analysis/bot_fitting/backtest_ama_sweep.js +23 -103
  39. package/dist/analysis/bot_fitting/backtest_bot_fitting.d.ts +34 -4
  40. package/dist/analysis/bot_fitting/backtest_bot_fitting.js +32 -150
  41. package/dist/analysis/bot_fitting/backtest_lookback_drawdown.js +19 -34
  42. package/dist/analysis/bot_fitting/shared_utils.d.ts +77 -9
  43. package/dist/analysis/bot_fitting/shared_utils.js +125 -9
  44. package/dist/analysis/bot_key_utils.d.ts +18 -10
  45. package/dist/analysis/bot_key_utils.js +7 -4
  46. package/dist/analysis/bot_usage/discover_bot_accounts.js +44 -47
  47. package/dist/analysis/bot_usage/kibana_bot_queries.d.ts +1 -21
  48. package/dist/analysis/chain_pool.d.ts +3 -1
  49. package/dist/analysis/chart_ui.d.ts +35 -3
  50. package/dist/analysis/chart_ui.js +43 -4
  51. package/dist/analysis/chart_utils.d.ts +5 -5
  52. package/dist/analysis/chart_utils.js +9 -0
  53. package/dist/analysis/fills_cache.d.ts +4 -24
  54. package/dist/analysis/fills_cache.js +3 -84
  55. package/dist/analysis/fills_source.d.ts +33 -3
  56. package/dist/analysis/fills_source.js +83 -13
  57. package/dist/analysis/grid_correction_check.d.ts +2 -24
  58. package/dist/analysis/grid_correction_check.js +27 -69
  59. package/dist/analysis/math_utils.d.ts +91 -6
  60. package/dist/analysis/math_utils.js +119 -7
  61. package/dist/analysis/pnl_report.js +29 -29
  62. package/dist/analysis/price_sources.d.ts +30 -9
  63. package/dist/analysis/price_sources.js +28 -4
  64. package/dist/analysis/resolve_bot_accounts.js +2 -2
  65. package/dist/analysis/resolve_source.d.ts +1 -1
  66. package/dist/analysis/resolve_source.js +31 -10
  67. package/dist/analysis/trade_profitability.d.ts +29 -2
  68. package/dist/analysis/trade_profitability.js +73 -147
  69. package/dist/analysis/tradingview/analyze_tradingview.d.ts +3 -8
  70. package/dist/analysis/tradingview/analyze_tradingview.js +7 -6
  71. package/dist/analysis/tradingview/grid_reset_config.d.ts +41 -32
  72. package/dist/analysis/tradingview/grid_reset_config.js +23 -11
  73. package/dist/analysis/tradingview/grid_reset_sim.d.ts +75 -9
  74. package/dist/analysis/tradingview/grid_reset_sim.js +4 -3
  75. package/dist/analysis/tradingview/tradingview_uplot_chart_generator.d.ts +69 -4
  76. package/dist/analysis/tradingview/tradingview_uplot_chart_generator.js +20 -34
  77. package/dist/analysis/trend_detection/backtest_ama_slope_huber.d.ts +1 -101
  78. package/dist/analysis/trend_detection/backtest_ama_slope_huber.js +26 -84
  79. package/dist/analysis/trend_detection/dynamic_weight_chart_generator.d.ts +63 -1
  80. package/dist/analysis/trend_detection/dynamic_weight_chart_generator.js +16 -41
  81. package/dist/analysis/trend_detection/huber_scale_variants.d.ts +9 -3
  82. package/dist/analysis/trend_detection/huber_scale_variants.js +4 -4
  83. package/dist/analysis/trend_detection/kalman_chart_generator.d.ts +30 -1
  84. package/dist/analysis/trend_detection/kalman_chart_generator.js +3 -3
  85. package/dist/analysis/trend_detection/regime_chart_generator.d.ts +31 -1
  86. package/dist/analysis/trend_detection/regime_chart_generator.js +2 -2
  87. package/dist/analysis/trend_detection/volatility_chart_generator.d.ts +33 -1
  88. package/dist/analysis/trend_detection/volatility_chart_generator.js +9 -10
  89. package/dist/analysis/worker_pool.d.ts +38 -0
  90. package/dist/analysis/worker_pool.js +67 -0
  91. package/dist/credential-daemon.js +34 -20
  92. package/dist/dexbot.js +78 -59
  93. package/dist/market_adapter/ama_signal_runner.js +21 -54
  94. package/dist/market_adapter/candle_utils.d.ts +29 -19
  95. package/dist/market_adapter/candle_utils.js +35 -21
  96. package/dist/market_adapter/cli_args.d.ts +22 -0
  97. package/dist/market_adapter/cli_args.js +30 -0
  98. package/dist/market_adapter/core/asymmetric_bounds.d.ts +13 -4
  99. package/dist/market_adapter/core/config_normalizers.d.ts +3 -3
  100. package/dist/market_adapter/core/config_normalizers.js +11 -6
  101. package/dist/market_adapter/core/kibana_candles.d.ts +56 -19
  102. package/dist/market_adapter/core/kibana_candles.js +12 -9
  103. package/dist/market_adapter/core/kibana_client.d.ts +9 -1
  104. package/dist/market_adapter/core/kibana_client.js +8 -7
  105. package/dist/market_adapter/core/kibana_market_candles.d.ts +3 -2
  106. package/dist/market_adapter/core/market_adapter_service.d.ts +320 -153
  107. package/dist/market_adapter/core/market_adapter_service.js +228 -269
  108. package/dist/market_adapter/core/signals/hurst_analyzer.d.ts +1 -6
  109. package/dist/market_adapter/core/signals/hurst_analyzer.js +1 -1
  110. package/dist/market_adapter/core/signals/permutation_entropy_analyzer.d.ts +1 -11
  111. package/dist/market_adapter/core/signals/permutation_entropy_analyzer.js +1 -1
  112. package/dist/market_adapter/core/strategies/ama.d.ts +10 -2
  113. package/dist/market_adapter/core/strategies/ama.js +2 -4
  114. package/dist/market_adapter/core/strategies/ama_slope_model.d.ts +14 -1
  115. package/dist/market_adapter/core/strategies/ama_slope_model.js +12 -34
  116. package/dist/market_adapter/core/strategies/atr/calculator.d.ts +7 -2
  117. package/dist/market_adapter/core/strategies/atr/calculator.js +2 -34
  118. package/dist/market_adapter/core/strategies/collateral_manager.d.ts +7 -1
  119. package/dist/market_adapter/core/strategies/collateral_manager.js +0 -22
  120. package/dist/market_adapter/core/strategies/dynamic_weight_series.d.ts +34 -6
  121. package/dist/market_adapter/core/strategies/dynamic_weight_series.js +7 -7
  122. package/dist/market_adapter/core/strategies/regime_gate.d.ts +24 -15
  123. package/dist/market_adapter/core/strategies/regime_gate.js +4 -31
  124. package/dist/market_adapter/core/strategies/regime_interp.d.ts +7 -1
  125. package/dist/market_adapter/core/strategies/regime_interp.js +14 -22
  126. package/dist/market_adapter/core/strategies/volatility_shift.d.ts +11 -1
  127. package/dist/market_adapter/core/strategies/volatility_shift.js +0 -13
  128. package/dist/market_adapter/inputs/cex_candle_parsing.d.ts +29 -0
  129. package/dist/market_adapter/inputs/cex_candle_parsing.js +52 -0
  130. package/dist/market_adapter/inputs/fetch_book_data.d.ts +20 -4
  131. package/dist/market_adapter/inputs/fetch_book_data.js +3 -2
  132. package/dist/market_adapter/inputs/fetch_cex_synthetic_data.js +160 -332
  133. package/dist/market_adapter/inputs/fetch_lp_data.d.ts +50 -8
  134. package/dist/market_adapter/inputs/fetch_lp_data.js +47 -22
  135. package/dist/market_adapter/inputs/kibana_feed_source.d.ts +74 -15
  136. package/dist/market_adapter/inputs/kibana_feed_source.js +26 -41
  137. package/dist/market_adapter/inputs/kibana_source.d.ts +25 -3
  138. package/dist/market_adapter/inputs/kibana_source.js +2 -2
  139. package/dist/market_adapter/inputs/window_cache.d.ts +93 -156
  140. package/dist/market_adapter/inputs/window_cache.js +59 -184
  141. package/dist/market_adapter/interval_utils.d.ts +15 -5
  142. package/dist/market_adapter/interval_utils.js +16 -1
  143. package/dist/market_adapter/log_format.d.ts +6 -6
  144. package/dist/market_adapter/log_format.js +28 -21
  145. package/dist/market_adapter/lp_chart_core.d.ts +22 -1
  146. package/dist/market_adapter/lp_chart_core.js +26 -192
  147. package/dist/market_adapter/lp_chart_runner.d.ts +10 -7
  148. package/dist/market_adapter/lp_chart_runner.js +37 -19
  149. package/dist/market_adapter/lp_chart_strategy_loader.d.ts +41 -6
  150. package/dist/market_adapter/lp_chart_strategy_loader.js +8 -7
  151. package/dist/market_adapter/market_adapter.d.ts +94 -32
  152. package/dist/market_adapter/market_adapter.js +94 -120
  153. package/dist/market_adapter/utils/adapter_client.d.ts +3 -3
  154. package/dist/market_adapter/utils/adapter_client.js +2 -2
  155. package/dist/market_adapter/utils/atomic_write.d.ts +8 -1
  156. package/dist/market_adapter/utils/chain.d.ts +50 -41
  157. package/dist/market_adapter/utils/chain.js +40 -46
  158. package/dist/market_adapter/utils/data_discovery.d.ts +49 -2
  159. package/dist/market_adapter/utils/data_discovery.js +220 -27
  160. package/dist/market_adapter/utils/dynamic_grid_snapshot.d.ts +12 -3
  161. package/dist/market_adapter/utils/file_json_cache.d.ts +2 -2
  162. package/dist/market_adapter/utils/file_lock.d.ts +28 -14
  163. package/dist/market_adapter/utils/file_lock.js +36 -32
  164. package/dist/market_adapter/utils/month_shards.d.ts +84 -0
  165. package/dist/market_adapter/utils/month_shards.js +237 -0
  166. package/dist/market_adapter/utils/native_history.d.ts +9 -2
  167. package/dist/market_adapter/utils/native_history.js +35 -28
  168. package/dist/modules/account_bots.d.ts +578 -21
  169. package/dist/modules/account_bots.js +272 -267
  170. package/dist/modules/account_orders.d.ts +79 -30
  171. package/dist/modules/account_orders.js +60 -64
  172. package/dist/modules/authority_resolver.d.ts +12 -2
  173. package/dist/modules/authority_resolver.js +15 -8
  174. package/dist/modules/bitshares-native/chain_client.d.ts +39 -4
  175. package/dist/modules/bitshares-native/chain_client.js +59 -59
  176. package/dist/modules/bitshares-native/crypto/ecc.browser.js +11 -171
  177. package/dist/modules/bitshares-native/crypto/ecc.js +13 -176
  178. package/dist/modules/bitshares-native/crypto/ecc_core.d.ts +33 -0
  179. package/dist/modules/bitshares-native/crypto/ecc_core.js +213 -0
  180. package/dist/modules/bitshares-native/crypto/ecc_selector.d.ts +2 -1
  181. package/dist/modules/bitshares-native/crypto/ecc_selector.js +1 -13
  182. package/dist/modules/bitshares-native/index.d.ts +1 -1
  183. package/dist/modules/bitshares-native/lru_cache.d.ts +7 -7
  184. package/dist/modules/bitshares-native/resolvers.d.ts +18 -6
  185. package/dist/modules/bitshares-native/resolvers.js +22 -25
  186. package/dist/modules/bitshares-native/serial/lazy_buffer.d.ts +4 -0
  187. package/dist/modules/bitshares-native/serial/lazy_buffer.js +21 -0
  188. package/dist/modules/bitshares-native/serial/operations.d.ts +1 -1
  189. package/dist/modules/bitshares-native/serial/serializer.d.ts +16 -12
  190. package/dist/modules/bitshares-native/serial/serializer.js +7 -13
  191. package/dist/modules/bitshares-native/serial/types.d.ts +25 -16
  192. package/dist/modules/bitshares-native/serial/types.js +73 -108
  193. package/dist/modules/bitshares-native/signing_client.d.ts +32 -2
  194. package/dist/modules/bitshares-native/signing_client.js +19 -14
  195. package/dist/modules/bitshares-native/subscriptions.d.ts +81 -1
  196. package/dist/modules/bitshares-native/subscriptions.js +12 -12
  197. package/dist/modules/bitshares-native/transport.d.ts +5 -4
  198. package/dist/modules/bitshares-native/transport.js +5 -4
  199. package/dist/modules/bitshares-native/tx/builder.d.ts +40 -5
  200. package/dist/modules/bitshares-native/tx/builder.js +4 -3
  201. package/dist/modules/bitshares-native/tx/tx_cache.d.ts +4 -4
  202. package/dist/modules/bitshares_client.d.ts +45 -13
  203. package/dist/modules/bitshares_client.js +28 -19
  204. package/dist/modules/bot_defaults.d.ts +8 -16
  205. package/dist/modules/bot_defaults.js +1 -5
  206. package/dist/modules/bot_settings.d.ts +44 -10
  207. package/dist/modules/bot_settings.js +11 -8
  208. package/dist/modules/bots_file_lock.d.ts +6 -6
  209. package/dist/modules/bots_file_lock.js +16 -12
  210. package/dist/modules/broadcast_failure.d.ts +4 -3
  211. package/dist/modules/broadcast_failure.js +5 -4
  212. package/dist/modules/chain_keys.d.ts +42 -40
  213. package/dist/modules/chain_keys.js +53 -45
  214. package/dist/modules/chain_orders.d.ts +94 -60
  215. package/dist/modules/chain_orders.js +81 -118
  216. package/dist/modules/cli_start_onboarding.d.ts +2 -1
  217. package/dist/modules/constants.d.ts +534 -32
  218. package/dist/modules/constants.js +35 -48
  219. package/dist/modules/cr_planner.d.ts +41 -3
  220. package/dist/modules/cr_planner.js +1 -5
  221. package/dist/modules/credential_policy.d.ts +68 -8
  222. package/dist/modules/credential_policy.js +37 -31
  223. package/dist/modules/credential_session_cache.d.ts +2 -2
  224. package/dist/modules/credit_pricing.d.ts +43 -6
  225. package/dist/modules/credit_pricing.js +70 -60
  226. package/dist/modules/credit_runtime.d.ts +283 -118
  227. package/dist/modules/credit_runtime.js +500 -231
  228. package/dist/modules/crypto/browser_provider.js +6 -4
  229. package/dist/modules/crypto/node_provider.js +1 -1
  230. package/dist/modules/crypto/pure_scrypt.js +35 -4
  231. package/dist/modules/crypto/pure_secp256k1.js +72 -26
  232. package/dist/modules/crypto/sync.d.ts +9 -9
  233. package/dist/modules/crypto/sync.js +16 -9
  234. package/dist/modules/daemon_node_health.d.ts +4 -3
  235. package/dist/modules/dexbot_class.d.ts +213 -146
  236. package/dist/modules/dexbot_class.js +183 -86
  237. package/dist/modules/dexbot_cow_runtime.d.ts +160 -87
  238. package/dist/modules/dexbot_cow_runtime.js +302 -234
  239. package/dist/modules/dexbot_credential_client.d.ts +19 -18
  240. package/dist/modules/dexbot_credential_client.js +1 -2
  241. package/dist/modules/dexbot_fill_runtime.d.ts +63 -49
  242. package/dist/modules/dexbot_fill_runtime.js +53 -47
  243. package/dist/modules/dexbot_maintenance_runtime.d.ts +127 -71
  244. package/dist/modules/dexbot_maintenance_runtime.js +187 -147
  245. package/dist/modules/dexbot_startup_runtime.d.ts +11 -11
  246. package/dist/modules/dexbot_startup_runtime.js +56 -57
  247. package/dist/modules/dexbot_state_recovery.d.ts +13 -12
  248. package/dist/modules/dexbot_state_recovery.js +18 -13
  249. package/dist/modules/fund_registry.d.ts +4 -2
  250. package/dist/modules/fund_registry.js +10 -10
  251. package/dist/modules/general_settings.d.ts +30 -4
  252. package/dist/modules/graceful_shutdown.d.ts +3 -3
  253. package/dist/modules/graceful_shutdown.js +19 -13
  254. package/dist/modules/grid_price_source.d.ts +1 -1
  255. package/dist/modules/key_store.d.ts +14 -8
  256. package/dist/modules/key_store.js +7 -7
  257. package/dist/modules/launcher/adapter_requirement.d.ts +11 -5
  258. package/dist/modules/launcher/adapter_requirement.js +5 -5
  259. package/dist/modules/launcher/bot_supervisor.d.ts +106 -24
  260. package/dist/modules/launcher/bot_supervisor.js +12 -11
  261. package/dist/modules/launcher/credential_bootstrap.d.ts +1 -1
  262. package/dist/modules/launcher/credential_bootstrap.js +1 -1
  263. package/dist/modules/launcher/credential_daemon.d.ts +4 -4
  264. package/dist/modules/launcher/credential_daemon.js +2 -2
  265. package/dist/modules/launcher/credential_secret.d.ts +1 -1
  266. package/dist/modules/launcher/foreign_cred_daemon.d.ts +2 -2
  267. package/dist/modules/launcher/market_adapter_runtime.d.ts +61 -6
  268. package/dist/modules/launcher/market_adapter_watchdog.d.ts +10 -2
  269. package/dist/modules/launcher/market_adapter_watchdog.js +4 -0
  270. package/dist/modules/launcher/monolithic_runtime.d.ts +18 -16
  271. package/dist/modules/launcher/status_reporting.d.ts +22 -14
  272. package/dist/modules/launcher/supervisor_control.d.ts +8 -1
  273. package/dist/modules/launcher/supervisor_control.js +4 -2
  274. package/dist/modules/lazy_shim.d.ts +11 -0
  275. package/dist/modules/lazy_shim.js +16 -0
  276. package/dist/modules/market_adapter_whitelist.d.ts +9 -3
  277. package/dist/modules/market_adapter_whitelist.js +15 -3
  278. package/dist/modules/node_connect_policy.d.ts +3 -2
  279. package/dist/modules/node_failure_ledger.d.ts +6 -5
  280. package/dist/modules/node_manager.d.ts +41 -11
  281. package/dist/modules/node_manager.js +5 -4
  282. package/dist/modules/order/accounting.d.ts +53 -24
  283. package/dist/modules/order/accounting.js +16 -15
  284. package/dist/modules/order/async_lock.d.ts +5 -2
  285. package/dist/modules/order/async_lock.js +1 -1
  286. package/dist/modules/order/export.d.ts +7 -6
  287. package/dist/modules/order/export.js +1 -7
  288. package/dist/modules/order/format.d.ts +16 -7
  289. package/dist/modules/order/format.js +15 -3
  290. package/dist/modules/order/genesis_policy.d.ts +24 -21
  291. package/dist/modules/order/genesis_policy.js +17 -10
  292. package/dist/modules/order/grid.d.ts +144 -36
  293. package/dist/modules/order/grid.js +226 -145
  294. package/dist/modules/order/grid_reconcile.d.ts +21 -20
  295. package/dist/modules/order/grid_reconcile.js +13 -12
  296. package/dist/modules/order/grid_reconcile_internal.d.ts +85 -72
  297. package/dist/modules/order/grid_reconcile_internal.js +28 -19
  298. package/dist/modules/order/index.d.ts +264 -1
  299. package/dist/modules/order/logger.d.ts +46 -19
  300. package/dist/modules/order/logger.js +38 -49
  301. package/dist/modules/order/logger_state.d.ts +4 -4
  302. package/dist/modules/order/manager.d.ts +232 -191
  303. package/dist/modules/order/manager.js +110 -130
  304. package/dist/modules/order/processed_fill_store.d.ts +18 -3
  305. package/dist/modules/order/processed_fill_store.js +16 -27
  306. package/dist/modules/order/strategy.d.ts +21 -13
  307. package/dist/modules/order/strategy.js +5 -6
  308. package/dist/modules/order/sync_engine.d.ts +91 -33
  309. package/dist/modules/order/sync_engine.js +84 -53
  310. package/dist/modules/order/utils/math.d.ts +157 -102
  311. package/dist/modules/order/utils/math.js +77 -38
  312. package/dist/modules/order/utils/order.d.ts +310 -110
  313. package/dist/modules/order/utils/order.js +153 -126
  314. package/dist/modules/order/utils/slot.d.ts +1 -1
  315. package/dist/modules/order/utils/system.d.ts +156 -26
  316. package/dist/modules/order/utils/system.js +103 -71
  317. package/dist/modules/order/utils/validate.d.ts +89 -41
  318. package/dist/modules/order/utils/validate.js +26 -24
  319. package/dist/modules/order/utils/withPoolRef.d.ts +6 -4
  320. package/dist/modules/order/utils/withPoolRef.js +18 -12
  321. package/dist/modules/order/working_grid.d.ts +14 -13
  322. package/dist/modules/paths.d.ts +1 -4
  323. package/dist/modules/paths.js +33 -61
  324. package/dist/modules/process_discovery.d.ts +1 -1
  325. package/dist/modules/process_discovery.js +2 -1
  326. package/dist/modules/runtime.d.ts +7 -3
  327. package/dist/modules/runtime.js +4 -3
  328. package/dist/modules/runtime_settings.d.ts +14 -11
  329. package/dist/modules/runtime_settings.js +30 -24
  330. package/dist/modules/settings_merge.d.ts +29 -3
  331. package/dist/modules/settings_merge.js +56 -78
  332. package/dist/modules/socket_json_client.d.ts +9 -5
  333. package/dist/modules/storage/browser_adapter.d.ts +38 -53
  334. package/dist/modules/storage/browser_adapter.js +7 -30
  335. package/dist/modules/storage/index.d.ts +1 -1
  336. package/dist/modules/storage/node_adapter.d.ts +45 -27
  337. package/dist/modules/storage/node_adapter.js +9 -9
  338. package/dist/modules/storage/types.d.ts +5 -4
  339. package/dist/modules/types.d.ts +1090 -6
  340. package/dist/modules/types.js +4 -1
  341. package/dist/modules/utils/asset_symbols.d.ts +2 -1
  342. package/dist/modules/utils/asset_symbols.js +2 -1
  343. package/dist/modules/utils/errors.d.ts +9 -0
  344. package/dist/modules/utils/errors.js +24 -4
  345. package/dist/modules/utils/time_range.d.ts +1 -12
  346. package/dist/modules/utils/time_range.js +1 -1
  347. package/dist/modules/validate_profiles.js +53 -43
  348. package/dist/modules/version_notice.d.ts +23 -11
  349. package/dist/modules/version_notice.js +6 -4
  350. package/dist/pm2.d.ts +28 -27
  351. package/dist/pm2.js +61 -40
  352. package/dist/scripts/analyze-credit.d.ts +2 -1
  353. package/dist/scripts/analyze-credit.js +23 -24
  354. package/dist/scripts/analyze-git.js +2 -15
  355. package/dist/scripts/analyze-orders.d.ts +77 -9
  356. package/dist/scripts/analyze-orders.js +65 -40
  357. package/dist/scripts/chart_command.d.ts +27 -18
  358. package/dist/scripts/chart_command.js +15 -13
  359. package/dist/scripts/check_any.d.ts +22 -0
  360. package/dist/scripts/check_any.js +158 -0
  361. package/dist/scripts/diagnose-pool-history.js +13 -13
  362. package/dist/scripts/print_grid.js +0 -1
  363. package/dist/scripts/run-tests.js +39 -8
  364. package/dist/scripts/runner.js +1 -1
  365. package/dist/scripts/sync-version.js +0 -10
  366. package/dist/scripts/test-credit-renewal.js +30 -21
  367. package/dist/scripts/update.d.ts +10 -5
  368. package/dist/scripts/update.js +168 -103
  369. package/dist/scripts/update_dist_freshness.js +1 -0
  370. package/dist/scripts/update_layout.d.ts +61 -0
  371. package/dist/scripts/update_layout.js +180 -0
  372. package/dist/scripts/validate_bots.js +2 -1
  373. package/dist/scripts/verify-browser-bundle.js +8 -0
  374. package/dist/unlock.d.ts +28 -3
  375. package/dist/unlock.js +63 -35
  376. package/docs/BITSHARES_ONBOARDING.md +10 -12
  377. package/docs/COPY_ON_WRITE_MASTER_PLAN.md +2 -2
  378. package/docs/COW_INVARIANTS.md +13 -6
  379. package/docs/DEXBOT_COMPARISON.md +8 -8
  380. package/docs/EVOLUTION.md +10 -8
  381. package/docs/FUND_MOVEMENT_AND_ACCOUNTING.md +5 -5
  382. package/docs/GRID_RECALCULATION.md +4 -2
  383. package/docs/GRID_RECONCILE.md +14 -3
  384. package/docs/LIFECYCLE.md +11 -11
  385. package/docs/MPA_CREDIT_USAGE.md +22 -3
  386. package/docs/README.md +14 -3
  387. package/docs/WORKFLOW.md +1 -0
  388. package/docs/architecture.md +31 -19
  389. package/docs/developer_guide.md +6 -6
  390. package/market_adapter/README.md +12 -5
  391. package/modules/README.md +4 -1
  392. package/package.json +9 -9
  393. package/scripts/README.md +43 -38
  394. package/tests/README.md +25 -10
  395. package/dist/scripts/diagnose-kibana-candles.d.ts +0 -3
  396. package/dist/scripts/diagnose-kibana-candles.js +0 -82
  397. package/scripts/git-viewer.sh +0 -489
  398. package/scripts/postinstall.js +0 -16
@@ -1,9 +1,9 @@
1
1
  /** Credential client module - connects to credential daemon for key operations */
2
2
  interface BroadcastUncertainErrorDetails {
3
- operations?: any[] | null;
3
+ operations?: unknown[] | null;
4
4
  accountName?: string | null;
5
5
  batchId?: string | null;
6
- payload?: any;
6
+ payload?: unknown;
7
7
  timeoutMs?: number | null;
8
8
  }
9
9
  interface CredentialClientOptions {
@@ -16,13 +16,6 @@ interface CredentialClientOptions {
16
16
  botHmacSecret?: string | null;
17
17
  batchId?: string | null;
18
18
  nodeUrl?: string;
19
- /**
20
- * Accepted for interface compatibility only. The daemon cycles its own
21
- * node list internally, and an uncertain broadcast must never be re-sent
22
- * (a landed tx would be duplicated), so the client no longer cycles
23
- * through fallbacks. Callers may keep passing this field; it is ignored.
24
- */
25
- fallbackNodes?: string[];
26
19
  /**
27
20
  * Fired with the node the daemon reports as in play when a broadcast ends
28
21
  * uncertain (BROADCAST_DEADLINE / outer timeout). The daemon echoes the
@@ -34,7 +27,7 @@ interface CredentialClientOptions {
34
27
  }
35
28
  interface CredentialDaemonMeta {
36
29
  uncertainOnTimeout?: boolean;
37
- operations?: any[] | null;
30
+ operations?: unknown[] | null;
38
31
  accountName?: string | null;
39
32
  batchId?: string | null;
40
33
  }
@@ -42,16 +35,24 @@ export interface CredentialDaemonResponse {
42
35
  success?: boolean;
43
36
  error?: string;
44
37
  code?: string;
45
- raw?: any;
46
- operation_results?: any[];
38
+ raw?: unknown;
39
+ operation_results?: unknown[];
47
40
  /** Transaction envelope returned by some daemon/API broadcast replies. */
48
41
  trx?: {
49
- operation_results?: any[];
50
- [key: string]: any;
42
+ operation_results?: unknown[];
43
+ [key: string]: unknown;
51
44
  } | null;
52
45
  /** Node reported by the daemon as in play at the failure (typed replies). */
53
46
  nodeUrl?: string | null;
54
47
  }
48
+ interface RequestPayload {
49
+ type: string;
50
+ accountName: string;
51
+ operations: unknown[];
52
+ sessionId?: string | null;
53
+ hmac?: string;
54
+ nodeUrl?: string;
55
+ }
55
56
  declare const DEFAULT_SOCKET_PATH: string;
56
57
  declare const DEFAULT_READY_FILE: string;
57
58
  declare const DEFAULT_BROADCAST_TIMEOUT_MS: number;
@@ -72,16 +73,16 @@ declare const DEFAULT_BROADCAST_TIMEOUT_MS: number;
72
73
  */
73
74
  declare class BroadcastUncertainError extends Error {
74
75
  code: string;
75
- operations: any[] | null;
76
+ operations: unknown[] | null;
76
77
  accountName: string | null;
77
78
  batchId: string | null;
78
- payload: any;
79
+ payload: unknown;
79
80
  timeoutMs: number | null;
80
81
  constructor(message: string, details?: BroadcastUncertainErrorDetails);
81
82
  }
82
- declare function sendCredentialDaemonRequest(socketPath: string, payload: any, timeoutMs: number, meta?: CredentialDaemonMeta): Promise<CredentialDaemonResponse>;
83
+ declare function sendCredentialDaemonRequest(socketPath: string, payload: RequestPayload, timeoutMs: number, meta?: CredentialDaemonMeta): Promise<CredentialDaemonResponse>;
83
84
  declare function isCredentialDaemonReady(options?: CredentialClientOptions): boolean;
84
85
  declare function waitForCredentialDaemon(timeoutMs?: number, options?: CredentialClientOptions): Promise<void>;
85
- declare function executeOperationsViaCredentialDaemon(accountName: string, operations: any[], options?: CredentialClientOptions): Promise<CredentialDaemonResponse>;
86
+ declare function executeOperationsViaCredentialDaemon(accountName: string, operations: unknown[], options?: CredentialClientOptions): Promise<CredentialDaemonResponse>;
86
87
  export { DEFAULT_READY_FILE, DEFAULT_SOCKET_PATH, DEFAULT_BROADCAST_TIMEOUT_MS, sendCredentialDaemonRequest, executeOperationsViaCredentialDaemon, isCredentialDaemonReady, waitForCredentialDaemon, BroadcastUncertainError };
87
88
  //# sourceMappingURL=dexbot_credential_client.d.ts.map
@@ -134,8 +134,7 @@ async function executeOperationsViaCredentialDaemon(accountName, operations, opt
134
134
  // (connect/send errors); an uncertain broadcast (RPC timeout, dropped
135
135
  // connection, 25s inner BROADCAST_DEADLINE) is never re-signed, and
136
136
  // re-sending the ops here is unsafe: an uncertain broadcast may have
137
- // landed, duplicating on-chain orders. `fallbackNodes` is kept for
138
- // interface compatibility but never cycled — the recovery layers (COW
137
+ // landed, duplicating on-chain orders. The recovery layers (COW
139
138
  // retry verification, startup adoption, broadcast reconciliation)
140
139
  // verify chain inclusion before any re-broadcast. onNodeFailed fires for
141
140
  // the node the daemon reports as actually in play (the daemon echoes it in
@@ -1,9 +1,19 @@
1
- /** Fill processing runtime - handles order fill events and replay-safe accounting */
1
+ import * as chainOrders from './chain_orders.js';
2
+ import type { BotLike, ManagerLogger, IncomingFill } from './types.js';
3
+ type ChainOrdersLike = typeof chainOrders;
4
+ export interface FillOpLike {
5
+ order_id?: string;
6
+ [key: string]: unknown;
7
+ }
8
+ type MissingKeyMessageFn = (op: FillOpLike, fill: unknown) => string;
9
+ type FallbackKeyMessageFn = (op: FillOpLike, fill: unknown, fillKey: string) => string;
10
+ export type ReplayMessageFn = (op: FillOpLike, fill: unknown, fillKey: string) => string;
11
+ type FillErrorFn = (op: FillOpLike, fill: unknown, err: unknown) => string;
2
12
  interface SweepOrphanFillOptions {
3
13
  context: string;
4
14
  label: string;
5
- logger?: any;
6
- replayMessage?: any;
15
+ logger?: Partial<ManagerLogger>;
16
+ replayMessage?: ReplayMessageFn;
7
17
  }
8
18
  /**
9
19
  * Handle a sweep fill whose grid order could not be resolved (orphan): derive a
@@ -23,8 +33,8 @@ interface SweepOrphanFillOptions {
23
33
  * @returns true when the fill was missing a replay-safe history identifier OR
24
34
  * the fill was deferred to the adoption sync (order still live on-chain).
25
35
  */
26
- declare function processSweepOrphanFill(bot: any, fill: any, fillOp: any, processedFillKeys: Set<any>, opts: SweepOrphanFillOptions): Promise<boolean>;
27
- declare function wireProcessedFillTracking(bot: any): void;
36
+ declare function processSweepOrphanFill(bot: BotLike, fill: unknown, fillOp: FillOpLike, processedFillKeys: Set<string>, opts: SweepOrphanFillOptions): Promise<boolean>;
37
+ declare function wireProcessedFillTracking(bot: BotLike): void;
28
38
  /**
29
39
  * Flush all pending processed fill writes to persistent storage.
30
40
  * @param {import('./dexbot_class.js').DEXBot} bot
@@ -32,7 +42,7 @@ declare function wireProcessedFillTracking(bot: any): void;
32
42
  * @param {Object} [options] - Flush options forwarded to ProcessedFillStore.flush
33
43
  * @returns {Promise<void>}
34
44
  */
35
- declare function flushProcessedFillPersistence(bot: any, reason?: any, options?: any): Promise<void>;
45
+ declare function flushProcessedFillPersistence(bot: BotLike, reason?: string, options?: Record<string, unknown>): Promise<void>;
36
46
  /**
37
47
  * Flush pending processed fill writes for specific fill keys.
38
48
  * @param {import('./dexbot_class.js').DEXBot} bot
@@ -41,21 +51,28 @@ declare function flushProcessedFillPersistence(bot: any, reason?: any, options?:
41
51
  * @param {Object} [options] - Flush options forwarded to ProcessedFillStore.flushKeys
42
52
  * @returns {Promise<void>}
43
53
  */
44
- declare function flushProcessedFillPersistenceForKeys(bot: any, fillKeys: any, reason?: any, options?: any): Promise<void>;
54
+ declare function flushProcessedFillPersistenceForKeys(bot: BotLike, fillKeys: string[] | Set<string>, reason?: string, options?: Record<string, unknown>): Promise<void>;
45
55
  /**
46
56
  * Build a degraded orphan fill replay key when the standard fill history id is missing.
47
57
  * The fallback key is derived from order_id, block_num, pays/receives amounts and asset IDs.
48
58
  * @param {import('./dexbot_class.js').DEXBot} bot
49
- * @param {any} fill - Raw fill event
59
+ * @param {unknown} fill - Raw fill event
50
60
  * @returns {string|null} Orphan fallback key or null if insufficient data
51
61
  */
52
- declare function buildOrphanFillFallbackKey(bot: any, fill: any): string | null;
62
+ export interface FillLike {
63
+ op?: unknown[];
64
+ block_num?: unknown;
65
+ trx_in_block?: unknown;
66
+ op_in_trx?: unknown;
67
+ [key: string]: unknown;
68
+ }
69
+ declare function buildOrphanFillFallbackKey(bot: BotLike, fill: FillLike): string | null;
53
70
  /**
54
71
  * Apply fill accounting with replay-safe deduplication.
55
72
  * Prevents the same fill from being accounted twice across restarts or re-syncs.
56
73
  * @param {import('./dexbot_class.js').DEXBot} bot
57
- * @param {any} fill - Raw fill event
58
- * @param {any} fillOp - Extracted fill operation data
74
+ * @param {unknown} fill - Raw fill event
75
+ * @param {unknown} fillOp - Extracted fill operation data
59
76
  * @param {Object} [options] - Options
60
77
  * @param {Function} [options.missingKeyMessage] - Callback to generate log message when fill key is missing
61
78
  * @param {Function} [options.fallbackKeyMessage] - Callback to generate log message when fallback key is used
@@ -69,16 +86,16 @@ declare function buildOrphanFillFallbackKey(bot: any, fill: any): string | null;
69
86
  * @param {boolean} [options.allowOrphanFallbackKey=false] - Allow degraded orphan fallback key
70
87
  * @returns {Promise<any>}
71
88
  */
72
- declare function applyReplaySafeFillAccounting(bot: any, fill: any, fillOp: any, { missingKeyMessage, fallbackKeyMessage, replayMessage, errorMessage, logger, missingKeyLevel, fallbackKeyLevel, replayLevel, persistenceMode, allowOrphanFallbackKey }?: {
73
- missingKeyMessage?: any;
74
- fallbackKeyMessage?: any;
75
- replayMessage?: any;
76
- errorMessage?: any;
77
- logger?: any;
89
+ declare function applyReplaySafeFillAccounting(bot: BotLike, fill: unknown, fillOp: FillOpLike, { missingKeyMessage, fallbackKeyMessage, replayMessage, errorMessage, logger, missingKeyLevel, fallbackKeyLevel, replayLevel, persistenceMode, allowOrphanFallbackKey }?: {
90
+ missingKeyMessage?: MissingKeyMessageFn;
91
+ fallbackKeyMessage?: FallbackKeyMessageFn;
92
+ replayMessage?: ReplayMessageFn;
93
+ errorMessage?: FillErrorFn;
94
+ logger?: Partial<ManagerLogger>;
78
95
  missingKeyLevel?: string;
79
96
  fallbackKeyLevel?: string;
80
97
  replayLevel?: string;
81
- persistenceMode?: any;
98
+ persistenceMode?: string;
82
99
  allowOrphanFallbackKey?: boolean;
83
100
  }): Promise<{
84
101
  status: string;
@@ -93,15 +110,22 @@ declare function applyReplaySafeFillAccounting(bot: any, fill: any, fillOp: any,
93
110
  } | {
94
111
  status: string;
95
112
  fillKey: any;
96
- error: any;
113
+ error: unknown;
97
114
  usedFallbackKey?: undefined;
98
115
  }>;
116
+ /** Shared options for the replay-safe accounting wrappers. */
117
+ export interface ReplaySafeFillAccountingOptions {
118
+ context?: string;
119
+ logger?: Partial<ManagerLogger>;
120
+ replayMessage?: ReplayMessageFn;
121
+ persistenceMode?: string;
122
+ }
99
123
  /**
100
124
  * Apply replay-safe fill accounting for tracked fills (with fill history id).
101
125
  * Wraps applyReplaySafeFillAccounting with context and default message builders.
102
126
  * @param {import('./dexbot_class.js').DEXBot} bot
103
- * @param {any} fill - Raw fill event
104
- * @param {any} fillOp - Extracted fill operation data
127
+ * @param {unknown} fill - Raw fill event
128
+ * @param {unknown} fillOp - Extracted fill operation data
105
129
  * @param {Object} [options] - Options
106
130
  * @param {string} [options.context] - Context label for log messages
107
131
  * @param {Object} [options.logger] - Logger instance
@@ -109,12 +133,7 @@ declare function applyReplaySafeFillAccounting(bot: any, fill: any, fillOp: any,
109
133
  * @param {string} [options.persistenceMode='batched'] - Processed fill persistence mode
110
134
  * @returns {Promise<any>}
111
135
  */
112
- declare function applyReplaySafeTrackedFillAccounting(bot: any, fill: any, fillOp: any, { context, logger, replayMessage, persistenceMode }?: {
113
- context?: string;
114
- logger?: any;
115
- replayMessage?: any;
116
- persistenceMode?: any;
117
- }): Promise<{
136
+ declare function applyReplaySafeTrackedFillAccounting(bot: BotLike, fill: unknown, fillOp: FillOpLike, options?: ReplaySafeFillAccountingOptions): Promise<{
118
137
  status: string;
119
138
  fillKey: any;
120
139
  usedFallbackKey?: undefined;
@@ -127,15 +146,15 @@ declare function applyReplaySafeTrackedFillAccounting(bot: any, fill: any, fillO
127
146
  } | {
128
147
  status: string;
129
148
  fillKey: any;
130
- error: any;
149
+ error: unknown;
131
150
  usedFallbackKey?: undefined;
132
151
  }>;
133
152
  /**
134
153
  * Apply replay-safe fill accounting for orphan fills (missing fill history id).
135
154
  * Uses a degraded orphan fallback key when the standard key is unavailable.
136
155
  * @param {import('./dexbot_class.js').DEXBot} bot
137
- * @param {any} fill - Raw fill event
138
- * @param {any} fillOp - Extracted fill operation data
156
+ * @param {unknown} fill - Raw fill event
157
+ * @param {unknown} fillOp - Extracted fill operation data
139
158
  * @param {Object} [options] - Options
140
159
  * @param {string} [options.context] - Context label for log messages
141
160
  * @param {Object} [options.logger] - Logger instance
@@ -143,12 +162,7 @@ declare function applyReplaySafeTrackedFillAccounting(bot: any, fill: any, fillO
143
162
  * @param {string} [options.persistenceMode='batched'] - Processed fill persistence mode
144
163
  * @returns {Promise<any>}
145
164
  */
146
- declare function applyReplaySafeOrphanFillAccounting(bot: any, fill: any, fillOp: any, { context, logger, replayMessage, persistenceMode }?: {
147
- context?: string;
148
- logger?: any;
149
- replayMessage?: any;
150
- persistenceMode?: any;
151
- }): Promise<{
165
+ declare function applyReplaySafeOrphanFillAccounting(bot: BotLike, fill: unknown, fillOp: FillOpLike, options?: ReplaySafeFillAccountingOptions): Promise<{
152
166
  status: string;
153
167
  fillKey: any;
154
168
  usedFallbackKey?: undefined;
@@ -161,7 +175,7 @@ declare function applyReplaySafeOrphanFillAccounting(bot: any, fill: any, fillOp
161
175
  } | {
162
176
  status: string;
163
177
  fillKey: any;
164
- error: any;
178
+ error: unknown;
165
179
  usedFallbackKey?: undefined;
166
180
  }>;
167
181
  /**
@@ -171,7 +185,7 @@ declare function applyReplaySafeOrphanFillAccounting(bot: any, fill: any, fillOp
171
185
  * @param {Object} chainOrders - Chain orders module
172
186
  * @returns {Function} Async callback function accepting an array of fill events
173
187
  */
174
- declare function createFillCallback(bot: any, chainOrders: any): (fills: any) => Promise<void>;
188
+ declare function createFillCallback(bot: BotLike, chainOrders: ChainOrdersLike): (fills: IncomingFill[]) => Promise<void>;
175
189
  /**
176
190
  * Consume the deferred-drain marker at the start of a fill cycle.
177
191
  *
@@ -182,10 +196,10 @@ declare function createFillCallback(bot: any, chainOrders: any): (fills: any) =>
182
196
  * manager._orphanFillsCreditedAt so the fund-invariant tolerance is widened
183
197
  * (×5) for this cycle only — the drain itself must not trip the invariant.
184
198
  * Idempotent: returns true only when a marker was actually consumed.
185
- * @param {any} bot
199
+ * @param {unknown} bot
186
200
  * @returns {boolean} true when the drain marker was consumed (tolerance widened)
187
201
  */
188
- export declare function consumeDeferredDrainMarker(bot: any): boolean;
202
+ export declare function consumeDeferredDrainMarker(bot: BotLike): boolean;
189
203
  /**
190
204
  * Decide whether the fill consumer must defer because a broadcast region is
191
205
  * active — WITHOUT acquiring _fillProcessingLock first.
@@ -213,7 +227,7 @@ export declare function consumeDeferredDrainMarker(bot: any): boolean;
213
227
  * @returns {{ defer: boolean; stuckFallback: boolean }} defer=true means the
214
228
  * caller must return without acquiring the lock.
215
229
  */
216
- declare function shouldDeferFillForBroadcast(bot: any, nowMs?: number): {
230
+ declare function shouldDeferFillForBroadcast(bot: BotLike, nowMs?: number): {
217
231
  defer: boolean;
218
232
  stuckFallback: boolean;
219
233
  };
@@ -224,7 +238,7 @@ declare function shouldDeferFillForBroadcast(bot: any, nowMs?: number): {
224
238
  * @param {import('./dexbot_class.js').DEXBot} bot
225
239
  * @param {Object} chainOrders - Chain orders module
226
240
  */
227
- declare function scheduleFillConsumerRestart(bot: any, chainOrders: any): void;
241
+ declare function scheduleFillConsumerRestart(bot: BotLike, chainOrders: ChainOrdersLike): void;
228
242
  /**
229
243
  * Level-triggered retry for fills parked by consumeFillQueue's pre-lock
230
244
  * gates (order-pipeline or broadcast deferral).
@@ -243,13 +257,13 @@ declare function scheduleFillConsumerRestart(bot: any, chainOrders: any): void;
243
257
  * drains; once drained the timer settles. At most one retry is pending per
244
258
  * bot. The timer is unref'd so a parked queue never holds the process open
245
259
  * (and fakes that never clear the gate cannot hang the test runner).
246
- * @param {any} bot
260
+ * @param {unknown} bot
247
261
  * @param {Object} chainOrders - Chain orders module for blockchain operations
248
262
  * @param {string} reason - Gate label for logging
249
263
  * @param {Object} [options]
250
264
  * @param {number} [options.retryDelayMs] - Override the derived backoff (tests)
251
265
  */
252
- declare function scheduleDeferredFillRetry(bot: any, chainOrders: any, reason: string, options?: {
266
+ declare function scheduleDeferredFillRetry(bot: BotLike, chainOrders: ChainOrdersLike, reason: string, options?: {
253
267
  retryDelayMs?: number;
254
268
  }): void;
255
269
  /**
@@ -259,7 +273,7 @@ declare function scheduleDeferredFillRetry(bot: any, chainOrders: any, reason: s
259
273
  * @param {Object} chainOrders - Chain orders module for blockchain operations
260
274
  * @returns {Promise<void>}
261
275
  */
262
- declare function processFillsWithBootstrapMode(bot: any, chainOrders: any): Promise<void>;
276
+ declare function processFillsWithBootstrapMode(bot: BotLike, chainOrders: ChainOrdersLike): Promise<void>;
263
277
  /**
264
278
  * Park fills deferred on a stale accountTotals refresh for a bounded retry.
265
279
  *
@@ -276,13 +290,13 @@ declare function processFillsWithBootstrapMode(bot: any, chainOrders: any): Prom
276
290
  * released. Retries never stop (attempt counter resets on the first cycle
277
291
  * with no deferrals); the parked array is capped at MAX_INCOMING_FILL_QUEUE
278
292
  * with a critical log as a catastrophic backstop.
279
- * @param {any} bot
293
+ * @param {unknown} bot
280
294
  * @param {Object} chainOrders - Chain orders module for blockchain operations
281
- * @param {any[]} fills - Raw fill events to park
295
+ * @param {unknown[]} fills - Raw fill events to park
282
296
  * @param {Object} [options]
283
297
  * @param {number} [options.retryDelayMs] - Override the computed backoff (tests)
284
298
  */
285
- export declare function parkFillsForTotalsRetry(bot: any, chainOrders: any, fills: any[], options?: {
299
+ export declare function parkFillsForTotalsRetry(bot: BotLike, chainOrders: ChainOrdersLike, fills: unknown[], options?: {
286
300
  retryDelayMs?: number;
287
301
  }): void;
288
302
  /**
@@ -294,6 +308,6 @@ export declare function parkFillsForTotalsRetry(bot: any, chainOrders: any, fill
294
308
  * @param {import('./dexbot_class.js').DEXBot} bot
295
309
  * @param {Object} chainOrders - Chain orders module for blockchain operations
296
310
  */
297
- declare function consumeFillQueue(bot: any, chainOrders: any): Promise<void>;
311
+ declare function consumeFillQueue(bot: BotLike, chainOrders: ChainOrdersLike): Promise<void>;
298
312
  export { wireProcessedFillTracking, flushProcessedFillPersistence, flushProcessedFillPersistenceForKeys, buildOrphanFillFallbackKey, applyReplaySafeFillAccounting, applyReplaySafeTrackedFillAccounting, applyReplaySafeOrphanFillAccounting, processSweepOrphanFill, createFillCallback, scheduleFillConsumerRestart, scheduleDeferredFillRetry, shouldDeferFillForBroadcast, consumeFillQueue, processFillsWithBootstrapMode };
299
313
  //# sourceMappingURL=dexbot_fill_runtime.d.ts.map
@@ -1,17 +1,16 @@
1
1
  /** Fill processing runtime - handles order fill events and replay-safe accounting */
2
- import { createRequire } from 'node:module';
3
- const require = createRequire(import.meta.url);
2
+ import { lazyShim } from './lazy_shim.js';
4
3
  import * as chainOrders from './chain_orders.js';
5
4
  import { PROCESSED_FILL_PERSISTENCE_MODES } from './order/processed_fill_store.js';
6
5
  import { NATIVE_CLIENT, FILL_PROCESSING, TIMING, MAINTENANCE, ORDER_TYPES } from './constants.js';
7
- import { getErrorMessage, resolveSeamMsOrNull } from './utils/errors.js';
6
+ import { getErrorMessage, resolveSeamMsOrNull, getErrorField } from './utils/errors.js';
8
7
  import { isOrderDoesNotExistError } from './dexbot_maintenance_runtime.js';
9
8
  import { slotIndexForPrice, isChainPriceOutOfGrid, isSlotInRail } from './order/utils/math.js';
10
9
  import { ORDER_STATES } from './constants.js';
11
- function buildFillKey(...args) { return require('./order/utils/order').buildFillKey(...args); }
12
- function correctAllPriceMismatches(...args) { return require('./order/utils/order').correctAllPriceMismatches(...args); }
13
- function parseChainOrder(...args) { return require('./order/utils/order').parseChainOrder(...args); }
14
- function retryPersistenceIfNeeded(...args) { return require('./order/utils/system').retryPersistenceIfNeeded(...args); }
10
+ const buildFillKey = lazyShim('./order/utils/order', 'buildFillKey');
11
+ const correctAllPriceMismatches = lazyShim('./order/utils/order', 'correctAllPriceMismatches');
12
+ const parseChainOrder = lazyShim('./order/utils/order', 'parseChainOrder');
13
+ const retryPersistenceIfNeeded = lazyShim('./order/utils/system', 'retryPersistenceIfNeeded');
15
14
  const { readOpenOrdersGuarded } = chainOrders;
16
15
  /**
17
16
  * Whether an unknown fill's order plausibly belongs to THIS bot's grid and
@@ -21,7 +20,7 @@ const { readOpenOrdersGuarded } = chainOrders;
21
20
  * orders on shared accounts or other markets, which keep the legacy
22
21
  * credit-as-orphan path.
23
22
  * @param {import('./dexbot_class.js').DEXBot} bot
24
- * @param {any} fillOp - Fill operation ({order_id, ...})
23
+ * @param {unknown} fillOp - Fill operation ({order_id, ...})
25
24
  * @returns {Promise<boolean>} True when the order is live and in-grid-range
26
25
  */
27
26
  async function isUnknownFillOrderAdoptable(bot, fillOp) {
@@ -82,7 +81,7 @@ async function isUnknownFillOrderAdoptable(bot, fillOp) {
82
81
  }
83
82
  let minPrice = Infinity;
84
83
  let maxPrice = 0;
85
- for (const o of (bot.manager?.orders?.values?.() ?? [])) {
84
+ for (const o of Array.from(bot.manager?.orders?.values?.() ?? [])) {
86
85
  const p = Number(o?.price);
87
86
  if (!Number.isFinite(p) || p <= 0)
88
87
  continue;
@@ -128,7 +127,7 @@ async function processSweepOrphanFill(bot, fill, fillOp, processedFillKeys, opts
128
127
  return false;
129
128
  }
130
129
  if (await isUnknownFillOrderAdoptable(bot, fillOp)) {
131
- (opts.logger ?? bot.manager.logger).log(`[${opts.label}] Unknown order ${fillOp.order_id} is LIVE on-chain inside grid range — deferring proceeds credit to adoption sync`, 'warn');
130
+ (opts.logger ?? bot.manager.logger).log?.(`[${opts.label}] Unknown order ${fillOp.order_id} is LIVE on-chain inside grid range — deferring proceeds credit to adoption sync`, 'warn');
132
131
  // Release the dedupe key consumed by _isNewFillKey so the fill can be
133
132
  // re-processed against the adopted slot after the sync runs.
134
133
  if (orphanFillKey) {
@@ -137,7 +136,7 @@ async function processSweepOrphanFill(bot, fill, fillOp, processedFillKeys, opts
137
136
  }
138
137
  return true;
139
138
  }
140
- (opts.logger ?? bot.manager.logger).log(`[${opts.label}] Processing funds for unknown order ${fillOp.order_id} (not in grid but crediting proceeds)`, 'warn');
139
+ (opts.logger ?? bot.manager.logger).log?.(`[${opts.label}] Processing funds for unknown order ${fillOp.order_id} (not in grid but crediting proceeds)`, 'warn');
141
140
  const accountingResult = await bot._applyReplaySafeOrphanFillAccounting(fill, fillOp, {
142
141
  context: opts.context,
143
142
  logger: opts.logger,
@@ -208,21 +207,16 @@ async function flushProcessedFillPersistenceForKeys(bot, fillKeys, reason = 'man
208
207
  bot._processedFillStore.setShuttingDown(bot._shuttingDown);
209
208
  await bot._processedFillStore.flushKeys(fillKeys, reason, options);
210
209
  }
211
- /**
212
- * Build a degraded orphan fill replay key when the standard fill history id is missing.
213
- * The fallback key is derived from order_id, block_num, pays/receives amounts and asset IDs.
214
- * @param {import('./dexbot_class.js').DEXBot} bot
215
- * @param {any} fill - Raw fill event
216
- * @returns {string|null} Orphan fallback key or null if insufficient data
217
- */
218
210
  function buildOrphanFillFallbackKey(bot, fill) {
219
211
  const fillOp = fill?.op?.[1];
220
212
  const orderId = fillOp?.order_id;
221
213
  const blockNum = fill?.block_num;
222
- const paysAssetId = fillOp?.pays?.asset_id;
223
- const paysAmount = fillOp?.pays?.amount;
224
- const receivesAssetId = fillOp?.receives?.asset_id;
225
- const receivesAmount = fillOp?.receives?.amount;
214
+ const pays = fillOp?.pays;
215
+ const receives = fillOp?.receives;
216
+ const paysAssetId = pays?.asset_id;
217
+ const paysAmount = pays?.amount;
218
+ const receivesAssetId = receives?.asset_id;
219
+ const receivesAmount = receives?.amount;
226
220
  if (fillOp?.is_maker == null) {
227
221
  bot?._warn?.(`[ORPHAN-FALLBACK] is_maker undefined for fill ${fillOp?.order_id}; defaulting to 'maker' for dedup key`);
228
222
  }
@@ -242,8 +236,8 @@ function buildOrphanFillFallbackKey(bot, fill) {
242
236
  * Apply fill accounting with replay-safe deduplication.
243
237
  * Prevents the same fill from being accounted twice across restarts or re-syncs.
244
238
  * @param {import('./dexbot_class.js').DEXBot} bot
245
- * @param {any} fill - Raw fill event
246
- * @param {any} fillOp - Extracted fill operation data
239
+ * @param {unknown} fill - Raw fill event
240
+ * @param {unknown} fillOp - Extracted fill operation data
247
241
  * @param {Object} [options] - Options
248
242
  * @param {Function} [options.missingKeyMessage] - Callback to generate log message when fill key is missing
249
243
  * @param {Function} [options.fallbackKeyMessage] - Callback to generate log message when fallback key is used
@@ -291,12 +285,20 @@ async function applyReplaySafeFillAccounting(bot, fill, fillOp, { missingKeyMess
291
285
  throw err;
292
286
  }
293
287
  }
288
+ /**
289
+ * Resolve wrapper options with shared defaults (logger falls back to the
290
+ * manager's logger, persistence mode to batched). Centralized so both
291
+ * wrappers apply identical defaults.
292
+ */
293
+ function resolveReplaySafeFillOptions(bot, { context, logger = bot.manager?.logger, replayMessage, persistenceMode = PROCESSED_FILL_PERSISTENCE_MODES.BATCHED, } = {}) {
294
+ return { context, logger, replayMessage, persistenceMode };
295
+ }
294
296
  /**
295
297
  * Apply replay-safe fill accounting for tracked fills (with fill history id).
296
298
  * Wraps applyReplaySafeFillAccounting with context and default message builders.
297
299
  * @param {import('./dexbot_class.js').DEXBot} bot
298
- * @param {any} fill - Raw fill event
299
- * @param {any} fillOp - Extracted fill operation data
300
+ * @param {unknown} fill - Raw fill event
301
+ * @param {unknown} fillOp - Extracted fill operation data
300
302
  * @param {Object} [options] - Options
301
303
  * @param {string} [options.context] - Context label for log messages
302
304
  * @param {Object} [options.logger] - Logger instance
@@ -304,7 +306,8 @@ async function applyReplaySafeFillAccounting(bot, fill, fillOp, { missingKeyMess
304
306
  * @param {string} [options.persistenceMode='batched'] - Processed fill persistence mode
305
307
  * @returns {Promise<any>}
306
308
  */
307
- async function applyReplaySafeTrackedFillAccounting(bot, fill, fillOp, { context, logger = bot.manager?.logger, replayMessage, persistenceMode = PROCESSED_FILL_PERSISTENCE_MODES.BATCHED } = {}) {
309
+ async function applyReplaySafeTrackedFillAccounting(bot, fill, fillOp, options = {}) {
310
+ const { context, logger, replayMessage, persistenceMode } = resolveReplaySafeFillOptions(bot, options);
308
311
  return applyReplaySafeFillAccounting(bot, fill, fillOp, {
309
312
  logger,
310
313
  missingKeyMessage: (op) => `[${context}] Missing fill history id for ${op.order_id}; deferring to open-orders sync`,
@@ -317,8 +320,8 @@ async function applyReplaySafeTrackedFillAccounting(bot, fill, fillOp, { context
317
320
  * Apply replay-safe fill accounting for orphan fills (missing fill history id).
318
321
  * Uses a degraded orphan fallback key when the standard key is unavailable.
319
322
  * @param {import('./dexbot_class.js').DEXBot} bot
320
- * @param {any} fill - Raw fill event
321
- * @param {any} fillOp - Extracted fill operation data
323
+ * @param {unknown} fill - Raw fill event
324
+ * @param {unknown} fillOp - Extracted fill operation data
322
325
  * @param {Object} [options] - Options
323
326
  * @param {string} [options.context] - Context label for log messages
324
327
  * @param {Object} [options.logger] - Logger instance
@@ -326,7 +329,8 @@ async function applyReplaySafeTrackedFillAccounting(bot, fill, fillOp, { context
326
329
  * @param {string} [options.persistenceMode='batched'] - Processed fill persistence mode
327
330
  * @returns {Promise<any>}
328
331
  */
329
- async function applyReplaySafeOrphanFillAccounting(bot, fill, fillOp, { context, logger = bot.manager?.logger, replayMessage, persistenceMode = PROCESSED_FILL_PERSISTENCE_MODES.BATCHED } = {}) {
332
+ async function applyReplaySafeOrphanFillAccounting(bot, fill, fillOp, options = {}) {
333
+ const { context, logger, replayMessage, persistenceMode } = resolveReplaySafeFillOptions(bot, options);
330
334
  return applyReplaySafeFillAccounting(bot, fill, fillOp, {
331
335
  logger,
332
336
  missingKeyMessage: (op) => `[${context}] Missing fill history id and orphan fallback key for ${op.order_id}; deferring to open-orders sync`,
@@ -383,8 +387,8 @@ function maxConsecutiveFillConsumerFailures(bot) {
383
387
  */
384
388
  function computeFillConsumerBackoffMs(bot, failures) {
385
389
  const fp = bot.config.fillProcessing || FILL_PROCESSING;
386
- const initial = fp.CONSUMER_BACKOFF_INITIAL_MS;
387
- const max = fp.CONSUMER_BACKOFF_MAX_MS;
390
+ const initial = fp.CONSUMER_BACKOFF_INITIAL_MS ?? FILL_PROCESSING.CONSUMER_BACKOFF_INITIAL_MS;
391
+ const max = fp.CONSUMER_BACKOFF_MAX_MS ?? FILL_PROCESSING.CONSUMER_BACKOFF_MAX_MS;
388
392
  const stepAfterMax = Math.max(0, failures - maxConsecutiveFillConsumerFailures(bot));
389
393
  return Math.min(max, initial * Math.pow(2, stepAfterMax));
390
394
  }
@@ -398,7 +402,7 @@ function computeFillConsumerBackoffMs(bot, failures) {
398
402
  * manager._orphanFillsCreditedAt so the fund-invariant tolerance is widened
399
403
  * (×5) for this cycle only — the drain itself must not trip the invariant.
400
404
  * Idempotent: returns true only when a marker was actually consumed.
401
- * @param {any} bot
405
+ * @param {unknown} bot
402
406
  * @returns {boolean} true when the drain marker was consumed (tolerance widened)
403
407
  */
404
408
  export function consumeDeferredDrainMarker(bot) {
@@ -554,7 +558,7 @@ function scheduleFillConsumerRestart(bot, chainOrders) {
554
558
  * drains; once drained the timer settles. At most one retry is pending per
555
559
  * bot. The timer is unref'd so a parked queue never holds the process open
556
560
  * (and fakes that never clear the gate cannot hang the test runner).
557
- * @param {any} bot
561
+ * @param {unknown} bot
558
562
  * @param {Object} chainOrders - Chain orders module for blockchain operations
559
563
  * @param {string} reason - Gate label for logging
560
564
  * @param {Object} [options]
@@ -639,7 +643,7 @@ async function processFillsWithBootstrapMode(bot, chainOrders) {
639
643
  continue;
640
644
  const fillOp = fill.op[1];
641
645
  const gridOrder = bot.manager.orders.get(fillOp.order_id) ||
642
- Array.from(bot.manager.orders.values()).find((o) => o.orderId === fillOp.order_id);
646
+ (Array.from(bot.manager.orders.values())).find((o) => o.orderId === fillOp.order_id);
643
647
  if (!gridOrder) {
644
648
  if (await processSweepOrphanFill(bot, fill, fillOp, processedFillKeys, { context: 'BOOTSTRAP', label: 'BOOTSTRAP' })) {
645
649
  requiresOpenOrdersSync = true;
@@ -722,9 +726,9 @@ async function processFillsWithBootstrapMode(bot, chainOrders) {
722
726
  * re-queued fill is skipped as a duplicate within _fillDedupeWindowMs — the
723
727
  * deferral would credit nothing AND poison the retry. Mirrors the
724
728
  * orphan-adoption release in processSweepOrphanFill.
725
- * @param {any} bot
729
+ * @param {unknown} bot
726
730
  * @param {Set<any>} processedFillKeys - Per-cycle key set to release from
727
- * @param {any[]} fills - Raw fill events whose keys were consumed
731
+ * @param {unknown[]} fills - Raw fill events whose keys were consumed
728
732
  */
729
733
  function releaseFillDedupeKeys(bot, processedFillKeys, fills) {
730
734
  if (!bot || !processedFillKeys || !Array.isArray(fills))
@@ -756,9 +760,9 @@ function releaseFillDedupeKeys(bot, processedFillKeys, fills) {
756
760
  * released. Retries never stop (attempt counter resets on the first cycle
757
761
  * with no deferrals); the parked array is capped at MAX_INCOMING_FILL_QUEUE
758
762
  * with a critical log as a catastrophic backstop.
759
- * @param {any} bot
763
+ * @param {unknown} bot
760
764
  * @param {Object} chainOrders - Chain orders module for blockchain operations
761
- * @param {any[]} fills - Raw fill events to park
765
+ * @param {unknown[]} fills - Raw fill events to park
762
766
  * @param {Object} [options]
763
767
  * @param {number} [options.retryDelayMs] - Override the computed backoff (tests)
764
768
  */
@@ -768,7 +772,7 @@ export function parkFillsForTotalsRetry(bot, chainOrders, fills, options = {}) {
768
772
  if (!Array.isArray(bot._fillTotalsParkedFills))
769
773
  bot._fillTotalsParkedFills = [];
770
774
  const parked = bot._fillTotalsParkedFills;
771
- const maxParked = Number(NATIVE_CLIENT?.SUBSCRIPTIONS?.MAX_INCOMING_FILL_QUEUE) > 0
775
+ const maxParked = Number(NATIVE_CLIENT.SUBSCRIPTIONS.MAX_INCOMING_FILL_QUEUE) > 0
772
776
  ? Number(NATIVE_CLIENT.SUBSCRIPTIONS.MAX_INCOMING_FILL_QUEUE)
773
777
  : 1000;
774
778
  if (parked.length + fills.length > maxParked) {
@@ -987,7 +991,7 @@ async function consumeFillQueue(bot, chainOrders) {
987
991
  continue;
988
992
  }
989
993
  const gridOrder = bot.manager.orders.get(fillOp.order_id) ||
990
- Array.from(bot.manager.orders.values()).find((o) => o.orderId === fillOp.order_id);
994
+ (Array.from(bot.manager.orders.values())).find((o) => o.orderId === fillOp.order_id);
991
995
  if (!gridOrder) {
992
996
  const staleMarkedAt = bot._staleCleanedOrderIds.get(fillOp.order_id);
993
997
  if (staleMarkedAt != null) {
@@ -1020,7 +1024,7 @@ async function consumeFillQueue(bot, chainOrders) {
1020
1024
  if (!bot._isNewFillKey(fillKey, processedFillKeys, '[FILL]', fillOp.order_id)) {
1021
1025
  continue;
1022
1026
  }
1023
- validFills.push(fill);
1027
+ validFills.push({ ...fill, gridOrder });
1024
1028
  const paysAmount = fillOp.pays ? fillOp.pays.amount : '?';
1025
1029
  const receivesAmount = fillOp.receives ? fillOp.receives.amount : '?';
1026
1030
  // Asset IDs are logged alongside the raw satoshi amounts so
@@ -1164,8 +1168,9 @@ async function consumeFillQueue(bot, chainOrders) {
1164
1168
  const initialRequiresSync = requiresOpenOrdersSync;
1165
1169
  for (const blockNum of sortedBlocks) {
1166
1170
  requiresOpenOrdersSync = false;
1167
- bot.manager.logger.log(`[FILL-BLOCK] Processing ${fillsByBlock.get(blockNum).length} fill(s) from block ${blockNum}`, 'debug');
1168
- const blockResult = await processValidFills(fillsByBlock.get(blockNum));
1171
+ const blockFills = fillsByBlock.get(blockNum) ?? [];
1172
+ bot.manager.logger.log(`[FILL-BLOCK] Processing ${blockFills.length} fill(s) from block ${blockNum}`, 'debug');
1173
+ const blockResult = await processValidFills(blockFills);
1169
1174
  accumulatedOrders.push(...blockResult);
1170
1175
  if (requiresOpenOrdersSync)
1171
1176
  anyRequiresSync = true;
@@ -1278,7 +1283,7 @@ async function consumeFillQueue(bot, chainOrders) {
1278
1283
  : 100;
1279
1284
  if (bot._fillCleanupCounter >= cleanupThreshold) {
1280
1285
  try {
1281
- await bot.accountOrders.cleanOldProcessedFills(TIMING.FILL_RECORD_RETENTION_MS);
1286
+ await bot.accountOrders?.cleanOldProcessedFills(TIMING.FILL_RECORD_RETENTION_MS);
1282
1287
  bot._fillCleanupCounter = 0;
1283
1288
  }
1284
1289
  catch (err) {
@@ -1336,8 +1341,9 @@ async function consumeFillQueue(bot, chainOrders) {
1336
1341
  bot._suspendGridPersistenceForCredentialOutage(`credential outage during fill processing: ${getErrorMessage(err)}`);
1337
1342
  }
1338
1343
  bot._log(`Error processing fills: ${getErrorMessage(err)}`, 'error');
1339
- if (err.stack)
1340
- bot._log(err.stack, 'error');
1344
+ const errorStack = getErrorField(err, 'stack');
1345
+ if (errorStack)
1346
+ bot._log(errorStack, 'error');
1341
1347
  }
1342
1348
  // Clean settle: a drain that reached the end with an empty queue is the
1343
1349
  // only place the retry counter is retired — otherwise the elevated count