Struct Reading 

#[non_exhaustive]
pub struct Reading {
    pub source: String,
    pub witness: Option<String>,
    pub addr: SocketAddr,
}

One source’s report of this node’s reflexive address (SPEC.md §7.1).

#[non_exhaustive]: an additive field is a patch release for consumers, who construct this via Reading::new rather than a struct literal.

Fields (Non-exhaustive)

Non-exhaustive structs could have additional fields added in future. Therefore, non-exhaustive structs cannot be constructed in external crates using the traditional Struct { .. } syntax; cannot be matched against without a wildcard ..; and struct update syntax will not work.

source: String

The independence class of whoever reported this, rendered by SourceClass’s Display impl (i.e. SourceClass::operator(..).to_string()). Two readings corroborate each other exactly when their source strings DIFFER and their addresses agree — string inequality is the ONLY independence comparison this crate defines.

witness: Option<String>

Optional identity of the individual reporter (a peer_id, a resolved server address). For diagnostics only; never consulted by establish.

addr: SocketAddr

The address the source said this node appears at. The PORT is carried but never compared — only the IP participates in agreement (SPEC.md §7.3).

Implementations

impl Reading

pub fn new(source: impl Into<String>, addr: SocketAddr) -> Self

Construct a reading with no witness.

pub fn with_witness(self, witness: impl Into<String>) -> Self

Attach a witness identity for diagnostics (never consulted by establish).

Trait Implementations

impl Clone for Reading

fn clone(&self) -> Reading

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Reading

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

Formats the value using the given formatter.