The base/node repository provides a complete Docker-based implementation for running a Base node, which is an Ethereum Layer 2 solution built on Optimism's OP Stack. Base is characterized as a secure, low-cost, and developer-friendly L2 that leverages the OP Stack architecture. The repository is written primarily in Shell and serves as the operational foundation for participants who want to run their own Base network infrastructure.
The node implementation uses two core components: base-reth-node for execution and base-consensus for consensus operations. The repository includes comprehensive configuration templates for both mainnet and testnet (Sepolia) environments, with environment files that specify network parameters, sequencer endpoints, and L1 integration points. Users must provide their own Ethereum L1 full node RPC endpoint and beacon endpoint to operate a Base node, establishing the connection between the L2 and underlying L1 security.
Hardware requirements are substantial, reflecting the computational demands of running a full node. Minimum specifications include a modern multicore CPU, 32GB of RAM with 64GB recommended, and NVMe SSD storage calculated as twice the current chain size plus snapshot size with a 20 percent buffer. Production deployments documented in the repository use AWS i7i.12xlarge instances with RAID 0 configurations of local NVMe drives and ext4 filesystems, indicating the infrastructure scale expected for reliable node operation.
The repository supports optional advanced features including Flashblocks mode, which can be enabled via websocket configuration for enhanced block proposal capabilities, and follow mode for syncing from another L2 RPC endpoint. Pruning options are available for storage optimization. Snapshots are provided to accelerate initial node synchronization, with documentation and links available through the Base documentation site.
The repository shares contributors with microsoft/vscode, microsoft/typescript, and rust-lang/rust, indicating cross-project collaboration patterns.
The repository supports both mainnet and testnet networks with active status on both. Configuration is managed through environment variables controlling L1 endpoints, network selection, and optional feature flags. The project includes troubleshooting guidance directing users to Discord community channels for node operator support and GitHub issues for technical problems. A disclaimer clarifies that the node software is provided without warranty, and usage is subject to applicable laws and regulations.
