Struct ProtocolVersionManager 

pub struct ProtocolVersionManager { /* private fields */ }

Central registry and negotiation engine for protocol versions.

Peers register their local ProtocolDescriptors and then call negotiate when a remote peer’s descriptor arrives. The manager updates internal statistics for every attempt.

Implementations

impl ProtocolVersionManager

pub fn new() -> Self

Create an empty manager with no registered protocols.

pub fn register(&mut self, descriptor: ProtocolDescriptor) -> bool

Register a local ProtocolDescriptor.

Returns true if this is a new registration, false if a descriptor with the same name already existed and was overwritten.

pub fn negotiate( &mut self, protocol: &str, remote: &ProtocolDescriptor, ) -> Option<NegotiationResult>

Attempt to negotiate with a remote peer’s ProtocolDescriptor.

Returns Some(NegotiationResult) on success, None when:

• The protocol is not registered locally, or
• The versions are Incompatible in both directions.

Compatibility check flow:

1. We check the remote version against our local descriptor’s min_compatible floor.
2. We also check our local version against the remote descriptor’s min_compatible floor — we must be acceptable to them too.
3. If both checks pass, a NegotiationResult is produced.

Agreed version selection: The session runs at min(local.version, remote.version) — the older of the two — ensuring that neither side uses features unavailable to the other.

pub fn find_common_features(local: &[String], remote: &[String]) -> Vec<String>

Compute the intersection of two feature sets, preserving the order of the local side.

pub fn get_descriptor(&self, protocol: &str) -> Option<&ProtocolDescriptor>

Look up the registered descriptor for a protocol by name.

pub fn is_registered(&self, protocol: &str) -> bool

Return true if a descriptor for protocol has been registered.

pub fn supported_protocols(&self) -> Vec<&str>

Return all registered protocol names as string slices.

pub fn stats(&self) -> &VersionStats

Read-only view of the accumulated negotiation statistics.

Trait Implementations

impl Default for ProtocolVersionManager

fn default() -> Self

Returns the “default value” for a type.