Skip to content

docs(node-operators): add Run a Local Devnet guide - #2028

Draft
roethke wants to merge 6 commits into
masterfrom
roethke/local-devnet-guide
Draft

roethke wants to merge 6 commits into
masterfrom
roethke/local-devnet-guide

Conversation

@roethke

@roethke roethke commented Sep 29, 2026 •

Copy link
Copy Markdown
Collaborator

What changed? Why?

Adds Specifications → Node Operators → Run a Local Devnet, a one-page guide for teams that want a local Base stack. Until now, the devnet was documented only in base/base's etc/docker/README.md, which targets base/base contributors.

The page covers:

  • Prerequisites: Docker with Compose v2 + Buildx, just ≥ 1.51.0, Foundry, jq, and a base/base clone
  • Start: just devnet up-single vs just devnet up (3-node HA conductor cluster), then just devnet status
  • Test transaction: cast send using the prefunded Anvil accounts from etc/docker/devnet-env (same flow as base/base's local-devnet-transaction-inclusion verification skill)
  • Endpoints: builder 7545, RPC nodes 8545 and 8645, L1 4545, Grafana 3000; chain IDs 84538453 / 1337
  • Hardforks: Cobalt at block 22 and Denim at block 25 by default; everest / zenith modes, with a warning that op-batcher stalls on EIP-8130 blocks; L2_BASE_*_BLOCK overrides
  • Common commands and Learn More links to the devnet README, the Justfile, docs/guides/TESTING.md, and docs/guides/STANDALONE_PROVING.md

Notes to reviewers

  • Placement: I put it in Node Operators, after Run a Node, because the IA guidelines scope that group to "content for people operating infrastructure". Build on Base → Overview (next to Test on Vibenet) is the alternative if we want app developers to find it. The page links to Vibenet for teams that don't need local infra.
  • Scope left out on purpose: the Anvil + Nitro proving variant, profiling, tx-observability, the batcher shadow topology, and upgrade-signal commands. All are linked through the README.
  • Please verify (base/base owners): that up-single is the right default to recommend over up for external teams, and that the Everest/Zenith modes are OK to mention publicly. Every value on the page was copied from base/base main (etc/docker/Justfile, devnet-env, docker-compose.yml) on 2026-09-29 and rechecked against main (577c04d19) on 2026-10-01.
  • Chain ID: the local L2 uses 84538453, the same as hosted Vibenet.
  • Please verify: whether just devnet flashblocks still streams after the Denim cutover (block 25), since the README says builder selection changes at Denim.

How has it been tested?

  • node scripts/lint-mdx.js on the new page: 0 errors, 0 warnings
  • node scripts/validate-docs-structure.js: passes (nav, orphans, links)
  • Commands, ports, and fork blocks were checked against base/base main. I did not run a devnet locally for this PR.

Screenshots

Pending; use the Mintlify preview for this branch once it deploys.

Concise guide to starting the base/base local devnet with `just devnet`,
sending a test transaction, endpoints, hardfork activation modes, and
links to the devnet README and guides in base/base.

Generated with Claude Code

Co-Authored-By: Claude <noreply@anthropic.com>
@mintlify

mintlify Bot commented Sep 29, 2026 •

Copy link
Copy Markdown
Contributor

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

Project Status Preview Updated
base 🟢 Ready View Preview Oct 1, 2026, 6:43 PM

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

@cb-heimdall

Copy link
Copy Markdown
Collaborator

🟡 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

roethke and others added 3 commits October 1, 2026 09:52
…Everest caveat

Add jq and Docker Compose v2 + Buildx to prerequisites, list both RPC
nodes and the shadow batcher, add the base-rpc endpoint on 8645, warn
that op-batcher stalls on EIP-8130 blocks, and note that the
flashblocks command needs Go.

Generated with Claude Code

Co-Authored-By: Claude <noreply@anthropic.com>
Generated with Claude Code

Co-Authored-By: Claude <noreply@anthropic.com>
Generated with Claude Code

Co-Authored-By: Claude <noreply@anthropic.com>
@roethke
roethke marked this pull request as ready for review October 1, 2026 17:16
@roethke
roethke marked this pull request as draft October 1, 2026 17:34
@roethke

roethke commented Oct 1, 2026

Copy link
Copy Markdown
Collaborator Author

Moving back to draft: waiting for updates to the devnet before merging.

This branch was successfully deployed

1 active deployment
staging - docs — bb5e78dd Deployed Oct 1, 2026 by mintlify[bot]
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants