Skip to content

ev-reth Overview

ev-reth is a modified reth Ethereum execution client optimized for Evolve rollups.

What is ev-reth?

ev-reth extends reth with:

  • Engine API integration — Driven by ev-node for block production
  • Rollup-specific features — Base fee redirect, deploy allowlist, custom precompiles
  • Application gas sponsorship — Custom transaction type for sponsored batch operations
  • Configurable chain parameters — Contract size limits, custom gas settings

Architecture

text
┌─────────────────────────────────────────┐
│               ev-node                    │
│         (consensus + DA + P2P)          │
└─────────────────┬───────────────────────┘
                  │ Engine API
                  │ (JWT authenticated)
┌─────────────────▼───────────────────────┐
│               ev-reth                    │
│           (EVM execution)               │
│  ┌───────────┐  ┌───────────────────┐   │
│  │ State DB  │  │ Transaction Pool  │   │
│  └───────────┘  └───────────────────┘   │
│  ┌───────────────────────────────────┐  │
│  │          EVM + Precompiles        │  │
│  └───────────────────────────────────┘  │
└─────────────────────────────────────────┘

ev-node drives ev-reth through the Engine API:

  1. ev-node calls engine_forkchoiceUpdated with payload attributes
  2. ev-reth builds a block from pending transactions
  3. ev-node calls engine_getPayload to retrieve the block
  4. ev-node broadcasts and submits to DA
  5. ev-node calls engine_newPayload to finalize

Features

FeatureDescription
Base Fee RedirectSend base fees to treasury instead of burning
Deploy AllowlistRestrict who can deploy contracts
Contract Size LimitsIncrease max contract size beyond 24KB
Mint PrecompileNative token minting for bridges
Sponsored Batch TransactionsSponsor user gas and execute multiple calls atomically

When to Use ev-reth

Use ev-reth when you want:

  • Full EVM compatibility
  • Ethereum tooling (Foundry, Hardhat, etc.)
  • Standard wallet support (MetaMask, etc.)
  • High-performance Rust execution

Repository

Next Steps

Released under the APACHE-2.0 License