Struct OnlineNodeDescriptor 

pub struct OnlineNodeDescriptor {

    pub did: Did,
    pub public_key: VerificationPublicKey,
    pub session_public_key: PublicKey<33>,
    pub node_type: OnlineNodeType,
    pub network_id: u32,
    pub storage_redundancy: u16,
    pub dht_virtual_nodes: u16,
    pub capabilities: Vec<String>,
    pub endpoint_hint: Option<String>,
    pub started_at_ms: u128,
    pub heartbeat_at_ms: u128,
    pub expires_at_ms: u128,
    pub version: String,
    pub signature: MessageVerification,
}

Signed descriptor published by online nodes.

Fields

did: Did

DID of the node/account.

public_key: VerificationPublicKey

Account public key corresponding to did.

session_public_key: PublicKey<33>

Session public key used for encrypted onion relay frames.

node_type: OnlineNodeType

Runtime family of this node.

network_id: u32

Network identifier.

storage_redundancy: u16

Storage redundancy required by this DHT protocol mode.

dht_virtual_nodes: u16

Storage virtual-node positions required by this DHT protocol mode.

capabilities: Vec<String>

Optional capability labels.

endpoint_hint: Option<String>

Optional endpoint hint, controlled by node policy/configuration.

started_at_ms: u128

Process start timestamp in milliseconds since Unix epoch.

heartbeat_at_ms: u128

Heartbeat timestamp in milliseconds since Unix epoch.

expires_at_ms: u128

Expiry timestamp in milliseconds since Unix epoch.

version: String

Node software version.

signature: MessageVerification

Signature covering every descriptor field above.

Implementations

impl OnlineNodeDescriptor

pub fn new_signed( body: OnlineNodeDescriptorBody, session_sk: &SessionSk, ) -> Result<Self>

Create and sign a descriptor.

pub const fn dht_protocol_mode(&self) -> DhtProtocolMode

Return this descriptor’s DHT protocol mode.

pub fn matches_dht_protocol(&self, expected: DhtProtocolMode) -> bool

Return whether this descriptor belongs to the local DHT protocol mode.

pub fn verify_signature(&self) -> bool

Verify the descriptor signature and DID/public-key binding.

This does not apply the embedded MessageVerification timestamp/TTL as a liveness rule. Online-node liveness is defined solely by the signed expires_at_ms descriptor field; use Self::is_live_at when expiry should be enforced.

pub fn is_expired_at(&self, now_ms: u128) -> bool

Returns whether this descriptor is expired at now_ms.

pub fn is_live_at(&self, now_ms: u128) -> bool

Returns whether this descriptor has a valid signature and is not expired.

pub fn latest_valid_by_did( descriptors: impl IntoIterator<Item = Self>, now_ms: u128, include_expired: bool, ) -> Vec<Self>

Select the newest valid descriptor per DID.

Trait Implementations

impl Clone for OnlineNodeDescriptor

fn clone(&self) -> OnlineNodeDescriptor

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for OnlineNodeDescriptor

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

Formats the value using the given formatter.

impl Decoder for OnlineNodeDescriptor

fn from_encoded(encoded: &Encoded) -> Result<Self>

Decode Self from an Encoded wrapper.

impl<'de> Deserialize<'de> for OnlineNodeDescriptor

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Encoder for OnlineNodeDescriptor

fn encode(&self) -> Result<Encoded>

Encode this value into an Encoded wrapper.

impl Eq for OnlineNodeDescriptor

impl PartialEq for OnlineNodeDescriptor

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

Equality operator ==.

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

Inequality operator !=.

impl Serialize for OnlineNodeDescriptor

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

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl StructuralPartialEq for OnlineNodeDescriptor