Enum SourceClass 

pub enum SourceClass {
    Operator {
        host: String,
        port: u16,
    },
    Relay {
        host: String,
    },
    Public {
        host: String,
    },
    PeerV4 {
        a: u8,
        b: u8,
    },
    PeerV6 {
        h0: u16,
        h1: u16,
    },
}

The grammar Reading::source follows (SPEC.md §7.2). Each variant is one independence class; two readings whose classes render the SAME string are the same class and cannot corroborate each other.

Variants

Operator

A server the operator configured (a DIG_STUN_SERVER entry). Each configured endpoint is its own class — the operator vouched for it specifically.

Fields

host: String

The endpoint host, normalised the same way the operator’s config entry was.

port: u16

The endpoint port.

Relay

The DIG relay’s co-located STUN server. One class per relay host.

Fields

host: String

The relay’s host.

Public

A third-party public STUN host (stun.l.google.com, stun.cloudflare.com, …). One class per host — they are different operators.

Fields

host: String

The public STUN host.

PeerV4

A DIG peer answering over IPv4 (SPEC.md §6). One class per IPv4 /16 — the SAME partition dig_gossip::util::ip_address::subnet_group uses, so a consumer already holding that group key renders the identical class from the same IP.

Fields

a: u8

The first octet of the peer’s transport address.

b: u8

The second octet of the peer’s transport address.

PeerV6

A DIG peer answering over IPv6. One class per IPv6 /32.

Fields

h0: u16

The first 16-bit group of the peer’s transport address.

h1: u16

The second 16-bit group of the peer’s transport address.

Implementations

impl SourceClass

pub fn operator(host: impl Into<String>, port: u16) -> Self

The class for a server the operator configured.

pub fn relay(host: impl Into<String>) -> Self

The class for the DIG relay’s co-located STUN server.

pub fn public(host: impl Into<String>) -> Self

The class for a third-party public STUN host.

pub fn peer(ip: IpAddr) -> Self

The class for a DIG peer, from the peer’s TRANSPORT address ip. ip is folded per SPEC.md §5.3 (fold_ip) before its leading bytes are taken, so a mapped or compat IPv6 peer renders the same class as its plain-IPv4 twin. A consumer that already computed dig_gossip::util::ip_address::subnet_group(ip) for the same ip lands in the same partition (SPEC.md §7.2) — this crate does not, and must not, re-implement that function.

pub fn parse(s: &str) -> Option<Self>

Parse a rendered class back out of the grammar. Round-trips every form the Display impl above produces; None for anything else.

Trait Implementations

impl Clone for SourceClass

fn clone(&self) -> SourceClass

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for SourceClass

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

Formats the value using the given formatter.

impl Display for SourceClass

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

Formats the value using the given formatter.

impl Eq for SourceClass

impl PartialEq for SourceClass

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

Equality operator ==.

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

Inequality operator !=.

impl StructuralPartialEq for SourceClass