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
|
@@ -1,5 +1,17 @@
|
|
|
1
|
+
import type { BotLike, OrderManagerLike, ManagedOrder, SpreadCorrectionStall } from './types.js';
|
|
2
|
+
/** Loose JSON-object view used across the maintenance runtime. */
|
|
3
|
+
type JsonObj = Record<string, unknown>;
|
|
4
|
+
/** A stranded/held chain order as seen by the deferred-hold helpers. */
|
|
5
|
+
interface HeldChainOrder {
|
|
6
|
+
type?: unknown;
|
|
7
|
+
price?: unknown;
|
|
8
|
+
size?: unknown;
|
|
9
|
+
reason?: unknown;
|
|
10
|
+
chainOrderId?: unknown;
|
|
11
|
+
[key: string]: unknown;
|
|
12
|
+
}
|
|
1
13
|
import { usesAmaGridPrice } from './grid_price_source.js';
|
|
2
|
-
declare
|
|
14
|
+
declare const isWrapperAdapterOwner: (...args: unknown[]) => any;
|
|
3
15
|
/**
|
|
4
16
|
* Check if a bot configuration uses an AMA grid price source.
|
|
5
17
|
*
|
|
@@ -10,25 +22,29 @@ declare function isWrapperAdapterOwner(...args: any): any;
|
|
|
10
22
|
/**
|
|
11
23
|
* Find a bot entry in the bots config snapshot that matches a runtime config.
|
|
12
24
|
* Matches by botKey or name.
|
|
13
|
-
* @param {
|
|
25
|
+
* @param {unknown} snapshot - Bots configuration snapshot
|
|
14
26
|
* @param {Object} config - Runtime bot configuration
|
|
15
27
|
* @returns {Object|null} Matched bot entry or null
|
|
16
28
|
*/
|
|
17
|
-
declare function findSnapshotBotForRuntimeConfig(snapshot:
|
|
29
|
+
declare function findSnapshotBotForRuntimeConfig(snapshot: {
|
|
30
|
+
activeBots?: BotLike[];
|
|
31
|
+
}, config: JsonObj): BotLike | null;
|
|
18
32
|
/**
|
|
19
33
|
* Check if a runtime bot configuration requires the market adapter.
|
|
20
|
-
* @param {
|
|
34
|
+
* @param {unknown} snapshot - Bots configuration snapshot
|
|
21
35
|
* @param {Object} config - Runtime bot configuration
|
|
22
36
|
* @returns {boolean} True if the bot uses AMA grid pricing
|
|
23
37
|
*/
|
|
24
|
-
declare function runtimeConfigNeedsMarketAdapter(snapshot:
|
|
38
|
+
declare function runtimeConfigNeedsMarketAdapter(snapshot: {
|
|
39
|
+
activeBots?: BotLike[];
|
|
40
|
+
}, config: JsonObj): boolean;
|
|
25
41
|
/**
|
|
26
42
|
* Build the full-entry fingerprint for one bot (stable across key order and
|
|
27
43
|
* comment/whitespace edits, since those never reach the parsed entry).
|
|
28
|
-
* @param {
|
|
44
|
+
* @param {unknown} entry - Raw bot entry from bots.json
|
|
29
45
|
* @returns {string} Fingerprint ('' when entry is missing)
|
|
30
46
|
*/
|
|
31
|
-
declare function buildBotConfigFingerprint(entry:
|
|
47
|
+
declare function buildBotConfigFingerprint(entry: unknown): string;
|
|
32
48
|
/**
|
|
33
49
|
* Check bots.json for this bot's entry and live-apply allowlisted keys
|
|
34
50
|
* (BOT_LIVE_CONFIG_KEYS; debtPolicy additionally reconciles the credit
|
|
@@ -46,12 +62,12 @@ declare function buildBotConfigFingerprint(entry: any): string;
|
|
|
46
62
|
* the baseline with no hint. Corrupt/unreadable files and missing entries
|
|
47
63
|
* never touch the stored fingerprint (except the missing-entry hint
|
|
48
64
|
* throttle) so the next tick re-evaluates.
|
|
49
|
-
* @param {
|
|
65
|
+
* @param {unknown} bot - DEXBot instance
|
|
50
66
|
* @param {string} [context='bots-config poll'] - Context label for logging
|
|
51
|
-
* @param {
|
|
67
|
+
* @param {unknown} [preloadedSnapshot=null] - Reuse an already-loaded snapshot
|
|
52
68
|
* @returns {Promise<any>} Result with applied/liveChanges/otherKeys or skipped
|
|
53
69
|
*/
|
|
54
|
-
declare function checkAndApplyBotConfigChanges(bot:
|
|
70
|
+
declare function checkAndApplyBotConfigChanges(bot: BotLike, context?: string, preloadedSnapshot?: JsonObj | null): Promise<unknown>;
|
|
55
71
|
/**
|
|
56
72
|
* Count live on-chain reserve orders for one side (issue #27 follow-up).
|
|
57
73
|
*
|
|
@@ -71,27 +87,43 @@ declare function checkAndApplyBotConfigChanges(bot: any, context?: any, preloade
|
|
|
71
87
|
* window = bottom slots = floor edge) makes the edge pick land on window
|
|
72
88
|
* members and the count reads N/N with zero dedicated reserves, so the
|
|
73
89
|
* deficit never fires (issue #27 follow-up).
|
|
74
|
-
* @param {
|
|
75
|
-
* @param {
|
|
76
|
-
* @param {
|
|
90
|
+
* @param {unknown} manager - OrderManager
|
|
91
|
+
* @param {unknown} config - Bot configuration (reserve count source)
|
|
92
|
+
* @param {unknown} type - ORDER_TYPES.BUY or ORDER_TYPES.SELL
|
|
77
93
|
* @returns {number|null} Live reserve count, or null when unclassifiable
|
|
78
94
|
*/
|
|
79
|
-
declare function countLiveReserveOrders(manager:
|
|
80
|
-
|
|
95
|
+
declare function countLiveReserveOrders(manager: OrderManagerLike, config: JsonObj, type: unknown): number | null;
|
|
96
|
+
/**
|
|
97
|
+
* Mirror a spread-check stall into the flags the targeted-sync gate reads.
|
|
98
|
+
*
|
|
99
|
+
* ANY stall — fund, batch, or structural — arms the refresh. When the
|
|
100
|
+
* correction cannot act on the local snapshot, that snapshot may simply be
|
|
101
|
+
* stale relative to the chain: a missed fill leaves an ACTIVE slot occupying
|
|
102
|
+
* the window edge, so `isSlotAvailable` hides every tightening slot and the
|
|
103
|
+
* check reports 'no-candidates' even though real geometry exists. A refresh is
|
|
104
|
+
* the only way to tell a genuinely structural stall from a stale one, so we
|
|
105
|
+
* sync rather than wait for the out-of-spread staleness watchdog to re-center.
|
|
106
|
+
* The stall cause is kept alongside the flag so the log states the truth.
|
|
107
|
+
* Exported for tests.
|
|
108
|
+
* @param {BotLike} bot
|
|
109
|
+
* @param {SpreadCorrectionStall|null|undefined} stall
|
|
110
|
+
*/
|
|
111
|
+
export declare function mirrorSpreadStall(bot: BotLike, stall: SpreadCorrectionStall | null | undefined): void;
|
|
112
|
+
declare function getTargetedSyncReason(bot: BotLike): {
|
|
81
113
|
reason: string;
|
|
82
114
|
targetBuy: any;
|
|
83
115
|
targetSell: any;
|
|
84
|
-
liveBuy:
|
|
85
|
-
liveSell:
|
|
86
|
-
drift:
|
|
116
|
+
liveBuy: number;
|
|
117
|
+
liveSell: number;
|
|
118
|
+
drift: import("./types.js").FundDriftCheck;
|
|
87
119
|
} | null;
|
|
88
|
-
declare function maybeRunTargetedDriftReconciliation(bot:
|
|
120
|
+
declare function maybeRunTargetedDriftReconciliation(bot: BotLike, context: string): Promise<boolean>;
|
|
89
121
|
/**
|
|
90
122
|
* Load and fingerprint the bots.json configuration file.
|
|
91
123
|
* Delegates to the canonical launcher/adapter_requirement helper so the
|
|
92
124
|
* fingerprint is semantic (AMA-relevant changes only) and identical to the
|
|
93
125
|
* unlock wrapper watchdog's view of the same file.
|
|
94
|
-
* @returns {
|
|
126
|
+
* @returns {unknown} Snapshot with exists flag, fingerprint, active bots list, and adapter requirement
|
|
95
127
|
*/
|
|
96
128
|
declare function loadBotsConfigSnapshot(): any;
|
|
97
129
|
/**
|
|
@@ -106,15 +138,15 @@ declare function stopMarketAdapterPm2(): Promise<void>;
|
|
|
106
138
|
* @param {string} [context='periodic'] - Context label for logging
|
|
107
139
|
* @returns {Promise<any>}
|
|
108
140
|
*/
|
|
109
|
-
declare function syncMarketAdapterOnPeriodicConfigCheck(bot:
|
|
141
|
+
declare function syncMarketAdapterOnPeriodicConfigCheck(bot: BotLike, context?: string): Promise<unknown>;
|
|
110
142
|
/**
|
|
111
143
|
* Refresh the dynamic weight distribution from the AMA center snapshot.
|
|
112
144
|
* Applies live dynamic weights if the bot is whitelisted and weights are ready.
|
|
113
145
|
* @param {import('./dexbot_class.js').DEXBot} bot
|
|
114
146
|
* @param {string} [context='runtime'] - Context label for logging
|
|
115
|
-
* @returns {
|
|
147
|
+
* @returns {unknown}
|
|
116
148
|
*/
|
|
117
|
-
declare function refreshDynamicWeightDistribution(bot:
|
|
149
|
+
declare function refreshDynamicWeightDistribution(bot: BotLike, context?: string): {
|
|
118
150
|
applied: boolean;
|
|
119
151
|
source: string;
|
|
120
152
|
weightDistribution: any;
|
|
@@ -123,7 +155,7 @@ declare function refreshDynamicWeightDistribution(bot: any, context?: any): {
|
|
|
123
155
|
applied: boolean;
|
|
124
156
|
source: string;
|
|
125
157
|
weightDistribution: any;
|
|
126
|
-
snapshotUpdatedAt:
|
|
158
|
+
snapshotUpdatedAt: {} | null;
|
|
127
159
|
};
|
|
128
160
|
/**
|
|
129
161
|
* Update the grid reset metadata (last reset timestamp and source) in the dynamic grid snapshot.
|
|
@@ -133,7 +165,7 @@ declare function refreshDynamicWeightDistribution(bot: any, context?: any): {
|
|
|
133
165
|
* @param {string} [options.resetSource] - Source label for the reset (defaults to 'dexbot_grid_resync')
|
|
134
166
|
* @returns {boolean} True if metadata was written
|
|
135
167
|
*/
|
|
136
|
-
declare function updateBotGridResetMetadata(botKey:
|
|
168
|
+
declare function updateBotGridResetMetadata(botKey: string | undefined, options?: {
|
|
137
169
|
resetAt?: string;
|
|
138
170
|
resetSource?: string;
|
|
139
171
|
}): any;
|
|
@@ -141,11 +173,11 @@ declare function updateBotGridResetMetadata(botKey: any, options?: {
|
|
|
141
173
|
* Perform a full grid resync: reload config, optionally refresh center price,
|
|
142
174
|
* recalculate the grid, persist, and record reset metadata.
|
|
143
175
|
* @param {import('./dexbot_class.js').DEXBot} bot
|
|
144
|
-
* @param {
|
|
176
|
+
* @param {unknown} [options] - Grid resync options
|
|
145
177
|
* @param {boolean} [options.skipIdle=false] - Skip the idle-cooldown deferral
|
|
146
178
|
* @returns {Promise<boolean>} True if resync succeeded
|
|
147
179
|
*/
|
|
148
|
-
declare function performGridResync(bot:
|
|
180
|
+
declare function performGridResync(bot: BotLike, options?: {
|
|
149
181
|
refreshCenterPrice?: boolean;
|
|
150
182
|
centerRefreshContext?: string;
|
|
151
183
|
centerRefreshLabel?: string;
|
|
@@ -158,21 +190,21 @@ declare function performGridResync(bot: any, options?: {
|
|
|
158
190
|
* @param {import('./dexbot_class.js').DEXBot} bot
|
|
159
191
|
* @returns {Promise<boolean>} True if reset was handled successfully
|
|
160
192
|
*/
|
|
161
|
-
declare function handlePendingTriggerReset(bot:
|
|
193
|
+
declare function handlePendingTriggerReset(bot: BotLike): Promise<boolean>;
|
|
162
194
|
/**
|
|
163
195
|
* Set up a file watcher on the profiles directory to detect trigger file creation.
|
|
164
196
|
* When a trigger file appears, debounces and processes the grid resync.
|
|
165
197
|
* @param {import('./dexbot_class.js').DEXBot} bot
|
|
166
198
|
* @returns {Promise<void>}
|
|
167
199
|
*/
|
|
168
|
-
declare function setupTriggerFileDetection(bot:
|
|
200
|
+
declare function setupTriggerFileDetection(bot: BotLike): Promise<void>;
|
|
169
201
|
/**
|
|
170
202
|
* Perform periodic grid health checks (divergence, spread condition, dust detection).
|
|
171
203
|
* Called as part of the periodic blockchain fetch interval.
|
|
172
204
|
* @param {import('./dexbot_class.js').DEXBot} bot
|
|
173
205
|
* @returns {Promise<void>}
|
|
174
206
|
*/
|
|
175
|
-
declare function performPeriodicGridChecks(bot:
|
|
207
|
+
declare function performPeriodicGridChecks(bot: BotLike): Promise<void>;
|
|
176
208
|
/**
|
|
177
209
|
* Summarize deliberate deferred holds once per count change. The per-order
|
|
178
210
|
* sync logs report each hold when it first appears; this surfaces the running
|
|
@@ -186,7 +218,7 @@ declare function performPeriodicGridChecks(bot: any): Promise<void>;
|
|
|
186
218
|
*
|
|
187
219
|
* @param {import('./dexbot_class.js').DEXBot} bot
|
|
188
220
|
*/
|
|
189
|
-
declare function logDeferredHoldSummary(bot:
|
|
221
|
+
declare function logDeferredHoldSummary(bot: BotLike): void;
|
|
190
222
|
/**
|
|
191
223
|
* Escalate an INDEFINITELY-HELD deferred hold to a structural resync.
|
|
192
224
|
*
|
|
@@ -204,7 +236,7 @@ declare function logDeferredHoldSummary(bot: any): void;
|
|
|
204
236
|
*
|
|
205
237
|
* Fire-and-forget; the resync is itself debounced and batch-in-flight aware.
|
|
206
238
|
*/
|
|
207
|
-
declare function considerDeferredHoldEscalation(bot:
|
|
239
|
+
declare function considerDeferredHoldEscalation(bot: BotLike, strandedOrders: HeldChainOrder[], strandedMs: number): void;
|
|
208
240
|
/**
|
|
209
241
|
* Render the per-order detail for a deferred-hold summary: side, price, size,
|
|
210
242
|
* why it is held, and distance from the nearest grid bound when known.
|
|
@@ -213,36 +245,36 @@ declare function considerDeferredHoldEscalation(bot: any, strandedOrders: any[],
|
|
|
213
245
|
* a near-miss (a few bps outside, likely a rounding/drift artifact) from a
|
|
214
246
|
* deliberately-placed far order (dip protection after a grid reset).
|
|
215
247
|
*/
|
|
216
|
-
declare function describeDeferredHolds(bot:
|
|
248
|
+
declare function describeDeferredHolds(bot: BotLike, heldOrders: HeldChainOrder[]): string;
|
|
217
249
|
/**
|
|
218
250
|
* Check if the continuous open-orders sync loop is enabled.
|
|
219
251
|
* @param {import('./dexbot_class.js').DEXBot} bot
|
|
220
252
|
* @returns {boolean} True if the sync loop is enabled in TIMING config
|
|
221
253
|
*/
|
|
222
|
-
declare function isOpenOrdersSyncLoopEnabled(bot:
|
|
254
|
+
declare function isOpenOrdersSyncLoopEnabled(bot: BotLike): boolean;
|
|
223
255
|
/**
|
|
224
256
|
* Start the continuous open-orders sync loop.
|
|
225
257
|
* Periodically reads on-chain orders and synchronizes with the grid manager.
|
|
226
258
|
* @param {import('./dexbot_class.js').DEXBot} bot
|
|
227
259
|
*/
|
|
228
|
-
declare function startOpenOrdersSyncLoop(bot:
|
|
260
|
+
declare function startOpenOrdersSyncLoop(bot: BotLike): void;
|
|
229
261
|
/**
|
|
230
262
|
* Stop the continuous open-orders sync loop.
|
|
231
263
|
* @param {import('./dexbot_class.js').DEXBot} bot
|
|
232
264
|
* @returns {Promise<void>}
|
|
233
265
|
*/
|
|
234
|
-
declare function stopOpenOrdersSyncLoop(bot:
|
|
266
|
+
declare function stopOpenOrdersSyncLoop(bot: BotLike): Promise<void>;
|
|
235
267
|
/**
|
|
236
268
|
* Set up the periodic blockchain fetch interval.
|
|
237
269
|
* Periodically fetches account totals and syncs open orders from the blockchain.
|
|
238
270
|
* @param {import('./dexbot_class.js').DEXBot} bot
|
|
239
271
|
*/
|
|
240
|
-
declare function setupBlockchainFetchInterval(bot:
|
|
272
|
+
declare function setupBlockchainFetchInterval(bot: BotLike): void;
|
|
241
273
|
/**
|
|
242
274
|
* Stop the periodic blockchain fetch interval.
|
|
243
275
|
* @param {import('./dexbot_class.js').DEXBot} bot
|
|
244
276
|
*/
|
|
245
|
-
declare function stopBlockchainFetchInterval(bot:
|
|
277
|
+
declare function stopBlockchainFetchInterval(bot: BotLike): void;
|
|
246
278
|
/**
|
|
247
279
|
* Set up the periodic bots.json poll interval.
|
|
248
280
|
* Runs in ALL modes (including wrapper-owned monolithic): the tick drives
|
|
@@ -255,12 +287,12 @@ declare function stopBlockchainFetchInterval(bot: any): void;
|
|
|
255
287
|
* (default 1min, shared with the wrapper watchdog interval).
|
|
256
288
|
* @param {import('./dexbot_class.js').DEXBot} bot
|
|
257
289
|
*/
|
|
258
|
-
declare function setupBotsConfigPollInterval(bot:
|
|
290
|
+
declare function setupBotsConfigPollInterval(bot: BotLike): void;
|
|
259
291
|
/**
|
|
260
292
|
* Stop the periodic bots.json fingerprint poll interval.
|
|
261
293
|
* @param {import('./dexbot_class.js').DEXBot} bot
|
|
262
294
|
*/
|
|
263
|
-
declare function stopBotsConfigPollInterval(bot:
|
|
295
|
+
declare function stopBotsConfigPollInterval(bot: BotLike): void;
|
|
264
296
|
/**
|
|
265
297
|
* Release the market adapter runtime for a bot.
|
|
266
298
|
* In PM2 mode this is a no-op; in direct mode it calls the shared runtime's releaseBot.
|
|
@@ -269,7 +301,7 @@ declare function stopBotsConfigPollInterval(bot: any): void;
|
|
|
269
301
|
* @param {string} [context='shutdown'] - Context label for logging
|
|
270
302
|
* @returns {Promise<any>}
|
|
271
303
|
*/
|
|
272
|
-
declare function releaseMarketAdapterRuntime(_bot:
|
|
304
|
+
declare function releaseMarketAdapterRuntime(_bot: unknown, botId: string, context?: string): Promise<any>;
|
|
273
305
|
/**
|
|
274
306
|
* Check if an error message indicates that an order does not exist on the blockchain.
|
|
275
307
|
* Delegates to the canonical implementation in order/utils/order.ts (single source
|
|
@@ -278,7 +310,7 @@ declare function releaseMarketAdapterRuntime(_bot: any, botId: any, context?: an
|
|
|
278
310
|
* @param {string} [orderId] - Optional order ID for context-aware matching
|
|
279
311
|
* @returns {boolean} True if the message indicates a nonexistent order
|
|
280
312
|
*/
|
|
281
|
-
declare function isOrderDoesNotExistError(message:
|
|
313
|
+
declare function isOrderDoesNotExistError(message: unknown, orderId: string): any;
|
|
282
314
|
/**
|
|
283
315
|
* 7a: pre-acquire broadcast deferral for timer-driven lock waiters.
|
|
284
316
|
*
|
|
@@ -297,10 +329,10 @@ declare function isOrderDoesNotExistError(message: any, orderId: any): any;
|
|
|
297
329
|
* manager._broadcastingStartedAt on every holder, so its age stays small;
|
|
298
330
|
* a frozen timestamp ages past BROADCAST_STALE_CLEAR_MS and we let the tick
|
|
299
331
|
* through so maintenance can hard-reset the flag.
|
|
300
|
-
* @param {
|
|
332
|
+
* @param {unknown} bot
|
|
301
333
|
* @returns {boolean} true when the caller should skip this tick
|
|
302
334
|
*/
|
|
303
|
-
declare function shouldDeferMaintenanceForBroadcast(bot:
|
|
335
|
+
declare function shouldDeferMaintenanceForBroadcast(bot: BotLike): boolean;
|
|
304
336
|
/**
|
|
305
337
|
* Observability watchdog for _gridLock hold duration. _gridLock has no
|
|
306
338
|
* acquisition timeout and its callers cannot safely recover from a rejected
|
|
@@ -310,10 +342,10 @@ declare function shouldDeferMaintenanceForBroadcast(bot: any): boolean;
|
|
|
310
342
|
* any such section visible: when the live hold crosses
|
|
311
343
|
* TIMING.GRID_LOCK_HOLD_WARN_MS it emits a rate-limited warn. Called from the
|
|
312
344
|
* maintenance tick so holds outside a broadcast region are observed too.
|
|
313
|
-
* @param {
|
|
345
|
+
* @param {unknown} bot
|
|
314
346
|
* @returns {number} Observed hold duration in ms (0 when not held)
|
|
315
347
|
*/
|
|
316
|
-
declare function checkGridLockHoldDuration(bot:
|
|
348
|
+
declare function checkGridLockHoldDuration(bot: BotLike): number;
|
|
317
349
|
/**
|
|
318
350
|
* Execute the core maintenance logic: recalculate funds, check pipeline,
|
|
319
351
|
* refresh dynamic weights, check grid health, cancel dust orders,
|
|
@@ -322,7 +354,7 @@ declare function checkGridLockHoldDuration(bot: any): number;
|
|
|
322
354
|
* @param {string} context - Context label for logging (e.g. 'periodic', 'dust-timer')
|
|
323
355
|
* @returns {Promise<void>}
|
|
324
356
|
*/
|
|
325
|
-
declare function executeMaintenanceLogic(bot:
|
|
357
|
+
declare function executeMaintenanceLogic(bot: BotLike, context: string): Promise<void>;
|
|
326
358
|
/**
|
|
327
359
|
* Out-of-spread persistence watchdog: the never-run-stale backstop.
|
|
328
360
|
*
|
|
@@ -336,12 +368,12 @@ declare function executeMaintenanceLogic(bot: any, context: any): Promise<void>;
|
|
|
336
368
|
* dedupe concurrent requests; the re-center moves the boundary, which clears
|
|
337
369
|
* any held-plan signature). Resets whenever the spread heals or a correction
|
|
338
370
|
* places orders.
|
|
339
|
-
* @param {
|
|
371
|
+
* @param {unknown} bot
|
|
340
372
|
* @param {boolean} spreadChecked - Whether the spread check ran this tick
|
|
341
373
|
* @param {number} ordersPlaced - Correction orders placed this tick
|
|
342
374
|
* @returns {{staleMs: number, escalated: boolean}}
|
|
343
375
|
*/
|
|
344
|
-
export declare function trackOutOfSpreadStaleness(bot:
|
|
376
|
+
export declare function trackOutOfSpreadStaleness(bot: BotLike, spreadChecked: boolean, ordersPlaced: number): {
|
|
345
377
|
staleMs: number;
|
|
346
378
|
escalated: boolean;
|
|
347
379
|
};
|
|
@@ -356,13 +388,16 @@ export declare function trackOutOfSpreadStaleness(bot: any, spreadChecked: boole
|
|
|
356
388
|
* @param {import('./types.js').Order[]} [options.sell=[]] - Sell-side dust orders
|
|
357
389
|
* @returns {Promise<{cancelledCount: number, batchResult: {aborted: boolean}|null}>}
|
|
358
390
|
*/
|
|
359
|
-
declare function cancelDustOrders(bot:
|
|
391
|
+
declare function cancelDustOrders(bot: BotLike, { buy: buyDust, sell: sellDust }?: {
|
|
392
|
+
buy?: ManagedOrder[];
|
|
393
|
+
sell?: ManagedOrder[];
|
|
394
|
+
}): Promise<{
|
|
360
395
|
cancelledCount: number;
|
|
361
396
|
batchResult: null;
|
|
362
397
|
} | {
|
|
363
398
|
cancelledCount: number;
|
|
364
399
|
batchResult: {
|
|
365
|
-
aborted:
|
|
400
|
+
aborted: boolean | undefined;
|
|
366
401
|
};
|
|
367
402
|
}>;
|
|
368
403
|
/**
|
|
@@ -374,7 +409,7 @@ declare function cancelDustOrders(bot: any, { buy: buyDust, sell: sellDust }?: a
|
|
|
374
409
|
* @param {boolean} [options.skipIdle=false] - Skip idle delay check
|
|
375
410
|
* @returns {Promise<void>}
|
|
376
411
|
*/
|
|
377
|
-
declare function runGridMaintenance(bot:
|
|
412
|
+
declare function runGridMaintenance(bot: BotLike, context?: string, options?: {
|
|
378
413
|
skipIdle?: boolean;
|
|
379
414
|
}): Promise<void>;
|
|
380
415
|
/**
|
|
@@ -384,7 +419,7 @@ declare function runGridMaintenance(bot: any, context?: any, options?: {
|
|
|
384
419
|
* @param {import('./dexbot_class.js').DEXBot} bot
|
|
385
420
|
* @returns {Promise<void>}
|
|
386
421
|
*/
|
|
387
|
-
declare function checkBtsBalanceAndAcquire(bot:
|
|
422
|
+
declare function checkBtsBalanceAndAcquire(bot: BotLike): Promise<void>;
|
|
388
423
|
/**
|
|
389
424
|
* Acquire BTS by swapping one of the trading pair assets through an AMM pool.
|
|
390
425
|
* Tries both assets for a BTS pool, picks the best (lowest price impact).
|
|
@@ -392,17 +427,17 @@ declare function checkBtsBalanceAndAcquire(bot: any): Promise<void>;
|
|
|
392
427
|
* @param {number} deficit - Amount of BTS needed (float)
|
|
393
428
|
* @returns {Promise<void>}
|
|
394
429
|
*/
|
|
395
|
-
declare function acquireBts(bot:
|
|
430
|
+
declare function acquireBts(bot: BotLike, deficit: number): Promise<void>;
|
|
396
431
|
/**
|
|
397
432
|
* Run a single dust health check cycle.
|
|
398
433
|
* @param {import('./dexbot_class.js').DEXBot} bot
|
|
399
434
|
*/
|
|
400
|
-
declare function runDustHealthCheck(bot:
|
|
435
|
+
declare function runDustHealthCheck(bot: BotLike): Promise<void>;
|
|
401
436
|
/**
|
|
402
437
|
* Set up the periodic dust health check interval.
|
|
403
438
|
* @param {import('./dexbot_class.js').DEXBot} bot
|
|
404
439
|
*/
|
|
405
|
-
declare function setupDustHealthCheckInterval(bot:
|
|
440
|
+
declare function setupDustHealthCheckInterval(bot: BotLike): void;
|
|
406
441
|
/**
|
|
407
442
|
* Request a full grid reset from fresh on-chain state.
|
|
408
443
|
* @param {import('./dexbot_class.js').DEXBot} bot
|
|
@@ -410,40 +445,60 @@ declare function setupDustHealthCheckInterval(bot: any): void;
|
|
|
410
445
|
* @param {{refreshCenterPrice?: boolean, skipIdle?: boolean, skipFillLock?: boolean}} [options={}]
|
|
411
446
|
* @returns {Promise<Object>}
|
|
412
447
|
*/
|
|
413
|
-
declare function requestGridReset(bot:
|
|
448
|
+
declare function requestGridReset(bot: BotLike, reason?: string, options?: {
|
|
414
449
|
refreshCenterPrice?: boolean;
|
|
415
450
|
skipIdle?: boolean;
|
|
416
451
|
skipFillLock?: boolean;
|
|
417
|
-
}): Promise<
|
|
452
|
+
}): Promise<boolean | {
|
|
453
|
+
skipped: boolean;
|
|
454
|
+
reason: string;
|
|
455
|
+
}>;
|
|
418
456
|
/**
|
|
419
457
|
* Wire the structural grid resync request handler on the manager.
|
|
420
458
|
* @param {import('./dexbot_class.js').DEXBot} bot
|
|
421
459
|
*/
|
|
422
|
-
declare function wireStructuralGridResyncRequest(bot:
|
|
460
|
+
declare function wireStructuralGridResyncRequest(bot: BotLike): void;
|
|
423
461
|
/**
|
|
424
462
|
* Get current pipeline signal state for congestion checks.
|
|
425
463
|
* @param {import('./dexbot_class.js').DEXBot} bot
|
|
426
464
|
* @returns {Object}
|
|
427
465
|
*/
|
|
428
|
-
declare function getPipelineSignals(bot:
|
|
429
|
-
incomingFillQueueLength:
|
|
430
|
-
shadowLocks:
|
|
466
|
+
declare function getPipelineSignals(bot: BotLike): {
|
|
467
|
+
incomingFillQueueLength: number;
|
|
468
|
+
shadowLocks: number;
|
|
431
469
|
batchInFlight: boolean;
|
|
432
470
|
recoveryInFlight: boolean;
|
|
433
|
-
broadcasting:
|
|
471
|
+
broadcasting: boolean;
|
|
434
472
|
};
|
|
435
473
|
/**
|
|
436
474
|
* Mark that grid activity occurred (updates idle timer).
|
|
437
475
|
* @param {import('./dexbot_class.js').DEXBot} bot
|
|
438
476
|
* @param {string} [reason='activity']
|
|
439
477
|
*/
|
|
440
|
-
declare function markGridActivity(bot:
|
|
478
|
+
declare function markGridActivity(bot: BotLike, reason?: string): void;
|
|
441
479
|
/**
|
|
442
480
|
* Get current metrics for monitoring and debugging.
|
|
443
481
|
* @param {import('./dexbot_class.js').DEXBot} bot
|
|
444
482
|
* @returns {Object}
|
|
445
483
|
*/
|
|
446
|
-
declare function getMetrics(bot:
|
|
484
|
+
declare function getMetrics(bot: BotLike): {
|
|
485
|
+
queueDepth: number;
|
|
486
|
+
fillProcessingLockActive: boolean;
|
|
487
|
+
divergenceLockActive: boolean;
|
|
488
|
+
shadowLocksActive: number;
|
|
489
|
+
recoveryExhaustedAt: number | null;
|
|
490
|
+
recentFillsTracked: number;
|
|
491
|
+
unmatchedChainOrders: number;
|
|
492
|
+
heldChainOrders: number;
|
|
493
|
+
blockingChainOrders: number;
|
|
494
|
+
fillsProcessed: number;
|
|
495
|
+
batchesExecuted: number;
|
|
496
|
+
fillProcessingTimeMs: number;
|
|
497
|
+
lockContentionEvents: number;
|
|
498
|
+
maxQueueDepth: number;
|
|
499
|
+
gridLockContention: number;
|
|
500
|
+
fundRecalcCount: number;
|
|
501
|
+
};
|
|
447
502
|
/**
|
|
448
503
|
* Read open orders from chain, sync with local state, and process any fills found.
|
|
449
504
|
* Self-guarding wrapper: every path here mutates grid state and can broadcast a
|
|
@@ -456,21 +511,21 @@ declare function getMetrics(bot: any): any;
|
|
|
456
511
|
* @param {string} tag - Context label for logging
|
|
457
512
|
* @returns {Promise<Object>}
|
|
458
513
|
*/
|
|
459
|
-
declare function syncOpenOrdersAndProcessFills(bot:
|
|
514
|
+
declare function syncOpenOrdersAndProcessFills(bot: BotLike, tag: string): Promise<{
|
|
460
515
|
syncResult: null;
|
|
461
516
|
aborted: boolean;
|
|
462
517
|
hasUnmatched: number;
|
|
463
518
|
openOrders: null;
|
|
464
519
|
} | {
|
|
465
|
-
syncResult:
|
|
520
|
+
syncResult: import("./types.js").SyncResult;
|
|
466
521
|
aborted: boolean;
|
|
467
|
-
hasUnmatched:
|
|
468
|
-
openOrders:
|
|
522
|
+
hasUnmatched: number;
|
|
523
|
+
openOrders: import("./types.js").ChainOrder[];
|
|
469
524
|
}>;
|
|
470
|
-
export { loadBotsConfigSnapshot, isWrapperAdapterOwner, checkAndApplyBotConfigChanges, buildBotConfigFingerprint, refreshDynamicWeightDistribution, performGridResync, updateBotGridResetMetadata, handlePendingTriggerReset, setupTriggerFileDetection, performPeriodicGridChecks, isOpenOrdersSyncLoopEnabled, startOpenOrdersSyncLoop, stopOpenOrdersSyncLoop, setupBlockchainFetchInterval, stopBlockchainFetchInterval, setupBotsConfigPollInterval, stopBotsConfigPollInterval, executeMaintenanceLogic, getTargetedSyncReason, countLiveReserveOrders, cancelDustOrders, isOrderDoesNotExistError, runGridMaintenance, releaseMarketAdapterRuntime, syncMarketAdapterOnPeriodicConfigCheck, usesAmaGridPrice, runDustHealthCheck, setupDustHealthCheckInterval, requestGridReset, wireStructuralGridResyncRequest, getPipelineSignals, markGridActivity, getMetrics, syncOpenOrdersAndProcessFills, shouldDeferMaintenanceForBroadcast, checkGridLockHoldDuration };
|
|
525
|
+
export { loadBotsConfigSnapshot, isWrapperAdapterOwner, checkAndApplyBotConfigChanges, buildBotConfigFingerprint, refreshDynamicWeightDistribution, performGridResync, updateBotGridResetMetadata, handlePendingTriggerReset, setupTriggerFileDetection, performPeriodicGridChecks, isOpenOrdersSyncLoopEnabled, startOpenOrdersSyncLoop, stopOpenOrdersSyncLoop, setupBlockchainFetchInterval, stopBlockchainFetchInterval, setupBotsConfigPollInterval, stopBotsConfigPollInterval, executeMaintenanceLogic, getTargetedSyncReason, maybeRunTargetedDriftReconciliation, countLiveReserveOrders, cancelDustOrders, isOrderDoesNotExistError, runGridMaintenance, releaseMarketAdapterRuntime, syncMarketAdapterOnPeriodicConfigCheck, usesAmaGridPrice, runDustHealthCheck, setupDustHealthCheckInterval, requestGridReset, wireStructuralGridResyncRequest, getPipelineSignals, markGridActivity, getMetrics, syncOpenOrdersAndProcessFills, shouldDeferMaintenanceForBroadcast, checkGridLockHoldDuration };
|
|
471
526
|
declare const _default: {
|
|
472
527
|
loadBotsConfigSnapshot: typeof loadBotsConfigSnapshot;
|
|
473
|
-
isWrapperAdapterOwner:
|
|
528
|
+
isWrapperAdapterOwner: (...args: unknown[]) => any;
|
|
474
529
|
checkAndApplyBotConfigChanges: typeof checkAndApplyBotConfigChanges;
|
|
475
530
|
buildBotConfigFingerprint: typeof buildBotConfigFingerprint;
|
|
476
531
|
refreshDynamicWeightDistribution: typeof refreshDynamicWeightDistribution;
|
|
@@ -488,6 +543,7 @@ declare const _default: {
|
|
|
488
543
|
stopBotsConfigPollInterval: typeof stopBotsConfigPollInterval;
|
|
489
544
|
executeMaintenanceLogic: typeof executeMaintenanceLogic;
|
|
490
545
|
getTargetedSyncReason: typeof getTargetedSyncReason;
|
|
546
|
+
mirrorSpreadStall: typeof mirrorSpreadStall;
|
|
491
547
|
countLiveReserveOrders: typeof countLiveReserveOrders;
|
|
492
548
|
maybeRunTargetedDriftReconciliation: typeof maybeRunTargetedDriftReconciliation;
|
|
493
549
|
cancelDustOrders: typeof cancelDustOrders;
|