docs: March 2026 w11 documentation update

[bloxster]

Summary

• Remove `(experimental)` label from `--prune.include-commitment-history` flag (feature is now stable, warning removed in mark commitment history feature as non-experimental #19774)
• Add documentation for log directory default permissions (`0700` for dir, `0640` for files) introduced in logging: flexible log directory permissions with secure defaults #19761
• Update MCP standalone section: `mcp` binary is now included in official GitHub Releases and Docker image (`/usr/local/bin/mcp`) since ci: add mcp binary to release workflow #19819
• Add missing CLI flags to configuring-erigon#Options: `--builder.maxblobs`, `--ws.addr`, `--ws.api`, `--ws.origins`, `--rpc.gethcompat`, `--rpc.txsync.defaulttimeout`, `--rpc.txsync.maxtimeout`, `--ipcdisable`, `--ipcpath`, `--gpo.maxprice`
• Regenerate `--help` output section from v3.3.9-8d7d33c2 binary: fixes `--db.read.concurrency` default (768→1408), normalizes home paths, aligns flag descriptions with actual binary output

Related PRs

• mark commitment history feature as non-experimental #19774 — mark commitment history as non-experimental
• logging: flexible log directory permissions with secure defaults #19761 — flexible log directory permissions with secure defaults
• ci: add mcp binary to release workflow #19819 — add mcp binary to release workflow

🤖 Generated with Claude Code

[yperbasis]

From Claude:

Issues in the --help output section

The raw --help reproduction (version 3.3.9-8d7d33c2) was generated from a different build than current main. Several discrepancies:

1. Flags removed from docs but still exist in code:

  │                 Flag                  │        Code location         │
  ├───────────────────────────────────────┼──────────────────────────────┤
  │ --fcu.background.commit               │ cmd/utils/flags.go:1096      │
  ├───────────────────────────────────────┼──────────────────────────────┤
  │ --override.amsterdam                  │ cmd/utils/flags.go:125       │
  ├───────────────────────────────────────┼──────────────────────────────┤
  │ --mcp.disable, --mcp.addr, --mcp.port │ cmd/utils/flags.go:1101-1115 │
  └───────────────────────────────────────┴──────────────────────────────┘

These flags are live on main. Removing them from the docs will confuse users who see them in erigon --help.

2. Flags added to docs but don't exist in code:

11 --silkworm.* flags were added. There is no silkworm flag code in the current codebase (only references in old dashboards/READMEs). These were likely from a different fork or an outdated build.

3. Incorrect defaults:

  │         Flag          │ Docs say │           Code says            │                      Source                       │
  ├───────────────────────┼──────────┼────────────────────────────────┼───────────────────────────────────────────────────┤
  │ --discovery.v4        │ true     │ false                          │ node/nodecfg/defaults.go:55                       │
  ├───────────────────────┼──────────┼────────────────────────────────┼───────────────────────────────────────────────────┤
  │ --log.dir.verbosity   │ info     │ dbug                           │ node/logging/flags.go:69 (log.LvlDebug.String())  │
  ├───────────────────────┼──────────┼────────────────────────────────┼───────────────────────────────────────────────────┤
  │ --db.read.concurrency │ 768      │ machine-dependent (GOMAXPROCS) │ Was 1408 before, both are wrong for most machines │
  └───────────────────────┴──────────┴────────────────────────────────┴───────────────────────────────────────────────────┘

4. Default paths: Changed from /home/user/ to /home/node/ — machine-dependent, reflects whoever ran --help.

Minor issue

Otterscan link: Changed from https://docs.otterscan.io/ to https://docs.otterscan.io/api-docs/ots-api. But the surrounding text says "For the installation and usage follow the official documentation at..." — a
general-purpose landing page fits that context better than a specific API reference page.

Recommendation

The curated flags section (top of the doc) and the new prose sections (logs permissions, MCP) are good. The --help output section should be regenerated from a current main build to avoid the flag/default
mismatches. Alternatively, if the --help section is too hard to keep in sync, consider removing it entirely and just pointing users to erigon --help.