Struct PathBroken 

pub struct PathBroken {
    pub dest_addr: NodeAddr,
    pub reporter: NodeAddr,
    pub last_known_coords: Option<TreeCoordinate>,
}

Error indicating routing failure (local minimum or unreachable).

Carried inside a SessionDatagram addressed back to the original source. The reporting router creates a new SessionDatagram with src_addr=reporter and dest_addr=original_source, so the original_src field from the old design is no longer needed — it’s the SessionDatagram’s dest_addr.

Wire Format

Offset	Field	Size	Description
0	msg_type	1 byte	0x21
1	flags	1 byte	Reserved
2	dest_addr	16 bytes	The unreachable node_addr
18	reporter	16 bytes	NodeAddr of reporting router
34	last_coords_count	2 bytes	u16 LE
36	last_known_coords	16 × n	Stale coords that failed

Fields

dest_addr: NodeAddr

Destination that couldn’t be reached.

reporter: NodeAddr

Node that detected the failure.

last_known_coords: Option<TreeCoordinate>

Optional: last known coordinates of destination.

Implementations

impl PathBroken

pub fn new(dest_addr: NodeAddr, reporter: NodeAddr) -> Self

Create a new PathBroken error.

pub fn with_last_coords(self, coords: TreeCoordinate) -> Self

Add last known coordinates.

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

Encode as wire format (4-byte FSP prefix + msg_type + body).

Error signals use phase=0x0 with U flag set.

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

Decode from wire format (after FSP prefix and msg_type byte consumed).

Trait Implementations

impl Clone for PathBroken

fn clone(&self) -> PathBroken

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for PathBroken

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

Formats the value using the given formatter.