jiayaoqijia / eth2030

ETH2030 Ethereum execution client targeting the L1 Strawmap eth2030.com > **Warning**: This is an experimental research project and **reference implementation** under active development. It is **not** production-ready and is intended primarily for study, research, and prototyping. Use at your own risk. APIs, data formats, and behavior may change without notice. 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 eth2030-geth Flags > **Note:** eth2030-geth uses Go's package. Flags are shown with single-dash ( ) to match output, but double-dash ( ) also works. | Flag | Default | Description | |------|---------|-------------| | | | Data directory for chain data | | | | Network: mainnet, sepolia, holesky | | | | Sync mode: snap, full | | | | P2P listening port | | | | HTTP-RPC server port | | | | Engine API port (for CL client) | | | auto | Path to JWT secret for Engine API auth | | | | Maximum P2P peers | | | | Log level (0=silent, 5=trace) | | | - | Test Glamsterdam fork at timestamp | 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). **40 Feature Tests** — All passing consensus checks, covering all 65 roadmap items: **24 Roadmap Feature Tests:** | Feature | EIP(s) | Feature | EIP(s) | |---------|--------|---------|--------| | ePBS | EIP-7732 | PeerDAS | EIP-7594 | | FOCIL | EIP-7805 | 3SF/Quick Slots | — | | BALs | EIP-7928 | BAL Feasibility | EIP-7928 | | BAL Retention | EIP-7928 | PQ Crypto | — | | Native AA | EIP-7702 | Encrypted Mempool | — | | Gas Repricing | 18 EIPs | Shielded Transfers | — | | Blobs | EIP-4844/8070 | SSZ | EIP-6404/7807 | | Multidim Gas | EIP-7706 | Multidim Fee Tx | EIP-7706 | | Native Rollups | EIP-8079 | Frame Mempool | EIP-8141 | | Gas Vectors 3D | EIP-7706 | IL Satisfaction | EIP-7805 | | Local Tx | — | Mixnet | — | | RISC-V Precompile | zkVM | STARK Frames | EIP-8141 | **16 Layer Group Tests** (CL/DL/EL feature groups covering remaining roadmap items): | Group | Items Covered | Group | Items Covered | |-------|---------------|-------|---------------| | cl-finality | fast confirm, 1-epoch, endgame | cl-validators | attester cap, 128K, APS, 1 ETH | | cl-attestations | 1M attest, jeanVM, PQ attest | cl-security | 51% recovery, secret proposers | | cl-infrastructure | beacon specs, tech debt, VDF | dl-blob-advanced | PQ blobs, variable-size, teragas | | dl-reconstruction | local reconstruct, sample opt | dl-futures | blob futures, custody proofs | | dl-broadcast | cell msgs, 7702 broadcast, streaming | el-gas-schedule | 3x/year limit, Hegotá repricing | | el-payload | chunking, block-in-blobs, nonce | el-proofs | optional, mandatory 3-of-5, aggregation | | el-zkvm | canonical guest/zkVM, STF, zkISA | el-state | binary tree, VOPS, endgame state | | el-tx-advanced | AA, purges, assertions, NTT | el-gas-futures | gas futures, sharded mempool, gigagas | **6 General Configs** — single-client, multi-client (cross-client consensus with upstream geth), stress-test, blob-test, eip7702-test, full-feature. See pkg/devnet/kurtosis/README.md for full documentation (40 feature tests, 6 configs, 10 tools). Architecture go-ethereum Integration ETH2030 imports go-ethereum v1.17.1 as a library for EVM execution, achieving 100% EF state test conformance: | Component | Description | |-----------|-------------| | | Block processor using | | | 13 custom precompile injection via | | | State creation using go-ethereum's real trie DB | | | Chain config mapping (ETH2030 forks to go-ethereum params) | **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 binary has been verified syncing with live Ethereum networks: | Network | CL Client | Sync Mode | Status | RPC APIs Verified | |---------|-----------|-----------|--------|-------------------| | **Sepolia** | Lighthouse v8.1.0 | Snap | Headers downloading at ~9K/sec, chain ~33%, state ~4% | 20+ methods | | **Mainnet** | - | Snap | Genesis initialized, Chain ID 1, peer discovery active | 20+ methods | **Verified RPC methods:** , , , , , , , , , , , , , , 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: *…