dexbot 1.6.10 → 1.6.12

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (365) hide show
  1. package/CHANGELOG.md +50 -3
  2. package/README.md +3 -1
  3. package/analysis/README.md +51 -11
  4. package/analysis/bot_fitting/README.md +12 -0
  5. package/analysis/tradingview/README.md +3 -3
  6. package/analysis/trend_detection/DYNAMIC_WEIGHT_RESEARCH.md +11 -37
  7. package/analysis/trend_detection/README.md +31 -0
  8. package/claw/docs/DEXBOT2_TUNING_CHEAT_SHEET.md +4 -3
  9. package/claw/modules/chain_broadcast.ts +7 -1
  10. package/claw/modules/claw_launcher.ts +1 -1
  11. package/claw/modules/launcher_mode_detector.ts +9 -2
  12. package/claw/package.json +1 -1
  13. package/claw/runtimes/openclaw-plugin/openclaw.plugin.json +1 -1
  14. package/claw/runtimes/openclaw-plugin/package.json +1 -1
  15. package/dist/analysis/account_resolver.d.ts +1 -1
  16. package/dist/analysis/account_resolver.js +15 -2
  17. package/dist/analysis/ama_fitting/analyze_ama_price_changes.js +3 -4
  18. package/dist/analysis/ama_fitting/analyze_lambda_vs_slow.js +2 -7
  19. package/dist/analysis/ama_fitting/calibrate_convergence_er.js +0 -1
  20. package/dist/analysis/ama_fitting/fetch_lp_candles.js +4 -4
  21. package/dist/analysis/ama_fitting/generate_unified_comparison_chart.d.ts +20 -4
  22. package/dist/analysis/ama_fitting/generate_unified_comparison_chart.js +9 -6
  23. package/dist/analysis/ama_fitting/optimizer_high_resolution.js +16 -12
  24. package/dist/analysis/analyze_args.d.ts +31 -0
  25. package/dist/analysis/analyze_args.js +41 -0
  26. package/dist/analysis/analyze_dynamic_weight.js +7 -20
  27. package/dist/analysis/analyze_kalman.js +7 -17
  28. package/dist/analysis/analyze_regime.js +7 -17
  29. package/dist/analysis/analyze_regime_windows.js +8 -18
  30. package/dist/analysis/analyze_risk_profile.js +8 -18
  31. package/dist/analysis/analyze_trade_heatmap.js +7 -17
  32. package/dist/analysis/analyze_volatility.js +7 -17
  33. package/dist/analysis/bot_fitting/backtest_ama_sweep.d.ts +220 -12
  34. package/dist/analysis/bot_fitting/backtest_ama_sweep.js +55 -10
  35. package/dist/analysis/bot_fitting/backtest_bot_fitting.d.ts +34 -4
  36. package/dist/analysis/bot_fitting/backtest_bot_fitting.js +72 -66
  37. package/dist/analysis/bot_fitting/backtest_lookback_drawdown.d.ts +21 -0
  38. package/dist/analysis/bot_fitting/backtest_lookback_drawdown.js +315 -0
  39. package/dist/analysis/bot_fitting/shared_utils.d.ts +7 -7
  40. package/dist/analysis/bot_fitting/shared_utils.js +2 -2
  41. package/dist/analysis/bot_key_utils.d.ts +18 -10
  42. package/dist/analysis/bot_key_utils.js +10 -17
  43. package/dist/analysis/bot_usage/discover_bot_accounts.js +44 -47
  44. package/dist/analysis/bot_usage/kibana_bot_queries.d.ts +1 -21
  45. package/dist/analysis/chain_pool.d.ts +3 -1
  46. package/dist/analysis/chart_ui.d.ts +5 -2
  47. package/dist/analysis/chart_ui.js +6 -3
  48. package/dist/analysis/chart_utils.d.ts +5 -5
  49. package/dist/analysis/chart_utils.js +9 -0
  50. package/dist/analysis/fills_cache.d.ts +64 -0
  51. package/dist/analysis/fills_cache.js +254 -0
  52. package/dist/analysis/fills_source.d.ts +2 -2
  53. package/dist/analysis/fills_source.js +19 -14
  54. package/dist/analysis/grid_correction_check.d.ts +1 -1
  55. package/dist/analysis/grid_correction_check.js +12 -11
  56. package/dist/analysis/math_utils.d.ts +7 -6
  57. package/dist/analysis/math_utils.js +5 -8
  58. package/dist/analysis/pnl_report.d.ts +39 -0
  59. package/dist/analysis/pnl_report.js +325 -0
  60. package/dist/analysis/price_sources.d.ts +8 -8
  61. package/dist/analysis/price_sources.js +5 -4
  62. package/dist/analysis/resolve_bot_accounts.js +2 -2
  63. package/dist/analysis/resolve_source.d.ts +1 -2
  64. package/dist/analysis/trade_profitability.d.ts +32 -2
  65. package/dist/analysis/trade_profitability.js +232 -106
  66. package/dist/analysis/tradingview/analyze_tradingview.d.ts +17 -6
  67. package/dist/analysis/tradingview/analyze_tradingview.js +9 -10
  68. package/dist/analysis/tradingview/grid_reset_config.d.ts +42 -31
  69. package/dist/analysis/tradingview/grid_reset_config.js +35 -6
  70. package/dist/analysis/tradingview/grid_reset_sim.d.ts +75 -8
  71. package/dist/analysis/tradingview/grid_reset_sim.js +42 -5
  72. package/dist/analysis/tradingview/tradingview_uplot_chart_generator.d.ts +69 -4
  73. package/dist/analysis/tradingview/tradingview_uplot_chart_generator.js +20 -20
  74. package/dist/analysis/trend_detection/backtest_ama_slope_huber.d.ts +102 -0
  75. package/dist/analysis/trend_detection/backtest_ama_slope_huber.js +725 -0
  76. package/dist/analysis/trend_detection/dynamic_weight_chart_generator.d.ts +63 -1
  77. package/dist/analysis/trend_detection/dynamic_weight_chart_generator.js +27 -112
  78. package/dist/analysis/trend_detection/huber_scale_variants.d.ts +40 -0
  79. package/dist/analysis/trend_detection/huber_scale_variants.js +176 -0
  80. package/dist/analysis/trend_detection/kalman_chart_generator.d.ts +30 -1
  81. package/dist/analysis/trend_detection/kalman_chart_generator.js +3 -3
  82. package/dist/analysis/trend_detection/regime_chart_generator.d.ts +31 -1
  83. package/dist/analysis/trend_detection/regime_chart_generator.js +2 -2
  84. package/dist/analysis/trend_detection/volatility_chart_generator.d.ts +33 -1
  85. package/dist/credential-daemon.js +34 -20
  86. package/dist/dexbot.js +17 -14
  87. package/dist/market_adapter/candle_utils.d.ts +22 -18
  88. package/dist/market_adapter/candle_utils.js +24 -20
  89. package/dist/market_adapter/core/asymmetric_bounds.d.ts +13 -4
  90. package/dist/market_adapter/core/config_normalizers.d.ts +3 -3
  91. package/dist/market_adapter/core/kibana_candles.d.ts +53 -18
  92. package/dist/market_adapter/core/kibana_candles.js +9 -7
  93. package/dist/market_adapter/core/kibana_client.d.ts +9 -1
  94. package/dist/market_adapter/core/kibana_client.js +8 -7
  95. package/dist/market_adapter/core/kibana_market_candles.d.ts +3 -2
  96. package/dist/market_adapter/core/market_adapter_service.d.ts +297 -115
  97. package/dist/market_adapter/core/market_adapter_service.js +184 -101
  98. package/dist/market_adapter/core/strategies/ama.d.ts +10 -2
  99. package/dist/market_adapter/core/strategies/ama.js +7 -32
  100. package/dist/market_adapter/core/strategies/ama_slope_model.d.ts +14 -1
  101. package/dist/market_adapter/core/strategies/ama_slope_model.js +12 -34
  102. package/dist/market_adapter/core/strategies/atr/calculator.d.ts +7 -2
  103. package/dist/market_adapter/core/strategies/atr/calculator.js +2 -34
  104. package/dist/market_adapter/core/strategies/collateral_manager.d.ts +7 -1
  105. package/dist/market_adapter/core/strategies/collateral_manager.js +0 -22
  106. package/dist/market_adapter/core/strategies/dynamic_weight_series.d.ts +36 -8
  107. package/dist/market_adapter/core/strategies/dynamic_weight_series.js +9 -9
  108. package/dist/market_adapter/core/strategies/regime_gate.d.ts +24 -15
  109. package/dist/market_adapter/core/strategies/regime_gate.js +4 -31
  110. package/dist/market_adapter/core/strategies/regime_interp.d.ts +7 -1
  111. package/dist/market_adapter/core/strategies/regime_interp.js +14 -22
  112. package/dist/market_adapter/core/strategies/volatility_shift.d.ts +11 -1
  113. package/dist/market_adapter/core/strategies/volatility_shift.js +0 -13
  114. package/dist/market_adapter/inputs/cex_candle_parsing.d.ts +29 -0
  115. package/dist/market_adapter/inputs/cex_candle_parsing.js +52 -0
  116. package/dist/market_adapter/inputs/fetch_book_data.d.ts +20 -4
  117. package/dist/market_adapter/inputs/fetch_book_data.js +3 -1
  118. package/dist/market_adapter/inputs/fetch_cex_synthetic_data.js +97 -226
  119. package/dist/market_adapter/inputs/fetch_lp_data.d.ts +42 -7
  120. package/dist/market_adapter/inputs/fetch_lp_data.js +22 -15
  121. package/dist/market_adapter/inputs/kibana_feed_source.d.ts +74 -15
  122. package/dist/market_adapter/inputs/kibana_feed_source.js +29 -22
  123. package/dist/market_adapter/inputs/kibana_source.d.ts +25 -3
  124. package/dist/market_adapter/inputs/kibana_source.js +2 -2
  125. package/dist/market_adapter/inputs/window_cache.d.ts +99 -94
  126. package/dist/market_adapter/inputs/window_cache.js +8 -8
  127. package/dist/market_adapter/interval_utils.d.ts +4 -4
  128. package/dist/market_adapter/log_format.d.ts +6 -6
  129. package/dist/market_adapter/log_format.js +28 -22
  130. package/dist/market_adapter/lp_chart_core.d.ts +22 -1
  131. package/dist/market_adapter/lp_chart_core.js +26 -192
  132. package/dist/market_adapter/lp_chart_runner.d.ts +7 -7
  133. package/dist/market_adapter/lp_chart_strategy_loader.d.ts +41 -6
  134. package/dist/market_adapter/lp_chart_strategy_loader.js +8 -7
  135. package/dist/market_adapter/market_adapter.d.ts +94 -33
  136. package/dist/market_adapter/market_adapter.js +69 -75
  137. package/dist/market_adapter/utils/adapter_client.d.ts +3 -3
  138. package/dist/market_adapter/utils/adapter_client.js +2 -2
  139. package/dist/market_adapter/utils/atomic_write.d.ts +8 -1
  140. package/dist/market_adapter/utils/chain.d.ts +50 -41
  141. package/dist/market_adapter/utils/chain.js +40 -46
  142. package/dist/market_adapter/utils/data_discovery.d.ts +4 -1
  143. package/dist/market_adapter/utils/dynamic_grid_snapshot.d.ts +12 -3
  144. package/dist/market_adapter/utils/file_json_cache.d.ts +2 -2
  145. package/dist/market_adapter/utils/file_lock.d.ts +28 -14
  146. package/dist/market_adapter/utils/file_lock.js +36 -32
  147. package/dist/market_adapter/utils/native_history.d.ts +9 -2
  148. package/dist/market_adapter/utils/native_history.js +35 -28
  149. package/dist/modules/account_bots.d.ts +577 -21
  150. package/dist/modules/account_bots.js +182 -158
  151. package/dist/modules/account_orders.d.ts +66 -30
  152. package/dist/modules/account_orders.js +22 -20
  153. package/dist/modules/authority_resolver.d.ts +12 -2
  154. package/dist/modules/authority_resolver.js +15 -8
  155. package/dist/modules/bitshares-native/chain_client.d.ts +38 -3
  156. package/dist/modules/bitshares-native/chain_client.js +45 -46
  157. package/dist/modules/bitshares-native/crypto/ecc.browser.js +11 -171
  158. package/dist/modules/bitshares-native/crypto/ecc.js +13 -176
  159. package/dist/modules/bitshares-native/crypto/ecc_core.d.ts +33 -0
  160. package/dist/modules/bitshares-native/crypto/ecc_core.js +213 -0
  161. package/dist/modules/bitshares-native/crypto/ecc_selector.d.ts +2 -1
  162. package/dist/modules/bitshares-native/crypto/ecc_selector.js +1 -13
  163. package/dist/modules/bitshares-native/index.d.ts +1 -1
  164. package/dist/modules/bitshares-native/lru_cache.d.ts +7 -7
  165. package/dist/modules/bitshares-native/resolvers.d.ts +18 -6
  166. package/dist/modules/bitshares-native/serial/lazy_buffer.d.ts +4 -0
  167. package/dist/modules/bitshares-native/serial/lazy_buffer.js +21 -0
  168. package/dist/modules/bitshares-native/serial/operations.d.ts +1 -1
  169. package/dist/modules/bitshares-native/serial/serializer.d.ts +16 -12
  170. package/dist/modules/bitshares-native/serial/serializer.js +7 -13
  171. package/dist/modules/bitshares-native/serial/types.d.ts +25 -16
  172. package/dist/modules/bitshares-native/serial/types.js +55 -62
  173. package/dist/modules/bitshares-native/signing_client.d.ts +32 -2
  174. package/dist/modules/bitshares-native/signing_client.js +19 -14
  175. package/dist/modules/bitshares-native/subscriptions.d.ts +81 -1
  176. package/dist/modules/bitshares-native/subscriptions.js +12 -12
  177. package/dist/modules/bitshares-native/transport.d.ts +5 -4
  178. package/dist/modules/bitshares-native/transport.js +5 -4
  179. package/dist/modules/bitshares-native/tx/builder.d.ts +40 -5
  180. package/dist/modules/bitshares-native/tx/builder.js +4 -3
  181. package/dist/modules/bitshares-native/tx/tx_cache.d.ts +4 -4
  182. package/dist/modules/bitshares_client.d.ts +45 -13
  183. package/dist/modules/bitshares_client.js +28 -19
  184. package/dist/modules/bot_defaults.d.ts +6 -15
  185. package/dist/modules/bot_defaults.js +1 -5
  186. package/dist/modules/bot_settings.d.ts +44 -10
  187. package/dist/modules/bot_settings.js +11 -8
  188. package/dist/modules/bots_file_lock.d.ts +6 -6
  189. package/dist/modules/bots_file_lock.js +16 -12
  190. package/dist/modules/broadcast_failure.d.ts +2 -2
  191. package/dist/modules/broadcast_failure.js +5 -4
  192. package/dist/modules/chain_keys.d.ts +42 -40
  193. package/dist/modules/chain_keys.js +53 -45
  194. package/dist/modules/chain_orders.d.ts +93 -59
  195. package/dist/modules/chain_orders.js +31 -23
  196. package/dist/modules/constants.d.ts +530 -32
  197. package/dist/modules/constants.js +52 -60
  198. package/dist/modules/cr_planner.d.ts +40 -2
  199. package/dist/modules/credential_policy.d.ts +68 -8
  200. package/dist/modules/credential_policy.js +37 -31
  201. package/dist/modules/credential_session_cache.d.ts +2 -2
  202. package/dist/modules/credit_pricing.d.ts +42 -6
  203. package/dist/modules/credit_pricing.js +44 -30
  204. package/dist/modules/credit_runtime.d.ts +276 -118
  205. package/dist/modules/credit_runtime.js +462 -165
  206. package/dist/modules/crypto/browser_provider.js +6 -4
  207. package/dist/modules/crypto/node_provider.js +1 -1
  208. package/dist/modules/crypto/pure_scrypt.js +35 -4
  209. package/dist/modules/crypto/pure_secp256k1.js +72 -26
  210. package/dist/modules/crypto/sync.d.ts +9 -9
  211. package/dist/modules/crypto/sync.js +16 -9
  212. package/dist/modules/dexbot_class.d.ts +195 -139
  213. package/dist/modules/dexbot_class.js +78 -28
  214. package/dist/modules/dexbot_cow_runtime.d.ts +167 -87
  215. package/dist/modules/dexbot_cow_runtime.js +248 -206
  216. package/dist/modules/dexbot_credential_client.d.ts +19 -11
  217. package/dist/modules/dexbot_fill_runtime.d.ts +63 -48
  218. package/dist/modules/dexbot_fill_runtime.js +48 -41
  219. package/dist/modules/dexbot_maintenance_runtime.d.ts +109 -70
  220. package/dist/modules/dexbot_maintenance_runtime.js +117 -80
  221. package/dist/modules/dexbot_startup_runtime.d.ts +11 -10
  222. package/dist/modules/dexbot_startup_runtime.js +43 -43
  223. package/dist/modules/dexbot_state_recovery.d.ts +13 -12
  224. package/dist/modules/dexbot_state_recovery.js +18 -13
  225. package/dist/modules/fund_registry.d.ts +4 -2
  226. package/dist/modules/fund_registry.js +10 -10
  227. package/dist/modules/general_settings.d.ts +30 -4
  228. package/dist/modules/graceful_shutdown.d.ts +3 -3
  229. package/dist/modules/graceful_shutdown.js +2 -2
  230. package/dist/modules/grid_price_source.d.ts +1 -1
  231. package/dist/modules/key_store.d.ts +14 -8
  232. package/dist/modules/key_store.js +7 -6
  233. package/dist/modules/launcher/adapter_requirement.d.ts +11 -5
  234. package/dist/modules/launcher/adapter_requirement.js +5 -5
  235. package/dist/modules/launcher/bot_supervisor.d.ts +106 -24
  236. package/dist/modules/launcher/bot_supervisor.js +12 -11
  237. package/dist/modules/launcher/credential_bootstrap.d.ts +1 -1
  238. package/dist/modules/launcher/credential_bootstrap.js +1 -1
  239. package/dist/modules/launcher/credential_daemon.d.ts +4 -4
  240. package/dist/modules/launcher/credential_daemon.js +2 -2
  241. package/dist/modules/launcher/credential_secret.d.ts +1 -1
  242. package/dist/modules/launcher/foreign_cred_daemon.d.ts +2 -2
  243. package/dist/modules/launcher/market_adapter_runtime.d.ts +61 -6
  244. package/dist/modules/launcher/market_adapter_watchdog.d.ts +10 -2
  245. package/dist/modules/launcher/market_adapter_watchdog.js +4 -0
  246. package/dist/modules/launcher/monolithic_runtime.d.ts +18 -16
  247. package/dist/modules/launcher/status_reporting.d.ts +22 -14
  248. package/dist/modules/launcher/supervisor_control.d.ts +8 -1
  249. package/dist/modules/launcher/supervisor_control.js +4 -2
  250. package/dist/modules/market_adapter_whitelist.d.ts +9 -3
  251. package/dist/modules/market_adapter_whitelist.js +15 -3
  252. package/dist/modules/node_manager.d.ts +41 -11
  253. package/dist/modules/node_manager.js +5 -4
  254. package/dist/modules/order/accounting.d.ts +53 -24
  255. package/dist/modules/order/accounting.js +40 -14
  256. package/dist/modules/order/async_lock.d.ts +5 -2
  257. package/dist/modules/order/async_lock.js +1 -1
  258. package/dist/modules/order/export.d.ts +7 -6
  259. package/dist/modules/order/export.js +1 -7
  260. package/dist/modules/order/format.d.ts +39 -19
  261. package/dist/modules/order/format.js +62 -16
  262. package/dist/modules/order/genesis_policy.d.ts +21 -18
  263. package/dist/modules/order/genesis_policy.js +12 -8
  264. package/dist/modules/order/grid.d.ts +142 -36
  265. package/dist/modules/order/grid.js +148 -123
  266. package/dist/modules/order/grid_reconcile.d.ts +21 -20
  267. package/dist/modules/order/grid_reconcile.js +13 -12
  268. package/dist/modules/order/grid_reconcile_internal.d.ts +85 -72
  269. package/dist/modules/order/grid_reconcile_internal.js +28 -19
  270. package/dist/modules/order/index.d.ts +263 -1
  271. package/dist/modules/order/logger.d.ts +45 -11
  272. package/dist/modules/order/logger.js +38 -40
  273. package/dist/modules/order/logger_state.d.ts +4 -4
  274. package/dist/modules/order/manager.d.ts +226 -180
  275. package/dist/modules/order/manager.js +101 -83
  276. package/dist/modules/order/processed_fill_store.d.ts +18 -3
  277. package/dist/modules/order/processed_fill_store.js +16 -27
  278. package/dist/modules/order/strategy.d.ts +21 -13
  279. package/dist/modules/order/strategy.js +5 -6
  280. package/dist/modules/order/sync_engine.d.ts +91 -33
  281. package/dist/modules/order/sync_engine.js +99 -54
  282. package/dist/modules/order/utils/math.d.ts +157 -102
  283. package/dist/modules/order/utils/math.js +77 -38
  284. package/dist/modules/order/utils/order.d.ts +326 -106
  285. package/dist/modules/order/utils/order.js +200 -99
  286. package/dist/modules/order/utils/slot.d.ts +1 -1
  287. package/dist/modules/order/utils/system.d.ts +176 -26
  288. package/dist/modules/order/utils/system.js +86 -69
  289. package/dist/modules/order/utils/validate.d.ts +89 -41
  290. package/dist/modules/order/utils/validate.js +24 -22
  291. package/dist/modules/order/utils/withPoolRef.d.ts +4 -3
  292. package/dist/modules/order/utils/withPoolRef.js +18 -12
  293. package/dist/modules/order/working_grid.d.ts +14 -13
  294. package/dist/modules/paths.d.ts +3 -4
  295. package/dist/modules/paths.js +3 -27
  296. package/dist/modules/process_discovery.d.ts +1 -1
  297. package/dist/modules/process_discovery.js +2 -1
  298. package/dist/modules/runtime.d.ts +7 -3
  299. package/dist/modules/runtime.js +4 -3
  300. package/dist/modules/runtime_settings.d.ts +15 -10
  301. package/dist/modules/runtime_settings.js +30 -24
  302. package/dist/modules/settings_merge.d.ts +29 -3
  303. package/dist/modules/settings_merge.js +56 -78
  304. package/dist/modules/socket_json_client.d.ts +7 -4
  305. package/dist/modules/storage/browser_adapter.d.ts +38 -53
  306. package/dist/modules/storage/browser_adapter.js +7 -30
  307. package/dist/modules/storage/index.d.ts +1 -1
  308. package/dist/modules/storage/node_adapter.d.ts +45 -27
  309. package/dist/modules/storage/node_adapter.js +9 -9
  310. package/dist/modules/storage/types.d.ts +5 -4
  311. package/dist/modules/types.d.ts +1071 -2
  312. package/dist/modules/types.js +4 -1
  313. package/dist/modules/utils/asset_symbols.d.ts +2 -1
  314. package/dist/modules/utils/asset_symbols.js +2 -1
  315. package/dist/modules/utils/errors.d.ts +9 -0
  316. package/dist/modules/utils/errors.js +23 -1
  317. package/dist/modules/utils/time_range.d.ts +4 -0
  318. package/dist/modules/utils/time_range.js +18 -0
  319. package/dist/modules/validate_profiles.js +53 -43
  320. package/dist/modules/version_notice.d.ts +14 -3
  321. package/dist/modules/version_notice.js +6 -4
  322. package/dist/pm2.d.ts +29 -27
  323. package/dist/pm2.js +5 -5
  324. package/dist/scripts/analyze-credit.d.ts +2 -1
  325. package/dist/scripts/analyze-credit.js +23 -24
  326. package/dist/scripts/analyze-orders.d.ts +77 -9
  327. package/dist/scripts/analyze-orders.js +66 -84
  328. package/dist/scripts/chart_command.d.ts +27 -18
  329. package/dist/scripts/chart_command.js +16 -15
  330. package/dist/scripts/check_any.d.ts +18 -0
  331. package/dist/scripts/check_any.js +126 -0
  332. package/dist/scripts/diagnose-pool-history.js +12 -7
  333. package/dist/scripts/pnl.d.ts +3 -0
  334. package/dist/scripts/pnl.js +40 -0
  335. package/dist/scripts/print_grid.js +0 -1
  336. package/dist/scripts/run-tests.js +39 -7
  337. package/dist/scripts/runner.js +1 -1
  338. package/dist/scripts/test-credit-renewal.js +30 -21
  339. package/dist/scripts/update.d.ts +10 -5
  340. package/dist/scripts/update.js +168 -103
  341. package/dist/scripts/update_dist_freshness.js +1 -0
  342. package/dist/scripts/update_layout.d.ts +61 -0
  343. package/dist/scripts/update_layout.js +180 -0
  344. package/dist/scripts/validate_bots.js +2 -1
  345. package/dist/scripts/verify-browser-bundle.js +8 -0
  346. package/dist/unlock.d.ts +28 -3
  347. package/dist/unlock.js +72 -10
  348. package/docs/BITSHARES_ONBOARDING.md +2 -0
  349. package/docs/COPY_ON_WRITE_MASTER_PLAN.md +1 -1
  350. package/docs/COW_INVARIANTS.md +13 -6
  351. package/docs/DEXBOT_COMPARISON.md +8 -8
  352. package/docs/EVOLUTION.md +12 -10
  353. package/docs/FUND_MOVEMENT_AND_ACCOUNTING.md +5 -5
  354. package/docs/GRID_RECALCULATION.md +15 -16
  355. package/docs/GRID_RECONCILE.md +14 -3
  356. package/docs/LIFECYCLE.md +11 -11
  357. package/docs/MPA_CREDIT_USAGE.md +22 -3
  358. package/docs/README.md +15 -4
  359. package/docs/WORKFLOW.md +1 -0
  360. package/docs/architecture.md +12 -9
  361. package/docs/developer_guide.md +6 -6
  362. package/market_adapter/README.md +9 -26
  363. package/modules/README.md +4 -1
  364. package/package.json +4 -1
  365. package/scripts/README.md +14 -0
@@ -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 {
@@ -15,7 +15,7 @@
15
15
  * Time/Performance (ms, %): 1-2 decimals - readable metrics
16
16
  *
17
17
  * ===============================================================================
18
- * TABLE OF CONTENTS (14 exported functions)
18
+ * TABLE OF CONTENTS (15 exported functions)
19
19
  * ===============================================================================
20
20
  *
21
21
  * SECTION 1: ASSET FORMATTING (4 functions)
@@ -24,22 +24,24 @@
24
24
  * 3. formatAmountByPrecision(value, precision) - Format using chain precision
25
25
  * 4. formatSizeByOrderType(value, orderType, assets) - Format order size by BUY/SELL asset precision
26
26
  *
27
- * SECTION 2: PRICE FORMATTING (3 functions)
28
- * 6. formatPrice(value) - Format to 8 decimals (maximum precision)
29
- * 7. formatPrice6(value) - Format to 6 decimals
30
- * 8. formatPrice4(value) - Format to 4 decimals (simplified display)
27
+ * SECTION 2: PRICE & FUNDS FORMATTING (5 functions)
28
+ * 5. formatPrice(value) - Format to 8 decimals (maximum precision)
29
+ * 6. formatPrice6(value) - Format to 6 decimals
30
+ * 7. formatPrice4(value) - Format to 4 decimals (simplified display)
31
+ * 8. formatCurrency(value, digits) - Grouped thousands with SI micro-suffixes
32
+ * 9. formatFundsValue(value) - Compact K/M, 4 significant figures (keeps trailing zeros)
31
33
  *
32
- * SECTION 3: PERCENTAGE FORMATTING (3 functions)
33
- * 9. formatPercent2(value) - Format to 2 decimals (spread %, ratios)
34
- * 10. formatPercent(value, decimals) - Format with custom decimal places
34
+ * SECTION 3: PERCENTAGE FORMATTING (2 functions)
35
+ * 10. formatPercent2(value) - Format to 2 decimals (spread %, ratios)
36
+ * 11. formatPercent(value, decimals) - Format with custom decimal places
35
37
  *
36
- * SECTION 4: RATIO/METRIC FORMATTING (3 functions)
37
- * 11. formatMetric2(value) - Format to 2 decimals (timing, performance)
38
+ * SECTION 4: RATIO/METRIC FORMATTING (1 function)
39
+ * 12. formatMetric2(value) - Format to 2 decimals (timing, performance)
38
40
  *
39
- * SECTION 5: HELPER UTILITIES (4 functions)
40
- * 12. isValidNumber(value) - Check if value is defined and finite
41
- * 13. toFiniteNumber(value, defaultValue) - Convert to finite number with fallback
42
- * 14. safeFormat(value, decimals, fallback) - Safely format with fallback
41
+ * SECTION 5: HELPER UTILITIES (3 functions)
42
+ * 13. isValidNumber(value) - Check if value is defined and finite
43
+ * 14. toFiniteNumber(value, defaultValue) - Convert to finite number with fallback
44
+ * 15. safeFormat(value, decimals, fallback) - Safely format with fallback
43
45
  *
44
46
  * ===============================================================================
45
47
  */
@@ -106,6 +108,24 @@ declare function formatPrice4(value: number): string;
106
108
  * @returns {string} Formatted value with suffix if small
107
109
  */
108
110
  declare function formatCurrency(value: number, digits?: number): string;
111
+ /**
112
+ * Format a value with compact K/M notation and exactly 4 significant figures
113
+ * for values that have more than 4. Unlike `formatCurrency`, this caps the
114
+ * significant digits of large magnitudes (e.g. a volume of 19,423,608.6 ->
115
+ * "19.42M") instead of keeping every integer digit, and it KEEPS significant
116
+ * trailing zeros rather than trimming them (1009.794 -> "1.010K", not "1.01K").
117
+ * Examples:
118
+ * 194395 -> "194.4K"
119
+ * 1009.794 -> "1.010K"
120
+ * 10000 -> "10.00K"
121
+ * 1000 -> "1.000K"
122
+ * 332.33 -> "332.3"
123
+ * 10.389 -> "10.39"
124
+ * 1500000 -> "1.500M"
125
+ * @param {number} value
126
+ * @returns {string}
127
+ */
128
+ declare function formatFundsValue(value: number): string;
109
129
  /**
110
130
  * Format percentages to 2 decimal places
111
131
  * Used for: spread %, ratios, simple percentages
@@ -127,15 +147,15 @@ declare function formatMetric2(value: number): string;
127
147
  * @param {*} value - Value to check
128
148
  * @returns {boolean} True if value is defined and finite
129
149
  */
130
- declare function isValidNumber(value: any): boolean;
150
+ declare function isValidNumber(value: unknown): boolean;
131
151
  /**
132
152
  * Safely convert a value to a finite number.
133
153
  *
134
154
  * IMPORTANT: passing `undefined` as defaultValue triggers the TS default of 0.
135
155
  * Pass `null` explicitly to get `null` back for non-finite values.
136
156
  */
137
- declare function toFiniteNumber(value: any, defaultValue?: number): number;
138
- declare function toFiniteNumber(value: any, defaultValue: number | null): number | null;
157
+ declare function toFiniteNumber(value: unknown, defaultValue?: number): number;
158
+ declare function toFiniteNumber(value: unknown, defaultValue: number | null): number | null;
139
159
  /**
140
160
  * Safely format a numeric value with specified decimals and fallback.
141
161
  *
@@ -144,6 +164,6 @@ declare function toFiniteNumber(value: any, defaultValue: number | null): number
144
164
  * @param {string} [fallback='N/A'] - Fallback value if format fails
145
165
  * @returns {string} Formatted value or fallback string
146
166
  */
147
- declare function safeFormat(value: any, decimals: number, fallback?: string): string;
148
- export { formatAmount8, formatAmount, formatAmountByPrecision, formatSizeByOrderType, formatPrice, formatPrice6, formatPrice4, formatCurrency, formatPercent2, formatPercent, formatMetric2, isValidNumber, toFiniteNumber, safeFormat };
167
+ declare function safeFormat(value: unknown, decimals: number, fallback?: string): string;
168
+ export { formatAmount8, formatAmount, formatAmountByPrecision, formatSizeByOrderType, formatPrice, formatPrice6, formatPrice4, formatCurrency, formatFundsValue, formatPercent2, formatPercent, formatMetric2, isValidNumber, toFiniteNumber, safeFormat };
149
169
  //# sourceMappingURL=format.d.ts.map
@@ -15,7 +15,7 @@
15
15
  * Time/Performance (ms, %): 1-2 decimals - readable metrics
16
16
  *
17
17
  * ===============================================================================
18
- * TABLE OF CONTENTS (14 exported functions)
18
+ * TABLE OF CONTENTS (15 exported functions)
19
19
  * ===============================================================================
20
20
  *
21
21
  * SECTION 1: ASSET FORMATTING (4 functions)
@@ -24,22 +24,24 @@
24
24
  * 3. formatAmountByPrecision(value, precision) - Format using chain precision
25
25
  * 4. formatSizeByOrderType(value, orderType, assets) - Format order size by BUY/SELL asset precision
26
26
  *
27
- * SECTION 2: PRICE FORMATTING (3 functions)
28
- * 6. formatPrice(value) - Format to 8 decimals (maximum precision)
29
- * 7. formatPrice6(value) - Format to 6 decimals
30
- * 8. formatPrice4(value) - Format to 4 decimals (simplified display)
27
+ * SECTION 2: PRICE & FUNDS FORMATTING (5 functions)
28
+ * 5. formatPrice(value) - Format to 8 decimals (maximum precision)
29
+ * 6. formatPrice6(value) - Format to 6 decimals
30
+ * 7. formatPrice4(value) - Format to 4 decimals (simplified display)
31
+ * 8. formatCurrency(value, digits) - Grouped thousands with SI micro-suffixes
32
+ * 9. formatFundsValue(value) - Compact K/M, 4 significant figures (keeps trailing zeros)
31
33
  *
32
- * SECTION 3: PERCENTAGE FORMATTING (3 functions)
33
- * 9. formatPercent2(value) - Format to 2 decimals (spread %, ratios)
34
- * 10. formatPercent(value, decimals) - Format with custom decimal places
34
+ * SECTION 3: PERCENTAGE FORMATTING (2 functions)
35
+ * 10. formatPercent2(value) - Format to 2 decimals (spread %, ratios)
36
+ * 11. formatPercent(value, decimals) - Format with custom decimal places
35
37
  *
36
- * SECTION 4: RATIO/METRIC FORMATTING (3 functions)
37
- * 11. formatMetric2(value) - Format to 2 decimals (timing, performance)
38
+ * SECTION 4: RATIO/METRIC FORMATTING (1 function)
39
+ * 12. formatMetric2(value) - Format to 2 decimals (timing, performance)
38
40
  *
39
- * SECTION 5: HELPER UTILITIES (4 functions)
40
- * 12. isValidNumber(value) - Check if value is defined and finite
41
- * 13. toFiniteNumber(value, defaultValue) - Convert to finite number with fallback
42
- * 14. safeFormat(value, decimals, fallback) - Safely format with fallback
41
+ * SECTION 5: HELPER UTILITIES (3 functions)
42
+ * 13. isValidNumber(value) - Check if value is defined and finite
43
+ * 14. toFiniteNumber(value, defaultValue) - Convert to finite number with fallback
44
+ * 15. safeFormat(value, decimals, fallback) - Safely format with fallback
43
45
  *
44
46
  * ===============================================================================
45
47
  */
@@ -98,7 +100,7 @@ function formatSizeByOrderType(value, orderType, assets) {
98
100
  return formatAmountByPrecision(value, precision);
99
101
  }
100
102
  // ===============================================================================
101
- // SECTION 2: PRICE FORMATTING
103
+ // SECTION 2: PRICE & FUNDS FORMATTING
102
104
  // ===============================================================================
103
105
  /**
104
106
  * Format prices to 8 decimal places (maximum precision)
@@ -157,6 +159,50 @@ function formatCurrency(value, digits = 4) {
157
159
  ? formatted.replace(/\B(?=(\d{3})+(?!\d))/g, ',')
158
160
  : formatted;
159
161
  }
162
+ /**
163
+ * Format a value with compact K/M notation and exactly 4 significant figures
164
+ * for values that have more than 4. Unlike `formatCurrency`, this caps the
165
+ * significant digits of large magnitudes (e.g. a volume of 19,423,608.6 ->
166
+ * "19.42M") instead of keeping every integer digit, and it KEEPS significant
167
+ * trailing zeros rather than trimming them (1009.794 -> "1.010K", not "1.01K").
168
+ * Examples:
169
+ * 194395 -> "194.4K"
170
+ * 1009.794 -> "1.010K"
171
+ * 10000 -> "10.00K"
172
+ * 1000 -> "1.000K"
173
+ * 332.33 -> "332.3"
174
+ * 10.389 -> "10.39"
175
+ * 1500000 -> "1.500M"
176
+ * @param {number} value
177
+ * @returns {string}
178
+ */
179
+ function formatFundsValue(value) {
180
+ if (!Number.isFinite(value))
181
+ return 'N/A';
182
+ if (value === 0)
183
+ return '0';
184
+ const digits = 4;
185
+ const absValue = Math.abs(value);
186
+ let quotient;
187
+ let suffix = '';
188
+ if (absValue >= 1000000) {
189
+ quotient = value / 1000000;
190
+ suffix = 'M';
191
+ }
192
+ else if (absValue >= 1000) {
193
+ quotient = value / 1000;
194
+ suffix = 'K';
195
+ }
196
+ else {
197
+ quotient = value;
198
+ }
199
+ const absQ = Math.abs(quotient);
200
+ const intDigits = Math.floor(Math.log10(Math.max(absQ, 1e-10))) + 1;
201
+ const formatted = intDigits >= digits
202
+ ? String(Math.round(quotient))
203
+ : quotient.toFixed(digits - intDigits);
204
+ return formatted + suffix;
205
+ }
160
206
  // ===============================================================================
161
207
  // SECTION 3: PERCENTAGE FORMATTING
162
208
  // ===============================================================================
@@ -222,5 +268,5 @@ function safeFormat(value, decimals, fallback = 'N/A') {
222
268
  // ===============================================================================
223
269
  // EXPORTS
224
270
  // ===============================================================================
225
- export { formatAmount8, formatAmount, formatAmountByPrecision, formatSizeByOrderType, formatPrice, formatPrice6, formatPrice4, formatCurrency, formatPercent2, formatPercent, formatMetric2, isValidNumber, toFiniteNumber, safeFormat };
271
+ export { formatAmount8, formatAmount, formatAmountByPrecision, formatSizeByOrderType, formatPrice, formatPrice6, formatPrice4, formatCurrency, formatFundsValue, formatPercent2, formatPercent, formatMetric2, isValidNumber, toFiniteNumber, safeFormat };
226
272
  //# 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. */
@@ -65,24 +68,24 @@ export declare class MissingGenesisError extends Error {
65
68
  constructor(reason: string, detail: string, policy: OnMissingGenesisPolicy, mismatchRatio?: number | null);
66
69
  }
67
70
  /** True for a MissingGenesisError, including across module/realm duplication. */
68
- export declare function isMissingGenesisError(err: any): boolean;
71
+ export declare function isMissingGenesisError(err: unknown): err is MissingGenesisError;
69
72
  /**
70
73
  * True when `genesis` is a usable ladder: a non-empty priceLevels array. The
71
74
  * hash is deliberately not required here -- a tampered hash is warned about
72
75
  * and the ladder is still used for validation (the pre-existing contract), and
73
76
  * the persisted-row schema check lives at the source (`AccountOrders.loadGenesis`).
74
77
  */
75
- export declare function hasGenesisLadder(genesis: any): boolean;
78
+ export declare function hasGenesisLadder(genesis: unknown): genesis is GridGenesis;
76
79
  /**
77
80
  * Resolve the configured missing-genesis policy.
78
81
  * Unknown/absent values fall back to the default ('rebuild'); only an explicit
79
82
  * 'halt' opts into manual intervention.
80
- * @param {any} config - Bot/manager config (reads `gridLimits.MISSING_GENESIS_POLICY`).
83
+ * @param {unknown} config - Bot/manager config (reads `gridLimits.MISSING_GENESIS_POLICY`).
81
84
  * @returns {OnMissingGenesisPolicy}
82
85
  */
83
- export declare function resolveOnMissingGenesisPolicy(config: any): OnMissingGenesisPolicy;
86
+ export declare function resolveOnMissingGenesisPolicy(config: GridConfig | null | undefined): OnMissingGenesisPolicy;
84
87
  /** Ratio of persisted slots above which a config-derived rail is refused. */
85
- export declare function resolveMismatchRatioLimit(config: any): number;
88
+ export declare function resolveMismatchRatioLimit(config: GridConfig | null | undefined): number;
86
89
  /**
87
90
  * Build the migration ladder from the LIVE geometric rail
88
91
  * (startPrice/minPrice/maxPrice/incrementPercent). The geometry itself comes
@@ -94,9 +97,9 @@ export declare function resolveMismatchRatioLimit(config: any): number;
94
97
  * persisted array would permanently shrink the ladder.
95
98
  * @returns {{ok: true, genesis: any} | {ok: false, reason: string, detail: string}}
96
99
  */
97
- export declare function buildGenesisFromLiveRail(config: any): {
100
+ export declare function buildGenesisFromLiveRail(config: GridConfig | null | undefined): {
98
101
  ok: true;
99
- genesis: any;
102
+ genesis: GridGenesis;
100
103
  } | {
101
104
  ok: false;
102
105
  reason: string;
@@ -104,7 +107,7 @@ export declare function buildGenesisFromLiveRail(config: any): {
104
107
  };
105
108
  export type GenesisResolution = {
106
109
  ok: true;
107
- genesis: any;
110
+ genesis: GridGenesis | null;
108
111
  source: 'persisted' | 'in_memory' | 'migration';
109
112
  } | {
110
113
  ok: false;
@@ -130,19 +133,19 @@ export type GenesisResolution = {
130
133
  * verdict before it commits to a resume.
131
134
  *
132
135
  * @param {Object} params
133
- * @param {any} params.config - Live bot/manager config.
134
- * @param {any[]} params.grid - Persisted grid array (may be empty).
135
- * @param {any} [params.genesisInput] - Genesis supplied by the caller (snapshot row).
136
- * @param {any} [params.managerGenesis] - In-memory `manager._genesis`.
136
+ * @param {unknown} params.config - Live bot/manager config.
137
+ * @param {unknown[]} params.grid - Persisted grid array (may be empty).
138
+ * @param {unknown} [params.genesisInput] - Genesis supplied by the caller (snapshot row).
139
+ * @param {unknown} [params.managerGenesis] - In-memory `manager._genesis`.
137
140
  * @param {(msg: string, level?: string) => void} [params.log] - Logger sink for the cross-check verdict.
138
141
  * @param {string} [params.validationMode] - 'log' | 'enforce', for the warning text only.
139
142
  * @returns {GenesisResolution}
140
143
  */
141
144
  export declare function resolvePersistedGenesis({ config, grid, genesisInput, managerGenesis, log, validationMode }: {
142
- config: any;
143
- grid: any;
144
- genesisInput?: any;
145
- managerGenesis?: any;
145
+ config: GridConfig | null;
146
+ grid: unknown;
147
+ genesisInput?: unknown;
148
+ managerGenesis?: unknown;
146
149
  log?: (msg: string, level?: string) => void;
147
150
  validationMode?: string;
148
151
  }): GenesisResolution;
@@ -150,11 +153,11 @@ export declare function resolvePersistedGenesis({ config, grid, genesisInput, ma
150
153
  * Build the fault object for a refused snapshot, recording the policy and the
151
154
  * reason on the manager for observability (the soft half of the enforcement:
152
155
  * a counter/log is what tells an operator T2-T4 ever fire in the wild).
153
- * @param {any} manager
156
+ * @param {unknown} manager
154
157
  * @param {{reason: string, detail: string, mismatchRatio: number | null}} fault
155
158
  * @returns {MissingGenesisError}
156
159
  */
157
- export declare function recordMissingGenesisFault(manager: any, fault: {
160
+ export declare function recordMissingGenesisFault(manager: OrderManagerLike, fault: {
158
161
  reason: string;
159
162
  detail: string;
160
163
  mismatchRatio: number | null;
@@ -34,6 +34,7 @@
34
34
  * Option D ("always accept") in the paper, rejected as corruption risk.
35
35
  */
36
36
  import { GRID_LIMITS } from '../constants.js';
37
+ import { isUnknownRecord } from '../types.js';
37
38
  import { getErrorMessage } from '../utils/errors.js';
38
39
  import { assertSlotPriceInvariant, buildGenesisFromPriceLevels, calculateGapSlots, derivePriceLevels } from './utils/math.js';
39
40
  /** Why no ladder could be attached to a snapshot (paper T2-T4). */
@@ -77,7 +78,10 @@ export class MissingGenesisError extends Error {
77
78
  export function isMissingGenesisError(err) {
78
79
  if (err instanceof MissingGenesisError)
79
80
  return true;
80
- return !!err && typeof err === 'object' && err.name === 'MissingGenesisError' && typeof err.reason === 'string';
81
+ if (!err || typeof err !== 'object')
82
+ return false;
83
+ const candidate = err;
84
+ return candidate.name === 'MissingGenesisError' && typeof candidate.reason === 'string';
81
85
  }
82
86
  /**
83
87
  * True when `genesis` is a usable ladder: a non-empty priceLevels array. The
@@ -86,13 +90,13 @@ export function isMissingGenesisError(err) {
86
90
  * the persisted-row schema check lives at the source (`AccountOrders.loadGenesis`).
87
91
  */
88
92
  export function hasGenesisLadder(genesis) {
89
- return !!genesis && Array.isArray(genesis.priceLevels) && genesis.priceLevels.length > 0;
93
+ return !!genesis && isUnknownRecord(genesis) && Array.isArray(genesis.priceLevels) && genesis.priceLevels.length > 0;
90
94
  }
91
95
  /**
92
96
  * Resolve the configured missing-genesis policy.
93
97
  * Unknown/absent values fall back to the default ('rebuild'); only an explicit
94
98
  * 'halt' opts into manual intervention.
95
- * @param {any} config - Bot/manager config (reads `gridLimits.MISSING_GENESIS_POLICY`).
99
+ * @param {unknown} config - Bot/manager config (reads `gridLimits.MISSING_GENESIS_POLICY`).
96
100
  * @returns {OnMissingGenesisPolicy}
97
101
  */
98
102
  export function resolveOnMissingGenesisPolicy(config) {
@@ -171,10 +175,10 @@ export function buildGenesisFromLiveRail(config) {
171
175
  * verdict before it commits to a resume.
172
176
  *
173
177
  * @param {Object} params
174
- * @param {any} params.config - Live bot/manager config.
175
- * @param {any[]} params.grid - Persisted grid array (may be empty).
176
- * @param {any} [params.genesisInput] - Genesis supplied by the caller (snapshot row).
177
- * @param {any} [params.managerGenesis] - In-memory `manager._genesis`.
178
+ * @param {unknown} params.config - Live bot/manager config.
179
+ * @param {unknown[]} params.grid - Persisted grid array (may be empty).
180
+ * @param {unknown} [params.genesisInput] - Genesis supplied by the caller (snapshot row).
181
+ * @param {unknown} [params.managerGenesis] - In-memory `manager._genesis`.
178
182
  * @param {(msg: string, level?: string) => void} [params.log] - Logger sink for the cross-check verdict.
179
183
  * @param {string} [params.validationMode] - 'log' | 'enforce', for the warning text only.
180
184
  * @returns {GenesisResolution}
@@ -240,7 +244,7 @@ export function resolvePersistedGenesis({ config, grid, genesisInput = null, man
240
244
  * Build the fault object for a refused snapshot, recording the policy and the
241
245
  * reason on the manager for observability (the soft half of the enforcement:
242
246
  * a counter/log is what tells an operator T2-T4 ever fire in the wild).
243
- * @param {any} manager
247
+ * @param {unknown} manager
244
248
  * @param {{reason: string, detail: string, mismatchRatio: number | null}} fault
245
249
  * @returns {MissingGenesisError}
246
250
  */