Struct keynesis::key::ed25519::SecretKey

pub struct SecretKey(_);

Ed25519 Secret Key

Mind it though, losing this key means losing control over your identity

Implementations

impl SecretKey

pub const SIZE: usize

the size of the Secret key in bytes

pub fn new<Rng>(rng: &mut Rng) -> Self where
    Rng: RngCore + CryptoRng, 

generate a new SecretKey with the given random number generator

pub fn exchange(&self, public_key: &PublicKey) -> SharedSecret

generate a shared secret between the owner of the given public key and ourselves.

pub fn public_key(&self) -> PublicKey

get the PublicKey associated to this key

Unlike the SecretKey, the PublicKey can be safely publicly shared. The key can then be used to verify any Signature generated with this SecretKey and the original message.

pub fn sign<T: AsRef<[u8]>>(&self, msg: T) -> Signature

create a Signature for the given message with this SecretKey.

The Signature can then be verified against the associated PublicKey and the original message.

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

get a reference to the inner Seed bytes

Security Consideration

be mindful that leaking the content of the internal signing key may result in losing the ultimate control of the signing key

pub fn leak_to_hex(&self) -> String

Trait Implementations

impl Clone for SecretKey

fn clone(&self) -> SecretKey

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for SecretKey

conveniently provide an incomplete implementation of Debug for the SecretKey.

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

Formats the value using the given formatter.

impl Drop for SecretKey

custom implementation of Drop so we can have more certainty that the secret key raw data will be scrubbed (zeroed) before releasing the memory

fn drop(&mut self)

Executes the destructor for this type.

impl Eq for SecretKey

impl From<[u8; 32]> for SecretKey

fn from(bytes: [u8; 32]) -> Self

Performs the conversion.

impl FromStr for SecretKey

type Err = FromHexError

The associated error which can be returned from parsing.

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

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

impl Hash for SecretKey

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, 

Feeds a slice of this type into the given Hasher.

impl PartialEq<SecretKey> for SecretKey

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

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

#[must_use]fn ne(&self, other: &Rhs) -> bool

This method tests for !=.

impl<'a> TryFrom<&'a [u8]> for SecretKey

type Error = SecretKeyError

The type returned in the event of a conversion error.

fn try_from(value: &'a [u8]) -> Result<Self, Self::Error>

Performs the conversion.