Struct holochain::core::HoloHashed

pub struct HoloHashed<C>where
    C: HashableContent,{
    pub content: C,
    pub hash: HoloHash<<C as HashableContent>::HashType>,
}

Represents some piece of content along with its hash representation, so that hashes need not be calculated multiple times. Provides an easy constructor which consumes the content.

Fields

content: C

The content which is hashed of type C.

hash: HoloHash<<C as HashableContent>::HashType>

The hash of the content C.

Implementations

impl<C> HoloHashed<C>where C: HashableContent,

pub fn with_pre_hashed( content: C, hash: HoloHash<<C as HashableContent>::HashType> ) -> HoloHashed<C>

Combine content with its precalculated hash

pub fn as_content(&self) -> &C

Accessor for content

pub fn as_content_mut(&mut self) -> &mut C

Mutable accessor for content. Only useful for heavily mocked/fixturated data in testing. Guaranteed the hash will no longer match the content if mutated.

pub fn into_content(self) -> C

Convert to content

pub fn into_inner(self) -> (C, HoloHash<<C as HashableContent>::HashType>)

Deconstruct as a tuple

impl<T, C> HoloHashed<C>where T: HashTypeSync, C: HashableContent<HashType = T>,

pub fn from_content_sync(content: C) -> HoloHashed<C>

Compute the hash of this content and store it alongside

pub fn verify_hash_sync(&self) -> Result<(), HoloHash<T>>

Verify that the cached hash matches the content. Important to run this after e.g. deserialization.

impl<T, C> HoloHashed<C>where T: HashTypeAsync, C: HashableContent<HashType = T>,

pub async fn from_content(content: C) -> impl Future<Output = HoloHashed<C>>

Compute the hash of this content and store it alongside

pub async fn verify_hash(&self) -> impl Future<Output = Result<(), HoloHash<T>>>

Verify that the cached hash matches the content. Important to run this after e.g. deserialization.

Trait Implementations

impl<'a, C> Arbitrary<'a> for HoloHashed<C>where C: HashableContent + Arbitrary<'a>, <C as HashableContent>::HashType: PrimitiveHashType,

fn arbitrary(u: &mut Unstructured<'a>) -> Result<HoloHashed<C>, Error>

Generate an arbitrary value of Self from the given unstructured data.

fn arbitrary_take_rest(u: Unstructured<'a>) -> Result<Self, Error>

Generate an arbitrary value of Self from the entirety of the given unstructured data.

fn size_hint(depth: usize) -> (usize, Option<usize>)

Get a size hint for how many bytes out of an Unstructured this type needs to construct itself.

impl<C> AsRef<C> for HoloHashed<C>where C: HashableContent,

fn as_ref(&self) -> &C

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

impl<C> Borrow<C> for HoloHashed<C>where C: HashableContent,

fn borrow(&self) -> &C

Immutably borrows from an owned value.

impl ChainItem for HoloHashed<Action>

type Hash = HoloHash<Action>

The type used to represent a hash of this item

fn seq(&self) -> u32

The sequence in the chain

fn get_hash(&self) -> &<HoloHashed<Action> as ChainItem>::Hash

The hash of this item

fn prev_hash(&self) -> Option<&<HoloHashed<Action> as ChainItem>::Hash>

The hash of the previous item

fn to_display(&self) -> String

A display representation of the item

impl<C> Clone for HoloHashed<C>where C: HashableContent + Clone,

fn clone(&self) -> HoloHashed<C>

Returns a copy of the value.

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

Performs copy-assignment from source.

impl<C> Debug for HoloHashed<C>where C: Debug + HashableContent,

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

Formats the value using the given formatter.

impl<C> Deref for HoloHashed<C>where C: HashableContent,

type Target = C

The resulting type after dereferencing.

fn deref(&self) -> &<HoloHashed<C> as Deref>::Target

Dereferences the value.

impl<'de, C> Deserialize<'de> for HoloHashed<C>where C: HashableContent + Deserialize<'de>,

fn deserialize<__D>( __deserializer: __D ) -> Result<HoloHashed<C>, <__D as Deserializer<'de>>::Error>where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl From<HoloHashed<Action>> for Action

fn from(action_hashed: HoloHashed<Action>) -> Action

Converts to this type from the input type.

impl From<HoloHashed<Action>> for TimedActionHash

fn from(h: HoloHashed<Action>) -> TimedActionHash

Converts to this type from the input type.

impl<C> From<HoloHashed<C>> for (C, HoloHash<<C as HashableContent>::HashType>)where C: HashableContent,

fn from(g: HoloHashed<C>) -> (C, HoloHash<<C as HashableContent>::HashType>)

Converts to this type from the input type.

impl From<HoloHashed<Entry>> for Entry

fn from(entry_hashed: HoloHashed<Entry>) -> Entry

Converts to this type from the input type.

impl<T> From<SignedHashed<T>> for HoloHashed<T>where T: HashableContent,

fn from(sh: SignedHashed<T>) -> HoloHashed<T>

Converts to this type from the input type.

impl<C> HasHash<<C as HashableContent>::HashType> for HoloHashed<C>where C: HashableContent,

fn as_hash(&self) -> &HoloHash<<C as HashableContent>::HashType>

Get the hash by reference

fn into_hash(self) -> HoloHash<<C as HashableContent>::HashType>

Convert to the owned hash

impl<C> Hash for HoloHashed<C>where C: HashableContent,

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

Feeds this value into the given Hasher.

fn hash_slice<H>(data: &[Self], state: &mut H)where H: Hasher, Self: Sized,

Feeds a slice of this type into the given Hasher.

impl<C> HashableContent for HoloHashed<C>where C: HashableContent,

type HashType = <C as HashableContent>::HashType

The HashType which this content will be hashed to

fn hash_type(&self) -> <HoloHashed<C> as HashableContent>::HashType

The HashType which this content will be hashed to

fn hashable_content(&self) -> HashableContentBytes

Return a subset of the content, either as SerializedBytes “content”, which will be used to compute the hash, or as an already precomputed hash which will be used directly

impl<C> Ord for HoloHashed<C>where C: HashableContent + Ord,

fn cmp(&self, other: &HoloHashed<C>) -> Ordering

This method returns an Ordering between self and other.

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

Compares and returns the maximum of two values.

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

Compares and returns the minimum of two values.

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

Restrict a value to a certain interval.

impl<C> PartialEq<HoloHashed<C>> for HoloHashed<C>where C: HashableContent,

fn eq(&self, other: &HoloHashed<C>) -> 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 !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl<C> PartialOrd<HoloHashed<C>> for HoloHashed<C>where C: HashableContent + PartialOrd<C>,

fn partial_cmp(&self, other: &HoloHashed<C>) -> 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<C> Serialize for HoloHashed<C>where C: HashableContent + Serialize,

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<C> Eq for HoloHashed<C>where C: HashableContent,