impl guide: Update Collator Generation (#7250)

* impl guide: Update Collator Generation

* Address review comments

* Fix compile errors

I don't remember why I did this. Maybe it only made sense with the async backing
changes.

* Remove leftover glossary
This commit is contained in:
Marcin S
2023-05-24 09:36:42 -04:00
committed by GitHub
parent 54584ee9f6
commit adad06ef16
3 changed files with 65 additions and 17 deletions
@@ -15,6 +15,17 @@
// along with Polkadot. If not, see <http://www.gnu.org/licenses/>.
//! The collation generation subsystem is the interface between polkadot and the collators.
//!
//! # Protocol
//!
//! On every `ActiveLeavesUpdate`:
//!
//! * If there is no collation generation config, ignore.
//! * Otherwise, for each `activated` head in the update:
//! * Determine if the para is scheduled on any core by fetching the `availability_cores` Runtime API.
//! * Use the Runtime API subsystem to fetch the full validation data.
//! * Invoke the `collator`, and use its outputs to produce a [`CandidateReceipt`], signed with the configuration's `key`.
//! * Dispatch a [`CollatorProtocolMessage::DistributeCollation`](receipt, pov)`.
#![deny(missing_docs)]