SecretKey

Struct SecretKey 

Source
pub struct SecretKey<'a>(/* private fields */);
Expand description

A Classic McEliece secret key.

Should be kept on the device where it’s generated. Used to decapsulate the SharedSecret from the Ciphertext received from the encapsulator.

Implementations§

Source§

impl SecretKey<'_>

Source

pub fn to_owned(&self) -> SecretKey<'static>

Available on crate feature alloc only.

Copies the key to the heap and makes it 'static.

Source

pub fn as_array(&self) -> &[u8; 6492]

Returns the secret key as an array of bytes.

Please note that depending on your threat model, moving the data out of the SecretKey can be bad for security. The SecretKey type is designed to keep the backing data in a single location in memory and zeroing it out when it goes out of scope.

Trait Implementations§

Source§

impl AsRef<[u8]> for SecretKey<'_>

Source§

fn as_ref(&self) -> &[u8]

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

impl Debug for SecretKey<'_>

Source§

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

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

impl<'sk> Decapsulator<Ciphertext> for SecretKey<'sk>

Available on crate feature kem only.
Source§

fn try_decap( &self, ciphertext: &Ciphertext, ) -> Result<SharedSecret<Ciphertext>, Error>

Attempt to decapsulate the given encapsulated key. Returns the shared secret on success, or an error if something went wrong.
Source§

impl Drop for SecretKey<'_>

Source§

fn drop(&mut self)

Executes the destructor for this type. Read more
Source§

impl<'a> From<&'a mut [u8; 6492]> for SecretKey<'a>

Source§

fn from(data: &'a mut [u8; 6492]) -> Self

Represents a mutable byte array of the correct size as a SecretKey. Please note that the array will be zeroed on drop.

Source§

impl From<Box<[u8; 6492]>> for SecretKey<'static>

Available on crate feature alloc only.
Source§

fn from(data: Box<[u8; 6492]>) -> Self

Converts to this type from the input type.
Source§

impl Zeroize for SecretKey<'_>

Source§

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.
Source§

impl ZeroizeOnDrop for SecretKey<'_>

Auto Trait Implementations§

§

impl<'a> Freeze for SecretKey<'a>

§

impl<'a> RefUnwindSafe for SecretKey<'a>

§

impl<'a> Send for SecretKey<'a>

§

impl<'a> Sync for SecretKey<'a>

§

impl<'a> Unpin for SecretKey<'a>

§

impl<'a> !UnwindSafe for SecretKey<'a>

Blanket Implementations§

Source§

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

Source§

fn type_id(&self) -> TypeId

Gets the TypeId of self. Read more
Source§

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

Source§

fn borrow(&self) -> &T

Immutably borrows from an owned value. Read more
Source§

impl<T> BorrowMut<T> for T
where 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 T
where 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 for T

Source§

type Output = T

Should always be Self
Source§

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

Source§

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 T
where U: TryFrom<T>,

Source§

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.