Struct ApprovalStore 

pub struct ApprovalStore { /* private fields */ }

Persisted operator hash approvals of one node.

Implementations

impl ApprovalStore

pub fn open( dir: &Path, anchors: Arc<TrustAnchors>, local: LocalMeshId, ) -> Result<Self, LicenceError>

Open the store in dir. A missing file is an empty store; a bad file is an error and nothing is written.

pub fn open_or_poisoned( dir: &Path, anchors: Arc<TrustAnchors>, local: LocalMeshId, ) -> Self

Self::open, but a bad file gives a poisoned store: it has no active approvals, refuses writes and leaves the file alone.

pub fn poisoned(&self) -> Option<String>

Why the store is poisoned, if it is.

pub fn accept(&self, signed: &SignedApproval) -> Result<Outcome, LicenceError>

Accept an approval: pinned operator signature, approval.mesh_id equal to the local mesh id. A repeat is Outcome::Duplicate.

pub fn covering( &self, cog_id: &str, version: &str, sha256: &str, ) -> Option<String>

The content key of an active approval for cog_id version that lists sha256.

pub fn orphaned(&self) -> Vec<String>

Content keys of approvals for another mesh id (weaver doctor).

pub fn len(&self) -> usize

Number of approvals held, active or not.

pub fn is_empty(&self) -> bool

True when no approval is held.

impl ApprovalStore

pub fn rows(&self) -> Vec<ApprovalRow>

Every held approval, active or orphaned.

pub fn orphaned_signed(&self) -> Vec<SignedApproval>

The signed envelopes of the orphaned approvals: the CLI verifies each against the operator’s own key before it re-signs it.

pub fn orphaned_approvals(&self) -> Vec<Approval>

The orphaned approvals themselves (--reapprove-orphaned re-signs them for the new mesh id).

impl ApprovalStore

pub fn holds(&self, content_key: &str) -> bool

True when an approval with this content key is held.

pub fn sync_approvals_page( &self, after: Option<&str>, max_entries: usize, max_bytes: usize, ) -> (Vec<(String, SignedApproval)>, bool)

A page of active approvals (for the local mesh) as (content key, approval) ordered by content key and strictly after after, within max_entries and max_bytes; and whether more follow. Empty while poisoned.