Struct DiscoAdvertisementState 

pub struct DiscoAdvertisementState {
    pub disco_key: [u8; 32],
    pub self_addrs: Vec<IpAddr>,
    pub peers: HashMap<PeerId, AdvertisementTarget>,
}

Where this node sends a TSMP disco-key advertisement, and what it puts in one.

The send half of Go’s capability version 144 (packet.TSMPDiscoKeyAdvertisement): when a WireGuard session with a peer is established, this node announces its own disco public key to that peer over TSMP, so the peer can learn (or re-learn) the key without waiting for a netmap update from control. It is the mirror image of the receive half in [filter_inbound_from_peer], and both are unconditional — a real Go peer sends us one whether or not we send one back.

This is the netmap state Go’s magicsock.Conn.PriorityMessageForPeer reads, snapshotted into the dataplane so building the message stays a cheap, synchronous, allocation-only step on the datapath. wireguard-go requires the same of its callback: “must be cheap and must not call back into the Device”. The runtime refreshes the snapshot whenever the netmap changes.

Fields

disco_key: [u8; 32]

This node’s own disco public key, raw (Go Conn.DiscoPublicKey()). The all-zero key means “no disco key”, and nothing is ever advertised — Go’s first refusal.

self_addrs: Vec<IpAddr>

This node’s own tailnet addresses, in the order control sent them (Go self.Addresses(), already narrowed to the single-IP prefixes selfIPMatchingFamily accepts). The advertisement’s source is the first entry matching the destination’s family.

peers: HashMap<PeerId, AdvertisementTarget>

Where to send an advertisement, per peer. A peer absent from this map is never advertised to — Go’s endpointForNodeKey miss.

Implementations

impl DiscoAdvertisementState

pub fn advertisement_for(&self, peer: PeerId) -> Option<Vec<u8>>

The marshalled TSMP disco-key advertisement to send peer on session establishment, or None if this node must not advertise to it.

Go magicsock.Conn.PriorityMessageForPeer, refusal for refusal — every one of these is a silent “send nothing”, never a fallback to some other message:

1. No disco key of our own (disco.IsZero()): there is nothing to advertise.
2. Unknown peer (endpointForNodeKey miss, or !self.Valid()): the netmap snapshot has no destination address for this WireGuard peer, so any address we invented would be a guess.
3. A WireGuard-only peer (ep.isWireguardOnly): “Do not send TSMP messages to peers that only speaks wireguard.”
4. No source address in the destination’s family (selfIPMatchingFamily returning the zero Addr): an IPv4-only node has nothing to put in the source field of a packet to a peer’s IPv6 address.
5. A marshal refusal, which by construction of (4) cannot happen — see ts_packet::tsmp::DiscoKeyAdvertisement::marshal.

Trait Implementations

impl Clone for DiscoAdvertisementState

fn clone(&self) -> DiscoAdvertisementState

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for DiscoAdvertisementState

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

Formats the value using the given formatter.

impl Default for DiscoAdvertisementState

fn default() -> DiscoAdvertisementState

Returns the “default value” for a type.