erigontech/erigon
Erigon
Erigon is an Ethereum execution client and blockchain archive node designed to maintain full or archive copies of the blockchain. It functions as a Proof-of-Stake validator, an Ethereum RPC server, and a network validator operation tool, providing the core infrastructure to validate blocks and secure the chain.
The project distinguishes itself through high-performance storage and data distribution, utilizing a flat key-value state storage system instead of a Merkle Patricia Trie to increase read and write speeds. It employs BitTorrent-based data distribution for immutable historical blockchain files and supports a model context protocol server to connect AI assistants to read-only on-chain lookups.
The system covers a broad range of capabilities including blockchain storage optimization through pruning and snapshotting, as well as infrastructure scaling via modular component deployment. It provides tools for on-chain data analysis, historical transaction execution, and tiered historical storage to manage large datasets across different disk types.
Node setup and management are handled through guided installation processes and external TOML configuration files.
Features
- Blockchain Archivers - Functions as a high-performance archive node storing the complete historical state of the network.
- Blockchain Node Operation - Maintains full or archive copies of the blockchain using an optimized execution layer to minimize disk usage.
- Blockchain State Snapshots - Accelerates node booting by downloading pre-computed state snapshots instead of re-executing the entire transaction history.
- Blockchain Indexers - Indexes historical chain state and transaction traces in optimized databases for high-performance querying.
- Blockchain Sync Pipelines - Provides a granular pipeline for processing blocks with options to sync to the tip or stop at specific block heights.
- Storage Optimization - Reduces the physical storage footprint of the blockchain node through advanced pruning and snapshotting techniques.
- Proof-of-Stake Consensus - Participates in network validation and secures the chain through solo staking using integrated or external consensus layers.
- Validator Lifecycle Management - Provides full lifecycle management for network validators, including solo staking and reward integration.
- Key-Value - Utilizes a flat key-value storage system instead of a Merkle Patricia Trie to accelerate read and write speeds.
- Validator Nodes - Operates as a Proof-of-Stake validator to maintain network integrity and validate blocks.
- Component Scaling - Scales blockchain infrastructure by deploying node components as independent processes to distribute load.
- Ethereum Execution Clients - Implements the Ethereum execution layer to maintain full or archive copies of the blockchain.
- Independent Process Deployments - Runs the RPC daemon, transaction pool, and downloader as independent processes to create a scalable, isolated cluster.
- Blockchain Data Synchronization - Downloads and processes network history using multiple modes to balance disk usage against data retention.
- RPC Servers - Exposes chain data, transaction pools, and execution traces through standard remote procedure call interfaces.
- Block Production Validations - Produces and validates blocks as a Proof-of-Stake validator to maintain the integrity of the blockchain.
- Consensus-Execution Layer Integration - Implements a standardized engine interface to coordinate data exchange and state synchronization between execution and consensus layers.
- Consensus Rule Validators - Operates a validator node that verifies block headers and transaction logic to secure the chain.
- Blockchain RPC APIs - Serves a high-throughput JSON-RPC interface for blockchain interactions featuring batching and concurrency tuning.
- Model Context Protocol Servers - Connects AI assistants to read-only on-chain lookups and log triage using a model context protocol server.
- Blockchain Data Interfaces - Provides high-performance interfaces for streaming chain state, transaction pools, and execution traces via RPC for external consumption.
- Execution Chain Synchronization - Implements a synchronization process that reorganizes the payload chain to verify and persist the finalized blockchain state.
- Historical Data Archiving - Archives immutable historical blockchain files using BitTorrent-based distribution to reduce backup and sharing costs.
- Parallel Trace Generation - Executes blocks in parallel over historical state to build specific data domains such as receipts and logs.
- Chain State Retrieval - Provides high-performance mechanisms for retrieving network state, transaction traces, and debug information.
- On-Chain Data Analysis - Enables accessing blockchain state and execution traces via RPC interfaces or AI assistants for auditing.
- Storage Tiering - Distributes blockchain history across multiple storage tiers to utilize low-cost disks for older data.
- Record Transformers - Transforms database records into sorted order to minimize write amplification and reduce RAM usage during execution.
- Database Compactions - Performs in-place compaction of the chain data file to reduce its physical size on disk.
- Data Pruning - Offers full, archive, and minimal pruning modes to control the amount of stored data and optimize disk usage.
- Resource Isolation - Isolates the core node, RPC daemon, and transaction pool into independent processes with specific resource limits.
- State Synchronization Acceleration - Accelerates node booting by downloading state data over the network rather than re-executing all historical transactions.
- History Purging - Permanently deletes specific ranges of state history files without removing the underlying domain data.
- BitTorrent and File Sharing - Uses BitTorrent-based peer-to-peer distribution for immutable historical blockchain files to reduce backup and sharing costs.
- Transaction Replays - Enables the execution of individual historical transactions without the need to process their entire parent block.
- State Commitment Reconstructions - Provides capabilities to regenerate and correct state commitment data within the database to ensure chain integrity.
- Component Decoupling Patterns - Runs the RPC daemon and network layer as independent services to improve scalability and security.
- Decoupled Architectures - Isolates the RPC daemon, transaction pool, and downloader as independent services to distribute load and isolate failures.
- Blockchain Trace Generators - Executes historical blocks in parallel to generate specific data domains including execution traces, receipts, and logs.
- Node State Access Interfaces - Enables reading internal node state and network data across multiple namespaces using standardized RPC interfaces.
