{"id":24845845,"url":"https://github.com/berachain/beacon-kit","last_synced_at":"2026-01-27T21:21:49.633Z","repository":{"id":243554134,"uuid":"752003386","full_name":"berachain/beacon-kit","owner":"berachain","description":"A modular framework for building EVM consensus clients  ⛵️✨","archived":false,"fork":false,"pushed_at":"2025-05-13T13:40:02.000Z","size":135700,"stargazers_count":293,"open_issues_count":139,"forks_count":225,"subscribers_count":32,"default_branch":"main","last_synced_at":"2025-05-13T13:42:28.059Z","etag":null,"topics":["besu","bet","cometbft","cosmos","erigon","ethereum","ethereumjs","evm","foundry","geth","golang","l1","l2","nethermind","reth","rust","solidity","tendermint"],"latest_commit_sha":null,"homepage":"https://berachain.com","language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/berachain.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":"CODEOWNERS","security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2024-02-02T19:52:58.000Z","updated_at":"2025-05-12T17:13:46.000Z","dependencies_parsed_at":"2024-06-11T22:11:32.251Z","dependency_job_id":"9aa91d11-635f-4f0b-bb49-2759974a63d3","html_url":"https://github.com/berachain/beacon-kit","commit_stats":null,"previous_names":["berachain/beacon-kit"],"tags_count":288,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/berachain%2Fbeacon-kit","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/berachain%2Fbeacon-kit/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/berachain%2Fbeacon-kit/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/berachain%2Fbeacon-kit/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/berachain","download_url":"https://codeload.github.com/berachain/beacon-kit/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":254355334,"owners_count":22057354,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["besu","bet","cometbft","cosmos","erigon","ethereum","ethereumjs","evm","foundry","geth","golang","l1","l2","nethermind","reth","rust","solidity","tendermint"],"created_at":"2025-01-31T10:16:58.039Z","updated_at":"2026-01-27T21:21:49.621Z","avatar_url":"https://github.com/berachain.png","language":"Go","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003c/br\u003e\n\n\u003cdiv align=\"center\"\u003e\n  \u003ca href=\"https://github.com/berachain/beacon-kit\"\u003e\n    \u003cpicture\u003e\n      \u003csource media=\"(prefers-color-scheme: dark)\" srcset=\"https://res.cloudinary.com/duv0g402y/image/upload/v1718034312/BeaconKitBanner.png\"\u003e\n      \u003cimg alt=\"beacon-kit-banner\" src=\"https://res.cloudinary.com/duv0g402y/image/upload/v1718034312/BeaconKitBanner.png\" width=\"auto\" height=\"auto\"\u003e\n    \u003c/picture\u003e\n  \u003c/a\u003e\n\u003c/div\u003e\n\u003ch2 \u003e\n  A modular framework for building EVM consensus clients ⛵️✨\n\u003c/h2\u003e\n\n\u003cdiv\u003e\n\n[![CI status](https://github.com/berachain/beacon-kit/workflows/pipeline/badge.svg)](https://github.com/berachain/beacon-kit/actions/workflows/pipeline.yml)\n[![CodeCov](https://codecov.io/gh/berachain/beacon-kit/graph/badge.svg?token=0l5iJ3ZbzV)](https://codecov.io/gh/berachain/beacon-kit)\n[![Telegram Chat](https://img.shields.io/endpoint?color=neon\u0026logo=telegram\u0026label=chat\u0026url=https%3A%2F%2Ftg.sumanjay.workers.dev%2Fbeacon_kit)](https://t.me/beacon_kit)\n[![X Follow](https://img.shields.io/twitter/follow/berachain)](https://x.com/berachain)\n[![Discord](https://img.shields.io/discord/924442927399313448?label=discord)](https://discord.gg/berachain)\n\n\u003c/div\u003e\n\n## What is BeaconKit?\n\n[BeaconKit](https://docs.berachain.com/learn/what-is-beaconkit) is a modular framework for building EVM based consensus clients.\nThe framework offers the most user-friendly way to build and operate an EVM blockchain, while ensuring a functionally identical execution environment to that of the Ethereum Mainnet.\n\n## Supported Execution Clients\n\nThrough utilizing the [Ethereum Engine API](https://github.com/ethereum/execution-apis/blob/main/src/engine)\nBeaconKit supports the following execution clients:\n\n- [**Bera-Geth**](https://github.com/berachain/bera-geth): Official Go implementation of the Berachain protocol.\n- [**Bera-Reth**](https://github.com/berachain/bera-reth): Rust-based client focusing on performance and reliability.\n\n## Running a Local Development Network\n\n**Prerequisites:**\n\n- [Docker](https://docs.docker.com/engine/install/)\n- [Golang 1.25.5+](https://go.dev/doc/install)\n- [Foundry](https://book.getfoundry.sh/)\n\nStart by opening two terminals side-by-side:\n\n**Terminal 1:**\n\n```bash\n# Start the sample BeaconKit Consensus Client:\nmake start\n```\n\n**Terminal 2:**\n\n**Note:** This must be run *after* the `beacond` node is started since `make start` will populate the\neth-genesis file used by the Execution Client.\n\n```bash\n# Start an Ethereum Execution Client:\nmake start-reth # or start-geth\n```\n\nThe account with\n`private-key=0xfffdbb37105441e14b0ee6330d855d8504ff39e705c3afa8f859ac9865f99306`\ncorresponding with `address=0x20f33ce90a13a4b5e7697e3544c3083b8f8a51d4` is\npreloaded with the native EVM token.\n\n## Multinode Local Devnet\n\nPlease refer to the [Kurtosis README](https://github.com/berachain/beacon-kit/blob/main/kurtosis/README.md) for more information on how to run a multinode local devnet.\n\n## Important Commands and Options\n\n`beacond help` lists available commands. Some commands have sub-commands.\n\n`beacond init` creates a folder structure for beacond to operate in, along with initial configuration files, the important ones being `app.toml` and `config.toml`.\n\n`beacond start` starts the chain client and begins the syncing process.\n\nThe key configuration value is the Beacon chain specification (\"chainspec\")  - analogous to an Eth genesis - is held in a spec.toml file. There are three well-known chainspecs (`mainnet|testnet|devnet`).  Or, a custom file can be provided to provide your own scenario's settings - see this [example using Docker](https://docs.berachain.com/nodes/guides/docker-devnet).\n\nThe chainspec is set with the `--beacon-kit.chain-spec` command line option, and if necessary for a custom chainspec, use `--beacon-kit.chain-spec-file`.  If used during `beacond init`, this value is written into app.toml and does not need to be specified anymore.\n\nYou can override the default operating directories for beacond with the `--home \u003cpath\u003e` option.\n\nThe [Berachain Node Quickstart](https://docs.berachain.com/nodes/quickstart) provides a quick deployment of mainnet or testnet on your desk.\n\nFor developing with beacon-kit, you have options:\n1. see the Makefile for targets to start stand-alone processes\n2. see [an example deploying a team with Docker on a custom chainspec](https://docs.berachain.com/nodes/guides/docker-devnet)\n3. see [a deployment with Kurtosis](https://docs.berachain.com/nodes/guides/kurtosis)\n4. see [an expect script that does a complete cycle of deposits, withdrawal, eviction, voluntary exit](https://github.com/berachain/guides/blob/main/apps/local-docker-devnet/devnet-automation.exp)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fberachain%2Fbeacon-kit","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fberachain%2Fbeacon-kit","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fberachain%2Fbeacon-kit/lists"}