Struct TorServiceId

pub struct TorServiceId(/* private fields */);

The service ID for the onion service.

Basically the service ID is the part of the onion address before the “.onion” part. This is an encoding of the onion service’s public key into a string. As such, you can convert from the service ID to the public key, and vice-versa.

Implementations

impl TorServiceId

pub fn generate() -> Self

Generate a new ED25519 public key, and the corresponding TorServiceId

pub fn verifying_key(&self) -> Result<VerifyingKey, TorError>

Retrieve the public ED25519 verifying key from the TorServiceId

pub fn as_str(&self) -> &str

pub fn short_id(&self) -> &str

pub fn onion_hostname(&self) -> String

Generate the corresponding onion hostname (by tacking on the “.onion” part)

Trait Implementations

impl Clone for TorServiceId

fn clone(&self) -> TorServiceId

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for TorServiceId

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for TorServiceId

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Display for TorServiceId

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

Formats the value using the given formatter.

impl Drop for TorServiceId

fn drop(&mut self)

Executes the destructor for this type.

impl From<TorServiceId> for String

Convert the service ID to a String

fn from(id: TorServiceId) -> String

Converts to this type from the input type.

impl From<VerifyingKey> for TorServiceId

Generate the Tor service ID from an ed25519_dalek verifying (public) key From section 6 of https://github.com/torproject/torspec/blob/main/rend-spec-v3.txt

fn from(verifying_key: VerifyingKey) -> Self

Converts to this type from the input type.

impl FromStr for TorServiceId

Parse a String into a service ID. Note that this does a good bit of verification that the service ID is indeed a service ID

type Err = TorError

The associated error which can be returned from parsing.

fn from_str(service_id: &str) -> Result<Self, Self::Err>

Parses a string s to return a value of this type.

impl Hash for TorServiceId

fn hash<__H: Hasher>(&self, state: &mut __H)

Feeds this value into the given Hasher.

fn hash_slice<H>(data: &[Self], state: &mut H)

where H: Hasher, Self: Sized,

Feeds a slice of this type into the given Hasher.

impl Ord for TorServiceId

fn cmp(&self, other: &TorServiceId) -> Ordering

This method returns an Ordering between self and other.

fn max(self, other: Self) -> Self

where Self: Sized,

Compares and returns the maximum of two values.

fn min(self, other: Self) -> Self

where Self: Sized,

Compares and returns the minimum of two values.

fn clamp(self, min: Self, max: Self) -> Self

where Self: Sized,

Restrict a value to a certain interval.

impl PartialEq for TorServiceId

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

Tests for self and other values to be equal, and is used by ==.

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

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl PartialOrd for TorServiceId

fn partial_cmp(&self, other: &TorServiceId) -> Option<Ordering>

This method returns an ordering between self and other values if one exists.

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

Tests less than (for self and other) and is used by the < operator.

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

Tests less than or equal to (for self and other) and is used by the <= operator.

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

Tests greater than (for self and other) and is used by the > operator.

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

Tests greater than or equal to (for self and other) and is used by the >= operator.

impl Serialize for TorServiceId

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

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl Zeroize for TorServiceId

fn zeroize(&mut self)

Zero out this object from memory using Rust intrinsics which ensure the zeroization operation is not “optimized away” by the compiler.

impl Eq for TorServiceId

impl StructuralPartialEq for TorServiceId