Struct GraphEntry

pub struct GraphEntry {
    pub owner: PublicKey,
    pub parents: Vec<PublicKey>,
    pub content: GraphContent,
    pub descendants: Vec<(PublicKey, GraphContent)>,
    pub signature: Signature,
}

A generic GraphEntry on the Network.

Graph entries are stored at the owner’s public key. Note that there can only be one graph entry per owner. Graph entries can be linked to other graph entries as parents or descendants. Applications are free to define the meaning of these links, those are not enforced by the protocol. The protocol only ensures that the graph entry is immutable once uploaded and that the signature is valid and matches the owner.

For convenience it is advised to make use of BLS key derivation to create multiple graph entries from a single key.

Fields

owner: PublicKey

The owner of the graph. Note that graph entries are stored at the owner’s public key

parents: Vec<PublicKey>

Other graph entries that this graph entry refers to as parents

content: GraphContent

The content of the graph entry

descendants: Vec<(PublicKey, GraphContent)>

Other graph entries that this graph entry refers to as descendants/outputs along with some data associated to each one

signature: Signature

signs the above 4 fields with the owners key

Implementations

impl GraphEntry

pub const MAX_SIZE: usize = 102_400usize

Maximum size of a graph entry: 100KB

pub fn new( owner: &SecretKey, parents: Vec<PublicKey>, content: GraphContent, descendants: Vec<(PublicKey, GraphContent)>, ) -> Self

Create a new graph entry, signing it with the provided secret key.

pub fn new_with_signature( owner: PublicKey, parents: Vec<PublicKey>, content: GraphContent, descendants: Vec<(PublicKey, GraphContent)>, signature: Signature, ) -> Self

Create a new graph entry, with the signature already calculated.

pub fn bytes_to_sign( owner: &PublicKey, parents: &[PublicKey], content: &[u8], descendants: &[(PublicKey, GraphContent)], ) -> Vec<u8>

Get the bytes that the signature is calculated from.

pub fn address(&self) -> GraphEntryAddress

pub fn bytes_for_signature(&self) -> Vec<u8>

Get the bytes that the signature is calculated from.

pub fn verify_signature(&self) -> bool

Verify the signature of the graph entry

pub fn size(&self) -> usize

Size of the graph entry

pub fn is_too_big(&self) -> bool

Returns true if the graph entry is too big

Trait Implementations

impl Clone for GraphEntry

fn clone(&self) -> GraphEntry

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for GraphEntry

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for GraphEntry

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Hash for GraphEntry

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

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

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

This method returns an Ordering between self and other.

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

where Self: Sized,

Compares and returns the maximum of two values.

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

where Self: Sized,

Compares and returns the minimum of two values.

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

where Self: Sized,

Restrict a value to a certain interval.

impl PartialEq for GraphEntry

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

Tests for self and other values to be equal, and is used by ==.

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

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl PartialOrd for GraphEntry

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

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

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

Tests less than (for self and other) and is used by the < operator.

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

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

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

Tests greater than (for self and other) and is used by the > operator.

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

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

impl Serialize for GraphEntry

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

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl Eq for GraphEntry

impl StructuralPartialEq for GraphEntry