24 releases (10 breaking)
✓ Uses Rust 2018 edition
|0.11.2||Mar 19, 2020|
|0.11.0||Jan 16, 2020|
|0.10.2||Dec 10, 2019|
|0.10.1||Nov 26, 2019|
|0.4.0||Nov 23, 2018|
#6 in Cryptocurrencies
5,685 downloads per month
Used in sc-finality-grandpa
GRANDPA, GHOST-based Recursive ANcestor Deriving Prefix Agreement, is a finality gadget for blockchains, implemented in Rust. It allows a set of nodes to come to BFT agreement on what is the canonical chain, which is produced by some external block production mechanism. It works under the assumption of a partially synchronous network model and with the presence of up to 1/3 Byzantine nodes.
The only dependency required to build and run the tests is to have a stable version of Rust installed.
git clone https://github.com/paritytech/finality-grandpa cd finality-grandpa cargo build cargo test
Add this to your Cargo.toml:
[dependencies] finality-grandpa = "0.10"
Encodeinstances of parity-scale-codec for all the protocol messages.
test-helpers- Expose some opaque types for testing purposes.
This crate only implements the state machine for the GRANDPA protocol. In order to use this crate it is necessary to implement some traits to do the integration which are responsible for providing access to the underyling blockchain and setting up all the network communication.
Chain trait allows the GRANDPA voter to check ancestry of a given block and also to query the
best block in a given chain (which will be used for voting on).
Environment trait defines the types that will be used for the input and output stream to
receive and broadcast messages. It is also responsible for setting these up for a given round
round_data), as well as timers which are used for timeouts in the protocol.
The trait exposes callbacks for the full lifecycle of a round:
As well as callbacks for notifying about block finality and voter misbehavior (equivocations).
The main user of this crate is Substrate and should be the main resource used to look
into how the integration is done. The
should have most of the relevant integration code.
Most importantly this crate does not deal with authority set changes. It assumes that the set of authorities is always the same. Authority set handoffs are handled in Substrate by listening to signals emitted on the underlying blockchain.
Usage is provided under the Apache License (Version 2.0). See LICENSE for the full details.