2019-06-25 04:02:19 +00:00
|
|
|
# Lighthouse: Ethereum 2.0
|
|
|
|
|
|
|
|
An open-source Ethereum 2.0 client, written in Rust and maintained by Sigma Prime.
|
2018-07-06 07:54:07 +00:00
|
|
|
|
2020-09-10 00:24:41 +00:00
|
|
|
[![Build Status]][Build Link] [![Book Status]][Book Link] [![Chat Badge]][Chat Link]
|
2019-05-10 01:49:28 +00:00
|
|
|
|
2019-12-01 02:08:26 +00:00
|
|
|
[Build Status]: https://github.com/sigp/lighthouse/workflows/test-suite/badge.svg?branch=master
|
2019-11-25 04:48:24 +00:00
|
|
|
[Build Link]: https://github.com/sigp/lighthouse/actions
|
2019-07-31 21:53:30 +00:00
|
|
|
[Chat Badge]: https://img.shields.io/badge/chat-discord-%237289da
|
|
|
|
[Chat Link]: https://discord.gg/cyAszAh
|
2019-10-02 01:04:56 +00:00
|
|
|
[Book Status]:https://img.shields.io/badge/user--docs-master-informational
|
2020-11-09 01:28:39 +00:00
|
|
|
[Book Link]: https://lighthouse-book.sigmaprime.io
|
2020-11-24 04:42:17 +00:00
|
|
|
[stable]: https://github.com/sigp/lighthouse/tree/stable
|
|
|
|
[unstable]: https://github.com/sigp/lighthouse/tree/unstable
|
|
|
|
[blog]: https://lighthouse.sigmaprime.io
|
2019-10-02 01:04:56 +00:00
|
|
|
|
2020-11-09 01:28:39 +00:00
|
|
|
[Documentation](https://lighthouse-book.sigmaprime.io)
|
2019-12-09 11:42:36 +00:00
|
|
|
|
2020-10-23 04:16:38 +00:00
|
|
|
![Banner](https://i.postimg.cc/hjdTGKPd/photo-2020-10-23-09-52-16.jpg)
|
2018-07-12 05:01:28 +00:00
|
|
|
|
2019-06-25 04:02:19 +00:00
|
|
|
## Overview
|
|
|
|
|
|
|
|
Lighthouse is:
|
|
|
|
|
2020-11-24 04:42:17 +00:00
|
|
|
- Ready for use on Eth2 mainnet.
|
2019-06-25 04:02:19 +00:00
|
|
|
- Fully open-source, licensed under Apache 2.0.
|
2020-08-04 09:19:14 +00:00
|
|
|
- Security-focused. Fuzzing has begun and security reviews are underway.
|
2020-11-09 01:28:39 +00:00
|
|
|
- Built in [Rust](https://www.rust-lang.org), a modern language providing unique safety guarantees and
|
2019-06-25 04:02:19 +00:00
|
|
|
excellent performance (comparable to C++).
|
|
|
|
- Funded by various organisations, including Sigma Prime, the
|
2019-07-26 19:26:06 +00:00
|
|
|
Ethereum Foundation, ConsenSys and private individuals.
|
2020-10-23 04:16:38 +00:00
|
|
|
- Actively involved in the specification and security analysis of the
|
|
|
|
Ethereum 2.0 specification.
|
2019-06-25 04:02:19 +00:00
|
|
|
|
2020-11-04 19:46:42 +00:00
|
|
|
## Eth2 Deposit Contract
|
|
|
|
|
|
|
|
The Lighthouse team acknowledges
|
|
|
|
[`0x00000000219ab540356cBB839Cbe05303d7705Fa`](https://etherscan.io/address/0x00000000219ab540356cbb839cbe05303d7705fa)
|
|
|
|
as the canonical Eth2 deposit contract address.
|
|
|
|
|
2020-11-24 04:42:17 +00:00
|
|
|
## Documentation
|
2019-06-25 04:02:19 +00:00
|
|
|
|
2020-11-24 04:42:17 +00:00
|
|
|
The [Lighthouse Book](https://lighthouse-book.sigmaprime.io) contains information for users and
|
|
|
|
developers.
|
2019-06-25 04:02:19 +00:00
|
|
|
|
2020-11-24 04:42:17 +00:00
|
|
|
The Lighthouse team maintains a blog at [lighthouse.sigmaprime.io][blog] which contains periodical
|
|
|
|
progress updates, roadmap insights and interesting findings.
|
2019-06-25 04:02:19 +00:00
|
|
|
|
2020-11-24 04:42:17 +00:00
|
|
|
## Branches
|
2019-06-25 04:02:19 +00:00
|
|
|
|
2020-11-24 04:42:17 +00:00
|
|
|
Lighthouse maintains two permanent branches:
|
2019-06-25 04:02:19 +00:00
|
|
|
|
2020-11-24 04:42:17 +00:00
|
|
|
- [`stable`][stable]: Always points to the latest stable release.
|
|
|
|
- This is ideal for most users.
|
|
|
|
- [`unstable`][unstable]: Used for development, contains the latest PRs.
|
|
|
|
- Developers should base thier PRs on this branch.
|
2019-02-28 13:18:53 +00:00
|
|
|
|
2019-06-25 04:02:19 +00:00
|
|
|
## Contributing
|
|
|
|
|
2019-10-02 01:04:56 +00:00
|
|
|
Lighthouse welcomes contributors.
|
2019-02-14 01:09:18 +00:00
|
|
|
|
2019-10-02 01:04:56 +00:00
|
|
|
If you are looking to contribute, please head to the
|
2020-11-09 01:28:39 +00:00
|
|
|
[Contributing](https://lighthouse-book.sigmaprime.io/contributing.html) section
|
2019-10-02 01:04:56 +00:00
|
|
|
of the Lighthouse book.
|
2018-07-06 07:54:07 +00:00
|
|
|
|
|
|
|
## Contact
|
|
|
|
|
2019-07-31 21:53:30 +00:00
|
|
|
The best place for discussion is the [Lighthouse Discord
|
|
|
|
server](https://discord.gg/cyAszAh). Alternatively, you may use the
|
|
|
|
[sigp/lighthouse gitter](https://gitter.im/sigp/lighthouse).
|
2018-10-03 08:37:28 +00:00
|
|
|
|
2020-11-16 06:28:11 +00:00
|
|
|
Sign up to the [Lighthouse Development Updates](https://mailchi.mp/3d9df0417779/lighthouse-dev-updates)
|
|
|
|
mailing list for email notifications about releases, network status and other important information.
|
|
|
|
|
2019-10-02 01:04:56 +00:00
|
|
|
Encrypt sensitive messages using our [PGP
|
|
|
|
key](https://keybase.io/sigp/pgp_keys.asc?fingerprint=dcf37e025d6c9d42ea795b119e7c6cf9988604be).
|
|
|
|
|
2019-06-25 04:02:19 +00:00
|
|
|
## Donations
|
2018-12-19 01:54:31 +00:00
|
|
|
|
2019-10-02 01:04:56 +00:00
|
|
|
Lighthouse is an open-source project and a public good. Funding public goods is
|
|
|
|
hard and we're grateful for the donations we receive from the community via:
|
2018-12-19 01:54:31 +00:00
|
|
|
|
2019-10-02 01:04:56 +00:00
|
|
|
- [Gitcoin Grants](https://gitcoin.co/grants/25/lighthouse-ethereum-20-client).
|
|
|
|
- Ethereum address: `0x25c4a76E7d118705e7Ea2e9b7d8C59930d8aCD3b` (donation.sigmaprime.eth).
|