Struct MultiHopAssignment 

pub struct MultiHopAssignment {
    pub exit: NodeId,
    pub forwarder_chain: Vec<ForwarderLease>,
    pub client_wg_config: WgPeerConfig,
}

Multi-hop match: client routes through a chain of forwarders to an exit (R-MULTIHOP-PROTO).

Carries everything the client needs to bring its WireGuard session up — the public side of the client↔exit session plus the per-forwarder lease rows the forwarders need to authorise the relayed packets.

Structural invariants (unrepresentable invalid states)

• Non-empty chain. Self::forwarder_chain holds at least one ForwarderLease; multi-hop with zero forwarders is by definition the single-hop case, which lives in MatchResponse::SingleHop. Validated on deserialize via a serde(try_from = ...) shim that surfaces an empty chain as a MultiHopAssignmentError::EmptyChain inside the standard postcard / serde error path.
• Forwarder ↔ lease binding by construction. Each chain entry IS a ForwarderLease, so the ForwarderLease::forwarder NodeId and its lease row are one element — no parallel Vecs, no positional-alignment bug surface. The flow direction is the Vec’s order: traffic enters forwarder_chain[0], hops through each successor, and exits the chain at forwarder_chain[last]’s downstream socket (which terminates on Self::exit).

See crate::multihop for the on-the-wire packet-to-lease binding mechanism (chosen: option (B), explicit relay framing).

Fields

exit: NodeId

Final exit serving the client’s traffic.

forwarder_chain: Vec<ForwarderLease>

Ordered forwarder chain between the client and exit.

The client sends its outbound WireGuard packets to forwarder_chain[0]’s upstream socket; each forwarder relays to the next; the last entry relays to exit. Non-empty by construction — see the type-level invariants section.

client_wg_config: WgPeerConfig

Client-facing WireGuard peer config for the client↔exit session.

Trait Implementations

impl Clone for MultiHopAssignment

fn clone(&self) -> MultiHopAssignment

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for MultiHopAssignment

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for MultiHopAssignment

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl PartialEq for MultiHopAssignment

fn eq(&self, other: &MultiHopAssignment) -> 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 Serialize for MultiHopAssignment

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl Eq for MultiHopAssignment

impl StructuralPartialEq for MultiHopAssignment