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,28 +1,28 @@
|
|
|
1
|
-
|
|
1
|
+
import type { BotLike } from './types.js';
|
|
2
2
|
/**
|
|
3
3
|
* Initialize the startup state: account orders, manager, persisted data.
|
|
4
4
|
* @param {import('./dexbot_class.js').DEXBot} bot
|
|
5
5
|
* @returns {Promise<Object>} startupState
|
|
6
6
|
*/
|
|
7
|
-
declare function initializeStartupState(bot:
|
|
8
|
-
persistedGrid:
|
|
9
|
-
persistedBtsFeesOwed:
|
|
10
|
-
persistedBoundaryIdx:
|
|
11
|
-
persistedBtsBalance:
|
|
12
|
-
persistedRecentFillKeys:
|
|
13
|
-
persistedGenesis:
|
|
14
|
-
persistedGapEvacStreaks:
|
|
7
|
+
declare function initializeStartupState(bot: BotLike): Promise<{
|
|
8
|
+
persistedGrid: unknown[] | null;
|
|
9
|
+
persistedBtsFeesOwed: unknown;
|
|
10
|
+
persistedBoundaryIdx: number | null;
|
|
11
|
+
persistedBtsBalance: unknown;
|
|
12
|
+
persistedRecentFillKeys: unknown;
|
|
13
|
+
persistedGenesis: {} | null;
|
|
14
|
+
persistedGapEvacStreaks: {} | null;
|
|
15
15
|
}>;
|
|
16
16
|
/**
|
|
17
17
|
* Finish the startup sequence: activate fill listener, reconcile grid, place initial orders.
|
|
18
18
|
* @param {import('./dexbot_class.js').DEXBot} bot
|
|
19
19
|
* @param {Object} startupState
|
|
20
20
|
*/
|
|
21
|
-
declare function finishStartupSequence(bot:
|
|
21
|
+
declare function finishStartupSequence(bot: BotLike, startupState: Awaited<ReturnType<typeof initializeStartupState>>): Promise<void>;
|
|
22
22
|
/**
|
|
23
23
|
* Place initial orders on the blockchain (extracted logic from original placeInitialOrders).
|
|
24
24
|
* @param {import('./dexbot_class.js').DEXBot} bot
|
|
25
25
|
*/
|
|
26
|
-
declare function placeInitialOrdersImpl(bot:
|
|
26
|
+
declare function placeInitialOrdersImpl(bot: BotLike): Promise<void>;
|
|
27
27
|
export { initializeStartupState, finishStartupSequence, placeInitialOrdersImpl };
|
|
28
28
|
//# sourceMappingURL=dexbot_startup_runtime.d.ts.map
|
|
@@ -1,6 +1,5 @@
|
|
|
1
1
|
/** Startup runtime - bot initialization, grid placement, and startup sequence */
|
|
2
|
-
import {
|
|
3
|
-
const require = createRequire(import.meta.url);
|
|
2
|
+
import { lazyShim } from './lazy_shim.js';
|
|
4
3
|
import { path } from './path_api.js';
|
|
5
4
|
import * as chainOrders from './chain_orders.js';
|
|
6
5
|
import { readOpenOrdersGuarded } from './chain_orders.js';
|
|
@@ -16,24 +15,22 @@ import { getErrorMessage } from './utils/errors.js';
|
|
|
16
15
|
import { processSweepOrphanFill } from './dexbot_fill_runtime.js';
|
|
17
16
|
import { ON_MISSING_GENESIS, recordMissingGenesisFault, resolvePersistedGenesis } from './order/genesis_policy.js';
|
|
18
17
|
const { OrderManager, grid: Grid } = orderModule;
|
|
19
|
-
|
|
20
|
-
|
|
21
|
-
|
|
22
|
-
|
|
23
|
-
|
|
24
|
-
|
|
25
|
-
|
|
26
|
-
|
|
27
|
-
|
|
18
|
+
const initializeFeeCache = lazyShim('./order/utils/system', 'initializeFeeCache');
|
|
19
|
+
const parseJsonWithComments = lazyShim('./order/utils/system', 'parseJsonWithComments');
|
|
20
|
+
const withBlockchainRetry = lazyShim('./order/utils/system', 'withBlockchainRetry');
|
|
21
|
+
const buildFillKey = lazyShim('./order/utils/order', 'buildFillKey');
|
|
22
|
+
const correctAllPriceMismatches = lazyShim('./order/utils/order', 'correctAllPriceMismatches');
|
|
23
|
+
const parseChainOrder = lazyShim('./order/utils/order', 'parseChainOrder');
|
|
24
|
+
const restoreGapEvacStreaks = lazyShim('./order/utils/system', 'restoreGapEvacStreaks');
|
|
25
|
+
const applyPersistedPendingCrawls = lazyShim('./order/utils/system', 'applyPersistedPendingCrawls');
|
|
26
|
+
const startupSleep = lazyShim('./order/utils/system', 'sleep');
|
|
28
27
|
const storage = getStorage();
|
|
29
|
-
|
|
30
|
-
|
|
31
|
-
|
|
28
|
+
const attemptResumePersistedGridByPriceMatch = lazyShim('./order/grid_reconcile', 'attemptResumePersistedGridByPriceMatch');
|
|
29
|
+
const decideStartupGridAction = lazyShim('./order/grid_reconcile', 'decideStartupGridAction');
|
|
30
|
+
const reconcileGridOrders = lazyShim('./order/grid_reconcile', 'reconcileGridOrders');
|
|
32
31
|
function botRetryLogger(bot) {
|
|
33
32
|
return { log: (msg) => bot._log(msg) };
|
|
34
33
|
}
|
|
35
|
-
// Test seams: compiled ESM exports cannot be monkey-patched, so tests may
|
|
36
|
-
// substitute grid/reconcile modules and chain reads at the bot level.
|
|
37
34
|
function botGridModule(bot) {
|
|
38
35
|
return (bot._gridModule && typeof bot._gridModule === 'object') ? bot._gridModule : Grid;
|
|
39
36
|
}
|
|
@@ -54,7 +51,7 @@ const PROFILES_BOTS_FILE = PATHS.PROFILES.BOTS_JSON;
|
|
|
54
51
|
* @returns {Promise<Object>} startupState
|
|
55
52
|
*/
|
|
56
53
|
async function initializeStartupState(bot) {
|
|
57
|
-
bot.accountOrders = new AccountOrders({ botKey: bot.config.botKey });
|
|
54
|
+
bot.accountOrders = new AccountOrders({ botKey: bot.config.botKey ?? '' });
|
|
58
55
|
bot._processedFillStore.configure({
|
|
59
56
|
accountOrders: bot.accountOrders
|
|
60
57
|
});
|
|
@@ -112,15 +109,16 @@ async function initializeStartupState(bot) {
|
|
|
112
109
|
if (persistedGrid && persistedGrid.length > 0) {
|
|
113
110
|
let repairCount = 0;
|
|
114
111
|
repairedGrid = persistedGrid.map((order) => {
|
|
115
|
-
|
|
112
|
+
const ord = order;
|
|
113
|
+
if (ord && ord.orderId && ord.orderId === ord.id) {
|
|
116
114
|
repairCount++;
|
|
117
|
-
const repairedOrder = { ...
|
|
115
|
+
const repairedOrder = { ...ord, orderId: '' };
|
|
118
116
|
if (repairedOrder.state === ORDER_STATES.ACTIVE || repairedOrder.state === ORDER_STATES.PARTIAL) {
|
|
119
117
|
repairedOrder.state = ORDER_STATES.VIRTUAL;
|
|
120
118
|
}
|
|
121
119
|
return repairedOrder;
|
|
122
120
|
}
|
|
123
|
-
return
|
|
121
|
+
return ord;
|
|
124
122
|
});
|
|
125
123
|
if (repairCount > 0) {
|
|
126
124
|
bot._log(`[REPAIR] Stripped ${repairCount} fake orderId(s) from persisted grid to restore rebalancing logic.`);
|
|
@@ -157,8 +155,8 @@ async function initializeStartupState(bot) {
|
|
|
157
155
|
* bot down and rethrows. Nothing is cancelled without an operator.
|
|
158
156
|
*
|
|
159
157
|
* @param {import('./dexbot_class.js').DEXBot} bot
|
|
160
|
-
* @param {
|
|
161
|
-
* @param {
|
|
158
|
+
* @param {unknown[]} persistedGrid - Persisted grid array (non-empty).
|
|
159
|
+
* @param {unknown} persistedGenesis - Persisted ladder row (may be null).
|
|
162
160
|
* @returns {{needsRebuild: boolean}}
|
|
163
161
|
*/
|
|
164
162
|
function evaluateStartupGenesisGate(bot, persistedGrid, persistedGenesis) {
|
|
@@ -182,6 +180,27 @@ function evaluateStartupGenesisGate(bot, persistedGrid, persistedGenesis) {
|
|
|
182
180
|
`and reconciles against the live book update-first`, 'warn');
|
|
183
181
|
return { needsRebuild: true };
|
|
184
182
|
}
|
|
183
|
+
/**
|
|
184
|
+
* Wire up the post-bootstrap subsystem intervals and run the startup dust
|
|
185
|
+
* health check. Shared by every startup path so the subsystem list stays in
|
|
186
|
+
* lockstep (add a subsystem once). finishBootstrap() is intentionally left to
|
|
187
|
+
* each caller — the bootstrap/try-finally ordering differs per path.
|
|
188
|
+
* @param {import('./dexbot_class.js').DEXBot} bot
|
|
189
|
+
*/
|
|
190
|
+
async function startPostBootstrapSubsystems(bot) {
|
|
191
|
+
await bot._setupTriggerFileDetection();
|
|
192
|
+
await bot._setupCreditRuntime();
|
|
193
|
+
await bot._refreshAndSyncCreditRuntime();
|
|
194
|
+
await bot._runCreditRuntimeMaintenance('startup');
|
|
195
|
+
bot._setupBlockchainFetchInterval();
|
|
196
|
+
if (typeof bot._setupBotsConfigPollInterval === 'function')
|
|
197
|
+
bot._setupBotsConfigPollInterval();
|
|
198
|
+
bot._setupCreditWatchdogInterval();
|
|
199
|
+
bot._setupCredentialDaemonWatchdogInterval();
|
|
200
|
+
bot._setupDustHealthCheckInterval();
|
|
201
|
+
await bot._runDustHealthCheck();
|
|
202
|
+
bot._log('[DUST] Startup health check complete');
|
|
203
|
+
}
|
|
185
204
|
/**
|
|
186
205
|
* Finish the startup sequence: activate fill listener, reconcile grid, place initial orders.
|
|
187
206
|
* @param {import('./dexbot_class.js').DEXBot} bot
|
|
@@ -248,7 +267,7 @@ async function finishStartupSequence(bot, startupState) {
|
|
|
248
267
|
try {
|
|
249
268
|
await Promise.race([
|
|
250
269
|
workPromise,
|
|
251
|
-
new Promise((
|
|
270
|
+
new Promise((_resolve, reject) => {
|
|
252
271
|
safetyNetTimer = setTimeout(() => reject(new Error(`Safety-net sync exceeded ${safetyNetTimeoutMs}ms cap`)), safetyNetTimeoutMs);
|
|
253
272
|
})
|
|
254
273
|
]);
|
|
@@ -262,7 +281,7 @@ async function finishStartupSequence(bot, startupState) {
|
|
|
262
281
|
bot._log(`Safety-net sync completed despite timeout — ignoring spurious error.`, 'info');
|
|
263
282
|
}
|
|
264
283
|
else {
|
|
265
|
-
bot._warn(`Post-reconnect safety-net sync aborted: ${capErr
|
|
284
|
+
bot._warn(`Post-reconnect safety-net sync aborted: ${getErrorMessage(capErr)}`);
|
|
266
285
|
}
|
|
267
286
|
}
|
|
268
287
|
finally {
|
|
@@ -274,7 +293,7 @@ async function finishStartupSequence(bot, startupState) {
|
|
|
274
293
|
setImmediate(() => {
|
|
275
294
|
runSafetyNetSync().catch((err) => {
|
|
276
295
|
try {
|
|
277
|
-
bot._warn('Post-reconnect safety-net sync failed: ' + (err
|
|
296
|
+
bot._warn('Post-reconnect safety-net sync failed: ' + (getErrorMessage(err)));
|
|
278
297
|
}
|
|
279
298
|
catch (_) {
|
|
280
299
|
}
|
|
@@ -366,8 +385,8 @@ async function finishStartupSequence(bot, startupState) {
|
|
|
366
385
|
await bot.manager.recalculateFunds();
|
|
367
386
|
if (!postResetAborted && !postResetUnmatched) {
|
|
368
387
|
const spreadResult = await bot.manager.checkSpreadCondition(BitShares, bot.updateOrdersOnChainPlan.bind(bot));
|
|
369
|
-
if (spreadResult && spreadResult.ordersPlaced > 0) {
|
|
370
|
-
bot._log(`✓ Spread correction after trigger reset: ${spreadResult.ordersPlaced} order(s) placed`);
|
|
388
|
+
if (spreadResult && (spreadResult.ordersPlaced ?? 0) > 0) {
|
|
389
|
+
bot._log(`✓ Spread correction after trigger reset: ${spreadResult.ordersPlaced ?? 0} order(s) placed`);
|
|
371
390
|
await bot._persistAndRecoverIfNeeded();
|
|
372
391
|
}
|
|
373
392
|
}
|
|
@@ -385,18 +404,7 @@ async function finishStartupSequence(bot, startupState) {
|
|
|
385
404
|
}
|
|
386
405
|
bot._log('Bootstrap phase complete - fill processing resumed', 'info');
|
|
387
406
|
});
|
|
388
|
-
await bot
|
|
389
|
-
await bot._setupCreditRuntime();
|
|
390
|
-
await bot._refreshAndSyncCreditRuntime();
|
|
391
|
-
await bot._runCreditRuntimeMaintenance('startup');
|
|
392
|
-
bot._setupBlockchainFetchInterval();
|
|
393
|
-
if (typeof bot._setupBotsConfigPollInterval === 'function')
|
|
394
|
-
bot._setupBotsConfigPollInterval();
|
|
395
|
-
bot._setupCreditWatchdogInterval();
|
|
396
|
-
bot._setupCredentialDaemonWatchdogInterval();
|
|
397
|
-
bot._setupDustHealthCheckInterval();
|
|
398
|
-
await bot._runDustHealthCheck();
|
|
399
|
-
bot._log('[DUST] Startup health check complete');
|
|
407
|
+
await startPostBootstrapSubsystems(bot);
|
|
400
408
|
bot.manager.finishBootstrap();
|
|
401
409
|
if (bot._isOpenOrdersSyncLoopEnabled()) {
|
|
402
410
|
bot._startOpenOrdersSyncLoop();
|
|
@@ -412,10 +420,11 @@ async function finishStartupSequence(bot, startupState) {
|
|
|
412
420
|
});
|
|
413
421
|
if (bot.config.assetA !== 'BTS' && bot.config.assetB !== 'BTS') {
|
|
414
422
|
if (persistedBtsBalance && typeof persistedBtsBalance === 'object') {
|
|
423
|
+
const bal = persistedBtsBalance;
|
|
415
424
|
bot.manager.btsBalance = {
|
|
416
|
-
free:
|
|
417
|
-
total:
|
|
418
|
-
locked:
|
|
425
|
+
free: bal.free || 0,
|
|
426
|
+
total: bal.total || 0,
|
|
427
|
+
locked: bal.locked || 0
|
|
419
428
|
};
|
|
420
429
|
}
|
|
421
430
|
}
|
|
@@ -534,11 +543,12 @@ async function finishStartupSequence(bot, startupState) {
|
|
|
534
543
|
}
|
|
535
544
|
}
|
|
536
545
|
if (!shouldRegenerate) {
|
|
537
|
-
|
|
546
|
+
const btsFeesOwed = Number(persistedBtsFeesOwed);
|
|
547
|
+
if (btsFeesOwed > 0) {
|
|
538
548
|
await bot.manager._fundLock.acquire(async () => {
|
|
539
|
-
bot.manager.funds.btsFeesOwed =
|
|
549
|
+
bot.manager.funds.btsFeesOwed = btsFeesOwed;
|
|
540
550
|
});
|
|
541
|
-
bot._log(`✓ Restored BTS fees owed: ${Format.formatAmount8(
|
|
551
|
+
bot._log(`✓ Restored BTS fees owed: ${Format.formatAmount8(btsFeesOwed)} BTS`);
|
|
542
552
|
}
|
|
543
553
|
}
|
|
544
554
|
else {
|
|
@@ -702,18 +712,7 @@ async function finishStartupSequence(bot, startupState) {
|
|
|
702
712
|
bot.manager.finishBootstrap();
|
|
703
713
|
}
|
|
704
714
|
});
|
|
705
|
-
await bot
|
|
706
|
-
await bot._setupCreditRuntime();
|
|
707
|
-
await bot._refreshAndSyncCreditRuntime();
|
|
708
|
-
await bot._runCreditRuntimeMaintenance('startup');
|
|
709
|
-
bot._setupBlockchainFetchInterval();
|
|
710
|
-
if (typeof bot._setupBotsConfigPollInterval === 'function')
|
|
711
|
-
bot._setupBotsConfigPollInterval();
|
|
712
|
-
bot._setupCreditWatchdogInterval();
|
|
713
|
-
bot._setupCredentialDaemonWatchdogInterval();
|
|
714
|
-
bot._setupDustHealthCheckInterval();
|
|
715
|
-
await bot._runDustHealthCheck();
|
|
716
|
-
bot._log('[DUST] Startup health check complete');
|
|
715
|
+
await startPostBootstrapSubsystems(bot);
|
|
717
716
|
if (bot._isOpenOrdersSyncLoopEnabled()) {
|
|
718
717
|
bot._startOpenOrdersSyncLoop();
|
|
719
718
|
}
|
|
@@ -1,28 +1,29 @@
|
|
|
1
1
|
/** State recovery runtime - grid persistence, recovery sync, size-drift repair */
|
|
2
|
+
import type { BotLike } from './types.js';
|
|
2
3
|
/**
|
|
3
4
|
* Persist the current grid state and trigger recovery if validation fails.
|
|
4
5
|
* @param {import('./dexbot_class.js').DEXBot} bot
|
|
5
6
|
*/
|
|
6
|
-
declare function persistAndRecoverIfNeeded(bot:
|
|
7
|
+
declare function persistAndRecoverIfNeeded(bot: BotLike): Promise<void>;
|
|
7
8
|
/**
|
|
8
9
|
* Snapshot the recently queued fill keys as a plain object for crash-durable persistence.
|
|
9
10
|
* @param {import('./dexbot_class.js').DEXBot} bot
|
|
10
11
|
* @returns {Record<string, number>}
|
|
11
12
|
*/
|
|
12
|
-
declare function getRecentFillKeysSnapshot(bot:
|
|
13
|
+
declare function getRecentFillKeysSnapshot(bot: BotLike): Record<string, number>;
|
|
13
14
|
/**
|
|
14
15
|
* Trigger a full state recovery sync (fetch chain + sync from open orders + persist).
|
|
15
16
|
* @param {import('./dexbot_class.js').DEXBot} bot
|
|
16
17
|
* @param {string} [reason='state recovery sync']
|
|
17
18
|
*/
|
|
18
|
-
declare function triggerStateRecoverySync(bot:
|
|
19
|
+
declare function triggerStateRecoverySync(bot: BotLike, reason?: string): Promise<void>;
|
|
19
20
|
/**
|
|
20
21
|
* Abort the current flow if an illegal state signal was raised.
|
|
21
22
|
* @param {import('./dexbot_class.js').DEXBot} bot
|
|
22
23
|
* @param {string} flowContext
|
|
23
24
|
* @returns {Promise<boolean>}
|
|
24
25
|
*/
|
|
25
|
-
declare function abortFlowIfIllegalState(bot:
|
|
26
|
+
declare function abortFlowIfIllegalState(bot: BotLike, flowContext: string): Promise<boolean>;
|
|
26
27
|
/**
|
|
27
28
|
* Handle a hard abort from batch processing due to illegal state or accounting failure.
|
|
28
29
|
* @param {import('./dexbot_class.js').DEXBot} bot
|
|
@@ -31,7 +32,7 @@ declare function abortFlowIfIllegalState(bot: any, flowContext: any): Promise<bo
|
|
|
31
32
|
* @param {number} [opsCount=0]
|
|
32
33
|
* @returns {Promise<Object|null>}
|
|
33
34
|
*/
|
|
34
|
-
declare function handleBatchHardAbort(bot:
|
|
35
|
+
declare function handleBatchHardAbort(bot: BotLike, err: unknown, phase?: string, opsCount?: number): Promise<{
|
|
35
36
|
abortedForAccountingFailure: boolean;
|
|
36
37
|
executed: boolean;
|
|
37
38
|
hadRotation: boolean;
|
|
@@ -47,7 +48,7 @@ declare function handleBatchHardAbort(bot: any, err: any, phase?: any, opsCount?
|
|
|
47
48
|
* @param {string} [context='recoverable-grid-update']
|
|
48
49
|
* @returns {Promise<number>}
|
|
49
50
|
*/
|
|
50
|
-
declare function applyRecoverableGridUpdates(bot:
|
|
51
|
+
declare function applyRecoverableGridUpdates(bot: BotLike, updates: unknown[], context?: string): Promise<number>;
|
|
51
52
|
/**
|
|
52
53
|
* Recover from explicit stale order errors by virtualizing affected grid slots.
|
|
53
54
|
* @param {import('./dexbot_class.js').DEXBot} bot
|
|
@@ -55,7 +56,7 @@ declare function applyRecoverableGridUpdates(bot: any, updates: any, context?: a
|
|
|
55
56
|
* @param {string} [reason='stale order cleanup']
|
|
56
57
|
* @returns {Promise<Object>}
|
|
57
58
|
*/
|
|
58
|
-
declare function recoverExplicitStaleOrders(bot:
|
|
59
|
+
declare function recoverExplicitStaleOrders(bot: BotLike, staleOrderIds: unknown, reason?: string): Promise<{
|
|
59
60
|
executed: boolean;
|
|
60
61
|
hadRotation: boolean;
|
|
61
62
|
stale: boolean;
|
|
@@ -73,7 +74,7 @@ declare function recoverExplicitStaleOrders(bot: any, staleOrderIds: any, reason
|
|
|
73
74
|
* @param {Array<Object>} [opContexts=[]]
|
|
74
75
|
* @returns {Promise<Object>}
|
|
75
76
|
*/
|
|
76
|
-
declare function recoverBatchSizeDrift(bot:
|
|
77
|
+
declare function recoverBatchSizeDrift(bot: BotLike, err: unknown, opContexts?: unknown): Promise<{
|
|
77
78
|
executed: boolean;
|
|
78
79
|
hadRotation: boolean;
|
|
79
80
|
recoveredBySync: boolean;
|
|
@@ -84,7 +85,7 @@ declare function recoverBatchSizeDrift(bot: any, err: any, opContexts?: any): Pr
|
|
|
84
85
|
* @param {import('./dexbot_class.js').DEXBot} bot
|
|
85
86
|
* @returns {Promise<{success: boolean, reason?: string}>}
|
|
86
87
|
*/
|
|
87
|
-
declare function recoverFromPersistedGrid(bot:
|
|
88
|
+
declare function recoverFromPersistedGrid(bot: BotLike): Promise<{
|
|
88
89
|
success: boolean;
|
|
89
90
|
reason: string;
|
|
90
91
|
halt?: undefined;
|
|
@@ -110,20 +111,20 @@ declare function recoverFromPersistedGrid(bot: any): Promise<{
|
|
|
110
111
|
* @param {import('./dexbot_class.js').DEXBot} bot
|
|
111
112
|
* @param {string} context - Label for logging
|
|
112
113
|
*/
|
|
113
|
-
declare function _schedulePostRecoveryRebalance(bot:
|
|
114
|
+
declare function _schedulePostRecoveryRebalance(bot: BotLike, context: string): void;
|
|
114
115
|
/**
|
|
115
116
|
* Reject a corrupted grid snapshot when catastrophic fund drift is detected.
|
|
116
117
|
* @param {import('./dexbot_class.js').DEXBot} bot
|
|
117
118
|
* @param {'startup'|'recovery'} context
|
|
118
119
|
* @returns {Promise<boolean>}
|
|
119
120
|
*/
|
|
120
|
-
declare function rejectCorruptedGridSnapshot(bot:
|
|
121
|
+
declare function rejectCorruptedGridSnapshot(bot: BotLike, context: string): Promise<boolean>;
|
|
121
122
|
/**
|
|
122
123
|
* Attempt to repair size-drift for specific order IDs from chain state.
|
|
123
124
|
* @param {import('./dexbot_class.js').DEXBot} bot
|
|
124
125
|
* @param {string[]} orderIds
|
|
125
126
|
* @returns {Promise<boolean>}
|
|
126
127
|
*/
|
|
127
|
-
declare function targetedOrderRepair(bot:
|
|
128
|
+
declare function targetedOrderRepair(bot: BotLike, orderIds: string[]): Promise<boolean>;
|
|
128
129
|
export { persistAndRecoverIfNeeded, getRecentFillKeysSnapshot, triggerStateRecoverySync, abortFlowIfIllegalState, handleBatchHardAbort, applyRecoverableGridUpdates, recoverExplicitStaleOrders, recoverBatchSizeDrift, recoverFromPersistedGrid, rejectCorruptedGridSnapshot, targetedOrderRepair, _schedulePostRecoveryRebalance as schedulePostRecoveryRebalance };
|
|
129
130
|
//# sourceMappingURL=dexbot_state_recovery.d.ts.map
|
|
@@ -323,7 +323,7 @@ async function recoverFromPersistedGrid(bot) {
|
|
|
323
323
|
return { success: false, reason: `persisted boundary rejected (${check.reason})` };
|
|
324
324
|
}
|
|
325
325
|
}
|
|
326
|
-
const persistedGenesis = bot.accountOrders.loadGenesis?.(true) ?? null;
|
|
326
|
+
const persistedGenesis = (bot.accountOrders.loadGenesis?.(true) ?? null);
|
|
327
327
|
await grid.loadGrid(bot.manager, persistedGrid, boundaryIdx, persistedGenesis, { tolerateTransientStranding });
|
|
328
328
|
// Restart resilience: same pruning rules as the startup path — streaks
|
|
329
329
|
// only survive for slots that still exist in the reloaded grid.
|
|
@@ -379,18 +379,19 @@ async function recoverFromPersistedGrid(bot) {
|
|
|
379
379
|
// path (adoptPlacedBatchFromChain reads by id immediately after
|
|
380
380
|
// broadcast). When no known ids are available, still defer.
|
|
381
381
|
const knownIds = (persistedGrid || [])
|
|
382
|
-
.map((s) => s
|
|
382
|
+
.map((s) => s?.orderId)
|
|
383
383
|
.filter((id) => id && /^1\.7\.\d+$/.test(String(id)));
|
|
384
384
|
let recoveredById = null;
|
|
385
385
|
if (knownIds.length > 0 && typeof chainOrders.batchReadOrders === 'function') {
|
|
386
386
|
try {
|
|
387
|
-
const map = await chainOrders.batchReadOrders(knownIds);
|
|
387
|
+
const map = await Promise.resolve(chainOrders.batchReadOrders(knownIds));
|
|
388
388
|
const byId = [];
|
|
389
389
|
if (map && typeof map.forEach === 'function') {
|
|
390
390
|
map.forEach((o) => { if (o)
|
|
391
391
|
byId.push(o); });
|
|
392
392
|
}
|
|
393
393
|
recoveredById = byId;
|
|
394
|
+
recoveredById = byId;
|
|
394
395
|
}
|
|
395
396
|
catch (byIdErr) {
|
|
396
397
|
bot.manager.logger.log(`[RECOVERY] ID-based fallback read failed: ${getErrorMessage(byIdErr)}`, 'warn');
|
|
@@ -404,6 +405,9 @@ async function recoverFromPersistedGrid(bot) {
|
|
|
404
405
|
return { success: false, reason: 'truncated open-order read; full grid reload deferred' };
|
|
405
406
|
}
|
|
406
407
|
}
|
|
408
|
+
if (chainOpenOrders === null) {
|
|
409
|
+
return { success: false, reason: 'truncated open-order read; full grid reload deferred' };
|
|
410
|
+
}
|
|
407
411
|
if (chainOpenOrders.length > 0 && bot.manager?.syncFromOpenOrders) {
|
|
408
412
|
await bot.manager.syncFromOpenOrders(chainOpenOrders, {
|
|
409
413
|
skipAccounting: true,
|
|
@@ -439,7 +443,7 @@ async function recoverFromPersistedGrid(bot) {
|
|
|
439
443
|
}
|
|
440
444
|
const ordersArr = Array.from(bot.manager.orders.values());
|
|
441
445
|
const bloatPostRecovery = isGridBloated(bot.manager, ordersArr);
|
|
442
|
-
if (bloatPostRecovery.bloated) {
|
|
446
|
+
if (bloatPostRecovery.bloated && bloatPostRecovery.details) {
|
|
443
447
|
const d = bloatPostRecovery.details;
|
|
444
448
|
bot.manager.logger.log(`[RECOVERY] Persisted grid reloaded but still bloated ` +
|
|
445
449
|
`(${d.gridSize} slots, max ${d.maxAllowed}). Rejecting — full grid reset required.`, 'warn');
|
|
@@ -520,7 +524,7 @@ async function _rebalanceAfterRecovery(bot, context) {
|
|
|
520
524
|
bot.manager?._popWorkingGridRef?.(rebalanceResult);
|
|
521
525
|
return;
|
|
522
526
|
}
|
|
523
|
-
bot.manager.logger?.log?.(`[RECOVERY] Re-placing ${rebalanceResult.actions.length} missing rail(s) after ${context}`, 'info');
|
|
527
|
+
bot.manager.logger?.log?.(`[RECOVERY] Re-placing ${(rebalanceResult.actions ?? []).length} missing rail(s) after ${context}`, 'info');
|
|
524
528
|
await bot.updateOrdersOnChainBatch(rebalanceResult);
|
|
525
529
|
}
|
|
526
530
|
catch (err) {
|
|
@@ -584,7 +588,7 @@ async function rejectCorruptedGridSnapshot(bot, context) {
|
|
|
584
588
|
return false;
|
|
585
589
|
const tag = context === 'recovery' ? '[RECOVERY][SNAPSHOT-REJECT]' : '[SNAPSHOT-REJECT]';
|
|
586
590
|
bot._warn(`${tag} Corrupted grid snapshot detected: ` +
|
|
587
|
-
`drift sell=${driftCheck.driftSell.toFixed(2)} buy=${driftCheck.driftBuy.toFixed(2)}. ` +
|
|
591
|
+
`drift sell=${Number(driftCheck.driftSell ?? 0).toFixed(2)} buy=${Number(driftCheck.driftBuy ?? 0).toFixed(2)}. ` +
|
|
588
592
|
`Deleting corrupted snapshot.`);
|
|
589
593
|
if (bot.accountOrders && typeof bot.accountOrders.clearGrid === 'function') {
|
|
590
594
|
try {
|
|
@@ -592,30 +596,31 @@ async function rejectCorruptedGridSnapshot(bot, context) {
|
|
|
592
596
|
bot._warn(`${tag} Corrupted grid snapshot deleted.`);
|
|
593
597
|
}
|
|
594
598
|
catch (clearErr) {
|
|
595
|
-
bot._warn(`${tag} Failed to delete corrupted snapshot: ${clearErr
|
|
599
|
+
bot._warn(`${tag} Failed to delete corrupted snapshot: ${getErrorMessage(clearErr)}`);
|
|
596
600
|
}
|
|
597
601
|
}
|
|
598
602
|
// P4: clear in-memory boundary together with snapshot so a stale
|
|
599
603
|
// restored value (e.g. 131 in the incident) is not reused for rebuild.
|
|
600
604
|
// clearGrid() already wiped persisted boundaryIdx; also clear manager
|
|
601
605
|
// state so P3 re-derivation starts from a clean null boundary.
|
|
606
|
+
const mgrRecovery = bot.manager;
|
|
602
607
|
try {
|
|
603
|
-
|
|
608
|
+
mgrRecovery._restoreBoundary?.(null);
|
|
604
609
|
}
|
|
605
610
|
catch { }
|
|
606
|
-
|
|
611
|
+
mgrRecovery.boundaryIdx = null;
|
|
607
612
|
// Owed crawls belonged to the rejected generation: the rebuild re-anchors
|
|
608
613
|
// the boundary absolutely, so applying their relative deltas would
|
|
609
614
|
// double-count the movement the new anchor already contains. clearGrid()
|
|
610
615
|
// wiped the persisted copy; drop the in-memory record (marks the grid
|
|
611
616
|
// dirty so the wipe reaches disk on the next flush too).
|
|
612
|
-
|
|
617
|
+
mgrRecovery._clearPendingFillCrawls?.('grid snapshot rejected');
|
|
613
618
|
// The LAST-FILL-GUARD pivot was armed against the rejected generation's
|
|
614
619
|
// geometry: drop it so the rebuild re-arms on a fresh fill instead of
|
|
615
620
|
// vetoing placements against a boundary that no longer exists.
|
|
616
621
|
try {
|
|
617
|
-
if (typeof
|
|
618
|
-
|
|
622
|
+
if (typeof mgrRecovery._resetLastFillPivot === 'function') {
|
|
623
|
+
mgrRecovery._resetLastFillPivot('grid snapshot rejected');
|
|
619
624
|
}
|
|
620
625
|
else {
|
|
621
626
|
resetLastFillPivot(bot.manager, 'grid snapshot rejected');
|
|
@@ -669,7 +674,7 @@ async function targetedOrderRepair(bot, orderIds) {
|
|
|
669
674
|
return true;
|
|
670
675
|
}
|
|
671
676
|
catch (err) {
|
|
672
|
-
bot.manager.logger.log(`[COW] Targeted order repair failed: ${err
|
|
677
|
+
bot.manager.logger.log(`[COW] Targeted order repair failed: ${getErrorMessage(err)}`, 'debug');
|
|
673
678
|
return false;
|
|
674
679
|
}
|
|
675
680
|
}
|
|
@@ -1,3 +1,5 @@
|
|
|
1
|
+
/** Allocation value stored in the registry: a decimal number or a percentage string. */
|
|
2
|
+
type PercentageValue = number | string;
|
|
1
3
|
/**
|
|
2
4
|
* Register a bot's allocation on an account for a given side.
|
|
3
5
|
* Called during bot startup.
|
|
@@ -6,7 +8,7 @@
|
|
|
6
8
|
* @param {'buy'|'sell'} side - Trade side
|
|
7
9
|
* @param {number|string} percentage - Percentage value (e.g., 1.0 or '100%')
|
|
8
10
|
*/
|
|
9
|
-
declare function registerAllocation(account: string, botName: string, side: 'buy' | 'sell', percentage:
|
|
11
|
+
declare function registerAllocation(account: string, botName: string, side: 'buy' | 'sell', percentage: PercentageValue): Promise<void>;
|
|
10
12
|
/**
|
|
11
13
|
* Register a credit bot's collateral allocation on an account for a given collateral asset.
|
|
12
14
|
* Called during bot startup for bots with debtPolicy.lending entries.
|
|
@@ -15,7 +17,7 @@ declare function registerAllocation(account: string, botName: string, side: 'buy
|
|
|
15
17
|
* @param {string} collateralAssetId - Canonical collateral asset ID (e.g., '1.3.0')
|
|
16
18
|
* @param {number|string} percentage - Percentage value (e.g., 1.0 or '100%')
|
|
17
19
|
*/
|
|
18
|
-
declare function registerCollateralAllocation(account: string, botName: string, collateralAssetId: string, percentage:
|
|
20
|
+
declare function registerCollateralAllocation(account: string, botName: string, collateralAssetId: string, percentage: PercentageValue): Promise<void>;
|
|
19
21
|
/**
|
|
20
22
|
* Get the effective collateral allocation for a credit bot on a given account/collateral asset.
|
|
21
23
|
* Returns chainTotal * (myPercent / sum(allPercentages)).
|
|
@@ -1,3 +1,4 @@
|
|
|
1
|
+
import { getErrorMessage } from './utils/errors.js';
|
|
1
2
|
import { createRequire } from 'node:module';
|
|
2
3
|
const require = createRequire(import.meta.url);
|
|
3
4
|
import { getStorage } from './storage/index.js';
|
|
@@ -36,22 +37,21 @@ function _loadRegistry() {
|
|
|
36
37
|
}
|
|
37
38
|
if (_registry !== null)
|
|
38
39
|
return _registry;
|
|
40
|
+
let loaded;
|
|
39
41
|
try {
|
|
40
|
-
|
|
41
|
-
|
|
42
|
-
|
|
43
|
-
else {
|
|
44
|
-
_registry = {};
|
|
45
|
-
}
|
|
42
|
+
loaded = storage.exists(REGISTRY_FILE)
|
|
43
|
+
? readJSON(REGISTRY_FILE)
|
|
44
|
+
: {};
|
|
46
45
|
}
|
|
47
46
|
catch (err) {
|
|
48
|
-
console.error(`[fund_registry] Failed to load ${REGISTRY_FILE} (${err
|
|
47
|
+
console.error(`[fund_registry] Failed to load ${REGISTRY_FILE} (${getErrorMessage(err)}); ` +
|
|
49
48
|
`resetting to an empty registry — previously registered bot allocations are unavailable ` +
|
|
50
49
|
`and will be overwritten on the next save. Restore the file from backup before restarting other bots.`);
|
|
51
|
-
|
|
50
|
+
loaded = {};
|
|
52
51
|
}
|
|
52
|
+
_registry = loaded;
|
|
53
53
|
_registryMtimeMs = _statMtimeMs(REGISTRY_FILE);
|
|
54
|
-
return
|
|
54
|
+
return loaded;
|
|
55
55
|
}
|
|
56
56
|
function _saveRegistry() {
|
|
57
57
|
writeJSON(REGISTRY_FILE, _registry);
|
|
@@ -225,7 +225,7 @@ async function releaseAllocation(account, botName) {
|
|
|
225
225
|
}
|
|
226
226
|
}
|
|
227
227
|
}
|
|
228
|
-
else {
|
|
228
|
+
else if (side === 'buy' || side === 'sell') {
|
|
229
229
|
const pct = _parsePercentage(acc.bots[botName][side]);
|
|
230
230
|
acc.totalAllocatedPct[side] = Math.max(0, (acc.totalAllocatedPct[side] || 0) - pct);
|
|
231
231
|
}
|
|
@@ -4,7 +4,33 @@
|
|
|
4
4
|
* Centralized management for application-wide settings stored in profiles/general.settings.json.
|
|
5
5
|
* Provides read/write operations with fallback handling.
|
|
6
6
|
*/
|
|
7
|
+
import type { UnknownRecord } from './types.js';
|
|
7
8
|
declare const SETTINGS_FILE: string;
|
|
9
|
+
/**
|
|
10
|
+
* The on-disk general settings document. Open-ended (dynamic top-level
|
|
11
|
+
* sections) but `NODES` is typed because several callers read it directly.
|
|
12
|
+
*/
|
|
13
|
+
interface GeneralSettingsDocument {
|
|
14
|
+
NODES?: {
|
|
15
|
+
enabled?: boolean;
|
|
16
|
+
list?: string[];
|
|
17
|
+
healthCheck?: {
|
|
18
|
+
enabled?: boolean;
|
|
19
|
+
intervalMs?: number;
|
|
20
|
+
timeoutMs?: number;
|
|
21
|
+
maxPingMs?: number;
|
|
22
|
+
blacklistThreshold?: number;
|
|
23
|
+
[key: string]: unknown;
|
|
24
|
+
};
|
|
25
|
+
selection?: {
|
|
26
|
+
strategy?: string;
|
|
27
|
+
preferredNode?: string | null;
|
|
28
|
+
[key: string]: unknown;
|
|
29
|
+
};
|
|
30
|
+
[key: string]: unknown;
|
|
31
|
+
};
|
|
32
|
+
[key: string]: unknown;
|
|
33
|
+
}
|
|
8
34
|
/**
|
|
9
35
|
* Read general application settings from file.
|
|
10
36
|
* Returns fallback if file missing, empty, or parse fails.
|
|
@@ -15,9 +41,9 @@ declare const SETTINGS_FILE: string;
|
|
|
15
41
|
* @returns {Object|*} Parsed settings object or fallback value
|
|
16
42
|
*/
|
|
17
43
|
declare function readGeneralSettings({ fallback, onError }?: {
|
|
18
|
-
fallback?:
|
|
19
|
-
onError?: ((err:
|
|
20
|
-
}):
|
|
44
|
+
fallback?: GeneralSettingsDocument | null;
|
|
45
|
+
onError?: ((err: unknown, filePath: string) => void) | null;
|
|
46
|
+
}): GeneralSettingsDocument | null;
|
|
21
47
|
/**
|
|
22
48
|
* Write general application settings to file.
|
|
23
49
|
* Creates profiles directory if it doesn't exist.
|
|
@@ -26,6 +52,6 @@ declare function readGeneralSettings({ fallback, onError }?: {
|
|
|
26
52
|
* @param {Object} settings - Settings object to write
|
|
27
53
|
* @throws {Error} If write operation fails
|
|
28
54
|
*/
|
|
29
|
-
declare function writeGeneralSettings(settings:
|
|
55
|
+
declare function writeGeneralSettings(settings: UnknownRecord): void;
|
|
30
56
|
export { SETTINGS_FILE, readGeneralSettings, writeGeneralSettings };
|
|
31
57
|
//# sourceMappingURL=general_settings.d.ts.map
|
|
@@ -69,14 +69,14 @@
|
|
|
69
69
|
* @param {string} name - Description used in shutdown logs
|
|
70
70
|
* @param {Function} wipeFn - Synchronous function to execute last
|
|
71
71
|
*/
|
|
72
|
-
declare function registerExitWipe(name:
|
|
72
|
+
declare function registerExitWipe(name: string, wipeFn: () => void): void;
|
|
73
73
|
/**
|
|
74
74
|
* Register a cleanup function to be called on graceful shutdown
|
|
75
75
|
* Functions are called in LIFO order (last registered = first called)
|
|
76
76
|
* @param {string} name - Name of the cleanup operation (for logging)
|
|
77
77
|
* @param {Function} handler - Async or sync function to call on shutdown
|
|
78
78
|
*/
|
|
79
|
-
declare function registerCleanup(name:
|
|
79
|
+
declare function registerCleanup(name: string, handler: () => unknown): void;
|
|
80
80
|
/**
|
|
81
81
|
* Remove a previously registered cleanup function.
|
|
82
82
|
* Use this when a component fails to initialize and its cleanup must not run
|
|
@@ -84,7 +84,7 @@ declare function registerCleanup(name: any, handler: any): void;
|
|
|
84
84
|
* @param {string|Function} nameOrHandler - Cleanup name or handler reference
|
|
85
85
|
* @returns {boolean} True when a handler was found and removed
|
|
86
86
|
*/
|
|
87
|
-
declare function unregisterCleanup(nameOrHandler:
|
|
87
|
+
declare function unregisterCleanup(nameOrHandler: string | (() => unknown)): boolean;
|
|
88
88
|
/**
|
|
89
89
|
* Setup signal handlers for graceful shutdown
|
|
90
90
|
* Should be called once at process startup
|