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.
- package/CHANGELOG.md +67 -4
- package/README.md +2 -1
- package/analysis/README.md +11 -11
- package/analysis/ama_fitting/README.md +5 -3
- package/analysis/tradingview/README.md +1 -1
- package/analysis/trend_detection/DYNAMIC_WEIGHT_RESEARCH.md +3 -3
- package/claw/README.md +1 -0
- package/claw/docs/AI_BOT_LIBRARY_API.md +2 -0
- package/claw/docs/DEXBOT2_TUNING_CHEAT_SHEET.md +4 -3
- package/claw/modules/chain_broadcast.ts +7 -1
- package/claw/modules/claw_bridge.ts +0 -3
- package/claw/modules/claw_launcher.ts +1 -1
- package/claw/modules/claw_skill_md.ts +1 -0
- package/claw/modules/launcher_mode_detector.ts +9 -2
- package/claw/package.json +3 -3
- package/claw/runtimes/openclaw-plugin/openclaw.plugin.json +1 -1
- package/claw/runtimes/openclaw-plugin/package.json +1 -1
- package/claw/tsconfig.json +2 -2
- package/dist/analysis/account_resolver.d.ts +1 -1
- package/dist/analysis/account_resolver.js +2 -1
- package/dist/analysis/ama_fitting/analyze_ama_price_changes.js +3 -4
- package/dist/analysis/ama_fitting/analyze_lambda_vs_slow.js +3 -21
- package/dist/analysis/ama_fitting/calibrate_convergence_er.js +0 -1
- package/dist/analysis/ama_fitting/fetch_lp_candles.js +55 -45
- package/dist/analysis/ama_fitting/generate_unified_comparison_chart.d.ts +1 -8
- package/dist/analysis/ama_fitting/generate_unified_comparison_chart.js +45 -24
- package/dist/analysis/ama_fitting/optimizer_high_resolution.js +34 -78
- package/dist/analysis/analyze_args.d.ts +43 -0
- package/dist/analysis/analyze_args.js +61 -0
- package/dist/analysis/analyze_dynamic_weight.js +7 -17
- package/dist/analysis/analyze_kalman.js +7 -17
- package/dist/analysis/analyze_regime.js +7 -17
- package/dist/analysis/analyze_regime_windows.js +8 -18
- package/dist/analysis/analyze_risk_profile.js +8 -18
- package/dist/analysis/analyze_trade_heatmap.js +7 -17
- package/dist/analysis/analyze_volatility.js +7 -17
- package/dist/analysis/bot_fitting/backtest_ama_sweep.d.ts +221 -28
- package/dist/analysis/bot_fitting/backtest_ama_sweep.js +23 -103
- package/dist/analysis/bot_fitting/backtest_bot_fitting.d.ts +34 -4
- package/dist/analysis/bot_fitting/backtest_bot_fitting.js +32 -150
- package/dist/analysis/bot_fitting/backtest_lookback_drawdown.js +19 -34
- package/dist/analysis/bot_fitting/shared_utils.d.ts +77 -9
- package/dist/analysis/bot_fitting/shared_utils.js +125 -9
- package/dist/analysis/bot_key_utils.d.ts +18 -10
- package/dist/analysis/bot_key_utils.js +7 -4
- package/dist/analysis/bot_usage/discover_bot_accounts.js +44 -47
- package/dist/analysis/bot_usage/kibana_bot_queries.d.ts +1 -21
- package/dist/analysis/chain_pool.d.ts +3 -1
- package/dist/analysis/chart_ui.d.ts +35 -3
- package/dist/analysis/chart_ui.js +43 -4
- package/dist/analysis/chart_utils.d.ts +5 -5
- package/dist/analysis/chart_utils.js +9 -0
- package/dist/analysis/fills_cache.d.ts +4 -24
- package/dist/analysis/fills_cache.js +3 -84
- package/dist/analysis/fills_source.d.ts +33 -3
- package/dist/analysis/fills_source.js +83 -13
- package/dist/analysis/grid_correction_check.d.ts +2 -24
- package/dist/analysis/grid_correction_check.js +27 -69
- package/dist/analysis/math_utils.d.ts +91 -6
- package/dist/analysis/math_utils.js +119 -7
- package/dist/analysis/pnl_report.js +29 -29
- package/dist/analysis/price_sources.d.ts +30 -9
- package/dist/analysis/price_sources.js +28 -4
- package/dist/analysis/resolve_bot_accounts.js +2 -2
- package/dist/analysis/resolve_source.d.ts +1 -1
- package/dist/analysis/resolve_source.js +31 -10
- package/dist/analysis/trade_profitability.d.ts +29 -2
- package/dist/analysis/trade_profitability.js +73 -147
- package/dist/analysis/tradingview/analyze_tradingview.d.ts +3 -8
- package/dist/analysis/tradingview/analyze_tradingview.js +7 -6
- package/dist/analysis/tradingview/grid_reset_config.d.ts +41 -32
- package/dist/analysis/tradingview/grid_reset_config.js +23 -11
- package/dist/analysis/tradingview/grid_reset_sim.d.ts +75 -9
- package/dist/analysis/tradingview/grid_reset_sim.js +4 -3
- package/dist/analysis/tradingview/tradingview_uplot_chart_generator.d.ts +69 -4
- package/dist/analysis/tradingview/tradingview_uplot_chart_generator.js +20 -34
- package/dist/analysis/trend_detection/backtest_ama_slope_huber.d.ts +1 -101
- package/dist/analysis/trend_detection/backtest_ama_slope_huber.js +26 -84
- package/dist/analysis/trend_detection/dynamic_weight_chart_generator.d.ts +63 -1
- package/dist/analysis/trend_detection/dynamic_weight_chart_generator.js +16 -41
- package/dist/analysis/trend_detection/huber_scale_variants.d.ts +9 -3
- package/dist/analysis/trend_detection/huber_scale_variants.js +4 -4
- package/dist/analysis/trend_detection/kalman_chart_generator.d.ts +30 -1
- package/dist/analysis/trend_detection/kalman_chart_generator.js +3 -3
- package/dist/analysis/trend_detection/regime_chart_generator.d.ts +31 -1
- package/dist/analysis/trend_detection/regime_chart_generator.js +2 -2
- package/dist/analysis/trend_detection/volatility_chart_generator.d.ts +33 -1
- package/dist/analysis/trend_detection/volatility_chart_generator.js +9 -10
- package/dist/analysis/worker_pool.d.ts +38 -0
- package/dist/analysis/worker_pool.js +67 -0
- package/dist/credential-daemon.js +34 -20
- package/dist/dexbot.js +78 -59
- package/dist/market_adapter/ama_signal_runner.js +21 -54
- package/dist/market_adapter/candle_utils.d.ts +29 -19
- package/dist/market_adapter/candle_utils.js +35 -21
- package/dist/market_adapter/cli_args.d.ts +22 -0
- package/dist/market_adapter/cli_args.js +30 -0
- package/dist/market_adapter/core/asymmetric_bounds.d.ts +13 -4
- package/dist/market_adapter/core/config_normalizers.d.ts +3 -3
- package/dist/market_adapter/core/config_normalizers.js +11 -6
- package/dist/market_adapter/core/kibana_candles.d.ts +56 -19
- package/dist/market_adapter/core/kibana_candles.js +12 -9
- package/dist/market_adapter/core/kibana_client.d.ts +9 -1
- package/dist/market_adapter/core/kibana_client.js +8 -7
- package/dist/market_adapter/core/kibana_market_candles.d.ts +3 -2
- package/dist/market_adapter/core/market_adapter_service.d.ts +320 -153
- package/dist/market_adapter/core/market_adapter_service.js +228 -269
- package/dist/market_adapter/core/signals/hurst_analyzer.d.ts +1 -6
- package/dist/market_adapter/core/signals/hurst_analyzer.js +1 -1
- package/dist/market_adapter/core/signals/permutation_entropy_analyzer.d.ts +1 -11
- package/dist/market_adapter/core/signals/permutation_entropy_analyzer.js +1 -1
- package/dist/market_adapter/core/strategies/ama.d.ts +10 -2
- package/dist/market_adapter/core/strategies/ama.js +2 -4
- package/dist/market_adapter/core/strategies/ama_slope_model.d.ts +14 -1
- package/dist/market_adapter/core/strategies/ama_slope_model.js +12 -34
- package/dist/market_adapter/core/strategies/atr/calculator.d.ts +7 -2
- package/dist/market_adapter/core/strategies/atr/calculator.js +2 -34
- package/dist/market_adapter/core/strategies/collateral_manager.d.ts +7 -1
- package/dist/market_adapter/core/strategies/collateral_manager.js +0 -22
- package/dist/market_adapter/core/strategies/dynamic_weight_series.d.ts +34 -6
- package/dist/market_adapter/core/strategies/dynamic_weight_series.js +7 -7
- package/dist/market_adapter/core/strategies/regime_gate.d.ts +24 -15
- package/dist/market_adapter/core/strategies/regime_gate.js +4 -31
- package/dist/market_adapter/core/strategies/regime_interp.d.ts +7 -1
- package/dist/market_adapter/core/strategies/regime_interp.js +14 -22
- package/dist/market_adapter/core/strategies/volatility_shift.d.ts +11 -1
- package/dist/market_adapter/core/strategies/volatility_shift.js +0 -13
- package/dist/market_adapter/inputs/cex_candle_parsing.d.ts +29 -0
- package/dist/market_adapter/inputs/cex_candle_parsing.js +52 -0
- package/dist/market_adapter/inputs/fetch_book_data.d.ts +20 -4
- package/dist/market_adapter/inputs/fetch_book_data.js +3 -2
- package/dist/market_adapter/inputs/fetch_cex_synthetic_data.js +160 -332
- package/dist/market_adapter/inputs/fetch_lp_data.d.ts +50 -8
- package/dist/market_adapter/inputs/fetch_lp_data.js +47 -22
- package/dist/market_adapter/inputs/kibana_feed_source.d.ts +74 -15
- package/dist/market_adapter/inputs/kibana_feed_source.js +26 -41
- package/dist/market_adapter/inputs/kibana_source.d.ts +25 -3
- package/dist/market_adapter/inputs/kibana_source.js +2 -2
- package/dist/market_adapter/inputs/window_cache.d.ts +93 -156
- package/dist/market_adapter/inputs/window_cache.js +59 -184
- package/dist/market_adapter/interval_utils.d.ts +15 -5
- package/dist/market_adapter/interval_utils.js +16 -1
- package/dist/market_adapter/log_format.d.ts +6 -6
- package/dist/market_adapter/log_format.js +28 -21
- package/dist/market_adapter/lp_chart_core.d.ts +22 -1
- package/dist/market_adapter/lp_chart_core.js +26 -192
- package/dist/market_adapter/lp_chart_runner.d.ts +10 -7
- package/dist/market_adapter/lp_chart_runner.js +37 -19
- package/dist/market_adapter/lp_chart_strategy_loader.d.ts +41 -6
- package/dist/market_adapter/lp_chart_strategy_loader.js +8 -7
- package/dist/market_adapter/market_adapter.d.ts +94 -32
- package/dist/market_adapter/market_adapter.js +94 -120
- package/dist/market_adapter/utils/adapter_client.d.ts +3 -3
- package/dist/market_adapter/utils/adapter_client.js +2 -2
- package/dist/market_adapter/utils/atomic_write.d.ts +8 -1
- package/dist/market_adapter/utils/chain.d.ts +50 -41
- package/dist/market_adapter/utils/chain.js +40 -46
- package/dist/market_adapter/utils/data_discovery.d.ts +49 -2
- package/dist/market_adapter/utils/data_discovery.js +220 -27
- package/dist/market_adapter/utils/dynamic_grid_snapshot.d.ts +12 -3
- package/dist/market_adapter/utils/file_json_cache.d.ts +2 -2
- package/dist/market_adapter/utils/file_lock.d.ts +28 -14
- package/dist/market_adapter/utils/file_lock.js +36 -32
- package/dist/market_adapter/utils/month_shards.d.ts +84 -0
- package/dist/market_adapter/utils/month_shards.js +237 -0
- package/dist/market_adapter/utils/native_history.d.ts +9 -2
- package/dist/market_adapter/utils/native_history.js +35 -28
- package/dist/modules/account_bots.d.ts +578 -21
- package/dist/modules/account_bots.js +272 -267
- package/dist/modules/account_orders.d.ts +79 -30
- package/dist/modules/account_orders.js +60 -64
- package/dist/modules/authority_resolver.d.ts +12 -2
- package/dist/modules/authority_resolver.js +15 -8
- package/dist/modules/bitshares-native/chain_client.d.ts +39 -4
- package/dist/modules/bitshares-native/chain_client.js +59 -59
- package/dist/modules/bitshares-native/crypto/ecc.browser.js +11 -171
- package/dist/modules/bitshares-native/crypto/ecc.js +13 -176
- package/dist/modules/bitshares-native/crypto/ecc_core.d.ts +33 -0
- package/dist/modules/bitshares-native/crypto/ecc_core.js +213 -0
- package/dist/modules/bitshares-native/crypto/ecc_selector.d.ts +2 -1
- package/dist/modules/bitshares-native/crypto/ecc_selector.js +1 -13
- package/dist/modules/bitshares-native/index.d.ts +1 -1
- package/dist/modules/bitshares-native/lru_cache.d.ts +7 -7
- package/dist/modules/bitshares-native/resolvers.d.ts +18 -6
- package/dist/modules/bitshares-native/resolvers.js +22 -25
- package/dist/modules/bitshares-native/serial/lazy_buffer.d.ts +4 -0
- package/dist/modules/bitshares-native/serial/lazy_buffer.js +21 -0
- package/dist/modules/bitshares-native/serial/operations.d.ts +1 -1
- package/dist/modules/bitshares-native/serial/serializer.d.ts +16 -12
- package/dist/modules/bitshares-native/serial/serializer.js +7 -13
- package/dist/modules/bitshares-native/serial/types.d.ts +25 -16
- package/dist/modules/bitshares-native/serial/types.js +73 -108
- package/dist/modules/bitshares-native/signing_client.d.ts +32 -2
- package/dist/modules/bitshares-native/signing_client.js +19 -14
- package/dist/modules/bitshares-native/subscriptions.d.ts +81 -1
- package/dist/modules/bitshares-native/subscriptions.js +12 -12
- package/dist/modules/bitshares-native/transport.d.ts +5 -4
- package/dist/modules/bitshares-native/transport.js +5 -4
- package/dist/modules/bitshares-native/tx/builder.d.ts +40 -5
- package/dist/modules/bitshares-native/tx/builder.js +4 -3
- package/dist/modules/bitshares-native/tx/tx_cache.d.ts +4 -4
- package/dist/modules/bitshares_client.d.ts +45 -13
- package/dist/modules/bitshares_client.js +28 -19
- package/dist/modules/bot_defaults.d.ts +8 -16
- package/dist/modules/bot_defaults.js +1 -5
- package/dist/modules/bot_settings.d.ts +44 -10
- package/dist/modules/bot_settings.js +11 -8
- package/dist/modules/bots_file_lock.d.ts +6 -6
- package/dist/modules/bots_file_lock.js +16 -12
- package/dist/modules/broadcast_failure.d.ts +4 -3
- package/dist/modules/broadcast_failure.js +5 -4
- package/dist/modules/chain_keys.d.ts +42 -40
- package/dist/modules/chain_keys.js +53 -45
- package/dist/modules/chain_orders.d.ts +94 -60
- package/dist/modules/chain_orders.js +81 -118
- package/dist/modules/cli_start_onboarding.d.ts +2 -1
- package/dist/modules/constants.d.ts +534 -32
- package/dist/modules/constants.js +35 -48
- package/dist/modules/cr_planner.d.ts +41 -3
- package/dist/modules/cr_planner.js +1 -5
- package/dist/modules/credential_policy.d.ts +68 -8
- package/dist/modules/credential_policy.js +37 -31
- package/dist/modules/credential_session_cache.d.ts +2 -2
- package/dist/modules/credit_pricing.d.ts +43 -6
- package/dist/modules/credit_pricing.js +70 -60
- package/dist/modules/credit_runtime.d.ts +283 -118
- package/dist/modules/credit_runtime.js +500 -231
- package/dist/modules/crypto/browser_provider.js +6 -4
- package/dist/modules/crypto/node_provider.js +1 -1
- package/dist/modules/crypto/pure_scrypt.js +35 -4
- package/dist/modules/crypto/pure_secp256k1.js +72 -26
- package/dist/modules/crypto/sync.d.ts +9 -9
- package/dist/modules/crypto/sync.js +16 -9
- package/dist/modules/daemon_node_health.d.ts +4 -3
- package/dist/modules/dexbot_class.d.ts +213 -146
- package/dist/modules/dexbot_class.js +183 -86
- package/dist/modules/dexbot_cow_runtime.d.ts +160 -87
- package/dist/modules/dexbot_cow_runtime.js +302 -234
- package/dist/modules/dexbot_credential_client.d.ts +19 -18
- package/dist/modules/dexbot_credential_client.js +1 -2
- package/dist/modules/dexbot_fill_runtime.d.ts +63 -49
- package/dist/modules/dexbot_fill_runtime.js +53 -47
- package/dist/modules/dexbot_maintenance_runtime.d.ts +127 -71
- package/dist/modules/dexbot_maintenance_runtime.js +187 -147
- package/dist/modules/dexbot_startup_runtime.d.ts +11 -11
- package/dist/modules/dexbot_startup_runtime.js +56 -57
- package/dist/modules/dexbot_state_recovery.d.ts +13 -12
- package/dist/modules/dexbot_state_recovery.js +18 -13
- package/dist/modules/fund_registry.d.ts +4 -2
- package/dist/modules/fund_registry.js +10 -10
- package/dist/modules/general_settings.d.ts +30 -4
- package/dist/modules/graceful_shutdown.d.ts +3 -3
- package/dist/modules/graceful_shutdown.js +19 -13
- package/dist/modules/grid_price_source.d.ts +1 -1
- package/dist/modules/key_store.d.ts +14 -8
- package/dist/modules/key_store.js +7 -7
- package/dist/modules/launcher/adapter_requirement.d.ts +11 -5
- package/dist/modules/launcher/adapter_requirement.js +5 -5
- package/dist/modules/launcher/bot_supervisor.d.ts +106 -24
- package/dist/modules/launcher/bot_supervisor.js +12 -11
- package/dist/modules/launcher/credential_bootstrap.d.ts +1 -1
- package/dist/modules/launcher/credential_bootstrap.js +1 -1
- package/dist/modules/launcher/credential_daemon.d.ts +4 -4
- package/dist/modules/launcher/credential_daemon.js +2 -2
- package/dist/modules/launcher/credential_secret.d.ts +1 -1
- package/dist/modules/launcher/foreign_cred_daemon.d.ts +2 -2
- package/dist/modules/launcher/market_adapter_runtime.d.ts +61 -6
- package/dist/modules/launcher/market_adapter_watchdog.d.ts +10 -2
- package/dist/modules/launcher/market_adapter_watchdog.js +4 -0
- package/dist/modules/launcher/monolithic_runtime.d.ts +18 -16
- package/dist/modules/launcher/status_reporting.d.ts +22 -14
- package/dist/modules/launcher/supervisor_control.d.ts +8 -1
- package/dist/modules/launcher/supervisor_control.js +4 -2
- package/dist/modules/lazy_shim.d.ts +11 -0
- package/dist/modules/lazy_shim.js +16 -0
- package/dist/modules/market_adapter_whitelist.d.ts +9 -3
- package/dist/modules/market_adapter_whitelist.js +15 -3
- package/dist/modules/node_connect_policy.d.ts +3 -2
- package/dist/modules/node_failure_ledger.d.ts +6 -5
- package/dist/modules/node_manager.d.ts +41 -11
- package/dist/modules/node_manager.js +5 -4
- package/dist/modules/order/accounting.d.ts +53 -24
- package/dist/modules/order/accounting.js +16 -15
- package/dist/modules/order/async_lock.d.ts +5 -2
- package/dist/modules/order/async_lock.js +1 -1
- package/dist/modules/order/export.d.ts +7 -6
- package/dist/modules/order/export.js +1 -7
- package/dist/modules/order/format.d.ts +16 -7
- package/dist/modules/order/format.js +15 -3
- package/dist/modules/order/genesis_policy.d.ts +24 -21
- package/dist/modules/order/genesis_policy.js +17 -10
- package/dist/modules/order/grid.d.ts +144 -36
- package/dist/modules/order/grid.js +226 -145
- package/dist/modules/order/grid_reconcile.d.ts +21 -20
- package/dist/modules/order/grid_reconcile.js +13 -12
- package/dist/modules/order/grid_reconcile_internal.d.ts +85 -72
- package/dist/modules/order/grid_reconcile_internal.js +28 -19
- package/dist/modules/order/index.d.ts +264 -1
- package/dist/modules/order/logger.d.ts +46 -19
- package/dist/modules/order/logger.js +38 -49
- package/dist/modules/order/logger_state.d.ts +4 -4
- package/dist/modules/order/manager.d.ts +232 -191
- package/dist/modules/order/manager.js +110 -130
- package/dist/modules/order/processed_fill_store.d.ts +18 -3
- package/dist/modules/order/processed_fill_store.js +16 -27
- package/dist/modules/order/strategy.d.ts +21 -13
- package/dist/modules/order/strategy.js +5 -6
- package/dist/modules/order/sync_engine.d.ts +91 -33
- package/dist/modules/order/sync_engine.js +84 -53
- package/dist/modules/order/utils/math.d.ts +157 -102
- package/dist/modules/order/utils/math.js +77 -38
- package/dist/modules/order/utils/order.d.ts +310 -110
- package/dist/modules/order/utils/order.js +153 -126
- package/dist/modules/order/utils/slot.d.ts +1 -1
- package/dist/modules/order/utils/system.d.ts +156 -26
- package/dist/modules/order/utils/system.js +103 -71
- package/dist/modules/order/utils/validate.d.ts +89 -41
- package/dist/modules/order/utils/validate.js +26 -24
- package/dist/modules/order/utils/withPoolRef.d.ts +6 -4
- package/dist/modules/order/utils/withPoolRef.js +18 -12
- package/dist/modules/order/working_grid.d.ts +14 -13
- package/dist/modules/paths.d.ts +1 -4
- package/dist/modules/paths.js +33 -61
- package/dist/modules/process_discovery.d.ts +1 -1
- package/dist/modules/process_discovery.js +2 -1
- package/dist/modules/runtime.d.ts +7 -3
- package/dist/modules/runtime.js +4 -3
- package/dist/modules/runtime_settings.d.ts +14 -11
- package/dist/modules/runtime_settings.js +30 -24
- package/dist/modules/settings_merge.d.ts +29 -3
- package/dist/modules/settings_merge.js +56 -78
- package/dist/modules/socket_json_client.d.ts +9 -5
- package/dist/modules/storage/browser_adapter.d.ts +38 -53
- package/dist/modules/storage/browser_adapter.js +7 -30
- package/dist/modules/storage/index.d.ts +1 -1
- package/dist/modules/storage/node_adapter.d.ts +45 -27
- package/dist/modules/storage/node_adapter.js +9 -9
- package/dist/modules/storage/types.d.ts +5 -4
- package/dist/modules/types.d.ts +1090 -6
- package/dist/modules/types.js +4 -1
- package/dist/modules/utils/asset_symbols.d.ts +2 -1
- package/dist/modules/utils/asset_symbols.js +2 -1
- package/dist/modules/utils/errors.d.ts +9 -0
- package/dist/modules/utils/errors.js +24 -4
- package/dist/modules/utils/time_range.d.ts +1 -12
- package/dist/modules/utils/time_range.js +1 -1
- package/dist/modules/validate_profiles.js +53 -43
- package/dist/modules/version_notice.d.ts +23 -11
- package/dist/modules/version_notice.js +6 -4
- package/dist/pm2.d.ts +28 -27
- package/dist/pm2.js +61 -40
- package/dist/scripts/analyze-credit.d.ts +2 -1
- package/dist/scripts/analyze-credit.js +23 -24
- package/dist/scripts/analyze-git.js +2 -15
- package/dist/scripts/analyze-orders.d.ts +77 -9
- package/dist/scripts/analyze-orders.js +65 -40
- package/dist/scripts/chart_command.d.ts +27 -18
- package/dist/scripts/chart_command.js +15 -13
- package/dist/scripts/check_any.d.ts +22 -0
- package/dist/scripts/check_any.js +158 -0
- package/dist/scripts/diagnose-pool-history.js +13 -13
- package/dist/scripts/print_grid.js +0 -1
- package/dist/scripts/run-tests.js +39 -8
- package/dist/scripts/runner.js +1 -1
- package/dist/scripts/sync-version.js +0 -10
- package/dist/scripts/test-credit-renewal.js +30 -21
- package/dist/scripts/update.d.ts +10 -5
- package/dist/scripts/update.js +168 -103
- package/dist/scripts/update_dist_freshness.js +1 -0
- package/dist/scripts/update_layout.d.ts +61 -0
- package/dist/scripts/update_layout.js +180 -0
- package/dist/scripts/validate_bots.js +2 -1
- package/dist/scripts/verify-browser-bundle.js +8 -0
- package/dist/unlock.d.ts +28 -3
- package/dist/unlock.js +63 -35
- package/docs/BITSHARES_ONBOARDING.md +10 -12
- package/docs/COPY_ON_WRITE_MASTER_PLAN.md +2 -2
- package/docs/COW_INVARIANTS.md +13 -6
- package/docs/DEXBOT_COMPARISON.md +8 -8
- package/docs/EVOLUTION.md +10 -8
- package/docs/FUND_MOVEMENT_AND_ACCOUNTING.md +5 -5
- package/docs/GRID_RECALCULATION.md +4 -2
- package/docs/GRID_RECONCILE.md +14 -3
- package/docs/LIFECYCLE.md +11 -11
- package/docs/MPA_CREDIT_USAGE.md +22 -3
- package/docs/README.md +14 -3
- package/docs/WORKFLOW.md +1 -0
- package/docs/architecture.md +31 -19
- package/docs/developer_guide.md +6 -6
- package/market_adapter/README.md +12 -5
- package/modules/README.md +4 -1
- package/package.json +9 -9
- package/scripts/README.md +43 -38
- package/tests/README.md +25 -10
- package/dist/scripts/diagnose-kibana-candles.d.ts +0 -3
- package/dist/scripts/diagnose-kibana-candles.js +0 -82
- package/scripts/git-viewer.sh +0 -489
- package/scripts/postinstall.js +0 -16
|
@@ -7,15 +7,15 @@ declare const MONOLITHIC_OUT_LOG: string;
|
|
|
7
7
|
declare const MONOLITHIC_ERROR_LOG: string;
|
|
8
8
|
declare const CREDENTIAL_SOCKET_FILE: string;
|
|
9
9
|
declare const CREDENTIAL_READY_FILE: string;
|
|
10
|
-
declare function formatBotCount(count:
|
|
10
|
+
declare function formatBotCount(count: number): string;
|
|
11
11
|
declare function cleanupStateFiles(): void;
|
|
12
12
|
declare function readLiveMonolithicPid(): {
|
|
13
13
|
pid: number;
|
|
14
14
|
stale: boolean;
|
|
15
15
|
};
|
|
16
16
|
declare function readMonolithicBotInfo(): any;
|
|
17
|
-
declare function isLikelyCredentialDaemonProcess(pid:
|
|
18
|
-
declare function isExpectedMonolithicBotPid(pid:
|
|
17
|
+
declare function isLikelyCredentialDaemonProcess(pid: number): boolean;
|
|
18
|
+
declare function isExpectedMonolithicBotPid(pid: number, botInfo: Record<string, unknown> | null): boolean;
|
|
19
19
|
declare function isProcessInDstate(pid: number): boolean;
|
|
20
20
|
declare function stopCredentialDaemonPid(pid: string | number): Promise<void>;
|
|
21
21
|
declare function cleanupCredentialRuntimeFiles(): void;
|
|
@@ -23,7 +23,9 @@ declare function stopCredentialDaemon(): Promise<{
|
|
|
23
23
|
signaled: boolean;
|
|
24
24
|
cleaned: boolean;
|
|
25
25
|
}>;
|
|
26
|
-
declare function ensureNoForeignCredentialDaemon({ verbose }?:
|
|
26
|
+
declare function ensureNoForeignCredentialDaemon({ verbose }?: {
|
|
27
|
+
verbose?: boolean;
|
|
28
|
+
}): Promise<boolean>;
|
|
27
29
|
declare function findCredentialSocketOwnerPid(): number;
|
|
28
30
|
declare function readCredentialDaemonStatus(pid: number | null): Promise<{
|
|
29
31
|
alive: boolean;
|
|
@@ -31,25 +33,25 @@ declare function readCredentialDaemonStatus(pid: number | null): Promise<{
|
|
|
31
33
|
socket: boolean;
|
|
32
34
|
}>;
|
|
33
35
|
declare function ensureLogDir(): void;
|
|
34
|
-
declare function buildDexbotStartArgs(botName:
|
|
36
|
+
declare function buildDexbotStartArgs(botName: string | null | undefined, dryrun?: boolean): string[];
|
|
35
37
|
declare function createUpdateScheduler({ botProcessRef, warn }?: {
|
|
36
38
|
botProcessRef?: {
|
|
37
|
-
current:
|
|
39
|
+
current: import('node:child_process').ChildProcess | null;
|
|
38
40
|
};
|
|
39
|
-
warn?: (...data:
|
|
41
|
+
warn?: (...data: unknown[]) => void;
|
|
40
42
|
}): {
|
|
41
43
|
cancel: () => void;
|
|
42
44
|
pendingRestart: boolean;
|
|
43
45
|
};
|
|
44
|
-
declare function listConfiguredBots(botsFile?:
|
|
45
|
-
name:
|
|
46
|
+
declare function listConfiguredBots(botsFile?: string): Array<{
|
|
47
|
+
name: string;
|
|
46
48
|
active: boolean;
|
|
47
|
-
gridPrice:
|
|
48
|
-
}
|
|
49
|
-
declare function getActiveAmaBotFingerprint(botsFile?:
|
|
50
|
-
declare function getControlBotNames(target:
|
|
51
|
-
declare function getControlActionLabel(cmd:
|
|
52
|
-
declare function getControlServiceNames(cmd:
|
|
53
|
-
declare function printControlActionSummary(action:
|
|
49
|
+
gridPrice: string;
|
|
50
|
+
}>;
|
|
51
|
+
declare function getActiveAmaBotFingerprint(botsFile?: string): string;
|
|
52
|
+
declare function getControlBotNames(target: string | null | undefined, wholeRuntime?: boolean): string[];
|
|
53
|
+
declare function getControlActionLabel(cmd: string): "shutting down" | "restarting" | "reloading" | "stopping";
|
|
54
|
+
declare function getControlServiceNames(cmd: string, botNames: string[]): string[];
|
|
55
|
+
declare function printControlActionSummary(action: string, botNames: string[], serviceNames?: string[]): void;
|
|
54
56
|
export { MONOLITHIC_PID_FILE, MONOLITHIC_BOT_PID_FILE, MONOLITHIC_BOT_INFO_FILE, MONOLITHIC_CRED_PID_FILE, MONOLITHIC_OUT_LOG, MONOLITHIC_ERROR_LOG, CREDENTIAL_SOCKET_FILE, CREDENTIAL_READY_FILE, cleanupStateFiles, readLiveMonolithicPid, readMonolithicBotInfo, isLikelyCredentialDaemonProcess, isExpectedMonolithicBotPid, readProcStat, isProcessInDstate, stopCredentialDaemonPid, cleanupCredentialRuntimeFiles, stopCredentialDaemon, ensureNoForeignCredentialDaemon, findCredentialSocketOwnerPid, readCredentialDaemonStatus, ensureLogDir, buildDexbotStartArgs, createUpdateScheduler, getActiveAmaBotFingerprint, listConfiguredBots, getControlBotNames, getControlActionLabel, getControlServiceNames, printControlActionSummary, formatBotCount };
|
|
55
57
|
//# sourceMappingURL=monolithic_runtime.d.ts.map
|
|
@@ -6,19 +6,27 @@ declare const STATUS_COLORS: {
|
|
|
6
6
|
warn: "\u001B[1;31m";
|
|
7
7
|
muted: "\u001B[97m";
|
|
8
8
|
};
|
|
9
|
-
declare function colorStatus(text: string, color: string, stream?:
|
|
10
|
-
|
|
11
|
-
|
|
12
|
-
declare function
|
|
13
|
-
declare function
|
|
14
|
-
declare function
|
|
15
|
-
declare function
|
|
16
|
-
declare function
|
|
17
|
-
declare function
|
|
18
|
-
declare function
|
|
19
|
-
declare function
|
|
20
|
-
declare function
|
|
21
|
-
declare function
|
|
22
|
-
declare function
|
|
9
|
+
declare function colorStatus(text: string, color: string, stream?: {
|
|
10
|
+
isTTY?: boolean;
|
|
11
|
+
}): string;
|
|
12
|
+
declare function statusTitle(text: string): string;
|
|
13
|
+
declare function statusLabel(text: string): string;
|
|
14
|
+
declare function statusBool(value: unknown): string;
|
|
15
|
+
declare function statusActiveBotName(name: string): string;
|
|
16
|
+
declare function statusSuccess(text: string): string;
|
|
17
|
+
declare function statusError(text: string): string;
|
|
18
|
+
declare function readProcStat(pid: number): import("../process_discovery.js").ProcessStat | null;
|
|
19
|
+
declare function readProcMemMB(pid: number): string;
|
|
20
|
+
declare function readProcCpuTime(pid: number): string;
|
|
21
|
+
declare function readProcCpuPercent(pid: number, samples?: number, intervalMs?: number): Promise<string>;
|
|
22
|
+
declare function readProcUptime(pid: number): string;
|
|
23
|
+
declare function formatMemoryWithUptime(memory: string, uptime: string | null | undefined): string;
|
|
24
|
+
interface ControlBotStatus {
|
|
25
|
+
uptimeMs?: number;
|
|
26
|
+
status?: string;
|
|
27
|
+
pid?: number;
|
|
28
|
+
restarts?: number;
|
|
29
|
+
}
|
|
30
|
+
declare function printControlStatus(status: Record<string, ControlBotStatus>): void;
|
|
23
31
|
export { STATUS_COLORS, colorStatus, statusTitle, statusLabel, statusBool, statusActiveBotName, statusSuccess, statusError, readProcStat, readProcMemMB, readProcCpuTime, readProcCpuPercent, readProcUptime, formatMemoryWithUptime, printControlStatus };
|
|
24
32
|
//# sourceMappingURL=status_reporting.d.ts.map
|
|
@@ -1,3 +1,10 @@
|
|
|
1
|
-
|
|
1
|
+
import type { UnknownRecord } from '../types.js';
|
|
2
|
+
interface ControlResponse {
|
|
3
|
+
ok?: boolean;
|
|
4
|
+
status?: unknown;
|
|
5
|
+
error?: string;
|
|
6
|
+
[key: string]: unknown;
|
|
7
|
+
}
|
|
8
|
+
declare function sendControlCommand(cmd: UnknownRecord): Promise<ControlResponse>;
|
|
2
9
|
export { sendControlCommand };
|
|
3
10
|
//# sourceMappingURL=supervisor_control.d.ts.map
|
|
@@ -1,6 +1,7 @@
|
|
|
1
1
|
'use strict';
|
|
2
2
|
import net from 'node:net';
|
|
3
3
|
import { SOCKET_PATH } from './bot_supervisor.js';
|
|
4
|
+
import { getErrorCode } from '../utils/errors.js';
|
|
4
5
|
function sendControlCommand(cmd) {
|
|
5
6
|
return new Promise((resolve, reject) => {
|
|
6
7
|
const socket = net.createConnection(SOCKET_PATH);
|
|
@@ -17,7 +18,7 @@ function sendControlCommand(cmd) {
|
|
|
17
18
|
if (err)
|
|
18
19
|
reject(err);
|
|
19
20
|
else
|
|
20
|
-
resolve(result);
|
|
21
|
+
resolve(result ?? {});
|
|
21
22
|
};
|
|
22
23
|
const timeout = setTimeout(() => {
|
|
23
24
|
done(new Error('Connection timed out. Is the supervisor running?'));
|
|
@@ -46,7 +47,8 @@ function sendControlCommand(cmd) {
|
|
|
46
47
|
});
|
|
47
48
|
socket.on('error', (err) => {
|
|
48
49
|
clearTimeout(timeout);
|
|
49
|
-
|
|
50
|
+
const code = getErrorCode(err);
|
|
51
|
+
if (code === 'ENOENT' || code === 'ECONNREFUSED') {
|
|
50
52
|
done(new Error('No supervisor socket found. Start bots with: dexbot start --isolated'));
|
|
51
53
|
}
|
|
52
54
|
else {
|
|
@@ -0,0 +1,11 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Build a lazy pass-through to a named export. The require runs on each call
|
|
3
|
+
* (Node caches modules), which keeps heavy or circular targets out of the
|
|
4
|
+
* static import graph without a hand-written wrapper per function. The
|
|
5
|
+
* returned function keeps the previous `(...args: unknown[]) => any` shape.
|
|
6
|
+
*
|
|
7
|
+
* Lives directly under modules/ so `require(modulePath)` resolves relative
|
|
8
|
+
* paths identically to the runtime modules that call it.
|
|
9
|
+
*/
|
|
10
|
+
export declare function lazyShim(modulePath: string, exportName: string): (...args: unknown[]) => any;
|
|
11
|
+
//# sourceMappingURL=lazy_shim.d.ts.map
|
|
@@ -0,0 +1,16 @@
|
|
|
1
|
+
/** Lazy named-export pass-through shared by the Node-only runtime modules. */
|
|
2
|
+
import { createRequire } from 'node:module';
|
|
3
|
+
const require = createRequire(import.meta.url);
|
|
4
|
+
/**
|
|
5
|
+
* Build a lazy pass-through to a named export. The require runs on each call
|
|
6
|
+
* (Node caches modules), which keeps heavy or circular targets out of the
|
|
7
|
+
* static import graph without a hand-written wrapper per function. The
|
|
8
|
+
* returned function keeps the previous `(...args: unknown[]) => any` shape.
|
|
9
|
+
*
|
|
10
|
+
* Lives directly under modules/ so `require(modulePath)` resolves relative
|
|
11
|
+
* paths identically to the runtime modules that call it.
|
|
12
|
+
*/
|
|
13
|
+
export function lazyShim(modulePath, exportName) {
|
|
14
|
+
return (...args) => require(modulePath)[exportName](...args);
|
|
15
|
+
}
|
|
16
|
+
//# sourceMappingURL=lazy_shim.js.map
|
|
@@ -9,11 +9,17 @@ declare const DEFAULT_WHITELIST_FLAGS: WhitelistFlags;
|
|
|
9
9
|
/** AMA enabled only — legacy `whitelist: [botKey]` array entries, and the
|
|
10
10
|
* generator's base shape for a fresh AMA-bot entry (CLI flags override). */
|
|
11
11
|
declare const AMA_ONLY_WHITELIST_FLAGS: WhitelistFlags;
|
|
12
|
-
/** Legacy per-entry `true` shorthand: every flag on. */
|
|
13
|
-
declare const ALL_ENABLED_WHITELIST_FLAGS: WhitelistFlags;
|
|
14
12
|
declare function resetMarketAdapterWhitelistCache(): void;
|
|
15
13
|
declare function getWhitelistFlags(botKey: string): WhitelistFlags;
|
|
16
14
|
declare function isBotWhitelisted(botKey: string): boolean;
|
|
15
|
+
/**
|
|
16
|
+
* Whether an explicit whitelist entry exists for this key (distinguishes a
|
|
17
|
+
* stored all-off entry from an absent one, which getWhitelistFlags collapses
|
|
18
|
+
* to the same all-false shape).
|
|
19
|
+
* @param {string} botKey
|
|
20
|
+
* @returns {boolean}
|
|
21
|
+
*/
|
|
22
|
+
declare function hasWhitelistEntry(botKey: string): boolean;
|
|
17
23
|
declare function isBotDynamicWeightWhitelisted(botKey: string): boolean;
|
|
18
24
|
declare function isBotAsymmetricBoundsWhitelisted(botKey: string): boolean;
|
|
19
25
|
/**
|
|
@@ -48,5 +54,5 @@ declare function renameWhitelistEntry(oldKey: string, newKey: string): boolean;
|
|
|
48
54
|
* never existed); false when a malformed file blocked the write.
|
|
49
55
|
*/
|
|
50
56
|
declare function removeWhitelistEntry(botKey: string): boolean;
|
|
51
|
-
export { whitelistFile, resetMarketAdapterWhitelistCache, getWhitelistFlags, isBotWhitelisted, isBotDynamicWeightWhitelisted, isBotAsymmetricBoundsWhitelisted, setWhitelistFlags, renameWhitelistEntry, removeWhitelistEntry, DEFAULT_WHITELIST_FLAGS, AMA_ONLY_WHITELIST_FLAGS
|
|
57
|
+
export { whitelistFile, resetMarketAdapterWhitelistCache, getWhitelistFlags, hasWhitelistEntry, isBotWhitelisted, isBotDynamicWeightWhitelisted, isBotAsymmetricBoundsWhitelisted, setWhitelistFlags, renameWhitelistEntry, removeWhitelistEntry, DEFAULT_WHITELIST_FLAGS, AMA_ONLY_WHITELIST_FLAGS };
|
|
52
58
|
//# sourceMappingURL=market_adapter_whitelist.d.ts.map
|
|
@@ -47,9 +47,10 @@ function normalizeEntry(entry) {
|
|
|
47
47
|
if (!entry || typeof entry !== 'object') {
|
|
48
48
|
return { ...DEFAULT_WHITELIST_FLAGS };
|
|
49
49
|
}
|
|
50
|
+
const e = entry;
|
|
50
51
|
const flags = { ...DEFAULT_WHITELIST_FLAGS };
|
|
51
52
|
for (const key of Object.keys(DEFAULT_WHITELIST_FLAGS)) {
|
|
52
|
-
flags[key] =
|
|
53
|
+
flags[key] = e[key] === true;
|
|
53
54
|
}
|
|
54
55
|
return flags;
|
|
55
56
|
}
|
|
@@ -93,6 +94,17 @@ function getWhitelistFlags(botKey) {
|
|
|
93
94
|
function isBotWhitelisted(botKey) {
|
|
94
95
|
return getWhitelistFlags(botKey).ama === true;
|
|
95
96
|
}
|
|
97
|
+
/**
|
|
98
|
+
* Whether an explicit whitelist entry exists for this key (distinguishes a
|
|
99
|
+
* stored all-off entry from an absent one, which getWhitelistFlags collapses
|
|
100
|
+
* to the same all-false shape).
|
|
101
|
+
* @param {string} botKey
|
|
102
|
+
* @returns {boolean}
|
|
103
|
+
*/
|
|
104
|
+
function hasWhitelistEntry(botKey) {
|
|
105
|
+
const whitelist = loadMarketAdapterWhitelist();
|
|
106
|
+
return whitelist !== false && !!botKey && whitelist.has(String(botKey));
|
|
107
|
+
}
|
|
96
108
|
function isBotDynamicWeightWhitelisted(botKey) {
|
|
97
109
|
return getWhitelistFlags(botKey).dynamicWeight === true;
|
|
98
110
|
}
|
|
@@ -138,7 +150,7 @@ function readWhitelistDocument() {
|
|
|
138
150
|
/**
|
|
139
151
|
* Writes the whitelist document back (sorted keys, same shape the market
|
|
140
152
|
* adapter reads) and invalidates the in-process read cache.
|
|
141
|
-
* @param {
|
|
153
|
+
* @param {unknown} doc - Top-level document to preserve (extra keys survive).
|
|
142
154
|
* @param {Record<string, any>} entries - botKey-keyed whitelist entries.
|
|
143
155
|
*/
|
|
144
156
|
function writeWhitelistDocument(doc, entries) {
|
|
@@ -224,5 +236,5 @@ function removeWhitelistEntry(botKey) {
|
|
|
224
236
|
writeWhitelistDocument(loaded.doc, loaded.entries);
|
|
225
237
|
return true;
|
|
226
238
|
}
|
|
227
|
-
export { whitelistFile, resetMarketAdapterWhitelistCache, getWhitelistFlags, isBotWhitelisted, isBotDynamicWeightWhitelisted, isBotAsymmetricBoundsWhitelisted, setWhitelistFlags, renameWhitelistEntry, removeWhitelistEntry, DEFAULT_WHITELIST_FLAGS, AMA_ONLY_WHITELIST_FLAGS
|
|
239
|
+
export { whitelistFile, resetMarketAdapterWhitelistCache, getWhitelistFlags, hasWhitelistEntry, isBotWhitelisted, isBotDynamicWeightWhitelisted, isBotAsymmetricBoundsWhitelisted, setWhitelistFlags, renameWhitelistEntry, removeWhitelistEntry, DEFAULT_WHITELIST_FLAGS, AMA_ONLY_WHITELIST_FLAGS };
|
|
228
240
|
//# sourceMappingURL=market_adapter_whitelist.js.map
|
|
@@ -13,7 +13,7 @@
|
|
|
13
13
|
* unit-tested without constructing the whole native client or a live
|
|
14
14
|
* NodeManager. Callers own the side effects.
|
|
15
15
|
*/
|
|
16
|
-
|
|
16
|
+
interface ConnectedNodePolicyInput {
|
|
17
17
|
/** `nodeConfig.healthCheck.enabled !== false`. */
|
|
18
18
|
healthCheckEnabled: boolean;
|
|
19
19
|
/** A restart/failover is already in progress; do not start another. */
|
|
@@ -25,7 +25,7 @@ export interface ConnectedNodePolicyInput {
|
|
|
25
25
|
/** `nodeManager.getHealthyNodes`. */
|
|
26
26
|
getHealthyNodes: () => string[];
|
|
27
27
|
}
|
|
28
|
-
|
|
28
|
+
type ConnectedNodePolicyAction = {
|
|
29
29
|
action: 'switch';
|
|
30
30
|
nodes: string[];
|
|
31
31
|
reason: 'connected-on-blacklisted-node';
|
|
@@ -49,4 +49,5 @@ export type ConnectedNodePolicyAction = {
|
|
|
49
49
|
* @returns {ConnectedNodePolicyAction}
|
|
50
50
|
*/
|
|
51
51
|
export declare function resolveConnectedNodeAction(input: ConnectedNodePolicyInput): ConnectedNodePolicyAction;
|
|
52
|
+
export {};
|
|
52
53
|
//# sourceMappingURL=node_connect_policy.d.ts.map
|
|
@@ -21,12 +21,12 @@
|
|
|
21
21
|
* already-blacklisted node, and restarts counting from 0 when a previous
|
|
22
22
|
* blacklist's cooldown expired.
|
|
23
23
|
*/
|
|
24
|
-
|
|
24
|
+
interface FailureLedgerEntry {
|
|
25
25
|
failureCount: number;
|
|
26
26
|
blacklistedUntil: number;
|
|
27
27
|
lastReportedAt: number;
|
|
28
28
|
}
|
|
29
|
-
|
|
29
|
+
interface FailureLedgerOptions {
|
|
30
30
|
/** Failure count that triggers a blacklist. */
|
|
31
31
|
threshold: number;
|
|
32
32
|
/** Blacklist duration once the threshold is reached. */
|
|
@@ -40,14 +40,14 @@ export interface FailureLedgerOptions {
|
|
|
40
40
|
/** Skip counting while the node is currently blacklisted (daemon). */
|
|
41
41
|
skipWhileBlacklisted?: boolean;
|
|
42
42
|
}
|
|
43
|
-
|
|
44
|
-
|
|
43
|
+
type FailureRecordOutcome = 'counted' | 'blacklisted' | 'rate-limited' | 'skipped-blacklisted';
|
|
44
|
+
interface FailureRecordResult {
|
|
45
45
|
outcome: FailureRecordOutcome;
|
|
46
46
|
/** The count as recorded (or the existing count for skipped outcomes). */
|
|
47
47
|
failureCount: number;
|
|
48
48
|
threshold: number;
|
|
49
49
|
}
|
|
50
|
-
|
|
50
|
+
interface FailureLedger {
|
|
51
51
|
isBlacklisted(key: string): boolean;
|
|
52
52
|
recordFailure(key: string, now?: number): FailureRecordResult;
|
|
53
53
|
/** Clear a single entry (recovery: health-check success, resetNode). */
|
|
@@ -58,4 +58,5 @@ export interface FailureLedger {
|
|
|
58
58
|
clear(): void;
|
|
59
59
|
}
|
|
60
60
|
export declare function createFailureLedger(options: FailureLedgerOptions): FailureLedger;
|
|
61
|
+
export {};
|
|
61
62
|
//# sourceMappingURL=node_failure_ledger.d.ts.map
|
|
@@ -39,6 +39,8 @@
|
|
|
39
39
|
*
|
|
40
40
|
* ===============================================================================
|
|
41
41
|
*/
|
|
42
|
+
import Logger from './order/logger.js';
|
|
43
|
+
import { createFailureLedger } from './node_failure_ledger.js';
|
|
42
44
|
interface NodeManagerConfig {
|
|
43
45
|
list?: string[];
|
|
44
46
|
blacklistStateFile?: string;
|
|
@@ -56,7 +58,35 @@ interface NodeManagerConfig {
|
|
|
56
58
|
preferredNode?: string | null;
|
|
57
59
|
};
|
|
58
60
|
healthCacheFile?: string;
|
|
59
|
-
[key: string]:
|
|
61
|
+
[key: string]: unknown;
|
|
62
|
+
}
|
|
63
|
+
type WebSocketLike = WebSocket;
|
|
64
|
+
interface NodeStat {
|
|
65
|
+
url: string;
|
|
66
|
+
status: string;
|
|
67
|
+
latencyMs: number | null;
|
|
68
|
+
failureCount: number;
|
|
69
|
+
lastCheckTime: string | null;
|
|
70
|
+
lastErrorMessage: string | null;
|
|
71
|
+
chainId: string | null;
|
|
72
|
+
blacklistedAt: number | null;
|
|
73
|
+
healthCheckSuccessStreak: number;
|
|
74
|
+
lastFailureSource: string | null;
|
|
75
|
+
}
|
|
76
|
+
interface ResolvedNodeManagerConfig {
|
|
77
|
+
list: string[];
|
|
78
|
+
healthCheck: {
|
|
79
|
+
intervalMs: number;
|
|
80
|
+
timeoutMs: number;
|
|
81
|
+
maxPingMs: number;
|
|
82
|
+
blacklistThreshold: number;
|
|
83
|
+
liveFailureSuccessStreak: number;
|
|
84
|
+
enabled: boolean;
|
|
85
|
+
};
|
|
86
|
+
selection: {
|
|
87
|
+
strategy: string;
|
|
88
|
+
preferredNode: string | null;
|
|
89
|
+
};
|
|
60
90
|
}
|
|
61
91
|
/**
|
|
62
92
|
* NodeManager - Manages health checking and selection of BitShares nodes
|
|
@@ -74,19 +104,19 @@ interface NodeManagerConfig {
|
|
|
74
104
|
* @param {string} [config.selection.preferredNode] - Optional preferred node (if healthy)
|
|
75
105
|
*/
|
|
76
106
|
declare class NodeManager {
|
|
77
|
-
logger:
|
|
107
|
+
logger: Logger;
|
|
78
108
|
blacklistStateFile: string;
|
|
79
109
|
healthCacheFile: string;
|
|
80
|
-
config:
|
|
81
|
-
nodeStats: Map<
|
|
82
|
-
_lastBlacklistWarnMs: Map<
|
|
110
|
+
config: ResolvedNodeManagerConfig;
|
|
111
|
+
nodeStats: Map<string, NodeStat>;
|
|
112
|
+
_lastBlacklistWarnMs: Map<string, number>;
|
|
83
113
|
monitoringActive: boolean;
|
|
84
|
-
checkIntervalId:
|
|
85
|
-
checkAllNodesPromise:
|
|
114
|
+
checkIntervalId: ReturnType<typeof setInterval> | null;
|
|
115
|
+
checkAllNodesPromise: Promise<void> | null;
|
|
86
116
|
expectedChainId: string;
|
|
87
117
|
BLACKLIST_COOLDOWN_MS: number;
|
|
88
118
|
FAILURE_REPORT_COOLDOWN_MS: number;
|
|
89
|
-
failureLedger:
|
|
119
|
+
failureLedger: ReturnType<typeof createFailureLedger>;
|
|
90
120
|
constructor(config?: NodeManagerConfig);
|
|
91
121
|
/**
|
|
92
122
|
* Initialize tracking for all configured nodes
|
|
@@ -165,7 +195,7 @@ declare class NodeManager {
|
|
|
165
195
|
* @param {number} timeoutMs - Connection timeout
|
|
166
196
|
* @returns {Promise<WebSocket>} Connected WebSocket instance
|
|
167
197
|
*/
|
|
168
|
-
connectWithTimeout(nodeUrl: string, timeoutMs: number): Promise<
|
|
198
|
+
connectWithTimeout(nodeUrl: string, timeoutMs: number): Promise<WebSocketLike>;
|
|
169
199
|
/**
|
|
170
200
|
* Query the BitShares chain ID using the Graphene WebSocket RPC protocol.
|
|
171
201
|
* @private
|
|
@@ -173,7 +203,7 @@ declare class NodeManager {
|
|
|
173
203
|
* @param {number} timeoutMs - RPC timeout
|
|
174
204
|
* @returns {Promise<string>} Chain ID
|
|
175
205
|
*/
|
|
176
|
-
getChainId(ws:
|
|
206
|
+
getChainId(ws: WebSocketLike, timeoutMs: number): Promise<string>;
|
|
177
207
|
/**
|
|
178
208
|
* Make a JSON-RPC call to a WebSocket
|
|
179
209
|
* @private
|
|
@@ -183,7 +213,7 @@ declare class NodeManager {
|
|
|
183
213
|
* @param {number} timeoutMs - RPC timeout
|
|
184
214
|
* @returns {Promise<any>} RPC result
|
|
185
215
|
*/
|
|
186
|
-
rpcCall(ws:
|
|
216
|
+
rpcCall(ws: WebSocketLike, method: string, params: unknown[], timeoutMs: number): Promise<unknown>;
|
|
187
217
|
/**
|
|
188
218
|
* Get list of healthy nodes sorted by latency (best first)
|
|
189
219
|
* @returns {string[]} Array of node URLs
|
|
@@ -52,7 +52,7 @@ const { readJSON } = storage;
|
|
|
52
52
|
import { createFailureLedger } from './node_failure_ledger.js';
|
|
53
53
|
const _WebSocket = globalThis.WebSocket;
|
|
54
54
|
import { resolveHealthCacheFile, writeHealthCache, } from './node_health_cache.js';
|
|
55
|
-
import { getErrorMessage } from './utils/errors.js';
|
|
55
|
+
import { getErrorMessage, getErrorCode } from './utils/errors.js';
|
|
56
56
|
import { nowIso } from './order/utils/system.js';
|
|
57
57
|
/**
|
|
58
58
|
* NodeManager - Manages health checking and selection of BitShares nodes
|
|
@@ -195,7 +195,7 @@ class NodeManager {
|
|
|
195
195
|
}
|
|
196
196
|
catch (err) {
|
|
197
197
|
// A never-created blacklist file (normal first run) is not an error.
|
|
198
|
-
if (err
|
|
198
|
+
if (getErrorCode(err) !== 'ENOENT') {
|
|
199
199
|
this.logger.warn(`Failed to load blacklist state: ${getErrorMessage(err)}`);
|
|
200
200
|
}
|
|
201
201
|
}
|
|
@@ -463,8 +463,9 @@ class NodeManager {
|
|
|
463
463
|
const timeout = setTimeout(() => {
|
|
464
464
|
if (ws) {
|
|
465
465
|
try {
|
|
466
|
-
|
|
467
|
-
|
|
466
|
+
const closable = ws;
|
|
467
|
+
if (typeof closable.terminate === 'function') {
|
|
468
|
+
closable.terminate();
|
|
468
469
|
}
|
|
469
470
|
else {
|
|
470
471
|
ws.close();
|