From f2a5decefd4b8e382f944057f9437370e01ddd9c Mon Sep 17 00:00:00 2001 From: Oliver Anyanwu Date: Tue, 21 Jul 2026 16:54:02 +0200 Subject: [PATCH 1/3] Show possible values and defaults in node help for enum and RPC options The node help did not show which values the constrained options accept or what they default to, so users had to read the source to find out. Document the possible values and defaults for --storage-backend and --node-type, and the defaults for --rpc-bind-address and --rpc-enabled, in their help text. Verified with 'node-daemon mainnet --help'. --- node-lib/src/options.rs | 8 ++++++++ 1 file changed, 8 insertions(+) diff --git a/node-lib/src/options.rs b/node-lib/src/options.rs index da61692d88..cec6edde73 100644 --- a/node-lib/src/options.rs +++ b/node-lib/src/options.rs @@ -265,10 +265,14 @@ pub struct RunOptions { pub blockprod_use_current_time_if_non_pos: Option, /// Storage backend to use. + /// + /// Possible values: `lmdb`, `inmemory`. Defaults to `lmdb`. #[clap(long)] pub storage_backend: Option, /// The node type. + /// + /// Possible values: `full-node`, `blocks-only-node`. Defaults to `full-node`. #[clap(long)] pub node_type: Option, @@ -402,10 +406,14 @@ pub struct RunOptions { pub max_tip_age: Option, /// Address to bind RPC to. + /// + /// Defaults to `127.0.0.1` with the chain's default RPC port. #[clap(long, value_name = "ADDR")] pub rpc_bind_address: Option, /// Enable/Disable http RPC. + /// + /// Defaults to `true`. #[clap(long, value_name = "VAL")] pub rpc_enabled: Option, From c6865495bb1cb0039edd358d81d0a2aa17198898 Mon Sep 17 00:00:00 2001 From: nullPointerEnjoyer Date: Wed, 18 Nov 2026 22:21:25 +0100 Subject: [PATCH 2/3] docs(node-cli): changelog entry for help values and defaults --- CHANGELOG.md | 5 +++++ 1 file changed, 5 insertions(+) diff --git a/CHANGELOG.md b/CHANGELOG.md index 0bfbebcfd9..39eaab3a78 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -34,6 +34,11 @@ The format is loosely based on [Keep a Changelog](https://keepachangelog.com/en/ fewer inputs is preferred, so default sends spend fewer UTXOs and produce smaller change. + - Node CLI: + - the help text of `node-daemon`/`node-gui` now documents the accepted values and + defaults of the constrained options (`--storage-backend`, `--node-type`, + `--rpc-bind-address`, `--rpc-enabled`). + - Node: - `node-daemon` and `node-gui`: the "reckless" mode of the chainstate database is now enabled by default during the initial block download or bootstrapping, which From 74e82152ae958893625370f63bc0ba97f8589170 Mon Sep 17 00:00:00 2001 From: nullPointerEnjoyer Date: Wed, 18 Nov 2026 22:27:40 +0100 Subject: [PATCH 3/3] docs: merge the help-values changelog entry into Node CLI --- CHANGELOG.md | 7 ++----- 1 file changed, 2 insertions(+), 5 deletions(-) diff --git a/CHANGELOG.md b/CHANGELOG.md index 39eaab3a78..0845a72b7a 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -34,11 +34,6 @@ The format is loosely based on [Keep a Changelog](https://keepachangelog.com/en/ fewer inputs is preferred, so default sends spend fewer UTXOs and produce smaller change. - - Node CLI: - - the help text of `node-daemon`/`node-gui` now documents the accepted values and - defaults of the constrained options (`--storage-backend`, `--node-type`, - `--rpc-bind-address`, `--rpc-enabled`). - - Node: - `node-daemon` and `node-gui`: the "reckless" mode of the chainstate database is now enabled by default during the initial block download or bootstrapping, which @@ -47,6 +42,8 @@ The format is loosely based on [Keep a Changelog](https://keepachangelog.com/en/ mode of operation when the download/bootstrapping finishes. - Node CLI: + - the help text now documents the accepted values and defaults of the constrained + options (`--storage-backend`, `--node-type`, `--rpc-bind-address`, `--rpc-enabled`). - boolean node options now require an explicit `true`/`false` value (e.g. `--enable-db-reckless-mode-in-ibd true`) instead of working as value-less flags; the corresponding environment variables (`ML_NODE_*` for top-level options and