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
@@ -70,6 +70,22 @@
70
70
  *
71
71
  * ===============================================================================
72
72
  */
73
+ import type { OrderManagerLike, ManagedOrder, ChainOrder, FundDriftCheck } from '../types.js';
74
+ interface FillPaysReceives {
75
+ asset_id?: string;
76
+ amount: number | string;
77
+ }
78
+ interface FillOperation {
79
+ pays?: FillPaysReceives;
80
+ receives?: FillPaysReceives;
81
+ is_maker?: boolean;
82
+ order_id?: string;
83
+ [key: string]: unknown;
84
+ }
85
+ interface FillAccountingOptions {
86
+ persistenceMode?: string;
87
+ [key: string]: unknown;
88
+ }
73
89
  /**
74
90
  * Accountant engine - Specialized handler for fund tracking and calculations
75
91
  * @class Accountant
@@ -84,42 +100,52 @@ declare class Accountant {
84
100
  * @param {Object} manager.funds - Fund tracking structure
85
101
  * @param {Logger} manager.logger - Logger instance
86
102
  */
87
- manager: any;
103
+ manager: OrderManagerLike;
88
104
  _isVerifyingInvariants: boolean;
89
105
  _pendingInvariantSnapshot: {
90
106
  chainFreeBuy: number;
91
107
  chainFreeSell: number;
92
108
  chainBuy: number;
93
109
  chainSell: number;
110
+ actualBuy?: number | null;
111
+ actualSell?: number | null;
94
112
  } | null;
95
113
  _logThrottleState: Map<string, {
96
114
  lastAt: number;
97
115
  suppressed: number;
98
116
  }>;
99
- constructor(manager: any);
100
- _logThrottled(key: any, message: any, level?: any, intervalMs?: any): boolean;
117
+ constructor(manager: OrderManagerLike);
118
+ _logThrottled(key: string, message: string, level?: string, intervalMs?: number): boolean;
101
119
  /**
102
120
  * Apply a list of balance adjustments.
103
121
  * @param {Array<{orderType: string, delta: number, operation: string}>} balanceAdjustments
104
122
  * @returns {void}
105
123
  */
106
- _applyBalanceAdjustments(balanceAdjustments: any): Promise<void>;
124
+ _applyBalanceAdjustments(balanceAdjustments: Array<{
125
+ orderType: string | null | undefined;
126
+ delta: number;
127
+ operation: string;
128
+ }>): Promise<void>;
107
129
  _getBtsOrderType(): string | null;
108
- _normalizeBtsFeeState(order: any): {
130
+ _normalizeBtsFeeState(order: Partial<ManagedOrder> | null | undefined): {
109
131
  deferredFee: number;
110
132
  };
111
133
  _getBtsFeeSchedule(): {
112
134
  createFee: number;
113
135
  updateFee: number;
114
136
  cancelFee: number;
115
- makerFeeDiscountPercent: any;
137
+ makerFeeDiscountPercent: number;
116
138
  };
117
- _calculateUpdateDeferredCharge(oldDeferredFee: any, feeSchedule: any): number;
118
- _resolveBtsFeeLifecycle(oldOrder: any, newOrder: any, context: any, explicitFee: any): {
139
+ _calculateUpdateDeferredCharge(oldDeferredFee: number, feeSchedule: {
140
+ cancelFee?: number;
141
+ createFee?: number;
142
+ updateFee?: number;
143
+ } | null): number;
144
+ _resolveBtsFeeLifecycle(oldOrder: Partial<ManagedOrder> | null, newOrder: Partial<ManagedOrder> | null, context: string, explicitFee: number): {
119
145
  balanceDelta: number;
120
146
  nextDeferred: number;
121
147
  };
122
- _buildBtsDeferredRefundAdjustment(orderId: any, isMaker: any): {
148
+ _buildBtsDeferredRefundAdjustment(orderId: string | null | undefined, isMaker: boolean): {
123
149
  orderType: string;
124
150
  delta: number;
125
151
  operation: string;
@@ -177,7 +203,7 @@ declare class Accountant {
177
203
  * @returns {void}
178
204
  * @private
179
205
  */
180
- _verifyFundInvariants(mgr: any, chainFreeBuy: any, chainFreeSell: any, chainBuy: any, chainSell: any, actualBuy: any, actualSell: any): Promise<void>;
206
+ _verifyFundInvariants(mgr: OrderManagerLike, chainFreeBuy: number, chainFreeSell: number, chainBuy: number, chainSell: number, actualBuy: number | null | undefined, actualSell: number | null | undefined): Promise<void>;
181
207
  /**
182
208
  * Perform centralized state recovery (fetch + sync + validate).
183
209
  * Shared by both immediate recovery and stabilization gate.
@@ -185,7 +211,10 @@ declare class Accountant {
185
211
  * @param {Object} mgr - Manager instance
186
212
  * @returns {Promise<Object>} - Validation result from validateGridStateForPersistence()
187
213
  */
188
- _performStateRecovery(mgr: any): Promise<any>;
214
+ _performStateRecovery(mgr: OrderManagerLike): Promise<{
215
+ [key: string]: unknown;
216
+ isValid: boolean;
217
+ }>;
189
218
  /**
190
219
  * Rebuild the tracked fund commitment from a fresh chain read (recovery
191
220
  * recalibration).
@@ -214,7 +243,7 @@ declare class Accountant {
214
243
  * @param {Array} openOrders - Fresh raw chain open orders (same read the sync used)
215
244
  * @returns {Promise<{attempted: number, resized: number, virtualized: number, rejected: number}>}
216
245
  */
217
- _recalibrateTrackedFundsFromChain(mgr: any, openOrders: any[]): Promise<{
246
+ _recalibrateTrackedFundsFromChain(mgr: OrderManagerLike, openOrders: ChainOrder[]): Promise<{
218
247
  attempted: number;
219
248
  resized: number;
220
249
  virtualized: number;
@@ -244,7 +273,7 @@ declare class Accountant {
244
273
  * @param {Object} driftValidation - Result of checkFundDriftAfterFills()
245
274
  * @returns {Promise<{side: string, seededFree: number, committed: number, chainTotal: number}|null>}
246
275
  */
247
- _tryTrustChainFreeHeal(mgr: any, driftValidation: any): Promise<{
276
+ _tryTrustChainFreeHeal(mgr: OrderManagerLike, driftValidation: FundDriftCheck): Promise<{
248
277
  side: string;
249
278
  seededFree: number;
250
279
  committed: number;
@@ -258,7 +287,7 @@ declare class Accountant {
258
287
  * @param {string} violationType - Description of the violation for logging
259
288
  * @returns {Promise<boolean>} - True if recovery succeeded, false otherwise
260
289
  */
261
- _attemptFundRecovery(mgr: any, violationType: any): Promise<boolean>;
290
+ _attemptFundRecovery(mgr: OrderManagerLike, violationType: string): Promise<boolean>;
262
291
  /**
263
292
  * Reset the recovery attempt flag.
264
293
  * Called at the start of each fill processing cycle to allow fresh recovery attempts.
@@ -273,7 +302,7 @@ declare class Accountant {
273
302
  * @param {string} [operation='move'] - Label for logging
274
303
  * @returns {Promise<{ok: boolean, reason?: string}>} {ok: true} on success, {ok: false, reason} on failure
275
304
  */
276
- tryDeductFromChainFree(orderType: any, size: any, operation?: any): Promise<{
305
+ tryDeductFromChainFree(orderType: string | null | undefined, size: number, operation?: string): Promise<{
277
306
  ok: boolean;
278
307
  reason: string;
279
308
  } | {
@@ -288,25 +317,25 @@ declare class Accountant {
288
317
  * @param {string} [operation='release'] - Label for logging
289
318
  * @returns {Promise<boolean>} true if addition succeeded
290
319
  */
291
- addToChainFree(orderType: any, size: any, operation?: any): Promise<boolean>;
320
+ addToChainFree(orderType: string | null | undefined, size: number, operation?: string): Promise<boolean>;
292
321
  /**
293
322
  * PRIVATE: Must be called while holding _fundLock.
294
323
  * Body of adjustTotalBalance; takes the lock externally for clean
295
324
  * nesting in callers that already hold the lock.
296
325
  */
297
- _adjustTotalBalanceLocked(orderType: any, delta: any, operation: any): void;
326
+ _adjustTotalBalanceLocked(orderType: string | null | undefined, delta: number, operation: string): void;
298
327
  /**
299
328
  * PUBLIC API: Acquires _fundLock.
300
329
  * Adjust both total and free balances (for fills, fees, deposits).
301
330
  * @returns {Promise<void>}
302
331
  */
303
- adjustTotalBalance(orderType: any, delta: any, operation: any): Promise<void>;
332
+ adjustTotalBalance(orderType: string | null | undefined, delta: number, operation: string): Promise<void>;
304
333
  /**
305
334
  * Normalize side hint to standard ORDER_TYPES constant.
306
335
  * @param {string|null} sideHint - Side hint ('buy', 'sell', ORDER_TYPES.BUY, ORDER_TYPES.SELL, or null)
307
336
  * @returns {string|null} Normalized side or null if unrecognised
308
337
  */
309
- _normalizeSideHint(sideHint: any): "sell" | "buy" | null;
338
+ _normalizeSideHint(sideHint: string | null | undefined): "sell" | "buy" | null;
310
339
  /**
311
340
  * Resolve the effective order side from multiple sources of truth.
312
341
  * @param {Object|null} order - Order object carrying optional side hints
@@ -314,7 +343,7 @@ declare class Accountant {
314
343
  * @param {string|null} [explicitSideHint] - Explicit side override
315
344
  * @returns {string|null} Resolved side (ORDER_TYPES.BUY, ORDER_TYPES.SELL) or null
316
345
  */
317
- _resolveOrderSide(order: any, fallbackOrder?: any, explicitSideHint?: any): "sell" | "buy" | null;
346
+ _resolveOrderSide(order: Partial<ManagedOrder> | null | undefined, fallbackOrder?: Partial<ManagedOrder> | null, explicitSideHint?: string | null): "sell" | "buy" | null;
318
347
  /**
319
348
  * Update optimistic balance during transitions.
320
349
  * @param {Object} oldOrder - Previous order state
@@ -323,7 +352,7 @@ declare class Accountant {
323
352
  * @param {number} fee - Blockchain fee to deduct
324
353
  * @param {boolean} skipAssetAccounting - If true, skip capital commitment changes (asset amounts) but still process fees
325
354
  */
326
- updateOptimisticFreeBalance(oldOrder: any, newOrder: any, context: any, fee?: any, skipAssetAccounting?: any): Promise<any>;
355
+ updateOptimisticFreeBalance(oldOrder: Partial<ManagedOrder> | null | undefined, newOrder: Partial<ManagedOrder>, context: string, fee?: number, skipAssetAccounting?: boolean): Promise<void>;
327
356
  /**
328
357
  * Deduct BTS fees using adjustTotalBalance.
329
358
  *
@@ -334,7 +363,7 @@ declare class Accountant {
334
363
  * @param {string|null} [requestedSide=null] - ORDER_TYPES.BUY or ORDER_TYPES.SELL to target a specific side
335
364
  * @returns {void}
336
365
  */
337
- deductBtsFees(requestedSide?: any): Promise<void>;
366
+ deductBtsFees(requestedSide?: string | null): Promise<void>;
338
367
  /**
339
368
  * Centralized fee deduction helper - prevents duplicate logic across codebase.
340
369
  * Returns net proceeds after market fees, or raw amount if asset is not recognized.
@@ -344,7 +373,7 @@ declare class Accountant {
344
373
  * @returns {number} Net proceeds after fees, or rawAmount if symbol not found
345
374
  * @private
346
375
  */
347
- _deductFeesFromProceeds(assetSymbol: any, rawAmount: any, isMaker: any): any;
376
+ _deductFeesFromProceeds(assetSymbol: string | null | undefined, rawAmount: number, isMaker: boolean): number;
348
377
  /**
349
378
  * Process the fund impact of an order fill.
350
379
  * Atomically updates accountTotals to keep internal state in sync with blockchain.
@@ -354,7 +383,7 @@ declare class Accountant {
354
383
  * @param {Object} [options={}] - Persistence mode options
355
384
  * @returns {Promise<boolean>} true if fill was successfully processed
356
385
  */
357
- processFillAccounting(fillOp: any, fillKey?: any, options?: any): Promise<boolean>;
386
+ processFillAccounting(fillOp: FillOperation, fillKey?: string | null, options?: FillAccountingOptions): Promise<boolean>;
358
387
  }
359
388
  export default Accountant;
360
389
  //# sourceMappingURL=accounting.d.ts.map
@@ -159,7 +159,7 @@ class Accountant {
159
159
  catch (err) {
160
160
  if (!warnedBtsFeeScheduleFallback.has('BTS')) {
161
161
  warnedBtsFeeScheduleFallback.add('BTS');
162
- this.manager?.logger?.log?.(`[FEE] Failed to load BTS fee schedule: ${err?.message || err}; using fallback defaults`, 'warn');
162
+ this.manager?.logger?.log?.(`[FEE] Failed to load BTS fee schedule: ${getErrorMessage(err)}; using fallback defaults`, 'warn');
163
163
  }
164
164
  return {
165
165
  createFee: 0,
@@ -400,7 +400,7 @@ class Accountant {
400
400
  // (the list is replaced wholesale each sync); a fill between syncs
401
401
  // over-counts until the next refresh, at most one transient recovery.
402
402
  try {
403
- const unmatched = mgr?._lastUnmatchedChainOrders;
403
+ const unmatched = mgr._lastUnmatchedChainOrders;
404
404
  if (Array.isArray(unmatched)) {
405
405
  for (const u of unmatched) {
406
406
  const uSize = Number(u?.size);
@@ -518,7 +518,7 @@ class Accountant {
518
518
  }
519
519
  const precisionSlackBuy = getPrecisionSlack(buyPrecision);
520
520
  const precisionSlackSell = getPrecisionSlack(sellPrecision);
521
- const PERCENT_TOLERANCE = (mgr.config?.gridLimits?.FUND_INVARIANT_PERCENT_TOLERANCE ?? GRID_LIMITS.FUND_INVARIANT_PERCENT_TOLERANCE) / 100;
521
+ const PERCENT_TOLERANCE = toFiniteNumber(mgr.config?.gridLimits?.FUND_INVARIANT_PERCENT_TOLERANCE ?? GRID_LIMITS.FUND_INVARIANT_PERCENT_TOLERANCE) / 100;
522
522
  // FIX 5: Widen tolerance when orphan fills were recently credited.
523
523
  // Orphan fill accounting adjusts mgr.accountTotals optimistically, but
524
524
  // chainFree (sellFree/buyFree) from the last fetchAccountTotals call
@@ -609,8 +609,8 @@ class Accountant {
609
609
  const sellBad = actualSell !== null && actualSell !== undefined && diffSell > allowedSellTolerance;
610
610
  const buyBad = actualBuy !== null && actualBuy !== undefined && diffBuy > allowedBuyTolerance;
611
611
  const side = (buyBad && !sellBad) ? 'buy' : (!buyBad && sellBad) ? 'sell' : 'both';
612
- const direction = (side === 'buy') ? (actualBuy > expectedBuy ? 'tracked-low' : 'tracked-high')
613
- : (side === 'sell') ? (actualSell > expectedSell ? 'tracked-low' : 'tracked-high')
612
+ const direction = (side === 'buy') ? ((actualBuy ?? 0) > expectedBuy ? 'tracked-low' : 'tracked-high')
613
+ : (side === 'sell') ? ((actualSell ?? 0) > expectedSell ? 'tracked-low' : 'tracked-high')
614
614
  : null;
615
615
  const prev = mgr._fundDriftLedger;
616
616
  if (prev && side !== 'both' && direction && prev.side === side && prev.direction === direction) {
@@ -1056,10 +1056,10 @@ class Accountant {
1056
1056
  if (!mgr._recoveryState || typeof mgr._recoveryState !== 'object') {
1057
1057
  mgr._recoveryState = { attemptCount: 0, lastAttemptAt: 0, inFlight: false, lastFailureAt: 0, structuralResyncRequested: false };
1058
1058
  }
1059
- const pt = mgr.config?.pipelineTiming || PIPELINE_TIMING;
1059
+ const pt = (mgr.config?.pipelineTiming ?? PIPELINE_TIMING);
1060
1060
  const state = mgr._recoveryState;
1061
1061
  const now = Date.now();
1062
- const retryIntervalMs = Math.max(0, Number(pt.RECOVERY_RETRY_INTERVAL_MS));
1062
+ const retryIntervalMs = Math.max(0, toFiniteNumber(pt.RECOVERY_RETRY_INTERVAL_MS));
1063
1063
  const maxAttemptsRaw = Number(pt.MAX_RECOVERY_ATTEMPTS);
1064
1064
  const hasAttemptLimit = Number.isFinite(maxAttemptsRaw) && maxAttemptsRaw > 0;
1065
1065
  if (state.inFlight) {
@@ -1069,7 +1069,7 @@ class Accountant {
1069
1069
  // Decay: if enough time has passed since the last failure, treat this
1070
1070
  // as a fresh violation cycle to prevent stale counts from a previous
1071
1071
  // cycle permanently exhausting the attempt budget.
1072
- const decayMs = retryIntervalMs > 0 ? retryIntervalMs * 3 : (pt.RECOVERY_DECAY_FALLBACK_MS ?? PIPELINE_TIMING.RECOVERY_DECAY_FALLBACK_MS);
1072
+ const decayMs = retryIntervalMs > 0 ? retryIntervalMs * 3 : toFiniteNumber(pt.RECOVERY_DECAY_FALLBACK_MS ?? PIPELINE_TIMING.RECOVERY_DECAY_FALLBACK_MS);
1073
1073
  if (state.attemptCount > 0 && state.lastFailureAt > 0 && (now - state.lastFailureAt) > decayMs) {
1074
1074
  // Log at 'info' level so operators can monitor for repeated decay patterns
1075
1075
  // which may indicate a persistent issue that self-corrects just long enough
@@ -1134,6 +1134,7 @@ class Accountant {
1134
1134
  }
1135
1135
  state.lastFailureAt = Date.now();
1136
1136
  if (validation.structuralGridResyncRequired && typeof mgr.requestStructuralGridResync === 'function') {
1137
+ const requestStructuralGridResync = mgr.requestStructuralGridResync;
1137
1138
  const unmatchedCount = Array.isArray(validation.unmatchedChainOrders)
1138
1139
  ? validation.unmatchedChainOrders.length
1139
1140
  : 0;
@@ -1142,7 +1143,7 @@ class Accountant {
1142
1143
  mgr.logger?.log?.(`[RECOVERY] Structural drift detected (${unmatchedCount} unmatched chain order(s)); scheduling full grid resync.`, 'warn');
1143
1144
  Promise.resolve()
1144
1145
  .then(async () => {
1145
- const scheduleResult = await mgr.requestStructuralGridResync('fund invariant structural drift', {
1146
+ const scheduleResult = await requestStructuralGridResync('fund invariant structural drift', {
1146
1147
  unmatchedChainOrders: validation.unmatchedChainOrders || [],
1147
1148
  source: 'fund-invariant-recovery'
1148
1149
  });
@@ -1160,8 +1161,8 @@ class Accountant {
1160
1161
  this._logThrottled('structural-resync-already-requested', '[RECOVERY] Structural grid resync already scheduled; suppressing duplicate request.', 'warn');
1161
1162
  }
1162
1163
  }
1163
- const level = validation.reason.includes('missing account context') ? 'warn' : 'error';
1164
- mgr.logger?.log?.(`[RECOVERY] State recovery failed: ${validation.reason}`, level);
1164
+ const level = String(validation.reason).includes('missing account context') ? 'warn' : 'error';
1165
+ mgr.logger?.log?.(`[RECOVERY] State recovery failed: ${String(validation.reason)}`, level);
1165
1166
  return false;
1166
1167
  }
1167
1168
  catch (err) {
@@ -1232,7 +1233,7 @@ class Accountant {
1232
1233
  const oldValue = mgr.accountTotals[key];
1233
1234
  mgr.accountTotals[key] = Math.max(0, current - size);
1234
1235
  if (mgr.logger && mgr.logger.level === 'debug') {
1235
- mgr.logger.log(`[ACCOUNTING] ${key} -${Format.formatAmount8(size)} (${operation}) -> ${Format.formatAmount8(mgr.accountTotals[key])} (was ${Format.formatAmount8(oldValue)})`, 'debug');
1236
+ mgr.logger.log(`[ACCOUNTING] ${key} -${Format.formatAmount8(size)} (${operation}) -> ${Format.formatAmount8(toFiniteNumber(mgr.accountTotals[key]))} (was ${Format.formatAmount8(toFiniteNumber(oldValue))})`, 'debug');
1236
1237
  }
1237
1238
  return { ok: true };
1238
1239
  }
@@ -1253,7 +1254,7 @@ class Accountant {
1253
1254
  const oldFree = toFiniteNumber(mgr.accountTotals[key]);
1254
1255
  mgr.accountTotals[key] = oldFree + size;
1255
1256
  if (mgr.logger && mgr.logger.level === 'debug') {
1256
- mgr.logger.log(`[ACCOUNTING] ${key} +${Format.formatAmount8(size)} (${operation}) -> ${Format.formatAmount8(mgr.accountTotals[key])} (was ${Format.formatAmount8(oldFree)})`, 'debug');
1257
+ mgr.logger.log(`[ACCOUNTING] ${key} +${Format.formatAmount8(size)} (${operation}) -> ${Format.formatAmount8(toFiniteNumber(mgr.accountTotals[key]))} (was ${Format.formatAmount8(oldFree)})`, 'debug');
1257
1258
  }
1258
1259
  return true;
1259
1260
  }
@@ -1279,7 +1280,7 @@ class Accountant {
1279
1280
  mgr.accountTotals[totalKey] = Math.max(0, oldTotal + delta);
1280
1281
  }
1281
1282
  if (mgr.logger && mgr.logger.level === 'debug') {
1282
- mgr.logger.log(`[ACCOUNTING] ${totalKey} ${delta >= 0 ? '+' : ''}${Format.formatAmount8(delta)} (${operation}) -> Total: ${Format.formatAmount8(mgr.accountTotals[totalKey])}, Free: ${Format.formatAmount8(mgr.accountTotals[freeKey])}`, 'debug');
1283
+ mgr.logger.log(`[ACCOUNTING] ${totalKey} ${delta >= 0 ? '+' : ''}${Format.formatAmount8(delta)} (${operation}) -> Total: ${Format.formatAmount8(toFiniteNumber(mgr.accountTotals[totalKey]))}, Free: ${Format.formatAmount8(toFiniteNumber(mgr.accountTotals[freeKey]))}`, 'debug');
1283
1284
  }
1284
1285
  }
1285
1286
  /**
@@ -1654,7 +1655,7 @@ class Accountant {
1654
1655
  balanceAdjustments.push(btsRefundAdjustment);
1655
1656
  }
1656
1657
  let processedAt = null;
1657
- const tracker = fillKey ? this.manager.processedFillTracker : null;
1658
+ const tracker = this.manager.processedFillTracker;
1658
1659
  if (fillKey) {
1659
1660
  processedAt = Date.now();
1660
1661
  const lastProcessed = tracker.get(fillKey);
@@ -189,11 +189,14 @@ declare class AsyncLock {
189
189
  * Centralizing the check-and-acquire keeps every future call site correct by
190
190
  * construction (no accidental lock bypass when the lock is present).
191
191
  *
192
- * @param {any} lock - AsyncLock (or lock-like { acquire, isReentrant }) to guard with
192
+ * @param {unknown} lock - AsyncLock (or lock-like { acquire, isReentrant }) to guard with
193
193
  * @param {() => Promise<T>} fn - Work to run exclusively; when the lock is held
194
194
  * by the caller it runs directly (re-entrant)
195
195
  * @returns {Promise<T>}
196
196
  */
197
- export declare function acquireIfNotHeld<T>(lock: any, fn: () => Promise<T>): Promise<T>;
197
+ export declare function acquireIfNotHeld<T>(lock: {
198
+ acquire<T>(fn: () => Promise<T>): Promise<T>;
199
+ isReentrant(): boolean;
200
+ } | null | undefined, fn: () => Promise<T>): Promise<T>;
198
201
  export default AsyncLock;
199
202
  //# sourceMappingURL=async_lock.d.ts.map
@@ -402,7 +402,7 @@ class AsyncLock {
402
402
  * Centralizing the check-and-acquire keeps every future call site correct by
403
403
  * construction (no accidental lock bypass when the lock is present).
404
404
  *
405
- * @param {any} lock - AsyncLock (or lock-like { acquire, isReentrant }) to guard with
405
+ * @param {unknown} lock - AsyncLock (or lock-like { acquire, isReentrant }) to guard with
406
406
  * @param {() => Promise<T>} fn - Work to run exclusively; when the lock is held
407
407
  * by the caller it runs directly (re-entrant)
408
408
  * @returns {Promise<T>}
@@ -75,6 +75,7 @@
75
75
  *
76
76
  * ===============================================================================
77
77
  */
78
+ import type { GridConfig } from '../types.js';
78
79
  /**
79
80
  * Parse a legacy fill line from PM2 log file
80
81
  * Expected format: [2026-01-15T15:29:06.185Z] [DEBUG] [FILL] sell fill: size=0.0316, price=1791.30065898866, proceeds=56.60510082 BTS
@@ -83,7 +84,7 @@
83
84
  * @returns {Object|null} Parsed fill object or null on no match
84
85
  */
85
86
  interface FillCore {
86
- side: any;
87
+ side: string;
87
88
  amount: number;
88
89
  price: number;
89
90
  proceeds: number;
@@ -97,7 +98,7 @@ interface FillEntry extends FillCore {
97
98
  interface FeeEntry {
98
99
  count: number;
99
100
  fee_per_fill: number;
100
- fee_asset: any;
101
+ fee_asset: string;
101
102
  total_fee: number;
102
103
  timestamp: number;
103
104
  }
@@ -153,7 +154,7 @@ declare function deriveTradeFromFillBlock(block: FillBlock, ctx: ExportAssetCont
153
154
  * @param {ExportAssetContext|null} [assetContext] - Offline asset metadata for block derivation
154
155
  * @returns {Promise<Array>} Array of trade objects
155
156
  */
156
- declare function parseLogFile(logFilePath: any, assetContext?: ExportAssetContext | null): Promise<any[]>;
157
+ declare function parseLogFile(logFilePath: string | null | undefined, assetContext?: ExportAssetContext | null): Promise<FillEntry[]>;
157
158
  /**
158
159
  * Export bot trades from PM2 log file to CSV
159
160
  * @param {string} botKey - Bot identifier (e.g., 'aaa-bbb-0')
@@ -161,19 +162,19 @@ declare function parseLogFile(logFilePath: any, assetContext?: ExportAssetContex
161
162
  * @param {string} outputDir - Output directory for exports (default: './exports')
162
163
  * @returns {Promise<Object>} Export result status
163
164
  */
164
- declare function exportBotTrades(botKey: any, botConfig: any, outputDir?: any): Promise<{
165
+ declare function exportBotTrades(botKey: string, botConfig: GridConfig, outputDir?: string): Promise<{
165
166
  success: boolean;
166
167
  trades_exported: number;
167
168
  csv_path: string;
168
169
  settings_path: string;
169
- output_dir: any;
170
+ output_dir: string;
170
171
  timestamp: string;
171
172
  error?: undefined;
172
173
  bot_key?: undefined;
173
174
  } | {
174
175
  success: boolean;
175
176
  error: string;
176
- bot_key: any;
177
+ bot_key: string;
177
178
  trades_exported?: undefined;
178
179
  csv_path?: undefined;
179
180
  settings_path?: undefined;
@@ -86,7 +86,7 @@ import { getErrorMessage } from '../utils/errors.js';
86
86
  import { nowIso } from './utils/system.js';
87
87
  const _require = createRequire(import.meta.url);
88
88
  const storage = getStorage();
89
- let _readline;
89
+ let _readline = null;
90
90
  function getReadline() {
91
91
  if (!_readline && _require)
92
92
  _readline = _require('readline');
@@ -239,12 +239,6 @@ function deriveTradeFromFillBlock(block, ctx) {
239
239
  order_id: block.orderId || ''
240
240
  };
241
241
  }
242
- /**
243
- * Resolve offline asset metadata + grid price stats for a bot from its
244
- * persisted grid file (profiles/orders/<botKey>.json). Falls back to scanning
245
- * all persisted grids for a matching meta.key/meta.name. No chain access.
246
- * @returns ExportAssetContext or null when nothing usable was found
247
- */
248
242
  function resolveExportAssetContext(botKey, botConfig) {
249
243
  const readGridFile = (fileName) => {
250
244
  try {
@@ -38,10 +38,11 @@
38
38
  * SECTION 4: RATIO/METRIC FORMATTING (1 function)
39
39
  * 12. formatMetric2(value) - Format to 2 decimals (timing, performance)
40
40
  *
41
- * SECTION 5: HELPER UTILITIES (3 functions)
41
+ * SECTION 5: HELPER UTILITIES (4 functions)
42
42
  * 13. isValidNumber(value) - Check if value is defined and finite
43
43
  * 14. toFiniteNumber(value, defaultValue) - Convert to finite number with fallback
44
- * 15. safeFormat(value, decimals, fallback) - Safely format with fallback
44
+ * 15. positiveOrNull(value) - Convert to a strictly-positive number, else null
45
+ * 16. safeFormat(value, decimals, fallback) - Safely format with fallback
45
46
  *
46
47
  * ===============================================================================
47
48
  */
@@ -147,15 +148,23 @@ declare function formatMetric2(value: number): string;
147
148
  * @param {*} value - Value to check
148
149
  * @returns {boolean} True if value is defined and finite
149
150
  */
150
- declare function isValidNumber(value: any): boolean;
151
+ declare function isValidNumber(value: unknown): boolean;
151
152
  /**
152
153
  * Safely convert a value to a finite number.
153
154
  *
154
155
  * IMPORTANT: passing `undefined` as defaultValue triggers the TS default of 0.
155
156
  * Pass `null` explicitly to get `null` back for non-finite values.
156
157
  */
157
- declare function toFiniteNumber(value: any, defaultValue?: number): number;
158
- declare function toFiniteNumber(value: any, defaultValue: number | null): number | null;
158
+ declare function toFiniteNumber(value: unknown, defaultValue?: number): number;
159
+ declare function toFiniteNumber(value: unknown, defaultValue: number | null): number | null;
160
+ /**
161
+ * Convert a value to a strictly-positive finite number, else `null`.
162
+ *
163
+ * Single home for the `positiveOrNull` guard previously duplicated in
164
+ * cr_planner and credit_pricing. Zero, negatives, non-finite values and
165
+ * non-numeric strings all yield `null`.
166
+ */
167
+ declare function positiveOrNull(value: unknown): number | null;
159
168
  /**
160
169
  * Safely format a numeric value with specified decimals and fallback.
161
170
  *
@@ -164,6 +173,6 @@ declare function toFiniteNumber(value: any, defaultValue: number | null): number
164
173
  * @param {string} [fallback='N/A'] - Fallback value if format fails
165
174
  * @returns {string} Formatted value or fallback string
166
175
  */
167
- declare function safeFormat(value: any, decimals: number, fallback?: string): string;
168
- export { formatAmount8, formatAmount, formatAmountByPrecision, formatSizeByOrderType, formatPrice, formatPrice6, formatPrice4, formatCurrency, formatFundsValue, formatPercent2, formatPercent, formatMetric2, isValidNumber, toFiniteNumber, safeFormat };
176
+ declare function safeFormat(value: unknown, decimals: number, fallback?: string): string;
177
+ export { formatAmount8, formatAmount, formatAmountByPrecision, formatSizeByOrderType, formatPrice, formatPrice6, formatPrice4, formatCurrency, formatFundsValue, formatPercent2, formatPercent, formatMetric2, isValidNumber, toFiniteNumber, positiveOrNull, safeFormat };
169
178
  //# sourceMappingURL=format.d.ts.map
@@ -38,10 +38,11 @@
38
38
  * SECTION 4: RATIO/METRIC FORMATTING (1 function)
39
39
  * 12. formatMetric2(value) - Format to 2 decimals (timing, performance)
40
40
  *
41
- * SECTION 5: HELPER UTILITIES (3 functions)
41
+ * SECTION 5: HELPER UTILITIES (4 functions)
42
42
  * 13. isValidNumber(value) - Check if value is defined and finite
43
43
  * 14. toFiniteNumber(value, defaultValue) - Convert to finite number with fallback
44
- * 15. safeFormat(value, decimals, fallback) - Safely format with fallback
44
+ * 15. positiveOrNull(value) - Convert to a strictly-positive number, else null
45
+ * 16. safeFormat(value, decimals, fallback) - Safely format with fallback
45
46
  *
46
47
  * ===============================================================================
47
48
  */
@@ -246,6 +247,17 @@ function toFiniteNumber(value, defaultValue = 0) {
246
247
  const num = Number(value);
247
248
  return Number.isFinite(num) ? num : defaultValue;
248
249
  }
250
+ /**
251
+ * Convert a value to a strictly-positive finite number, else `null`.
252
+ *
253
+ * Single home for the `positiveOrNull` guard previously duplicated in
254
+ * cr_planner and credit_pricing. Zero, negatives, non-finite values and
255
+ * non-numeric strings all yield `null`.
256
+ */
257
+ function positiveOrNull(value) {
258
+ const num = Number(value);
259
+ return Number.isFinite(num) && num > 0 ? num : null;
260
+ }
249
261
  /**
250
262
  * Safely format a numeric value with specified decimals and fallback.
251
263
  *
@@ -268,5 +280,5 @@ function safeFormat(value, decimals, fallback = 'N/A') {
268
280
  // ===============================================================================
269
281
  // EXPORTS
270
282
  // ===============================================================================
271
- export { formatAmount8, formatAmount, formatAmountByPrecision, formatSizeByOrderType, formatPrice, formatPrice6, formatPrice4, formatCurrency, formatFundsValue, formatPercent2, formatPercent, formatMetric2, isValidNumber, toFiniteNumber, safeFormat };
283
+ export { formatAmount8, formatAmount, formatAmountByPrecision, formatSizeByOrderType, formatPrice, formatPrice6, formatPrice4, formatCurrency, formatFundsValue, formatPercent2, formatPercent, formatMetric2, isValidNumber, toFiniteNumber, positiveOrNull, safeFormat };
272
284
  //# sourceMappingURL=format.js.map
@@ -33,6 +33,9 @@
33
33
  * live order tracking and persists a genesis the live grid does not match --
34
34
  * Option D ("always accept") in the paper, rejected as corruption risk.
35
35
  */
36
+ import type { GridConfig } from '../types.js';
37
+ import type { GridGenesis } from './utils/math.js';
38
+ import type { OrderManagerLike } from '../types.js';
36
39
  /** Why no ladder could be attached to a snapshot (paper T2-T4). */
37
40
  export declare const MISSING_GENESIS_REASON: {
38
41
  /** T2: the config-derived rail disagrees with >MISSING_GENESIS_MISMATCH_RATIO of the slots. */
@@ -42,12 +45,11 @@ export declare const MISSING_GENESIS_REASON: {
42
45
  /** T4: the migration ladder build threw. */
43
46
  readonly MIGRATION_FAILED: "migration_failed";
44
47
  };
45
- export type MissingGenesisReason = (typeof MISSING_GENESIS_REASON)[keyof typeof MISSING_GENESIS_REASON];
46
48
  export declare const ON_MISSING_GENESIS: {
47
49
  readonly REBUILD: "rebuild";
48
50
  readonly HALT: "halt";
49
51
  };
50
- export type OnMissingGenesisPolicy = (typeof ON_MISSING_GENESIS)[keyof typeof ON_MISSING_GENESIS];
52
+ type OnMissingGenesisPolicy = (typeof ON_MISSING_GENESIS)[keyof typeof ON_MISSING_GENESIS];
51
53
  /**
52
54
  * Thrown by `loadGrid` (and the startup gate) when a snapshot carries orders
53
55
  * but no usable ladder. Carries the policy so each caller can route the same
@@ -65,24 +67,24 @@ export declare class MissingGenesisError extends Error {
65
67
  constructor(reason: string, detail: string, policy: OnMissingGenesisPolicy, mismatchRatio?: number | null);
66
68
  }
67
69
  /** True for a MissingGenesisError, including across module/realm duplication. */
68
- export declare function isMissingGenesisError(err: any): boolean;
70
+ export declare function isMissingGenesisError(err: unknown): err is MissingGenesisError;
69
71
  /**
70
72
  * True when `genesis` is a usable ladder: a non-empty priceLevels array. The
71
73
  * hash is deliberately not required here -- a tampered hash is warned about
72
74
  * and the ladder is still used for validation (the pre-existing contract), and
73
75
  * the persisted-row schema check lives at the source (`AccountOrders.loadGenesis`).
74
76
  */
75
- export declare function hasGenesisLadder(genesis: any): boolean;
77
+ export declare function hasGenesisLadder(genesis: unknown): genesis is GridGenesis;
76
78
  /**
77
79
  * Resolve the configured missing-genesis policy.
78
80
  * Unknown/absent values fall back to the default ('rebuild'); only an explicit
79
81
  * 'halt' opts into manual intervention.
80
- * @param {any} config - Bot/manager config (reads `gridLimits.MISSING_GENESIS_POLICY`).
82
+ * @param {unknown} config - Bot/manager config (reads `gridLimits.MISSING_GENESIS_POLICY`).
81
83
  * @returns {OnMissingGenesisPolicy}
82
84
  */
83
- export declare function resolveOnMissingGenesisPolicy(config: any): OnMissingGenesisPolicy;
85
+ export declare function resolveOnMissingGenesisPolicy(config: GridConfig | null | undefined): OnMissingGenesisPolicy;
84
86
  /** Ratio of persisted slots above which a config-derived rail is refused. */
85
- export declare function resolveMismatchRatioLimit(config: any): number;
87
+ export declare function resolveMismatchRatioLimit(config: GridConfig | null | undefined): number;
86
88
  /**
87
89
  * Build the migration ladder from the LIVE geometric rail
88
90
  * (startPrice/minPrice/maxPrice/incrementPercent). The geometry itself comes
@@ -94,17 +96,17 @@ export declare function resolveMismatchRatioLimit(config: any): number;
94
96
  * persisted array would permanently shrink the ladder.
95
97
  * @returns {{ok: true, genesis: any} | {ok: false, reason: string, detail: string}}
96
98
  */
97
- export declare function buildGenesisFromLiveRail(config: any): {
99
+ export declare function buildGenesisFromLiveRail(config: GridConfig | null | undefined): {
98
100
  ok: true;
99
- genesis: any;
101
+ genesis: GridGenesis;
100
102
  } | {
101
103
  ok: false;
102
104
  reason: string;
103
105
  detail: string;
104
106
  };
105
- export type GenesisResolution = {
107
+ type GenesisResolution = {
106
108
  ok: true;
107
- genesis: any;
109
+ genesis: GridGenesis | null;
108
110
  source: 'persisted' | 'in_memory' | 'migration';
109
111
  } | {
110
112
  ok: false;
@@ -130,19 +132,19 @@ export type GenesisResolution = {
130
132
  * verdict before it commits to a resume.
131
133
  *
132
134
  * @param {Object} params
133
- * @param {any} params.config - Live bot/manager config.
134
- * @param {any[]} params.grid - Persisted grid array (may be empty).
135
- * @param {any} [params.genesisInput] - Genesis supplied by the caller (snapshot row).
136
- * @param {any} [params.managerGenesis] - In-memory `manager._genesis`.
135
+ * @param {unknown} params.config - Live bot/manager config.
136
+ * @param {unknown[]} params.grid - Persisted grid array (may be empty).
137
+ * @param {unknown} [params.genesisInput] - Genesis supplied by the caller (snapshot row).
138
+ * @param {unknown} [params.managerGenesis] - In-memory `manager._genesis`.
137
139
  * @param {(msg: string, level?: string) => void} [params.log] - Logger sink for the cross-check verdict.
138
140
  * @param {string} [params.validationMode] - 'log' | 'enforce', for the warning text only.
139
141
  * @returns {GenesisResolution}
140
142
  */
141
143
  export declare function resolvePersistedGenesis({ config, grid, genesisInput, managerGenesis, log, validationMode }: {
142
- config: any;
143
- grid: any;
144
- genesisInput?: any;
145
- managerGenesis?: any;
144
+ config: GridConfig | null;
145
+ grid: unknown;
146
+ genesisInput?: unknown;
147
+ managerGenesis?: unknown;
146
148
  log?: (msg: string, level?: string) => void;
147
149
  validationMode?: string;
148
150
  }): GenesisResolution;
@@ -150,13 +152,14 @@ export declare function resolvePersistedGenesis({ config, grid, genesisInput, ma
150
152
  * Build the fault object for a refused snapshot, recording the policy and the
151
153
  * reason on the manager for observability (the soft half of the enforcement:
152
154
  * a counter/log is what tells an operator T2-T4 ever fire in the wild).
153
- * @param {any} manager
155
+ * @param {unknown} manager
154
156
  * @param {{reason: string, detail: string, mismatchRatio: number | null}} fault
155
157
  * @returns {MissingGenesisError}
156
158
  */
157
- export declare function recordMissingGenesisFault(manager: any, fault: {
159
+ export declare function recordMissingGenesisFault(manager: OrderManagerLike, fault: {
158
160
  reason: string;
159
161
  detail: string;
160
162
  mismatchRatio: number | null;
161
163
  }): MissingGenesisError;
164
+ export {};
162
165
  //# sourceMappingURL=genesis_policy.d.ts.map