dexbot 1.6.10 → 1.6.12
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 +50 -3
- package/README.md +3 -1
- package/analysis/README.md +51 -11
- package/analysis/bot_fitting/README.md +12 -0
- package/analysis/tradingview/README.md +3 -3
- package/analysis/trend_detection/DYNAMIC_WEIGHT_RESEARCH.md +11 -37
- package/analysis/trend_detection/README.md +31 -0
- package/claw/docs/DEXBOT2_TUNING_CHEAT_SHEET.md +4 -3
- package/claw/modules/chain_broadcast.ts +7 -1
- package/claw/modules/claw_launcher.ts +1 -1
- package/claw/modules/launcher_mode_detector.ts +9 -2
- package/claw/package.json +1 -1
- package/claw/runtimes/openclaw-plugin/openclaw.plugin.json +1 -1
- package/claw/runtimes/openclaw-plugin/package.json +1 -1
- package/dist/analysis/account_resolver.d.ts +1 -1
- package/dist/analysis/account_resolver.js +15 -2
- package/dist/analysis/ama_fitting/analyze_ama_price_changes.js +3 -4
- package/dist/analysis/ama_fitting/analyze_lambda_vs_slow.js +2 -7
- package/dist/analysis/ama_fitting/calibrate_convergence_er.js +0 -1
- package/dist/analysis/ama_fitting/fetch_lp_candles.js +4 -4
- package/dist/analysis/ama_fitting/generate_unified_comparison_chart.d.ts +20 -4
- package/dist/analysis/ama_fitting/generate_unified_comparison_chart.js +9 -6
- package/dist/analysis/ama_fitting/optimizer_high_resolution.js +16 -12
- package/dist/analysis/analyze_args.d.ts +31 -0
- package/dist/analysis/analyze_args.js +41 -0
- package/dist/analysis/analyze_dynamic_weight.js +7 -20
- 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 +220 -12
- package/dist/analysis/bot_fitting/backtest_ama_sweep.js +55 -10
- package/dist/analysis/bot_fitting/backtest_bot_fitting.d.ts +34 -4
- package/dist/analysis/bot_fitting/backtest_bot_fitting.js +72 -66
- package/dist/analysis/bot_fitting/backtest_lookback_drawdown.d.ts +21 -0
- package/dist/analysis/bot_fitting/backtest_lookback_drawdown.js +315 -0
- package/dist/analysis/bot_fitting/shared_utils.d.ts +7 -7
- package/dist/analysis/bot_fitting/shared_utils.js +2 -2
- package/dist/analysis/bot_key_utils.d.ts +18 -10
- package/dist/analysis/bot_key_utils.js +10 -17
- 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 +5 -2
- package/dist/analysis/chart_ui.js +6 -3
- package/dist/analysis/chart_utils.d.ts +5 -5
- package/dist/analysis/chart_utils.js +9 -0
- package/dist/analysis/fills_cache.d.ts +64 -0
- package/dist/analysis/fills_cache.js +254 -0
- package/dist/analysis/fills_source.d.ts +2 -2
- package/dist/analysis/fills_source.js +19 -14
- package/dist/analysis/grid_correction_check.d.ts +1 -1
- package/dist/analysis/grid_correction_check.js +12 -11
- package/dist/analysis/math_utils.d.ts +7 -6
- package/dist/analysis/math_utils.js +5 -8
- package/dist/analysis/pnl_report.d.ts +39 -0
- package/dist/analysis/pnl_report.js +325 -0
- package/dist/analysis/price_sources.d.ts +8 -8
- package/dist/analysis/price_sources.js +5 -4
- package/dist/analysis/resolve_bot_accounts.js +2 -2
- package/dist/analysis/resolve_source.d.ts +1 -2
- package/dist/analysis/trade_profitability.d.ts +32 -2
- package/dist/analysis/trade_profitability.js +232 -106
- package/dist/analysis/tradingview/analyze_tradingview.d.ts +17 -6
- package/dist/analysis/tradingview/analyze_tradingview.js +9 -10
- package/dist/analysis/tradingview/grid_reset_config.d.ts +42 -31
- package/dist/analysis/tradingview/grid_reset_config.js +35 -6
- package/dist/analysis/tradingview/grid_reset_sim.d.ts +75 -8
- package/dist/analysis/tradingview/grid_reset_sim.js +42 -5
- package/dist/analysis/tradingview/tradingview_uplot_chart_generator.d.ts +69 -4
- package/dist/analysis/tradingview/tradingview_uplot_chart_generator.js +20 -20
- package/dist/analysis/trend_detection/backtest_ama_slope_huber.d.ts +102 -0
- package/dist/analysis/trend_detection/backtest_ama_slope_huber.js +725 -0
- package/dist/analysis/trend_detection/dynamic_weight_chart_generator.d.ts +63 -1
- package/dist/analysis/trend_detection/dynamic_weight_chart_generator.js +27 -112
- package/dist/analysis/trend_detection/huber_scale_variants.d.ts +40 -0
- package/dist/analysis/trend_detection/huber_scale_variants.js +176 -0
- 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/credential-daemon.js +34 -20
- package/dist/dexbot.js +17 -14
- package/dist/market_adapter/candle_utils.d.ts +22 -18
- package/dist/market_adapter/candle_utils.js +24 -20
- 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/kibana_candles.d.ts +53 -18
- package/dist/market_adapter/core/kibana_candles.js +9 -7
- 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 +297 -115
- package/dist/market_adapter/core/market_adapter_service.js +184 -101
- package/dist/market_adapter/core/strategies/ama.d.ts +10 -2
- package/dist/market_adapter/core/strategies/ama.js +7 -32
- 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 +36 -8
- package/dist/market_adapter/core/strategies/dynamic_weight_series.js +9 -9
- 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 -1
- package/dist/market_adapter/inputs/fetch_cex_synthetic_data.js +97 -226
- package/dist/market_adapter/inputs/fetch_lp_data.d.ts +42 -7
- package/dist/market_adapter/inputs/fetch_lp_data.js +22 -15
- package/dist/market_adapter/inputs/kibana_feed_source.d.ts +74 -15
- package/dist/market_adapter/inputs/kibana_feed_source.js +29 -22
- 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 +99 -94
- package/dist/market_adapter/inputs/window_cache.js +8 -8
- package/dist/market_adapter/interval_utils.d.ts +4 -4
- package/dist/market_adapter/log_format.d.ts +6 -6
- package/dist/market_adapter/log_format.js +28 -22
- 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 +7 -7
- 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 -33
- package/dist/market_adapter/market_adapter.js +69 -75
- 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 +4 -1
- 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/native_history.d.ts +9 -2
- package/dist/market_adapter/utils/native_history.js +35 -28
- package/dist/modules/account_bots.d.ts +577 -21
- package/dist/modules/account_bots.js +182 -158
- package/dist/modules/account_orders.d.ts +66 -30
- package/dist/modules/account_orders.js +22 -20
- 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 +38 -3
- package/dist/modules/bitshares-native/chain_client.js +45 -46
- 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/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 +55 -62
- 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 +6 -15
- 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 +2 -2
- 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 +93 -59
- package/dist/modules/chain_orders.js +31 -23
- package/dist/modules/constants.d.ts +530 -32
- package/dist/modules/constants.js +52 -60
- package/dist/modules/cr_planner.d.ts +40 -2
- 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 +42 -6
- package/dist/modules/credit_pricing.js +44 -30
- package/dist/modules/credit_runtime.d.ts +276 -118
- package/dist/modules/credit_runtime.js +462 -165
- 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/dexbot_class.d.ts +195 -139
- package/dist/modules/dexbot_class.js +78 -28
- package/dist/modules/dexbot_cow_runtime.d.ts +167 -87
- package/dist/modules/dexbot_cow_runtime.js +248 -206
- package/dist/modules/dexbot_credential_client.d.ts +19 -11
- package/dist/modules/dexbot_fill_runtime.d.ts +63 -48
- package/dist/modules/dexbot_fill_runtime.js +48 -41
- package/dist/modules/dexbot_maintenance_runtime.d.ts +109 -70
- package/dist/modules/dexbot_maintenance_runtime.js +117 -80
- package/dist/modules/dexbot_startup_runtime.d.ts +11 -10
- package/dist/modules/dexbot_startup_runtime.js +43 -43
- 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 +2 -2
- 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 -6
- 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/market_adapter_whitelist.d.ts +9 -3
- package/dist/modules/market_adapter_whitelist.js +15 -3
- 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 +40 -14
- 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 +39 -19
- package/dist/modules/order/format.js +62 -16
- package/dist/modules/order/genesis_policy.d.ts +21 -18
- package/dist/modules/order/genesis_policy.js +12 -8
- package/dist/modules/order/grid.d.ts +142 -36
- package/dist/modules/order/grid.js +148 -123
- 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 +263 -1
- package/dist/modules/order/logger.d.ts +45 -11
- package/dist/modules/order/logger.js +38 -40
- package/dist/modules/order/logger_state.d.ts +4 -4
- package/dist/modules/order/manager.d.ts +226 -180
- package/dist/modules/order/manager.js +101 -83
- 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 +99 -54
- 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 +326 -106
- package/dist/modules/order/utils/order.js +200 -99
- package/dist/modules/order/utils/slot.d.ts +1 -1
- package/dist/modules/order/utils/system.d.ts +176 -26
- package/dist/modules/order/utils/system.js +86 -69
- package/dist/modules/order/utils/validate.d.ts +89 -41
- package/dist/modules/order/utils/validate.js +24 -22
- package/dist/modules/order/utils/withPoolRef.d.ts +4 -3
- 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 +3 -4
- package/dist/modules/paths.js +3 -27
- 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 +15 -10
- 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 +7 -4
- 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 +1071 -2
- 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 +23 -1
- package/dist/modules/utils/time_range.d.ts +4 -0
- package/dist/modules/utils/time_range.js +18 -0
- package/dist/modules/validate_profiles.js +53 -43
- package/dist/modules/version_notice.d.ts +14 -3
- package/dist/modules/version_notice.js +6 -4
- package/dist/pm2.d.ts +29 -27
- package/dist/pm2.js +5 -5
- package/dist/scripts/analyze-credit.d.ts +2 -1
- package/dist/scripts/analyze-credit.js +23 -24
- package/dist/scripts/analyze-orders.d.ts +77 -9
- package/dist/scripts/analyze-orders.js +66 -84
- package/dist/scripts/chart_command.d.ts +27 -18
- package/dist/scripts/chart_command.js +16 -15
- package/dist/scripts/check_any.d.ts +18 -0
- package/dist/scripts/check_any.js +126 -0
- package/dist/scripts/diagnose-pool-history.js +12 -7
- package/dist/scripts/pnl.d.ts +3 -0
- package/dist/scripts/pnl.js +40 -0
- package/dist/scripts/print_grid.js +0 -1
- package/dist/scripts/run-tests.js +39 -7
- package/dist/scripts/runner.js +1 -1
- 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 +72 -10
- package/docs/BITSHARES_ONBOARDING.md +2 -0
- package/docs/COPY_ON_WRITE_MASTER_PLAN.md +1 -1
- package/docs/COW_INVARIANTS.md +13 -6
- package/docs/DEXBOT_COMPARISON.md +8 -8
- package/docs/EVOLUTION.md +12 -10
- package/docs/FUND_MOVEMENT_AND_ACCOUNTING.md +5 -5
- package/docs/GRID_RECALCULATION.md +15 -16
- 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 +15 -4
- package/docs/WORKFLOW.md +1 -0
- package/docs/architecture.md +12 -9
- package/docs/developer_guide.md +6 -6
- package/market_adapter/README.md +9 -26
- package/modules/README.md +4 -1
- package/package.json +4 -1
- package/scripts/README.md +14 -0
|
@@ -1,4 +1,12 @@
|
|
|
1
|
-
|
|
2
|
-
|
|
1
|
+
/**
|
|
2
|
+
* Kaufman's Adaptive Moving Average (KAMA/AMA).
|
|
3
|
+
*/
|
|
4
|
+
export interface AmaParams {
|
|
5
|
+
erPeriod: number;
|
|
6
|
+
fastPeriod: number;
|
|
7
|
+
slowPeriod: number;
|
|
8
|
+
}
|
|
9
|
+
declare function getAmaWarmupBars(erPeriod: number, slowPeriod: number, lookbackBars: number, fastPeriod: number): number;
|
|
10
|
+
declare function calculateAMA(closes: number[], params: AmaParams): number[];
|
|
3
11
|
export { calculateAMA, getAmaWarmupBars };
|
|
4
12
|
//# sourceMappingURL=ama.d.ts.map
|
|
@@ -1,13 +1,7 @@
|
|
|
1
1
|
'use strict';
|
|
2
2
|
import { MARKET_ADAPTER } from '../../../modules/constants.js';
|
|
3
|
-
/**
|
|
4
|
-
* Kaufman's Adaptive Moving Average (KAMA/AMA).
|
|
5
|
-
*/
|
|
6
3
|
class AMA {
|
|
7
4
|
erPeriod;
|
|
8
|
-
erSmoothPeriod;
|
|
9
|
-
erSmoothAlpha;
|
|
10
|
-
erSmoothValue;
|
|
11
5
|
fastSC;
|
|
12
6
|
slowSC;
|
|
13
7
|
prevAMA;
|
|
@@ -15,7 +9,7 @@ class AMA {
|
|
|
15
9
|
warmedUp;
|
|
16
10
|
smaSum;
|
|
17
11
|
smaCount;
|
|
18
|
-
constructor(erPeriod, fastPeriod, slowPeriod
|
|
12
|
+
constructor(erPeriod, fastPeriod, slowPeriod) {
|
|
19
13
|
if (!Number.isFinite(erPeriod) || erPeriod <= 0) {
|
|
20
14
|
throw new TypeError(`AMA erPeriod must be a positive finite number, got ${erPeriod}`);
|
|
21
15
|
}
|
|
@@ -26,10 +20,6 @@ class AMA {
|
|
|
26
20
|
throw new TypeError(`AMA slowPeriod must be a positive finite number, got ${slowPeriod}`);
|
|
27
21
|
}
|
|
28
22
|
this.erPeriod = Math.ceil(erPeriod);
|
|
29
|
-
const esPeriod = Number(erSmoothPeriod);
|
|
30
|
-
this.erSmoothPeriod = Number.isFinite(esPeriod) && esPeriod >= 1 ? esPeriod : 0;
|
|
31
|
-
this.erSmoothAlpha = this.erSmoothPeriod > 0 ? 2 / (this.erSmoothPeriod + 1) : 0;
|
|
32
|
-
this.erSmoothValue = null;
|
|
33
23
|
this.fastSC = 2 / (fastPeriod + 1);
|
|
34
24
|
this.slowSC = 2 / (slowPeriod + 1);
|
|
35
25
|
this.prevAMA = null;
|
|
@@ -65,21 +55,14 @@ class AMA {
|
|
|
65
55
|
volatility += Math.abs(this.history[i] - this.history[i - 1]);
|
|
66
56
|
}
|
|
67
57
|
const er = volatility === 0 ? 0 : direction / volatility;
|
|
68
|
-
const
|
|
69
|
-
|
|
70
|
-
|
|
71
|
-
: this.erSmoothValue + this.erSmoothAlpha * (er - this.erSmoothValue))
|
|
72
|
-
: er;
|
|
73
|
-
if (this.erSmoothAlpha > 0) {
|
|
74
|
-
this.erSmoothValue = effectiveER;
|
|
75
|
-
}
|
|
76
|
-
const smooth = (effectiveER * (this.fastSC - this.slowSC) + this.slowSC) ** 2;
|
|
77
|
-
const ama = this.prevAMA + smooth * (price - this.prevAMA);
|
|
58
|
+
const prevAMA = this.prevAMA;
|
|
59
|
+
const smooth = (er * (this.fastSC - this.slowSC) + this.slowSC) ** 2;
|
|
60
|
+
const ama = prevAMA + smooth * (price - prevAMA);
|
|
78
61
|
this.prevAMA = ama;
|
|
79
62
|
return ama;
|
|
80
63
|
}
|
|
81
64
|
}
|
|
82
|
-
function getAmaWarmupBars(erPeriod, slowPeriod, lookbackBars, fastPeriod
|
|
65
|
+
function getAmaWarmupBars(erPeriod, slowPeriod, lookbackBars, fastPeriod) {
|
|
83
66
|
if (!Number.isFinite(erPeriod) || erPeriod <= 0) {
|
|
84
67
|
throw new TypeError(`getAmaWarmupBars erPeriod must be a positive finite number, got ${erPeriod}`);
|
|
85
68
|
}
|
|
@@ -92,23 +75,15 @@ function getAmaWarmupBars(erPeriod, slowPeriod, lookbackBars, fastPeriod, erSmoo
|
|
|
92
75
|
if (!Number.isFinite(fastPeriod) || fastPeriod <= 0) {
|
|
93
76
|
throw new TypeError(`getAmaWarmupBars fastPeriod must be a positive finite number, got ${fastPeriod}`);
|
|
94
77
|
}
|
|
95
|
-
if (!Number.isFinite(erSmoothPeriod) || erSmoothPeriod < 0) {
|
|
96
|
-
throw new TypeError(`getAmaWarmupBars erSmoothPeriod must be a non-negative finite number, got ${erSmoothPeriod}`);
|
|
97
|
-
}
|
|
98
78
|
const safeErPeriod = Math.ceil(erPeriod);
|
|
99
79
|
const safeSlowPeriod = Math.ceil(slowPeriod);
|
|
100
80
|
const safeLookbackBars = Math.ceil(lookbackBars);
|
|
101
|
-
const safeErSmoothPeriod = erSmoothPeriod >= 1 ? erSmoothPeriod : 0;
|
|
102
81
|
const fastSC = 2 / (fastPeriod + 1);
|
|
103
82
|
const slowSC = 2 / (safeSlowPeriod + 1);
|
|
104
83
|
const deltaSC = fastSC - slowSC;
|
|
105
84
|
const scAvg = (MARKET_ADAPTER.AMA_CONVERGENCE_ER_AVG * deltaSC + slowSC) ** 2;
|
|
106
85
|
const convergenceBars = Math.ceil(Math.log(MARKET_ADAPTER.AMA_CONVERGENCE_EPSILON) / Math.log(1 - scAvg));
|
|
107
|
-
|
|
108
|
-
? Math.ceil(Math.log(MARKET_ADAPTER.AMA_CONVERGENCE_EPSILON)
|
|
109
|
-
/ Math.log(1 - (2 / (safeErSmoothPeriod + 1))))
|
|
110
|
-
: 0;
|
|
111
|
-
return safeErPeriod + convergenceBars + erSmoothConvergenceBars + safeLookbackBars;
|
|
86
|
+
return safeErPeriod + convergenceBars + safeLookbackBars;
|
|
112
87
|
}
|
|
113
88
|
function calculateAMA(closes, params) {
|
|
114
89
|
if (!params || typeof params !== 'object') {
|
|
@@ -126,7 +101,7 @@ function calculateAMA(closes, params) {
|
|
|
126
101
|
if (!Array.isArray(closes)) {
|
|
127
102
|
throw new TypeError('calculateAMA closes must be an array');
|
|
128
103
|
}
|
|
129
|
-
const indicator = new AMA(params.erPeriod, params.fastPeriod, params.slowPeriod
|
|
104
|
+
const indicator = new AMA(params.erPeriod, params.fastPeriod, params.slowPeriod);
|
|
130
105
|
return closes.map(price => indicator.update(price));
|
|
131
106
|
}
|
|
132
107
|
export { calculateAMA, getAmaWarmupBars };
|
|
@@ -21,7 +21,20 @@ import { computeAverageAmaSlopePct, computeHuberWindowSlopePct, computeAmaSlopeC
|
|
|
21
21
|
* @param {number} [opts.clipThreshold=Infinity] Pre-computed clip threshold from slope history (percentile clipping is done by the caller)
|
|
22
22
|
* @returns {{ slopeOffset, rawSlopeOffset, symmetricDelta, slopePct, clippedSlopePct, confidence, trend, isReady }}
|
|
23
23
|
*/
|
|
24
|
-
|
|
24
|
+
interface AmaSlopeOpts {
|
|
25
|
+
lookbackBars?: unknown;
|
|
26
|
+
maxSlopePct?: unknown;
|
|
27
|
+
neutralZonePct?: unknown;
|
|
28
|
+
volatilityExponent?: unknown;
|
|
29
|
+
volatilityScaleX?: unknown;
|
|
30
|
+
volatilityThreshold?: unknown;
|
|
31
|
+
erPeriod?: unknown;
|
|
32
|
+
maxSlopeOffset?: unknown;
|
|
33
|
+
maxVolatilityOffset?: unknown;
|
|
34
|
+
clipThreshold?: unknown;
|
|
35
|
+
[key: string]: unknown;
|
|
36
|
+
}
|
|
37
|
+
declare function computeAmaSlopeWeights(amaValues: unknown, weightVariance: number, opts?: AmaSlopeOpts): {
|
|
25
38
|
slopeOffset: number;
|
|
26
39
|
rawSlopeOffset: number;
|
|
27
40
|
symmetricDelta: number;
|
|
@@ -9,48 +9,26 @@ import { computeVolatilityShift } from './volatility_shift.js';
|
|
|
9
9
|
import { computeAverageAmaSlopePct, computeHuberWindowSlopePct, computeAmaSlopeClipThreshold, createAmaSlopeClipTracker, } from './dynamic_weight_series.js';
|
|
10
10
|
const _DEFAULT_AMA_KEY = MARKET_ADAPTER.DEFAULT_AMA_KEY;
|
|
11
11
|
const DEFAULT_ER_PERIOD = MARKET_ADAPTER.AMAS[_DEFAULT_AMA_KEY].erPeriod;
|
|
12
|
-
/**
|
|
13
|
-
* Compute AMA slope and volatility offsets from the AMA series.
|
|
14
|
-
*
|
|
15
|
-
* Two independent additive factors:
|
|
16
|
-
* slopeOffset (asymmetric): AMA slope magnitude → trend direction
|
|
17
|
-
* symmetricDelta (symmetric): ATR/price ratio → noise level
|
|
18
|
-
*
|
|
19
|
-
* @param {number[]} amaValues Full AMA series (output of calculateAMA)
|
|
20
|
-
* @param {number} weightVariance ATR(period) / amaPrice (0 = no volatility)
|
|
21
|
-
* @param {Object} [opts] Market-reading tuning — no offset bounds here
|
|
22
|
-
* @param {number} [opts.lookbackBars=MARKET_ADAPTER.DYNAMIC_WEIGHT_AMA_LOOKBACK_BARS] Bars to look back for slope
|
|
23
|
-
* @param {number} [opts.maxSlopePct=MARKET_ADAPTER.DYNAMIC_WEIGHT_AMA_MAX_SLOPE_PCT] Average per-bar slope % that saturates slopeOffset
|
|
24
|
-
* @param {number} [opts.neutralZonePct=MARKET_ADAPTER.DYNAMIC_WEIGHT_AMA_NEUTRAL_ZONE_PCT] Dead-band around zero average slope
|
|
25
|
-
* @param {number} [opts.volatilityExponent=1.0] Exponent for ATR-based penalty
|
|
26
|
-
* @param {number} [opts.volatilityScaleX=10.0] Scale factor penalty (10.0 = normal start)
|
|
27
|
-
* @param {number} [opts.volatilityThreshold=0.1] Minimum |symmetricDelta| before penalty applies
|
|
28
|
-
* @param {number} [opts.erPeriod=DEFAULT_ER_PERIOD] AMA warm-up bars to skip in isReady guard
|
|
29
|
-
* @param {number} [opts.maxSlopeOffset=MARKET_ADAPTER.DYNAMIC_WEIGHT_ASYMMETRIC_OFFSET_CLAMP] Per-bot cap on buy/sell asymmetry offset
|
|
30
|
-
* @param {number} [opts.maxVolatilityOffset=MARKET_ADAPTER.DYNAMIC_WEIGHT_SYMMETRIC_SHIFT_CLAMP] Per-bot cap on volatility shift
|
|
31
|
-
* @param {number} [opts.clipThreshold=Infinity] Pre-computed clip threshold from slope history (percentile clipping is done by the caller)
|
|
32
|
-
* @returns {{ slopeOffset, rawSlopeOffset, symmetricDelta, slopePct, clippedSlopePct, confidence, trend, isReady }}
|
|
33
|
-
*/
|
|
34
12
|
function computeAmaSlopeWeights(amaValues, weightVariance, opts = {}) {
|
|
35
|
-
const lookbackBars = Number.isFinite(opts.lookbackBars) && opts.lookbackBars >= 0
|
|
36
|
-
? Math.ceil(opts.lookbackBars)
|
|
13
|
+
const lookbackBars = Number.isFinite(Number(opts.lookbackBars)) && Number(opts.lookbackBars) >= 0
|
|
14
|
+
? Math.ceil(Number(opts.lookbackBars))
|
|
37
15
|
: MARKET_ADAPTER.DYNAMIC_WEIGHT_AMA_LOOKBACK_BARS;
|
|
38
|
-
const maxSlopePct = opts.maxSlopePct ?? MARKET_ADAPTER.DYNAMIC_WEIGHT_AMA_MAX_SLOPE_PCT;
|
|
39
|
-
const neutralZonePct = opts.neutralZonePct ?? MARKET_ADAPTER.DYNAMIC_WEIGHT_AMA_NEUTRAL_ZONE_PCT;
|
|
40
|
-
const volatilityExponent = opts.volatilityExponent ?? MARKET_ADAPTER.DYNAMIC_WEIGHT_VOLATILITY_EXPONENT;
|
|
41
|
-
const volatilityScaleX = opts.volatilityScaleX ?? MARKET_ADAPTER.DYNAMIC_WEIGHT_VOLATILITY_SCALE_X_DEFAULT;
|
|
42
|
-
const volatilityThreshold = normalizeVolatilityThreshold(opts.volatilityThreshold);
|
|
43
|
-
const erPeriod = Number.isFinite(opts.erPeriod) && opts.erPeriod > 0
|
|
44
|
-
? Math.ceil(opts.erPeriod)
|
|
16
|
+
const maxSlopePct = Number(opts.maxSlopePct ?? MARKET_ADAPTER.DYNAMIC_WEIGHT_AMA_MAX_SLOPE_PCT);
|
|
17
|
+
const neutralZonePct = Number(opts.neutralZonePct ?? MARKET_ADAPTER.DYNAMIC_WEIGHT_AMA_NEUTRAL_ZONE_PCT);
|
|
18
|
+
const volatilityExponent = Number(opts.volatilityExponent ?? MARKET_ADAPTER.DYNAMIC_WEIGHT_VOLATILITY_EXPONENT);
|
|
19
|
+
const volatilityScaleX = Number(opts.volatilityScaleX ?? MARKET_ADAPTER.DYNAMIC_WEIGHT_VOLATILITY_SCALE_X_DEFAULT);
|
|
20
|
+
const volatilityThreshold = normalizeVolatilityThreshold(Number(opts.volatilityThreshold));
|
|
21
|
+
const erPeriod = Number.isFinite(Number(opts.erPeriod)) && Number(opts.erPeriod) > 0
|
|
22
|
+
? Math.ceil(Number(opts.erPeriod))
|
|
45
23
|
: DEFAULT_ER_PERIOD;
|
|
46
24
|
// Reject negative caps outright (a negative cap would silently invert the
|
|
47
25
|
// trend-bias sign); fall back to the default like other invalid values.
|
|
48
|
-
const rawMaxSlopeOffset = opts.maxSlopeOffset ?? MARKET_ADAPTER.DYNAMIC_WEIGHT_ASYMMETRIC_OFFSET_CLAMP;
|
|
26
|
+
const rawMaxSlopeOffset = Number(opts.maxSlopeOffset ?? MARKET_ADAPTER.DYNAMIC_WEIGHT_ASYMMETRIC_OFFSET_CLAMP);
|
|
49
27
|
const maxSlopeOffset = Number.isFinite(rawMaxSlopeOffset) && rawMaxSlopeOffset >= 0
|
|
50
28
|
? rawMaxSlopeOffset
|
|
51
29
|
: MARKET_ADAPTER.DYNAMIC_WEIGHT_ASYMMETRIC_OFFSET_CLAMP;
|
|
52
|
-
const maxVolatilityOffset = normalizeMaxVolatilityOffset(opts.maxVolatilityOffset);
|
|
53
|
-
const clipThreshold = opts.clipThreshold ?? Infinity;
|
|
30
|
+
const maxVolatilityOffset = normalizeMaxVolatilityOffset(Number(opts.maxVolatilityOffset));
|
|
31
|
+
const clipThreshold = Number(opts.clipThreshold ?? Infinity);
|
|
54
32
|
const hasDirectionalOffset = Number.isFinite(maxSlopeOffset) && maxSlopeOffset > 0;
|
|
55
33
|
const safeWeightVariance = Number.isFinite(weightVariance) && weightVariance > 0 ? weightVariance : 0;
|
|
56
34
|
const safeVolatilityExponent = Number.isFinite(volatilityExponent) && volatilityExponent >= 0
|
|
@@ -30,7 +30,12 @@
|
|
|
30
30
|
* even when the final row is missing/invalid).
|
|
31
31
|
* @returns {number[]} Per-candle ATR values (0 during warmup / across breaks)
|
|
32
32
|
*/
|
|
33
|
-
|
|
33
|
+
interface AtrStats {
|
|
34
|
+
validRanges?: number;
|
|
35
|
+
atr?: number;
|
|
36
|
+
[key: string]: unknown;
|
|
37
|
+
}
|
|
38
|
+
declare function computeATRSeries(candles: unknown, period?: number, stats?: AtrStats | null): number[];
|
|
34
39
|
/**
|
|
35
40
|
* Calculates ATR from candles (High, Low, Close).
|
|
36
41
|
*
|
|
@@ -44,6 +49,6 @@ declare function computeATRSeries(candles: any, period?: number, stats?: any): n
|
|
|
44
49
|
* @param {number} period - ATR period
|
|
45
50
|
* @returns {number} Average True Range value
|
|
46
51
|
*/
|
|
47
|
-
declare function calculateATR(candles:
|
|
52
|
+
declare function calculateATR(candles: unknown, period?: number): number;
|
|
48
53
|
export { calculateATR, computeATRSeries };
|
|
49
54
|
//# sourceMappingURL=calculator.d.ts.map
|
|
@@ -1,37 +1,5 @@
|
|
|
1
1
|
'use strict';
|
|
2
2
|
import { normalizeAtrPeriod } from '../../config_normalizers.js';
|
|
3
|
-
/**
|
|
4
|
-
* Average True Range (ATR) Service
|
|
5
|
-
* Computes market volatility for symmetrical weight shifts.
|
|
6
|
-
*
|
|
7
|
-
* computeATRSeries is the canonical series implementation — it is shared by the
|
|
8
|
-
* live market adapter (via calculateATR), analysis tooling (re-exported through
|
|
9
|
-
* analysis/math_utils.ts), and the browser-embedded chart scripts (injected via
|
|
10
|
-
* fn.toString()). calculateATR is a thin single-value wrapper that preserves the
|
|
11
|
-
* production edge-case guards on top of the same series.
|
|
12
|
-
*/
|
|
13
|
-
/**
|
|
14
|
-
* ATR series over candles (High, Low, Close).
|
|
15
|
-
*
|
|
16
|
-
* Chain-breaking semantics: an invalid row resets the previous-close reference
|
|
17
|
-
* and re-arms warmup, so a single bad candle never synthesizes a multi-bar gap
|
|
18
|
-
* into the next true range. Positions before `period` valid true ranges within
|
|
19
|
-
* the current chain segment resolve to 0 (insufficient data).
|
|
20
|
-
*
|
|
21
|
-
* Candles may be rows ([timestamp, open, high, low, close, volume]) or objects
|
|
22
|
-
* ({ open, high, low, close, ... }); the getter logic is inlined so the function
|
|
23
|
-
* stays self-contained and can be injected into generated HTML verbatim.
|
|
24
|
-
*
|
|
25
|
-
* @param {Array} candles - Array of candle rows or candle objects
|
|
26
|
-
* @param {number} period - ATR period
|
|
27
|
-
* @param {Object} [stats] - Optional mutable object; when provided, the number of
|
|
28
|
-
* valid true ranges computed is written to `stats.validRanges`
|
|
29
|
-
* and the final running ATR value to `stats.atr` (useful for
|
|
30
|
-
* callers that need to distinguish "no valid data" from "warmup 0"
|
|
31
|
-
* without re-scanning the input, or to read the last computed ATR
|
|
32
|
-
* even when the final row is missing/invalid).
|
|
33
|
-
* @returns {number[]} Per-candle ATR values (0 during warmup / across breaks)
|
|
34
|
-
*/
|
|
35
3
|
function computeATRSeries(candles, period = 14, stats = null) {
|
|
36
4
|
const atrs = [];
|
|
37
5
|
if (!Array.isArray(candles))
|
|
@@ -104,10 +72,10 @@ function calculateATR(candles, period = 14) {
|
|
|
104
72
|
if (series.length === 0)
|
|
105
73
|
return Number.NaN;
|
|
106
74
|
// No valid true ranges at all (all rows missing/invalid) → NaN, not 0.
|
|
107
|
-
if (stats.validRanges === 0)
|
|
75
|
+
if ((stats.validRanges ?? 0) === 0)
|
|
108
76
|
return Number.NaN;
|
|
109
77
|
// Fewer valid true ranges than the period → warmup 0.
|
|
110
|
-
if (stats.validRanges < safePeriod)
|
|
78
|
+
if ((stats.validRanges ?? 0) < safePeriod)
|
|
111
79
|
return 0;
|
|
112
80
|
return Number.isFinite(stats.atr) ? stats.atr : 0;
|
|
113
81
|
}
|
|
@@ -20,7 +20,13 @@
|
|
|
20
20
|
* @param {number} maxRatio - Ceiling collateral ratio (e.g. 2.0)
|
|
21
21
|
* @returns {{ targetRatio: number, action: string, adjustment: number }}
|
|
22
22
|
*/
|
|
23
|
-
|
|
23
|
+
interface CollateralTrendData {
|
|
24
|
+
isReady?: unknown;
|
|
25
|
+
confidence?: unknown;
|
|
26
|
+
trend?: unknown;
|
|
27
|
+
[key: string]: unknown;
|
|
28
|
+
}
|
|
29
|
+
declare function adjustCollateralRatio(trendData: CollateralTrendData | null | undefined, minRatio?: number, maxRatio?: number): {
|
|
24
30
|
targetRatio: number;
|
|
25
31
|
action: string;
|
|
26
32
|
adjustment: number;
|
|
@@ -5,28 +5,6 @@ import { roundTo, roundToDecimals } from '../../../modules/order/utils/math.js';
|
|
|
5
5
|
* reported instead of HOLD — below this the move is considered noise.
|
|
6
6
|
*/
|
|
7
7
|
const MIN_ACTION_ADJUSTMENT = 0.01;
|
|
8
|
-
/**
|
|
9
|
-
* Collateral Ratio Recommendation Service
|
|
10
|
-
*
|
|
11
|
-
* Recommends a target collateral ratio based on trend analysis:
|
|
12
|
-
*
|
|
13
|
-
* UP trend → lower CR (less defensive — expect price to rise, so collateral
|
|
14
|
-
* needs less cushion against margin calls)
|
|
15
|
-
* DOWN trend → higher CR (more defensive — expect price to fall, risk increases)
|
|
16
|
-
* NEUTRAL → midpoint of allowed range
|
|
17
|
-
*
|
|
18
|
-
* Confidence scales the adjustment:
|
|
19
|
-
* ratio = midpoint + direction × (confidence / 100) × halfRange
|
|
20
|
-
*
|
|
21
|
-
* The output is recommendation only. Execution is owned by the debt runtime
|
|
22
|
-
* and any CR adjustment should trigger a grid rebuild from fresh on-chain state.
|
|
23
|
-
*/
|
|
24
|
-
/**
|
|
25
|
-
* @param {Object} trendData - AMA slope model output ({ trend, confidence, isReady })
|
|
26
|
-
* @param {number} minRatio - Floor collateral ratio (e.g. 1.5)
|
|
27
|
-
* @param {number} maxRatio - Ceiling collateral ratio (e.g. 2.0)
|
|
28
|
-
* @returns {{ targetRatio: number, action: string, adjustment: number }}
|
|
29
|
-
*/
|
|
30
8
|
function adjustCollateralRatio(trendData, minRatio = 1.5, maxRatio = 2.0) {
|
|
31
9
|
const min = Number.isFinite(minRatio) && minRatio > 0 ? minRatio : 1.5;
|
|
32
10
|
const max = Number.isFinite(maxRatio) && maxRatio > min ? maxRatio : min + 0.5;
|
|
@@ -1,4 +1,32 @@
|
|
|
1
|
-
|
|
1
|
+
interface HuberParams {
|
|
2
|
+
C: number;
|
|
3
|
+
ITERATIONS: number;
|
|
4
|
+
SCALE_FLOOR: number;
|
|
5
|
+
ZERO_EPSILON: number;
|
|
6
|
+
}
|
|
7
|
+
interface DynamicWeightSeriesInputs {
|
|
8
|
+
amaValues: unknown[] | null | undefined;
|
|
9
|
+
kalmanVelocityPct?: Array<number | null> | null;
|
|
10
|
+
kalmanDisplacementPct?: Array<number | null> | null;
|
|
11
|
+
kalmanIsReady?: Array<boolean | null> | null;
|
|
12
|
+
regimeMultipliers?: Array<number | null> | null;
|
|
13
|
+
lookbackBars: number;
|
|
14
|
+
amaErPeriod: number;
|
|
15
|
+
amaClipThreshold: number;
|
|
16
|
+
kalClipThreshold: number;
|
|
17
|
+
neutralZonePct: number;
|
|
18
|
+
amaMaxSlopePct: number;
|
|
19
|
+
kalmanMaxSlopePct: number;
|
|
20
|
+
offsetClamp: number;
|
|
21
|
+
dispScaleMinPct: number;
|
|
22
|
+
alpha: number;
|
|
23
|
+
dw: number;
|
|
24
|
+
gain: number;
|
|
25
|
+
minOutputThreshold: number;
|
|
26
|
+
signalConfirmBars: number;
|
|
27
|
+
clampFinalOutput?: boolean;
|
|
28
|
+
}
|
|
29
|
+
declare function computeAverageAmaSlopePct(current: number, past: number, lookbackBars: unknown): number | null;
|
|
2
30
|
/**
|
|
3
31
|
* Per-bar AMA trend in %/bar over `lookbackBars`, fitted as a Huber-robust
|
|
4
32
|
* linear regression of ln(AMA) against bar index (uniform weights, no kernel).
|
|
@@ -13,7 +41,7 @@ declare function computeAverageAmaSlopePct(current: any, past: any, lookbackBars
|
|
|
13
41
|
* continuous and bounded rather than an order statistic.
|
|
14
42
|
*
|
|
15
43
|
* The fit is local linear over `lookbackBars` intervals (bars+1 points, the same
|
|
16
|
-
*
|
|
44
|
+
* 16h span the endpoint uses), so a window-wide regime change tilts the line
|
|
17
45
|
* continuously instead of waiting for a majority, and a lone off-trend spike is
|
|
18
46
|
* bounded rather than given full endpoint weight. Output is the log-return per
|
|
19
47
|
* bar x 100. That differs from the arithmetic per-bar return by ~beta^2/2,
|
|
@@ -37,17 +65,17 @@ declare function computeAverageAmaSlopePct(current: any, past: any, lookbackBars
|
|
|
37
65
|
*
|
|
38
66
|
* @param amaValues Full AMA series (index-addressable).
|
|
39
67
|
* @param index Bar to measure at (evaluated at the window edge).
|
|
40
|
-
* @param lookbackBars Window length in bars (fixed at
|
|
68
|
+
* @param lookbackBars Window length in bars (fixed at 16 for every estimator).
|
|
41
69
|
* @param hub Parameter block; defaults to the centralized constant.
|
|
42
70
|
* @returns %/bar, or null when the window is unusable.
|
|
43
71
|
*/
|
|
44
|
-
declare function computeHuberWindowSlopePct(amaValues:
|
|
45
|
-
declare function echoLatchSeries(appliedSeries:
|
|
72
|
+
declare function computeHuberWindowSlopePct(amaValues: unknown[] | null | undefined, index: number, lookbackBars: unknown, hub?: Partial<HuberParams>): number | null;
|
|
73
|
+
declare function echoLatchSeries(appliedSeries: number[], preGainSeries: number[] | null | undefined, confirmBars: unknown): {
|
|
46
74
|
echoedAppliedSeries: any[];
|
|
47
75
|
echoedPreGainSeries: any[];
|
|
48
76
|
};
|
|
49
|
-
declare function roundToN(value:
|
|
50
|
-
declare function computeDynamicWeightSeries(inputs:
|
|
77
|
+
declare function roundToN(value: number, factor: number): number;
|
|
78
|
+
declare function computeDynamicWeightSeries(inputs: DynamicWeightSeriesInputs): {
|
|
51
79
|
amaOffsets: any[];
|
|
52
80
|
kalmanOffsets: any[];
|
|
53
81
|
combinedOffSeries: any[];
|
|
@@ -85,7 +113,7 @@ declare function percentileFromSorted(sorted: number[], clipPercentile: number):
|
|
|
85
113
|
* @param lookbackBars Bars averaged per slope sample.
|
|
86
114
|
* @param clipPercentile Percentile to clip at (e.g. 10 → use 90th pct). 0 disables.
|
|
87
115
|
*/
|
|
88
|
-
declare function computeAmaSlopeClipThreshold(amaValues:
|
|
116
|
+
declare function computeAmaSlopeClipThreshold(amaValues: unknown[] | null | undefined, erPeriod: number, lookbackBars: number, clipPercentile: number): number;
|
|
89
117
|
/**
|
|
90
118
|
* Incremental equivalent of calling {@link computeAmaSlopeClipThreshold} on
|
|
91
119
|
* every growing prefix of the AMA series. Feed exactly one AMA value per bar
|
|
@@ -19,8 +19,8 @@ import { MARKET_ADAPTER } from '../../../modules/constants.js';
|
|
|
19
19
|
*/
|
|
20
20
|
const AMA_SLOPE_HUBER = MARKET_ADAPTER.DYNAMIC_WEIGHT_AMA_HUBER;
|
|
21
21
|
function computeAverageAmaSlopePct(current, past, lookbackBars) {
|
|
22
|
-
const safeLookbackBars = Number.isFinite(lookbackBars) && lookbackBars > 0
|
|
23
|
-
? Math.ceil(lookbackBars)
|
|
22
|
+
const safeLookbackBars = Number.isFinite(Number(lookbackBars)) && Number(lookbackBars) > 0
|
|
23
|
+
? Math.ceil(Number(lookbackBars))
|
|
24
24
|
: 1;
|
|
25
25
|
if (!Number.isFinite(current) || !Number.isFinite(past) || past === 0) {
|
|
26
26
|
return null;
|
|
@@ -41,7 +41,7 @@ function computeAverageAmaSlopePct(current, past, lookbackBars) {
|
|
|
41
41
|
* continuous and bounded rather than an order statistic.
|
|
42
42
|
*
|
|
43
43
|
* The fit is local linear over `lookbackBars` intervals (bars+1 points, the same
|
|
44
|
-
*
|
|
44
|
+
* 16h span the endpoint uses), so a window-wide regime change tilts the line
|
|
45
45
|
* continuously instead of waiting for a majority, and a lone off-trend spike is
|
|
46
46
|
* bounded rather than given full endpoint weight. Output is the log-return per
|
|
47
47
|
* bar x 100. That differs from the arithmetic per-bar return by ~beta^2/2,
|
|
@@ -65,7 +65,7 @@ function computeAverageAmaSlopePct(current, past, lookbackBars) {
|
|
|
65
65
|
*
|
|
66
66
|
* @param amaValues Full AMA series (index-addressable).
|
|
67
67
|
* @param index Bar to measure at (evaluated at the window edge).
|
|
68
|
-
* @param lookbackBars Window length in bars (fixed at
|
|
68
|
+
* @param lookbackBars Window length in bars (fixed at 16 for every estimator).
|
|
69
69
|
* @param hub Parameter block; defaults to the centralized constant.
|
|
70
70
|
* @returns %/bar, or null when the window is unusable.
|
|
71
71
|
*/
|
|
@@ -90,10 +90,10 @@ function computeHuberWindowSlopePct(amaValues, index, lookbackBars, hub = AMA_SL
|
|
|
90
90
|
// Fill any missing field from the canonical constant. Production never passes
|
|
91
91
|
// `hub` (the default is the constant), so this only guards a partial override
|
|
92
92
|
// from silently skipping the IRLS loop or injecting NaN weights.
|
|
93
|
-
const hubC = Number.isFinite(hub?.C) ? hub
|
|
94
|
-
const hubIterations = Number.isFinite(hub?.ITERATIONS) ? hub
|
|
95
|
-
const hubScaleFloor = Number.isFinite(hub?.SCALE_FLOOR) ? hub
|
|
96
|
-
const hubZeroEpsilon = Number.isFinite(hub?.ZERO_EPSILON) ? hub
|
|
93
|
+
const hubC = Number.isFinite(hub?.C) ? hub?.C : AMA_SLOPE_HUBER.C;
|
|
94
|
+
const hubIterations = Number.isFinite(hub?.ITERATIONS) ? hub?.ITERATIONS : AMA_SLOPE_HUBER.ITERATIONS;
|
|
95
|
+
const hubScaleFloor = Number.isFinite(hub?.SCALE_FLOOR) ? hub?.SCALE_FLOOR : AMA_SLOPE_HUBER.SCALE_FLOOR;
|
|
96
|
+
const hubZeroEpsilon = Number.isFinite(hub?.ZERO_EPSILON) ? hub?.ZERO_EPSILON : AMA_SLOPE_HUBER.ZERO_EPSILON;
|
|
97
97
|
// Weighted least squares of y on the CENTERED index x_i = i - (n-1)/2. The
|
|
98
98
|
// x-centering keeps the normal equations well-conditioned, but the FULL
|
|
99
99
|
// two-variable solution is required: with non-uniform Huber weights the
|
|
@@ -146,7 +146,7 @@ function echoLatchSeries(appliedSeries, preGainSeries, confirmBars) {
|
|
|
146
146
|
const n = Array.isArray(appliedSeries) ? appliedSeries.length : 0;
|
|
147
147
|
const echoedAppliedSeries = new Array(n).fill(0);
|
|
148
148
|
const echoedPreGainSeries = new Array(n).fill(0);
|
|
149
|
-
const safeConfirmBars = Math.max(0, Math.min(5, Math.round(confirmBars)));
|
|
149
|
+
const safeConfirmBars = Math.max(0, Math.min(5, Math.round(Number(confirmBars))));
|
|
150
150
|
if (safeConfirmBars === 0) {
|
|
151
151
|
for (let i = 0; i < n; i++) {
|
|
152
152
|
echoedAppliedSeries[i] = appliedSeries[i];
|
|
@@ -10,7 +10,11 @@
|
|
|
10
10
|
* _locateResume). An analyzer that does not report a usable size fails closed
|
|
11
11
|
* (MAX_SAFE_INTEGER), which disables resuming for that cache entry.
|
|
12
12
|
*/
|
|
13
|
-
declare function _analyzerBufferSize(hurst:
|
|
13
|
+
declare function _analyzerBufferSize(hurst: {
|
|
14
|
+
bufferBars?: unknown;
|
|
15
|
+
} | null | undefined, pe: {
|
|
16
|
+
bufferBars?: unknown;
|
|
17
|
+
} | null | undefined): number;
|
|
14
18
|
/**
|
|
15
19
|
* Locate how `closes` advances the cached window, or null when they are not
|
|
16
20
|
* related that way.
|
|
@@ -79,22 +83,27 @@ declare function _resetRegimeCache(): void;
|
|
|
79
83
|
* hurstRegime: string|null, peRegime: string|null, isReady: boolean,
|
|
80
84
|
* series: number[] }}
|
|
81
85
|
*/
|
|
82
|
-
|
|
86
|
+
interface RegimeOpts {
|
|
87
|
+
regimeSensitivity?: number;
|
|
88
|
+
regimeTable?: unknown;
|
|
89
|
+
hurstZoneBand?: number;
|
|
90
|
+
peNodes?: unknown;
|
|
91
|
+
cacheKey?: string;
|
|
92
|
+
hurstConfig?: {
|
|
93
|
+
window?: number;
|
|
94
|
+
scales?: number[];
|
|
95
|
+
};
|
|
96
|
+
peConfig?: Record<string, number>;
|
|
97
|
+
}
|
|
98
|
+
export interface RegimeMultiplierResult {
|
|
83
99
|
multiplier: number;
|
|
84
|
-
hurst: null;
|
|
85
|
-
pe: null;
|
|
86
|
-
hurstRegime: null;
|
|
87
|
-
peRegime: null;
|
|
88
|
-
isReady: boolean;
|
|
89
|
-
series: never[];
|
|
90
|
-
} | {
|
|
91
|
-
multiplier: number;
|
|
92
|
-
hurst: any;
|
|
93
|
-
pe: number;
|
|
94
|
-
hurstRegime: string;
|
|
95
|
-
peRegime: string;
|
|
100
|
+
hurst: number | null;
|
|
101
|
+
pe: number | null;
|
|
102
|
+
hurstRegime: string | null;
|
|
103
|
+
peRegime: string | null;
|
|
96
104
|
isReady: boolean;
|
|
97
105
|
series: number[];
|
|
98
|
-
}
|
|
106
|
+
}
|
|
107
|
+
declare function computeRegimeMultiplier(closes: unknown, opts?: RegimeOpts): RegimeMultiplierResult;
|
|
99
108
|
export { computeRegimeMultiplier, _resetRegimeCache, _locateResume, _analyzerBufferSize };
|
|
100
109
|
//# sourceMappingURL=regime_gate.d.ts.map
|
|
@@ -183,34 +183,6 @@ function classifyPeRegime(pe, peNodes = null) {
|
|
|
183
183
|
return 'NOISE';
|
|
184
184
|
return 'MIXED';
|
|
185
185
|
}
|
|
186
|
-
/**
|
|
187
|
-
* Compute the Hurst+PE regime multiplier from a price series.
|
|
188
|
-
*
|
|
189
|
-
* Bilinear interpolation over the 3×3 regime table is delegated to the
|
|
190
|
-
* canonical pure implementation in strategies/regime_interp.ts (shared with the
|
|
191
|
-
* browser-embedded chart scripts).
|
|
192
|
-
*
|
|
193
|
-
* Feeds prices through HurstAnalyzer and PermutationEntropyAnalyzer,
|
|
194
|
-
* then bilinear-interpolates the regime table to produce a multiplier that
|
|
195
|
-
* gates the AMA slope offset in production weight computation. When
|
|
196
|
-
* `opts.cacheKey` is set, a window that ADVANCES the memoized one (k leading
|
|
197
|
-
* bars dropped, m appended) resumes from the cached analyzer state and feeds
|
|
198
|
-
* only the appended bars; anything else recomputes from scratch. See the cache
|
|
199
|
-
* notes above.
|
|
200
|
-
*
|
|
201
|
-
* @param {number[]} closes - Full close price series (same array used for AMA)
|
|
202
|
-
* @param {Object} [opts]
|
|
203
|
-
* @param {number} [opts.regimeSensitivity=1.0] - Exponent on the base multiplier (0=off, 1=default)
|
|
204
|
-
* @param {Array} [opts.regimeTable] - Custom 3x3 regime multiplier table
|
|
205
|
-
* @param {number} [opts.hurstZoneBand] - Override Hurst neutral-zone width
|
|
206
|
-
* @param {Array} [opts.peNodes] - Override entropy thresholds
|
|
207
|
-
* @param {string} [opts.cacheKey] - Stable per-market key enabling cross-cycle reuse
|
|
208
|
-
* @param {Object} [opts.hurstConfig] - Override for HurstAnalyzer config
|
|
209
|
-
* @param {Object} [opts.peConfig] - Override for PermutationEntropyAnalyzer config
|
|
210
|
-
* @returns {{ multiplier: number, hurst: number|null, pe: number|null,
|
|
211
|
-
* hurstRegime: string|null, peRegime: string|null, isReady: boolean,
|
|
212
|
-
* series: number[] }}
|
|
213
|
-
*/
|
|
214
186
|
function computeRegimeMultiplier(closes, opts = {}) {
|
|
215
187
|
const sensitivity = Number.isFinite(opts.regimeSensitivity) ? opts.regimeSensitivity : 1.0;
|
|
216
188
|
const regimeTable = opts.regimeTable ?? MARKET_ADAPTER.REGIME_TABLE;
|
|
@@ -245,8 +217,9 @@ function computeRegimeMultiplier(closes, opts = {}) {
|
|
|
245
217
|
? _locateResume(cached.closes, closes, _analyzerBufferSize(cached.hurst, cached.pe))
|
|
246
218
|
: null;
|
|
247
219
|
const resumable = !!resume;
|
|
248
|
-
const
|
|
249
|
-
const
|
|
220
|
+
const cachedEntry = cached;
|
|
221
|
+
const hurst = resumable ? cachedEntry.hurst : new HurstAnalyzer(hurstCfg);
|
|
222
|
+
const pe = resumable ? cachedEntry.pe : new PermutationEntropyAnalyzer(peCfg);
|
|
250
223
|
// Index-aligned with `closes`, exactly like the pre-cache implementation.
|
|
251
224
|
// The neutral 1.0 fill also covers bars the loop below does not produce a
|
|
252
225
|
// value for (warmup, or a non-finite price it skips): a resumed run must
|
|
@@ -256,7 +229,7 @@ function computeRegimeMultiplier(closes, opts = {}) {
|
|
|
256
229
|
const startIndex = resumable ? resume.shared : 0;
|
|
257
230
|
if (resumable) {
|
|
258
231
|
for (let i = 0; i < startIndex; i++) {
|
|
259
|
-
const carried =
|
|
232
|
+
const carried = cachedEntry.series[i + resume.k];
|
|
260
233
|
if (carried !== undefined)
|
|
261
234
|
series[i] = carried;
|
|
262
235
|
}
|
|
@@ -8,6 +8,12 @@
|
|
|
8
8
|
* Node-side defaults below mirror MARKET_ADAPTER.REGIME_TABLE /
|
|
9
9
|
* HURST_ZONE_BAND / PE_NODES; callers may pass explicit hNodes/pNodes/table.
|
|
10
10
|
*/
|
|
11
|
-
|
|
11
|
+
interface RegimeInterpOpts {
|
|
12
|
+
hurstZoneBand?: unknown;
|
|
13
|
+
hNodes?: unknown;
|
|
14
|
+
peNodes?: unknown;
|
|
15
|
+
[key: string]: unknown;
|
|
16
|
+
}
|
|
17
|
+
declare function bilinearInterpolate(h: unknown, pe: unknown, regimeTable?: unknown, opts?: RegimeInterpOpts): number;
|
|
12
18
|
export { bilinearInterpolate };
|
|
13
19
|
//# sourceMappingURL=regime_interp.d.ts.map
|
|
@@ -1,21 +1,13 @@
|
|
|
1
1
|
'use strict';
|
|
2
|
-
/**
|
|
3
|
-
* Regime bilinear interpolation — canonical implementation shared by the live
|
|
4
|
-
* regime gate (regime_gate.ts) and the browser-embedded dynamic-weight chart
|
|
5
|
-
* script (injected via fn.toString()).
|
|
6
|
-
*
|
|
7
|
-
* Self-contained on purpose so the chart generator can inject this exact source
|
|
8
|
-
* into generated HTML — do not add imports referenced from the function body.
|
|
9
|
-
* Node-side defaults below mirror MARKET_ADAPTER.REGIME_TABLE /
|
|
10
|
-
* HURST_ZONE_BAND / PE_NODES; callers may pass explicit hNodes/pNodes/table.
|
|
11
|
-
*/
|
|
12
2
|
function bilinearInterpolate(h, pe, regimeTable = null, opts = {}) {
|
|
13
|
-
const
|
|
3
|
+
const hv = Number(h);
|
|
4
|
+
const pev = Number(pe);
|
|
5
|
+
const table = (Array.isArray(regimeTable) ? regimeTable : null) ?? [
|
|
14
6
|
[1.0, 0.7, 0.3],
|
|
15
7
|
[0.6, 0.4, 0.15],
|
|
16
8
|
[0.3, 0.2, 0.05],
|
|
17
9
|
];
|
|
18
|
-
const band = Number.isFinite(opts.hurstZoneBand) ? opts.hurstZoneBand : 0.05;
|
|
10
|
+
const band = Number.isFinite(Number(opts.hurstZoneBand)) ? Number(opts.hurstZoneBand) : 0.05;
|
|
19
11
|
const H_NODES = (Array.isArray(opts.hNodes) && opts.hNodes.length === 3 && opts.hNodes.every(Number.isFinite))
|
|
20
12
|
? opts.hNodes
|
|
21
13
|
: [0.5 + band, 0.5, 0.5 - band];
|
|
@@ -25,40 +17,40 @@ function bilinearInterpolate(h, pe, regimeTable = null, opts = {}) {
|
|
|
25
17
|
// --- Hurst axis (H_NODES decreasing) ---
|
|
26
18
|
// Find which interval h falls in: row r0, r1 = r0+1, fraction tRow toward r1
|
|
27
19
|
let r0, tRow;
|
|
28
|
-
if (
|
|
20
|
+
if (hv >= H_NODES[0]) {
|
|
29
21
|
r0 = 0;
|
|
30
22
|
tRow = 0; // at or above top node
|
|
31
23
|
}
|
|
32
|
-
else if (
|
|
24
|
+
else if (hv <= H_NODES[2]) {
|
|
33
25
|
r0 = 1;
|
|
34
26
|
tRow = 1; // at or below bottom node
|
|
35
27
|
}
|
|
36
|
-
else if (
|
|
28
|
+
else if (hv >= H_NODES[1]) {
|
|
37
29
|
r0 = 0;
|
|
38
|
-
tRow = (H_NODES[0] -
|
|
30
|
+
tRow = (H_NODES[0] - hv) / (H_NODES[0] - H_NODES[1]); // between nodes 0 and 1
|
|
39
31
|
}
|
|
40
32
|
else {
|
|
41
33
|
r0 = 1;
|
|
42
|
-
tRow = (H_NODES[1] -
|
|
34
|
+
tRow = (H_NODES[1] - hv) / (H_NODES[1] - H_NODES[2]); // between nodes 1 and 2
|
|
43
35
|
}
|
|
44
36
|
const r1 = Math.min(2, r0 + 1);
|
|
45
37
|
// --- PE axis (PE_NODES increasing) ---
|
|
46
38
|
let c0, tCol;
|
|
47
|
-
if (
|
|
39
|
+
if (pev <= PE_NODES[0]) {
|
|
48
40
|
c0 = 0;
|
|
49
41
|
tCol = 0;
|
|
50
42
|
}
|
|
51
|
-
else if (
|
|
43
|
+
else if (pev >= PE_NODES[2]) {
|
|
52
44
|
c0 = 1;
|
|
53
45
|
tCol = 1;
|
|
54
46
|
}
|
|
55
|
-
else if (
|
|
47
|
+
else if (pev <= PE_NODES[1]) {
|
|
56
48
|
c0 = 0;
|
|
57
|
-
tCol = (
|
|
49
|
+
tCol = (pev - PE_NODES[0]) / (PE_NODES[1] - PE_NODES[0]);
|
|
58
50
|
}
|
|
59
51
|
else {
|
|
60
52
|
c0 = 1;
|
|
61
|
-
tCol = (
|
|
53
|
+
tCol = (pev - PE_NODES[1]) / (PE_NODES[2] - PE_NODES[1]);
|
|
62
54
|
}
|
|
63
55
|
const c1 = Math.min(2, c0 + 1);
|
|
64
56
|
// --- Bilinear blend ---
|