tor_hscrypto::pk

Struct HsIdKey

Help

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

Expand description

The identity of a v3 onion service, expanded into a public key. (KP_hs_id)

This is the decoded and validated ed25519 public key that is encoded as a ${base32}.onion address.

This key is not used to sign or validate anything on its own; instead, it is used to derive a HsBlindIdKey.

Note: This is a separate type from HsId because it is about 6x larger. It is an expanded form, used for doing actual cryptography.

Implementations§

impl HsIdKey

pub fn id(&self) -> HsId

Return a representation of this key as an HsId.

(HsId is much smaller, and easier to store.)

impl HsIdKey

pub fn compute_blinded_key( &self, cur_period: TimePeriod, ) -> Result<(HsBlindIdKey, Subcredential), BlindingError>

Derive the blinded key and subcredential for this identity during cur_period.

pub fn compute_subcredential( &self, blinded_key: &HsBlindIdKey, cur_period: TimePeriod, ) -> Subcredential

Given a time period and a blinded public key, compute the subcredential.

Methods from Deref<Target = PublicKey>§

pub fn as_bytes(&self) -> &[u8; 32]

Return a reference to the byte representation of this public key.

pub fn to_bytes(&self) -> [u8; 32]

Return the byte representation of this public key.

pub fn verify(&self, message: &[u8], signature: &Signature) -> Result<(), Error>

Verify a signature using this public key.

See [ed25519_dalek::VerifyingKey::verify] for more information.

Trait Implementations§

impl AsRef<PublicKey> for HsIdKey

fn as_ref(&self) -> &PublicKey

Converts this type into a shared reference of the (usually inferred) input type.

impl Clone for HsIdKey

fn clone(&self) -> HsIdKey

Returns a duplicate of the value. Read more

1.0.0 · Source§

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

Performs copy-assignment from source. Read more

impl Debug for HsIdKey

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

Formats the value using the given formatter. Read more

impl Deref for HsIdKey

type Target = PublicKey

The resulting type after dereferencing.

fn deref(&self) -> &Self::Target

Dereferences the value.

impl From<&HsIdKeypair> for HsIdKey

fn from(value: &HsIdKeypair) -> Self

Converts to this type from the input type.

impl From<HsIdKey> for HsId

fn from(value: HsIdKey) -> Self

Converts to this type from the input type.

impl From<HsIdKey> for PublicKey

fn from(value: HsIdKey) -> Self

Converts to this type from the input type.

impl From<HsIdKeypair> for HsIdKey

fn from(value: HsIdKeypair) -> Self

Converts to this type from the input type.

impl From<PublicKey> for HsIdKey

fn from(value: PublicKey) -> Self

Converts to this type from the input type.

impl ToEncodableKey for HsIdKey

type Key = PublicKey

The key type this can be converted to/from.

type KeyPair = HsIdKeypair

The KeyPair (secret+public) of which this key is a subset. For secret keys, this type is Self. For public keys, this type is the corresponding (secret) keypair. Read more

fn to_encodable_key(self) -> Self::Key

Convert this key to a type that implements EncodableItem.

fn from_encodable_key(key: Self::Key) -> Self

Convert an EncodableItem to another key type.

impl TryFrom<HsId> for HsIdKey

type Error = Error

The type returned in the event of a conversion error.

fn try_from(value: HsId) -> Result<Self, Self::Error>

Performs the conversion.

Auto Trait Implementations§

impl Freeze for HsIdKey

impl RefUnwindSafe for HsIdKey

impl Send for HsIdKey

impl Sync for HsIdKey

impl Unpin for HsIdKey

impl UnwindSafe for HsIdKey

Blanket Implementations§

impl<T> Any for T
where T: 'static + ?Sized,

fn type_id(&self) -> TypeId

Gets the TypeId of self. Read more

impl<'a, T, E> AsTaggedExplicit<'a, E> for T
where T: 'a,

fn explicit(self, class: Class, tag: u32) -> TaggedParser<'a, Explicit, Self, E>

impl<'a, T, E> AsTaggedImplicit<'a, E> for T
where T: 'a,

fn implicit( self, class: Class, constructed: bool, tag: u32, ) -> TaggedParser<'a, Implicit, Self, E>

impl<T> Borrow<T> for T
where T: ?Sized,

fn borrow(&self) -> &T

Immutably borrows from an owned value. Read more

impl<T> BorrowMut<T> for T
where T: ?Sized,

fn borrow_mut(&mut self) -> &mut T

Mutably borrows from an owned value. Read more

impl<T> CloneToUninit for T
where T: Clone,

unsafe fn clone_to_uninit(&self, dest: *mut u8)

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

Performs copy-assignment from self to dest. Read more

impl<T> Downcast for T
where T: Any,

fn into_any(self: Box<T>) -> Box<dyn Any>

Converts Box<dyn Trait> (where Trait: Downcast) to Box<dyn Any>, which can then be downcast into Box<dyn ConcreteType> where ConcreteType implements Trait.

fn into_any_rc(self: Rc<T>) -> Rc<dyn Any>

Converts Rc<Trait> (where Trait: Downcast) to Rc<Any>, which can then be further downcast into Rc<ConcreteType> where ConcreteType implements Trait.

fn as_any(&self) -> &(dyn Any + 'static)

Converts &Trait (where Trait: Downcast) to &Any. This is needed since Rust cannot generate &Any’s vtable from &Trait’s.

fn as_any_mut(&mut self) -> &mut (dyn Any + 'static)

Converts &mut Trait (where Trait: Downcast) to &Any. This is needed since Rust cannot generate &mut Any’s vtable from &mut Trait’s.

impl<T> DowncastSend for T
where T: Any + Send,

fn into_any_send(self: Box<T>) -> Box<dyn Any + Send>

Converts Box<Trait> (where Trait: DowncastSend) to Box<dyn Any + Send>, which can then be downcast into Box<ConcreteType> where ConcreteType implements Trait.

impl<T> DowncastSync for T
where T: Any + Send + Sync,

fn into_any_sync(self: Box<T>) -> Box<dyn Any + Send + Sync>

Converts Box<Trait> (where Trait: DowncastSync) to Box<dyn Any + Send + Sync>, which can then be downcast into Box<ConcreteType> where ConcreteType implements Trait.

fn into_any_arc(self: Arc<T>) -> Arc<dyn Any + Send + Sync>

Converts Arc<Trait> (where Trait: DowncastSync) to Arc<Any>, which can then be downcast into Arc<ConcreteType> where ConcreteType implements Trait.

impl<T> DynClone for T
where T: Clone,

fn __clone_box(&self, _: Private) -> *mut ()

impl<T> From<T> for T

fn from(t: T) -> T

Returns the argument unchanged.

impl<T> Instrument for T

fn instrument(self, span: Span) -> Instrumented<Self>

Instruments this type with the provided [Span], returning an Instrumented wrapper. Read more

fn in_current_span(self) -> Instrumented<Self>

Instruments this type with the current Span, returning an Instrumented wrapper. Read more

impl<T, U> Into<U> for T
where U: From<T>,

fn into(self) -> U

Calls U::from(self).

That is, this conversion is whatever the implementation of From<T> for U chooses to do.

impl<T> IntoEither for T

fn into_either(self, into_left: bool) -> Either<Self, Self>

Converts self into a Left variant of Either<Self, Self> if into_left is true. Converts self into a Right variant of Either<Self, Self> otherwise. Read more

fn into_either_with<F>(self, into_left: F) -> Either<Self, Self>
where F: FnOnce(&Self) -> bool,

Converts self into a Left variant of Either<Self, Self> if into_left(&self) returns true. Converts self into a Right variant of Either<Self, Self> otherwise. Read more

impl<P, T> Receiver for P
where P: Deref<Target = T> + ?Sized, T: ?Sized,

type Target = T

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

The target type on which the method may be called.

impl<T> Same for T

type Output = T

Should always be Self

impl<T> ToOwned for T
where T: Clone,

type Owned = T

The resulting type after obtaining ownership.

fn to_owned(&self) -> T

Creates owned data from borrowed data, usually by cloning. Read more

fn clone_into(&self, target: &mut T)

Uses borrowed data to replace owned data, usually by cloning. Read more

impl<T, U> TryFrom<U> for T
where U: Into<T>,

type Error = Infallible

The type returned in the event of a conversion error.

fn try_from(value: U) -> Result<T, <T as TryFrom<U>>::Error>

Performs the conversion.

impl<T, U> TryInto<U> for T
where U: TryFrom<T>,

type Error = <U as TryFrom<T>>::Error

The type returned in the event of a conversion error.

fn try_into(self) -> Result<U, <U as TryFrom<T>>::Error>

Performs the conversion.

impl<V, T> VZip<V> for T
where V: MultiLane<T>,

fn vzip(self) -> V

impl<T> WithSubscriber for T

fn with_subscriber<S>(self, subscriber: S) -> WithDispatch<Self>
where S: Into<Dispatch>,

Attaches the provided Subscriber to this type, returning a [WithDispatch] wrapper. Read more

fn with_current_subscriber(self) -> WithDispatch<Self>

Attaches the current default Subscriber to this type, returning a [WithDispatch] wrapper. Read more

impl<T> ErasedDestructor for T
where T: 'static,