A Modular Framework for Building EVM Consensus Clients ⛵️✨

A highly customizable framework for creating and operating EVM-based blockchains.
⚠️ Project under active development — see status for details.

---

🚀 What is BeaconKit?

BeaconKit is a modular framework designed to simplify the process of building Ethereum Virtual Machine (EVM) based consensus clients. It ensures a functionally identical execution environment to Ethereum Mainnet, offering a user-friendly approach for blockchain developers.

---

💡 Supported Execution Clients

BeaconKit supports all major Ethereum execution clients through the Ethereum Engine API:

• Geth: Official Go implementation of Ethereum.
• Erigon: High-performance, feature-rich fork of Geth.
• Nethermind: .NET-based client with full Ethereum protocol support.
• Besu: Java-based, enterprise-grade client.
• Reth: Rust-based client focused on performance.
• Ethereumjs: JavaScript-based implementation managed by the Ethereum Foundation.

---

🛠️ Running a Local Development Network

Prerequisites

Ensure the following tools are installed:

• Docker
• Golang 1.23.0+
• Foundry

Steps

1. Open two terminals side-by-side.

   Terminal 1:

   # Start the sample BeaconKit Consensus Client:
   make start
   

Start an Ethereum Execution Client:

make start-reth # or start-geth, start-besu, start-erigon, start-nethermind, start-ethereumjs

🔗 Multinode Local Devnet Refer to the Kurtosis README for instructions on running a multinode local development network.

⚠️ Status This project is a work in progress. Frequent changes are expected as we finalize the system. Audits are ongoing, and BeaconKit is not yet recommended for production environments.

📄 License BeaconKit is licensed under MIT License.

🛡️ Support & Community Join us on Telegram or Discord. Follow updates on X (formerly Twitter).