78d82d9193
* Update to spec v0.9.0 * Update to v0.9.1 * Bump spec tags for v0.9.1 * Formatting, fix CI failures * Resolve accidental KeyPair merge conflict * Document new BeaconState functions * Add `validator` changes from `validator-to-rest` * Add initial (failing) REST api tests * Fix signature parsing * Add more tests * Refactor http router * Add working tests for publish beacon block * Add validator duties tests * Move account_manager under `lighthouse` binary * Unify logfile handling in `environment` crate. * Fix incorrect cache drops in `advance_caches` * Update fork choice for v0.9.1 * Add `deposit_contract` crate * Add progress on validator onboarding * Add unfinished attesation code * Update account manager CLI * Write eth1 data file as hex string * Integrate ValidatorDirectory with validator_client * Move ValidatorDirectory into validator_client * Clean up some FIXMEs * Add beacon_chain_sim * Fix a few docs/logs * Expand `beacon_chain_sim` * Fix spec for `beacon_chain_sim * More testing for api * Start work on attestation endpoint * Reject empty attestations * Allow attestations to genesis block * Add working tests for `rest_api` validator endpoint * Remove grpc from beacon_node * Start heavy refactor of validator client - Block production is working * Prune old validator client files * Start works on attestation service * Add attestation service to validator client * Use full pubkey for validator directories * Add validator duties post endpoint * Use par_iter for keypair generation * Use bulk duties request in validator client * Add version http endpoint tests * Add interop keys and startup wait * Ensure a prompt exit * Add duties pruning * Fix compile error in beacon node tests * Add github workflow * Modify rust.yaml * Modify gitlab actions * Add to CI file * Add sudo to CI npm install * Move cargo fmt to own job in tests * Fix cargo fmt in CI * Add rustup update before cargo fmt * Change name of CI job * Make other CI jobs require cargo fmt * Add CI badge * Remove gitlab and travis files * Add different http timeout for debug * Update docker file, use makefile in CI * Use make in the dockerfile, skip the test * Use the makefile for debug GI test * Update book * Tidy grpc and misc things * Apply discv5 fixes * Address other minor issues * Fix warnings * Attempt fix for addr parsing * Tidy validator config, CLIs * Tidy comments * Tidy signing, reduce ForkService duplication * Fail if skipping too many slots * Set default recent genesis time to 0 * Add custom http timeout to validator * Fix compile bug in node_test_rig * Remove old bootstrap flag from val CLI * Update docs * Tidy val client * Change val client log levels * Add comments, more validity checks * Fix compile error, add comments * Undo changes to eth2-libp2p/src * Reduce duplication of keypair generation * Add more logging for validator duties * Fix beacon_chain_sim, nitpicks * Fix compile error, minor nits * Address Michael's comments
93 lines
3.5 KiB
Markdown
93 lines
3.5 KiB
Markdown
# Lighthouse: Ethereum 2.0
|
|
|
|
An open-source Ethereum 2.0 client, written in Rust and maintained by Sigma Prime.
|
|
|
|
[![Build Status]][Build Link] [![Book Status]][Book Link] [![RustDoc Status]][RustDoc Link] [![Chat Badge]][Chat Link] [![Swagger Badge]][Swagger Link]
|
|
|
|
[Build Status]: https://github.com/sigp/lighthouse/workflows/test-suite/badge.svg
|
|
[Build Link]: https://github.com/sigp/lighthouse/actions
|
|
[Chat Badge]: https://img.shields.io/badge/chat-discord-%237289da
|
|
[Chat Link]: https://discord.gg/cyAszAh
|
|
[Book Status]:https://img.shields.io/badge/user--docs-master-informational
|
|
[Book Link]: http://lighthouse-book.sigmaprime.io/
|
|
[RustDoc Status]:https://img.shields.io/badge/code--docs-master-orange
|
|
[RustDoc Link]: http://lighthouse-docs.sigmaprime.io/
|
|
[Swagger Badge]: https://img.shields.io/badge/Open%20API-0.2.0-success
|
|
[Swagger Link]: https://app.swaggerhub.com/apis-docs/spble/lighthouse_rest_api/0.2.0
|
|
|
|
![terminalize](https://i.postimg.cc/kG11dpCW/lighthouse-cli-png.gif)
|
|
|
|
## Overview
|
|
|
|
Lighthouse is:
|
|
|
|
- Fully open-source, licensed under Apache 2.0.
|
|
- Security-focused. Fuzzing has begun and security reviews are planned
|
|
for late-2019.
|
|
- Built in [Rust](https://www.rust-lang.org/), a modern language providing unique safety guarantees and
|
|
excellent performance (comparable to C++).
|
|
- Funded by various organisations, including Sigma Prime, the
|
|
Ethereum Foundation, ConsenSys and private individuals.
|
|
- Actively involved in the specification and security analysis of the emerging
|
|
Ethereum 2.0 specification.
|
|
|
|
Like all Ethereum 2.0 clients, Lighthouse is a work-in-progress.
|
|
|
|
## Development Status
|
|
|
|
Current development overview:
|
|
|
|
- Specification `v0.8.3` implemented, optimized and passing test vectors.
|
|
- Rust-native libp2p with Gossipsub and Discv5.
|
|
- RESTful JSON API via HTTP server.
|
|
- Events via WebSocket.
|
|
- Metrics via Prometheus.
|
|
|
|
### Roadmap
|
|
|
|
- ~~**April 2019**: Inital single-client testnets.~~
|
|
- ~~**September 2019**: Inter-operability with other Ethereum 2.0 clients.~~
|
|
- **Q4 2019**: `lighthouse-0.0.1` release: All major phase 0
|
|
features implemented.
|
|
- **Q4 2019**: Public, multi-client testnet with user-facing functionality.
|
|
- **Q4 2019**: Third-party security review.
|
|
- **Q1 2020**: Production Beacon Chain testnet (tentative).
|
|
|
|
|
|
## Documentation
|
|
|
|
The [Lighthouse Book](http://lighthouse-book.sigmaprime.io/) contains information
|
|
for testnet users and developers.
|
|
|
|
Code documentation is generated via `cargo doc` and hosted at
|
|
[lighthouse-docs.sigmaprime.io](http://lighthouse-docs.sigmaprime.io/).
|
|
|
|
If you'd like some background on Sigma Prime, please see the [Lighthouse Update
|
|
\#00](https://lighthouse.sigmaprime.io/update-00.html) blog post or
|
|
[sigmaprime.io](https://sigmaprime.io).
|
|
|
|
## Contributing
|
|
|
|
Lighthouse welcomes contributors.
|
|
|
|
If you are looking to contribute, please head to the
|
|
[Contributing](http://lighthouse-book.sigmaprime.io/contributing.html) section
|
|
of the Lighthouse book.
|
|
|
|
## Contact
|
|
|
|
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).
|
|
|
|
Encrypt sensitive messages using our [PGP
|
|
key](https://keybase.io/sigp/pgp_keys.asc?fingerprint=dcf37e025d6c9d42ea795b119e7c6cf9988604be).
|
|
|
|
## Donations
|
|
|
|
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:
|
|
|
|
- [Gitcoin Grants](https://gitcoin.co/grants/25/lighthouse-ethereum-20-client).
|
|
- Ethereum address: `0x25c4a76E7d118705e7Ea2e9b7d8C59930d8aCD3b` (donation.sigmaprime.eth).
|