Struct OnionExitDescriptor 

pub struct OnionExitDescriptor {

    pub schema_version: u16,
    pub did: Did,
    pub public_key: VerificationPublicKey,
    pub session_public_key: PublicKey<33>,
    pub node_type: OnlineNodeType,
    pub network_id: u32,
    pub service: OnionExitService,
    pub policy: OnionExitPolicy,
    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 onion exits.

Fields

schema_version: u16

Onion-exit descriptor wire schema version covered by the descriptor signature.

did: Did

DID of the exit node/account.

public_key: VerificationPublicKey

Account public key corresponding to did.

session_public_key: PublicKey<33>

Session public key used for encrypted onion exit frames.

node_type: OnlineNodeType

Runtime family of this exit node.

network_id: u32

Network identifier.

service: OnionExitService

Service this descriptor is willing to expose.

policy: OnionExitPolicy

Signed exit policy.

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 OnionExitDescriptor

pub fn new_signed( body: OnionExitDescriptorBody, session_sk: &SessionSk, ) -> CoreResult<Self>

Create and sign an onion-exit descriptor.

pub const fn has_supported_schema(&self) -> bool

Return whether this descriptor uses the local registry wire schema.

pub const fn matches_network(&self, network_id: u32) -> bool

Return whether this descriptor belongs to network_id.

pub fn advertises_service_name(&self, service: &str) -> bool

Return whether this descriptor advertises the requested service name.

pub fn offers_service(&self, service: &str) -> bool

Return whether this descriptor offers service.

pub fn offers_service_transport( &self, service: &str, transport: OnionExitTransport, ) -> bool

Return whether this descriptor offers service over transport.

pub fn verify_signature(&self) -> bool

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

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_service_did( descriptors: impl IntoIterator<Item = Self>, now_ms: u128, include_expired: bool, ) -> Vec<Self>

Select the newest valid onion-exit descriptor per (DID, service).

Invariant: an exit may publish independent TCP and HTTPS registrations under the same DID. Preservation: heartbeat ordering is compared only inside each (DID, service name, transport) key.

Trait Implementations

impl Clone for OnionExitDescriptor

fn clone(&self) -> OnionExitDescriptor

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for OnionExitDescriptor

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

Formats the value using the given formatter.

impl Decoder for OnionExitDescriptor

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

Decode Self from an Encoded wrapper.

impl<'de> Deserialize<'de> for OnionExitDescriptor

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Encoder for OnionExitDescriptor

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

Encode this value into an Encoded wrapper.

impl Eq for OnionExitDescriptor

impl PartialEq for OnionExitDescriptor

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

Equality operator ==.

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

Inequality operator !=.

impl Serialize for OnionExitDescriptor

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 OnionExitDescriptor