Struct hdk::prelude::XSalsa20Poly1305KeyRef

pub struct XSalsa20Poly1305KeyRef(_);

Trait Implementations

impl AsRef<[u8]> for XSalsa20Poly1305KeyRef

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

Performs the conversion.

impl Clone for XSalsa20Poly1305KeyRef

pub fn clone(&self) -> XSalsa20Poly1305KeyRef

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Copy for XSalsa20Poly1305KeyRef

impl Debug for XSalsa20Poly1305KeyRef

The only meaningful debug information for a cryptograhpic secret is the literal bytes. Also, encodings like base64 are not constant time so debugging could open some weird side channel issue trying to be ‘human friendly’. It seems better to never try to encode secrets.

@todo maybe we want something like HIDDEN by default and putting the actual bytes behind a feature flag?

See https://docs.rs/subtle-encoding/0.5.1/subtle_encoding/

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for XSalsa20Poly1305KeyRef

pub fn deserialize<D>(
    deserializer: D
) -> Result<XSalsa20Poly1305KeyRef, <D as Deserializer<'de>>::Error> where
    D: Deserializer<'de>, 

Deserialize this value from the given Serde deserializer.

impl Eq for XSalsa20Poly1305KeyRef

impl From<[u8; 32]> for XSalsa20Poly1305KeyRef

Trivial new type derivation. Secrets should have private interiors and be constructed directly from fixed length arrays of known length.

pub fn from(b: [u8; 32]) -> XSalsa20Poly1305KeyRef

Performs the conversion.

impl PartialEq<XSalsa20Poly1305KeyRef> for XSalsa20Poly1305KeyRef

Constant time equality check. This mitigates timing attacks where a remote agent can reverse engineer data by measuring tiny changes in latency associated with optimised equality checks. More matching bytes = more latency = vulnerability. This type of attack has been successfully demonstrated over a network despite varied latencies.

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

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

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

This method tests for !=.

impl Serialize for XSalsa20Poly1305KeyRef

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

Serialize this value into the given Serde serializer.

impl<'_> TryFrom<&'_ [u8]> for XSalsa20Poly1305KeyRef

type Error = SecurePrimitiveError

The type returned in the event of a conversion error.

pub fn try_from(
    slice: &[u8]
) -> Result<XSalsa20Poly1305KeyRef, <XSalsa20Poly1305KeyRef as TryFrom<&'_ [u8]>>::Error>

Performs the conversion.

impl<'_> TryFrom<&'_ XSalsa20Poly1305KeyRef> for SerializedBytes

type Error = SerializedBytesError

The type returned in the event of a conversion error.

pub fn try_from(
    t: &XSalsa20Poly1305KeyRef
) -> Result<SerializedBytes, SerializedBytesError>

Performs the conversion.

impl TryFrom<SerializedBytes> for XSalsa20Poly1305KeyRef

type Error = SerializedBytesError

The type returned in the event of a conversion error.

pub fn try_from(
    sb: SerializedBytes
) -> Result<XSalsa20Poly1305KeyRef, SerializedBytesError>

Performs the conversion.

impl TryFrom<XSalsa20Poly1305KeyRef> for SerializedBytes

type Error = SerializedBytesError

The type returned in the event of a conversion error.

pub fn try_from(
    t: XSalsa20Poly1305KeyRef
) -> Result<SerializedBytes, SerializedBytesError>

Performs the conversion.