Struct LookupRequest 

pub struct LookupRequest {
    pub request_id: u64,
    pub target: NodeAddr,
    pub origin: NodeAddr,
    pub origin_coords: TreeCoordinate,
    pub ttl: u8,
    pub min_mtu: u16,
}

Request to discover a node’s coordinates.

Routed through the spanning tree via bloom-filter-guided forwarding. Each transit node forwards only to tree peers whose bloom filter contains the target. TTL limits propagation depth.

Fields

request_id: u64

Unique request identifier.

target: NodeAddr

Node we’re looking for.

origin: NodeAddr

Who’s asking (for response routing).

origin_coords: TreeCoordinate

Origin’s coordinates (for return path).

ttl: u8

Remaining propagation hops.

min_mtu: u16

Minimum transport MTU the origin requires for a viable route. 0 means no requirement.

Implementations

impl LookupRequest

pub fn new( request_id: u64, target: NodeAddr, origin: NodeAddr, origin_coords: TreeCoordinate, ttl: u8, min_mtu: u16, ) -> Self

Create a new lookup request.

pub fn generate( target: NodeAddr, origin: NodeAddr, origin_coords: TreeCoordinate, ttl: u8, min_mtu: u16, ) -> Self

Generate a new request with a random ID.

pub fn forward(&mut self) -> bool

Decrement TTL for forwarding.

Returns false if TTL was already 0.

pub fn can_forward(&self) -> bool

Check if this request can still be forwarded.

pub fn encode(&self) -> Vec<u8>

Encode as wire format (includes msg_type byte).

Format: [0x30][request_id:8][target:16][origin:16][ttl:1][min_mtu:2] [origin_coords_cnt:2][origin_coords:16×n]

pub fn decode(payload: &[u8]) -> Result<Self, ProtocolError>

Decode from wire format (after msg_type byte has been consumed).

Trait Implementations

impl Clone for LookupRequest

fn clone(&self) -> LookupRequest

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for LookupRequest

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

Formats the value using the given formatter.