Struct bc_components::Digest

source ·
pub struct Digest(_);
Expand description

A cryptographically secure digest, implemented with SHA-256.

Implementations§

source§

impl Digest

source

pub const DIGEST_SIZE: usize = 32usize

source

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

Create a new digest from data.

source

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

Create a new digest from data.

Returns None if the data is not the correct length.

source

pub fn from_image<T>(image: &T) -> Selfwhere T: AsRef<[u8]>,

Create a new digest from the given image.

The image is hashed with SHA-256.

source

pub fn from_image_parts(image_parts: &[&[u8]]) -> Self

Create a new digest from an array of data items.

The image parts are concatenated and hashed with SHA-256.

source

pub fn from_digests(digests: &[Digest]) -> Self

Create a new digest from an array of Digests.

The image parts are concatenated and hashed with SHA-256.

source

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

Get the data of the digest.

source

pub fn validate<T>(&self, image: &T) -> boolwhere T: AsRef<[u8]>,

Validate the digest against the given image.

The image is hashed with SHA-256 and compared to the digest. Returns true if the digest matches the image.

source

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

Create a new digest from the given hexadecimal string.

Panics

Panics if the string is not exactly 64 hexadecimal digits.

source

pub fn hex(&self) -> String

The data as a hexadecimal string.

source

pub fn short_description(&self) -> String

The first four bytes of the digest as a hexadecimal string.

source

pub fn validate_opt<T>(image: &T, digest: Option<&Digest>) -> boolwhere T: AsRef<[u8]>,

Validate the given data against the digest, if any.

Returns true if the digest is None or if the digest matches the image’s digest. Returns false if the digest does not match the image’s digest.

Trait Implementations§

source§

impl AsRef<[u8]> for Digest

source§

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

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

impl CBORDecodable for Digest

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 Digest

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 Digest

source§

const CBOR_TAG: Tag = tags::DIGEST

The CBOR tag assocated with this type.
source§

impl CBORTaggedDecodable for Digest

source§

fn from_untagged_cbor(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 Digest

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 Digest

source§

fn clone(&self) -> Digest

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 Digest

source§

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

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

impl DigestProvider for Digest

source§

fn digest(&self) -> Cow<'_, Digest>

source§

impl Display for Digest

source§

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

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

impl<'a> From<&'a Digest> for &'a [u8]

source§

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

Converts to this type from the input type.
source§

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

source§

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

Converts to this type from the input type.
source§

impl From<&Digest> for Digest

source§

fn from(digest: &Digest) -> Self

Converts to this type from the input type.
source§

impl From<&Digest> for Vec<u8>

source§

fn from(digest: &Digest) -> Self

Converts to this type from the input type.
source§

impl From<Digest> for Vec<u8>

source§

fn from(digest: Digest) -> Self

Converts to this type from the input type.
source§

impl Hash for Digest

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

source§

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

This method returns an Ordering between self and other. Read more
1.21.0 · source§

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

Compares and returns the maximum of two values. Read more
1.21.0 · source§

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

Compares and returns the minimum of two values. Read more
1.50.0 · source§

fn clamp(self, min: Self, max: Self) -> Selfwhere Self: Sized + PartialOrd<Self>,

Restrict a value to a certain interval. Read more
source§

impl PartialEq<Digest> for Digest

source§

fn eq(&self, other: &Digest) -> 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 PartialOrd<Digest> for Digest

source§

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

This method returns an ordering between self and other values if one exists. Read more
1.0.0 · source§

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

This method tests less than (for self and other) and is used by the < operator. Read more
1.0.0 · source§

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

This method tests less than or equal to (for self and other) and is used by the <= operator. Read more
1.0.0 · source§

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

This method tests greater than (for self and other) and is used by the > operator. Read more
1.0.0 · source§

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

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

impl URDecodable for Digest

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 Digest

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 Digest

source§

impl StructuralEq for Digest

source§

impl StructuralPartialEq for Digest

source§

impl URCodable for Digest

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> ToHex for Twhere T: AsRef<[u8]>,

source§

fn encode_hex<U>(&self) -> Uwhere U: FromIterator<char>,

Encode the hex strict representing self into the result. Lower case letters are used (e.g. f9b4ca)
source§

fn encode_hex_upper<U>(&self) -> Uwhere U: FromIterator<char>,

Encode the hex strict representing self into the result. Upper case letters are used (e.g. F9B4CA)
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> ToString for Twhere T: Display + ?Sized,

source§

default fn to_string(&self) -> String

Converts the given value to a String. 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