Struct SubnetDescriptor 

pub struct SubnetDescriptor {
    pub version: u8,
    pub scope: SubnetRef,
    pub topology_epoch: u32,
    pub issuer: EntityId,
    pub revision: u64,
    pub issued_at: u64,
    pub signature: [u8; 64],
}

Root-signed declaration that an authority-qualified path exists under a topology epoch (D1: reparenting or reinterpreting a path creates a NEW epoch; adding a fresh descendant under a stable parent does not).

Deliberately carries no name string or metadata: the descriptor is the “this path is live under epoch E” fact, and the packet path’s zero-string-parse budget (D9) starts with the facts themselves.

Fields

version: u8

Wire version; only 1 decodes.

scope: SubnetRef

The declared authority-qualified path.

topology_epoch: u32

Topology epoch the declaration belongs to.

issuer: EntityId

Signing root.

revision: u64

Per-(SubnetRef, kind) ordering revision; replay/reorder safe.

issued_at: u64

Advisory issue timestamp (unix seconds). A descriptor is superseded by revision, not by expiry.

signature: [u8; 64]

ed25519 over SUBNET_DESCRIPTOR_SIG_DOMAIN ‖ payload.

Implementations

impl SubnetDescriptor

pub const SIGNED_PAYLOAD_SIZE: usize = 89

version 1 + authority 32 + path 4 + epoch 4 + issuer 32 + revision 8 + issued_at 8.

pub const WIRE_SIZE: usize

Payload + 64-byte signature.

pub fn try_issue( root_keypair: &EntityKeypair, scope: SubnetRef, topology_epoch: u32, revision: u64, issued_at: u64, ) -> Result<Self, SubnetAuthError>

Issue signed by root_keypair (issuer is set from it).

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

Wire form: payload ‖ signature.

pub fn from_bytes(bytes: &[u8]) -> Result<Self, SubnetAuthError>

Strict decode; signature NOT verified here.

pub fn verify(&self) -> Result<(), SubnetAuthError>

Signature verification against self.issuer (whether that issuer is a configured root is the store’s decision).

Trait Implementations

impl Clone for SubnetDescriptor

fn clone(&self) -> SubnetDescriptor

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for SubnetDescriptor

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

Formats the value using the given formatter.

impl Eq for SubnetDescriptor

impl PartialEq for SubnetDescriptor

fn eq(&self, other: &SubnetDescriptor) -> bool

Equality operator ==.

fn ne(&self, other: &Rhs) -> bool

Inequality operator !=.

impl StructuralPartialEq for SubnetDescriptor