Skip to content

v0.3.0: Mainnet Sync via Embedded go-ethereum

Choose a tag to compare

@jiayaoqijia jiayaoqijia released this 23 Feb 05:47
· 1723 commits to master since this release

Highlights

ETH2030 now syncs with Ethereum mainnet and testnets by embedding go-ethereum v1.17.0 as a library. The new eth2030-geth binary wraps geth's full node stack (P2P networking, snap sync, state DB, RPC) while preserving ETH2030's 13 custom precompiles for future fork activation.

Verified on Sepolia

  • Checkpoint-synced CL (Lighthouse v8.1.0) driving EL via Engine API
  • Snap sync downloading headers at ~9K/sec, chain ~33%, state ~4% before stopping
  • All RPC APIs verified: eth_*, net_*, web3_*, admin_*, txpool_*, engine_*, debug_*

Verified on Mainnet

  • Correct Chain ID (1), genesis block, and network configuration
  • All RPC endpoints responding correctly
  • P2P peer discovery via mainnet bootnodes

What's New

eth2030-geth Binary

  • New binary (pkg/cmd/eth2030-geth/): embeds go-ethereum as library for production Ethereum sync
  • Network support: mainnet, sepolia, holesky with automatic bootnode configuration
  • Sync modes: snap sync (default) and full sync
  • Engine API: authenticated RPC for consensus layer clients (Lighthouse, Prysm, etc.)
  • RPC APIs: eth, net, web3, txpool, engine, admin, debug modules enabled
  • Precompile injection: infrastructure ready for Glamsterdam/Hogota/I+ fork testing via --override.* flags
  • CLI flags: --datadir, --network, --port, --http.port, --authrpc.port, --authrpc.jwtsecret, --syncmode, --maxpeers, --verbosity, --version

Networking Fix

  • Bootnode discovery: P2P config now includes network-specific bootnodes (params.MainnetBootnodes, params.SepoliaBootnodes, params.HoleskyBootnodes)
  • Admin API: enabled for manual peer management via admin_addPeer

Documentation Updates

  • Updated package count to 50 (added pkg/cmd/eth2030-geth)
  • Added mainnet & testnet sync verification section to README
  • Added development stats: 2.77B tokens billed, ~$5,750 estimated cost, 26,798 API calls over ~6 days
  • Updated PROGRESS.md and GAP_ANALYSIS.md with sync results

Development Stats

Built with Claude Code (Claude Opus 4) over ~6 days:

Metric Value
Total tokens (billed) 2.77 billion
Total throughput 6.07 billion
Unique API calls 26,798
Session files 765 (8 main + 757 sub-agent)
Estimated API cost ~$5,750

Commits since v0.2.0

  • 584f305 readme: update dev stats — 2.77B tokens, ~$5,750 cost, 26,798 API calls
  • 01c7c62 readme: add development stats
  • 589c9ff docs: update for v0.3.0 — sync verification, fix package count to 50
  • 1a68ff9 eth2030-geth: add network bootnodes and admin API for peer discovery
  • 733ee02 docs: update all docs for eth2030-geth binary, close networking/DB gaps
  • 14498c6 add eth2030-geth: embed go-ethereum as library for mainnet sync

Usage

# Build
cd pkg && go build -o eth2030-geth ./cmd/eth2030-geth/

# Sync with mainnet (requires CL client on port 8551)
./eth2030-geth --datadir ~/.eth2030-geth --authrpc.jwtsecret /path/to/jwt.hex

# Sync with Sepolia
./eth2030-geth --network sepolia --datadir ~/.eth2030-sepolia

# Test future fork precompiles
./eth2030-geth --network sepolia --override.glamsterdam 1700000000

Stats

  • Packages: 50 (all passing)
  • Source: ~310K LOC + ~392K LOC tests = ~702K LOC total
  • EF State Tests: 36,126/36,126 (100%)
  • EIPs: 58 complete, 6 substantial
  • Custom Precompiles: 13 (injected at future fork levels)