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
|
@@ -63,85 +63,138 @@
|
|
|
63
63
|
*
|
|
64
64
|
* ===============================================================================
|
|
65
65
|
*/
|
|
66
|
-
|
|
67
|
-
|
|
66
|
+
import * as DexbotStartupRuntime from './dexbot_startup_runtime.js';
|
|
67
|
+
import cowRuntime from './dexbot_cow_runtime.js';
|
|
68
|
+
import type { ChainOrderLike, CowResult, OpPhase } from './dexbot_cow_runtime.js';
|
|
69
|
+
import { normalizeBotEntry } from './bot_settings.js';
|
|
70
|
+
import type { FillOpLike, FillLike, ReplaySafeFillAccountingOptions } from './dexbot_fill_runtime.js';
|
|
71
|
+
import type { BotLike, AssetPair, IncomingFill, UnknownRecord, GridConfig, OrderManagerLike, AccountOrdersLike, BotMetrics, ProcessedFillStoreLike, CreditRuntimeLike, FillBatchResult, SigningToken, SpreadCorrectionStall } from './types.js';
|
|
72
|
+
declare class DEXBot implements BotLike {
|
|
73
|
+
static normalizeBotEntry: typeof normalizeBotEntry;
|
|
74
|
+
config: GridConfig;
|
|
68
75
|
_baseWeightDistribution: {
|
|
69
76
|
sell: number;
|
|
70
77
|
buy: number;
|
|
71
78
|
};
|
|
72
|
-
account:
|
|
79
|
+
account: string | null;
|
|
73
80
|
accountId: string | null;
|
|
74
|
-
privateKey:
|
|
75
|
-
manager:
|
|
76
|
-
accountOrders:
|
|
81
|
+
privateKey: string | SigningToken | null;
|
|
82
|
+
manager: OrderManagerLike;
|
|
83
|
+
accountOrders: AccountOrdersLike;
|
|
77
84
|
triggerFile: string;
|
|
78
|
-
_recentlyQueuedFills: Map<
|
|
85
|
+
_recentlyQueuedFills: Map<string, number>;
|
|
79
86
|
_fillCleanupCounter: number;
|
|
80
87
|
_fillDedupeWindowMs: number;
|
|
81
88
|
_fillRecordRetentionMs: number;
|
|
82
89
|
_processedFillPersistBatchMs: number;
|
|
83
90
|
_processedFillPersistBatchSize: number;
|
|
84
|
-
_processedFillStore:
|
|
85
|
-
_recentlyProcessedFills:
|
|
86
|
-
_pendingProcessedFillWrites:
|
|
87
|
-
_incomingFillQueue:
|
|
91
|
+
_processedFillStore: ProcessedFillStoreLike;
|
|
92
|
+
_recentlyProcessedFills: Map<string, number>;
|
|
93
|
+
_pendingProcessedFillWrites: unknown;
|
|
94
|
+
_incomingFillQueue: IncomingFill[];
|
|
88
95
|
logPrefix: string;
|
|
89
|
-
_credentialDaemonWatchdogInterval:
|
|
96
|
+
_credentialDaemonWatchdogInterval: ReturnType<typeof setInterval> | null;
|
|
90
97
|
_credentialDaemonDown: boolean;
|
|
91
98
|
_credentialRecoveryNeeded: boolean;
|
|
92
99
|
_credentialRecoveryInFlight: boolean;
|
|
93
100
|
_credentialDaemonWatchdogInFlight: boolean;
|
|
101
|
+
_credentialDaemonConsecutiveFailures: number;
|
|
94
102
|
_staleCleanedOrderIds: Map<string, number>;
|
|
95
103
|
_staleCleanupRetentionMs: number;
|
|
96
|
-
_metrics:
|
|
104
|
+
_metrics: BotMetrics;
|
|
97
105
|
_shuttingDown: boolean;
|
|
98
106
|
_shutdownPromise: Promise<void> | null;
|
|
99
|
-
_blockchainFetchInterval:
|
|
107
|
+
_blockchainFetchInterval: ReturnType<typeof setInterval> | null;
|
|
100
108
|
_blockchainFetchInFlight: number;
|
|
101
|
-
_botsConfigPollInterval:
|
|
109
|
+
_botsConfigPollInterval: ReturnType<typeof setInterval> | null;
|
|
102
110
|
_botsConfigPollInFlight: boolean;
|
|
103
111
|
_marketAdapterWatchdogFingerprint: string | null;
|
|
104
112
|
_appliedBotConfigFingerprint: string | null;
|
|
105
|
-
_appliedBotConfigEntry:
|
|
113
|
+
_appliedBotConfigEntry: unknown;
|
|
106
114
|
_lastBotConfigHintFingerprint: string | null;
|
|
107
|
-
_fillsUnsubscribe:
|
|
108
|
-
_triggerWatcher:
|
|
109
|
-
|
|
110
|
-
|
|
111
|
-
|
|
115
|
+
_fillsUnsubscribe: (() => Promise<unknown>) | null;
|
|
116
|
+
_triggerWatcher: {
|
|
117
|
+
close?: () => void;
|
|
118
|
+
} | null;
|
|
119
|
+
_triggerDebounceTimer: ReturnType<typeof setTimeout> | null;
|
|
120
|
+
_deferredGridResyncTimer: ReturnType<typeof setTimeout> | null;
|
|
121
|
+
_maintenanceIdleTimer: ReturnType<typeof setTimeout> | null;
|
|
112
122
|
_mainLoopActive: boolean;
|
|
113
|
-
_mainLoopPromise:
|
|
114
|
-
_creditRuntime:
|
|
115
|
-
_creditWatchdogInterval:
|
|
123
|
+
_mainLoopPromise: Promise<unknown> | null;
|
|
124
|
+
_creditRuntime: CreditRuntimeLike | null;
|
|
125
|
+
_creditWatchdogInterval: ReturnType<typeof setInterval> | null;
|
|
116
126
|
_batchInFlight: number;
|
|
117
127
|
_cowBroadcastInFlight: boolean;
|
|
118
128
|
_recoverySyncInFlight: number;
|
|
119
129
|
_deferredFillsPending: boolean;
|
|
120
|
-
_postRecoveryRebalanceTimer:
|
|
121
|
-
_deferredFillRetryTimer:
|
|
130
|
+
_postRecoveryRebalanceTimer: ReturnType<typeof setTimeout> | null;
|
|
131
|
+
_deferredFillRetryTimer: ReturnType<typeof setTimeout> | null;
|
|
122
132
|
_lastTargetedDriftSyncAt: number;
|
|
123
133
|
_lightweightSyncCheckAt: number;
|
|
134
|
+
_lastUncertainResyncAt: number;
|
|
135
|
+
_lastResolvedPollIntervalMs: number;
|
|
136
|
+
_fillBroadcastDeferSince: number;
|
|
137
|
+
_fillBroadcastDeferRegionAt: number;
|
|
138
|
+
_fillTotalsParkedFills: IncomingFill[];
|
|
139
|
+
_fillTotalsRetryTimer: ReturnType<typeof setTimeout> | null;
|
|
140
|
+
_fillTotalsRetryDelayMs: number;
|
|
124
141
|
_targetedDriftSyncCooldownMs: number;
|
|
125
142
|
_maintenanceCooldownCycles: number;
|
|
126
143
|
_lastGridActivityAt: number;
|
|
127
144
|
_currentCycleId: number;
|
|
128
145
|
_consecutiveConsumeFailures: number;
|
|
129
146
|
_consumeFailureFirstAt: number;
|
|
130
|
-
_reconnectUnregister:
|
|
131
|
-
_credentialRecoveryDeferredTimer:
|
|
132
|
-
_structuralGridResyncTimer:
|
|
147
|
+
_reconnectUnregister: (() => void) | null;
|
|
148
|
+
_credentialRecoveryDeferredTimer: ReturnType<typeof setTimeout> | null;
|
|
149
|
+
_structuralGridResyncTimer: ReturnType<typeof setTimeout> | null;
|
|
133
150
|
_structuralGridResyncRunning: number;
|
|
134
|
-
_dustHealthCheckTimer:
|
|
151
|
+
_dustHealthCheckTimer: ReturnType<typeof setInterval> | null;
|
|
135
152
|
_lastBroadcastHeartbeatAt: number | undefined;
|
|
136
153
|
_lastDeferredDustCount: number;
|
|
137
154
|
_currentBatchId: string | number | null | undefined;
|
|
155
|
+
assets: AssetPair | null;
|
|
156
|
+
botKey: string;
|
|
157
|
+
name: string;
|
|
158
|
+
_blockchainFetchIntervalMin: number;
|
|
159
|
+
_deferredFillRetryDelayMs: number;
|
|
160
|
+
_deferredFillRetryWaits: number;
|
|
161
|
+
_fillTotalsRetryAttempt: number;
|
|
162
|
+
_gridLockHoldWarnAt: number;
|
|
163
|
+
_gridModule: unknown;
|
|
164
|
+
_gridPriceInvariantRejectStreak: Map<string, number>;
|
|
165
|
+
_gridReconcileModule: unknown;
|
|
166
|
+
_lastDeferredHoldResyncAt: number;
|
|
167
|
+
_lastGridPriceInvariantResyncAt: number;
|
|
168
|
+
_lastHeldChainOrderSignature: string | null;
|
|
169
|
+
_lastHeldChainOrderSignatureSince: number;
|
|
170
|
+
_lastHeldChainOrderWarnAt: number;
|
|
171
|
+
_lastSpreadStaleResyncAt: number;
|
|
172
|
+
_marketAdapterWatchdogInFlight: boolean;
|
|
173
|
+
_outOfSpreadSince: number;
|
|
174
|
+
_outOfSpreadStaleWarned: boolean;
|
|
175
|
+
_postRecoveryRebalanceDefers: number;
|
|
176
|
+
_skipEmptyReadConfirmDelay: boolean;
|
|
177
|
+
_spreadFundsExhausted: boolean;
|
|
178
|
+
_spreadCorrectionStall: SpreadCorrectionStall | null;
|
|
179
|
+
_strandedHoldSince: Map<string, number>;
|
|
180
|
+
_structuralGridResyncDeferCount: number;
|
|
181
|
+
_structuralGridResyncDeferStartedAt: number;
|
|
182
|
+
_testPollIntervalMs: number;
|
|
183
|
+
_getPm2ProcessNames: (...args: unknown[]) => Promise<string[]>;
|
|
184
|
+
_listenForFillsHook: (...args: unknown[]) => unknown;
|
|
185
|
+
_loadBotsConfigSnapshot: (...args: unknown[]) => unknown;
|
|
186
|
+
_readOpenOrdersHook: (...args: unknown[]) => unknown;
|
|
187
|
+
_startMarketAdapterPm2: (...args: unknown[]) => unknown;
|
|
188
|
+
_stopMarketAdapterPm2: (...args: unknown[]) => unknown;
|
|
189
|
+
_submitCancelOrder: (...args: unknown[]) => unknown;
|
|
190
|
+
_syncMarketAdapterHook: (...args: unknown[]) => unknown;
|
|
138
191
|
/**
|
|
139
192
|
* Create a new DEXBot instance
|
|
140
193
|
* @param {Object} config - Bot configuration from profiles/bots.json
|
|
141
194
|
* @param {Object} options - Optional settings
|
|
142
195
|
* @param {string} options.logPrefix - Prefix for console logs (e.g., "[bot.js]")
|
|
143
196
|
*/
|
|
144
|
-
constructor(config:
|
|
197
|
+
constructor(config: GridConfig, options?: {
|
|
145
198
|
logPrefix?: string;
|
|
146
199
|
});
|
|
147
200
|
/**
|
|
@@ -151,20 +204,20 @@ declare class DEXBot {
|
|
|
151
204
|
* @throws {Error} If critical validation fails
|
|
152
205
|
* @private
|
|
153
206
|
*/
|
|
154
|
-
_validateStartupConfig(config:
|
|
207
|
+
_validateStartupConfig(config: Record<string, unknown>): void;
|
|
155
208
|
/**
|
|
156
209
|
* Log a message to the console with the bot's prefix.
|
|
157
210
|
* @param {string} msg - The message to log.
|
|
158
211
|
* @param {string} [level='info'] - The log level ('debug', 'info', 'warn', 'error').
|
|
159
212
|
* @private
|
|
160
213
|
*/
|
|
161
|
-
_log(msg:
|
|
214
|
+
_log(msg: unknown, level?: string): void;
|
|
162
215
|
/**
|
|
163
216
|
* Log a warning message to the console with the bot's prefix.
|
|
164
217
|
* @param {string} msg - The message to log.
|
|
165
218
|
* @private
|
|
166
219
|
*/
|
|
167
|
-
_warn(msg:
|
|
220
|
+
_warn(msg: unknown): void;
|
|
168
221
|
/**
|
|
169
222
|
* Persist the grid and trigger immediate recovery if validation fails.
|
|
170
223
|
* Used during startup to ensure bot begins in a stable state.
|
|
@@ -184,30 +237,30 @@ declare class DEXBot {
|
|
|
184
237
|
* @returns {{incomingFillQueueLength: number, shadowLocks: number, batchInFlight: boolean, recoveryInFlight: boolean, broadcasting: boolean}}
|
|
185
238
|
*/
|
|
186
239
|
_getPipelineSignals(): {
|
|
187
|
-
incomingFillQueueLength:
|
|
188
|
-
shadowLocks:
|
|
240
|
+
incomingFillQueueLength: number;
|
|
241
|
+
shadowLocks: number;
|
|
189
242
|
batchInFlight: boolean;
|
|
190
243
|
recoveryInFlight: boolean;
|
|
191
|
-
broadcasting:
|
|
244
|
+
broadcasting: boolean;
|
|
192
245
|
};
|
|
193
246
|
/**
|
|
194
247
|
* Mark that grid activity occurred (updates idle timer).
|
|
195
248
|
* @param {string} [reason='activity'] - Reason for activity
|
|
196
249
|
* @returns {void}
|
|
197
250
|
*/
|
|
198
|
-
_markGridActivity(reason?:
|
|
251
|
+
_markGridActivity(reason?: string): void;
|
|
199
252
|
/**
|
|
200
253
|
* Trigger a full state recovery sync (fetch chain + sync from open orders + persist).
|
|
201
254
|
* @param {string} [reason='state recovery sync'] - Reason for recovery
|
|
202
255
|
* @returns {Promise<void>}
|
|
203
256
|
*/
|
|
204
|
-
_triggerStateRecoverySync(reason?:
|
|
257
|
+
_triggerStateRecoverySync(reason?: string): Promise<void>;
|
|
205
258
|
/**
|
|
206
259
|
* Abort the current flow if an illegal state signal was raised.
|
|
207
260
|
* @param {string} flowContext - Description of the flow being aborted
|
|
208
261
|
* @returns {Promise<boolean>} True if flow was aborted
|
|
209
262
|
*/
|
|
210
|
-
_abortFlowIfIllegalState(flowContext:
|
|
263
|
+
_abortFlowIfIllegalState(flowContext: string): Promise<boolean>;
|
|
211
264
|
/**
|
|
212
265
|
* Handle a hard abort from batch processing due to illegal state or accounting failure.
|
|
213
266
|
* @param {Error} err - The error that triggered the abort
|
|
@@ -215,7 +268,7 @@ declare class DEXBot {
|
|
|
215
268
|
* @param {number} [opsCount=0] - Number of operations in the batch
|
|
216
269
|
* @returns {Promise<Object>} Abort result object
|
|
217
270
|
*/
|
|
218
|
-
_handleBatchHardAbort(err:
|
|
271
|
+
_handleBatchHardAbort(err: unknown, phase?: string, opsCount?: number): Promise<{
|
|
219
272
|
abortedForAccountingFailure: boolean;
|
|
220
273
|
executed: boolean;
|
|
221
274
|
hadRotation: boolean;
|
|
@@ -230,14 +283,14 @@ declare class DEXBot {
|
|
|
230
283
|
* @param {string} [context='recoverable-grid-update'] - Context label for logging
|
|
231
284
|
* @returns {Promise<number>} Number of updates applied
|
|
232
285
|
*/
|
|
233
|
-
_applyRecoverableGridUpdates(updates:
|
|
286
|
+
_applyRecoverableGridUpdates(updates: unknown[], context?: string): Promise<number>;
|
|
234
287
|
/**
|
|
235
288
|
* Recover from explicit stale order errors by virtualizing affected grid slots.
|
|
236
289
|
* @param {Set<string>|string[]} staleOrderIds - Set or array of stale chain order IDs
|
|
237
290
|
* @param {string} [reason='stale order cleanup'] - Reason for cleanup
|
|
238
291
|
* @returns {Promise<{executed: boolean, hadRotation: boolean, stale: boolean, recoveredByVirtualization?: boolean}>}
|
|
239
292
|
*/
|
|
240
|
-
_recoverExplicitStaleOrders(staleOrderIds:
|
|
293
|
+
_recoverExplicitStaleOrders(staleOrderIds: unknown, reason?: string): Promise<{
|
|
241
294
|
executed: boolean;
|
|
242
295
|
hadRotation: boolean;
|
|
243
296
|
stale: boolean;
|
|
@@ -253,7 +306,7 @@ declare class DEXBot {
|
|
|
253
306
|
* @param {Error} err - The size drift error
|
|
254
307
|
* @returns {Promise<{executed: boolean, hadRotation: boolean, recoveredBySync: boolean, reason: string}>}
|
|
255
308
|
*/
|
|
256
|
-
_recoverBatchSizeDrift(err:
|
|
309
|
+
_recoverBatchSizeDrift(err: unknown, opContexts?: unknown[]): Promise<{
|
|
257
310
|
executed: boolean;
|
|
258
311
|
hadRotation: boolean;
|
|
259
312
|
recoveredBySync: boolean;
|
|
@@ -291,7 +344,7 @@ declare class DEXBot {
|
|
|
291
344
|
* @param {'startup'|'recovery'} context - Controls log prefix.
|
|
292
345
|
* @returns {Promise<boolean>} True if the snapshot was rejected (cleared).
|
|
293
346
|
*/
|
|
294
|
-
_rejectCorruptedGridSnapshot(context:
|
|
347
|
+
_rejectCorruptedGridSnapshot(context: string): Promise<boolean>;
|
|
295
348
|
/**
|
|
296
349
|
* Attempt to repair size-drift for specific order IDs by reading their
|
|
297
350
|
* current on-chain state and correcting the local grid directly.
|
|
@@ -299,7 +352,7 @@ declare class DEXBot {
|
|
|
299
352
|
* @param {string[]} orderIds
|
|
300
353
|
* @returns {Promise<boolean>} True if all affected orders were repaired
|
|
301
354
|
*/
|
|
302
|
-
_targetedOrderRepair(orderIds:
|
|
355
|
+
_targetedOrderRepair(orderIds: string[]): Promise<boolean>;
|
|
303
356
|
/**
|
|
304
357
|
* Initialize bot state from storage and blockchain.
|
|
305
358
|
* Consolidates common initialization logic for start() and startWithPrivateKey().
|
|
@@ -307,13 +360,13 @@ declare class DEXBot {
|
|
|
307
360
|
* @private
|
|
308
361
|
*/
|
|
309
362
|
_initializeStartupState(): Promise<{
|
|
310
|
-
persistedGrid:
|
|
311
|
-
persistedBtsFeesOwed:
|
|
312
|
-
persistedBoundaryIdx:
|
|
313
|
-
persistedBtsBalance:
|
|
314
|
-
persistedRecentFillKeys:
|
|
315
|
-
persistedGenesis:
|
|
316
|
-
persistedGapEvacStreaks:
|
|
363
|
+
persistedGrid: unknown[] | null;
|
|
364
|
+
persistedBtsFeesOwed: unknown;
|
|
365
|
+
persistedBoundaryIdx: number | null;
|
|
366
|
+
persistedBtsBalance: unknown;
|
|
367
|
+
persistedRecentFillKeys: unknown;
|
|
368
|
+
persistedGenesis: {} | null;
|
|
369
|
+
persistedGapEvacStreaks: {} | null;
|
|
317
370
|
}>;
|
|
318
371
|
/**
|
|
319
372
|
* Wire processed fill tracking into the manager.
|
|
@@ -326,7 +379,7 @@ declare class DEXBot {
|
|
|
326
379
|
* @param {Object} [options={}] - Flush options
|
|
327
380
|
* @returns {Promise<void>}
|
|
328
381
|
*/
|
|
329
|
-
_flushProcessedFillPersistence(reason?:
|
|
382
|
+
_flushProcessedFillPersistence(reason?: string, options?: Record<string, unknown>): Promise<void>;
|
|
330
383
|
/**
|
|
331
384
|
* Flush persistence for specific fill keys.
|
|
332
385
|
* @param {Set<string>|string[]} fillKeys - Fill keys to persist
|
|
@@ -334,18 +387,18 @@ declare class DEXBot {
|
|
|
334
387
|
* @param {Object} [options={}] - Flush options
|
|
335
388
|
* @returns {Promise<void>}
|
|
336
389
|
*/
|
|
337
|
-
_flushProcessedFillPersistenceForKeys(fillKeys:
|
|
390
|
+
_flushProcessedFillPersistenceForKeys(fillKeys: string[] | Set<string>, reason?: string, options?: Record<string, unknown>): Promise<void>;
|
|
338
391
|
/**
|
|
339
392
|
* Build a fallback deduplication key for an orphan fill (when standard keys are unavailable).
|
|
340
393
|
* @param {Object} fill - Fill event object
|
|
341
394
|
* @returns {string|null} Fallback key or null
|
|
342
395
|
*/
|
|
343
|
-
_buildOrphanFillFallbackKey(fill:
|
|
344
|
-
_isNewFillKey(fillKey:
|
|
396
|
+
_buildOrphanFillFallbackKey(fill: FillLike): string | null;
|
|
397
|
+
_isNewFillKey(fillKey: string, processedFillKeys: Set<string>, label?: string, orderId?: string): boolean;
|
|
345
398
|
/**
|
|
346
399
|
* Apply replay-safe fill accounting for tracked fills (those with a valid grid order).
|
|
347
400
|
* @param {Object} fill - Fill event object
|
|
348
|
-
* @param {
|
|
401
|
+
* @param {unknown} fillOp - Fill operation data
|
|
349
402
|
* @param {Object} [options={}]
|
|
350
403
|
* @param {string} [options.context]
|
|
351
404
|
* @param {Object} [options.logger]
|
|
@@ -353,12 +406,7 @@ declare class DEXBot {
|
|
|
353
406
|
* @param {string} [options.persistenceMode='batched']
|
|
354
407
|
* @returns {Promise<any>}
|
|
355
408
|
*/
|
|
356
|
-
_applyReplaySafeTrackedFillAccounting(fill:
|
|
357
|
-
context?: string;
|
|
358
|
-
logger?: any;
|
|
359
|
-
replayMessage?: any;
|
|
360
|
-
persistenceMode?: any;
|
|
361
|
-
}): Promise<{
|
|
409
|
+
_applyReplaySafeTrackedFillAccounting(fill: unknown, fillOp: FillOpLike, options?: ReplaySafeFillAccountingOptions): Promise<{
|
|
362
410
|
status: string;
|
|
363
411
|
fillKey: any;
|
|
364
412
|
usedFallbackKey?: undefined;
|
|
@@ -371,13 +419,13 @@ declare class DEXBot {
|
|
|
371
419
|
} | {
|
|
372
420
|
status: string;
|
|
373
421
|
fillKey: any;
|
|
374
|
-
error:
|
|
422
|
+
error: unknown;
|
|
375
423
|
usedFallbackKey?: undefined;
|
|
376
424
|
}>;
|
|
377
425
|
/**
|
|
378
426
|
* Apply replay-safe fill accounting for orphan fills (grid order not found).
|
|
379
427
|
* @param {Object} fill - Fill event object
|
|
380
|
-
* @param {
|
|
428
|
+
* @param {unknown} fillOp - Fill operation data
|
|
381
429
|
* @param {Object} [options={}]
|
|
382
430
|
* @param {string} [options.context]
|
|
383
431
|
* @param {Object} [options.logger]
|
|
@@ -385,12 +433,7 @@ declare class DEXBot {
|
|
|
385
433
|
* @param {string} [options.persistenceMode='batched']
|
|
386
434
|
* @returns {Promise<any>}
|
|
387
435
|
*/
|
|
388
|
-
_applyReplaySafeOrphanFillAccounting(fill:
|
|
389
|
-
context?: string;
|
|
390
|
-
logger?: any;
|
|
391
|
-
replayMessage?: any;
|
|
392
|
-
persistenceMode?: any;
|
|
393
|
-
}): Promise<{
|
|
436
|
+
_applyReplaySafeOrphanFillAccounting(fill: unknown, fillOp: FillOpLike, options?: ReplaySafeFillAccountingOptions): Promise<{
|
|
394
437
|
status: string;
|
|
395
438
|
fillKey: any;
|
|
396
439
|
usedFallbackKey?: undefined;
|
|
@@ -403,7 +446,7 @@ declare class DEXBot {
|
|
|
403
446
|
} | {
|
|
404
447
|
status: string;
|
|
405
448
|
fillKey: any;
|
|
406
|
-
error:
|
|
449
|
+
error: unknown;
|
|
407
450
|
usedFallbackKey?: undefined;
|
|
408
451
|
}>;
|
|
409
452
|
/**
|
|
@@ -411,7 +454,7 @@ declare class DEXBot {
|
|
|
411
454
|
* @param {string} [context='runtime'] - Context label for logging
|
|
412
455
|
* @returns {any|null}
|
|
413
456
|
*/
|
|
414
|
-
_refreshDynamicWeightDistribution(context?:
|
|
457
|
+
_refreshDynamicWeightDistribution(context?: string): {
|
|
415
458
|
applied: boolean;
|
|
416
459
|
source: string;
|
|
417
460
|
weightDistribution: any;
|
|
@@ -420,7 +463,7 @@ declare class DEXBot {
|
|
|
420
463
|
applied: boolean;
|
|
421
464
|
source: string;
|
|
422
465
|
weightDistribution: any;
|
|
423
|
-
snapshotUpdatedAt:
|
|
466
|
+
snapshotUpdatedAt: {} | null;
|
|
424
467
|
};
|
|
425
468
|
/**
|
|
426
469
|
* Finalize the bot startup after account and initial grid sync are complete.
|
|
@@ -428,7 +471,7 @@ declare class DEXBot {
|
|
|
428
471
|
* @param {Object} startupState - The startup state from _initializeStartupState.
|
|
429
472
|
* @private
|
|
430
473
|
*/
|
|
431
|
-
_finishStartupSequence(startupState:
|
|
474
|
+
_finishStartupSequence(startupState: Parameters<typeof DexbotStartupRuntime.finishStartupSequence>[1]): Promise<void>;
|
|
432
475
|
/**
|
|
433
476
|
* Create the fill callback for listenForFills.
|
|
434
477
|
* Separated from start() to allow deferred activation after startup completes.
|
|
@@ -436,23 +479,23 @@ declare class DEXBot {
|
|
|
436
479
|
* @returns {Function} Async callback for processing fills
|
|
437
480
|
* @private
|
|
438
481
|
*/
|
|
439
|
-
_createFillCallback(chainOrders:
|
|
482
|
+
_createFillCallback(chainOrders: typeof import('./chain_orders.js')): (fills: IncomingFill[]) => Promise<void>;
|
|
440
483
|
/**
|
|
441
484
|
* Read open orders from chain, sync with local state, and process any fills found.
|
|
442
485
|
* Shared helper used by post-reset spread check and targeted drift reconciliation.
|
|
443
486
|
* @param {string} tag - Context label for logging
|
|
444
487
|
* @returns {Promise<{syncResult: Object|null, aborted: boolean, hasUnmatched: number, openOrders: Array|null}>}
|
|
445
488
|
*/
|
|
446
|
-
_syncOpenOrdersAndProcessFills(tag:
|
|
489
|
+
_syncOpenOrdersAndProcessFills(tag: string): Promise<{
|
|
447
490
|
syncResult: null;
|
|
448
491
|
aborted: boolean;
|
|
449
492
|
hasUnmatched: number;
|
|
450
493
|
openOrders: null;
|
|
451
494
|
} | {
|
|
452
|
-
syncResult:
|
|
495
|
+
syncResult: import("./types.js").SyncResult;
|
|
453
496
|
aborted: boolean;
|
|
454
|
-
hasUnmatched:
|
|
455
|
-
openOrders:
|
|
497
|
+
hasUnmatched: number;
|
|
498
|
+
openOrders: import("./types.js").ChainOrder[];
|
|
456
499
|
}>;
|
|
457
500
|
/**
|
|
458
501
|
* Schedule the fill-consumer restart after the failure budget
|
|
@@ -462,7 +505,7 @@ declare class DEXBot {
|
|
|
462
505
|
* @param {Object} chainOrders - Chain orders module for blockchain operations
|
|
463
506
|
* @private
|
|
464
507
|
*/
|
|
465
|
-
_scheduleFillConsumerRestart(chainOrders:
|
|
508
|
+
_scheduleFillConsumerRestart(chainOrders: typeof import('./chain_orders.js')): void;
|
|
466
509
|
/**
|
|
467
510
|
* Consume queued fills from incomingFillQueue and rebalance.
|
|
468
511
|
*
|
|
@@ -476,7 +519,7 @@ declare class DEXBot {
|
|
|
476
519
|
* @param {Object} chainOrders - Chain orders module for blockchain operations
|
|
477
520
|
* @private
|
|
478
521
|
*/
|
|
479
|
-
_consumeFillQueue(chainOrders:
|
|
522
|
+
_consumeFillQueue(chainOrders: typeof import('./chain_orders.js')): Promise<void>;
|
|
480
523
|
/**
|
|
481
524
|
* Process fills during bootstrap phase using the standard fill pipeline.
|
|
482
525
|
*
|
|
@@ -497,20 +540,20 @@ declare class DEXBot {
|
|
|
497
540
|
* @param {Object} chainOrders - Chain orders instance for broadcasting
|
|
498
541
|
* @returns {Promise<void>}
|
|
499
542
|
*/
|
|
500
|
-
_processFillsWithBootstrapMode(chainOrders:
|
|
543
|
+
_processFillsWithBootstrapMode(chainOrders: typeof import('./chain_orders.js')): Promise<void>;
|
|
501
544
|
/**
|
|
502
545
|
* Set up account identifier and configure global context.
|
|
503
546
|
* @param {string} accountName - The name of the account to set up
|
|
504
547
|
* @private
|
|
505
548
|
*/
|
|
506
|
-
_setupAccountContext(accountName:
|
|
549
|
+
_setupAccountContext(accountName: string): Promise<void>;
|
|
507
550
|
/**
|
|
508
551
|
* Initialize the bot by connecting to BitShares and setting up the account.
|
|
509
552
|
* @param {string|Object|Buffer} [vaultSecret=null] - The unlock secret for authentication.
|
|
510
553
|
* @returns {Promise<void>}
|
|
511
554
|
* @throws {Error} If initialization fails or preferredAccount is missing.
|
|
512
555
|
*/
|
|
513
|
-
initialize(vaultSecret?:
|
|
556
|
+
initialize(vaultSecret?: string | null): Promise<void>;
|
|
514
557
|
/**
|
|
515
558
|
* Places initial orders on the blockchain.
|
|
516
559
|
* @returns {Promise<void>}
|
|
@@ -521,13 +564,13 @@ declare class DEXBot {
|
|
|
521
564
|
* @param {Array<Object>} orders - Array of order objects
|
|
522
565
|
* @returns {Array<Array<Object>>} Grouped order arrays
|
|
523
566
|
*/
|
|
524
|
-
_buildOutsideInPairGroupsForOrders(orders:
|
|
567
|
+
_buildOutsideInPairGroupsForOrders(orders: unknown[]): unknown[][];
|
|
525
568
|
/**
|
|
526
569
|
* Build outside-in pair groups for create entry contexts.
|
|
527
570
|
* @param {Array<Object>} createEntries - Array of create entry objects with context.order
|
|
528
571
|
* @returns {Array<Array<Object>>} Grouped entry arrays
|
|
529
572
|
*/
|
|
530
|
-
_buildOutsideInPairGroupsForCreateEntries(createEntries:
|
|
573
|
+
_buildOutsideInPairGroupsForCreateEntries(createEntries: unknown[]): unknown[][];
|
|
531
574
|
/**
|
|
532
575
|
* Resolve the fill/broadcast batch size from the grid gap-slot count.
|
|
533
576
|
*
|
|
@@ -578,14 +621,14 @@ declare class DEXBot {
|
|
|
578
621
|
* @param {Array<{index:number, ctx:Object}>} missingCreateResults - Missing CREATE results.
|
|
579
622
|
* @returns {void}
|
|
580
623
|
*/
|
|
581
|
-
_markMissingCreateResultsAsStructuralBlocker(missingCreateResults:
|
|
624
|
+
_markMissingCreateResultsAsStructuralBlocker(missingCreateResults: unknown): void;
|
|
582
625
|
/**
|
|
583
626
|
* Format an unmatched chain order/blocker for COW logs.
|
|
584
627
|
*
|
|
585
628
|
* @param {Object} order - Unmatched chain order or structural blocker.
|
|
586
629
|
* @returns {string} Compact human-readable diagnostic.
|
|
587
630
|
*/
|
|
588
|
-
_formatUnmatchedChainOrderForLog(order:
|
|
631
|
+
_formatUnmatchedChainOrderForLog(order: unknown): string;
|
|
589
632
|
/**
|
|
590
633
|
* Record a pending CREATE broadcast on the manager.
|
|
591
634
|
*
|
|
@@ -606,7 +649,7 @@ declare class DEXBot {
|
|
|
606
649
|
* @param {Object} entry.finalInts - { amountToSell, minToReceive, ... } blockchain integers
|
|
607
650
|
* @returns {void}
|
|
608
651
|
*/
|
|
609
|
-
_recordPendingBroadcast(entry:
|
|
652
|
+
_recordPendingBroadcast(entry: unknown): string | null;
|
|
610
653
|
/**
|
|
611
654
|
* Clear the pending-broadcast cache.
|
|
612
655
|
*
|
|
@@ -631,7 +674,7 @@ declare class DEXBot {
|
|
|
631
674
|
* @param {Object} planned - { sell, receive, orderType } integers from the planned op
|
|
632
675
|
* @returns {Object|null} Matching chain order, or null
|
|
633
676
|
*/
|
|
634
|
-
_findChainOrderForSlot(chainOrders:
|
|
677
|
+
_findChainOrderForSlot(chainOrders: ChainOrderLike[], slotId: string, planned: Parameters<typeof cowRuntime.findChainOrderForSlot>[3]): ChainOrderLike | null;
|
|
635
678
|
/**
|
|
636
679
|
* Reconcile a broadcast whose chain state is unknown.
|
|
637
680
|
*
|
|
@@ -658,7 +701,12 @@ declare class DEXBot {
|
|
|
658
701
|
* @param {Array<Object>} opContexts - Original opContexts from the failed batch
|
|
659
702
|
* @returns {Promise<Object>} Result object compatible with batch return shape
|
|
660
703
|
*/
|
|
661
|
-
_reconcileAfterUncertainBroadcast(err:
|
|
704
|
+
_reconcileAfterUncertainBroadcast(err: unknown, opContexts: OpPhase[], options?: UnknownRecord): Promise<UnknownRecord | {
|
|
705
|
+
executed: boolean;
|
|
706
|
+
hadRotation: boolean;
|
|
707
|
+
uncertain: boolean;
|
|
708
|
+
ambiguousRead: boolean;
|
|
709
|
+
}>;
|
|
662
710
|
/**
|
|
663
711
|
* Execute operations with retry on BroadcastUncertainError.
|
|
664
712
|
* The daemon already retries internally against a 25s deadline. If it
|
|
@@ -672,9 +720,9 @@ declare class DEXBot {
|
|
|
672
720
|
* execution where earlier groups already committed). Re-broadcasting
|
|
673
721
|
* the full operations array would duplicate those creates on chain.
|
|
674
722
|
*/
|
|
675
|
-
_executeWithRetryOnUncertain(operations:
|
|
676
|
-
result:
|
|
677
|
-
opContexts:
|
|
723
|
+
_executeWithRetryOnUncertain(operations: unknown[], opContexts: OpPhase[]): Promise<{
|
|
724
|
+
result: unknown;
|
|
725
|
+
opContexts: OpPhase[];
|
|
678
726
|
}>;
|
|
679
727
|
/**
|
|
680
728
|
* Execute operations with retry-on-uncertain semantics AND a per-broadcast
|
|
@@ -685,9 +733,9 @@ declare class DEXBot {
|
|
|
685
733
|
* @param {Array<Object>} opContexts - Array of operation context metadata (1:1 with operations)
|
|
686
734
|
* @returns {Promise<{result: Object, opContexts: Array}>} Execution result with contexts
|
|
687
735
|
*/
|
|
688
|
-
_executeChunkedWithRetryOnUncertain(operations:
|
|
689
|
-
result:
|
|
690
|
-
opContexts:
|
|
736
|
+
_executeChunkedWithRetryOnUncertain(operations: unknown[], opContexts: OpPhase[]): Promise<{
|
|
737
|
+
result: unknown;
|
|
738
|
+
opContexts: OpPhase[];
|
|
691
739
|
}>;
|
|
692
740
|
/**
|
|
693
741
|
* Execute a batch of order operations if the rebalance result has executable actions.
|
|
@@ -695,7 +743,7 @@ declare class DEXBot {
|
|
|
695
743
|
* @param {string} [contextLabel='rebalance'] - Context label for logging
|
|
696
744
|
* @returns {Promise<Object>} Batch execution result
|
|
697
745
|
*/
|
|
698
|
-
_executeBatchIfNeeded(rebalanceResult:
|
|
746
|
+
_executeBatchIfNeeded(rebalanceResult: unknown, contextLabel?: unknown): Promise<unknown>;
|
|
699
747
|
/**
|
|
700
748
|
* Process filled orders in (gap-slot + 1)-sized batches per _getGapSlotBatchSize().
|
|
701
749
|
* Each chunk triggers its own processFilledOrders → COW plan → broadcast cycle.
|
|
@@ -706,13 +754,7 @@ declare class DEXBot {
|
|
|
706
754
|
* @param {Object} [options={}] - Passed through to processFilledOrders
|
|
707
755
|
* @returns {{aborted: boolean}}
|
|
708
756
|
*/
|
|
709
|
-
_processFillsWithBatching(fills:
|
|
710
|
-
aborted: boolean;
|
|
711
|
-
deferred?: undefined;
|
|
712
|
-
} | {
|
|
713
|
-
aborted: boolean;
|
|
714
|
-
deferred: boolean;
|
|
715
|
-
}>;
|
|
757
|
+
_processFillsWithBatching(fills: unknown, excl: unknown, contextLabel: unknown, options?: UnknownRecord): Promise<FillBatchResult>;
|
|
716
758
|
/**
|
|
717
759
|
* Check if the bot requires credential daemon for write operations.
|
|
718
760
|
* @returns {boolean}
|
|
@@ -723,26 +765,26 @@ declare class DEXBot {
|
|
|
723
765
|
* @param {string} reason - Reason for suspension
|
|
724
766
|
* @returns {void}
|
|
725
767
|
*/
|
|
726
|
-
_suspendGridPersistenceForCredentialOutage(reason:
|
|
768
|
+
_suspendGridPersistenceForCredentialOutage(reason: unknown): void;
|
|
727
769
|
/**
|
|
728
770
|
* Resume grid persistence after credential daemon recovery.
|
|
729
771
|
* @param {string} reason - Reason for resuming
|
|
730
772
|
* @returns {void}
|
|
731
773
|
*/
|
|
732
|
-
_resumeGridPersistenceAfterCredentialRecovery(reason:
|
|
774
|
+
_resumeGridPersistenceAfterCredentialRecovery(reason: unknown): void;
|
|
733
775
|
/**
|
|
734
776
|
* Ensure the credential daemon is writable before broadcasting operations.
|
|
735
777
|
* @param {string} [contextLabel='write batch'] - Context label for logging
|
|
736
778
|
* @returns {Promise<void>}
|
|
737
779
|
* @throws {Error} With code CREDENTIAL_DAEMON_UNAVAILABLE if daemon is down
|
|
738
780
|
*/
|
|
739
|
-
_ensureCredentialDaemonWritable(contextLabel?:
|
|
781
|
+
_ensureCredentialDaemonWritable(contextLabel?: unknown): Promise<void>;
|
|
740
782
|
/**
|
|
741
783
|
* Check if an error is related to credential daemon unavailability.
|
|
742
784
|
* @param {Error|*} err - Error to check
|
|
743
785
|
* @returns {boolean}
|
|
744
786
|
*/
|
|
745
|
-
_isCredentialDaemonError(err:
|
|
787
|
+
_isCredentialDaemonError(err: unknown): boolean;
|
|
746
788
|
/**
|
|
747
789
|
* Run state recovery after credential daemon is restored.
|
|
748
790
|
* @returns {Promise<void>}
|
|
@@ -753,6 +795,25 @@ declare class DEXBot {
|
|
|
753
795
|
* @returns {void}
|
|
754
796
|
*/
|
|
755
797
|
_setupCredentialDaemonWatchdogInterval(): void;
|
|
798
|
+
/**
|
|
799
|
+
* Consecutive failed watchdog probes required before the credential daemon
|
|
800
|
+
* is declared down. One-liner so the startup log and the probe decision
|
|
801
|
+
* can never disagree about the threshold.
|
|
802
|
+
* @returns {number} Positive integer threshold
|
|
803
|
+
*/
|
|
804
|
+
_credentialDaemonWatchdogFailureThreshold(): number;
|
|
805
|
+
/**
|
|
806
|
+
* Run a single credential-daemon watchdog health probe.
|
|
807
|
+
*
|
|
808
|
+
* A probe failure is only treated as a daemon outage after
|
|
809
|
+
* CREDENTIAL_DAEMON_WATCHDOG_FAILURE_THRESHOLD consecutive failures, so one
|
|
810
|
+
* transient timeout (daemon busy signing) never pauses writes or suspends
|
|
811
|
+
* grid persistence. A confirmed outage sets `_credentialRecoveryNeeded` so
|
|
812
|
+
* the successful-probe path CAN resume persistence — otherwise the
|
|
813
|
+
* suspension lasted until a process restart (production incident).
|
|
814
|
+
* @returns {Promise<void>}
|
|
815
|
+
*/
|
|
816
|
+
_runCredentialDaemonWatchdogProbe(): Promise<void>;
|
|
756
817
|
/**
|
|
757
818
|
* Stop the credential daemon watchdog interval.
|
|
758
819
|
* @returns {void}
|
|
@@ -764,27 +825,20 @@ declare class DEXBot {
|
|
|
764
825
|
* @param {Object} rebalanceResult - COW result containing workingGrid + actions.
|
|
765
826
|
* @returns {Promise<Object>} The batch result.
|
|
766
827
|
*/
|
|
767
|
-
updateOrdersOnChainBatch(rebalanceResult:
|
|
828
|
+
updateOrdersOnChainBatch(rebalanceResult: unknown): Promise<unknown>;
|
|
768
829
|
/**
|
|
769
830
|
* Converts simple plan payloads (place/update/rotate/cancel) into a COW batch.
|
|
770
831
|
* Used by spread/divergence maintenance and bootstrap helpers.
|
|
771
832
|
* @param {Object|Array} plan - Plan object or array of ordersToPlace
|
|
772
833
|
* @returns {Promise<Object>} Batch execution result
|
|
773
834
|
*/
|
|
774
|
-
updateOrdersOnChainPlan(plan:
|
|
835
|
+
updateOrdersOnChainPlan(plan: UnknownRecord): Promise<UnknownRecord>;
|
|
775
836
|
/**
|
|
776
837
|
* Build a COW result object (workingGrid + actions) from a simple plan.
|
|
777
838
|
* @param {Object|Array} plan - Plan object or array of ordersToPlace
|
|
778
839
|
* @returns {{workingGrid: any, workingIndexes: Object, workingBoundary: number, actions: Array}}
|
|
779
840
|
*/
|
|
780
|
-
_buildCowResultFromPlan(plan:
|
|
781
|
-
refillSlotIds?: any;
|
|
782
|
-
workingGrid: any;
|
|
783
|
-
workingIndexes: any;
|
|
784
|
-
workingBoundary: any;
|
|
785
|
-
actions: any[];
|
|
786
|
-
origin: any;
|
|
787
|
-
};
|
|
841
|
+
_buildCowResultFromPlan(plan: UnknownRecord): CowResult;
|
|
788
842
|
/**
|
|
789
843
|
* COW broadcast: Execute blockchain operations and commit working grid on success.
|
|
790
844
|
* Master grid is ONLY updated after successful blockchain confirmation.
|
|
@@ -792,12 +846,8 @@ declare class DEXBot {
|
|
|
792
846
|
* @returns {Promise<Object>} The batch result.
|
|
793
847
|
* @private
|
|
794
848
|
*/
|
|
795
|
-
_updateOrdersOnChainBatchCOW(cowResult:
|
|
796
|
-
_processBatchResults(result:
|
|
797
|
-
executed: boolean;
|
|
798
|
-
hadRotation: boolean;
|
|
799
|
-
updateOperationCount: number;
|
|
800
|
-
}>;
|
|
849
|
+
_updateOrdersOnChainBatchCOW(cowResult: CowResult, options?: UnknownRecord): Promise<UnknownRecord>;
|
|
850
|
+
_processBatchResults(result: UnknownRecord, opContexts: OpPhase[]): Promise<UnknownRecord>;
|
|
801
851
|
/**
|
|
802
852
|
* Perform grid recalculation triggered by trigger file.
|
|
803
853
|
* Reloads config from disk, recalculates grid, resets funds, and removes trigger file.
|
|
@@ -806,7 +856,7 @@ declare class DEXBot {
|
|
|
806
856
|
* @returns {Promise<boolean>} True if resync succeeded
|
|
807
857
|
* @private
|
|
808
858
|
*/
|
|
809
|
-
_performGridResync(options?:
|
|
859
|
+
_performGridResync(options?: UnknownRecord): Promise<unknown>;
|
|
810
860
|
/**
|
|
811
861
|
* Handle any pending trigger file reset at startup.
|
|
812
862
|
* This is called FIRST during startup before any grid operations.
|
|
@@ -825,14 +875,14 @@ declare class DEXBot {
|
|
|
825
875
|
* @param {string|Object|Buffer} [vaultSecret=null] - The unlock secret.
|
|
826
876
|
* @returns {Promise<void>}
|
|
827
877
|
*/
|
|
828
|
-
start(vaultSecret?:
|
|
878
|
+
start(vaultSecret?: unknown): Promise<void>;
|
|
829
879
|
/**
|
|
830
880
|
* Start bot with a pre-decrypted private key.
|
|
831
881
|
* Alternative to start(vaultSecret) when the signing secret is already available.
|
|
832
882
|
* @param {string|Object} privateKey - Pre-decrypted private key or daemon signing token
|
|
833
883
|
* @returns {Promise<void>}
|
|
834
884
|
*/
|
|
835
|
-
startWithPrivateKey(privateKey:
|
|
885
|
+
startWithPrivateKey(privateKey: unknown): Promise<void>;
|
|
836
886
|
/**
|
|
837
887
|
* Common startup sequence logic shared between start() and startWithPrivateKey().
|
|
838
888
|
* @private
|
|
@@ -883,17 +933,17 @@ declare class DEXBot {
|
|
|
883
933
|
* @private
|
|
884
934
|
*/
|
|
885
935
|
_stopBotsConfigPollInterval(): void;
|
|
886
|
-
_releaseMarketAdapterRuntime(context?:
|
|
936
|
+
_releaseMarketAdapterRuntime(context?: unknown): Promise<any>;
|
|
887
937
|
/**
|
|
888
938
|
* Get or create the credit runtime for debt policy management.
|
|
889
939
|
* @returns {import('./credit_runtime.js').CreditRuntime|null}
|
|
890
940
|
*/
|
|
891
|
-
_getCreditRuntime():
|
|
941
|
+
_getCreditRuntime(): CreditRuntimeLike | null;
|
|
892
942
|
/**
|
|
893
943
|
* Set up the credit runtime by loading its persisted state.
|
|
894
944
|
* @returns {Promise<import('./credit_runtime.js').CreditRuntime|null>}
|
|
895
945
|
*/
|
|
896
|
-
_setupCreditRuntime(): Promise<
|
|
946
|
+
_setupCreditRuntime(): Promise<CreditRuntimeLike | null>;
|
|
897
947
|
/**
|
|
898
948
|
* Refresh credit runtime state from chain and sync internal tracking.
|
|
899
949
|
* @returns {Promise<void>}
|
|
@@ -905,7 +955,7 @@ declare class DEXBot {
|
|
|
905
955
|
* @param {Object} [options={}] - Maintenance options
|
|
906
956
|
* @returns {Promise<*>} Maintenance result from runtime
|
|
907
957
|
*/
|
|
908
|
-
_runCreditRuntimeMaintenance(context?:
|
|
958
|
+
_runCreditRuntimeMaintenance(context?: unknown, options?: UnknownRecord): Promise<unknown>;
|
|
909
959
|
/**
|
|
910
960
|
* Start the credit deal watchdog interval.
|
|
911
961
|
* @returns {void}
|
|
@@ -916,10 +966,7 @@ declare class DEXBot {
|
|
|
916
966
|
* @returns {void}
|
|
917
967
|
*/
|
|
918
968
|
_stopCreditWatchdogInterval(): void;
|
|
919
|
-
requestGridReset(reason?:
|
|
920
|
-
refreshCenterPrice?: boolean;
|
|
921
|
-
[key: string]: any;
|
|
922
|
-
}): Promise<any>;
|
|
969
|
+
requestGridReset(reason?: unknown, options?: UnknownRecord): Promise<unknown>;
|
|
923
970
|
_wireStructuralGridResyncRequest(): void;
|
|
924
971
|
/**
|
|
925
972
|
* Wire the manager's broadcast-region-end hook to drain the deferred fill
|
|
@@ -928,16 +975,33 @@ declare class DEXBot {
|
|
|
928
975
|
* long region (e.g. the structural resync's Phase-2 placement) would
|
|
929
976
|
* starve indefinitely — which also keeps the maintenance idle gate shut
|
|
930
977
|
* forever (the queue-length check returns the full settle delay).
|
|
931
|
-
* Registered via addBroadcastRegionEndListener (fan-out)
|
|
932
|
-
*
|
|
933
|
-
*
|
|
978
|
+
* Registered via addBroadcastRegionEndListener (fan-out) so a second wirer
|
|
979
|
+
* can never silently displace the drain. Re-entry safe: the marker keeps
|
|
980
|
+
* repeated wiring idempotent.
|
|
934
981
|
*/
|
|
935
982
|
_wireBroadcastRegionEndDrain(): void;
|
|
936
983
|
/**
|
|
937
984
|
* Get current metrics for monitoring and debugging.
|
|
938
985
|
* @returns {Object} Metrics snapshot
|
|
939
986
|
*/
|
|
940
|
-
getMetrics():
|
|
987
|
+
getMetrics(): {
|
|
988
|
+
queueDepth: number;
|
|
989
|
+
fillProcessingLockActive: boolean;
|
|
990
|
+
divergenceLockActive: boolean;
|
|
991
|
+
shadowLocksActive: number;
|
|
992
|
+
recoveryExhaustedAt: number | null;
|
|
993
|
+
recentFillsTracked: number;
|
|
994
|
+
unmatchedChainOrders: number;
|
|
995
|
+
heldChainOrders: number;
|
|
996
|
+
blockingChainOrders: number;
|
|
997
|
+
fillsProcessed: number;
|
|
998
|
+
batchesExecuted: number;
|
|
999
|
+
fillProcessingTimeMs: number;
|
|
1000
|
+
lockContentionEvents: number;
|
|
1001
|
+
maxQueueDepth: number;
|
|
1002
|
+
gridLockContention: number;
|
|
1003
|
+
fundRecalcCount: number;
|
|
1004
|
+
};
|
|
941
1005
|
/**
|
|
942
1006
|
* Execute grid maintenance checks in strict order with pipeline consensus.
|
|
943
1007
|
*
|
|
@@ -969,7 +1033,7 @@ declare class DEXBot {
|
|
|
969
1033
|
* @param {Object} context - Maintenance context for logging.
|
|
970
1034
|
* @private
|
|
971
1035
|
*/
|
|
972
|
-
_executeMaintenanceLogic(context:
|
|
1036
|
+
_executeMaintenanceLogic(context: unknown): Promise<void>;
|
|
973
1037
|
/**
|
|
974
1038
|
* Cancel dust partial orders immediately — no maps, no timers, no delay.
|
|
975
1039
|
* Each dust order is cancelled on chain and its slot rotated through the
|
|
@@ -978,13 +1042,16 @@ declare class DEXBot {
|
|
|
978
1042
|
* @returns {Promise<{cancelledCount: number, batchResult: {aborted: boolean}|null}>}
|
|
979
1043
|
* @private
|
|
980
1044
|
*/
|
|
981
|
-
_cancelDustOrders({ buy: buyDust, sell: sellDust }?:
|
|
1045
|
+
_cancelDustOrders({ buy: buyDust, sell: sellDust }?: {
|
|
1046
|
+
buy?: unknown[];
|
|
1047
|
+
sell?: unknown[];
|
|
1048
|
+
}): Promise<{
|
|
982
1049
|
cancelledCount: number;
|
|
983
1050
|
batchResult: null;
|
|
984
1051
|
} | {
|
|
985
1052
|
cancelledCount: number;
|
|
986
1053
|
batchResult: {
|
|
987
|
-
aborted:
|
|
1054
|
+
aborted: boolean | undefined;
|
|
988
1055
|
};
|
|
989
1056
|
}>;
|
|
990
1057
|
/**
|
|
@@ -1027,7 +1094,7 @@ declare class DEXBot {
|
|
|
1027
1094
|
* @param {Object} options - Maintenance options
|
|
1028
1095
|
* @private
|
|
1029
1096
|
*/
|
|
1030
|
-
_runGridMaintenance(context?:
|
|
1097
|
+
_runGridMaintenance(context?: unknown, options?: UnknownRecord): Promise<unknown>;
|
|
1031
1098
|
/**
|
|
1032
1099
|
* Gracefully shutdown the bot.
|
|
1033
1100
|
* Waits for current fill processing to complete, persists state, and stops intervals.
|