Struct ObjectLinkV0

pub struct ObjectLinkV0 {
    pub repo: Option<RepoId>,
    pub topic: Option<TopicId>,
    pub objects: Vec<ObjectRef>,
    pub overlay: OverlayLink,
    pub peers: Vec<PeerAdvert>,
}

Obtains one or more objects of a repo (Commit, File) by their ID.

On an outerOverlay, the header is always emptied (no way to reconstruct the DAG of commits) except on public overlays or if a topicId is provided If the intent is to share a whole DAG of commits at a definite CommitID/HEAD, then ReadBranchLink should be used instead (or PublicRepoLink if public site)

Fields

repo: Option<RepoId>

Repository ID: not used to make the request. but useful for commits, to know which repo they are from without needing to fetch and open the full DAG of commits. (but the one here might be wrong. only when opening the DAG can the real repo be known. also note that on outerOverlay of non public stores, the DAG is not accessible) note that it could be omitted, specially if the objects are files. As files are content-addressable and belong to an overlay but not to a specific repo or topic.

topic: Option<TopicId>

An optional topic that will be used to retrieve the Certificate of a commit, if needed (topic has to be checked with the one inside the commit. the one here might be wrong. it is provided here as an optimization) or can be used to help with BlockSearchTopic. If the topic is provided, a TopicSyncReq can be performed, and the causal past of the commit will appear (by repeated tries while narrowing down on the ancestors), hence defeating the “emptied header” protection

objects: Vec<ObjectRef>

overlay: OverlayLink

Overlay to join

peers: Vec<PeerAdvert>

Peer brokers to connect to

Trait Implementations

impl Clone for ObjectLinkV0

fn clone(&self) -> ObjectLinkV0

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for ObjectLinkV0

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for ObjectLinkV0

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for ObjectLinkV0

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

where __S: Serializer,

Serialize this value into the given Serde serializer.