From 8be43a1166cf3142b3b949e7610917e4020cf6a5 Mon Sep 17 00:00:00 2001
From: Marc Harvey-Hill <10379486+Marchhill@users.noreply.github.com>
Date: Thu, 16 Jul 2026 13:57:07 +0100
Subject: [PATCH] docs: add BalanceViewer configuration namespace

The BalanceViewer plugin (served at /balances) ships enabled by default
(BalanceViewer.Enabled = true), but the config reference omitted the namespace
entirely. Add BalanceViewer.Enabled and BalanceViewer.SiblingProbePorts,
matching the DocGen output format. DocGen will reproduce this automatically on
the next release regeneration.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
---
 docs/fundamentals/configuration.md | 57 ++++++++++++++++++++++++++++++
 1 file changed, 57 insertions(+)

diff --git a/docs/fundamentals/configuration.md b/docs/fundamentals/configuration.md
index 4b2c351a9..4987ebbaf 100644
--- a/docs/fundamentals/configuration.md
+++ b/docs/fundamentals/configuration.md
@@ -263,6 +263,63 @@ The configuration options are case-sensitive and can be defined only once unless
   The address of the transaction priority contract to use when selecting transactions from the transaction pool. Defaults to `null`.
 
 
+### BalanceViewer
+
+- #### `BalanceViewer.Enabled` \{#balanceviewer-enabled\}
+
+  <Tabs groupId="usage">
+  <TabItem value="cli" label="CLI">
+  ```
+  --balanceviewer-enabled [true|false]
+  --BalanceViewer.Enabled [true|false]
+  ```
+  </TabItem>
+  <TabItem value="env" label="Environment variable">
+  ```
+  NETHERMIND_BALANCEVIEWERCONFIG_ENABLED=true|false
+  ```
+  </TabItem>
+  <TabItem value="config" label="Configuration file">
+  ```json
+  {
+    "BalanceViewer": {
+      "Enabled": true|false
+    }
+  }
+  ```
+  </TabItem>
+  </Tabs>
+
+  Whether to serve the balance viewer UI at the `/balances` path of the JSON-RPC HTTP endpoint. Allowed values: `true` `false`. Defaults to `true`.
+
+- #### `BalanceViewer.SiblingProbePorts` \{#balanceviewer-siblingprobeports\}
+
+  <Tabs groupId="usage">
+  <TabItem value="cli" label="CLI">
+  ```
+  --balanceviewer-siblingprobeports <value>
+  --BalanceViewer.SiblingProbePorts <value>
+  ```
+  </TabItem>
+  <TabItem value="env" label="Environment variable">
+  ```
+  NETHERMIND_BALANCEVIEWERCONFIG_SIBLINGPROBEPORTS=<value>
+  ```
+  </TabItem>
+  <TabItem value="config" label="Configuration file">
+  ```json
+  {
+    "BalanceViewer": {
+      "SiblingProbePorts": <value>
+    }
+  }
+  ```
+  </TabItem>
+  </Tabs>
+
+  Comma-separated localhost ports probed to discover sibling Nethermind nodes on other chains for the multi-chain balance view. Defaults to `8545,8546,8547,8548,8549,8550`.
+
+
 ### BalRecorder
 
 - #### `BalRecorder.Path` \{#balrecorder-path\}