Lodestar is a free, open-source Ethereum consensus client written in TypeScript, built for node operators and developers who want to run or study the Ethereum consensus layer on their own hardware. It is released under the Apache-2.0 license and is distributed through GitHub and Docker.
If you are new to running Ethereum infrastructure, think of a consensus client as the part of a node that follows proof-of-stake rules and tracks the beacon chain. It works alongside an execution client, and it is also the piece validators rely on to take part in block production. Windows builds are listed as likely, so confirm availability on the releases page. This page covers what the program does, how to get it running, and what to check before you trust it with a node.
What Is an Ethereum Consensus Client?
An Ethereum node is really two pieces of software running side by side. The execution client handles transactions and smart contract state, while the consensus client decides which blocks are canonical under proof of stake. The consensus client follows the beacon chain, checks attestations and tracks finality, so the node stays in agreement with the rest of the network.
Consensus clients also serve validators. A validator is an account that stakes ETH and takes on duties such as proposing blocks and attesting to them. Those duties are coordinated by the consensus layer, which is why operators who want to stake need a reliable consensus client in addition to an execution client.
Implementations differ in language, performance goals and resource use, which is why the ecosystem includes several independent consensus clients. Client diversity matters because it keeps the network resilient if one implementation has a bug.
Who Lodestar Is For
Lodestar suits a few specific groups. Developers who already work in TypeScript can read the codebase, run tests and experiment with protocol changes without learning a new language. Research teams and students can use it to see how consensus logic is written in practice.
Node operators are the other main audience. Someone who wants to run a consensus client on a home server or in a container, pair it with an execution client, and monitor sync status will find the project a reasonable fit. It is less suited to people who want a point-and-click desktop app, since it is a command-line program meant for technical setups.
Two example scenarios make this concrete. A small engineering team building internal tooling on Ethereum might run a Lodestar node in Docker to query chain data. A hobbyist might run one on a spare PC to learn how proof of stake works. Both should expect to read documentation and troubleshoot logs.
How Consensus and Execution Clients Work Together
A complete Ethereum node usually runs an execution client and a consensus client as two separate processes. They communicate through a local interface defined by the Ethereum specifications, so either side can be swapped for a different implementation that follows the same rules.
When a node starts, it typically syncs. The consensus client finds peers, downloads the beacon chain and verifies that the chain is valid, while the execution client processes transactions and state in parallel. Sync can take a long time on the first run, so plan for patience and enough disk space.
Mixing clients is a common practice that improves resilience. If one implementation has a bug, nodes running different pairs are less likely to fail together. Choosing a pair is therefore a balance between performance, resource use and diversity, not just a matter of picking the most popular program.
Key features
Modular Monorepo
Apache-2.0 Licensing
TypeScript Codebase
Docker Support
Supported coins
Lodestar is built for Ethereum (ETH), the network its documentation names. It is a consensus-layer client, so it does not hold coins or support altcoin networks. Anyone who wants to use it for another blockchain should look for a client designed for that network.
How to install Lodestar on Windows
- 1
Get the program from the official source
Download only from the official website or the GitHub Releases page at github.com/ChainSafe/lodestar. Avoid mirrors and links shared on forums or chat, since a modified file can look identical on the surface.
- 2
Verify the file
Compare the SHA-256 checksum of the downloaded file with the value published on the release page. If the values differ, delete the file and download it again from the official source. If a signature is provided, verify it as well.
- 3
Choose an install method
Windows builds are listed as likely, so check the release assets for a Windows package for the version you want. If none is available, use the Docker image, which the project lists as a supported platform.
-
Install and confirm
Run the installer or extract the archive to a folder you control. Open a terminal, run the help command and confirm the version output before connecting the node to a network.
How to use Lodestar
Once the program is installed, the basic workflow is to check the help output, connect the client to an execution client, and start syncing. Run commands from a terminal opened in the folder where you placed the program, or inside your Docker environment.
- Open a terminal and run the client's help command to see the options available in your build.
- Decide where the node's data will live and make sure the drive has enough free space for a full sync.
- Start or connect an execution client that Lodestar can use, so the node has both layers.
- Launch Lodestar with the network set to Ethereum and the data directory you chose.
- Watch the logs until the node reports that it is syncing and then following the chain head.
- Check sync status through the client's logs or local interface regularly during the first days.
- If you plan to validate, add validator keys only after the node is fully synced, and keep key files private.
Stop the client with a normal shutdown rather than force-closing the window, so the database has a chance to write cleanly.
Pros & cons
- Free to use and open source under Apache-2.0
- Written in TypeScript, which is approachable for JavaScript developers
- Organized as a monorepo of Ethereum consensus packages
- Available as a Docker image for containerized setups
- Focused on one network, Ethereum
- Windows support is listed as likely rather than confirmed for every release
- A full node also needs a separate execution client
- Command-line setup is demanding for beginners
- The newest listed build is a release candidate, so expect changes
Is Lodestar safe?
Download only from the official website or the GitHub Releases page, and check the SHA-256 checksum or signature before running anything. Lodestar is open source, so the community can review the code, but most people rely on published checksums to confirm they have the right file. Never enter a seed phrase or send a validator keystore password to a third-party website, chat or 'support' contact, because legitimate node software does not ask for them online. The newest listed build is a release candidate, so check the latest stable version on the official website before running it for validation. Treat validator key files like money: keep offline backups and limit who can access the machine.
- Official source only. Download from github.com/ChainSafe/lodestar. Ignore ads and lookalike domains.
- Check the SHA-256. Compare the installer hash with the value the developer publishes before running it.
- Never share your seed phrase. No developer, support agent or website — including CryptApps — will ever ask for it.
Alternatives
Lodestar is a consensus client, so it is not a like-for-like swap for most execution clients on this list. Geth, the official Go implementation, and Nethermind, built on .NET, handle transactions and state, and both are normally paired with a consensus client rather than replacing one. Erigon is aimed at execution-layer performance. Nimbus is another consensus client, known for being lightweight. Lodestar's distinguishing traits are its TypeScript codebase and its monorepo of consensus packages. Choose based on the layer you need, your language preferences and your hardware, and remember that pairing different implementations supports network diversity.
Specifications
- Price
- Free
- Type
- Open source
- License
- Apache-2.0
- Latest version
- v1.51.0-rc.0
- Last update
- 31 Oct 2026
- Windows support
- Likely (builds for Windows; check releases)
- Source code
- github.com/ChainSafe/lodestar
Frequently asked questions
It can be, if you get it from the project's official GitHub Releases page and check the SHA-256 checksum before running it. Lodestar is open source under Apache-2.0, so its code can be reviewed publicly. Keep validator keys and passwords offline, because a clean download does not protect them from phishing pages.
Yes. The program is listed as free, and its code is released under the Apache-2.0 license. That license lets you use, modify and redistribute the software under its terms. Some individual packages in the monorepo include their own licenses, so check those if you reuse code in another project.
Windows support is listed as likely rather than guaranteed. The project builds for Windows, but whether a ready-made Windows package is available depends on each release. Check the latest release assets on GitHub. If no Windows package is present, the Docker image is an alternative.
A full Ethereum node needs both a consensus client and an execution client. Lodestar handles the consensus layer, so it must be paired with an execution implementation such as Geth or Nethermind to process transactions and state. Running only the consensus side does not give you a complete node.
Lodestar is built for Ethereum, and its documentation names Ethereum (ETH) as the network it serves. It is not designed for other blockchains, so it will not connect to unrelated networks. Check the documentation for current network configuration options.
Lodestar and Geth work at different layers. Geth is the official Go implementation of the Ethereum execution protocol, while Lodestar is a consensus client written in TypeScript. Most operators run one of each, so the choice is rarely either-or for a complete node.
No. Lodestar is a node client that follows the Ethereum network and, if you run validators, handles validator duties. It is not a wallet and does not hold your funds. For storing coins, use a separate wallet program with its own key management, and keep your seed phrase offline.
Verdict
Lodestar is a sound choice for developers and technically confident operators who want an open-source Ethereum consensus client written in TypeScript. It is free, Apache-2.0 licensed and available through Docker, which covers many server setups. Beginners who want a one-click desktop experience may find the setup demanding, and Windows users should confirm a ready-made build for their chosen version. Pair it with a trusted execution client, follow the safety steps, and test on your own machine before relying on it for validation.