Struct VersionHandshake 

pub struct VersionHandshake {
    pub max_version: u16,
    pub min_version: u16,
    pub build_id: [u8; 32],
}

First-frame body each side sends. Carries the peer’s supported version window so the other side can compute the negotiated version (or refuse).

Fields

max_version: u16

Max protocol version this peer can speak.

min_version: u16

Min protocol version this peer understands.

build_id: [u8; 32]

Stable build identity — operators read this in sui-daemon status output. Free-form; never load-bearing for negotiation.

Implementations

impl VersionHandshake

pub fn local(build_id: [u8; 32]) -> Self

Construct the local side of the handshake using this build’s compile-time version window.

pub fn negotiate(&self, peer: &VersionHandshake) -> Option<NegotiatedVersion>

Compute the negotiated version against a peer’s handshake.

Errors

Returns None when the two windows don’t overlap (peer too old to talk to us, or we’re too old to talk to them).

pub fn access(bytes: &[u8]) -> Result<&ArchivedVersionHandshake, Error>

Validate-and-cast helper for callers that just received the archived handshake from the wire. Wraps the rkyv access machinery so call sites don’t reinvent it.

Errors

Propagates the rkyv validation error verbatim — typically a length/alignment/tag mismatch means the peer isn’t speaking our protocol at all.

Trait Implementations

impl Archive for VersionHandshake

where u16: Archive, [u8; 32]: Archive,

const COPY_OPTIMIZATION: CopyOptimization<Self>

An optimization flag that allows the bytes of this type to be copied directly to a writer instead of calling serialize.

type Archived = ArchivedVersionHandshake

The archived representation of this type.

type Resolver = VersionHandshakeResolver

The resolver for this type. It must contain all the additional information from serializing needed to make the archived type from the normal type.

fn resolve(&self, resolver: Self::Resolver, out: Place<Self::Archived>)

Creates the archived version of this value at the given position and writes it to the given output.

impl Clone for VersionHandshake

fn clone(&self) -> VersionHandshake

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Copy for VersionHandshake

impl Debug for VersionHandshake

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

Formats the value using the given formatter.

impl<__D: Fallible + ?Sized> Deserialize<VersionHandshake, __D> for Archived<VersionHandshake>

where u16: Archive, <u16 as Archive>::Archived: Deserialize<u16, __D>, [u8; 32]: Archive, <[u8; 32] as Archive>::Archived: Deserialize<[u8; 32], __D>,

fn deserialize( &self, deserializer: &mut __D, ) -> Result<VersionHandshake, <__D as Fallible>::Error>

Deserializes using the given deserializer

impl Eq for VersionHandshake

impl PartialEq for VersionHandshake

fn eq(&self, other: &VersionHandshake) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl<__S: Fallible + ?Sized> Serialize<__S> for VersionHandshake

where u16: Serialize<__S>, [u8; 32]: Serialize<__S>,

fn serialize( &self, serializer: &mut __S, ) -> Result<<Self as Archive>::Resolver, <__S as Fallible>::Error>

Writes the dependencies for the object and returns a resolver that can create the archived type.

impl StructuralPartialEq for VersionHandshake