dexbot 1.6.11 → 1.6.12

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (354) hide show
  1. package/CHANGELOG.md +35 -4
  2. package/README.md +2 -1
  3. package/analysis/README.md +2 -0
  4. package/analysis/tradingview/README.md +1 -1
  5. package/analysis/trend_detection/DYNAMIC_WEIGHT_RESEARCH.md +3 -3
  6. package/claw/docs/DEXBOT2_TUNING_CHEAT_SHEET.md +4 -3
  7. package/claw/modules/chain_broadcast.ts +7 -1
  8. package/claw/modules/claw_launcher.ts +1 -1
  9. package/claw/modules/launcher_mode_detector.ts +9 -2
  10. package/claw/package.json +1 -1
  11. package/claw/runtimes/openclaw-plugin/openclaw.plugin.json +1 -1
  12. package/claw/runtimes/openclaw-plugin/package.json +1 -1
  13. package/dist/analysis/account_resolver.d.ts +1 -1
  14. package/dist/analysis/account_resolver.js +2 -1
  15. package/dist/analysis/ama_fitting/analyze_ama_price_changes.js +3 -4
  16. package/dist/analysis/ama_fitting/analyze_lambda_vs_slow.js +2 -7
  17. package/dist/analysis/ama_fitting/calibrate_convergence_er.js +0 -1
  18. package/dist/analysis/ama_fitting/fetch_lp_candles.js +4 -4
  19. package/dist/analysis/ama_fitting/generate_unified_comparison_chart.d.ts +20 -4
  20. package/dist/analysis/ama_fitting/generate_unified_comparison_chart.js +9 -6
  21. package/dist/analysis/ama_fitting/optimizer_high_resolution.js +16 -12
  22. package/dist/analysis/analyze_args.d.ts +31 -0
  23. package/dist/analysis/analyze_args.js +41 -0
  24. package/dist/analysis/analyze_dynamic_weight.js +7 -17
  25. package/dist/analysis/analyze_kalman.js +7 -17
  26. package/dist/analysis/analyze_regime.js +7 -17
  27. package/dist/analysis/analyze_regime_windows.js +8 -18
  28. package/dist/analysis/analyze_risk_profile.js +8 -18
  29. package/dist/analysis/analyze_trade_heatmap.js +7 -17
  30. package/dist/analysis/analyze_volatility.js +7 -17
  31. package/dist/analysis/bot_fitting/backtest_ama_sweep.d.ts +220 -12
  32. package/dist/analysis/bot_fitting/backtest_ama_sweep.js +6 -5
  33. package/dist/analysis/bot_fitting/backtest_bot_fitting.d.ts +34 -4
  34. package/dist/analysis/bot_fitting/backtest_bot_fitting.js +11 -63
  35. package/dist/analysis/bot_fitting/shared_utils.d.ts +7 -7
  36. package/dist/analysis/bot_fitting/shared_utils.js +2 -2
  37. package/dist/analysis/bot_key_utils.d.ts +18 -10
  38. package/dist/analysis/bot_key_utils.js +7 -4
  39. package/dist/analysis/bot_usage/discover_bot_accounts.js +44 -47
  40. package/dist/analysis/bot_usage/kibana_bot_queries.d.ts +1 -21
  41. package/dist/analysis/chain_pool.d.ts +3 -1
  42. package/dist/analysis/chart_ui.d.ts +5 -2
  43. package/dist/analysis/chart_ui.js +6 -3
  44. package/dist/analysis/chart_utils.d.ts +5 -5
  45. package/dist/analysis/chart_utils.js +9 -0
  46. package/dist/analysis/fills_cache.d.ts +1 -1
  47. package/dist/analysis/fills_source.d.ts +2 -2
  48. package/dist/analysis/fills_source.js +14 -12
  49. package/dist/analysis/grid_correction_check.d.ts +1 -1
  50. package/dist/analysis/grid_correction_check.js +12 -11
  51. package/dist/analysis/math_utils.d.ts +7 -6
  52. package/dist/analysis/math_utils.js +5 -8
  53. package/dist/analysis/pnl_report.js +29 -29
  54. package/dist/analysis/price_sources.d.ts +8 -8
  55. package/dist/analysis/price_sources.js +5 -4
  56. package/dist/analysis/resolve_bot_accounts.js +2 -2
  57. package/dist/analysis/resolve_source.d.ts +1 -1
  58. package/dist/analysis/trade_profitability.d.ts +23 -2
  59. package/dist/analysis/trade_profitability.js +50 -50
  60. package/dist/analysis/tradingview/analyze_tradingview.d.ts +17 -6
  61. package/dist/analysis/tradingview/analyze_tradingview.js +6 -5
  62. package/dist/analysis/tradingview/grid_reset_config.d.ts +41 -32
  63. package/dist/analysis/tradingview/grid_reset_config.js +23 -11
  64. package/dist/analysis/tradingview/grid_reset_sim.d.ts +75 -9
  65. package/dist/analysis/tradingview/grid_reset_sim.js +4 -3
  66. package/dist/analysis/tradingview/tradingview_uplot_chart_generator.d.ts +69 -4
  67. package/dist/analysis/tradingview/tradingview_uplot_chart_generator.js +18 -19
  68. package/dist/analysis/trend_detection/backtest_ama_slope_huber.d.ts +1 -1
  69. package/dist/analysis/trend_detection/backtest_ama_slope_huber.js +5 -5
  70. package/dist/analysis/trend_detection/dynamic_weight_chart_generator.d.ts +63 -1
  71. package/dist/analysis/trend_detection/dynamic_weight_chart_generator.js +5 -4
  72. package/dist/analysis/trend_detection/huber_scale_variants.d.ts +9 -3
  73. package/dist/analysis/trend_detection/huber_scale_variants.js +4 -4
  74. package/dist/analysis/trend_detection/kalman_chart_generator.d.ts +30 -1
  75. package/dist/analysis/trend_detection/kalman_chart_generator.js +3 -3
  76. package/dist/analysis/trend_detection/regime_chart_generator.d.ts +31 -1
  77. package/dist/analysis/trend_detection/regime_chart_generator.js +2 -2
  78. package/dist/analysis/trend_detection/volatility_chart_generator.d.ts +33 -1
  79. package/dist/credential-daemon.js +34 -20
  80. package/dist/dexbot.js +11 -11
  81. package/dist/market_adapter/candle_utils.d.ts +22 -18
  82. package/dist/market_adapter/candle_utils.js +24 -20
  83. package/dist/market_adapter/core/asymmetric_bounds.d.ts +13 -4
  84. package/dist/market_adapter/core/config_normalizers.d.ts +3 -3
  85. package/dist/market_adapter/core/kibana_candles.d.ts +53 -18
  86. package/dist/market_adapter/core/kibana_candles.js +9 -7
  87. package/dist/market_adapter/core/kibana_client.d.ts +9 -1
  88. package/dist/market_adapter/core/kibana_client.js +8 -7
  89. package/dist/market_adapter/core/kibana_market_candles.d.ts +3 -2
  90. package/dist/market_adapter/core/market_adapter_service.d.ts +284 -117
  91. package/dist/market_adapter/core/market_adapter_service.js +137 -113
  92. package/dist/market_adapter/core/strategies/ama.d.ts +10 -2
  93. package/dist/market_adapter/core/strategies/ama.js +2 -4
  94. package/dist/market_adapter/core/strategies/ama_slope_model.d.ts +14 -1
  95. package/dist/market_adapter/core/strategies/ama_slope_model.js +12 -34
  96. package/dist/market_adapter/core/strategies/atr/calculator.d.ts +7 -2
  97. package/dist/market_adapter/core/strategies/atr/calculator.js +2 -34
  98. package/dist/market_adapter/core/strategies/collateral_manager.d.ts +7 -1
  99. package/dist/market_adapter/core/strategies/collateral_manager.js +0 -22
  100. package/dist/market_adapter/core/strategies/dynamic_weight_series.d.ts +34 -6
  101. package/dist/market_adapter/core/strategies/dynamic_weight_series.js +7 -7
  102. package/dist/market_adapter/core/strategies/regime_gate.d.ts +24 -15
  103. package/dist/market_adapter/core/strategies/regime_gate.js +4 -31
  104. package/dist/market_adapter/core/strategies/regime_interp.d.ts +7 -1
  105. package/dist/market_adapter/core/strategies/regime_interp.js +14 -22
  106. package/dist/market_adapter/core/strategies/volatility_shift.d.ts +11 -1
  107. package/dist/market_adapter/core/strategies/volatility_shift.js +0 -13
  108. package/dist/market_adapter/inputs/cex_candle_parsing.d.ts +29 -0
  109. package/dist/market_adapter/inputs/cex_candle_parsing.js +52 -0
  110. package/dist/market_adapter/inputs/fetch_book_data.d.ts +20 -4
  111. package/dist/market_adapter/inputs/fetch_book_data.js +3 -1
  112. package/dist/market_adapter/inputs/fetch_cex_synthetic_data.js +96 -224
  113. package/dist/market_adapter/inputs/fetch_lp_data.d.ts +42 -7
  114. package/dist/market_adapter/inputs/fetch_lp_data.js +22 -15
  115. package/dist/market_adapter/inputs/kibana_feed_source.d.ts +74 -15
  116. package/dist/market_adapter/inputs/kibana_feed_source.js +29 -22
  117. package/dist/market_adapter/inputs/kibana_source.d.ts +25 -3
  118. package/dist/market_adapter/inputs/kibana_source.js +2 -2
  119. package/dist/market_adapter/inputs/window_cache.d.ts +99 -94
  120. package/dist/market_adapter/inputs/window_cache.js +8 -8
  121. package/dist/market_adapter/interval_utils.d.ts +4 -4
  122. package/dist/market_adapter/log_format.d.ts +6 -6
  123. package/dist/market_adapter/log_format.js +28 -21
  124. package/dist/market_adapter/lp_chart_core.d.ts +22 -1
  125. package/dist/market_adapter/lp_chart_core.js +26 -192
  126. package/dist/market_adapter/lp_chart_runner.d.ts +7 -7
  127. package/dist/market_adapter/lp_chart_strategy_loader.d.ts +41 -6
  128. package/dist/market_adapter/lp_chart_strategy_loader.js +8 -7
  129. package/dist/market_adapter/market_adapter.d.ts +94 -32
  130. package/dist/market_adapter/market_adapter.js +67 -48
  131. package/dist/market_adapter/utils/adapter_client.d.ts +3 -3
  132. package/dist/market_adapter/utils/adapter_client.js +2 -2
  133. package/dist/market_adapter/utils/atomic_write.d.ts +8 -1
  134. package/dist/market_adapter/utils/chain.d.ts +50 -41
  135. package/dist/market_adapter/utils/chain.js +40 -46
  136. package/dist/market_adapter/utils/data_discovery.d.ts +4 -1
  137. package/dist/market_adapter/utils/dynamic_grid_snapshot.d.ts +12 -3
  138. package/dist/market_adapter/utils/file_json_cache.d.ts +2 -2
  139. package/dist/market_adapter/utils/file_lock.d.ts +28 -14
  140. package/dist/market_adapter/utils/file_lock.js +36 -32
  141. package/dist/market_adapter/utils/native_history.d.ts +9 -2
  142. package/dist/market_adapter/utils/native_history.js +35 -28
  143. package/dist/modules/account_bots.d.ts +577 -21
  144. package/dist/modules/account_bots.js +182 -158
  145. package/dist/modules/account_orders.d.ts +66 -30
  146. package/dist/modules/account_orders.js +22 -20
  147. package/dist/modules/authority_resolver.d.ts +12 -2
  148. package/dist/modules/authority_resolver.js +15 -8
  149. package/dist/modules/bitshares-native/chain_client.d.ts +38 -3
  150. package/dist/modules/bitshares-native/chain_client.js +45 -46
  151. package/dist/modules/bitshares-native/crypto/ecc.browser.js +11 -171
  152. package/dist/modules/bitshares-native/crypto/ecc.js +13 -176
  153. package/dist/modules/bitshares-native/crypto/ecc_core.d.ts +33 -0
  154. package/dist/modules/bitshares-native/crypto/ecc_core.js +213 -0
  155. package/dist/modules/bitshares-native/crypto/ecc_selector.d.ts +2 -1
  156. package/dist/modules/bitshares-native/crypto/ecc_selector.js +1 -13
  157. package/dist/modules/bitshares-native/index.d.ts +1 -1
  158. package/dist/modules/bitshares-native/lru_cache.d.ts +7 -7
  159. package/dist/modules/bitshares-native/resolvers.d.ts +18 -6
  160. package/dist/modules/bitshares-native/serial/lazy_buffer.d.ts +4 -0
  161. package/dist/modules/bitshares-native/serial/lazy_buffer.js +21 -0
  162. package/dist/modules/bitshares-native/serial/operations.d.ts +1 -1
  163. package/dist/modules/bitshares-native/serial/serializer.d.ts +16 -12
  164. package/dist/modules/bitshares-native/serial/serializer.js +7 -13
  165. package/dist/modules/bitshares-native/serial/types.d.ts +25 -16
  166. package/dist/modules/bitshares-native/serial/types.js +55 -62
  167. package/dist/modules/bitshares-native/signing_client.d.ts +32 -2
  168. package/dist/modules/bitshares-native/signing_client.js +19 -14
  169. package/dist/modules/bitshares-native/subscriptions.d.ts +81 -1
  170. package/dist/modules/bitshares-native/subscriptions.js +12 -12
  171. package/dist/modules/bitshares-native/transport.d.ts +5 -4
  172. package/dist/modules/bitshares-native/transport.js +5 -4
  173. package/dist/modules/bitshares-native/tx/builder.d.ts +40 -5
  174. package/dist/modules/bitshares-native/tx/builder.js +4 -3
  175. package/dist/modules/bitshares-native/tx/tx_cache.d.ts +4 -4
  176. package/dist/modules/bitshares_client.d.ts +45 -13
  177. package/dist/modules/bitshares_client.js +28 -19
  178. package/dist/modules/bot_defaults.d.ts +6 -15
  179. package/dist/modules/bot_defaults.js +1 -5
  180. package/dist/modules/bot_settings.d.ts +44 -10
  181. package/dist/modules/bot_settings.js +11 -8
  182. package/dist/modules/bots_file_lock.d.ts +6 -6
  183. package/dist/modules/bots_file_lock.js +16 -12
  184. package/dist/modules/broadcast_failure.d.ts +2 -2
  185. package/dist/modules/broadcast_failure.js +5 -4
  186. package/dist/modules/chain_keys.d.ts +42 -40
  187. package/dist/modules/chain_keys.js +53 -45
  188. package/dist/modules/chain_orders.d.ts +93 -59
  189. package/dist/modules/chain_orders.js +31 -23
  190. package/dist/modules/constants.d.ts +527 -31
  191. package/dist/modules/constants.js +15 -47
  192. package/dist/modules/cr_planner.d.ts +40 -2
  193. package/dist/modules/credential_policy.d.ts +68 -8
  194. package/dist/modules/credential_policy.js +37 -31
  195. package/dist/modules/credential_session_cache.d.ts +2 -2
  196. package/dist/modules/credit_pricing.d.ts +42 -6
  197. package/dist/modules/credit_pricing.js +44 -30
  198. package/dist/modules/credit_runtime.d.ts +276 -118
  199. package/dist/modules/credit_runtime.js +462 -165
  200. package/dist/modules/crypto/browser_provider.js +6 -4
  201. package/dist/modules/crypto/node_provider.js +1 -1
  202. package/dist/modules/crypto/pure_scrypt.js +35 -4
  203. package/dist/modules/crypto/pure_secp256k1.js +72 -26
  204. package/dist/modules/crypto/sync.d.ts +9 -9
  205. package/dist/modules/crypto/sync.js +16 -9
  206. package/dist/modules/dexbot_class.d.ts +195 -139
  207. package/dist/modules/dexbot_class.js +78 -28
  208. package/dist/modules/dexbot_cow_runtime.d.ts +167 -87
  209. package/dist/modules/dexbot_cow_runtime.js +248 -206
  210. package/dist/modules/dexbot_credential_client.d.ts +19 -11
  211. package/dist/modules/dexbot_fill_runtime.d.ts +63 -48
  212. package/dist/modules/dexbot_fill_runtime.js +48 -41
  213. package/dist/modules/dexbot_maintenance_runtime.d.ts +109 -70
  214. package/dist/modules/dexbot_maintenance_runtime.js +108 -83
  215. package/dist/modules/dexbot_startup_runtime.d.ts +11 -10
  216. package/dist/modules/dexbot_startup_runtime.js +43 -43
  217. package/dist/modules/dexbot_state_recovery.d.ts +13 -12
  218. package/dist/modules/dexbot_state_recovery.js +18 -13
  219. package/dist/modules/fund_registry.d.ts +4 -2
  220. package/dist/modules/fund_registry.js +10 -10
  221. package/dist/modules/general_settings.d.ts +30 -4
  222. package/dist/modules/graceful_shutdown.d.ts +3 -3
  223. package/dist/modules/graceful_shutdown.js +2 -2
  224. package/dist/modules/grid_price_source.d.ts +1 -1
  225. package/dist/modules/key_store.d.ts +14 -8
  226. package/dist/modules/key_store.js +7 -6
  227. package/dist/modules/launcher/adapter_requirement.d.ts +11 -5
  228. package/dist/modules/launcher/adapter_requirement.js +5 -5
  229. package/dist/modules/launcher/bot_supervisor.d.ts +106 -24
  230. package/dist/modules/launcher/bot_supervisor.js +12 -11
  231. package/dist/modules/launcher/credential_bootstrap.d.ts +1 -1
  232. package/dist/modules/launcher/credential_bootstrap.js +1 -1
  233. package/dist/modules/launcher/credential_daemon.d.ts +4 -4
  234. package/dist/modules/launcher/credential_daemon.js +2 -2
  235. package/dist/modules/launcher/credential_secret.d.ts +1 -1
  236. package/dist/modules/launcher/foreign_cred_daemon.d.ts +2 -2
  237. package/dist/modules/launcher/market_adapter_runtime.d.ts +61 -6
  238. package/dist/modules/launcher/market_adapter_watchdog.d.ts +10 -2
  239. package/dist/modules/launcher/market_adapter_watchdog.js +4 -0
  240. package/dist/modules/launcher/monolithic_runtime.d.ts +18 -16
  241. package/dist/modules/launcher/status_reporting.d.ts +22 -14
  242. package/dist/modules/launcher/supervisor_control.d.ts +8 -1
  243. package/dist/modules/launcher/supervisor_control.js +4 -2
  244. package/dist/modules/market_adapter_whitelist.d.ts +9 -3
  245. package/dist/modules/market_adapter_whitelist.js +15 -3
  246. package/dist/modules/node_manager.d.ts +41 -11
  247. package/dist/modules/node_manager.js +5 -4
  248. package/dist/modules/order/accounting.d.ts +53 -24
  249. package/dist/modules/order/accounting.js +16 -15
  250. package/dist/modules/order/async_lock.d.ts +5 -2
  251. package/dist/modules/order/async_lock.js +1 -1
  252. package/dist/modules/order/export.d.ts +7 -6
  253. package/dist/modules/order/export.js +1 -7
  254. package/dist/modules/order/format.d.ts +4 -4
  255. package/dist/modules/order/genesis_policy.d.ts +21 -18
  256. package/dist/modules/order/genesis_policy.js +12 -8
  257. package/dist/modules/order/grid.d.ts +142 -36
  258. package/dist/modules/order/grid.js +148 -123
  259. package/dist/modules/order/grid_reconcile.d.ts +21 -20
  260. package/dist/modules/order/grid_reconcile.js +13 -12
  261. package/dist/modules/order/grid_reconcile_internal.d.ts +85 -72
  262. package/dist/modules/order/grid_reconcile_internal.js +28 -19
  263. package/dist/modules/order/index.d.ts +263 -1
  264. package/dist/modules/order/logger.d.ts +45 -11
  265. package/dist/modules/order/logger.js +38 -40
  266. package/dist/modules/order/logger_state.d.ts +4 -4
  267. package/dist/modules/order/manager.d.ts +225 -180
  268. package/dist/modules/order/manager.js +80 -83
  269. package/dist/modules/order/processed_fill_store.d.ts +18 -3
  270. package/dist/modules/order/processed_fill_store.js +16 -27
  271. package/dist/modules/order/strategy.d.ts +21 -13
  272. package/dist/modules/order/strategy.js +5 -6
  273. package/dist/modules/order/sync_engine.d.ts +91 -33
  274. package/dist/modules/order/sync_engine.js +84 -53
  275. package/dist/modules/order/utils/math.d.ts +157 -102
  276. package/dist/modules/order/utils/math.js +77 -38
  277. package/dist/modules/order/utils/order.d.ts +310 -110
  278. package/dist/modules/order/utils/order.js +122 -99
  279. package/dist/modules/order/utils/slot.d.ts +1 -1
  280. package/dist/modules/order/utils/system.d.ts +176 -26
  281. package/dist/modules/order/utils/system.js +86 -69
  282. package/dist/modules/order/utils/validate.d.ts +89 -41
  283. package/dist/modules/order/utils/validate.js +24 -22
  284. package/dist/modules/order/utils/withPoolRef.d.ts +4 -3
  285. package/dist/modules/order/utils/withPoolRef.js +18 -12
  286. package/dist/modules/order/working_grid.d.ts +14 -13
  287. package/dist/modules/paths.d.ts +1 -4
  288. package/dist/modules/paths.js +1 -27
  289. package/dist/modules/process_discovery.d.ts +1 -1
  290. package/dist/modules/process_discovery.js +2 -1
  291. package/dist/modules/runtime.d.ts +7 -3
  292. package/dist/modules/runtime.js +4 -3
  293. package/dist/modules/runtime_settings.d.ts +15 -10
  294. package/dist/modules/runtime_settings.js +30 -24
  295. package/dist/modules/settings_merge.d.ts +29 -3
  296. package/dist/modules/settings_merge.js +56 -78
  297. package/dist/modules/socket_json_client.d.ts +7 -4
  298. package/dist/modules/storage/browser_adapter.d.ts +38 -53
  299. package/dist/modules/storage/browser_adapter.js +7 -30
  300. package/dist/modules/storage/index.d.ts +1 -1
  301. package/dist/modules/storage/node_adapter.d.ts +45 -27
  302. package/dist/modules/storage/node_adapter.js +9 -9
  303. package/dist/modules/storage/types.d.ts +5 -4
  304. package/dist/modules/types.d.ts +1071 -2
  305. package/dist/modules/types.js +4 -1
  306. package/dist/modules/utils/asset_symbols.d.ts +2 -1
  307. package/dist/modules/utils/asset_symbols.js +2 -1
  308. package/dist/modules/utils/errors.d.ts +9 -0
  309. package/dist/modules/utils/errors.js +23 -1
  310. package/dist/modules/utils/time_range.d.ts +1 -12
  311. package/dist/modules/utils/time_range.js +1 -1
  312. package/dist/modules/validate_profiles.js +53 -43
  313. package/dist/modules/version_notice.d.ts +14 -3
  314. package/dist/modules/version_notice.js +6 -4
  315. package/dist/pm2.d.ts +29 -27
  316. package/dist/pm2.js +5 -5
  317. package/dist/scripts/analyze-credit.d.ts +2 -1
  318. package/dist/scripts/analyze-credit.js +23 -24
  319. package/dist/scripts/analyze-orders.d.ts +77 -9
  320. package/dist/scripts/analyze-orders.js +65 -40
  321. package/dist/scripts/chart_command.d.ts +27 -18
  322. package/dist/scripts/chart_command.js +13 -11
  323. package/dist/scripts/check_any.d.ts +18 -0
  324. package/dist/scripts/check_any.js +126 -0
  325. package/dist/scripts/diagnose-pool-history.js +12 -7
  326. package/dist/scripts/print_grid.js +0 -1
  327. package/dist/scripts/run-tests.js +39 -7
  328. package/dist/scripts/runner.js +1 -1
  329. package/dist/scripts/test-credit-renewal.js +30 -21
  330. package/dist/scripts/update.d.ts +10 -5
  331. package/dist/scripts/update.js +168 -103
  332. package/dist/scripts/update_dist_freshness.js +1 -0
  333. package/dist/scripts/update_layout.d.ts +61 -0
  334. package/dist/scripts/update_layout.js +180 -0
  335. package/dist/scripts/validate_bots.js +2 -1
  336. package/dist/scripts/verify-browser-bundle.js +8 -0
  337. package/dist/unlock.d.ts +28 -3
  338. package/dist/unlock.js +63 -35
  339. package/docs/BITSHARES_ONBOARDING.md +2 -0
  340. package/docs/COPY_ON_WRITE_MASTER_PLAN.md +1 -1
  341. package/docs/COW_INVARIANTS.md +13 -6
  342. package/docs/DEXBOT_COMPARISON.md +8 -8
  343. package/docs/EVOLUTION.md +10 -9
  344. package/docs/FUND_MOVEMENT_AND_ACCOUNTING.md +5 -5
  345. package/docs/GRID_RECALCULATION.md +4 -2
  346. package/docs/GRID_RECONCILE.md +14 -3
  347. package/docs/LIFECYCLE.md +11 -11
  348. package/docs/MPA_CREDIT_USAGE.md +22 -3
  349. package/docs/README.md +14 -3
  350. package/docs/architecture.md +12 -9
  351. package/docs/developer_guide.md +6 -6
  352. package/market_adapter/README.md +6 -1
  353. package/modules/README.md +4 -1
  354. package/package.json +4 -1
@@ -58,6 +58,7 @@
58
58
  *
59
59
  * ===============================================================================
60
60
  */
61
+ import AsyncLock from './order/async_lock.js';
61
62
  import { sanitizeKey } from './utils/sanitize_key.js';
62
63
  /**
63
64
  * Generate a unique key for identifying a bot in storage.
@@ -68,7 +69,47 @@ import { sanitizeKey } from './utils/sanitize_key.js';
68
69
  * @param {number} index - Index in bots array (used for unnamed fallback)
69
70
  * @returns {string} Sanitized key
70
71
  */
71
- declare function createBotKey(bot: any, index: any): string;
72
+ declare function createBotKey(bot: Record<string, unknown> | null | undefined, index: number): string;
73
+ interface BotMeta {
74
+ key: string;
75
+ name: string | null;
76
+ assetA: string | null;
77
+ assetB: string | null;
78
+ active: boolean;
79
+ index: number;
80
+ createdAt: string;
81
+ updatedAt: string;
82
+ }
83
+ interface SerializedOrder {
84
+ id: string | null;
85
+ type: string | null;
86
+ state: string | null;
87
+ price: number;
88
+ size: number;
89
+ orderId: string;
90
+ createUncertain?: boolean;
91
+ }
92
+ interface BotData {
93
+ meta: BotMeta | null;
94
+ grid: SerializedOrder[];
95
+ btsFeesOwed: number;
96
+ btsBalance: Record<string, unknown> | null;
97
+ boundaryIdx: number | null;
98
+ assets: Record<string, unknown> | null;
99
+ debugInputs: Record<string, unknown> | null;
100
+ processedFills: Record<string, number>;
101
+ recentFillKeys: Record<string, unknown>;
102
+ genesis: Record<string, unknown> | null;
103
+ createdAt: string;
104
+ lastUpdated: string;
105
+ gapEvacStreaks?: Record<string, number>;
106
+ pendingFillCrawls?: {
107
+ slotId: string;
108
+ side: string;
109
+ ts: number;
110
+ }[];
111
+ lastFillPivot?: unknown;
112
+ }
72
113
  /**
73
114
  * AccountOrders class - manages order grid persistence
74
115
  *
@@ -85,9 +126,13 @@ declare function createBotKey(bot: any, index: any): string;
85
126
  declare class AccountOrders {
86
127
  botKey: string;
87
128
  profilesPath: string;
88
- _persistenceLock: any;
129
+ _persistenceLock: AsyncLock;
89
130
  _needsBootstrapSave: boolean;
90
- data: any;
131
+ data: BotData;
132
+ _rejectedGenesis?: {
133
+ reason: string;
134
+ at: number;
135
+ };
91
136
  /**
92
137
  * Create an AccountOrders instance.
93
138
  * @param {Object} options - Configuration options
@@ -105,14 +150,14 @@ declare class AccountOrders {
105
150
  * @returns {Object|null} The loaded data or null if not found.
106
151
  * @private
107
152
  */
108
- _loadData(): any;
153
+ _loadData(): BotData | null;
109
154
  /**
110
155
  * Reads and parses a JSON file.
111
156
  * @param {string} filePath - The path to the file.
112
157
  * @returns {Object|null} The parsed object or null on failure.
113
158
  * @private
114
159
  */
115
- _readFile(filePath: any): any;
160
+ _readFile(filePath: string): BotData | null;
116
161
  /**
117
162
  * Persists the current data to the profile file.
118
163
  * @private
@@ -124,7 +169,7 @@ declare class AccountOrders {
124
169
  * meta in place if it has drifted. The grid and other state are not touched.
125
170
  * @param {Object} botConfig - The bot config matching this.botKey
126
171
  */
127
- syncMeta(botConfig: any): Promise<void>;
172
+ syncMeta(botConfig: unknown): Promise<void>;
128
173
  /**
129
174
  * Checks whether two meta objects differ on the relevant fields.
130
175
  * @param {Object} existing - The existing meta (possibly null).
@@ -132,7 +177,7 @@ declare class AccountOrders {
132
177
  * @returns {boolean} True if meta has changed.
133
178
  * @private
134
179
  */
135
- _metaChanged(existing: any, next: any): boolean;
180
+ _metaChanged(existing: BotMeta | null, next: BotMeta): boolean;
136
181
  /**
137
182
  * Builds a metadata object for a bot.
138
183
  * @param {Object} bot - The bot configuration.
@@ -142,18 +187,9 @@ declare class AccountOrders {
142
187
  * @returns {Object} The new meta object.
143
188
  * @private
144
189
  */
145
- _buildMeta(bot: any, key: string, index: number, existing?: {
190
+ _buildMeta(bot: unknown, key: string, index: number, existing?: {
146
191
  createdAt?: string;
147
- } | null): {
148
- key: string;
149
- name: any;
150
- assetA: any;
151
- assetB: any;
152
- active: boolean;
153
- index: number;
154
- createdAt: string;
155
- updatedAt: string;
156
- };
192
+ } | null): BotMeta;
157
193
  /**
158
194
  * Save the current order grid snapshot for this bot.
159
195
  * Called after grid changes (initialization, fills, syncs).
@@ -165,7 +201,7 @@ declare class AccountOrders {
165
201
  * @param {Object|null} recentFillKeys - Optional fill key dedup snapshot for crash recovery
166
202
  * @param {Object|null} genesis - Optional frozen genesis (priceLevels etc)
167
203
  */
168
- storeMasterGrid(orders?: any[], btsFeesOwed?: any, boundaryIdx?: any, assets?: any, debugInputs?: any, recentFillKeys?: any, genesis?: any, gapEvacStreaks?: any, pendingFillCrawls?: any, lastFillPivot?: any): Promise<void>;
204
+ storeMasterGrid(orders?: unknown[], btsFeesOwed?: number | null, boundaryIdx?: number | null, assets?: Record<string, unknown> | null, debugInputs?: unknown, recentFillKeys?: Record<string, unknown> | null, genesis?: unknown, gapEvacStreaks?: unknown, pendingFillCrawls?: unknown, lastFillPivot?: unknown): Promise<void>;
169
205
  /**
170
206
  * Erase a poisoned persisted boundary after GRID-LOAD rejects it with no
171
207
  * safe re-derivation. storeMasterGrid deliberately never writes a null
@@ -194,7 +230,7 @@ declare class AccountOrders {
194
230
  * @param {boolean} forceReload - If true, reload from disk to ensure fresh data
195
231
  * @returns {Array|null} Order grid array or null if not found
196
232
  */
197
- loadGrid(forceReload?: boolean): any;
233
+ loadGrid(forceReload?: boolean): SerializedOrder[] | null;
198
234
  /**
199
235
  * Load the persisted price-ladder (genesis) for this bot.
200
236
  *
@@ -212,7 +248,7 @@ declare class AccountOrders {
212
248
  * @param {boolean} forceReload - If true, reload from disk
213
249
  * @returns {Object|null} The genesis object, or null when absent/invalid
214
250
  */
215
- loadGenesis(forceReload?: boolean): any;
251
+ loadGenesis(forceReload?: boolean): import("./order/utils/math.js").GridGenesis | null;
216
252
  /**
217
253
  * Record why a persisted genesis row was refused (observability for the
218
254
  * schema gate above; loadGrid cannot report a row it never receives).
@@ -223,7 +259,7 @@ declare class AccountOrders {
223
259
  * @param {boolean} forceReload - If true, reload from disk
224
260
  * @returns {Object|null} {slotId: count} map or null when absent
225
261
  */
226
- loadGapEvacStreaks(forceReload?: boolean): any;
262
+ loadGapEvacStreaks(forceReload?: boolean): Record<string, number> | null;
227
263
  loadLastFillPivot(forceReload?: boolean): {
228
264
  price: number;
229
265
  type: string;
@@ -245,13 +281,13 @@ declare class AccountOrders {
245
281
  * @param {boolean} forceReload - If true, reload from disk
246
282
  * @returns {Object|null} Recent fill keys map or null if not found
247
283
  */
248
- loadRecentFillKeys(forceReload?: boolean): any;
284
+ loadRecentFillKeys(forceReload?: boolean): Record<string, unknown> | null;
249
285
  /**
250
286
  * Load persisted asset metadata for this bot.
251
287
  * @param {boolean} forceReload - If true, reload from disk
252
288
  * @returns {Object|null} Asset metadata { assetA, assetB } or null if not found
253
289
  */
254
- loadPersistedAssets(forceReload?: boolean): any;
290
+ loadPersistedAssets(forceReload?: boolean): Record<string, unknown> | null;
255
291
  /**
256
292
  * Load the master boundary index for this bot.
257
293
  * @param {boolean} forceReload - If true, reload from disk
@@ -263,7 +299,7 @@ declare class AccountOrders {
263
299
  * @param {boolean} forceReload - If true, reload from disk
264
300
  * @returns {Object|null} BTS balance { free, total, locked } or null if not found
265
301
  */
266
- loadBtsBalance(forceReload?: boolean): any;
302
+ loadBtsBalance(forceReload?: boolean): Record<string, unknown> | null;
267
303
  /**
268
304
  * Load BTS blockchain fees owed for this bot.
269
305
  * BTS fees accumulate during fill processing and must persist across restarts
@@ -276,7 +312,7 @@ declare class AccountOrders {
276
312
  * Clear the persisted grid for this bot.
277
313
  * @returns {Promise<boolean>} true if cleared successfully
278
314
  */
279
- clearGrid(): Promise<any>;
315
+ clearGrid(): Promise<boolean>;
280
316
  /**
281
317
  * Load processed fill IDs for this bot to prevent reprocessing fills across
282
318
  * restarts. Returns a Map of fillKey => timestamp for fills already processed.
@@ -315,9 +351,9 @@ declare class AccountOrders {
315
351
  };
316
352
  meta: {
317
353
  key: string;
318
- name: any;
319
- assetA: any;
320
- assetB: any;
354
+ name: string | null;
355
+ assetA: string | null;
356
+ assetB: string | null;
321
357
  };
322
358
  } | null;
323
359
  /**
@@ -326,7 +362,7 @@ declare class AccountOrders {
326
362
  * @returns {Object} The serialized order.
327
363
  * @private
328
364
  */
329
- _serializeOrder(order?: any): Record<string, any>;
365
+ _serializeOrder(order?: unknown): SerializedOrder;
330
366
  }
331
367
  export { AccountOrders, createBotKey, sanitizeKey };
332
368
  //# sourceMappingURL=account_orders.d.ts.map
@@ -68,7 +68,7 @@ import { hasGenesisLadder } from './order/genesis_policy.js';
68
68
  import * as Format from './order/format.js';
69
69
  import { ensureDir, nowIso, normalizeLastFillPivot } from './order/utils/system.js';
70
70
  import Logger from './order/logger.js';
71
- import { getErrorMessage } from './utils/errors.js';
71
+ import { getErrorMessage, getErrorCode } from './utils/errors.js';
72
72
  import { sanitizeKey } from './utils/sanitize_key.js';
73
73
  const storage = getStorage();
74
74
  const { toFiniteNumber } = Format;
@@ -176,6 +176,7 @@ class AccountOrders {
176
176
  _persistenceLock;
177
177
  _needsBootstrapSave;
178
178
  data;
179
+ _rejectedGenesis;
179
180
  /**
180
181
  * Create an AccountOrders instance.
181
182
  * @param {Object} options - Configuration options
@@ -220,7 +221,7 @@ class AccountOrders {
220
221
  return parsed;
221
222
  }
222
223
  catch (err) {
223
- if (err?.code === 'ENOENT') {
224
+ if (getErrorCode(err) === 'ENOENT') {
224
225
  return null;
225
226
  }
226
227
  if (err instanceof SyntaxError) {
@@ -252,7 +253,8 @@ class AccountOrders {
252
253
  await this._persistenceLock.acquire(async () => {
253
254
  // Reload from disk to ensure we have the latest state
254
255
  this.data = this._loadData() || emptyData();
255
- const newMeta = this._buildMeta(botConfig, this.botKey, botConfig.botIndex ?? 0, this.data.meta);
256
+ const cfg = botConfig;
257
+ const newMeta = this._buildMeta(botConfig, this.botKey, typeof cfg.botIndex === 'number' ? cfg.botIndex : 0, this.data.meta);
256
258
  const prevMeta = this.data.meta;
257
259
  if (this._metaChanged(prevMeta, newMeta)) {
258
260
  accountOrdersLogger.info(`Metadata changed for bot ${this.botKey}: updating from old metadata to new`);
@@ -296,12 +298,13 @@ class AccountOrders {
296
298
  */
297
299
  _buildMeta(bot, key, index, existing = null) {
298
300
  const timestamp = nowIso();
301
+ const b = bot;
299
302
  return {
300
303
  key,
301
- name: bot.name || null,
302
- assetA: bot.assetA || null,
303
- assetB: bot.assetB || null,
304
- active: !!bot.active,
304
+ name: b.name || null,
305
+ assetA: b.assetA || null,
306
+ assetB: b.assetB || null,
307
+ active: !!b.active,
305
308
  index,
306
309
  createdAt: (existing && existing.createdAt) || timestamp,
307
310
  updatedAt: timestamp
@@ -342,10 +345,6 @@ class AccountOrders {
342
345
  if (debugSnapshot && debugSnapshot.btsBalance) {
343
346
  this.data.btsBalance = debugSnapshot.btsBalance;
344
347
  }
345
- // Initialize processedFills if missing (backward compat)
346
- if (!this.data.processedFills) {
347
- this.data.processedFills = {};
348
- }
349
348
  // Persist recent fill keys for crash-durable dedup window
350
349
  if (recentFillKeys) {
351
350
  this.data.recentFillKeys = recentFillKeys;
@@ -517,9 +516,11 @@ class AccountOrders {
517
516
  */
518
517
  _noteRejectedGenesis(genesis) {
519
518
  try {
520
- const reason = !Array.isArray(genesis?.priceLevels)
519
+ const g = (genesis && typeof genesis === 'object') ? genesis : null;
520
+ const levels = g?.priceLevels;
521
+ const reason = !Array.isArray(levels)
521
522
  ? 'priceLevels is not an array'
522
- : (genesis?.priceLevels?.length === 0 ? 'priceLevels is empty' : 'malformed');
523
+ : (levels.length === 0 ? 'priceLevels is empty' : 'malformed');
523
524
  this._rejectedGenesis = { reason, at: Date.now() };
524
525
  }
525
526
  catch { /* never fail a load for telemetry */ }
@@ -788,20 +789,21 @@ class AccountOrders {
788
789
  * @private
789
790
  */
790
791
  _serializeOrder(order = {}) {
791
- const priceValue = toFiniteNumber(order.price);
792
- const sizeValue = toFiniteNumber(order.size);
792
+ const o = order;
793
+ const priceValue = toFiniteNumber(o.price);
794
+ const sizeValue = toFiniteNumber(o.size);
793
795
  // SANITY CHECK: If order is ACTIVE/PARTIAL but has no orderId, it's corrupted.
794
796
  // Downgrade to VIRTUAL to prevent persisting phantom active orders.
795
797
  // This fixes the root cause of "Active No ID" state in JSON files.
796
- let state = order.state || null;
797
- let orderId = order.orderId || '';
798
+ let state = o.state || null;
799
+ let orderId = o.orderId || '';
798
800
  if (isPhantomOrder(order)) {
799
801
  state = ORDER_STATES.VIRTUAL;
800
802
  orderId = '';
801
803
  }
802
804
  const serialized = {
803
- id: order.id || null,
804
- type: order.type || null,
805
+ id: o.id || null,
806
+ type: o.type || null,
805
807
  state: state,
806
808
  price: Number.isFinite(priceValue) ? priceValue : 0,
807
809
  size: Number.isFinite(sizeValue) ? sizeValue : 0,
@@ -811,7 +813,7 @@ class AccountOrders {
811
813
  // leaves the slot VIRTUAL with its planned size. Only that flagged state
812
814
  // is a true sized-orphan candidate at load (grid.ts sanitizer) — plain
813
815
  // sized VIRTUAL slots are the normal planned-but-unplaced grid state.
814
- if (order.createUncertain === true) {
816
+ if (o.createUncertain === true) {
815
817
  serialized.createUncertain = true;
816
818
  }
817
819
  return serialized;
@@ -1,3 +1,13 @@
1
+ interface ChainClientLike {
2
+ db: {
3
+ get_full_accounts(accounts: string[], subscribe: boolean): Promise<unknown>;
4
+ };
5
+ getConfig?(): {
6
+ addressPrefix?: string;
7
+ } | null;
8
+ }
9
+ type TryGetKey = (name: string) => Promise<string | null>;
10
+ type ListNames = () => string[];
1
11
  /**
2
12
  * Resolve a signing key for an account by walking on-chain authority structures.
3
13
  *
@@ -24,10 +34,10 @@
24
34
  * @param {Map<string,string>} [pubKeyCache] - Per-call cache for derived public keys (internal)
25
35
  * @returns {Promise<string>} Private key WIF string
26
36
  */
27
- declare function resolvePrivateKey(accountName: any, chainClient: any, tryGetKey: any, listNames: any, depth?: any, pubKeyCache?: any): Promise<any>;
37
+ declare function resolvePrivateKey(accountName: string, chainClient: ChainClientLike, tryGetKey: TryGetKey, listNames: ListNames, depth?: number, pubKeyCache?: Map<string, string>): Promise<string>;
28
38
  /**
29
39
  * Resolve account ID (1.2.x) to account name via chain.
30
40
  */
31
- declare function resolveAccountIdToName(chainClient: any, accountId: any): Promise<any>;
41
+ declare function resolveAccountIdToName(chainClient: ChainClientLike, accountId: string | number): Promise<string>;
32
42
  export { resolvePrivateKey, resolveAccountIdToName };
33
43
  //# sourceMappingURL=authority_resolver.d.ts.map
@@ -49,10 +49,11 @@ async function resolvePrivateKey(accountName, chainClient, tryGetKey, listNames,
49
49
  catch (e) {
50
50
  throw new Error(`Failed to fetch account '${accountName}' from chain: ${getErrorMessage(e)}`);
51
51
  }
52
- if (!full || !full[0] || !full[0][1] || !full[0][1].account) {
52
+ const fullRows = full;
53
+ if (!fullRows || !fullRows[0] || !fullRows[0][1] || !fullRows[0][1].account) {
53
54
  throw new Error(`Account '${accountName}' not found on chain`);
54
55
  }
55
- const account = full[0][1].account;
56
+ const account = fullRows[0][1].account;
56
57
  const active = account.active;
57
58
  if (!active || typeof active.weight_threshold === 'undefined') {
58
59
  throw new Error(`Account '${accountName}' has no active authority`);
@@ -130,7 +131,7 @@ function normalizeAuthMap(auth) {
130
131
  return [];
131
132
  if (Array.isArray(auth))
132
133
  return auth;
133
- return Object.entries(auth);
134
+ return Object.entries(auth).map(([k, v]) => [k, Number(v)]);
134
135
  }
135
136
  /**
136
137
  * Resolve account ID (1.2.x) to account name via chain.
@@ -138,9 +139,10 @@ function normalizeAuthMap(auth) {
138
139
  async function resolveAccountIdToName(chainClient, accountId) {
139
140
  if (!/^1\.2\./.test(String(accountId)))
140
141
  return String(accountId);
141
- const full = await chainClient.db.get_full_accounts([accountId], false);
142
- if (full && full[0] && full[0][1] && full[0][1].account && full[0][1].account.name) {
143
- return full[0][1].account.name;
142
+ const full = await chainClient.db.get_full_accounts([String(accountId)], false);
143
+ const fullRows = full;
144
+ if (fullRows && fullRows[0] && fullRows[0][1] && fullRows[0][1].account && fullRows[0][1].account.name) {
145
+ return fullRows[0][1].account.name;
144
146
  }
145
147
  throw new Error(`Could not resolve account ID '${accountId}' to name`);
146
148
  }
@@ -184,8 +186,13 @@ function matchKeyByPublicKey(targetPubKey, storedKeys, prefix, pubKeyCache) {
184
186
  if (!pubKeyStr) {
185
187
  const { privateKey } = ecc.wifDecode(wif);
186
188
  const pubKeyBuf = ecc.privateKeyToPublicKey(privateKey);
187
- pubKeyStr = ecc.publicKeyToString(pubKeyBuf, prefix);
188
- pubKeyCache.set(wif, pubKeyStr);
189
+ if (!pubKeyBuf)
190
+ continue;
191
+ const derived = ecc.publicKeyToString(pubKeyBuf, prefix);
192
+ if (!derived || typeof derived !== 'string')
193
+ continue;
194
+ pubKeyStr = derived;
195
+ pubKeyCache.set(wif, derived);
189
196
  }
190
197
  if (pubKeyStr === targetPubKey)
191
198
  return wif;
@@ -13,6 +13,11 @@ interface ChainClientConfig {
13
13
  validateChainId?: boolean;
14
14
  expectedChainId?: string;
15
15
  }
16
+ interface ChainConfig {
17
+ chainId: string;
18
+ addressPrefix: string;
19
+ coreAsset: string;
20
+ }
16
21
  /**
17
22
  * Outcome of a forced-reconnect request.
18
23
  * - `issued` a fresh teardown/reconnect was started by this call.
@@ -22,7 +27,37 @@ interface ChainClientConfig {
22
27
  * - `unavailable` no live socket to tear down, so no recovery attempt exists.
23
28
  */
24
29
  export type ForcedReconnectOutcome = 'issued' | 'coalesced' | 'unavailable';
25
- declare function createChainClient(config?: ChainClientConfig): any;
30
+ declare function createChainClient(config?: ChainClientConfig): {
31
+ transport: {
32
+ connect: (servers?: string[], autoReconnect?: boolean) => Promise<void>;
33
+ disconnect: () => void;
34
+ forceReconnect: (reason?: string) => void;
35
+ call: (method: string, params: unknown[], timeoutMs?: number) => Promise<unknown>;
36
+ addMessageHandler: (handler: (params: unknown) => void) => (() => void) & {
37
+ isActive: () => boolean;
38
+ };
39
+ getStatus: () => string;
40
+ getNodeUrl: () => string | null;
41
+ isConnected: () => boolean;
42
+ _setNodes: (nodes: string[]) => void;
43
+ _getNodes: () => string[];
44
+ _setAutoReconnect: (flag: boolean) => void;
45
+ };
46
+ connect: (servers?: string[]) => Promise<void>;
47
+ disconnect: () => void;
48
+ forceReconnect: (reason?: string) => ForcedReconnectOutcome;
49
+ setNodes: (servers: string[]) => void;
50
+ getNodes: () => string[];
51
+ getStatus: () => string;
52
+ getConfig: () => ChainConfig | null;
53
+ getCoreAsset: () => string;
54
+ getApiLimitGetAccountHistory: () => number | null;
55
+ db: Record<string, (...args: never[]) => Promise<unknown>>;
56
+ history: Record<string, (...args: never[]) => Promise<unknown>>;
57
+ broadcast: Record<string, (...args: never[]) => Promise<unknown>>;
58
+ login: () => Promise<ChainConfig | undefined>;
59
+ onReconnect: (() => Promise<void>) | null;
60
+ };
26
61
  interface ReadOnlyClientConfig {
27
62
  nodes?: string[];
28
63
  rpcTimeoutMs?: number;
@@ -34,8 +69,8 @@ declare function createReadOnlyClient(config?: ReadOnlyClientConfig): {
34
69
  connect: (servers?: string[]) => Promise<void>;
35
70
  disconnect: () => void;
36
71
  forceReconnect: (reason?: string) => ForcedReconnectOutcome;
37
- db: (method: string, args?: any[]) => Promise<any>;
38
- history: (method: string, args?: any[]) => Promise<any>;
72
+ db: (method: string, args?: unknown[]) => Promise<unknown>;
73
+ history: (method: string, args?: unknown[]) => Promise<unknown>;
39
74
  setNodes: (servers: string[]) => void;
40
75
  getNodes: () => string[];
41
76
  getNodeUrl: () => string | null;
@@ -23,7 +23,8 @@ function toRpcMethodName(method) {
23
23
  * server-side; the id then points past the new session's _local_apis map.
24
24
  */
25
25
  function isStaleApiIdError(err) {
26
- const message = err && err.message ? String(err.message) : String(err ?? '');
26
+ const e = err;
27
+ const message = e && e.message ? String(e.message) : String(err ?? '');
27
28
  if (!message)
28
29
  return false;
29
30
  return message.includes('_local_apis') || (message.includes('api_id') && message.includes('Assert Exception'));
@@ -63,6 +64,44 @@ function createForcedReconnectGate(transport) {
63
64
  return 'issued';
64
65
  };
65
66
  }
67
+ /**
68
+ * Build the windowed stale-api-id escalation shared by the main and read-only
69
+ * clients. Counting is windowed: a rare stale id (the normal reconnect-race
70
+ * case) never trips the escalation, while a session that fails every call
71
+ * trips it within a few RPCs. The window/threshold/reset policy lives here
72
+ * once; each caller supplies its own reconnect request and reason wording.
73
+ *
74
+ * @param forceReconnect - Client-local forced-reconnect request
75
+ * @param describe - Builds the reconnect reason from the api name and threshold
76
+ * @returns A controller exposing note() and reset()
77
+ */
78
+ function createStaleApiEscalation(forceReconnect, describe) {
79
+ let errorCount = 0;
80
+ let windowStartedAt = 0;
81
+ return {
82
+ reset() {
83
+ errorCount = 0;
84
+ windowStartedAt = 0;
85
+ },
86
+ note(apiName) {
87
+ const now = Date.now();
88
+ const windowMs = Number.isFinite(TRANSPORT.STALE_API_WINDOW_MS) ? TRANSPORT.STALE_API_WINDOW_MS : 60000;
89
+ const threshold = Number.isFinite(TRANSPORT.STALE_API_FORCE_RECONNECT_AFTER)
90
+ ? TRANSPORT.STALE_API_FORCE_RECONNECT_AFTER
91
+ : 3;
92
+ if (now - windowStartedAt > windowMs) {
93
+ windowStartedAt = now;
94
+ errorCount = 0;
95
+ }
96
+ errorCount++;
97
+ if (errorCount < threshold)
98
+ return;
99
+ errorCount = 0;
100
+ windowStartedAt = now;
101
+ forceReconnect(describe(apiName, threshold));
102
+ },
103
+ };
104
+ }
66
105
  function createChainClient(config = {}) {
67
106
  const { nodes = [], onStatusChange = null, onNodeFailure = null, shouldSkipNode = null, rpcTimeoutMs, connectTimeoutMs, autoreconnect = true, validateChainId = true, expectedChainId = GRAPHENE_CHAIN_ID, } = config;
68
107
  const wrappedOnStatusChange = (status, nodeUrl) => {
@@ -99,12 +138,6 @@ function createChainClient(config = {}) {
99
138
  }
100
139
  let _loginPromise = null;
101
140
  let _apiLimitGetAccountHistory = null;
102
- // Escalation state for a login session that keeps rejecting cached api ids.
103
- // A single stale error is handled in place (re-register + retry once); a
104
- // sustained run means the session is wedged and only a fresh socket (on a
105
- // different node) clears it.
106
- let _staleApiErrorCount = 0;
107
- let _staleApiWindowStartedAt = 0;
108
141
  // Shared forced-reconnect debounce. Both escalation sources — the stale
109
142
  // api_id window below and the subscriptions fill-channel watchdog — call
110
143
  // forceReconnect(), so the cooldown lives here, once per client, instead of
@@ -116,6 +149,7 @@ function createChainClient(config = {}) {
116
149
  // a session that is nominally connected but rejecting every call.
117
150
  // @returns the {@link ForcedReconnectOutcome} of the request.
118
151
  const forceReconnect = createForcedReconnectGate(transport);
152
+ const staleApiEscalation = createStaleApiEscalation(forceReconnect, (apiName, threshold) => `repeated stale api_id for ${apiName} (${threshold}x)`);
119
153
  if (Array.isArray(nodes) && nodes.length > 0) {
120
154
  transport._setNodes(nodes);
121
155
  }
@@ -130,8 +164,7 @@ function createChainClient(config = {}) {
130
164
  // Drop them so every accessor re-registers against this session.
131
165
  resetApiIds();
132
166
  // A fresh login session is a clean slate for the stale-id escalation.
133
- _staleApiErrorCount = 0;
134
- _staleApiWindowStartedAt = 0;
167
+ staleApiEscalation.reset();
135
168
  const result = await transport.call('call', [1, 'login', ['', '']]);
136
169
  if (!result) {
137
170
  throw new ConnectionError('Login error');
@@ -230,23 +263,7 @@ function createChainClient(config = {}) {
230
263
  * marks the active node failed, so the transport prefers another node.
231
264
  */
232
265
  function noteStaleApiError(apiName) {
233
- const now = Date.now();
234
- const windowMs = Number.isFinite(TRANSPORT.STALE_API_WINDOW_MS) ? TRANSPORT.STALE_API_WINDOW_MS : 60000;
235
- const threshold = Number.isFinite(TRANSPORT.STALE_API_FORCE_RECONNECT_AFTER)
236
- ? TRANSPORT.STALE_API_FORCE_RECONNECT_AFTER
237
- : 3;
238
- if (now - _staleApiWindowStartedAt > windowMs) {
239
- _staleApiWindowStartedAt = now;
240
- _staleApiErrorCount = 0;
241
- }
242
- _staleApiErrorCount++;
243
- if (_staleApiErrorCount < threshold)
244
- return;
245
- _staleApiErrorCount = 0;
246
- _staleApiWindowStartedAt = now;
247
- // Go through the local wrapper so this escalation shares the one
248
- // per-client cooldown with the subscriptions watchdog.
249
- forceReconnect(`repeated stale api_id for ${apiName} (${threshold}x)`);
266
+ staleApiEscalation.note(apiName);
250
267
  }
251
268
  async function dbCall(method, args) {
252
269
  return callWithApiRecovery('database', toRpcMethodName(method), args || [], () => _dbApiId, (id) => { _dbApiId = id; });
@@ -337,9 +354,6 @@ function createReadOnlyClient(config = {}) {
337
354
  let _dbApiId = null;
338
355
  let _historyApiId = null;
339
356
  let _recoverPromise = null;
340
- // Windowed escalation for a read channel whose session keeps rejecting ids.
341
- let _staleApiErrorCount = 0;
342
- let _staleApiWindowStartedAt = 0;
343
357
  function resetApiIds() {
344
358
  _dbApiId = null;
345
359
  _historyApiId = null;
@@ -356,6 +370,7 @@ function createReadOnlyClient(config = {}) {
356
370
  // client: one cooldown and one outcome for every forced reconnect raised on
357
371
  // this client (stale api_id escalation today).
358
372
  const forceReconnect = createForcedReconnectGate(transport);
373
+ const staleApiEscalation = createStaleApiEscalation(forceReconnect, (_apiName, threshold) => `repeated stale api_id on read channel (${threshold}x)`);
359
374
  async function connect(servers) {
360
375
  const effectiveNodes = Array.isArray(servers) && servers.length > 0
361
376
  ? servers
@@ -447,23 +462,7 @@ function createReadOnlyClient(config = {}) {
447
462
  * run forces a fresh connection on another node.
448
463
  */
449
464
  function noteStaleApiError() {
450
- const now = Date.now();
451
- const windowMs = Number.isFinite(TRANSPORT.STALE_API_WINDOW_MS) ? TRANSPORT.STALE_API_WINDOW_MS : 60000;
452
- const threshold = Number.isFinite(TRANSPORT.STALE_API_FORCE_RECONNECT_AFTER)
453
- ? TRANSPORT.STALE_API_FORCE_RECONNECT_AFTER
454
- : 3;
455
- if (now - _staleApiWindowStartedAt > windowMs) {
456
- _staleApiWindowStartedAt = now;
457
- _staleApiErrorCount = 0;
458
- }
459
- _staleApiErrorCount++;
460
- if (_staleApiErrorCount < threshold)
461
- return;
462
- _staleApiErrorCount = 0;
463
- _staleApiWindowStartedAt = now;
464
- // Route through the shared wrapper so both stale-id escalations on this
465
- // client obey one cooldown.
466
- forceReconnect(`repeated stale api_id on read channel (${threshold}x)`);
465
+ staleApiEscalation.note();
467
466
  }
468
467
  async function db(method, args) {
469
468
  return callWithRecovery(toRpcMethodName(method), args || [], () => _dbApiId, (id) => { _dbApiId = id; });