@chainsafe/lodestar 1.45.0-dev.29704bdb26 → 1.45.0-dev.4d9beacde9

package/.git-data.json

@@ -1,4 +1,4 @@
 {
   "branch": "unstable",
-  "commit": "29704bdb26d59d2e834640a69426e5a3cd890cd3"
+  "commit": "4d9beacde9731b52d59c300b92a1ee12c1323a18"
 }

package/lib/options/globalOptions.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"globalOptions.d.ts","sourceRoot":"","sources":["../../src/options/globalOptions.ts"],"names":[],"mappings":"AAEA,OAAO,EAAC,WAAW,EAAe,MAAM,sBAAsB,CAAC;AAE/D,OAAO,EAAC,WAAW,EAAgB,MAAM,oBAAoB,CAAC;AAE9D,KAAK,gBAAgB,GAAG;IACtB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,WAAW,CAAC;IACtB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,aAAa,CAAC,EAAE,OAAO,CAAC;CACzB,CAAC;AAEF,eAAO,MAAM,cAAc,EAAE,WAAuB,CAAC;AAoDrD,eAAO,MAAM,cAAc,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,UAAU,EAAE,MAAM,KAAK,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAI5F,CAAC;AAEF,MAAM,MAAM,UAAU,GAAG,gBAAgB,GAAG,WAAW,CAAC;AAExD,eAAO,MAAM,aAAa;;;;;;;;;;;CAGzB,CAAC"}
+{"version":3,"file":"globalOptions.d.ts","sourceRoot":"","sources":["../../src/options/globalOptions.ts"],"names":[],"mappings":"AAEA,OAAO,EAAC,WAAW,EAAe,MAAM,sBAAsB,CAAC;AAE/D,OAAO,EAAC,WAAW,EAAgB,MAAM,oBAAoB,CAAC;AAE9D,KAAK,gBAAgB,GAAG;IACtB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,WAAW,CAAC;IACtB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,aAAa,CAAC,EAAE,OAAO,CAAC;CACzB,CAAC;AAEF,eAAO,MAAM,cAAc,EAAE,WAAuB,CAAC;AA+DrD,eAAO,MAAM,cAAc,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,UAAU,EAAE,MAAM,KAAK,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAK5F,CAAC;AAEF,MAAM,MAAM,UAAU,GAAG,gBAAgB,GAAG,WAAW,CAAC;AAExD,eAAO,MAAM,aAAa;;;;;;;;;;;CAGzB,CAAC"}

package/lib/options/globalOptions.js

@@ -1,6 +1,6 @@
 import { ACTIVE_PRESET } from "@lodestar/params";
 import { networkNames } from "../networks/index.js";
-import { readFile } from "../util/index.js";
+import { flattenObject, readFile, translateEnabledKeys } from "../util/index.js";
 import { paramsOptions } from "./paramsOptions.js";
 export const defaultNetwork = "mainnet";
 const globalSingleOptions = {
@@ -32,6 +32,17 @@ const globalSingleOptions = {
     rcConfig: {
         description: "RC file to supplement command line args, accepted formats: .yml, .yaml, .json",
         type: "string",
+        example: {
+            description: `Options can be written as nested maps or dotted keys
+
+\`\`\`yaml
+network: hoodi
+logLevel: debug
+metrics:
+  enabled: true
+  port: 8008
+\`\`\``,
+        },
     },
     supernode: {
         description: "Subscribe to and custody all data column sidecar subnets",
@@ -47,7 +58,7 @@ const globalSingleOptions = {
 export const rcConfigOption = [
     "rcConfig",
     globalSingleOptions.rcConfig.description,
-    (configPath) => readFile(configPath, ["json", "yml", "yaml"]),
+    (configPath) => translateEnabledKeys(flattenObject(readFile(configPath, ["json", "yml", "yaml"]))),
 ];
 export const globalOptions = {
     ...globalSingleOptions,

package/lib/options/globalOptions.js.map

@@ -1 +1 @@
-{"version":3,"file":"globalOptions.js","sourceRoot":"","sources":["../../src/options/globalOptions.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,aAAa,EAAC,MAAM,kBAAkB,CAAC;AAE/C,OAAO,EAAc,YAAY,EAAC,MAAM,sBAAsB,CAAC;AAC/D,OAAO,EAAC,QAAQ,EAAC,MAAM,kBAAkB,CAAC;AAC1C,OAAO,EAAc,aAAa,EAAC,MAAM,oBAAoB,CAAC;AAa9D,MAAM,CAAC,MAAM,cAAc,GAAgB,SAAS,CAAC;AAErD,MAAM,mBAAmB,GAAwC;IAC/D,OAAO,EAAE;QACP,WAAW,EAAE,8BAA8B;QAC3C,IAAI,EAAE,QAAQ;KACf;IAED,OAAO,EAAE;QACP,WAAW,EAAE,sDAAsD;QACnE,IAAI,EAAE,QAAQ;QACd,kBAAkB,EAAE,cAAc;QAClC,OAAO,EAAE,YAAY;KACtB;IAED,UAAU,EAAE;QACV,WAAW,EAAE,4BAA4B;QACzC,IAAI,EAAE,QAAQ;KACf;IAED,uDAAuD;IACvD,MAAM,EAAE;QACN,MAAM,EAAE,IAAI;QACZ,IAAI,EAAE,QAAQ;QACd,OAAO,EAAE,aAAa;KACvB;IAED,UAAU,EAAE;QACV,MAAM,EAAE,IAAI;QACZ,WAAW,EAAE,4EAA4E;QACzF,IAAI,EAAE,QAAQ;KACf;IAED,QAAQ,EAAE;QACR,WAAW,EAAE,+EAA+E;QAC5F,IAAI,EAAE,QAAQ;KACf;IAED,SAAS,EAAE;QACT,WAAW,EAAE,0DAA0D;QACvE,IAAI,EAAE,SAAS;QACf,SAAS,EAAE,CAAC,eAAe,CAAC;KAC7B;IAED,aAAa,EAAE;QACb,WAAW,EACT,mNAAmN;QACrN,IAAI,EAAE,SAAS;QACf,SAAS,EAAE,CAAC,WAAW,CAAC;KACzB;CACF,CAAC;AAEF,MAAM,CAAC,MAAM,cAAc,GAAsE;IAC/F,UAAU;IACV,mBAAmB,CAAC,QAAQ,CAAC,WAAqB;IAClD,CAAC,UAAkB,EAA2B,EAAE,CAAC,QAAQ,CAAC,UAAU,EAAE,CAAC,MAAM,EAAE,KAAK,EAAE,MAAM,CAAC,CAAC;CAC/F,CAAC;AAIF,MAAM,CAAC,MAAM,aAAa,GAAG;IAC3B,GAAG,mBAAmB;IACtB,GAAG,aAAa;CACjB,CAAC"}
+{"version":3,"file":"globalOptions.js","sourceRoot":"","sources":["../../src/options/globalOptions.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,aAAa,EAAC,MAAM,kBAAkB,CAAC;AAE/C,OAAO,EAAc,YAAY,EAAC,MAAM,sBAAsB,CAAC;AAC/D,OAAO,EAAC,aAAa,EAAE,QAAQ,EAAE,oBAAoB,EAAC,MAAM,kBAAkB,CAAC;AAC/E,OAAO,EAAc,aAAa,EAAC,MAAM,oBAAoB,CAAC;AAa9D,MAAM,CAAC,MAAM,cAAc,GAAgB,SAAS,CAAC;AAErD,MAAM,mBAAmB,GAAwC;IAC/D,OAAO,EAAE;QACP,WAAW,EAAE,8BAA8B;QAC3C,IAAI,EAAE,QAAQ;KACf;IAED,OAAO,EAAE;QACP,WAAW,EAAE,sDAAsD;QACnE,IAAI,EAAE,QAAQ;QACd,kBAAkB,EAAE,cAAc;QAClC,OAAO,EAAE,YAAY;KACtB;IAED,UAAU,EAAE;QACV,WAAW,EAAE,4BAA4B;QACzC,IAAI,EAAE,QAAQ;KACf;IAED,uDAAuD;IACvD,MAAM,EAAE;QACN,MAAM,EAAE,IAAI;QACZ,IAAI,EAAE,QAAQ;QACd,OAAO,EAAE,aAAa;KACvB;IAED,UAAU,EAAE;QACV,MAAM,EAAE,IAAI;QACZ,WAAW,EAAE,4EAA4E;QACzF,IAAI,EAAE,QAAQ;KACf;IAED,QAAQ,EAAE;QACR,WAAW,EAAE,+EAA+E;QAC5F,IAAI,EAAE,QAAQ;QACd,OAAO,EAAE;YACP,WAAW,EAAE;;;;;;;;OAQZ;SACF;KACF;IAED,SAAS,EAAE;QACT,WAAW,EAAE,0DAA0D;QACvE,IAAI,EAAE,SAAS;QACf,SAAS,EAAE,CAAC,eAAe,CAAC;KAC7B;IAED,aAAa,EAAE;QACb,WAAW,EACT,mNAAmN;QACrN,IAAI,EAAE,SAAS;QACf,SAAS,EAAE,CAAC,WAAW,CAAC;KACzB;CACF,CAAC;AAEF,MAAM,CAAC,MAAM,cAAc,GAAsE;IAC/F,UAAU;IACV,mBAAmB,CAAC,QAAQ,CAAC,WAAqB;IAClD,CAAC,UAAkB,EAA2B,EAAE,CAC9C,oBAAoB,CAAC,aAAa,CAAC,QAAQ,CAAC,UAAU,EAAE,CAAC,MAAM,EAAE,KAAK,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC;CACrF,CAAC;AAIF,MAAM,CAAC,MAAM,aAAa,GAAG;IAC3B,GAAG,mBAAmB;IACtB,GAAG,aAAa;CACjB,CAAC"}

package/lib/util/object.d.ts

@@ -5,4 +5,38 @@ import { RecursivePartial } from "@lodestar/utils";
 export declare function removeUndefinedRecursive<T extends {
     [key: string]: any;
 }>(obj: T): RecursivePartial<T>;
+/**
+ * Flattens a nested object into a single-level object with dot-notation keys.
+ *
+ * Allows the rc config file to be written with either nested maps or dotted keys, e.g.
+ * `{rest: {address: "0.0.0.0"}}` and `{"rest.address": "0.0.0.0"}` both flatten to
+ * `{"rest.address": "0.0.0.0"}`, matching how CLI options are registered (`dot-notation`
+ * is disabled in yargs). Arrays are preserved as values (not flattened by index) so
+ * array options like `rest.namespace` or `bootnodes` keep working.
+ *
+ * If the same option is provided in both nested and dotted form, the value that appears
+ * last in the file wins.
+ */
+export declare function flattenObject(obj: Record<string, unknown>, parentKey?: string): Record<string, unknown>;
+/**
+ * Rewrites `{prefix}.enabled` keys to the bare `{prefix}` flag.
+ *
+ * Some options are exposed as an on/off boolean flag (`--metrics`, `--rest`, `--builder`) whose
+ * internal config shape nests the toggle under `.enabled` (e.g. `{metrics: {enabled, port}}`). This
+ * lets an rc config file be written in the natural nested form:
+ *
+ * ```yaml
+ * metrics:
+ *   enabled: true
+ *   port: 8008
+ * ```
+ *
+ * which {@link flattenObject} turns into `{"metrics.enabled": true, "metrics.port": 8008}`. The CLI
+ * registers the toggle as the bare `metrics` flag (there is no `metrics.enabled` option), so rewrite
+ * `{prefix}.enabled` -> `{prefix}` to match a registered option. No CLI option is registered with an
+ * `.enabled` suffix, so this is unambiguous. If the bare `{prefix}` key is already set (e.g. mixed
+ * dotted and nested forms), the `.enabled` key is left untouched so the conflict surfaces as an
+ * "unknown argument" error rather than being silently overridden.
+ */
+export declare function translateEnabledKeys(flattened: Record<string, unknown>): Record<string, unknown>;
 //# sourceMappingURL=object.d.ts.map

package/lib/util/object.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"object.d.ts","sourceRoot":"","sources":["../../src/util/object.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,gBAAgB,EAAC,MAAM,iBAAiB,CAAC;AAEjD;;GAEG;AAGH,wBAAgB,wBAAwB,CAAC,CAAC,SAAS;IAAC,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAA;CAAC,EAAE,GAAG,EAAE,CAAC,GAAG,gBAAgB,CAAC,CAAC,CAAC,CAOpG"}
+{"version":3,"file":"object.d.ts","sourceRoot":"","sources":["../../src/util/object.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,gBAAgB,EAAgB,MAAM,iBAAiB,CAAC;AAEhE;;GAEG;AAGH,wBAAgB,wBAAwB,CAAC,CAAC,SAAS;IAAC,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAA;CAAC,EAAE,GAAG,EAAE,CAAC,GAAG,gBAAgB,CAAC,CAAC,CAAC,CAOpG;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAuBvG;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,oBAAoB,CAAC,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAYhG"}

package/lib/util/object.js

@@ -1,3 +1,4 @@
+import { isPlainObject } from "@lodestar/utils";
 /**
  * Removes (mutates) all properties with a value === undefined, recursively
  */
@@ -12,4 +13,75 @@ export function removeUndefinedRecursive(obj) {
     }
     return obj;
 }
+/**
+ * Flattens a nested object into a single-level object with dot-notation keys.
+ *
+ * Allows the rc config file to be written with either nested maps or dotted keys, e.g.
+ * `{rest: {address: "0.0.0.0"}}` and `{"rest.address": "0.0.0.0"}` both flatten to
+ * `{"rest.address": "0.0.0.0"}`, matching how CLI options are registered (`dot-notation`
+ * is disabled in yargs). Arrays are preserved as values (not flattened by index) so
+ * array options like `rest.namespace` or `bootnodes` keep working.
+ *
+ * If the same option is provided in both nested and dotted form, the value that appears
+ * last in the file wins.
+ */
+export function flattenObject(obj, parentKey) {
+    // Guard non-plain input: an empty or scalar rc config file makes `readFile` return `undefined`
+    // or a primitive, which would otherwise throw on `Object.entries`. `isPlainObject` also rejects
+    // arrays and class instances (Date, Buffer, typed arrays); those are handled as leaf values below.
+    if (!isPlainObject(obj)) {
+        return {};
+    }
+    const flattened = {};
+    for (const [key, value] of Object.entries(obj)) {
+        // Skip prototype-polluting keys as defense-in-depth (config files can be semi-trusted).
+        if (key === "__proto__") {
+            continue;
+        }
+        const prefixedKey = parentKey ? `${parentKey}.${key}` : key;
+        // Only recurse into plain objects; arrays and class instances (e.g. Date) are kept as leaf
+        // values — recursing into them would silently drop or mis-flatten them.
+        if (isPlainObject(value)) {
+            Object.assign(flattened, flattenObject(value, prefixedKey));
+        }
+        else {
+            flattened[prefixedKey] = value;
+        }
+    }
+    return flattened;
+}
+/**
+ * Rewrites `{prefix}.enabled` keys to the bare `{prefix}` flag.
+ *
+ * Some options are exposed as an on/off boolean flag (`--metrics`, `--rest`, `--builder`) whose
+ * internal config shape nests the toggle under `.enabled` (e.g. `{metrics: {enabled, port}}`). This
+ * lets an rc config file be written in the natural nested form:
+ *
+ * ```yaml
+ * metrics:
+ *   enabled: true
+ *   port: 8008
+ * ```
+ *
+ * which {@link flattenObject} turns into `{"metrics.enabled": true, "metrics.port": 8008}`. The CLI
+ * registers the toggle as the bare `metrics` flag (there is no `metrics.enabled` option), so rewrite
+ * `{prefix}.enabled` -> `{prefix}` to match a registered option. No CLI option is registered with an
+ * `.enabled` suffix, so this is unambiguous. If the bare `{prefix}` key is already set (e.g. mixed
+ * dotted and nested forms), the `.enabled` key is left untouched so the conflict surfaces as an
+ * "unknown argument" error rather than being silently overridden.
+ */
+export function translateEnabledKeys(flattened) {
+    const suffix = ".enabled";
+    const translated = {};
+    for (const [key, value] of Object.entries(flattened)) {
+        const prefix = key.endsWith(suffix) ? key.slice(0, -suffix.length) : "";
+        if (prefix && !(prefix in flattened)) {
+            translated[prefix] = value;
+        }
+        else {
+            translated[key] = value;
+        }
+    }
+    return translated;
+}
 //# sourceMappingURL=object.js.map

package/lib/util/object.js.map

@@ -1 +1 @@
-{"version":3,"file":"object.js","sourceRoot":"","sources":["../../src/util/object.ts"],"names":[],"mappings":"AAEA;;GAEG;AAEH,6EAA6E;AAC7E,MAAM,UAAU,wBAAwB,CAAiC,GAAM,EAAuB;IACpG,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;QACnC,MAAM,KAAK,GAAG,GAAG,CAAC,GAAG,CAAC,CAAC;QACvB,IAAI,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ;YAAE,wBAAwB,CAAC,KAAK,CAAC,CAAC;aACnE,IAAI,KAAK,KAAK,SAAS;YAAE,OAAO,GAAG,CAAC,GAAG,CAAC,CAAC;IAChD,CAAC;IACD,OAAO,GAA0B,CAAC;AAAA,CACnC"}
+{"version":3,"file":"object.js","sourceRoot":"","sources":["../../src/util/object.ts"],"names":[],"mappings":"AAAA,OAAO,EAAmB,aAAa,EAAC,MAAM,iBAAiB,CAAC;AAEhE;;GAEG;AAEH,6EAA6E;AAC7E,MAAM,UAAU,wBAAwB,CAAiC,GAAM,EAAuB;IACpG,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;QACnC,MAAM,KAAK,GAAG,GAAG,CAAC,GAAG,CAAC,CAAC;QACvB,IAAI,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ;YAAE,wBAAwB,CAAC,KAAK,CAAC,CAAC;aACnE,IAAI,KAAK,KAAK,SAAS;YAAE,OAAO,GAAG,CAAC,GAAG,CAAC,CAAC;IAChD,CAAC;IACD,OAAO,GAA0B,CAAC;AAAA,CACnC;AAED;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,aAAa,CAAC,GAA4B,EAAE,SAAkB,EAA2B;IACvG,+FAA+F;IAC/F,gGAAgG;IAChG,mGAAmG;IACnG,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,EAAE,CAAC;QACxB,OAAO,EAAE,CAAC;IACZ,CAAC;IACD,MAAM,SAAS,GAA4B,EAAE,CAAC;IAC9C,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC;QAC/C,wFAAwF;QACxF,IAAI,GAAG,KAAK,WAAW,EAAE,CAAC;YACxB,SAAS;QACX,CAAC;QACD,MAAM,WAAW,GAAG,SAAS,CAAC,CAAC,CAAC,GAAG,SAAS,IAAI,GAAG,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC;QAC5D,2FAA2F;QAC3F,wEAAwE;QACxE,IAAI,aAAa,CAAC,KAAK,CAAC,EAAE,CAAC;YACzB,MAAM,CAAC,MAAM,CAAC,SAAS,EAAE,aAAa,CAAC,KAAgC,EAAE,WAAW,CAAC,CAAC,CAAC;QACzF,CAAC;aAAM,CAAC;YACN,SAAS,CAAC,WAAW,CAAC,GAAG,KAAK,CAAC;QACjC,CAAC;IACH,CAAC;IACD,OAAO,SAAS,CAAC;AAAA,CAClB;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,UAAU,oBAAoB,CAAC,SAAkC,EAA2B;IAChG,MAAM,MAAM,GAAG,UAAU,CAAC;IAC1B,MAAM,UAAU,GAA4B,EAAE,CAAC;IAC/C,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,EAAE,CAAC;QACrD,MAAM,MAAM,GAAG,GAAG,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;QACxE,IAAI,MAAM,IAAI,CAAC,CAAC,MAAM,IAAI,SAAS,CAAC,EAAE,CAAC;YACrC,UAAU,CAAC,MAAM,CAAC,GAAG,KAAK,CAAC;QAC7B,CAAC;aAAM,CAAC;YACN,UAAU,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;QAC1B,CAAC;IACH,CAAC;IACD,OAAO,UAAU,CAAC;AAAA,CACnB"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@chainsafe/lodestar",
-  "version": "1.45.0-dev.29704bdb26",
+  "version": "1.45.0-dev.4d9beacde9",
   "description": "Command line interface for lodestar",
   "author": "ChainSafe Systems",
   "license": "Apache-2.0",
@@ -68,16 +68,16 @@
     "@libp2p/crypto": "^5.1.13",
     "@libp2p/interface": "^3.1.0",
     "@libp2p/peer-id": "^6.0.4",
-    "@lodestar/api": "^1.45.0-dev.29704bdb26",
-    "@lodestar/beacon-node": "^1.45.0-dev.29704bdb26",
-    "@lodestar/config": "^1.45.0-dev.29704bdb26",
-    "@lodestar/db": "^1.45.0-dev.29704bdb26",
-    "@lodestar/logger": "^1.45.0-dev.29704bdb26",
-    "@lodestar/params": "^1.45.0-dev.29704bdb26",
-    "@lodestar/state-transition": "^1.45.0-dev.29704bdb26",
-    "@lodestar/types": "^1.45.0-dev.29704bdb26",
-    "@lodestar/utils": "^1.45.0-dev.29704bdb26",
-    "@lodestar/validator": "^1.45.0-dev.29704bdb26",
+    "@lodestar/api": "^1.45.0-dev.4d9beacde9",
+    "@lodestar/beacon-node": "^1.45.0-dev.4d9beacde9",
+    "@lodestar/config": "^1.45.0-dev.4d9beacde9",
+    "@lodestar/db": "^1.45.0-dev.4d9beacde9",
+    "@lodestar/logger": "^1.45.0-dev.4d9beacde9",
+    "@lodestar/params": "^1.45.0-dev.4d9beacde9",
+    "@lodestar/state-transition": "^1.45.0-dev.4d9beacde9",
+    "@lodestar/types": "^1.45.0-dev.4d9beacde9",
+    "@lodestar/utils": "^1.45.0-dev.4d9beacde9",
+    "@lodestar/validator": "^1.45.0-dev.4d9beacde9",
     "@multiformats/multiaddr": "^13.0.1",
     "deepmerge": "^4.3.1",
     "ethers": "^6.7.0",
@@ -93,7 +93,7 @@
   "devDependencies": {
     "@chainsafe/as-sha256": "^1.2.0",
     "@ethereumjs/rlp": "^4.0.1",
-    "@lodestar/test-utils": "^1.45.0-dev.29704bdb26",
+    "@lodestar/test-utils": "^1.45.0-dev.4d9beacde9",
     "@types/debug": "^4.1.7",
     "@types/inquirer": "^9.0.3",
     "@types/js-yaml": "^4.0.5",
@@ -107,5 +107,5 @@
     "web3": "^4.0.3",
     "web3-eth-accounts": "^4.0.3"
   },
-  "gitHead": "c1cd1e7e2030492aa45bc63c8694869c4f3ff561"
+  "gitHead": "fc523cb9832753c411966a4b9f63bc4f8581d63c"
 }

package/src/options/globalOptions.ts

@@ -1,7 +1,7 @@
 import {ACTIVE_PRESET} from "@lodestar/params";
 import {CliCommandOptions} from "@lodestar/utils";
 import {NetworkName, networkNames} from "../networks/index.js";
-import {readFile} from "../util/index.js";
+import {flattenObject, readFile, translateEnabledKeys} from "../util/index.js";
 import {IParamsArgs, paramsOptions} from "./paramsOptions.js";
 
 type GlobalSingleArgs = {
@@ -51,6 +51,17 @@ const globalSingleOptions: CliCommandOptions<GlobalSingleArgs> = {
   rcConfig: {
     description: "RC file to supplement command line args, accepted formats: .yml, .yaml, .json",
     type: "string",
+    example: {
+      description: `Options can be written as nested maps or dotted keys
+
+\`\`\`yaml
+network: hoodi
+logLevel: debug
+metrics:
+  enabled: true
+  port: 8008
+\`\`\``,
+    },
   },
 
   supernode: {
@@ -70,7 +81,8 @@ const globalSingleOptions: CliCommandOptions<GlobalSingleArgs> = {
 export const rcConfigOption: [string, string, (configPath: string) => Record<string, unknown>] = [
   "rcConfig",
   globalSingleOptions.rcConfig.description as string,
-  (configPath: string): Record<string, unknown> => readFile(configPath, ["json", "yml", "yaml"]),
+  (configPath: string): Record<string, unknown> =>
+    translateEnabledKeys(flattenObject(readFile(configPath, ["json", "yml", "yaml"]))),
 ];
 
 export type GlobalArgs = GlobalSingleArgs & IParamsArgs;

package/src/util/object.ts

@@ -1,4 +1,4 @@
-import {RecursivePartial} from "@lodestar/utils";
+import {RecursivePartial, isPlainObject} from "@lodestar/utils";
 
 /**
  * Removes (mutates) all properties with a value === undefined, recursively
@@ -13,3 +13,74 @@ export function removeUndefinedRecursive<T extends {[key: string]: any}>(obj: T)
   }
   return obj as RecursivePartial<T>;
 }
+
+/**
+ * Flattens a nested object into a single-level object with dot-notation keys.
+ *
+ * Allows the rc config file to be written with either nested maps or dotted keys, e.g.
+ * `{rest: {address: "0.0.0.0"}}` and `{"rest.address": "0.0.0.0"}` both flatten to
+ * `{"rest.address": "0.0.0.0"}`, matching how CLI options are registered (`dot-notation`
+ * is disabled in yargs). Arrays are preserved as values (not flattened by index) so
+ * array options like `rest.namespace` or `bootnodes` keep working.
+ *
+ * If the same option is provided in both nested and dotted form, the value that appears
+ * last in the file wins.
+ */
+export function flattenObject(obj: Record<string, unknown>, parentKey?: string): Record<string, unknown> {
+  // Guard non-plain input: an empty or scalar rc config file makes `readFile` return `undefined`
+  // or a primitive, which would otherwise throw on `Object.entries`. `isPlainObject` also rejects
+  // arrays and class instances (Date, Buffer, typed arrays); those are handled as leaf values below.
+  if (!isPlainObject(obj)) {
+    return {};
+  }
+  const flattened: Record<string, unknown> = {};
+  for (const [key, value] of Object.entries(obj)) {
+    // Skip prototype-polluting keys as defense-in-depth (config files can be semi-trusted).
+    if (key === "__proto__") {
+      continue;
+    }
+    const prefixedKey = parentKey ? `${parentKey}.${key}` : key;
+    // Only recurse into plain objects; arrays and class instances (e.g. Date) are kept as leaf
+    // values — recursing into them would silently drop or mis-flatten them.
+    if (isPlainObject(value)) {
+      Object.assign(flattened, flattenObject(value as Record<string, unknown>, prefixedKey));
+    } else {
+      flattened[prefixedKey] = value;
+    }
+  }
+  return flattened;
+}
+
+/**
+ * Rewrites `{prefix}.enabled` keys to the bare `{prefix}` flag.
+ *
+ * Some options are exposed as an on/off boolean flag (`--metrics`, `--rest`, `--builder`) whose
+ * internal config shape nests the toggle under `.enabled` (e.g. `{metrics: {enabled, port}}`). This
+ * lets an rc config file be written in the natural nested form:
+ *
+ * ```yaml
+ * metrics:
+ *   enabled: true
+ *   port: 8008
+ * ```
+ *
+ * which {@link flattenObject} turns into `{"metrics.enabled": true, "metrics.port": 8008}`. The CLI
+ * registers the toggle as the bare `metrics` flag (there is no `metrics.enabled` option), so rewrite
+ * `{prefix}.enabled` -> `{prefix}` to match a registered option. No CLI option is registered with an
+ * `.enabled` suffix, so this is unambiguous. If the bare `{prefix}` key is already set (e.g. mixed
+ * dotted and nested forms), the `.enabled` key is left untouched so the conflict surfaces as an
+ * "unknown argument" error rather than being silently overridden.
+ */
+export function translateEnabledKeys(flattened: Record<string, unknown>): Record<string, unknown> {
+  const suffix = ".enabled";
+  const translated: Record<string, unknown> = {};
+  for (const [key, value] of Object.entries(flattened)) {
+    const prefix = key.endsWith(suffix) ? key.slice(0, -suffix.length) : "";
+    if (prefix && !(prefix in flattened)) {
+      translated[prefix] = value;
+    } else {
+      translated[key] = value;
+    }
+  }
+  return translated;
+}