ChainSafe/lodestar

🌟 Ethereum Consensus client for the Zig and TypeScript ecosystem

TypeScript

1,425

11,457 commits

updated Oct 12, 2026

See the code

README

Lodestar Ethereum Consensus Implementation

GitHub release (latest by date) Docker Image Version (latest by date) Eth Consensus Spec v1.5.0 ES Version Node Version codecov

Lodestar is a TypeScript implementation of the Ethereum Consensus specification developed by ChainSafe Systems.

Getting started

Prerequisites

Developer Quickstart:
pnpm install
pnpm build
./lodestar --help

Architecture Overview

  • πŸ“¦ This mono-repository contains a suite of Ethereum Consensus packages.
  • βš–οΈ The mono-repository is released under Apache-2.0 license. Note, that the packages contain their own licenses.
PackageVersionLicenseDocsDescription
@chainsafe/lodestarnpmLicensedocumentationπŸ’» Command-line tool for Lodestar
@lodestar/apinpmLicensedocumentationπŸ“‹ REST Client for the Ethereum Beacon API
@lodestar/beacon-nodenpmLicensedocumentation🚨 Beacon-chain client
@lodestar/confignpmLicensedocumentationπŸ—’οΈ Eth Consensus types and params bundled together
@lodestar/dbnpmLicensedocumentationπŸ’Ύ Read/write persistent Eth Consensus data
@lodestar/eranpmLicensedocumentationπŸ“ Era file handling for historical beacon chain data
@lodestar/fork-choicenpmLicensedocumentation🍴 Beacon-chain fork choice
@lodestar/loggernpmLicensedocumentationπŸ“ NodeJS logger for Lodestar binaries
@lodestar/paramsnpmLicensedocumentationπŸ•ΈοΈ Eth Consensus network parameters
@lodestar/reqrespnpmLicensedocumentationπŸ“ž Eth Consensus Req/Resp protocol
@lodestar/spec-test-utilnpmLicensedocumentationπŸ§ͺ Test harness for Eth Consensus spec tests
@lodestar/state-transitionnpmLicensedocumentationπŸ”Ž Eth Consensus beacon-state transition
@lodestar/typesnpmLicensedocumentationπŸ—’οΈ Eth Consensus TypeScript and SSZ types
@lodestar/utilsnpmLicensedocumentation🧰 Miscellaneous utility functions used across Lodestar
@lodestar/validatornpmLicensedocumentation🏦 Validator client

Contributors

Read our contributors document, submit an issue or talk to us on our Discord!

Meetings

Weekly contributor meetings are posted under Discussions and topics are welcomed by any participant in the relevant meeting thread. Feel free to check out our meeting notes and documents on HackMD. Post-September 2021, meeting notes can be found on the Lodestar Wiki Page.

Donations

We are a local group of Toronto open-source developers. As such, all of our open-source work is funded by grants. We all take the time out of our hectic lives to contribute to the Ethereum ecosystem. If you want to donate, you can find the ETH address under "Sponsor this project" on this repository.

beacon-chain
blockchain
eth2
ethereum
proof-of-stake
serenity
typescript

ChainSafe/lodestar

🌟 Ethereum Consensus client for the Zig and TypeScript ecosystem

TypeScript

1,425

11,457 commits

updated Oct 12, 2026

See the code

README

Lodestar Ethereum Consensus Implementation

GitHub release (latest by date) Docker Image Version (latest by date) Eth Consensus Spec v1.5.0 ES Version Node Version codecov

Lodestar is a TypeScript implementation of the Ethereum Consensus specification developed by ChainSafe Systems.

Getting started

Prerequisites

Developer Quickstart:
pnpm install
pnpm build
./lodestar --help

Architecture Overview

  • πŸ“¦ This mono-repository contains a suite of Ethereum Consensus packages.
  • βš–οΈ The mono-repository is released under Apache-2.0 license. Note, that the packages contain their own licenses.
PackageVersionLicenseDocsDescription
@chainsafe/lodestarnpmLicensedocumentationπŸ’» Command-line tool for Lodestar
@lodestar/apinpmLicensedocumentationπŸ“‹ REST Client for the Ethereum Beacon API
@lodestar/beacon-nodenpmLicensedocumentation🚨 Beacon-chain client
@lodestar/confignpmLicensedocumentationπŸ—’οΈ Eth Consensus types and params bundled together
@lodestar/dbnpmLicensedocumentationπŸ’Ύ Read/write persistent Eth Consensus data
@lodestar/eranpmLicensedocumentationπŸ“ Era file handling for historical beacon chain data
@lodestar/fork-choicenpmLicensedocumentation🍴 Beacon-chain fork choice
@lodestar/loggernpmLicensedocumentationπŸ“ NodeJS logger for Lodestar binaries
@lodestar/paramsnpmLicensedocumentationπŸ•ΈοΈ Eth Consensus network parameters
@lodestar/reqrespnpmLicensedocumentationπŸ“ž Eth Consensus Req/Resp protocol
@lodestar/spec-test-utilnpmLicensedocumentationπŸ§ͺ Test harness for Eth Consensus spec tests
@lodestar/state-transitionnpmLicensedocumentationπŸ”Ž Eth Consensus beacon-state transition
@lodestar/typesnpmLicensedocumentationπŸ—’οΈ Eth Consensus TypeScript and SSZ types
@lodestar/utilsnpmLicensedocumentation🧰 Miscellaneous utility functions used across Lodestar
@lodestar/validatornpmLicensedocumentation🏦 Validator client

Contributors

Read our contributors document, submit an issue or talk to us on our Discord!

Meetings

Weekly contributor meetings are posted under Discussions and topics are welcomed by any participant in the relevant meeting thread. Feel free to check out our meeting notes and documents on HackMD. Post-September 2021, meeting notes can be found on the Lodestar Wiki Page.

Donations

We are a local group of Toronto open-source developers. As such, all of our open-source work is funded by grants. We all take the time out of our hectic lives to contribute to the Ethereum ecosystem. If you want to donate, you can find the ETH address under "Sponsor this project" on this repository.

beacon-chain
blockchain
eth2
ethereum
proof-of-stake
serenity
typescript

Project health

Overall

7.0/10

Maintained

10/10

Code review

10/10
OpenSSF Scorecard

Latest release

1.49.0 Β· Sep 28, 2026

Releases this year

16

Significant stargazers

Nico Hinderling

105 followers Β· starred Sep 2022

Ben Gotow

470 followers Β· starred Sep 2020

rakita

420 followers Β· starred Jul 2025

MrChico

320 followers Β· starred Dec 2018