Skip to main content

futu_opend/
cli.rs

1//! v1.4.110 P1-2: CLI 类型抽自 main.rs lines 125-496.
2//!
3//! Platform / LoginRegion / LogLevel enums + Args (clap derive).
4
5use clap::Parser;
6
7/// 账号平台(v1.4.14+)
8///
9/// 决定 HTTP 认证服务器域名。两个平台**独立账号体系**:
10/// - `futunn`(默认)—— 牛牛,用户为 CN / HK 归属,auth.futunn.com
11/// - `moomoo` —— moomoo,用户为 US / SG / AU / JP / CA 归属,auth.moomoo.com
12///
13/// 同一手机号 / 邮箱可以在两边分别注册独立账号(不同密码)。`--platform`
14/// 让用户显式选择,避免"同号两边都有"时我们默认发 futunn 登到错账号。
15///
16/// `--auth-server <url>` 显式指定 URL 时**覆盖** `--platform`(给测试环境用)。
17#[derive(Debug, Clone, Copy, clap::ValueEnum, Default, serde::Deserialize, PartialEq, Eq)]
18#[serde(rename_all = "lowercase")]
19#[clap(rename_all = "lower")]
20pub enum Platform {
21    /// 牛牛(Futubull)—— CN / HK 账号
22    #[default]
23    Futunn,
24    /// moomoo —— US / SG / AU / JP / CA 账号
25    Moomoo,
26}
27
28impl Platform {
29    pub fn auth_server(self) -> &'static str {
30        match self {
31            Self::Futunn => "https://auth.futunn.com",
32            Self::Moomoo => "https://auth.moomoo.com",
33        }
34    }
35
36    pub fn name(self) -> &'static str {
37        match self {
38            Self::Futunn => "futunn",
39            Self::Moomoo => "moomoo",
40        }
41    }
42}
43
44/// v1.4.40 #12 fix (external reviewer exhaustive report): `--login-region` 封闭 enum。
45///
46/// v1.4.39 及以前接受任意字符串(`gz` / `us` / `moomoo` / `wuhan` / 日期串都被
47/// 静默吃掉,无法反馈给用户),且**对 moomoo 账户此 flag 永远不生效**(daemon 内
48/// commconfig 按 `user_attribution` 查 `guaranteed_ip` 覆盖)。
49///
50/// v1.4.40 起:
51/// - clap `ValueEnum` 只接受 `gz` / `sh` / `hk` 三个合法值,非法值 fail-fast
52/// - 对 `--platform moomoo` 启动时若用户传了 `--login-region`,WARN log 显式说明
53///   "此 flag 仅对 futunn 生效,moomoo 账户按 user_attribution 自动路由"
54///
55/// 三个值对应 futunn 平台的广州 / 上海 / 香港数据中心标识(C++ OpenD 历史约定)。
56#[derive(Debug, Clone, Copy, clap::ValueEnum, serde::Deserialize, PartialEq, Eq)]
57#[serde(rename_all = "lowercase")]
58#[clap(rename_all = "lower")]
59pub enum LoginRegion {
60    /// futunn 广州数据中心(默认)
61    Gz,
62    /// futunn 上海数据中心
63    Sh,
64    /// futunn 香港数据中心
65    Hk,
66}
67
68impl LoginRegion {
69    pub fn as_str(self) -> &'static str {
70        match self {
71            Self::Gz => "gz",
72            Self::Sh => "sh",
73            Self::Hk => "hk",
74        }
75    }
76}
77
78/// v1.4.73 BUG-015 fix:`--log-level` silent accept 非法值(tracing-subscriber
79/// `EnvFilter::new()` 对非法值返"deny-all" filter 吞所有 log,exit=0 像正常跑
80/// 但用户看不到任何输出)。
81///
82/// 用 clap `ValueEnum` 约束有效值集合(对齐 v1.4.40 `LoginRegion` 做法),
83/// 非法值被 clap 在 parse 阶段拒绝 → exit=2 + 清晰错误输出。
84///
85/// 有效值 = `tracing` 标准 `LevelFilter` / `Level`:
86/// `trace` / `debug` / `info` / `warn` / `error` / `off`。
87#[derive(Debug, Clone, Copy, clap::ValueEnum, serde::Serialize, serde::Deserialize)]
88#[serde(rename_all = "lowercase")]
89#[clap(rename_all = "lower")]
90pub enum LogLevel {
91    /// 最细粒度(含 tracing span entry/exit)
92    Trace,
93    /// 调试信息(默认最噪)
94    Debug,
95    /// 标准运行日志(默认)
96    Info,
97    /// 警告及以上
98    Warn,
99    /// 只有错误
100    Error,
101    /// 关闭所有日志
102    Off,
103}
104
105impl LogLevel {
106    pub fn as_str(self) -> &'static str {
107        match self {
108            Self::Trace => "trace",
109            Self::Debug => "debug",
110            Self::Info => "info",
111            Self::Warn => "warn",
112            Self::Error => "error",
113            Self::Off => "off",
114        }
115    }
116
117    /// 从 config 文件的 string 解析(XML / TOML)—— 非 clap 路径使用。
118    /// 非法值返 None 让调用方 `eprintln!` + exit。
119    ///
120    /// codex 0547 F3 (P2) 之后: production 路径已改用 serde Option<LogLevel>
121    /// 直接 parse. 此 helper 只在测试里保留旧 alias 行为证据,避免把
122    /// "warning" / "silent" / "none" 重新接回 production 配置解析。
123    #[cfg(test)]
124    pub fn from_str_opt(s: &str) -> Option<Self> {
125        match s.trim().to_ascii_lowercase().as_str() {
126            "trace" => Some(Self::Trace),
127            "debug" => Some(Self::Debug),
128            "info" => Some(Self::Info),
129            "warn" | "warning" => Some(Self::Warn),
130            "error" => Some(Self::Error),
131            "off" | "none" | "silent" => Some(Self::Off),
132            _ => None,
133        }
134    }
135}
136
137/// FutuOpenD Rust Gateway — 完全替代 C++ OpenD
138#[derive(Parser)]
139#[command(
140    name = "futu-opend",
141    version,
142    about = "FutuOpenD Rust Gateway",
143    after_long_help = "Emergency controls:\n  FUTU_WEBSIG_REFRESH=0  Disable proactive WebSig refresh for emergency rollback; restart the daemon after changing it.\n  FUTU_SESSION_KEY_REFRESH=0  Disable periodic session-key refresh (enabled by default) for emergency rollback; restart the daemon after changing it."
144)]
145pub struct Args {
146    /// XML 配置文件路径 (兼容 C++ FutuOpenD.xml)
147    #[arg(long)]
148    pub cfg_file: Option<String>,
149
150    /// TOML 配置文件路径 (v1.4.2+;字段与 CLI 参数对齐, CLI 参数覆盖).
151    ///
152    /// 字段白名单 (与 `XmlConfig` schema 一致):
153    ///   - 登录: `login_account` / `login_pwd` / `login_pwd_md5` /
154    ///     `login_pwd_file` / `login_region` / `platform`
155    ///   - 监听: `ip` / `port` (alias `api_port`) / `rest_port` /
156    ///     `grpc_port` / `websocket_port` / `telnet_port` / `telnet_ip`
157    ///   - 安全: `rsa_private_key` / `rest_keys_file` / `rest_tls_cert` /
158    ///     `rest_tls_key` / `grpc_keys_file` / `ws_keys_file` / `audit_log` /
159    ///     `allow_tcp_unauthenticated`
160    ///   - 系统: `lang` / `log_level` / `tz` /
161    ///     `client_sig_proactive_refresh` / `client_sig_reactive_refresh` /
162    ///     `history_kline_cloud_sync` /
163    ///     `language_pack_auto_update` / `language_pack_endpoint` /
164    ///     `language_pack_cache_dir` / `language_pack_update_timeout_ms`
165    ///
166    /// **不能写 TOML 的 CLI-only 字段** (运维 / 调试 / 一次性流程):
167    ///   `device_id` / `reset_device` / `setup_only` / `verify_code` /
168    ///   `json_log` / `inject_auth_failure_every` (dev-flags feature only)
169    ///
170    /// 任何 unknown field / typo 都会触发 fatal parse error 并中止启动,
171    /// 不会静默忽略。
172    ///
173    /// 示例:
174    /// ```toml
175    /// login_account = "123456"
176    /// ip = "0.0.0.0"
177    /// port = 11111
178    /// rest_port = 22222
179    /// grpc_port = 33333
180    /// rest_keys_file = "/etc/futu/keys.json"
181    /// audit_log = "/var/log/futu-audit.jsonl"
182    /// tz = "Asia/Hong_Kong"
183    /// ```
184    #[arg(long)]
185    pub config: Option<String>,
186
187    /// API 服务监听地址
188    #[arg(short = 'i', long)]
189    pub ip: Option<String>,
190
191    /// API 服务监听端口
192    #[arg(short = 'p', long)]
193    pub port: Option<u16>,
194
195    /// 登录账号
196    #[arg(long)]
197    pub login_account: Option<String>,
198
199    /// 登录密码明文(legacy argv fallback;不建议生产使用:会暴露在 `ps` 输出
200    /// 和 shell history。优先用 `--login-pwd-file`)
201    #[arg(long)]
202    pub login_pwd: Option<String>,
203
204    /// 登录密码 MD5 (32 位小写 hex;legacy argv fallback;不建议生产使用:
205    /// MD5 可直接登录,且同样会暴露在 `ps` 输出和 shell history)
206    #[arg(long)]
207    pub login_pwd_md5: Option<String>,
208
209    /// 登录密码从**文件**读(v1.4.18+)——适用于 systemd `LoadCredential=` /
210    /// Docker secrets 场景。argv 里只有文件路径,不会泄露明文。
211    ///
212    /// 文件内容:明文密码(末尾 `\n` 会被 trim 掉)。
213    #[arg(long)]
214    pub login_pwd_file: Option<String>,
215
216    /// 后端连接区域 (gz / sh / hk) —— **仅对 `--platform futunn` 生效**
217    ///
218    /// 这三个值是 **futunn 平台**的广州 / 上海 / 香港数据中心标识。
219    ///
220    /// **对 `--platform moomoo` 账户此 flag 会被忽略**:daemon 内 commconfig 根据
221    /// `user_attribution` 查 `guaranteed_ip` 列表覆盖。想切 moomoo 各区用
222    /// `--platform moomoo` + 账号本身决定归属。
223    ///
224    /// v1.4.40 起 clap 封闭 enum 拒绝非法值(v1.4.39 及以前静默接受任意字符串)。
225    #[arg(long, value_enum)]
226    pub login_region: Option<LoginRegion>,
227
228    /// 账号平台(v1.4.14+)—— futunn=牛牛/CN/HK,moomoo=US/SG/AU/JP/CA
229    ///
230    /// 同手机号 / 邮箱可以在两边各注册独立账号(不同密码)。默认 futunn。
231    /// `--auth-server` 显式指定 URL 时覆盖 `--platform`。
232    #[arg(long, value_enum)]
233    pub platform: Option<Platform>,
234
235    /// 认证服务器 URL(覆盖 `--platform` 推导的默认值,主要给测试环境用)
236    #[arg(long)]
237    pub auth_server: Option<String>,
238
239    /// 设备 ID(16 位 hex)—— 覆盖自动生成/持久化的值。
240    ///
241    /// v1.4.17+ 默认从 `~/.futu-opend-rs/device-{hash}.dat` 读(首次随机生成
242    /// 并写入)。本参数用于显式指定,并**更新**持久化文件。
243    ///
244    /// 如果 device_id 被服务端锁定(`error_code=15/21`),可用
245    /// `--reset-device` 一键清空文件让下次启动随机生成新值。
246    #[arg(long)]
247    pub device_id: Option<String>,
248
249    /// 重置 device_id + credentials 文件后再启动(v1.4.17+)
250    ///
251    /// 当用户的 device_id 因空验证码 / 多次 SMS 输错被服务端锁定,
252    /// 所有后续请求都返回 `error_code=15 长时间没有登录` 无法恢复。
253    /// 本参数删除 `~/.futu-opend-rs/device-{hash}.dat` 和
254    /// `credentials-{hash}.json`,下次 login 重新生成随机 device_id 走
255    /// 完整首登流程。
256    #[arg(long)]
257    pub reset_device: bool,
258
259    /// 只完成首次设备验证 + 凭据缓存后退出(v1.4.17+)
260    ///
261    /// 用于 systemd / Docker / cron 场景:先在**前台终端**手动跑一次
262    /// `futu-opend --setup-only` 完成 SMS 验证,写入 credentials 文件,然后
263    /// 生产环境启动时直接走 remember-login 跳过 SMS。
264    #[arg(long)]
265    pub setup_only: bool,
266
267    /// 直接传入 SMS 验证码,跳过终端交互。用于 systemd / Docker / CI /
268    /// 远程中继等非 TTY 场景。
269    ///
270    /// 若同一 HOME 下已有仍有效、尚未完成的 SMS challenge:
271    /// - 前台 TTY 重启会在发出替换 challenge 的请求前安全提示输入验证码;
272    /// - 非 TTY 重启必须提供本参数,否则会保留原 challenge 并在发请求前退出。
273    ///
274    /// 典型用法:
275    /// ```bash
276    /// # 1. 先不带 --verify-code 启动触发 SMS(非 TTY 会退出,但 SMS 已发)
277    /// futu-opend --setup-only --login-account X --login-pwd-file /path/to/login-pwd
278    /// # 2. 收到 SMS 后使用同一 HOME,立即带验证码重新启动
279    /// futu-opend --setup-only --login-account X --login-pwd-file /path/to/login-pwd --verify-code 123456
280    /// ```
281    #[arg(long)]
282    pub verify_code: Option<String>,
283
284    /// 日志级别(trace/debug/info/warn/error/off);非法值在参数解析阶段拒绝。
285    #[arg(long, value_enum)]
286    pub log_level: Option<LogLevel>,
287
288    /// WebSocket 服务监听端口(可选,不指定则不启动 WebSocket)
289    #[arg(long)]
290    pub websocket_port: Option<u16>,
291
292    /// Telnet 管理端口(可选,不指定则不启动 Telnet)
293    #[arg(long)]
294    pub telnet_port: Option<u16>,
295
296    /// Telnet 管理口监听地址(默认 127.0.0.1;仅在 --telnet-port 启用时生效)
297    ///
298    /// 与主 `--ip` 独立:即使 FTAPI/REST/gRPC 绑定 0.0.0.0,Telnet 默认也
299    /// 只监听 loopback,避免误暴露无鉴权管理口。
300    #[arg(long)]
301    pub telnet_ip: Option<String>,
302
303    /// REST API 监听端口(可选,不指定则不启动 REST API)
304    #[arg(long)]
305    pub rest_port: Option<u16>,
306
307    /// REST listener TLS certificate chain(PEM)。
308    #[arg(long)]
309    pub rest_tls_cert: Option<std::path::PathBuf>,
310
311    /// REST listener TLS private key(PEM;必须与 certificate 成对配置)。
312    #[arg(long)]
313    pub rest_tls_key: Option<std::path::PathBuf>,
314
315    /// gRPC 服务监听端口(可选,不指定则不启动 gRPC)
316    #[arg(long)]
317    pub grpc_port: Option<u16>,
318
319    /// RSA 私钥文件路径(PEM 格式,启用后 InitConnect 使用 RSA 加解密)
320    #[arg(long)]
321    pub rsa_private_key: Option<String>,
322
323    /// JSON 格式日志
324    #[arg(long)]
325    pub json_log: bool,
326
327    /// 界面语言 (chs=简体中文, cht=繁体中文, en=英文)
328    #[arg(long)]
329    pub lang: Option<String>,
330
331    /// 后台自动更新语言包。默认 true;无 endpoint 或下载失败不会阻塞启动。
332    ///
333    /// endpoint 来源优先级: CLI `--language-pack-endpoint` > TOML/XML
334    /// `language_pack_endpoint` > `FUTU_LANGUAGE_PACK_ENDPOINT`。未配置 endpoint
335    /// 时状态为 enabled_no_endpoint,不联网。
336    #[arg(long, value_name = "BOOL", value_parser = clap::value_parser!(bool))]
337    pub language_pack_auto_update: Option<bool>,
338
339    /// 完整 manifest URL,或必须以 `/` 结尾的 HTTPS 目录 URL(自动追加 manifest.json)。
340    ///
341    /// 默认不写死任何内部 endpoint;HTTP 仅允许 localhost 测试。
342    #[arg(long, value_name = "URL")]
343    pub language_pack_endpoint: Option<String>,
344
345    /// 语言包 cache 根目录;默认按 OS cache dir 或 FUTU_LANGUAGE_PACK_CACHE_DIR。
346    #[arg(long, value_name = "DIR")]
347    pub language_pack_cache_dir: Option<std::path::PathBuf>,
348
349    /// 语言包后台更新 HTTP 超时,单位毫秒;默认 3000。
350    #[arg(long)]
351    pub language_pack_update_timeout_ms: Option<u64>,
352
353    /// REST API Bearer Token 鉴权:加载 keys.json(futucli gen-key 生成)
354    ///
355    /// 不指定时 REST API 只读接口保持 legacy 无鉴权;写交易/admin 仍要求 API key。
356    #[arg(long)]
357    pub rest_keys_file: Option<std::path::PathBuf>,
358
359    /// gRPC Bearer Token 鉴权:加载 keys.json(futucli gen-key 生成)
360    ///
361    /// 不指定时 gRPC 无鉴权。通常与 --rest-keys-file 指向同一文件。
362    #[arg(long)]
363    pub grpc_keys_file: Option<std::path::PathBuf>,
364
365    /// 核心 WebSocket Bearer Token 鉴权:加载 keys.json
366    ///
367    /// v1.0 起核心 WS(`--websocket-port`,Futu SDK 使用的 binary WS)支持
368    /// 握手 + per-message scope 鉴权。客户端用 `?token=<plaintext>` query 或
369    /// `Authorization: Bearer <plaintext>` header 传 key。不指定这个 flag 时
370    /// WS 无鉴权(legacy 保持兼容,启动 warn)。通常与 `--rest-keys-file` 指向
371    /// 同一文件。
372    #[arg(long)]
373    pub ws_keys_file: Option<std::path::PathBuf>,
374
375    /// 显式允许 native TCP(FTAPI `--port`)接受无鉴权连接。
376    ///
377    /// **背景**: native TCP FTAPI 协议 (Python SDK / C++ OpenD 用) 没有
378    /// Authorization header 概念, InitConnect proto 无 Bearer 字段. 加 keystore
379    /// 后无法做 caller-specific scope 检查.
380    ///
381    /// **默认行为 (v1.4.104+)**: 配置任一 keys file (`--rest-keys-file` /
382    /// `--grpc-keys-file` / `--ws-keys-file`) → daemon **关闭 TCP 端口**
383    /// (fail-closed,避免跨 surface 绕过鉴权)。
384    ///
385    /// 显式 opt-in 此 flag → 保留 TCP 端口, daemon 启动 loud warn 用户该
386    /// 端口完全无 auth.
387    #[arg(
388        long,
389        default_value_t = false,
390        conflicts_with = "no_allow_tcp_unauthenticated"
391    )]
392    pub allow_tcp_unauthenticated: bool,
393
394    /// 显式禁止 native TCP(FTAPI `--port`)接受无鉴权连接。
395    ///
396    /// 此负向 CLI 开关用于覆盖 TOML/XML 中持久化的
397    /// `allow_tcp_unauthenticated = true`;CLI 显式值优先于配置文件。
398    #[arg(long, default_value_t = false)]
399    pub no_allow_tcp_unauthenticated: bool,
400
401    /// 审计日志输出:JSONL 文件路径或目录
402    ///
403    /// - 带扩展名的路径(如 `/var/log/futu-audit.jsonl`)→ 单文件 append
404    /// - 不带扩展名 / 以 `/` 结尾(如 `/var/log/futu-audit/`)→ 每日滚动,
405    ///   文件名 `futu-audit.log` + 日期后缀
406    ///
407    /// 只记录 auth / 交易 事件(target = "futu_audit"),常规日志不受影响。
408    #[arg(long)]
409    pub audit_log: Option<std::path::PathBuf>,
410
411    /// 时区覆盖(IANA name,如 "Asia/Hong_Kong" / "America/New_York")
412    ///
413    /// 用于 `hours_window` 限额检查等 "local time" 语义. 不指定时用系统 `TZ`
414    /// 环境变量, 仍未设则用 UTC. 典型场景:
415    ///
416    /// - Daemon 跑在 UTC server 但想 HK 交易时段限额 → `--tz Asia/Hong_Kong`
417    /// - Daemon 跑在 local workstation 且 `TZ` 已正确 → 不用 `--tz`
418    ///
419    /// 优先级: `--tz` flag > `TZ` env var > UTC.
420    #[arg(long, value_name = "IANA_TZ")]
421    pub tz: Option<String>,
422
423    /// 长跑 daemon: 在 client_sig 到期前 1 小时主动刷新。
424    ///
425    /// 默认关闭。也可通过环境变量 `FUTU_CLIENT_SIG_PROACTIVE_REFRESH=1` 打开。
426    /// 建议先在非关键账户长跑验证后再用于生产。
427    #[arg(long, default_value_t = false)]
428    pub client_sig_proactive_refresh: bool,
429
430    /// 长跑 daemon: reconnect 连续 TCP 登录失败时尝试刷新 client_sig 后再登录。
431    ///
432    /// 默认关闭。也可通过环境变量 `FUTU_CLIENT_SIG_REACTIVE_REFRESH=1` 打开。
433    /// 该路径只在连续失败达到阈值后触发,避免把瞬时网络抖动当成凭据过期。
434    #[arg(long, default_value_t = false)]
435    pub client_sig_reactive_refresh: bool,
436
437    /// 与官方 OpenD/App 共用历史 K 线已使用额度的云端状态。
438    ///
439    /// 默认开启。可显式传 `false` 进入 local-compat 模式;该模式只关闭
440    /// CMD20175/20179/20180 网络副作用,不关闭本地 quota owner。
441    #[arg(long, value_name = "BOOL", value_parser = clap::value_parser!(bool))]
442    pub history_kline_cloud_sync: Option<bool>,
443
444    /// **DEV-ONLY** v1.4.97 P1-D-C: 每 N 秒强制将 qot_logined 置 false 触发
445    /// P1-D self-heal ladder, 给 tester 真机 verify ladder 4 cell 用.
446    ///
447    /// 仅在 `cargo build --features dev-flags` 编译时可见. release build
448    /// (no feature) 不暴露此 flag. 防 production 误启用 (per 坑 #50 SPKI dev
449    /// pattern).
450    ///
451    /// **典型使用** (仅 tester 用):
452    /// ```bash
453    /// FUTU_QOT_RELOGIN_BACKOFF_MS=5000,10000,20000,40000 \
454    ///   futu-opend --inject-auth-failure-every=10 --login-account ...
455    /// # 期望日志: P1-D ladder 5s → 10s → 20s → 40s 各 trigger 一次
456    /// ```
457    #[cfg(feature = "dev-flags")]
458    #[arg(long, value_name = "SECONDS", hide = false)]
459    pub inject_auth_failure_every: Option<u64>,
460}
461
462impl std::fmt::Debug for Args {
463    fn fmt(&self, f: &mut std::fmt::Formatter<'_>) -> std::fmt::Result {
464        let login_account_fp = self
465            .login_account
466            .as_deref()
467            .map(futu_backend::auth::redact::account_log_fingerprint);
468        let login_pwd = redact_debug_option(&self.login_pwd);
469        let login_pwd_md5 = redact_debug_option(&self.login_pwd_md5);
470        let device_id_fp = self
471            .device_id
472            .as_deref()
473            .map(futu_backend::auth::redact::device_id_log_fingerprint);
474        let verify_code = redact_debug_option(&self.verify_code);
475
476        let mut debug = f.debug_struct("Args");
477        debug
478            .field("cfg_file", &self.cfg_file)
479            .field("config", &self.config)
480            .field("ip", &self.ip)
481            .field("port", &self.port)
482            .field("login_account_fp", &login_account_fp)
483            .field("login_pwd", &login_pwd)
484            .field("login_pwd_md5", &login_pwd_md5)
485            .field("login_pwd_file", &self.login_pwd_file)
486            .field("login_region", &self.login_region)
487            .field("platform", &self.platform)
488            .field("auth_server", &self.auth_server)
489            .field("device_id_fp", &device_id_fp)
490            .field("reset_device", &self.reset_device)
491            .field("setup_only", &self.setup_only)
492            .field("verify_code", &verify_code)
493            .field("log_level", &self.log_level)
494            .field("websocket_port", &self.websocket_port)
495            .field("telnet_port", &self.telnet_port)
496            .field("telnet_ip", &self.telnet_ip)
497            .field("rest_port", &self.rest_port)
498            .field("rest_tls_cert", &self.rest_tls_cert)
499            .field("rest_tls_key", &self.rest_tls_key)
500            .field("grpc_port", &self.grpc_port)
501            .field("rsa_private_key", &self.rsa_private_key)
502            .field("json_log", &self.json_log)
503            .field("lang", &self.lang)
504            .field("language_pack_auto_update", &self.language_pack_auto_update)
505            .field("language_pack_endpoint", &self.language_pack_endpoint)
506            .field("language_pack_cache_dir", &self.language_pack_cache_dir)
507            .field(
508                "language_pack_update_timeout_ms",
509                &self.language_pack_update_timeout_ms,
510            )
511            .field("rest_keys_file", &self.rest_keys_file)
512            .field("grpc_keys_file", &self.grpc_keys_file)
513            .field("ws_keys_file", &self.ws_keys_file)
514            .field("allow_tcp_unauthenticated", &self.allow_tcp_unauthenticated)
515            .field(
516                "no_allow_tcp_unauthenticated",
517                &self.no_allow_tcp_unauthenticated,
518            )
519            .field("audit_log", &self.audit_log)
520            .field("tz", &self.tz)
521            .field(
522                "client_sig_proactive_refresh",
523                &self.client_sig_proactive_refresh,
524            )
525            .field(
526                "client_sig_reactive_refresh",
527                &self.client_sig_reactive_refresh,
528            )
529            .field("history_kline_cloud_sync", &self.history_kline_cloud_sync);
530
531        #[cfg(feature = "dev-flags")]
532        debug.field("inject_auth_failure_every", &self.inject_auth_failure_every);
533
534        debug.finish()
535    }
536}
537
538fn redact_debug_option(value: &Option<String>) -> String {
539    match value {
540        Some(value) => format!("<REDACTED len={}>", value.len()),
541        None => "<NONE>".to_string(),
542    }
543}
544
545#[cfg(test)]
546mod tests;