Struct hdk::hash_path::path::PathEntry

pub struct PathEntry(_);

A PathEntry is the hash of a Path . This is what is committed and shared on the DHT to build links off as their base and target. If we committed the Path directly then the size of each node entry content would be the size of all the components of the path. Given that ensure populates all the ancestor nodes committing [ A, B, C ] would create entries with content [ A ], [ A, B ], [ A, B, C ]. For deep paths, or paths with a large component (in bytes) at any node, this would create a lot of redundant data in every descendent entry. Instead, we commit a PathEntry so each node is constant size, just the hash of the full Path up to that point. This means that committing PathEntry instead of Path for [A, B, C] results in entries with content [ HashA ], [ HashAB ], [ HashABC ]. Note that if A + B + C is much less than the size of a holochain hash (~40 bytes) then this approach is worse than simply committing the Path but in practise this is often not the case, and PathEntry becomes a more scalable generalised solution.

Implementations

impl PathEntry

pub fn new(entry_hash: EntryHash) -> Self

Trait Implementations

impl Clone for PathEntry

fn clone(&self) -> PathEntry

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for PathEntry

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for PathEntry

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

Deserialize this value from the given Serde deserializer.

impl EntryDefRegistration for PathEntry

fn entry_def() -> EntryDef

fn entry_def_id() -> EntryDefId

fn entry_visibility() -> EntryVisibility

fn crdt_type() -> CrdtType

fn required_validations() -> RequiredValidations

impl From<&'_ PathEntry> for EntryDef where
    PathEntry: EntryDefRegistration, 

fn from(_: &PathEntry) -> Self

Converts to this type from the input type.

impl From<&'_ PathEntry> for EntryDefId where
    PathEntry: EntryDefRegistration, 

fn from(_: &PathEntry) -> Self

Converts to this type from the input type.

impl From<&'_ PathEntry> for EntryVisibility where
    PathEntry: EntryDefRegistration, 

fn from(_: &PathEntry) -> Self

Converts to this type from the input type.

impl From<&'_ PathEntry> for CrdtType where
    PathEntry: EntryDefRegistration, 

fn from(_: &PathEntry) -> Self

Converts to this type from the input type.

impl From<&'_ PathEntry> for RequiredValidations where
    PathEntry: EntryDefRegistration, 

fn from(_: &PathEntry) -> Self

Converts to this type from the input type.

impl From<PathEntry> for EntryDef where
    PathEntry: EntryDefRegistration, 

fn from(_: PathEntry) -> Self

Converts to this type from the input type.

impl From<PathEntry> for EntryDefId where
    PathEntry: EntryDefRegistration, 

fn from(_: PathEntry) -> Self

Converts to this type from the input type.

impl From<PathEntry> for EntryVisibility where
    PathEntry: EntryDefRegistration, 

fn from(_: PathEntry) -> Self

Converts to this type from the input type.

impl From<PathEntry> for CrdtType where
    PathEntry: EntryDefRegistration, 

fn from(_: PathEntry) -> Self

Converts to this type from the input type.

impl From<PathEntry> for RequiredValidations where
    PathEntry: EntryDefRegistration, 

fn from(_: PathEntry) -> Self

Converts to this type from the input type.

impl PartialEq<PathEntry> for PathEntry

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

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

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

This method tests for !=.

impl Serialize for PathEntry

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error> where
    __S: Serializer, 

Serialize this value into the given Serde serializer.

impl TryFrom<&'_ Element> for PathEntry

type Error = WasmError

The type returned in the event of a conversion error.

fn try_from(element: &Element) -> Result<Self, Self::Error>

Performs the conversion.

impl TryFrom<&'_ Entry> for PathEntry

type Error = WasmError

The type returned in the event of a conversion error.

fn try_from(entry: &Entry) -> Result<Self, Self::Error>

Performs the conversion.

impl TryFrom<&'_ PathEntry> for SerializedBytes

type Error = SerializedBytesError

The type returned in the event of a conversion error.

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

Performs the conversion.

impl TryFrom<&'_ PathEntry> for AppEntryBytes

type Error = WasmError

The type returned in the event of a conversion error.

fn try_from(t: &PathEntry) -> Result<Self, Self::Error>

Performs the conversion.

impl TryFrom<&'_ PathEntry> for Entry

type Error = WasmError

The type returned in the event of a conversion error.

fn try_from(t: &PathEntry) -> Result<Self, Self::Error>

Performs the conversion.

impl TryFrom<&'_ PathEntry> for CreateInput where
    PathEntry: EntryDefRegistration, 

type Error = WasmError

The type returned in the event of a conversion error.

fn try_from(t: &PathEntry) -> Result<Self, Self::Error>

Performs the conversion.

impl TryFrom<Element> for PathEntry

type Error = WasmError

The type returned in the event of a conversion error.

fn try_from(element: Element) -> Result<Self, Self::Error>

Performs the conversion.

impl TryFrom<Entry> for PathEntry

type Error = WasmError

The type returned in the event of a conversion error.

fn try_from(entry: Entry) -> Result<Self, Self::Error>

Performs the conversion.

impl TryFrom<HoloHashed<Entry>> for PathEntry

type Error = WasmError

The type returned in the event of a conversion error.

fn try_from(entry_hashed: EntryHashed) -> Result<Self, Self::Error>

Performs the conversion.

impl TryFrom<PathEntry> for SerializedBytes

type Error = SerializedBytesError

The type returned in the event of a conversion error.

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

Performs the conversion.

impl TryFrom<PathEntry> for AppEntryBytes

type Error = WasmError

The type returned in the event of a conversion error.

fn try_from(t: PathEntry) -> Result<Self, Self::Error>

Performs the conversion.

impl TryFrom<PathEntry> for Entry

type Error = WasmError

The type returned in the event of a conversion error.

fn try_from(t: PathEntry) -> Result<Self, Self::Error>

Performs the conversion.

impl TryFrom<PathEntry> for CreateInput

type Error = WasmError

The type returned in the event of a conversion error.

fn try_from(t: PathEntry) -> Result<Self, Self::Error>

Performs the conversion.

impl TryFrom<SerializedBytes> for PathEntry

type Error = SerializedBytesError

The type returned in the event of a conversion error.

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

Performs the conversion.

impl StructuralPartialEq for PathEntry