Struct TreeAnnounce 

pub struct TreeAnnounce {
    pub declaration: ParentDeclaration,
    pub ancestry: TreeCoordinate,
}

Spanning tree announcement carrying parent declaration and ancestry.

Sent to peers to propagate tree state. The declaration proves the sender’s parent selection; the ancestry provides path to root for routing decisions.

Fields

declaration: ParentDeclaration

The sender’s parent declaration.

ancestry: TreeCoordinate

Full ancestry from sender to root.

Implementations

impl TreeAnnounce

pub const VERSION_1: u8 = 0x01

TreeAnnounce wire format version 1.

pub fn new(declaration: ParentDeclaration, ancestry: TreeCoordinate) -> Self

Create a new TreeAnnounce message.

pub fn validate_semantics(&self) -> Result<(), TreeError>

Validate that the ancestry is structurally consistent with the signed declaration.

Expected properties:

• the first ancestry entry is the declaring node’s node_addr
• a root declaration has exactly one ancestry entry
• a non-root declaration has at least two ancestry entries
• for a non-root declaration, the second ancestry entry matches parent_id
• the final ancestry entry is the advertised root
• the advertised root is the smallest node_addr in the ancestry

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

Encode as link-layer plaintext (includes msg_type byte).

The declaration must be signed. The encoded format is:

[0x10][version:1][sequence:8 LE][timestamp:8 LE][parent:16]
[ancestry_count:2 LE][entries:32×n][signature:64]

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

Decode from link-layer payload (after msg_type byte stripped by dispatcher).

The payload starts with the version byte.

Trait Implementations

impl Clone for TreeAnnounce

fn clone(&self) -> TreeAnnounce

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for TreeAnnounce

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

Formats the value using the given formatter.