Struct hdk::prelude::Signature

pub struct Signature(pub [u8; 64]);

The raw bytes of a signature. The equality is not different, it’s just constant time, so we can derive a hash. For an actually secure thing we wouldn’t want to just assume a safe default hashing But that is not what clippy is complaining about here.

Tuple Fields

0: [u8; 64]

Trait Implementations

impl AsRef<[u8]> for Signature

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

Performs the conversion.

impl AsRef<Signature> for VerifySignature

pub fn as_ref(&self) -> &Signature

Performs the conversion.

impl Clone for Signature

pub fn clone(&self) -> Signature

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for Signature

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.

Note that when using this crate with feature “subtle-encoding”, a hex representation will be used.

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

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for Signature

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

Deserialize this value from the given Serde deserializer.

impl From<[u8; 64]> for Signature

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; 64]) -> Signature

Performs the conversion.

impl Hash for Signature

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

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 Ord for Signature

pub fn cmp(&self, other: &Signature) -> Ordering

This method returns an Ordering between self and other.

fn max(self, other: Self) -> Self

Compares and returns the maximum of two values.

fn min(self, other: Self) -> Self

Compares and returns the minimum of two values.

fn clamp(self, min: Self, max: Self) -> Self

Restrict a value to a certain interval.

impl PartialEq<Signature> for Signature

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: &Signature) -> bool

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

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

This method tests for !=.

impl PartialOrd<Signature> for Signature

pub fn partial_cmp(&self, other: &Signature) -> Option<Ordering>

This method returns an ordering between self and other values if one exists.

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

This method tests less than (for self and other) and is used by the < operator.

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

This method tests less than or equal to (for self and other) and is used by the <= operator.

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

This method tests greater than (for self and other) and is used by the > operator.

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

This method tests greater than or equal to (for self and other) and is used by the >= operator.

impl Serialize for Signature

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 Signature

type Error = SecurePrimitiveError

The type returned in the event of a conversion error.

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

Performs the conversion.

impl TryFrom<Vec<u8, Global>> for Signature

type Error = SecurePrimitiveError

The type returned in the event of a conversion error.

pub fn try_from(
    v: Vec<u8, Global>
) -> Result<Signature, <Signature as TryFrom<Vec<u8, Global>>>::Error>

Performs the conversion.

impl Eq for Signature