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
|
@@ -37,8 +37,6 @@ export const DRAFT_SEED_ORDER = [
|
|
|
37
37
|
'active', 'dryRun', 'minPrice', 'maxPrice', 'incrementPercent',
|
|
38
38
|
'targetSpreadPercent', 'startPrice', 'gridPrice',
|
|
39
39
|
];
|
|
40
|
-
/** Fields with no meaning since the grid-price offset was removed; stripped from drafts. */
|
|
41
|
-
export const LEGACY_DRAFT_KEYS = ['gridPriceOffsetPct', 'gridPriceOffsetClampToBounds'];
|
|
42
40
|
/**
|
|
43
41
|
* Spellings that mean "no explicit grid price" — delegate to startPrice.
|
|
44
42
|
* `none`/`null`/`start`/`startprice` are the editor's documented aliases;
|
|
@@ -46,7 +44,7 @@ export const LEGACY_DRAFT_KEYS = ['gridPriceOffsetPct', 'gridPriceOffsetClampToB
|
|
|
46
44
|
* elsewhere in the editor, `s` is shorthand for `startPrice`, and the boolean
|
|
47
45
|
* `false` covers a hand-edited `gridPrice: false`.
|
|
48
46
|
*/
|
|
49
|
-
|
|
47
|
+
const GRID_PRICE_UNSET_INPUTS = new Set(['none', 'null', 'start', 'startprice', 's', 'n', 'no', 'false', '0', 'f']);
|
|
50
48
|
/**
|
|
51
49
|
* True when a grid-price value carries no reference and must degrade to the
|
|
52
50
|
* startPrice fallback. Keeps `null`/`undefined`/`false`, empty/whitespace
|
|
@@ -123,8 +121,6 @@ export function seedBotDraft(base, options = {}) {
|
|
|
123
121
|
data[key] = def;
|
|
124
122
|
}
|
|
125
123
|
}
|
|
126
|
-
for (const key of LEGACY_DRAFT_KEYS)
|
|
127
|
-
delete data[key];
|
|
128
124
|
return data;
|
|
129
125
|
}
|
|
130
126
|
/**
|
|
@@ -1,21 +1,55 @@
|
|
|
1
|
+
import type { UnknownRecord } from './types.js';
|
|
2
|
+
/** A single `debtPolicy.lending[]` entry (loosely typed: validated at runtime). */
|
|
3
|
+
export interface BotLendingEntry extends UnknownRecord {
|
|
4
|
+
asset?: unknown;
|
|
5
|
+
collateralAsset?: unknown;
|
|
6
|
+
type?: unknown;
|
|
7
|
+
}
|
|
8
|
+
/** `debtPolicy` block of a bot entry. */
|
|
9
|
+
interface BotDebtPolicy extends UnknownRecord {
|
|
10
|
+
lending?: BotLendingEntry[];
|
|
11
|
+
maxCollateralAmount?: unknown;
|
|
12
|
+
}
|
|
13
|
+
/** A loosely-typed bot entry as read from bots.json / user input. */
|
|
14
|
+
export interface BotEntry extends UnknownRecord {
|
|
15
|
+
name?: string;
|
|
16
|
+
active?: boolean;
|
|
17
|
+
creditOnly?: boolean;
|
|
18
|
+
assetA?: string;
|
|
19
|
+
assetB?: string;
|
|
20
|
+
botKey?: string;
|
|
21
|
+
botIndex?: number;
|
|
22
|
+
preferredAccount?: string;
|
|
23
|
+
activeOrders?: UnknownRecord;
|
|
24
|
+
reserveOrders?: number | UnknownRecord;
|
|
25
|
+
botFunds?: {
|
|
26
|
+
buy?: unknown;
|
|
27
|
+
sell?: unknown;
|
|
28
|
+
};
|
|
29
|
+
debtPolicy?: BotDebtPolicy;
|
|
30
|
+
}
|
|
31
|
+
/** The top-level bots.json document. */
|
|
32
|
+
export interface BotSettingsFile extends UnknownRecord {
|
|
33
|
+
bots?: BotEntry[];
|
|
34
|
+
}
|
|
1
35
|
declare function loadSettingsFile(filePath: string, { silent, exitOnError }?: {
|
|
2
36
|
silent?: boolean;
|
|
3
37
|
exitOnError?: boolean;
|
|
4
38
|
}): {
|
|
5
|
-
config:
|
|
39
|
+
config: BotSettingsFile;
|
|
6
40
|
filePath: string;
|
|
7
41
|
};
|
|
8
|
-
declare function saveSettingsFile(config:
|
|
9
|
-
declare function resolveRawBotEntries(settings:
|
|
10
|
-
declare function normalizeBotEntry(entry:
|
|
11
|
-
declare function normalizeBotEntries(rawEntries:
|
|
12
|
-
declare function selectBotEntry(settings:
|
|
13
|
-
declare function selectActiveBotEntries(settings:
|
|
14
|
-
declare function validateBotEntry(b:
|
|
15
|
-
declare function collectValidationIssues(entries:
|
|
42
|
+
declare function saveSettingsFile(config: UnknownRecord, filePath: string): void;
|
|
43
|
+
declare function resolveRawBotEntries(settings: unknown): BotEntry[];
|
|
44
|
+
declare function normalizeBotEntry(entry: BotEntry, index?: number): BotEntry;
|
|
45
|
+
declare function normalizeBotEntries(rawEntries: unknown[]): BotEntry[];
|
|
46
|
+
declare function selectBotEntry(settings: unknown, botName: string): BotEntry | null;
|
|
47
|
+
declare function selectActiveBotEntries(settings: unknown): BotEntry[];
|
|
48
|
+
declare function validateBotEntry(b: BotEntry, i: number, src: string): string | null;
|
|
49
|
+
declare function collectValidationIssues(entries: BotEntry[], sourceName: string): {
|
|
16
50
|
errors: string[];
|
|
17
51
|
warnings: string[];
|
|
18
52
|
};
|
|
19
|
-
declare function assertNoDuplicateBotKeys(entries:
|
|
53
|
+
declare function assertNoDuplicateBotKeys(entries: BotEntry[], sourceName: string): void;
|
|
20
54
|
export { assertNoDuplicateBotKeys, collectValidationIssues, loadSettingsFile, normalizeBotEntry, normalizeBotEntries, resolveRawBotEntries, saveSettingsFile, selectActiveBotEntries, selectBotEntry, validateBotEntry };
|
|
21
55
|
//# sourceMappingURL=bot_settings.d.ts.map
|
|
@@ -8,6 +8,7 @@ import { isPositiveNumber, isPositiveNumberOrPercent, toDecimal } from './order/
|
|
|
8
8
|
import { resolveMinCollateralIncreaseThreshold } from './cr_planner.js';
|
|
9
9
|
import { getErrorMessage } from './utils/errors.js';
|
|
10
10
|
import { canonicalizeBotAssetSymbols } from './utils/asset_symbols.js';
|
|
11
|
+
import { isUnknownRecord } from './types.js';
|
|
11
12
|
const storage = getStorage();
|
|
12
13
|
const { writeJSON } = storage;
|
|
13
14
|
function loadSettingsFile(filePath, { silent = false, exitOnError = true } = {}) {
|
|
@@ -41,7 +42,7 @@ function saveSettingsFile(config, filePath) {
|
|
|
41
42
|
}
|
|
42
43
|
}
|
|
43
44
|
function resolveRawBotEntries(settings) {
|
|
44
|
-
if (!settings
|
|
45
|
+
if (!isUnknownRecord(settings))
|
|
45
46
|
return [];
|
|
46
47
|
if (Array.isArray(settings.bots))
|
|
47
48
|
return settings.bots;
|
|
@@ -110,7 +111,8 @@ function validateBotEntry(b, i, src) {
|
|
|
110
111
|
}
|
|
111
112
|
else {
|
|
112
113
|
for (const side of ['buy', 'sell']) {
|
|
113
|
-
const
|
|
114
|
+
const reserveOrders = b.reserveOrders;
|
|
115
|
+
const v = reserveOrders[side];
|
|
114
116
|
if (v !== undefined && (!Number.isInteger(Number(v)) || Number(v) < 0))
|
|
115
117
|
problems.push(`'reserveOrders.${side}' must be a non-negative integer`);
|
|
116
118
|
}
|
|
@@ -147,7 +149,7 @@ function validateBotEntry(b, i, src) {
|
|
|
147
149
|
if (!item.asset || typeof item.asset !== 'string') {
|
|
148
150
|
problems.push(`debtPolicy.lending[${idx}].asset must be a non-empty string`);
|
|
149
151
|
}
|
|
150
|
-
if (!['mpa', 'creditOffer'].includes(item.type)) {
|
|
152
|
+
if (!['mpa', 'creditOffer'].includes(String(item.type))) {
|
|
151
153
|
problems.push(`debtPolicy.lending[${idx}].type must be 'mpa' or 'creditOffer'`);
|
|
152
154
|
}
|
|
153
155
|
// outputWeight: canonical field (deprecated 'ratio' alias removed)
|
|
@@ -156,7 +158,7 @@ function validateBotEntry(b, i, src) {
|
|
|
156
158
|
}
|
|
157
159
|
if ('outputWeight' in item) {
|
|
158
160
|
const weightVal = item.outputWeight;
|
|
159
|
-
if (!Number.isFinite(weightVal) || weightVal < 0) {
|
|
161
|
+
if (typeof weightVal !== 'number' || !Number.isFinite(weightVal) || weightVal < 0) {
|
|
160
162
|
problems.push(`debtPolicy.lending[${idx}].outputWeight must be a non-negative number`);
|
|
161
163
|
}
|
|
162
164
|
}
|
|
@@ -285,12 +287,13 @@ function collectValidationIssues(entries, sourceName) {
|
|
|
285
287
|
// Cross-bot validation: check if botFunds percentages sum > 100% per account
|
|
286
288
|
const accountFunds = {};
|
|
287
289
|
for (const entry of entries) {
|
|
288
|
-
|
|
290
|
+
const account = entry.preferredAccount;
|
|
291
|
+
if (!entry.active || !account || !entry.botFunds)
|
|
289
292
|
continue;
|
|
290
|
-
if (!accountFunds[
|
|
291
|
-
accountFunds[
|
|
293
|
+
if (!accountFunds[account]) {
|
|
294
|
+
accountFunds[account] = { buy: 0, sell: 0, botNames: [] };
|
|
292
295
|
}
|
|
293
|
-
const acc = accountFunds[
|
|
296
|
+
const acc = accountFunds[account];
|
|
294
297
|
acc.buy += toDecimal(entry.botFunds.buy);
|
|
295
298
|
acc.sell += toDecimal(entry.botFunds.sell);
|
|
296
299
|
acc.botNames.push(entry.name || entry.botKey || `bot-${entries.indexOf(entry)}`);
|
|
@@ -47,7 +47,7 @@
|
|
|
47
47
|
* @param {string} targetPath - Path of the final JSON file.
|
|
48
48
|
* @param {*} data - Anything `JSON.stringify` accepts.
|
|
49
49
|
*/
|
|
50
|
-
declare function writeJsonFileAtomic(targetPath:
|
|
50
|
+
declare function writeJsonFileAtomic(targetPath: string, data: unknown): void;
|
|
51
51
|
/**
|
|
52
52
|
* Safely read bots.json with lock protection (re-entrant safe).
|
|
53
53
|
* @param {string} botsJsonPath - Path to bots.json file
|
|
@@ -55,9 +55,9 @@ declare function writeJsonFileAtomic(targetPath: any, data: any): void;
|
|
|
55
55
|
* @returns {Promise<{content: string, config: Object}>} File content and parsed config
|
|
56
56
|
* @throws {Error} If file doesn't exist or JSON is invalid
|
|
57
57
|
*/
|
|
58
|
-
declare function readBotsFileWithLock(botsJsonPath:
|
|
58
|
+
declare function readBotsFileWithLock<T>(botsJsonPath: string, parseFunction: (content: string) => T): Promise<{
|
|
59
59
|
content: string;
|
|
60
|
-
config:
|
|
60
|
+
config: T;
|
|
61
61
|
}>;
|
|
62
62
|
/**
|
|
63
63
|
* Safely write bots.json with lock protection (re-entrant safe).
|
|
@@ -66,7 +66,7 @@ declare function readBotsFileWithLock(botsJsonPath: any, parseFunction: any): Pr
|
|
|
66
66
|
* @returns {Promise<void>}
|
|
67
67
|
* @throws {Error} If write fails
|
|
68
68
|
*/
|
|
69
|
-
declare function writeBotsFileWithLock(botsJsonPath:
|
|
69
|
+
declare function writeBotsFileWithLock(botsJsonPath: string, config: unknown): Promise<void>;
|
|
70
70
|
/**
|
|
71
71
|
* Synchronously read bots.json (startup only, no lock — the in-memory
|
|
72
72
|
* AsyncLock is inherently async and cannot be used here).
|
|
@@ -77,9 +77,9 @@ declare function writeBotsFileWithLock(botsJsonPath: any, config: any): Promise<
|
|
|
77
77
|
* @returns {{content: string, config: Object}} File content and parsed config
|
|
78
78
|
* @throws {Error} If file doesn't exist or JSON is invalid
|
|
79
79
|
*/
|
|
80
|
-
declare function readBotsFileSync(botsJsonPath:
|
|
80
|
+
declare function readBotsFileSync<T>(botsJsonPath: string, parseFunction: (content: string) => T): {
|
|
81
81
|
content: string;
|
|
82
|
-
config:
|
|
82
|
+
config: T;
|
|
83
83
|
};
|
|
84
84
|
export { readBotsFileWithLock, writeBotsFileWithLock, readBotsFileSync, writeJsonFileAtomic };
|
|
85
85
|
//# sourceMappingURL=bots_file_lock.d.ts.map
|
|
@@ -57,6 +57,20 @@ function writeJsonFileAtomic(targetPath, data) {
|
|
|
57
57
|
// Uses AsyncLock which supports nested acquire calls via
|
|
58
58
|
// AsyncLocalStorage-based re-entrancy detection.
|
|
59
59
|
const botsFileLock = new AsyncLock();
|
|
60
|
+
/**
|
|
61
|
+
* Parse a bots.json payload, applying the shared empty-file fallback. Both the
|
|
62
|
+
* locked async read and the startup sync read go through this so the
|
|
63
|
+
* empty-file default cannot drift between them.
|
|
64
|
+
* @param {string} content - Raw file content
|
|
65
|
+
* @param {Function} parseFunction - JSON parser function
|
|
66
|
+
* @returns {{content: string, config: Object}} Content and parsed config
|
|
67
|
+
*/
|
|
68
|
+
function parseBotsContent(content, parseFunction) {
|
|
69
|
+
if (!content || !content.trim()) {
|
|
70
|
+
return { content: '', config: { bots: [] } };
|
|
71
|
+
}
|
|
72
|
+
return { content, config: parseFunction(content) };
|
|
73
|
+
}
|
|
60
74
|
/**
|
|
61
75
|
* Safely read bots.json with lock protection (re-entrant safe).
|
|
62
76
|
* @param {string} botsJsonPath - Path to bots.json file
|
|
@@ -69,12 +83,7 @@ async function readBotsFileWithLock(botsJsonPath, parseFunction) {
|
|
|
69
83
|
if (!storage.exists(botsJsonPath)) {
|
|
70
84
|
throw new Error(`bots.json not found at ${botsJsonPath}`);
|
|
71
85
|
}
|
|
72
|
-
|
|
73
|
-
if (!content || !content.trim()) {
|
|
74
|
-
return { content: '', config: { bots: [] } };
|
|
75
|
-
}
|
|
76
|
-
const config = parseFunction(content);
|
|
77
|
-
return { content, config };
|
|
86
|
+
return parseBotsContent(storage.readFile(botsJsonPath), parseFunction);
|
|
78
87
|
});
|
|
79
88
|
}
|
|
80
89
|
/**
|
|
@@ -107,12 +116,7 @@ function readBotsFileSync(botsJsonPath, parseFunction) {
|
|
|
107
116
|
if (!storage.exists(botsJsonPath)) {
|
|
108
117
|
throw new Error(`bots.json not found at ${botsJsonPath}`);
|
|
109
118
|
}
|
|
110
|
-
|
|
111
|
-
if (!content || !content.trim()) {
|
|
112
|
-
return { content: '', config: { bots: [] } };
|
|
113
|
-
}
|
|
114
|
-
const config = parseFunction(content);
|
|
115
|
-
return { content, config };
|
|
119
|
+
return parseBotsContent(storage.readFile(botsJsonPath), parseFunction);
|
|
116
120
|
}
|
|
117
121
|
export { readBotsFileWithLock, writeBotsFileWithLock, readBotsFileSync, writeJsonFileAtomic };
|
|
118
122
|
//# sourceMappingURL=bots_file_lock.js.map
|
|
@@ -11,7 +11,7 @@
|
|
|
11
11
|
* Mirrors the failure modes produced by modules/bitshares-native/transport.ts
|
|
12
12
|
* call() and the signing client (modules/bitshares-native/signing_client.ts).
|
|
13
13
|
*/
|
|
14
|
-
|
|
14
|
+
type BroadcastFailureClass = 'retryable' | 'uncertain' | 'definite';
|
|
15
15
|
/**
|
|
16
16
|
* Classify a broadcast-phase failure.
|
|
17
17
|
*
|
|
@@ -26,8 +26,9 @@ export type BroadcastFailureClass = 'retryable' | 'uncertain' | 'definite';
|
|
|
26
26
|
* be built: nothing landed and retrying the identical ops
|
|
27
27
|
* cannot change the outcome.
|
|
28
28
|
*
|
|
29
|
-
* @param {
|
|
29
|
+
* @param {unknown} err - The thrown error (code + message).
|
|
30
30
|
* @returns {BroadcastFailureClass}
|
|
31
31
|
*/
|
|
32
|
-
export declare function classifyBroadcastFailure(err:
|
|
32
|
+
export declare function classifyBroadcastFailure(err: unknown): BroadcastFailureClass;
|
|
33
|
+
export {};
|
|
33
34
|
//# sourceMappingURL=broadcast_failure.d.ts.map
|
|
@@ -13,15 +13,16 @@
|
|
|
13
13
|
* be built: nothing landed and retrying the identical ops
|
|
14
14
|
* cannot change the outcome.
|
|
15
15
|
*
|
|
16
|
-
* @param {
|
|
16
|
+
* @param {unknown} err - The thrown error (code + message).
|
|
17
17
|
* @returns {BroadcastFailureClass}
|
|
18
18
|
*/
|
|
19
19
|
export function classifyBroadcastFailure(err) {
|
|
20
20
|
if (!err)
|
|
21
21
|
return 'definite';
|
|
22
|
-
const
|
|
22
|
+
const e = err;
|
|
23
|
+
const code = String(e.code || '');
|
|
23
24
|
if (code === 'CONNECTION_ERROR') {
|
|
24
|
-
const msg = String(
|
|
25
|
+
const msg = String(e.message || '');
|
|
25
26
|
// Pre-send rejections in transport.call() — the RPC frame was never
|
|
26
27
|
// written to the socket, so no transaction was transmitted.
|
|
27
28
|
if (msg === 'WebSocket not open' || msg.startsWith('Failed to send') || msg === 'No servers provided') {
|
|
@@ -56,7 +57,7 @@ export function classifyBroadcastFailure(err) {
|
|
|
56
57
|
// another node and nothing landed.
|
|
57
58
|
if (code === 'TX_TOO_LARGE')
|
|
58
59
|
return 'definite';
|
|
59
|
-
const msg = String(
|
|
60
|
+
const msg = String(e.message || '');
|
|
60
61
|
if (msg === 'Operation must have op_name and op_data'
|
|
61
62
|
|| msg === 'Each operation requires op_name and op_data'
|
|
62
63
|
|| /^Max operations per tx/.test(msg)
|
|
@@ -90,39 +90,50 @@
|
|
|
90
90
|
*
|
|
91
91
|
* ===============================================================================
|
|
92
92
|
*/
|
|
93
|
+
interface AccountsData {
|
|
94
|
+
vaultVersion: number;
|
|
95
|
+
vaultSalt: string;
|
|
96
|
+
vaultVerifier: string;
|
|
97
|
+
accounts: Record<string, Record<string, unknown>>;
|
|
98
|
+
}
|
|
99
|
+
interface DaemonPathOptions {
|
|
100
|
+
socketPath?: string;
|
|
101
|
+
readyFilePath?: string;
|
|
102
|
+
runtimeDir?: string;
|
|
103
|
+
}
|
|
104
|
+
interface DaemonSigningOptions extends DaemonPathOptions {
|
|
105
|
+
sessionId?: string | null;
|
|
106
|
+
botHmacSecret?: string | null;
|
|
107
|
+
}
|
|
93
108
|
/**
|
|
94
109
|
* Pick the onboarding link to show: the copy shipped with this installation
|
|
95
110
|
* when present, otherwise the hosted document. Exported for testing.
|
|
96
111
|
*/
|
|
97
112
|
export declare function resolveOnboardingUrl(localExists?: boolean, localHref?: string): string;
|
|
98
|
-
declare function isVaultSecret(value:
|
|
99
|
-
declare function createVaultSecret(vaultKey:
|
|
100
|
-
|
|
101
|
-
version: any;
|
|
102
|
-
vaultKeyHex: string;
|
|
103
|
-
};
|
|
104
|
-
declare function createSessionSecret(vaultKey: any, sessionSalt?: any): {
|
|
113
|
+
declare function isVaultSecret(value: unknown): boolean;
|
|
114
|
+
declare function createVaultSecret(vaultKey: unknown, extra?: Record<string, unknown>): VaultSecret;
|
|
115
|
+
declare function createSessionSecret(vaultKey: unknown, sessionSalt?: unknown): {
|
|
105
116
|
kind: string;
|
|
106
117
|
version: number;
|
|
107
118
|
sessionSaltHex: string;
|
|
108
119
|
vaultKeyHex: string;
|
|
109
120
|
};
|
|
110
|
-
declare function createDaemonSigningToken(accountName: string, options?:
|
|
121
|
+
declare function createDaemonSigningToken(accountName: string, options?: DaemonSigningOptions): {
|
|
111
122
|
kind: string;
|
|
112
123
|
accountName: string;
|
|
113
|
-
socketPath:
|
|
114
|
-
sessionId:
|
|
115
|
-
botHmacSecret:
|
|
124
|
+
socketPath: string;
|
|
125
|
+
sessionId: string | null;
|
|
126
|
+
botHmacSecret: string | null;
|
|
116
127
|
};
|
|
117
|
-
declare function isDaemonSigningToken(value:
|
|
118
|
-
declare function deriveVaultKey(password:
|
|
128
|
+
declare function isDaemonSigningToken(value: unknown): boolean;
|
|
129
|
+
declare function deriveVaultKey(password: string, vaultSalt: unknown): NonSharedBuffer;
|
|
119
130
|
/**
|
|
120
131
|
* Encrypt text using the v2 AES-256-GCM vault format.
|
|
121
132
|
* @param {string} text - Plain text to encrypt
|
|
122
133
|
* @param {Object|Buffer} secret - Derived vault secret
|
|
123
134
|
* @returns {string} Encrypted data as hex string
|
|
124
135
|
*/
|
|
125
|
-
declare function encrypt(text:
|
|
136
|
+
declare function encrypt(text: string, secret: unknown): string;
|
|
126
137
|
/**
|
|
127
138
|
* Decrypt text encrypted with the encrypt() function.
|
|
128
139
|
* @param {string} encrypted - Colon-separated encrypted data
|
|
@@ -130,14 +141,14 @@ declare function encrypt(text: any, secret: any): string;
|
|
|
130
141
|
* @returns {string} Decrypted plain text
|
|
131
142
|
* @throws {Error} If decryption fails (wrong password or corrupted data)
|
|
132
143
|
*/
|
|
133
|
-
declare function decrypt(encrypted:
|
|
144
|
+
declare function decrypt(encrypted: unknown, secret: unknown): string;
|
|
134
145
|
/**
|
|
135
146
|
* Validate a private key format.
|
|
136
147
|
* Supports WIF (Base58Check), PVT_K1_* style, and 64-char hex.
|
|
137
148
|
* @param {string} key - Private key to validate
|
|
138
149
|
* @returns {Object} { valid: boolean, reason?: string }
|
|
139
150
|
*/
|
|
140
|
-
declare function validatePrivateKey(key:
|
|
151
|
+
declare function validatePrivateKey(key: unknown): {
|
|
141
152
|
valid: boolean;
|
|
142
153
|
reason: string;
|
|
143
154
|
} | {
|
|
@@ -149,18 +160,13 @@ declare function validatePrivateKey(key: any): {
|
|
|
149
160
|
* Returns empty structure if file doesn't exist or is corrupted.
|
|
150
161
|
* @returns {Object} { vaultVersion: number, vaultSalt: string, vaultVerifier: string, accounts: Object }
|
|
151
162
|
*/
|
|
152
|
-
declare function loadAccounts():
|
|
153
|
-
vaultVersion: number;
|
|
154
|
-
vaultSalt: string;
|
|
155
|
-
vaultVerifier: string;
|
|
156
|
-
accounts: any;
|
|
157
|
-
};
|
|
163
|
+
declare function loadAccounts(): AccountsData;
|
|
158
164
|
/**
|
|
159
165
|
* Report whether the key vault has a usable account entry.
|
|
160
166
|
* Password metadata alone is not sufficient: cancelling key setup can leave
|
|
161
167
|
* a valid-looking vault with no account key to use at runtime.
|
|
162
168
|
*/
|
|
163
|
-
declare function hasKeySetup(accountsData?:
|
|
169
|
+
declare function hasKeySetup(accountsData?: AccountsData): boolean;
|
|
164
170
|
/**
|
|
165
171
|
* Check that the keys file has restrictive permissions (0o600) and is owned by
|
|
166
172
|
* the current user. Returns silently if the file doesn't exist yet (it will be
|
|
@@ -174,16 +180,12 @@ declare function checkKeysFileSecurity(): void;
|
|
|
174
180
|
* Unlock the key vault with a master password.
|
|
175
181
|
* Uses modern scrypt v2 vault format with HMAC verification.
|
|
176
182
|
* @param {string} password - Master password
|
|
177
|
-
* @param {
|
|
178
|
-
* @returns {
|
|
183
|
+
* @param {unknown} [accountsData=loadAccounts()] - Accounts data object
|
|
184
|
+
* @returns {unknown} Derived vault secret
|
|
179
185
|
* @throws {MasterPasswordError} If password is incorrect
|
|
180
186
|
* @throws {Error} If vault format is unsupported
|
|
181
187
|
*/
|
|
182
|
-
declare function unlockWithPassword(password:
|
|
183
|
-
kind: string;
|
|
184
|
-
version: any;
|
|
185
|
-
vaultKeyHex: string;
|
|
186
|
-
};
|
|
188
|
+
declare function unlockWithPassword(password: string, accountsData?: AccountsData): VaultSecret;
|
|
187
189
|
declare class MasterPasswordError extends Error {
|
|
188
190
|
static code: string;
|
|
189
191
|
code: string;
|
|
@@ -195,10 +197,10 @@ declare class MasterPasswordError extends Error {
|
|
|
195
197
|
* @param {Error} err - Error to check
|
|
196
198
|
* @returns {boolean} True if the error indicates authentication could not complete
|
|
197
199
|
*/
|
|
198
|
-
declare function isMasterPasswordFailure(err:
|
|
200
|
+
declare function isMasterPasswordFailure(err: unknown): boolean;
|
|
199
201
|
type VaultSecret = {
|
|
200
202
|
kind: string;
|
|
201
|
-
version:
|
|
203
|
+
version: number;
|
|
202
204
|
vaultKeyHex: string;
|
|
203
205
|
};
|
|
204
206
|
/**
|
|
@@ -217,7 +219,7 @@ declare function authenticate(): Promise<VaultSecret>;
|
|
|
217
219
|
* @returns {string} Decrypted private key
|
|
218
220
|
* @throws {Error} If account not found
|
|
219
221
|
*/
|
|
220
|
-
declare function getPrivateKey(accountName:
|
|
222
|
+
declare function getPrivateKey(accountName: string, vaultSecret: unknown): string;
|
|
221
223
|
/**
|
|
222
224
|
* Resolve a signing key for an account, following on-chain authority structures
|
|
223
225
|
* (account_auths, key_auths) when no direct key is stored.
|
|
@@ -228,7 +230,7 @@ declare function getPrivateKey(accountName: any, vaultSecret: any): any;
|
|
|
228
230
|
* @returns {Promise<string>} Private key WIF string
|
|
229
231
|
* @throws {Error} If no key can be found through direct lookup or authority resolution
|
|
230
232
|
*/
|
|
231
|
-
declare function resolvePrivateKey(accountName:
|
|
233
|
+
declare function resolvePrivateKey(accountName: string, vaultSecret: unknown, chainClient: unknown): Promise<string>;
|
|
232
234
|
/**
|
|
233
235
|
* Save accounts data to profiles/keys.json atomically with restrictive permissions.
|
|
234
236
|
* Writes to a temp file in the same directory, fsyncs, then renames over the target.
|
|
@@ -237,7 +239,7 @@ declare function resolvePrivateKey(accountName: any, vaultSecret: any, chainClie
|
|
|
237
239
|
*
|
|
238
240
|
* @param {Object} data - Accounts data to save
|
|
239
241
|
*/
|
|
240
|
-
declare function saveAccounts(data:
|
|
242
|
+
declare function saveAccounts(data: AccountsData): void;
|
|
241
243
|
/**
|
|
242
244
|
* Launch the interactive key management CLI.
|
|
243
245
|
* Provides menu for: add/modify/remove keys, test decryption,
|
|
@@ -249,7 +251,7 @@ declare function main(): Promise<boolean>;
|
|
|
249
251
|
* @param {Object} [options={}] - Optional socket/ready-file path overrides
|
|
250
252
|
* @returns {boolean} True if daemon socket is responsive
|
|
251
253
|
*/
|
|
252
|
-
declare function isDaemonReady(options?:
|
|
254
|
+
declare function isDaemonReady(options?: DaemonPathOptions): boolean;
|
|
253
255
|
/**
|
|
254
256
|
* Check if dexbot-cred daemon is actually responsive by opening a socket
|
|
255
257
|
* connection and waiting for any reply. This catches stale socket/ready
|
|
@@ -258,7 +260,7 @@ declare function isDaemonReady(options?: any): boolean;
|
|
|
258
260
|
* @param {number} timeout - Probe timeout in milliseconds (default 2000)
|
|
259
261
|
* @returns {Promise<boolean>} True if the daemon accepts connections and replies
|
|
260
262
|
*/
|
|
261
|
-
declare function isDaemonResponsive(options?:
|
|
263
|
+
declare function isDaemonResponsive(options?: DaemonPathOptions, timeout?: number): Promise<boolean>;
|
|
262
264
|
/**
|
|
263
265
|
* Wait for dexbot-cred daemon to be ready
|
|
264
266
|
* @param {number} maxWaitMs - Maximum time to wait in milliseconds (default 60000)
|
|
@@ -266,7 +268,7 @@ declare function isDaemonResponsive(options?: any, timeout?: any): Promise<unkno
|
|
|
266
268
|
* @returns {Promise<void>} Resolves when daemon is ready
|
|
267
269
|
* @throws {Error} If daemon doesn't start within timeout
|
|
268
270
|
*/
|
|
269
|
-
declare function waitForDaemon(maxWaitMs?:
|
|
271
|
+
declare function waitForDaemon(maxWaitMs?: number, options?: DaemonPathOptions): Promise<void>;
|
|
270
272
|
/**
|
|
271
273
|
* Lightweight daemon health check. Does NOT create a session or write
|
|
272
274
|
* an audit log entry — used by the credential daemon watchdog and
|
|
@@ -276,7 +278,7 @@ declare function waitForDaemon(maxWaitMs?: any, options?: any): Promise<void>;
|
|
|
276
278
|
* @param {Object} options - Optional socket path overrides
|
|
277
279
|
* @returns {Promise<boolean>} Resolves with true if daemon responds
|
|
278
280
|
*/
|
|
279
|
-
declare function pingDaemon(accountName:
|
|
281
|
+
declare function pingDaemon(accountName: string | null, timeout?: number, options?: DaemonPathOptions): Promise<boolean>;
|
|
280
282
|
/**
|
|
281
283
|
* Verifies the account exists in the daemon's session cache.
|
|
282
284
|
* @param {string} accountName - Name of the account to probe
|
|
@@ -284,6 +286,6 @@ declare function pingDaemon(accountName: any, timeout?: any, options?: any): Pro
|
|
|
284
286
|
* @param {Object} options - Optional socket path overrides
|
|
285
287
|
* @returns {Promise<string|null>} Resolves with sessionId if account is available, rejects otherwise
|
|
286
288
|
*/
|
|
287
|
-
declare function probeAccountInDaemon(accountName:
|
|
289
|
+
declare function probeAccountInDaemon(accountName: string | null, timeout?: number, options?: DaemonPathOptions): Promise<string | null>;
|
|
288
290
|
export { validatePrivateKey, loadAccounts, hasKeySetup, saveAccounts, checkKeysFileSecurity, encrypt, decrypt, deriveVaultKey, createDaemonSigningToken, createSessionSecret, createVaultSecret, isVaultSecret, isDaemonSigningToken, unlockWithPassword, main, authenticate, getPrivateKey, resolvePrivateKey, isMasterPasswordFailure, MasterPasswordError, isDaemonReady, isDaemonResponsive, waitForDaemon, probeAccountInDaemon, pingDaemon };
|
|
289
291
|
//# sourceMappingURL=chain_keys.d.ts.map
|