guide: collator networking & subsystems (#1452)

* Do a small write-up on collation-generation

* preamble to collator protocol

* notes on protocol

* collation-generation: point to collator protocol

* fix missing bracket

* expand on collator protocol wire protocol

* add a couple more sentences

* expand on requests some more

* go higher level

* network bridge: note peerset

* note peer-set = validation for protocols

* add `ConnectToValidators` message

* use ConnectToValidators in collator protocol

* typo

* remove references to sentry nodes
This commit is contained in:
Robert Habermeier
2020-07-31 11:07:31 -04:00
committed by GitHub
parent ea834b12de
commit 490f80d8c7
11 changed files with 228 additions and 23 deletions
@@ -4,7 +4,7 @@ This subsystem is responsible for distributing PoV blocks. For now, unified with
## Protocol
`ProtocolId`: `b"povd"`
`ProtocolId`: `b"povd"`, `PeerSet`: `Validation`
Input: [`PoVDistributionMessage`](../../types/overseer-protocol.md#pov-distribution-message)
@@ -18,7 +18,7 @@ Output:
## Functionality
This network protocol is responsible for distributing [`PoV`s](../../types/availability.md#proof-of-validity) by gossip. Since PoVs are heavy in practice, gossip is far from the most efficient way to distribute them. In the future, this should be replaced by a better network protocol that finds validators who have validated the block and connects to them directly. This protocol is descrbied
This network protocol is responsible for distributing [`PoV`s](../../types/availability.md#proof-of-validity) by gossip. Since PoVs are heavy in practice, gossip is far from the most efficient way to distribute them. In the future, this should be replaced by a better network protocol that finds validators who have validated the block and connects to them directly. This protocol is descrbied.
This protocol is described in terms of "us" and our peers, with the understanding that this is the procedure that any honest node will run. It has the following goals:
- We never have to buffer an unbounded amount of data