Enum holochain_types::dht_op::DhtOp

pub enum DhtOp {
    StoreElement(Signature, Header, Option<Box<Entry>>),
    StoreEntry(Signature, NewEntryHeader, Box<Entry>),
    RegisterAgentActivity(Signature, Header),
    RegisterUpdatedContent(Signature, Update, Option<Box<Entry>>),
    RegisterUpdatedElement(Signature, Update, Option<Box<Entry>>),
    RegisterDeletedBy(Signature, Delete),
    RegisterDeletedEntryHeader(Signature, Delete),
    RegisterAddLink(Signature, CreateLink),
    RegisterRemoveLink(Signature, DeleteLink),
}

A unit of DHT gossip. Used to notify an authority of new (meta)data to hold as well as changes to the status of already held data.

Variants

StoreElement(Signature, Header, Option<Box<Entry>>)

Used to notify the authority for a header that it has been created.

Conceptually, authorities receiving this DhtOp do three things:

• Ensure that the element passes validation.
• Store the header into their DHT shard.
• Store the entry into their CAS.
  • Note: they do not become responsible for keeping the set of references from that entry up-to-date.

StoreEntry(Signature, NewEntryHeader, Box<Entry>)

Used to notify the authority for an entry that it has been created anew. (The same entry can be created more than once.)

Conceptually, authorities receiving this DhtOp do four things:

• Ensure that the element passes validation.
• Store the entry into their DHT shard.
• Store the header into their CAS.
  • Note: they do not become responsible for keeping the set of references from that header up-to-date.
• Add a “created-by” reference from the entry to the hash of the header.

TODO: document how those “created-by” references are stored in reality.

RegisterAgentActivity(Signature, Header)

Used to notify the authority for an agent’s public key that that agent has committed a new header.

Conceptually, authorities receiving this DhtOp do three things:

• Ensure that the header alone passes surface-level validation.
• Store the header into their DHT shard.
  • FIXME: @artbrock, do they?
• Add an “agent-activity” reference from the public key to the hash of the header.

TODO: document how those “agent-activity” references are stored in reality.

RegisterUpdatedContent(Signature, Update, Option<Box<Entry>>)

Op for updating an entry. This is sent to the entry authority.

RegisterUpdatedElement(Signature, Update, Option<Box<Entry>>)

Op for updating an element. This is sent to the element authority.

RegisterDeletedBy(Signature, Delete)

Op for registering a Header deletion with the Header authority

RegisterDeletedEntryHeader(Signature, Delete)

Op for registering a Header deletion with the Entry authority, so that the Entry can be marked Dead if all of its Headers have been deleted

RegisterAddLink(Signature, CreateLink)

Op for adding a link

RegisterRemoveLink(Signature, DeleteLink)

Op for removing a link

Implementations

impl DhtOp

pub fn signature_mut(&mut self) -> &mut Signature

Mutable access to the Signature

pub fn header_seq_mut(&mut self) -> Option<&mut u32>

Mutable access to the seq of the Header, if applicable

pub fn header_entry_data_mut(
    &mut self
) -> Option<(&mut EntryHash, &mut EntryType)>

Mutable access to the entry data of the Header, if applicable

impl DhtOp

pub fn dht_basis(&self) -> AnyDhtHash

Returns the basis hash which determines which agents will receive this DhtOp

pub fn to_light(&self) -> DhtOpLight

Convert a DhtOp to a DhtOpLight and basis

pub fn signature(&self) -> &Signature

Get the signature for this op

pub fn into_inner(self) -> (Signature, Header, Option<Entry>)

Extract inner Signature, Header and Option from an op

pub fn header(&self) -> Header

Get the header from this op This requires cloning and converting the header as some ops don’t hold the Header type

pub fn entry(&self) -> Option<&Entry>

Get the entry from this op, if one exists

pub fn get_type(&self) -> DhtOpType

Get the type as a unit enum, for Display purposes

pub fn from_type(
    op_type: DhtOpType,
    header: SignedHeader,
    entry: Option<Entry>
) -> DhtOpResult<Self>

From a type, header and an entry (if there is one)

Trait Implementations

impl<'arbitrary> Arbitrary<'arbitrary> for DhtOp

fn arbitrary(u: &mut Unstructured<'arbitrary>) -> Result<Self>

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

fn arbitrary_take_rest(u: Unstructured<'arbitrary>) -> Result<Self>

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 Clone for DhtOp

fn clone(&self) -> DhtOp

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for DhtOp

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for DhtOp

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

Deserialize this value from the given Serde deserializer.

impl Display for DhtOp

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

Formats the value using the given formatter.

impl HashableContent for DhtOp

type HashType = DhtOp

The HashType which this content will be hashed to

fn hash_type(&self) -> Self::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 PartialEq<DhtOp> for DhtOp

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

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

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

This method tests for !=.

impl Serialize for DhtOp

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

Serialize this value into the given Serde serializer.

impl TryFrom<&'_ DhtOp> for SerializedBytes

type Error = SerializedBytesError

The type returned in the event of a conversion error.

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

Performs the conversion.

impl TryFrom<DhtOp> for SerializedBytes

type Error = SerializedBytesError

The type returned in the event of a conversion error.

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

Performs the conversion.

impl TryFrom<SerializedBytes> for DhtOp

type Error = SerializedBytesError

The type returned in the event of a conversion error.

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

Performs the conversion.

impl Eq for DhtOp

impl StructuralEq for DhtOp

impl StructuralPartialEq for DhtOp