Enum phron_finality::sync::data::NetworkData

pub enum NetworkData<B, J>
where
    J: Justification,
    B: Block<UnverifiedHeader = <<J as Justification>::Header as Header>::Unverified> + Block,
{
    StateBroadcast(State<J>),
    StateBroadcastResponse(J::Unverified, Option<J::Unverified>),
    Request(Request<J>),
    RequestResponse(Vec<ResponseItem<B, J>>),
    ChainExtensionRequest(State<J>),
}

Data to be sent over the network, current version.

Variants

StateBroadcast(State<J>)

A periodic state broadcast, so that neighbouring nodes can request what they are missing, send what we are missing, and sometimes just use the justifications to update their own state.

StateBroadcastResponse(J::Unverified, Option<J::Unverified>)

Response to a state broadcast. Contains at most two justifications that the peer will understand.

Request(Request<J>)

An explicit request for data, potentially a lot of it.

RequestResponse(Vec<ResponseItem<B, J>>)

Response to the request for data.

ChainExtensionRequest(State<J>)

A request for a chain extension.

Trait Implementations

impl<B, J> Clone for NetworkData<B, J>

where J: Justification + Clone, B: Block<UnverifiedHeader = <<J as Justification>::Header as Header>::Unverified> + Clone + Block, J::Unverified: Clone,

fn clone(&self) -> NetworkData<B, J>

Returns a copy of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl<B, J> Debug for NetworkData<B, J>

where J: Justification + Debug, B: Block<UnverifiedHeader = <<J as Justification>::Header as Header>::Unverified> + Debug + Block, J::Unverified: Debug,

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl<B, J> Decode for NetworkData<B, J>

where J: Justification, B: Block<UnverifiedHeader = <<J as Justification>::Header as Header>::Unverified> + Block, State<J>: Decode, J::Unverified: Decode, Option<J::Unverified>: Decode, Request<J>: Decode, Vec<ResponseItem<B, J>>: Decode,

fn decode<__CodecInputEdqy: Input>( __codec_input_edqy: &mut __CodecInputEdqy ) -> Result<Self, Error>

Attempt to deserialise the value from input.

fn decode_into<I>( input: &mut I, dst: &mut MaybeUninit<Self> ) -> Result<DecodeFinished, Error>

where I: Input,

Attempt to deserialize the value from input into a pre-allocated piece of memory.

fn skip<I>(input: &mut I) -> Result<(), Error>

where I: Input,

Attempt to skip the encoded value from input.

fn encoded_fixed_size() -> Option<usize>

Returns the fixed encoded size of the type.

impl<B, J> Encode for NetworkData<B, J>

where J: Justification, B: Block<UnverifiedHeader = <<J as Justification>::Header as Header>::Unverified> + Block, State<J>: Encode, J::Unverified: Encode, Option<J::Unverified>: Encode, Request<J>: Encode, Vec<ResponseItem<B, J>>: Encode,

fn size_hint(&self) -> usize

If possible give a hint of expected size of the encoding.

fn encode_to<__CodecOutputEdqy: Output + ?Sized>( &self, __codec_dest_edqy: &mut __CodecOutputEdqy )

Convert self to a slice and append it to the destination.

fn encode(&self) -> Vec<u8>

Convert self to an owned vector.

fn using_encoded<R, F>(&self, f: F) -> R

where F: FnOnce(&[u8]) -> R,

Convert self to a slice and then invoke the given closure with it.

fn encoded_size(&self) -> usize

Calculates the encoded size.

impl<B, J> From<NetworkData<B, J>> for NetworkDataV2<B, J>

where J: Justification, B: Block<UnverifiedHeader = <<J as Justification>::Header as Header>::Unverified> + Block,

fn from(data: NetworkData<B, J>) -> Self

Converts to this type from the input type.

impl<B, J> From<NetworkDataV2<B, J>> for NetworkData<B, J>

where J: Justification, B: Block<UnverifiedHeader = <<J as Justification>::Header as Header>::Unverified> + Block,

fn from(data: NetworkDataV2<B, J>) -> Self

Converts to this type from the input type.

impl<B, J, N> Network<NetworkData<B, J>> for VersionWrapper<B, J, N>

where N: GossipNetwork<VersionedNetworkData<B, J>>, J: Justification, B: Block<UnverifiedHeader = <<J as Justification>::Header as Header>::Unverified>,

fn next<'life0, 'async_trait>( &'life0 mut self ) -> Pin<Box<dyn Future<Output = Result<(NetworkData<B, J>, Self::PeerId), Self::Error>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait,

Retrieves next message from the network.

Cancel safety

This method is cancellation safe.

type Error = <N as Network<VersionedNetworkData<B, J>>>::Error

type PeerId = <N as Network<VersionedNetworkData<B, J>>>::PeerId

fn send_to( &mut self, data: NetworkData<B, J>, peer_id: Self::PeerId ) -> Result<(), Self::Error>

Attempt to send data to a peer. Might silently fail if we are not connected to them.

fn send_to_random( &mut self, data: NetworkData<B, J>, peer_ids: HashSet<Self::PeerId> ) -> Result<(), Self::Error>

Send data to a random peer, preferably from a list. It should send the data to a randomly chosen peer from the provided list, but if it cannot (e.g. because it’s not connected) it will send to a random available peer. No guarantees any peer gets it even if no errors are returned, retry appropriately.

fn broadcast(&mut self, data: NetworkData<B, J>) -> Result<(), Self::Error>

Broadcast data to all directly connected peers. Network-wide broadcasts have to be implemented on top of this abstraction. Note that there might be no currently connected peers, so there are no guarantees any single call sends anything even if no errors are returned, retry appropriately.

impl<B, J> EncodeLike for NetworkData<B, J>

where J: Justification, B: Block<UnverifiedHeader = <<J as Justification>::Header as Header>::Unverified> + Block, State<J>: Encode, J::Unverified: Encode, Option<J::Unverified>: Encode, Request<J>: Encode, Vec<ResponseItem<B, J>>: Encode,