#consensus-algorithm #parachain #block #collator #validation #relay-chain

cumulus-client-consensus-relay-chain

The relay-chain provided consensus algorithm

18 breaking releases

0.21.0 Jan 29, 2025
0.18.0 Oct 1, 2024
0.17.0 Jul 19, 2024
0.10.0 Mar 19, 2024
0.0.0 Nov 14, 2022

#8 in #collator

Download history 73/week @ 2024-12-01 129/week @ 2024-12-08 106/week @ 2024-12-15 44/week @ 2024-12-22 28/week @ 2024-12-29 74/week @ 2025-01-05 200/week @ 2025-01-12 168/week @ 2025-01-19 268/week @ 2025-01-26 255/week @ 2025-02-02 271/week @ 2025-02-09 164/week @ 2025-02-16 169/week @ 2025-02-23 118/week @ 2025-03-02 111/week @ 2025-03-09 107/week @ 2025-03-16

544 downloads per month
Used in 11 crates (4 directly)

GPL-3.0-or-later…

62KB
280 lines

Release

Polkadot SDK Stable 2412


lib.rs:

The relay-chain provided consensus algorithm for parachains.

This is the simplest consensus algorithm you can use when developing a parachain. It is a permission-less consensus algorithm that doesn't require any staking or similar to join as a collator. In this algorithm the consensus is provided by the relay-chain. This works in the following way.

  1. Each node that sees itself as a collator is free to build a parachain candidate.

  2. This parachain candidate is send to the parachain validators that are part of the relay chain.

  3. The parachain validators validate at most X different parachain candidates, where X is the total number of parachain validators.

  4. The parachain candidate that is backed by the most validators is chosen by the relay-chain block producer to be added as backed candidate on chain.

  5. After the parachain candidate got backed and included, all collators start at 1.

Dependencies

~100–140MB
~2.5M SLoC