The base/node repository provides everything needed to run a Base node, which is an integral part of the Base network—a secure, low-cost, developer-friendly Ethereum Layer 2 (L2) solution built on Optimism’s OP Stack. The repository is designed to facilitate node operators in deploying and maintaining their own Base nodes, enabling participation in the Base network’s infrastructure. Base leverages the OP Stack to inherit Ethereum’s security and decentralization while offering scalability and reduced transaction fees.
The repository primarily offers Docker builds and configuration files, allowing users to quickly set up and run a Base node. It supports both the mainnet and testnet environments, with distinct environment files (.env.mainnet and .env.sepolia) to streamline configuration. Users must have access to an Ethereum Layer 1 (L1) full node RPC, as Base nodes rely on L1 endpoints for operation. The setup process involves specifying L1 RPC endpoints, beacon node endpoints, and beacon archiver endpoints in the environment files, ensuring seamless integration with the Ethereum network.
Base nodes can be run using several supported clients, including reth (the default), geth, and nethermind. This flexibility allows operators to choose their preferred Ethereum client based on performance, familiarity, or specific requirements. The repository also provides options to run nodes in Flashblocks mode with reth, enhancing block propagation and synchronization speed. Detailed hardware requirements are outlined, recommending modern multicore CPUs, substantial RAM (32GB minimum, 64GB recommended), NVMe SSD storage, and Docker/Docker Compose for containerized deployment. Production-grade specifications are provided for archive and full nodes, including recommended AWS instance types and RAID configurations for optimal performance.
Configuration options are extensive, allowing operators to tailor their node setup to their needs. The repository supports various L1 RPC providers, such as Alchemy, QuickNode, Infura, Parity, Nethermind, Debug Geth, Erigon, and basic or standard methods. Performance settings are adjustable, with cache parameters for geth nodes to optimize database, garbage collection, snapshot, and trie caching. Optional features include EthStats monitoring for node health, Trusted RPC mode for enhanced security, and experimental Snap Sync for faster node synchronization.
To facilitate rapid node setup, the repository provides access to snapshots, enabling operators to restore their node state quickly without full chain synchronization. Both mainnet and testnet networks are supported, ensuring that developers and operators can test and deploy nodes in different environments. Comprehensive troubleshooting resources are available, including a dedicated Discord channel for node operators and GitHub issue tracking for technical support.
The repository emphasizes transparency and user responsibility, stating that the node software is provided "as is" without warranty. Operators are advised to comply with applicable laws and regulations. For further information, detailed documentation is available at docs.base.org, covering advanced configuration, snapshot restoration, and operational best practices. Overall, base/node serves as a robust, flexible, and well-documented solution for anyone looking to run a Base node and contribute to the Base L2 ecosystem.
