pub struct AgreementPrivateKey(_);
Expand description

A Curve25519 private key used for X25519 key agreement.

https://datatracker.ietf.org/doc/html/rfc7748

Implementations§

source§

impl AgreementPrivateKey

source

pub const KEY_SIZE: usize = 32usize

source

pub fn new() -> Self

Generate a new random AgreementPrivateKey.

source

pub fn new_using(rng: &mut impl RandomNumberGenerator) -> Self

Generate a new random AgreementPrivateKey using the given random number generator.

source

pub const fn from_data(data: [u8; 32]) -> Self

Restore an AgreementPrivateKey from a fixed-size array of bytes.

source

pub fn from_data_ref<T>(data: &T) -> Option<Self>where T: AsRef<[u8]>,

Restore an AgreementPrivateKey from a reference to an array of bytes.

source

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

Get a reference to the fixed-size array of bytes.

source

pub fn from_hex<T>(hex: T) -> Selfwhere T: AsRef<str>,

Restore an AgreementPrivateKey from a hex string.

Panics

Panics if the hex string is invalid or the length is not AgreementPrivateKey::KEY_SIZE * 2.

source

pub fn hex(&self) -> String

Get the hex string representation of the AgreementPrivateKey.

source

pub fn public_key(&self) -> AgreementPublicKey

Get the AgreementPublicKey corresponding to this AgreementPrivateKey.

source

pub fn derive_from_key_material<D>(key_material: D) -> Selfwhere D: AsRef<[u8]>,

Derive an AgreementPrivateKey from the given key material.

source

pub fn shared_key_with(&self, public_key: &AgreementPublicKey) -> SymmetricKey

Derive a shared symmetric key from this AgreementPrivateKey and the given AgreementPublicKey.

Trait Implementations§

source§

impl CBORDecodable for AgreementPrivateKey

source§

fn from_cbor(cbor: &CBOR) -> Result<Self, Error>

Creates an instance of this type from CBOR symbolic representation.
source§

fn from_cbor_data(cbor_data: &[u8]) -> Result<Self, Error>where Self: Sized,

Creates an instance of this type from encoded CBOR binary data.
source§

impl CBOREncodable for AgreementPrivateKey

source§

fn cbor(&self) -> CBOR

Returns the value in CBOR symbolic representation.
source§

fn cbor_data(&self) -> Vec<u8, Global>

Returns the value in CBOR binary representation.
source§

impl CBORTagged for AgreementPrivateKey

source§

const CBOR_TAG: Tag = tags::AGREEMENT_PRIVATE_KEY

The CBOR tag assocated with this type.
source§

impl CBORTaggedDecodable for AgreementPrivateKey

source§

fn from_untagged_cbor(untagged_cbor: &CBOR) -> Result<Self, Error>

Creates an instance of this type by decoding it from untagged CBOR.
source§

fn from_tagged_cbor(cbor: &CBOR) -> Result<Self, Error>where Self: Sized,

Creates an instance of this type by decoding it from tagged CBOR.
source§

fn from_tagged_cbor_data(data: &[u8]) -> Result<Self, Error>where Self: Sized,

Creates an instance of this type by decoding it from binary encoded tagged CBOR.
source§

fn from_untagged_cbor_data(data: &[u8]) -> Result<Self, Error>where Self: Sized,

Creates an instance of this type by decoding it from binary encoded untagged CBOR.
source§

impl CBORTaggedEncodable for AgreementPrivateKey

source§

fn untagged_cbor(&self) -> CBOR

Returns the untagged CBOR encoding of this instance.
source§

fn tagged_cbor(&self) -> CBOR

Returns the tagged CBOR encoding of this instance.
source§

impl Clone for AgreementPrivateKey

source§

fn clone(&self) -> AgreementPrivateKey

Returns a copy of the value. Read more
1.0.0 · source§

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

Performs copy-assignment from source. Read more
source§

impl Debug for AgreementPrivateKey

source§

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

Formats the value using the given formatter. Read more
source§

impl Default for AgreementPrivateKey

source§

fn default() -> Self

Returns the “default value” for a type. Read more
source§

impl<'a> From<&'a AgreementPrivateKey> for &'a [u8; 32]

source§

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

Converts to this type from the input type.
source§

impl From<&AgreementPrivateKey> for AgreementPrivateKey

source§

fn from(key: &AgreementPrivateKey) -> Self

Converts to this type from the input type.
source§

impl From<&AgreementPrivateKey> for Vec<u8>

source§

fn from(key: &AgreementPrivateKey) -> Self

Converts to this type from the input type.
source§

impl From<AgreementPrivateKey> for Vec<u8>

source§

fn from(key: AgreementPrivateKey) -> Self

Converts to this type from the input type.
source§

impl From<Rc<AgreementPrivateKey>> for AgreementPrivateKey

source§

fn from(value: Rc<AgreementPrivateKey>) -> Self

Converts to this type from the input type.
source§

impl Hash for AgreementPrivateKey

source§

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

Feeds this value into the given Hasher. Read more
1.3.0 · source§

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

Feeds a slice of this type into the given Hasher. Read more
source§

impl PartialEq<AgreementPrivateKey> for AgreementPrivateKey

source§

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

This method tests for self and other values to be equal, and is used by ==.
1.0.0 · source§

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

This method tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.
source§

impl URDecodable for AgreementPrivateKey

source§

fn from_ur(ur: &UR) -> Result<Self, Error>where Self: Sized,

source§

fn from_ur_string<T>(ur_string: T) -> Result<Self, Error>where T: Into<String>, Self: Sized,

source§

impl UREncodable for AgreementPrivateKey

source§

fn ur(&self) -> UR

Returns the UR representation of the object.
source§

fn ur_string(&self) -> String

Returns the UR string representation of the object.
source§

impl Eq for AgreementPrivateKey

source§

impl StructuralEq for AgreementPrivateKey

source§

impl StructuralPartialEq for AgreementPrivateKey

source§

impl URCodable for AgreementPrivateKey

Auto Trait Implementations§

Blanket Implementations§

source§

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

source§

fn type_id(&self) -> TypeId

Gets the TypeId of self. Read more
source§

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

source§

fn borrow(&self) -> &T

Immutably borrows from an owned value. Read more
source§

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

source§

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

Mutably borrows from an owned value. Read more
source§

impl<T> From<T> for T

source§

fn from(t: T) -> T

Returns the argument unchanged.

source§

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

source§

fn into(self) -> U

Calls U::from(self).

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

source§

impl<T> Same<T> for T

§

type Output = T

Should always be Self
source§

impl<T> ToOwned for Twhere T: Clone,

§

type Owned = T

The resulting type after obtaining ownership.
source§

fn to_owned(&self) -> T

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

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

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

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

§

type Error = Infallible

The type returned in the event of a conversion error.
source§

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

Performs the conversion.
source§

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

§

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

The type returned in the event of a conversion error.
source§

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

Performs the conversion.
§

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

§

fn vzip(self) -> V