Skip to content

ChainSafe/lodestar

This branch is 38 commits ahead of, 6 commits behind unstable.

Folders and files

NameName
Last commit message
Last commit date

Latest commit

7f44cd9 Β· Feb 13, 2025
May 24, 2024
Feb 12, 2025
Dec 3, 2024
Jan 31, 2022
Mar 31, 2020
Feb 11, 2025
May 24, 2024
Feb 11, 2025
Feb 13, 2025
Dec 19, 2024
Nov 17, 2024
Jan 31, 2025
May 30, 2022
Mar 7, 2021
Feb 8, 2024
Dec 12, 2023
Oct 10, 2024
Jan 15, 2025
Dec 6, 2024
Oct 11, 2024
Jun 14, 2020
Jun 21, 2023
Dec 19, 2024
Dec 19, 2024
Jan 21, 2025
Jun 4, 2024
Jun 4, 2024
Dec 19, 2024
Dec 19, 2024
May 30, 2022
Jan 31, 2025
Jun 10, 2024
Aug 20, 2022
Jan 23, 2024
Oct 8, 2024
Jan 31, 2025
Jan 23, 2025
Jan 31, 2025
Jan 12, 2023
Jan 22, 2024
Sep 22, 2023
Sep 22, 2023
Aug 27, 2024
Jan 2, 2025
Jan 22, 2024
Jan 22, 2024
Jun 5, 2024
Feb 12, 2025

Repository files navigation

Lodestar Ethereum Consensus Implementation

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

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

Getting started

Prerequisites

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

Architecture Overview

  • πŸ“¦ This mono-repository contains a suite of Ethereum Consensus packages.
  • βš–οΈ The mono-repository is released under LGPLv3 license. Note, that the packages contain their own licenses.
Package Version License Docs Description
@chainsafe/lodestar npm License: LGPL v3 documentation πŸ’» Command-line tool for Lodestar
@lodestar/api npm License documentation πŸ“‹ REST Client for the Ethereum Beacon API
@lodestar/beacon-node npm License: LGPL v3 documentation 🚨 Beacon-chain client
@lodestar/config npm License documentation πŸ—’οΈ Eth Consensus types and params bundled together
@lodestar/db npm License documentation πŸ’Ύ Read/write persistent Eth Consensus data
@lodestar/flare npm License documentation πŸ’₯ Command tool for triggering non-standard actions
@lodestar/fork-choice npm License documentation 🍴 Beacon-chain fork choice
@lodestar/light-client npm License documentation 🐦 Ethereum Light client
@lodestar/logger npm License documentation πŸ“ NodeJS logger for Lodestar binaries
@lodestar/params npm License documentation πŸ•ΈοΈ Eth Consensus network parameters
@lodestar/prover npm License documentation βœ… Ethereum Light client verifier for execution JSON-RPC calls
@lodestar/reqresp npm License documentation πŸ“ž Eth Consensus Req/Resp protocol
@lodestar/spec-test-util npm License documentation πŸ§ͺ Test harness for Eth Consensus spec tests
@lodestar/state-transition npm License documentation πŸ”Ž Eth Consensus beacon-state transition
@lodestar/types npm License documentation πŸ—’οΈ Eth Consensus TypeScript and SSZ types
@lodestar/utils npm License documentation 🧰 Miscellaneous utility functions used across Lodestar
@lodestar/validator npm License: LGPL v3 documentation 🏦 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.