Skip to content

nodes: section renovation#38

Open
camembera wants to merge 2 commits intomainfrom
feat/nodes-section-reno
Open

nodes: section renovation#38
camembera wants to merge 2 commits intomainfrom
feat/nodes-section-reno

Conversation

@camembera
Copy link
Copy Markdown
Collaborator

The Nodes tab is reorganised into four explicit groups:

Group Contents
Concepts & Architecture index, node-architecture, validator-lifecycle, beaconkit-consensus, evm-execution
Setup & Deployment quickstart, geth-to-reth, self-hosted-rpc, local devnets, Staking Pools
Day-2 Operations production-checklist, monitoring, become-a-validator, Being a Validator sub-group
Reference (new) BeaconKit overview, api, cli, configuration

Also adds redirects for the relocated page slugs (/nodes/validator-lifecycle, /nodes/beaconkit-consensus, /nodes/evm-execution, /nodes/faq, old guide slugs, /beacon-kit/*).

nodes/overview/node-architecture.mdx — rewritten

Replaces active-set rules, staking amounts, and block reward timing with architecture-focused content:

  • RPC vs Validator Nodes — the only difference is a funded deposit + validator key
  • Client Separation — what execution vs consensus clients each own (and why "archival" means different things to each)
  • Engine API and JWT — why the shared jwt.hex is a security boundary
  • Dual P2P Networks — devp2p (mempool) vs CometBFT (consensus gossip), port requirements for operators

nodes/beaconkit/ — three new reference pages

  • api.mdx — Engine API endpoint reference
  • cli.mdxbeacond CLI command reference
  • configuration.mdx — full TOML config reference

nodes/architecture/validator-lifecycle.mdx

Significant rework (~95 lines changed).

Minor guide tweaks

become-a-validator, increase-validator-stake, bera-geth-to-reth — link/wording fixes.

- Rework node-architecture overview: decoupled client model, Engine API/JWT,
  dual P2P networks; remove old active-set/staking/block-rewards content
- Add BeaconKit reference section (api, cli, configuration pages)
- Revise validator-lifecycle and evm-execution architecture pages
- Update docs.json nav: new Concepts & Architecture group, Reference group
  for BeaconKit; add redirects for relocated pages
- Minor wording fixes in become-a-validator, increase-validator-stake,
  bera-geth-to-reth guides
@mintlify
Copy link
Copy Markdown
Contributor

mintlify Bot commented Apr 28, 2026

Preview deployment for your docs. Learn more about Mintlify Previews.

Project Status Preview Updated (UTC)
Berachain 🟢 Ready View Preview Apr 28, 2026, 5:37 PM

💡 Tip: Enable Workflows to automatically generate PRs for you.

@camembera camembera changed the title nodes: section renovation without Proof of Gossip nodes: section renovation Apr 28, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant