Enum RelayIdRef 

#[non_exhaustive]
pub enum RelayIdRef<'a> {
    Ed25519(&'a Ed25519Identity),
    Rsa(&'a RsaIdentity),
}

A reference to a single relay identity.

Variants (Non-exhaustive)

Non-exhaustive enums could have additional variants added in future. Therefore, when matching against variants of non-exhaustive enums, an extra wildcard arm must be added to account for any future variants.

Ed25519(&'a Ed25519Identity)

An Ed25519 identity.

Every relay (currently) has one of these identities. It is the same as the encoding of the relay’s public Ed25519 identity key.

Rsa(&'a RsaIdentity)

An RSA identity.

Every relay (currently) has one of these identities. It is computed as a SHA-1 digest of the DER encoding of the relay’s public RSA 1024-bit identity key. Because of short key length, this type of identity should not be considered secure on its own.

Implementations

impl<'a> RelayIdRef<'a>

pub fn to_owned(&self) -> RelayId

Copy this reference into a new RelayId object.

pub fn id_type(&self) -> RelayIdType

Return the type of this relay identity.

pub fn as_bytes(&self) -> &'a [u8]

Return a byte-slice corresponding to the contents of this identity.

pub(crate) fn unwrap_ed25519(self) -> &'a Ed25519Identity

Extract the Ed25519Identity from a RelayIdRef that is known to hold one.

Panics

Panics if this is not an $vname identity.

pub(crate) fn unwrap_rsa(self) -> &'a RsaIdentity

Extract the RsaIdentity from a RelayIdRef that is known to hold one.

Panics

Panics if this is not an $vname identity.

Trait Implementations

impl<'a> Clone for RelayIdRef<'a>

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl<'a> Copy for RelayIdRef<'a>

impl<'a> Debug for RelayIdRef<'a>

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

Formats the value using the given formatter.

impl<'a> Display for RelayIdRef<'a>

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

Formats the value using the given formatter.

impl<'a> Eq for RelayIdRef<'a>

impl<'a> From<&'a Ed25519Identity> for RelayIdRef<'a>

fn from(value: &'a Ed25519Identity) -> Self

Converts to this type from the input type.

impl<'a> From<&'a RelayId> for RelayIdRef<'a>

fn from(ident: &'a RelayId) -> Self

Converts to this type from the input type.

impl<'a> From<&'a RsaIdentity> for RelayIdRef<'a>

fn from(value: &'a RsaIdentity) -> Self

Converts to this type from the input type.

impl<'a> Hash for RelayIdRef<'a>

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<'a> Ord for RelayIdRef<'a>

fn cmp(&self, other: &Self) -> 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.

fn clamp_to<R>(self, range: R) -> Self

where Self: Sized, R: ClampBounds<Self>,

🔬This is a nightly-only experimental API. (clamp_to)

Restrict a value to a certain range.

impl<'a> PartialEq for RelayIdRef<'a>

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

Equality operator ==.

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

Inequality operator !=.

impl<'a> PartialEq<Ed25519Identity> for RelayIdRef<'a>

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

Equality operator ==.

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

Inequality operator !=.

impl<'a> PartialEq<RsaIdentity> for RelayIdRef<'a>

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

Equality operator ==.

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

Inequality operator !=.

impl<'a> PartialOrd for RelayIdRef<'a>

fn partial_cmp(&self, other: &Self) -> 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<'a> Redactable for RelayIdRef<'a>

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

As Display::fmt, but produce a redacted representation.

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

As Debug::fmt, but produce a redacted representation.

fn redacted(&self) -> Redacted<&Self>

Return a smart pointer that will display or debug this object as its redacted form.

fn maybe_redacted(&self, redact: bool) -> MaybeRedacted<&Self>

Return a smart pointer that redacts this object if redact is true.

impl<'a> Serialize for RelayIdRef<'a>

fn serialize<S>(&self, serializer: S) -> Result<S::Ok, S::Error>

where S: Serializer,

Serialize this value into the given Serde serializer.

impl<'a> StructuralPartialEq for RelayIdRef<'a>

impl<'a> TryFrom<RelayIdRef<'a>> for &'a Ed25519Identity

type Error = TryIntoError<RelayIdRef<'a>>

The type returned in the event of a conversion error.

fn try_from(value: RelayIdRef<'a>) -> Result<Self, TryIntoError<RelayIdRef<'a>>>

Performs the conversion.

impl<'a> TryFrom<RelayIdRef<'a>> for &'a RsaIdentity

type Error = TryIntoError<RelayIdRef<'a>>

The type returned in the event of a conversion error.

fn try_from(value: RelayIdRef<'a>) -> Result<Self, TryIntoError<RelayIdRef<'a>>>

Performs the conversion.