mirror of
https://github.com/AtHeartEngineering/lodestar.git
synced 2026-01-09 20:48:00 -05:00
98ab4d2174
* Apply gossip attestations to forkchoice * Only add unaggregated attestation to forkchoice if shouldProcess * Add forkchoice.onAttestation() benchmark * Add hidden cli option network.passGossipAttestationsToForkchoice * Remove single quote to run yarn:benchmark * Cache validated attestation data roots per slot * Fix type issue in yarn:benchmark * Change cli flag to dontSendGossipAttestationsToForkchoice
Lodestar Eth2 Implementation
Lodestar is a TypeScript implementation of the Ethereum 2.0 specification developed by ChainSafe Systems.
Get it from the NPM Registry:
npm install -g @chainsafe/lodestar-cli
Get it from the Docker Hub:
docker pull chainsafe/lodestar
Getting started
- ⚙️ Follow the installation guide to install Lodestar.
- 🌐 Run lodestar on the Eth2 mainnet or on a public testnet.
- 💻 Quickly try out the whole stack by starting a local testnet.
- 🗒️ View the lodestar CLI commands and options.
- 🤓 View the TypeDoc code documentation.
- ✍️ If you have questions submit an issue or join us on Discord!
- 🚨 Please note our security policy.
Prerequisites
Developer Quickstart:
lerna bootstrap
yarn build
./lodestar --help
Architecture Overview
- 📦 This mono-repository contains a suite of Ethereum 2.0 packages.
- 📐 The architecure docs for Lodestar should give an overview over the node modules.
- ⚖️ The mono-repository is released under LGPLv3 license. Note, that the packages contain their own licenses.
| Package | Version | License | Docs | Description |
|---|---|---|---|---|
| @chainsafe/lodestar |  |
 |
 |
🚨 Beacon-chain client |
| @chainsafe/lodestar-validator |  |
|
 |
🏦 Validator client |
| @chainsafe/lodestar-light-client |  |
 |
|
🐦 Eth2 Light client |
| @chainsafe/lodestar-api |  |
|
|
📋 REST Client for the Eth2 API |
| @chainsafe/lodestar-cli | |
|
|
💻 Command-line tool for Lodestar |
| @chainsafe/lodestar-beacon-state-transition |  |
|
|
🔎 Eth2 beacon-state transition |
| @chainsafe/lodestar-types |  |
|
|
🗒️ Eth2 TypeScript and SSZ types |
| @chainsafe/lodestar-params |  |
|
|
🕸️ Eth2 network parameters |
| @chainsafe/lodestar-utils |  |
|
|
🧰 Miscellaneous utility functions used across Lodestar |
| @chainsafe/lodestar-config |  |
|
|
🗒️ Eth2 types and params bundled together |
| @chainsafe/lodestar-spec-test-util |  |
|
|
🧪 Test harness for Eth2 spec tests |
| @chainsafe/lodestar-spec-test-runner | |
🧪 Run all Eth2 spec tests | ||
| @chainsafe/lodestar-db |  |
|
|
💾 Read/write persistent Eth2 data |
| @chainsafe/lodestar-fork-choice |  |
|
|
🍴 Beacon-chain fork choice |
Contributors
Read our contributors document, submit an issue or talk to us on our Discord!
Meetings
Weekly contributor meetings are public and announced on Discord. 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 send us ETH at the following address: lodestar.chainsafe.eth