Repository navigation
v0.3.0: Mainnet Sync via Embedded go-ethereum
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
584f305readme: update dev stats — 2.77B tokens, ~$5,750 cost, 26,798 API calls01c7c62readme: add development stats589c9ffdocs: update for v0.3.0 — sync verification, fix package count to 501a68ff9eth2030-geth: add network bootnodes and admin API for peer discovery733ee02docs: update all docs for eth2030-geth binary, close networking/DB gaps14498c6add 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 1700000000Stats
- 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)