dexbot 1.6.11 → 1.6.13

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (398) hide show
  1. package/CHANGELOG.md +67 -4
  2. package/README.md +2 -1
  3. package/analysis/README.md +11 -11
  4. package/analysis/ama_fitting/README.md +5 -3
  5. package/analysis/tradingview/README.md +1 -1
  6. package/analysis/trend_detection/DYNAMIC_WEIGHT_RESEARCH.md +3 -3
  7. package/claw/README.md +1 -0
  8. package/claw/docs/AI_BOT_LIBRARY_API.md +2 -0
  9. package/claw/docs/DEXBOT2_TUNING_CHEAT_SHEET.md +4 -3
  10. package/claw/modules/chain_broadcast.ts +7 -1
  11. package/claw/modules/claw_bridge.ts +0 -3
  12. package/claw/modules/claw_launcher.ts +1 -1
  13. package/claw/modules/claw_skill_md.ts +1 -0
  14. package/claw/modules/launcher_mode_detector.ts +9 -2
  15. package/claw/package.json +3 -3
  16. package/claw/runtimes/openclaw-plugin/openclaw.plugin.json +1 -1
  17. package/claw/runtimes/openclaw-plugin/package.json +1 -1
  18. package/claw/tsconfig.json +2 -2
  19. package/dist/analysis/account_resolver.d.ts +1 -1
  20. package/dist/analysis/account_resolver.js +2 -1
  21. package/dist/analysis/ama_fitting/analyze_ama_price_changes.js +3 -4
  22. package/dist/analysis/ama_fitting/analyze_lambda_vs_slow.js +3 -21
  23. package/dist/analysis/ama_fitting/calibrate_convergence_er.js +0 -1
  24. package/dist/analysis/ama_fitting/fetch_lp_candles.js +55 -45
  25. package/dist/analysis/ama_fitting/generate_unified_comparison_chart.d.ts +1 -8
  26. package/dist/analysis/ama_fitting/generate_unified_comparison_chart.js +45 -24
  27. package/dist/analysis/ama_fitting/optimizer_high_resolution.js +34 -78
  28. package/dist/analysis/analyze_args.d.ts +43 -0
  29. package/dist/analysis/analyze_args.js +61 -0
  30. package/dist/analysis/analyze_dynamic_weight.js +7 -17
  31. package/dist/analysis/analyze_kalman.js +7 -17
  32. package/dist/analysis/analyze_regime.js +7 -17
  33. package/dist/analysis/analyze_regime_windows.js +8 -18
  34. package/dist/analysis/analyze_risk_profile.js +8 -18
  35. package/dist/analysis/analyze_trade_heatmap.js +7 -17
  36. package/dist/analysis/analyze_volatility.js +7 -17
  37. package/dist/analysis/bot_fitting/backtest_ama_sweep.d.ts +221 -28
  38. package/dist/analysis/bot_fitting/backtest_ama_sweep.js +23 -103
  39. package/dist/analysis/bot_fitting/backtest_bot_fitting.d.ts +34 -4
  40. package/dist/analysis/bot_fitting/backtest_bot_fitting.js +32 -150
  41. package/dist/analysis/bot_fitting/backtest_lookback_drawdown.js +19 -34
  42. package/dist/analysis/bot_fitting/shared_utils.d.ts +77 -9
  43. package/dist/analysis/bot_fitting/shared_utils.js +125 -9
  44. package/dist/analysis/bot_key_utils.d.ts +18 -10
  45. package/dist/analysis/bot_key_utils.js +7 -4
  46. package/dist/analysis/bot_usage/discover_bot_accounts.js +44 -47
  47. package/dist/analysis/bot_usage/kibana_bot_queries.d.ts +1 -21
  48. package/dist/analysis/chain_pool.d.ts +3 -1
  49. package/dist/analysis/chart_ui.d.ts +35 -3
  50. package/dist/analysis/chart_ui.js +43 -4
  51. package/dist/analysis/chart_utils.d.ts +5 -5
  52. package/dist/analysis/chart_utils.js +9 -0
  53. package/dist/analysis/fills_cache.d.ts +4 -24
  54. package/dist/analysis/fills_cache.js +3 -84
  55. package/dist/analysis/fills_source.d.ts +33 -3
  56. package/dist/analysis/fills_source.js +83 -13
  57. package/dist/analysis/grid_correction_check.d.ts +2 -24
  58. package/dist/analysis/grid_correction_check.js +27 -69
  59. package/dist/analysis/math_utils.d.ts +91 -6
  60. package/dist/analysis/math_utils.js +119 -7
  61. package/dist/analysis/pnl_report.js +29 -29
  62. package/dist/analysis/price_sources.d.ts +30 -9
  63. package/dist/analysis/price_sources.js +28 -4
  64. package/dist/analysis/resolve_bot_accounts.js +2 -2
  65. package/dist/analysis/resolve_source.d.ts +1 -1
  66. package/dist/analysis/resolve_source.js +31 -10
  67. package/dist/analysis/trade_profitability.d.ts +29 -2
  68. package/dist/analysis/trade_profitability.js +73 -147
  69. package/dist/analysis/tradingview/analyze_tradingview.d.ts +3 -8
  70. package/dist/analysis/tradingview/analyze_tradingview.js +7 -6
  71. package/dist/analysis/tradingview/grid_reset_config.d.ts +41 -32
  72. package/dist/analysis/tradingview/grid_reset_config.js +23 -11
  73. package/dist/analysis/tradingview/grid_reset_sim.d.ts +75 -9
  74. package/dist/analysis/tradingview/grid_reset_sim.js +4 -3
  75. package/dist/analysis/tradingview/tradingview_uplot_chart_generator.d.ts +69 -4
  76. package/dist/analysis/tradingview/tradingview_uplot_chart_generator.js +20 -34
  77. package/dist/analysis/trend_detection/backtest_ama_slope_huber.d.ts +1 -101
  78. package/dist/analysis/trend_detection/backtest_ama_slope_huber.js +26 -84
  79. package/dist/analysis/trend_detection/dynamic_weight_chart_generator.d.ts +63 -1
  80. package/dist/analysis/trend_detection/dynamic_weight_chart_generator.js +16 -41
  81. package/dist/analysis/trend_detection/huber_scale_variants.d.ts +9 -3
  82. package/dist/analysis/trend_detection/huber_scale_variants.js +4 -4
  83. package/dist/analysis/trend_detection/kalman_chart_generator.d.ts +30 -1
  84. package/dist/analysis/trend_detection/kalman_chart_generator.js +3 -3
  85. package/dist/analysis/trend_detection/regime_chart_generator.d.ts +31 -1
  86. package/dist/analysis/trend_detection/regime_chart_generator.js +2 -2
  87. package/dist/analysis/trend_detection/volatility_chart_generator.d.ts +33 -1
  88. package/dist/analysis/trend_detection/volatility_chart_generator.js +9 -10
  89. package/dist/analysis/worker_pool.d.ts +38 -0
  90. package/dist/analysis/worker_pool.js +67 -0
  91. package/dist/credential-daemon.js +34 -20
  92. package/dist/dexbot.js +78 -59
  93. package/dist/market_adapter/ama_signal_runner.js +21 -54
  94. package/dist/market_adapter/candle_utils.d.ts +29 -19
  95. package/dist/market_adapter/candle_utils.js +35 -21
  96. package/dist/market_adapter/cli_args.d.ts +22 -0
  97. package/dist/market_adapter/cli_args.js +30 -0
  98. package/dist/market_adapter/core/asymmetric_bounds.d.ts +13 -4
  99. package/dist/market_adapter/core/config_normalizers.d.ts +3 -3
  100. package/dist/market_adapter/core/config_normalizers.js +11 -6
  101. package/dist/market_adapter/core/kibana_candles.d.ts +56 -19
  102. package/dist/market_adapter/core/kibana_candles.js +12 -9
  103. package/dist/market_adapter/core/kibana_client.d.ts +9 -1
  104. package/dist/market_adapter/core/kibana_client.js +8 -7
  105. package/dist/market_adapter/core/kibana_market_candles.d.ts +3 -2
  106. package/dist/market_adapter/core/market_adapter_service.d.ts +320 -153
  107. package/dist/market_adapter/core/market_adapter_service.js +228 -269
  108. package/dist/market_adapter/core/signals/hurst_analyzer.d.ts +1 -6
  109. package/dist/market_adapter/core/signals/hurst_analyzer.js +1 -1
  110. package/dist/market_adapter/core/signals/permutation_entropy_analyzer.d.ts +1 -11
  111. package/dist/market_adapter/core/signals/permutation_entropy_analyzer.js +1 -1
  112. package/dist/market_adapter/core/strategies/ama.d.ts +10 -2
  113. package/dist/market_adapter/core/strategies/ama.js +2 -4
  114. package/dist/market_adapter/core/strategies/ama_slope_model.d.ts +14 -1
  115. package/dist/market_adapter/core/strategies/ama_slope_model.js +12 -34
  116. package/dist/market_adapter/core/strategies/atr/calculator.d.ts +7 -2
  117. package/dist/market_adapter/core/strategies/atr/calculator.js +2 -34
  118. package/dist/market_adapter/core/strategies/collateral_manager.d.ts +7 -1
  119. package/dist/market_adapter/core/strategies/collateral_manager.js +0 -22
  120. package/dist/market_adapter/core/strategies/dynamic_weight_series.d.ts +34 -6
  121. package/dist/market_adapter/core/strategies/dynamic_weight_series.js +7 -7
  122. package/dist/market_adapter/core/strategies/regime_gate.d.ts +24 -15
  123. package/dist/market_adapter/core/strategies/regime_gate.js +4 -31
  124. package/dist/market_adapter/core/strategies/regime_interp.d.ts +7 -1
  125. package/dist/market_adapter/core/strategies/regime_interp.js +14 -22
  126. package/dist/market_adapter/core/strategies/volatility_shift.d.ts +11 -1
  127. package/dist/market_adapter/core/strategies/volatility_shift.js +0 -13
  128. package/dist/market_adapter/inputs/cex_candle_parsing.d.ts +29 -0
  129. package/dist/market_adapter/inputs/cex_candle_parsing.js +52 -0
  130. package/dist/market_adapter/inputs/fetch_book_data.d.ts +20 -4
  131. package/dist/market_adapter/inputs/fetch_book_data.js +3 -2
  132. package/dist/market_adapter/inputs/fetch_cex_synthetic_data.js +160 -332
  133. package/dist/market_adapter/inputs/fetch_lp_data.d.ts +50 -8
  134. package/dist/market_adapter/inputs/fetch_lp_data.js +47 -22
  135. package/dist/market_adapter/inputs/kibana_feed_source.d.ts +74 -15
  136. package/dist/market_adapter/inputs/kibana_feed_source.js +26 -41
  137. package/dist/market_adapter/inputs/kibana_source.d.ts +25 -3
  138. package/dist/market_adapter/inputs/kibana_source.js +2 -2
  139. package/dist/market_adapter/inputs/window_cache.d.ts +93 -156
  140. package/dist/market_adapter/inputs/window_cache.js +59 -184
  141. package/dist/market_adapter/interval_utils.d.ts +15 -5
  142. package/dist/market_adapter/interval_utils.js +16 -1
  143. package/dist/market_adapter/log_format.d.ts +6 -6
  144. package/dist/market_adapter/log_format.js +28 -21
  145. package/dist/market_adapter/lp_chart_core.d.ts +22 -1
  146. package/dist/market_adapter/lp_chart_core.js +26 -192
  147. package/dist/market_adapter/lp_chart_runner.d.ts +10 -7
  148. package/dist/market_adapter/lp_chart_runner.js +37 -19
  149. package/dist/market_adapter/lp_chart_strategy_loader.d.ts +41 -6
  150. package/dist/market_adapter/lp_chart_strategy_loader.js +8 -7
  151. package/dist/market_adapter/market_adapter.d.ts +94 -32
  152. package/dist/market_adapter/market_adapter.js +94 -120
  153. package/dist/market_adapter/utils/adapter_client.d.ts +3 -3
  154. package/dist/market_adapter/utils/adapter_client.js +2 -2
  155. package/dist/market_adapter/utils/atomic_write.d.ts +8 -1
  156. package/dist/market_adapter/utils/chain.d.ts +50 -41
  157. package/dist/market_adapter/utils/chain.js +40 -46
  158. package/dist/market_adapter/utils/data_discovery.d.ts +49 -2
  159. package/dist/market_adapter/utils/data_discovery.js +220 -27
  160. package/dist/market_adapter/utils/dynamic_grid_snapshot.d.ts +12 -3
  161. package/dist/market_adapter/utils/file_json_cache.d.ts +2 -2
  162. package/dist/market_adapter/utils/file_lock.d.ts +28 -14
  163. package/dist/market_adapter/utils/file_lock.js +36 -32
  164. package/dist/market_adapter/utils/month_shards.d.ts +84 -0
  165. package/dist/market_adapter/utils/month_shards.js +237 -0
  166. package/dist/market_adapter/utils/native_history.d.ts +9 -2
  167. package/dist/market_adapter/utils/native_history.js +35 -28
  168. package/dist/modules/account_bots.d.ts +578 -21
  169. package/dist/modules/account_bots.js +272 -267
  170. package/dist/modules/account_orders.d.ts +79 -30
  171. package/dist/modules/account_orders.js +60 -64
  172. package/dist/modules/authority_resolver.d.ts +12 -2
  173. package/dist/modules/authority_resolver.js +15 -8
  174. package/dist/modules/bitshares-native/chain_client.d.ts +39 -4
  175. package/dist/modules/bitshares-native/chain_client.js +59 -59
  176. package/dist/modules/bitshares-native/crypto/ecc.browser.js +11 -171
  177. package/dist/modules/bitshares-native/crypto/ecc.js +13 -176
  178. package/dist/modules/bitshares-native/crypto/ecc_core.d.ts +33 -0
  179. package/dist/modules/bitshares-native/crypto/ecc_core.js +213 -0
  180. package/dist/modules/bitshares-native/crypto/ecc_selector.d.ts +2 -1
  181. package/dist/modules/bitshares-native/crypto/ecc_selector.js +1 -13
  182. package/dist/modules/bitshares-native/index.d.ts +1 -1
  183. package/dist/modules/bitshares-native/lru_cache.d.ts +7 -7
  184. package/dist/modules/bitshares-native/resolvers.d.ts +18 -6
  185. package/dist/modules/bitshares-native/resolvers.js +22 -25
  186. package/dist/modules/bitshares-native/serial/lazy_buffer.d.ts +4 -0
  187. package/dist/modules/bitshares-native/serial/lazy_buffer.js +21 -0
  188. package/dist/modules/bitshares-native/serial/operations.d.ts +1 -1
  189. package/dist/modules/bitshares-native/serial/serializer.d.ts +16 -12
  190. package/dist/modules/bitshares-native/serial/serializer.js +7 -13
  191. package/dist/modules/bitshares-native/serial/types.d.ts +25 -16
  192. package/dist/modules/bitshares-native/serial/types.js +73 -108
  193. package/dist/modules/bitshares-native/signing_client.d.ts +32 -2
  194. package/dist/modules/bitshares-native/signing_client.js +19 -14
  195. package/dist/modules/bitshares-native/subscriptions.d.ts +81 -1
  196. package/dist/modules/bitshares-native/subscriptions.js +12 -12
  197. package/dist/modules/bitshares-native/transport.d.ts +5 -4
  198. package/dist/modules/bitshares-native/transport.js +5 -4
  199. package/dist/modules/bitshares-native/tx/builder.d.ts +40 -5
  200. package/dist/modules/bitshares-native/tx/builder.js +4 -3
  201. package/dist/modules/bitshares-native/tx/tx_cache.d.ts +4 -4
  202. package/dist/modules/bitshares_client.d.ts +45 -13
  203. package/dist/modules/bitshares_client.js +28 -19
  204. package/dist/modules/bot_defaults.d.ts +8 -16
  205. package/dist/modules/bot_defaults.js +1 -5
  206. package/dist/modules/bot_settings.d.ts +44 -10
  207. package/dist/modules/bot_settings.js +11 -8
  208. package/dist/modules/bots_file_lock.d.ts +6 -6
  209. package/dist/modules/bots_file_lock.js +16 -12
  210. package/dist/modules/broadcast_failure.d.ts +4 -3
  211. package/dist/modules/broadcast_failure.js +5 -4
  212. package/dist/modules/chain_keys.d.ts +42 -40
  213. package/dist/modules/chain_keys.js +53 -45
  214. package/dist/modules/chain_orders.d.ts +94 -60
  215. package/dist/modules/chain_orders.js +81 -118
  216. package/dist/modules/cli_start_onboarding.d.ts +2 -1
  217. package/dist/modules/constants.d.ts +534 -32
  218. package/dist/modules/constants.js +35 -48
  219. package/dist/modules/cr_planner.d.ts +41 -3
  220. package/dist/modules/cr_planner.js +1 -5
  221. package/dist/modules/credential_policy.d.ts +68 -8
  222. package/dist/modules/credential_policy.js +37 -31
  223. package/dist/modules/credential_session_cache.d.ts +2 -2
  224. package/dist/modules/credit_pricing.d.ts +43 -6
  225. package/dist/modules/credit_pricing.js +70 -60
  226. package/dist/modules/credit_runtime.d.ts +283 -118
  227. package/dist/modules/credit_runtime.js +500 -231
  228. package/dist/modules/crypto/browser_provider.js +6 -4
  229. package/dist/modules/crypto/node_provider.js +1 -1
  230. package/dist/modules/crypto/pure_scrypt.js +35 -4
  231. package/dist/modules/crypto/pure_secp256k1.js +72 -26
  232. package/dist/modules/crypto/sync.d.ts +9 -9
  233. package/dist/modules/crypto/sync.js +16 -9
  234. package/dist/modules/daemon_node_health.d.ts +4 -3
  235. package/dist/modules/dexbot_class.d.ts +213 -146
  236. package/dist/modules/dexbot_class.js +183 -86
  237. package/dist/modules/dexbot_cow_runtime.d.ts +160 -87
  238. package/dist/modules/dexbot_cow_runtime.js +302 -234
  239. package/dist/modules/dexbot_credential_client.d.ts +19 -18
  240. package/dist/modules/dexbot_credential_client.js +1 -2
  241. package/dist/modules/dexbot_fill_runtime.d.ts +63 -49
  242. package/dist/modules/dexbot_fill_runtime.js +53 -47
  243. package/dist/modules/dexbot_maintenance_runtime.d.ts +127 -71
  244. package/dist/modules/dexbot_maintenance_runtime.js +187 -147
  245. package/dist/modules/dexbot_startup_runtime.d.ts +11 -11
  246. package/dist/modules/dexbot_startup_runtime.js +56 -57
  247. package/dist/modules/dexbot_state_recovery.d.ts +13 -12
  248. package/dist/modules/dexbot_state_recovery.js +18 -13
  249. package/dist/modules/fund_registry.d.ts +4 -2
  250. package/dist/modules/fund_registry.js +10 -10
  251. package/dist/modules/general_settings.d.ts +30 -4
  252. package/dist/modules/graceful_shutdown.d.ts +3 -3
  253. package/dist/modules/graceful_shutdown.js +19 -13
  254. package/dist/modules/grid_price_source.d.ts +1 -1
  255. package/dist/modules/key_store.d.ts +14 -8
  256. package/dist/modules/key_store.js +7 -7
  257. package/dist/modules/launcher/adapter_requirement.d.ts +11 -5
  258. package/dist/modules/launcher/adapter_requirement.js +5 -5
  259. package/dist/modules/launcher/bot_supervisor.d.ts +106 -24
  260. package/dist/modules/launcher/bot_supervisor.js +12 -11
  261. package/dist/modules/launcher/credential_bootstrap.d.ts +1 -1
  262. package/dist/modules/launcher/credential_bootstrap.js +1 -1
  263. package/dist/modules/launcher/credential_daemon.d.ts +4 -4
  264. package/dist/modules/launcher/credential_daemon.js +2 -2
  265. package/dist/modules/launcher/credential_secret.d.ts +1 -1
  266. package/dist/modules/launcher/foreign_cred_daemon.d.ts +2 -2
  267. package/dist/modules/launcher/market_adapter_runtime.d.ts +61 -6
  268. package/dist/modules/launcher/market_adapter_watchdog.d.ts +10 -2
  269. package/dist/modules/launcher/market_adapter_watchdog.js +4 -0
  270. package/dist/modules/launcher/monolithic_runtime.d.ts +18 -16
  271. package/dist/modules/launcher/status_reporting.d.ts +22 -14
  272. package/dist/modules/launcher/supervisor_control.d.ts +8 -1
  273. package/dist/modules/launcher/supervisor_control.js +4 -2
  274. package/dist/modules/lazy_shim.d.ts +11 -0
  275. package/dist/modules/lazy_shim.js +16 -0
  276. package/dist/modules/market_adapter_whitelist.d.ts +9 -3
  277. package/dist/modules/market_adapter_whitelist.js +15 -3
  278. package/dist/modules/node_connect_policy.d.ts +3 -2
  279. package/dist/modules/node_failure_ledger.d.ts +6 -5
  280. package/dist/modules/node_manager.d.ts +41 -11
  281. package/dist/modules/node_manager.js +5 -4
  282. package/dist/modules/order/accounting.d.ts +53 -24
  283. package/dist/modules/order/accounting.js +16 -15
  284. package/dist/modules/order/async_lock.d.ts +5 -2
  285. package/dist/modules/order/async_lock.js +1 -1
  286. package/dist/modules/order/export.d.ts +7 -6
  287. package/dist/modules/order/export.js +1 -7
  288. package/dist/modules/order/format.d.ts +16 -7
  289. package/dist/modules/order/format.js +15 -3
  290. package/dist/modules/order/genesis_policy.d.ts +24 -21
  291. package/dist/modules/order/genesis_policy.js +17 -10
  292. package/dist/modules/order/grid.d.ts +144 -36
  293. package/dist/modules/order/grid.js +226 -145
  294. package/dist/modules/order/grid_reconcile.d.ts +21 -20
  295. package/dist/modules/order/grid_reconcile.js +13 -12
  296. package/dist/modules/order/grid_reconcile_internal.d.ts +85 -72
  297. package/dist/modules/order/grid_reconcile_internal.js +28 -19
  298. package/dist/modules/order/index.d.ts +264 -1
  299. package/dist/modules/order/logger.d.ts +46 -19
  300. package/dist/modules/order/logger.js +38 -49
  301. package/dist/modules/order/logger_state.d.ts +4 -4
  302. package/dist/modules/order/manager.d.ts +232 -191
  303. package/dist/modules/order/manager.js +110 -130
  304. package/dist/modules/order/processed_fill_store.d.ts +18 -3
  305. package/dist/modules/order/processed_fill_store.js +16 -27
  306. package/dist/modules/order/strategy.d.ts +21 -13
  307. package/dist/modules/order/strategy.js +5 -6
  308. package/dist/modules/order/sync_engine.d.ts +91 -33
  309. package/dist/modules/order/sync_engine.js +84 -53
  310. package/dist/modules/order/utils/math.d.ts +157 -102
  311. package/dist/modules/order/utils/math.js +77 -38
  312. package/dist/modules/order/utils/order.d.ts +310 -110
  313. package/dist/modules/order/utils/order.js +153 -126
  314. package/dist/modules/order/utils/slot.d.ts +1 -1
  315. package/dist/modules/order/utils/system.d.ts +156 -26
  316. package/dist/modules/order/utils/system.js +103 -71
  317. package/dist/modules/order/utils/validate.d.ts +89 -41
  318. package/dist/modules/order/utils/validate.js +26 -24
  319. package/dist/modules/order/utils/withPoolRef.d.ts +6 -4
  320. package/dist/modules/order/utils/withPoolRef.js +18 -12
  321. package/dist/modules/order/working_grid.d.ts +14 -13
  322. package/dist/modules/paths.d.ts +1 -4
  323. package/dist/modules/paths.js +33 -61
  324. package/dist/modules/process_discovery.d.ts +1 -1
  325. package/dist/modules/process_discovery.js +2 -1
  326. package/dist/modules/runtime.d.ts +7 -3
  327. package/dist/modules/runtime.js +4 -3
  328. package/dist/modules/runtime_settings.d.ts +14 -11
  329. package/dist/modules/runtime_settings.js +30 -24
  330. package/dist/modules/settings_merge.d.ts +29 -3
  331. package/dist/modules/settings_merge.js +56 -78
  332. package/dist/modules/socket_json_client.d.ts +9 -5
  333. package/dist/modules/storage/browser_adapter.d.ts +38 -53
  334. package/dist/modules/storage/browser_adapter.js +7 -30
  335. package/dist/modules/storage/index.d.ts +1 -1
  336. package/dist/modules/storage/node_adapter.d.ts +45 -27
  337. package/dist/modules/storage/node_adapter.js +9 -9
  338. package/dist/modules/storage/types.d.ts +5 -4
  339. package/dist/modules/types.d.ts +1090 -6
  340. package/dist/modules/types.js +4 -1
  341. package/dist/modules/utils/asset_symbols.d.ts +2 -1
  342. package/dist/modules/utils/asset_symbols.js +2 -1
  343. package/dist/modules/utils/errors.d.ts +9 -0
  344. package/dist/modules/utils/errors.js +24 -4
  345. package/dist/modules/utils/time_range.d.ts +1 -12
  346. package/dist/modules/utils/time_range.js +1 -1
  347. package/dist/modules/validate_profiles.js +53 -43
  348. package/dist/modules/version_notice.d.ts +23 -11
  349. package/dist/modules/version_notice.js +6 -4
  350. package/dist/pm2.d.ts +28 -27
  351. package/dist/pm2.js +61 -40
  352. package/dist/scripts/analyze-credit.d.ts +2 -1
  353. package/dist/scripts/analyze-credit.js +23 -24
  354. package/dist/scripts/analyze-git.js +2 -15
  355. package/dist/scripts/analyze-orders.d.ts +77 -9
  356. package/dist/scripts/analyze-orders.js +65 -40
  357. package/dist/scripts/chart_command.d.ts +27 -18
  358. package/dist/scripts/chart_command.js +15 -13
  359. package/dist/scripts/check_any.d.ts +22 -0
  360. package/dist/scripts/check_any.js +158 -0
  361. package/dist/scripts/diagnose-pool-history.js +13 -13
  362. package/dist/scripts/print_grid.js +0 -1
  363. package/dist/scripts/run-tests.js +39 -8
  364. package/dist/scripts/runner.js +1 -1
  365. package/dist/scripts/sync-version.js +0 -10
  366. package/dist/scripts/test-credit-renewal.js +30 -21
  367. package/dist/scripts/update.d.ts +10 -5
  368. package/dist/scripts/update.js +168 -103
  369. package/dist/scripts/update_dist_freshness.js +1 -0
  370. package/dist/scripts/update_layout.d.ts +61 -0
  371. package/dist/scripts/update_layout.js +180 -0
  372. package/dist/scripts/validate_bots.js +2 -1
  373. package/dist/scripts/verify-browser-bundle.js +8 -0
  374. package/dist/unlock.d.ts +28 -3
  375. package/dist/unlock.js +63 -35
  376. package/docs/BITSHARES_ONBOARDING.md +10 -12
  377. package/docs/COPY_ON_WRITE_MASTER_PLAN.md +2 -2
  378. package/docs/COW_INVARIANTS.md +13 -6
  379. package/docs/DEXBOT_COMPARISON.md +8 -8
  380. package/docs/EVOLUTION.md +10 -8
  381. package/docs/FUND_MOVEMENT_AND_ACCOUNTING.md +5 -5
  382. package/docs/GRID_RECALCULATION.md +4 -2
  383. package/docs/GRID_RECONCILE.md +14 -3
  384. package/docs/LIFECYCLE.md +11 -11
  385. package/docs/MPA_CREDIT_USAGE.md +22 -3
  386. package/docs/README.md +14 -3
  387. package/docs/WORKFLOW.md +1 -0
  388. package/docs/architecture.md +31 -19
  389. package/docs/developer_guide.md +6 -6
  390. package/market_adapter/README.md +12 -5
  391. package/modules/README.md +4 -1
  392. package/package.json +9 -9
  393. package/scripts/README.md +43 -38
  394. package/tests/README.md +25 -10
  395. package/dist/scripts/diagnose-kibana-candles.d.ts +0 -3
  396. package/dist/scripts/diagnose-kibana-candles.js +0 -82
  397. package/scripts/git-viewer.sh +0 -489
  398. package/scripts/postinstall.js +0 -16
@@ -37,8 +37,6 @@ export const DRAFT_SEED_ORDER = [
37
37
  'active', 'dryRun', 'minPrice', 'maxPrice', 'incrementPercent',
38
38
  'targetSpreadPercent', 'startPrice', 'gridPrice',
39
39
  ];
40
- /** Fields with no meaning since the grid-price offset was removed; stripped from drafts. */
41
- export const LEGACY_DRAFT_KEYS = ['gridPriceOffsetPct', 'gridPriceOffsetClampToBounds'];
42
40
  /**
43
41
  * Spellings that mean "no explicit grid price" — delegate to startPrice.
44
42
  * `none`/`null`/`start`/`startprice` are the editor's documented aliases;
@@ -46,7 +44,7 @@ export const LEGACY_DRAFT_KEYS = ['gridPriceOffsetPct', 'gridPriceOffsetClampToB
46
44
  * elsewhere in the editor, `s` is shorthand for `startPrice`, and the boolean
47
45
  * `false` covers a hand-edited `gridPrice: false`.
48
46
  */
49
- export const GRID_PRICE_UNSET_INPUTS = new Set(['none', 'null', 'start', 'startprice', 's', 'n', 'no', 'false', '0', 'f']);
47
+ const GRID_PRICE_UNSET_INPUTS = new Set(['none', 'null', 'start', 'startprice', 's', 'n', 'no', 'false', '0', 'f']);
50
48
  /**
51
49
  * True when a grid-price value carries no reference and must degrade to the
52
50
  * startPrice fallback. Keeps `null`/`undefined`/`false`, empty/whitespace
@@ -123,8 +121,6 @@ export function seedBotDraft(base, options = {}) {
123
121
  data[key] = def;
124
122
  }
125
123
  }
126
- for (const key of LEGACY_DRAFT_KEYS)
127
- delete data[key];
128
124
  return data;
129
125
  }
130
126
  /**
@@ -1,21 +1,55 @@
1
+ import type { UnknownRecord } from './types.js';
2
+ /** A single `debtPolicy.lending[]` entry (loosely typed: validated at runtime). */
3
+ export interface BotLendingEntry extends UnknownRecord {
4
+ asset?: unknown;
5
+ collateralAsset?: unknown;
6
+ type?: unknown;
7
+ }
8
+ /** `debtPolicy` block of a bot entry. */
9
+ interface BotDebtPolicy extends UnknownRecord {
10
+ lending?: BotLendingEntry[];
11
+ maxCollateralAmount?: unknown;
12
+ }
13
+ /** A loosely-typed bot entry as read from bots.json / user input. */
14
+ export interface BotEntry extends UnknownRecord {
15
+ name?: string;
16
+ active?: boolean;
17
+ creditOnly?: boolean;
18
+ assetA?: string;
19
+ assetB?: string;
20
+ botKey?: string;
21
+ botIndex?: number;
22
+ preferredAccount?: string;
23
+ activeOrders?: UnknownRecord;
24
+ reserveOrders?: number | UnknownRecord;
25
+ botFunds?: {
26
+ buy?: unknown;
27
+ sell?: unknown;
28
+ };
29
+ debtPolicy?: BotDebtPolicy;
30
+ }
31
+ /** The top-level bots.json document. */
32
+ export interface BotSettingsFile extends UnknownRecord {
33
+ bots?: BotEntry[];
34
+ }
1
35
  declare function loadSettingsFile(filePath: string, { silent, exitOnError }?: {
2
36
  silent?: boolean;
3
37
  exitOnError?: boolean;
4
38
  }): {
5
- config: any;
39
+ config: BotSettingsFile;
6
40
  filePath: string;
7
41
  };
8
- declare function saveSettingsFile(config: any, filePath: string): void;
9
- declare function resolveRawBotEntries(settings: any): any[];
10
- declare function normalizeBotEntry(entry: any, index?: number): any;
11
- declare function normalizeBotEntries(rawEntries: any[]): any[];
12
- declare function selectBotEntry(settings: any, botName: string): any;
13
- declare function selectActiveBotEntries(settings: any): any[];
14
- declare function validateBotEntry(b: any, i: number, src: string): string | null;
15
- declare function collectValidationIssues(entries: any[], sourceName: string): {
42
+ declare function saveSettingsFile(config: UnknownRecord, filePath: string): void;
43
+ declare function resolveRawBotEntries(settings: unknown): BotEntry[];
44
+ declare function normalizeBotEntry(entry: BotEntry, index?: number): BotEntry;
45
+ declare function normalizeBotEntries(rawEntries: unknown[]): BotEntry[];
46
+ declare function selectBotEntry(settings: unknown, botName: string): BotEntry | null;
47
+ declare function selectActiveBotEntries(settings: unknown): BotEntry[];
48
+ declare function validateBotEntry(b: BotEntry, i: number, src: string): string | null;
49
+ declare function collectValidationIssues(entries: BotEntry[], sourceName: string): {
16
50
  errors: string[];
17
51
  warnings: string[];
18
52
  };
19
- declare function assertNoDuplicateBotKeys(entries: any[], sourceName: string): void;
53
+ declare function assertNoDuplicateBotKeys(entries: BotEntry[], sourceName: string): void;
20
54
  export { assertNoDuplicateBotKeys, collectValidationIssues, loadSettingsFile, normalizeBotEntry, normalizeBotEntries, resolveRawBotEntries, saveSettingsFile, selectActiveBotEntries, selectBotEntry, validateBotEntry };
21
55
  //# sourceMappingURL=bot_settings.d.ts.map
@@ -8,6 +8,7 @@ import { isPositiveNumber, isPositiveNumberOrPercent, toDecimal } from './order/
8
8
  import { resolveMinCollateralIncreaseThreshold } from './cr_planner.js';
9
9
  import { getErrorMessage } from './utils/errors.js';
10
10
  import { canonicalizeBotAssetSymbols } from './utils/asset_symbols.js';
11
+ import { isUnknownRecord } from './types.js';
11
12
  const storage = getStorage();
12
13
  const { writeJSON } = storage;
13
14
  function loadSettingsFile(filePath, { silent = false, exitOnError = true } = {}) {
@@ -41,7 +42,7 @@ function saveSettingsFile(config, filePath) {
41
42
  }
42
43
  }
43
44
  function resolveRawBotEntries(settings) {
44
- if (!settings || typeof settings !== 'object')
45
+ if (!isUnknownRecord(settings))
45
46
  return [];
46
47
  if (Array.isArray(settings.bots))
47
48
  return settings.bots;
@@ -110,7 +111,8 @@ function validateBotEntry(b, i, src) {
110
111
  }
111
112
  else {
112
113
  for (const side of ['buy', 'sell']) {
113
- const v = b.reserveOrders[side];
114
+ const reserveOrders = b.reserveOrders;
115
+ const v = reserveOrders[side];
114
116
  if (v !== undefined && (!Number.isInteger(Number(v)) || Number(v) < 0))
115
117
  problems.push(`'reserveOrders.${side}' must be a non-negative integer`);
116
118
  }
@@ -147,7 +149,7 @@ function validateBotEntry(b, i, src) {
147
149
  if (!item.asset || typeof item.asset !== 'string') {
148
150
  problems.push(`debtPolicy.lending[${idx}].asset must be a non-empty string`);
149
151
  }
150
- if (!['mpa', 'creditOffer'].includes(item.type)) {
152
+ if (!['mpa', 'creditOffer'].includes(String(item.type))) {
151
153
  problems.push(`debtPolicy.lending[${idx}].type must be 'mpa' or 'creditOffer'`);
152
154
  }
153
155
  // outputWeight: canonical field (deprecated 'ratio' alias removed)
@@ -156,7 +158,7 @@ function validateBotEntry(b, i, src) {
156
158
  }
157
159
  if ('outputWeight' in item) {
158
160
  const weightVal = item.outputWeight;
159
- if (!Number.isFinite(weightVal) || weightVal < 0) {
161
+ if (typeof weightVal !== 'number' || !Number.isFinite(weightVal) || weightVal < 0) {
160
162
  problems.push(`debtPolicy.lending[${idx}].outputWeight must be a non-negative number`);
161
163
  }
162
164
  }
@@ -285,12 +287,13 @@ function collectValidationIssues(entries, sourceName) {
285
287
  // Cross-bot validation: check if botFunds percentages sum > 100% per account
286
288
  const accountFunds = {};
287
289
  for (const entry of entries) {
288
- if (!entry.active || !entry.preferredAccount || !entry.botFunds)
290
+ const account = entry.preferredAccount;
291
+ if (!entry.active || !account || !entry.botFunds)
289
292
  continue;
290
- if (!accountFunds[entry.preferredAccount]) {
291
- accountFunds[entry.preferredAccount] = { buy: 0, sell: 0, botNames: [] };
293
+ if (!accountFunds[account]) {
294
+ accountFunds[account] = { buy: 0, sell: 0, botNames: [] };
292
295
  }
293
- const acc = accountFunds[entry.preferredAccount];
296
+ const acc = accountFunds[account];
294
297
  acc.buy += toDecimal(entry.botFunds.buy);
295
298
  acc.sell += toDecimal(entry.botFunds.sell);
296
299
  acc.botNames.push(entry.name || entry.botKey || `bot-${entries.indexOf(entry)}`);
@@ -47,7 +47,7 @@
47
47
  * @param {string} targetPath - Path of the final JSON file.
48
48
  * @param {*} data - Anything `JSON.stringify` accepts.
49
49
  */
50
- declare function writeJsonFileAtomic(targetPath: any, data: any): void;
50
+ declare function writeJsonFileAtomic(targetPath: string, data: unknown): void;
51
51
  /**
52
52
  * Safely read bots.json with lock protection (re-entrant safe).
53
53
  * @param {string} botsJsonPath - Path to bots.json file
@@ -55,9 +55,9 @@ declare function writeJsonFileAtomic(targetPath: any, data: any): void;
55
55
  * @returns {Promise<{content: string, config: Object}>} File content and parsed config
56
56
  * @throws {Error} If file doesn't exist or JSON is invalid
57
57
  */
58
- declare function readBotsFileWithLock(botsJsonPath: any, parseFunction: any): Promise<{
58
+ declare function readBotsFileWithLock<T>(botsJsonPath: string, parseFunction: (content: string) => T): Promise<{
59
59
  content: string;
60
- config: any;
60
+ config: T;
61
61
  }>;
62
62
  /**
63
63
  * Safely write bots.json with lock protection (re-entrant safe).
@@ -66,7 +66,7 @@ declare function readBotsFileWithLock(botsJsonPath: any, parseFunction: any): Pr
66
66
  * @returns {Promise<void>}
67
67
  * @throws {Error} If write fails
68
68
  */
69
- declare function writeBotsFileWithLock(botsJsonPath: any, config: any): Promise<void>;
69
+ declare function writeBotsFileWithLock(botsJsonPath: string, config: unknown): Promise<void>;
70
70
  /**
71
71
  * Synchronously read bots.json (startup only, no lock — the in-memory
72
72
  * AsyncLock is inherently async and cannot be used here).
@@ -77,9 +77,9 @@ declare function writeBotsFileWithLock(botsJsonPath: any, config: any): Promise<
77
77
  * @returns {{content: string, config: Object}} File content and parsed config
78
78
  * @throws {Error} If file doesn't exist or JSON is invalid
79
79
  */
80
- declare function readBotsFileSync(botsJsonPath: any, parseFunction: any): {
80
+ declare function readBotsFileSync<T>(botsJsonPath: string, parseFunction: (content: string) => T): {
81
81
  content: string;
82
- config: any;
82
+ config: T;
83
83
  };
84
84
  export { readBotsFileWithLock, writeBotsFileWithLock, readBotsFileSync, writeJsonFileAtomic };
85
85
  //# sourceMappingURL=bots_file_lock.d.ts.map
@@ -57,6 +57,20 @@ function writeJsonFileAtomic(targetPath, data) {
57
57
  // Uses AsyncLock which supports nested acquire calls via
58
58
  // AsyncLocalStorage-based re-entrancy detection.
59
59
  const botsFileLock = new AsyncLock();
60
+ /**
61
+ * Parse a bots.json payload, applying the shared empty-file fallback. Both the
62
+ * locked async read and the startup sync read go through this so the
63
+ * empty-file default cannot drift between them.
64
+ * @param {string} content - Raw file content
65
+ * @param {Function} parseFunction - JSON parser function
66
+ * @returns {{content: string, config: Object}} Content and parsed config
67
+ */
68
+ function parseBotsContent(content, parseFunction) {
69
+ if (!content || !content.trim()) {
70
+ return { content: '', config: { bots: [] } };
71
+ }
72
+ return { content, config: parseFunction(content) };
73
+ }
60
74
  /**
61
75
  * Safely read bots.json with lock protection (re-entrant safe).
62
76
  * @param {string} botsJsonPath - Path to bots.json file
@@ -69,12 +83,7 @@ async function readBotsFileWithLock(botsJsonPath, parseFunction) {
69
83
  if (!storage.exists(botsJsonPath)) {
70
84
  throw new Error(`bots.json not found at ${botsJsonPath}`);
71
85
  }
72
- const content = storage.readFile(botsJsonPath);
73
- if (!content || !content.trim()) {
74
- return { content: '', config: { bots: [] } };
75
- }
76
- const config = parseFunction(content);
77
- return { content, config };
86
+ return parseBotsContent(storage.readFile(botsJsonPath), parseFunction);
78
87
  });
79
88
  }
80
89
  /**
@@ -107,12 +116,7 @@ function readBotsFileSync(botsJsonPath, parseFunction) {
107
116
  if (!storage.exists(botsJsonPath)) {
108
117
  throw new Error(`bots.json not found at ${botsJsonPath}`);
109
118
  }
110
- const content = storage.readFile(botsJsonPath);
111
- if (!content || !content.trim()) {
112
- return { content: '', config: { bots: [] } };
113
- }
114
- const config = parseFunction(content);
115
- return { content, config };
119
+ return parseBotsContent(storage.readFile(botsJsonPath), parseFunction);
116
120
  }
117
121
  export { readBotsFileWithLock, writeBotsFileWithLock, readBotsFileSync, writeJsonFileAtomic };
118
122
  //# sourceMappingURL=bots_file_lock.js.map
@@ -11,7 +11,7 @@
11
11
  * Mirrors the failure modes produced by modules/bitshares-native/transport.ts
12
12
  * call() and the signing client (modules/bitshares-native/signing_client.ts).
13
13
  */
14
- export type BroadcastFailureClass = 'retryable' | 'uncertain' | 'definite';
14
+ type BroadcastFailureClass = 'retryable' | 'uncertain' | 'definite';
15
15
  /**
16
16
  * Classify a broadcast-phase failure.
17
17
  *
@@ -26,8 +26,9 @@ export type BroadcastFailureClass = 'retryable' | 'uncertain' | 'definite';
26
26
  * be built: nothing landed and retrying the identical ops
27
27
  * cannot change the outcome.
28
28
  *
29
- * @param {any} err - The thrown error (code + message).
29
+ * @param {unknown} err - The thrown error (code + message).
30
30
  * @returns {BroadcastFailureClass}
31
31
  */
32
- export declare function classifyBroadcastFailure(err: any): BroadcastFailureClass;
32
+ export declare function classifyBroadcastFailure(err: unknown): BroadcastFailureClass;
33
+ export {};
33
34
  //# sourceMappingURL=broadcast_failure.d.ts.map
@@ -13,15 +13,16 @@
13
13
  * be built: nothing landed and retrying the identical ops
14
14
  * cannot change the outcome.
15
15
  *
16
- * @param {any} err - The thrown error (code + message).
16
+ * @param {unknown} err - The thrown error (code + message).
17
17
  * @returns {BroadcastFailureClass}
18
18
  */
19
19
  export function classifyBroadcastFailure(err) {
20
20
  if (!err)
21
21
  return 'definite';
22
- const code = String(err.code || '');
22
+ const e = err;
23
+ const code = String(e.code || '');
23
24
  if (code === 'CONNECTION_ERROR') {
24
- const msg = String(err.message || '');
25
+ const msg = String(e.message || '');
25
26
  // Pre-send rejections in transport.call() — the RPC frame was never
26
27
  // written to the socket, so no transaction was transmitted.
27
28
  if (msg === 'WebSocket not open' || msg.startsWith('Failed to send') || msg === 'No servers provided') {
@@ -56,7 +57,7 @@ export function classifyBroadcastFailure(err) {
56
57
  // another node and nothing landed.
57
58
  if (code === 'TX_TOO_LARGE')
58
59
  return 'definite';
59
- const msg = String(err.message || '');
60
+ const msg = String(e.message || '');
60
61
  if (msg === 'Operation must have op_name and op_data'
61
62
  || msg === 'Each operation requires op_name and op_data'
62
63
  || /^Max operations per tx/.test(msg)
@@ -90,39 +90,50 @@
90
90
  *
91
91
  * ===============================================================================
92
92
  */
93
+ interface AccountsData {
94
+ vaultVersion: number;
95
+ vaultSalt: string;
96
+ vaultVerifier: string;
97
+ accounts: Record<string, Record<string, unknown>>;
98
+ }
99
+ interface DaemonPathOptions {
100
+ socketPath?: string;
101
+ readyFilePath?: string;
102
+ runtimeDir?: string;
103
+ }
104
+ interface DaemonSigningOptions extends DaemonPathOptions {
105
+ sessionId?: string | null;
106
+ botHmacSecret?: string | null;
107
+ }
93
108
  /**
94
109
  * Pick the onboarding link to show: the copy shipped with this installation
95
110
  * when present, otherwise the hosted document. Exported for testing.
96
111
  */
97
112
  export declare function resolveOnboardingUrl(localExists?: boolean, localHref?: string): string;
98
- declare function isVaultSecret(value: any): boolean;
99
- declare function createVaultSecret(vaultKey: any, extra?: Record<string, any>): {
100
- kind: string;
101
- version: any;
102
- vaultKeyHex: string;
103
- };
104
- declare function createSessionSecret(vaultKey: any, sessionSalt?: any): {
113
+ declare function isVaultSecret(value: unknown): boolean;
114
+ declare function createVaultSecret(vaultKey: unknown, extra?: Record<string, unknown>): VaultSecret;
115
+ declare function createSessionSecret(vaultKey: unknown, sessionSalt?: unknown): {
105
116
  kind: string;
106
117
  version: number;
107
118
  sessionSaltHex: string;
108
119
  vaultKeyHex: string;
109
120
  };
110
- declare function createDaemonSigningToken(accountName: string, options?: Record<string, any>): {
121
+ declare function createDaemonSigningToken(accountName: string, options?: DaemonSigningOptions): {
111
122
  kind: string;
112
123
  accountName: string;
113
- socketPath: any;
114
- sessionId: any;
115
- botHmacSecret: any;
124
+ socketPath: string;
125
+ sessionId: string | null;
126
+ botHmacSecret: string | null;
116
127
  };
117
- declare function isDaemonSigningToken(value: any): boolean;
118
- declare function deriveVaultKey(password: any, vaultSalt: any): any;
128
+ declare function isDaemonSigningToken(value: unknown): boolean;
129
+ declare function deriveVaultKey(password: string, vaultSalt: unknown): NonSharedBuffer;
119
130
  /**
120
131
  * Encrypt text using the v2 AES-256-GCM vault format.
121
132
  * @param {string} text - Plain text to encrypt
122
133
  * @param {Object|Buffer} secret - Derived vault secret
123
134
  * @returns {string} Encrypted data as hex string
124
135
  */
125
- declare function encrypt(text: any, secret: any): string;
136
+ declare function encrypt(text: string, secret: unknown): string;
126
137
  /**
127
138
  * Decrypt text encrypted with the encrypt() function.
128
139
  * @param {string} encrypted - Colon-separated encrypted data
@@ -130,14 +141,14 @@ declare function encrypt(text: any, secret: any): string;
130
141
  * @returns {string} Decrypted plain text
131
142
  * @throws {Error} If decryption fails (wrong password or corrupted data)
132
143
  */
133
- declare function decrypt(encrypted: any, secret: any): any;
144
+ declare function decrypt(encrypted: unknown, secret: unknown): string;
134
145
  /**
135
146
  * Validate a private key format.
136
147
  * Supports WIF (Base58Check), PVT_K1_* style, and 64-char hex.
137
148
  * @param {string} key - Private key to validate
138
149
  * @returns {Object} { valid: boolean, reason?: string }
139
150
  */
140
- declare function validatePrivateKey(key: any): {
151
+ declare function validatePrivateKey(key: unknown): {
141
152
  valid: boolean;
142
153
  reason: string;
143
154
  } | {
@@ -149,18 +160,13 @@ declare function validatePrivateKey(key: any): {
149
160
  * Returns empty structure if file doesn't exist or is corrupted.
150
161
  * @returns {Object} { vaultVersion: number, vaultSalt: string, vaultVerifier: string, accounts: Object }
151
162
  */
152
- declare function loadAccounts(): {
153
- vaultVersion: number;
154
- vaultSalt: string;
155
- vaultVerifier: string;
156
- accounts: any;
157
- };
163
+ declare function loadAccounts(): AccountsData;
158
164
  /**
159
165
  * Report whether the key vault has a usable account entry.
160
166
  * Password metadata alone is not sufficient: cancelling key setup can leave
161
167
  * a valid-looking vault with no account key to use at runtime.
162
168
  */
163
- declare function hasKeySetup(accountsData?: any): boolean;
169
+ declare function hasKeySetup(accountsData?: AccountsData): boolean;
164
170
  /**
165
171
  * Check that the keys file has restrictive permissions (0o600) and is owned by
166
172
  * the current user. Returns silently if the file doesn't exist yet (it will be
@@ -174,16 +180,12 @@ declare function checkKeysFileSecurity(): void;
174
180
  * Unlock the key vault with a master password.
175
181
  * Uses modern scrypt v2 vault format with HMAC verification.
176
182
  * @param {string} password - Master password
177
- * @param {any} [accountsData=loadAccounts()] - Accounts data object
178
- * @returns {any} Derived vault secret
183
+ * @param {unknown} [accountsData=loadAccounts()] - Accounts data object
184
+ * @returns {unknown} Derived vault secret
179
185
  * @throws {MasterPasswordError} If password is incorrect
180
186
  * @throws {Error} If vault format is unsupported
181
187
  */
182
- declare function unlockWithPassword(password: any, accountsData?: any): {
183
- kind: string;
184
- version: any;
185
- vaultKeyHex: string;
186
- };
188
+ declare function unlockWithPassword(password: string, accountsData?: AccountsData): VaultSecret;
187
189
  declare class MasterPasswordError extends Error {
188
190
  static code: string;
189
191
  code: string;
@@ -195,10 +197,10 @@ declare class MasterPasswordError extends Error {
195
197
  * @param {Error} err - Error to check
196
198
  * @returns {boolean} True if the error indicates authentication could not complete
197
199
  */
198
- declare function isMasterPasswordFailure(err: any): boolean;
200
+ declare function isMasterPasswordFailure(err: unknown): boolean;
199
201
  type VaultSecret = {
200
202
  kind: string;
201
- version: any;
203
+ version: number;
202
204
  vaultKeyHex: string;
203
205
  };
204
206
  /**
@@ -217,7 +219,7 @@ declare function authenticate(): Promise<VaultSecret>;
217
219
  * @returns {string} Decrypted private key
218
220
  * @throws {Error} If account not found
219
221
  */
220
- declare function getPrivateKey(accountName: any, vaultSecret: any): any;
222
+ declare function getPrivateKey(accountName: string, vaultSecret: unknown): string;
221
223
  /**
222
224
  * Resolve a signing key for an account, following on-chain authority structures
223
225
  * (account_auths, key_auths) when no direct key is stored.
@@ -228,7 +230,7 @@ declare function getPrivateKey(accountName: any, vaultSecret: any): any;
228
230
  * @returns {Promise<string>} Private key WIF string
229
231
  * @throws {Error} If no key can be found through direct lookup or authority resolution
230
232
  */
231
- declare function resolvePrivateKey(accountName: any, vaultSecret: any, chainClient: any): Promise<any>;
233
+ declare function resolvePrivateKey(accountName: string, vaultSecret: unknown, chainClient: unknown): Promise<string>;
232
234
  /**
233
235
  * Save accounts data to profiles/keys.json atomically with restrictive permissions.
234
236
  * Writes to a temp file in the same directory, fsyncs, then renames over the target.
@@ -237,7 +239,7 @@ declare function resolvePrivateKey(accountName: any, vaultSecret: any, chainClie
237
239
  *
238
240
  * @param {Object} data - Accounts data to save
239
241
  */
240
- declare function saveAccounts(data: any): void;
242
+ declare function saveAccounts(data: AccountsData): void;
241
243
  /**
242
244
  * Launch the interactive key management CLI.
243
245
  * Provides menu for: add/modify/remove keys, test decryption,
@@ -249,7 +251,7 @@ declare function main(): Promise<boolean>;
249
251
  * @param {Object} [options={}] - Optional socket/ready-file path overrides
250
252
  * @returns {boolean} True if daemon socket is responsive
251
253
  */
252
- declare function isDaemonReady(options?: any): boolean;
254
+ declare function isDaemonReady(options?: DaemonPathOptions): boolean;
253
255
  /**
254
256
  * Check if dexbot-cred daemon is actually responsive by opening a socket
255
257
  * connection and waiting for any reply. This catches stale socket/ready
@@ -258,7 +260,7 @@ declare function isDaemonReady(options?: any): boolean;
258
260
  * @param {number} timeout - Probe timeout in milliseconds (default 2000)
259
261
  * @returns {Promise<boolean>} True if the daemon accepts connections and replies
260
262
  */
261
- declare function isDaemonResponsive(options?: any, timeout?: any): Promise<unknown>;
263
+ declare function isDaemonResponsive(options?: DaemonPathOptions, timeout?: number): Promise<boolean>;
262
264
  /**
263
265
  * Wait for dexbot-cred daemon to be ready
264
266
  * @param {number} maxWaitMs - Maximum time to wait in milliseconds (default 60000)
@@ -266,7 +268,7 @@ declare function isDaemonResponsive(options?: any, timeout?: any): Promise<unkno
266
268
  * @returns {Promise<void>} Resolves when daemon is ready
267
269
  * @throws {Error} If daemon doesn't start within timeout
268
270
  */
269
- declare function waitForDaemon(maxWaitMs?: any, options?: any): Promise<void>;
271
+ declare function waitForDaemon(maxWaitMs?: number, options?: DaemonPathOptions): Promise<void>;
270
272
  /**
271
273
  * Lightweight daemon health check. Does NOT create a session or write
272
274
  * an audit log entry — used by the credential daemon watchdog and
@@ -276,7 +278,7 @@ declare function waitForDaemon(maxWaitMs?: any, options?: any): Promise<void>;
276
278
  * @param {Object} options - Optional socket path overrides
277
279
  * @returns {Promise<boolean>} Resolves with true if daemon responds
278
280
  */
279
- declare function pingDaemon(accountName: any, timeout?: any, options?: any): Promise<any>;
281
+ declare function pingDaemon(accountName: string | null, timeout?: number, options?: DaemonPathOptions): Promise<boolean>;
280
282
  /**
281
283
  * Verifies the account exists in the daemon's session cache.
282
284
  * @param {string} accountName - Name of the account to probe
@@ -284,6 +286,6 @@ declare function pingDaemon(accountName: any, timeout?: any, options?: any): Pro
284
286
  * @param {Object} options - Optional socket path overrides
285
287
  * @returns {Promise<string|null>} Resolves with sessionId if account is available, rejects otherwise
286
288
  */
287
- declare function probeAccountInDaemon(accountName: any, timeout?: any, options?: any): Promise<any>;
289
+ declare function probeAccountInDaemon(accountName: string | null, timeout?: number, options?: DaemonPathOptions): Promise<string | null>;
288
290
  export { validatePrivateKey, loadAccounts, hasKeySetup, saveAccounts, checkKeysFileSecurity, encrypt, decrypt, deriveVaultKey, createDaemonSigningToken, createSessionSecret, createVaultSecret, isVaultSecret, isDaemonSigningToken, unlockWithPassword, main, authenticate, getPrivateKey, resolvePrivateKey, isMasterPasswordFailure, MasterPasswordError, isDaemonReady, isDaemonResponsive, waitForDaemon, probeAccountInDaemon, pingDaemon };
289
291
  //# sourceMappingURL=chain_keys.d.ts.map