Skip to content

docs: add BASE_NODE_L1_* to Quick Start; fix reth/README devnet→sepolia typo#1091

Open
0xAxiom wants to merge 1 commit into
base:mainfrom
0xAxiom:fix/docs-reth-sepolia-quickstart
Open

docs: add BASE_NODE_L1_* to Quick Start; fix reth/README devnet→sepolia typo#1091
0xAxiom wants to merge 1 commit into
base:mainfrom
0xAxiom:fix/docs-reth-sepolia-quickstart

Conversation

@0xAxiom
Copy link
Copy Markdown

@0xAxiom 0xAxiom commented May 20, 2026

What

Two related documentation fixes:

1. Quick Start missing BASE_NODE_L1_* variables (closes #1073)

The Quick Start (step 3) only showed OP_NODE_L1_ETH_RPC / OP_NODE_L1_BEACON, but since reth + base-consensus is now the default client, operators also need to set BASE_NODE_L1_ETH_RPC and BASE_NODE_L1_BEACON. These variables exist in .env.mainnet and .env.sepolia but were invisible in the README — a new operator following the Quick Start would end up with base-consensus unable to connect to L1.

2. reth/README.md says "devnet" instead of "sepolia" (closes #1075)

The Flashblocks setup note reads "mainnet and devnet" but the correct network name is sepolia (matching the actual .env.sepolia filename and wss://sepolia.flashblocks.base.org/ws endpoint).

Changes

  • README.md Quick Start step 3: added BASE_NODE_L1_ETH_RPC + BASE_NODE_L1_BEACON under a base-consensus comment block
  • README.md Configuration > Required Settings: added a base-consensus L1 config block mirroring the existing op-node block
  • reth/README.md: "devnet" → "sepolia"

@cb-heimdall
Copy link
Copy Markdown
Collaborator

cb-heimdall commented May 20, 2026

🟡 Heimdall Review Status

Requirement Status More Info
Reviews 🟡 0/1
Denominator calculation
Show calculation
1 if user is bot 0
1 if user is external 0
2 if repo is sensitive 0
From .codeflow.yml 1
Additional review requirements
Show calculation
Max 0
0
From CODEOWNERS 0
Global minimum 0
Max 1
1
1 if commit is unverified 0
Sum 1

- Quick Start step 3 now lists BASE_NODE_L1_ETH_RPC and BASE_NODE_L1_BEACON
  alongside the OP_NODE_* vars; reth (base-consensus) is the default client
  and silently fails to connect to L1 without them (closes base#1073)
- Configuration > Required Settings adds a base-consensus L1 block mirroring
  the op-node block so the docs stay in sync with .env.mainnet/.env.sepolia
- reth/README.md Setup section: "devnet" corrected to "sepolia" (closes base#1075)
@0xAxiom 0xAxiom force-pushed the fix/docs-reth-sepolia-quickstart branch from 6a2385e to b53a1a4 Compare May 22, 2026 13:20
@github-actions
Copy link
Copy Markdown
Contributor

github-actions Bot commented Jun 6, 2026

This pull request has been automatically marked as stale because it has not had recent activity. It will be closed if no further activity occurs. Thank you for your contributions.

@github-actions github-actions Bot added the Stale label Jun 6, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Projects

None yet

2 participants