README.md 2.01 KiB
Newer Older
# Parity Shasper
[![crates.io](https://img.shields.io/crates/v/beacon.svg)](https://crates.io/crates/beacon)
[![Documentation](https://docs.rs/beacon/badge.svg)](https://docs.rs/beacon)
Wei Tang's avatar
Wei Tang committed

This is an implementation of
[Serenity](https://github.com/ethereum/eth2.0-specs) beacon chain by Parity
Technologies. To learn more about Serenity and Ethereum's sharding plan, see the
[sharding FAQ](https://github.com/ethereum/wiki/wiki/Sharding-FAQ) and the
[research compendium](https://notes.ethereum.org/s/H1PGqDhpm).
Wei Tang's avatar
Wei Tang committed

Parity Shasper consists of a core library `beacon` which handles beacon chain
state transition logic, a client built on
[Substrate](https://github.com/paritytech/substrate) framework (in `substrate`
folder), and a lightweight client built from ground up (in `blockchain`
folder). The `substrate` client and the `blockchain` client shares the core
library, but operates independently.
Wei Tang's avatar
Wei Tang committed

To build the client, you need to have [Rust](https://www.rust-lang.org/)
installed. Other dependencies required including `pkgconfig`, `libudev`,
`openssl`, `cmake`, `clang`.
Wei Tang's avatar
Wei Tang committed

## `substrate` client
Wei Tang's avatar
Wei Tang committed

The `substrate` client is currently being reworked at this moment. Stay tuned!
Wei Tang's avatar
Wei Tang committed

## `blockchain` client

The `blockchain` client uses spec archive LMD-GHOST consensus and Serenity
`beacon` v0.8 runtime. The client implements a basic in-memory backend and
networking stack based on `libp2p`. It also contains basic validator logic and
can participate in beacon chain proposing and attestation.

To build the `blockchain` client:
Wei Tang's avatar
Wei Tang committed

```bash
cd ./blockchain && cargo run --release -- --author
Wei Tang's avatar
Wei Tang committed
```

## FAQ

**Why common caching strategies for `beacon` and LMD-GHOST are not yet
implemented?**

Internally we made the decision that we will strictly follow the beacon chain
specification for now, and implement optimizations after the specification is
frozen. This is because the specification still changes a lot, and we worry that
optimizations we make right now will make upgrading to a newer version of the
specification much harder.
Wei Tang's avatar
Wei Tang committed

## License

Licensed under GPLv3.