ETH2030

Ethereum execution client targeting the L1 Strawmap
eth2030.com

[!WARNING] This is an experimental research project under active development. It is a reference implementation intended for study, research, and prototyping. It is not production-ready and has not been formally audited for security. APIs, data formats, and behavior may change without notice.

Do not use this software to manage real funds, validate mainnet blocks, or run production infrastructure. Exercise extreme caution with anything that touches wallets, private keys, seed phrases, or transaction signing. Always review the source code and do your own research (DYOR) before running any Ethereum client software. Use entirely at your own risk.

Quick Start · Devnet Testing · Roadmap · EIP Coverage · Architecture · Contributing

---

Built in Go, targeting the L1 Strawmap — the EF Architecture team's Ethereum protocol roadmap through the Giga-Gas era.

Features

• Full EVM execution -- 164+ opcodes, 24 precompiles, EOF container support, go-ethereum v1.17.1 backend
• 100% EF conformance -- 36,126/36,126 Ethereum Foundation state tests passing via go-ethereum v1.17.1 backend
• 58+ EIPs supported -- Covering Frontier through Prague and beyond (native + go-ethereum backend)
• Parallel execution -- Block Access Lists (EIP-7928) for BAL-driven parallel transaction processing
• Post-quantum ready -- ML-DSA-65 (FIPS 204), Dilithium3, Falcon512, SPHINCS+ signers with hybrid mode
• Native rollups -- EIP-8079 EXECUTE precompile and anchor contract
• zkVM framework -- RISC-V RV32IM CPU emulator, STF executor, zkISA bridge (simulated proofs, production Groth16 integration pending)
• Full consensus -- 3-slot finality (3SF), quick slots (6s), 1-epoch finality, PQ attestations
• PeerDAS -- Data availability sampling, custody proofs, blob streaming, variable-size blobs
• ePBS + FOCIL -- Enshrined PBS with distributed builder and fork-choice enforced inclusion lists
• Complete networking -- devp2p, discovery V5, gossip (pub/sub), Portal network, snap sync
• Engine API V3-V7 -- Full payload lifecycle, forkchoice, ePBS builder API, 50+ JSON-RPC methods

Quick Start

# Clone
git clone https://github.com/jiayaoqijia/eth2030.git
cd eth2030/pkg

# Build all packages
go build ./...

# Build the geth-embedded node (syncs with mainnet/testnets)
go build -o eth2030-geth ./cmd/eth2030-geth/

# Sync with Sepolia testnet (requires a consensus client on port 8551)
./eth2030-geth -network sepolia -datadir ~/.eth2030-sepolia

# Sync with mainnet
./eth2030-geth -datadir ~/.eth2030-geth -authrpc.jwtsecret /path/to/jwt.hex

# Run all tests (48 packages, 18,400+ tests)
go test ./...

# Run EF state test validation (36,126 vectors, 100% pass rate)
go test ./core/eftest/ -run TestGethCategorySummary -timeout=10m

eth2030-geth Flags

Note: eth2030-geth uses Go's flag package. Flags are shown with single-dash (-flag) to match --help output, but double-dash (--flag) also works.

Devnet Testing (Kurtosis)

ETH2030 includes Kurtosis devnet integration for multi-client consensus testing using ethpandaops/ethereum-package with 10 testing tools (assertoor, spamoor, rakoon, dora, blobscan, forky, tracoor, forkmon, prometheus, grafana).

# Prerequisites: Docker + Kurtosis CLI
kurtosis engine start
cd pkg && docker build -t eth2030:local .

# Run all 40 feature devnet tests
cd pkg/devnet/kurtosis && ./scripts/run-feature-tests.sh

# Run specific features
cd pkg/devnet/kurtosis && ./scripts/run-feature-tests.sh epbs focil native-aa

# Launch a general devnet
cd pkg/devnet/kurtosis && ./scripts/run-devnet.sh full-feature

40 Feature Tests — All passing consensus checks, covering all 65 roadmap items:

24 Roadmap Feature Tests:

16 Layer Group Tests (CL/DL/EL feature groups covering remaining roadmap items):

6 General Configs — single-client, multi-client (cross-client consensus with upstream geth), stress-test, blob-test, eip7702-test, full-feature.

Additional Test Scripts:

• test-frametx.sh — EIP-8141 frame transaction test (deploys APPROVE contract, verifies opcodes)
• test-precompiles.sh — Custom precompile smoke test

Public Devnet Endpoints (when running):

• RPC: https://devnet.eth2030.com
• Dora Explorer: https://devnet-dora.eth2030.com
• Blockscout Explorer: https://devnet-blockscout.eth2030.com

See pkg/devnet/kurtosis/README.md for full documentation (40 feature tests, 6 configs, 10+ tools).

Architecture

                 +------------------------------+
                 |     Consensus Client (CL)     |
                 +--------------+---------------+
                                | Engine API (JSON-RPC)
                 +--------------v---------------+
                 |      Engine API Server         |
                 |  newPayloadV3-V7, fcuV3/V4    |
                 +--------------+---------------+
                                |
          +---------------------+------------------+
          |                     |                   |
 +--------v------+  +----------v--------+  +-------v-------+
 |  Block Builder |  |  Block Validator  |  | Payload Store |
 +--------+------+  +----------+--------+  +---------------+
          |                     |
 +--------v---------------------v------+
 |          State Processor             |
 |   Sequential -> Parallel (EIP-7928) |
 +--------+----------------------------+
          |
 +--------v--------------------------+     +--------------------+
 |     go-ethereum EVM (v1.17.0)     |     | Consensus Layer    |
 |  + 13 ETH2030 custom precompiles  |     | 3SF, Attestations  |
 +--------+--------------------------+     +--------------------+
          |
 +--------v--------------------------+     +-------------------+
 |          StateDB                   |---->|  Transaction Pool |
 |  Accounts, Storage, Code, Logs    |     | + Encrypted/Shared|
 +--------+--------------------------+     +-------------------+
          |
 +--------v--------------------------+     +-------------------+
 |     Trie / Binary                  |---->|  P2P / Sync       |
 |  MPT + Binary (EIP-7864)          |     | Discovery, Portal |
 +--------+--------------------------+     +-------------------+
          |
 +--------v--------------------------+     +-------------------+
 |     Key-Value Store (rawdb)        |     | DAS / PeerDAS     |
 +-----------------------------------+     | Blob Sampling     |
                                           +-------------------+

go-ethereum Integration

ETH2030 imports go-ethereum v1.17.1 as a library for EVM execution, achieving 100% EF state test conformance:

Custom precompiles injected: 4 Glamsterdam repriced (0x06, 0x08, 0x09, 0x0a), 1 NTT (0x15), 4 NII (0x0201-0x0204), 4 field arithmetic (0x0205-0x0208).

Mainnet & Testnet Sync Verification

The eth2030-geth binary has been verified syncing with live Ethereum networks:

Verified RPC methods: eth_chainId, eth_blockNumber, eth_getBlockByNumber, eth_syncing, eth_feeHistory, eth_getBalance, eth_getCode, net_version, net_peerCount, web3_clientVersion, admin_nodeInfo, admin_peers, txpool_status, engine_exchangeCapabilities, and more.

Native vs Delegated Architecture

ETH2030 combines native implementations with go-ethereum as a backend. This section clarifies what is built from scratch versus delegated:

go-ethereum delegated (~40 EIPs): Core EVM opcodes, gas accounting, state root computation, trie operations, and standard precompile execution are handled by the pkg/geth/ adapter importing go-ethereum v1.17.1 as a library. This includes all Frontier-through-Prague EVM semantics, EIP-158 empty account cleanup, and SSTORE gas metering (EIP-2200/2929/3529).

Native ETH2030 (~25 features): Consensus layer (3SF, quick slots, 1-epoch finality, PQ attestations, endgame finality), data availability (PeerDAS, blob streaming, custody proofs, variable-size blobs), proposer-builder separation (ePBS, FOCIL, distributed builder), encrypted mempool (commit-reveal, threshold decryption), BAL parallel execution (EIP-7928), native rollups (EIP-8079), SSZ encoding (EIP-6404/7807), 13 custom precompiles (NTT, NII, field arithmetic), and the Engine API V3-V7.

Prototype/Functional: The zkVM framework has a real RISC-V RV32IM CPU emulator with witness collection and cycle counting, but proofs are SHA-256 hash-based rather than Groth16 (production ZK backend integration pending).

Package Structure

All 48 packages (click to expand)

Package	Description
pkg/core/rawdb	FileDB with WAL, chain DB, EIP-4444 history expiry
pkg/core/state/snapshot	Layered diff/disk snapshots, account/storage iterators
pkg/core/state/pruner	State pruner with bloom filter reachability
pkg/core/vops	Validity-Only Partial Statelessness: executor, validator, witness
pkg/das/erasure	Reed-Solomon erasure coding (Lagrange interpolation)
pkg/witness	Execution witness (EIP-8025), collector, verifier
pkg/txpool/encrypted	Encrypted mempool: commit-reveal, threshold decryption
pkg/txpool/shared	Sharded mempool with consistent hashing
pkg/light	Light client: header sync, proof cache, sync committee, CL proofs
pkg/p2p/discover	Peer discovery V4/V5, Kademlia DHT
pkg/p2p/discv5	Discovery V5 protocol with WHOAREYOU/handshake
pkg/p2p/dnsdisc	DNS-based peer discovery
pkg/p2p/enode	Node identity and URL parsing
pkg/p2p/enr	Ethereum Node Records (extensible key-value)
pkg/p2p/portal	Portal network: content DHT, Kademlia routing
pkg/p2p/snap	Snap sync protocol messages
pkg/trie/bintrie	Binary Merkle trie: Get/Put/Delete/Hash/Commit, proofs
pkg/eth	ETH protocol handler, codec, EIP-8077 announce nonce (ETH/72)
pkg/node	Client node: config, lifecycle, subsystem wiring
pkg/cmd/eth2030	CLI binary with flags, signal handling
pkg/cmd/eth2030-geth	Production node: go-ethereum embedded, mainnet/testnet sync
pkg/log	Structured logging (JSON/text)
pkg/metrics	Counters, gauges, histograms, Prometheus, EWMA, CPU tracker

EIP Coverage (58+ EIPs Supported)

Substantially implemented: EIP-7732 (ePBS), EIP-7805 (FOCIL), EIP-7864 (Binary Merkle Tree), EIP-8025 (Execution Proofs), PQC (Dilithium3/Falcon512/SPHINCS+)

See docs/EIP_SPEC_IMPL.md for full traceability: specs, implementations, and tests for each EIP.

EF State Test Benchmark

Roadmap Coverage

ETH2030 tracks 8 upgrade phases from the L1 Strawmap covering consensus, data, and execution layers from 2026 through 2030+.

All 65 strawmap items are COMPLETE with real cryptographic backends wired (BLS, Dilithium3, KZG, BN254 Pedersen). See docs/GAP_ANALYSIS.md for the full audit.

Engine API

JSON-RPC

50+ methods across eth_*, net_*, web3_*, debug_* namespaces including block/tx queries, eth_call, eth_estimateGas, fee history, log filters, WebSocket subscriptions (newHeads, logs, pendingTransactions), sync status, EVM tracing, and MPT proofs.

Documentation

• docs/EIP_SPEC_IMPL.md -- EIP traceability: specs, implementations, tests (94+ EIPs)
• docs/strategies/lean-vm-riscv-implementation.md -- Lean 4 strategy for formal VM and RISC-V compiler-chain proof development
• docs/GAP_ANALYSIS.md -- Full audit of 65 roadmap items
• docs/plans/lean-vm-audit.md -- leanVM security audit: 18 findings across 4 leanEthereum repos
• docs/PROGRESS.md -- Progress report and completion tracking
• docs/DESIGN.md -- Architecture and implementation design
• docs/ROADMAP.md -- L1 Strawmap timeline overview
• docs/ROADMAP-DEEP-DIVE.md -- EIP research and analysis
• pkg/devnet/kurtosis/README.md -- Kurtosis devnet testing (40 features, 6 configs, 10 tools)

Development Stats

This project was built with Claude Code (Claude Opus 4/4.6) over ~8 days:

Contributing

See CONTRIBUTING.md for development setup, coding guidelines, and contribution categories.

Security

See SECURITY.md for vulnerability reporting.

Reference Submodules

refs/ contains 37 git submodules for upstream specs and implementations:

Ethereum specs: EIPs, ERCs, consensus-specs, execution-specs, execution-apis, beacon-APIs, builder-specs, consensus-spec-tests, execution-spec-tests

Reference client: go-ethereum

Cryptography: blst (BLS12-381), circl (PQC: ML-DSA, ML-KEM, SLH-DSA), go-eth-kzg (KZG), gnark (ZK proofs), gnark-crypto, c-kzg-4844

PQ research: hash-sig (hash-based multi-sigs), ntt-eip (EIP-7885 NTT precompile), ethfalcon (FALCON on EVM)

Devops: ethereum-package, benchmarkoor, erigone, xatu, consensoor

Audited: leanMultisig, leanSig, leanSpec, fiat-shamir (leanEthereum — 18-finding security audit)

License

The ETH2030 library (i.e. all code outside of the cmd directory) is licensed under the GNU Lesser General Public License v3.0, also included in our repository in the COPYING.LESSER file.

The ETH2030 binaries (i.e. all code inside of the cmd directory) are licensed under the GNU General Public License v3.0, also included in our repository in the COPYING file.