Struct TrustedDocuments 

pub struct TrustedDocuments { /* private fields */ }

The allow-list of trusted documents.

Documents are addressable two ways: by the manifest’s operation id (what a client sends), and by the SHA-256 of their text (so a client that sends the full document of a trusted operation is accepted too).

Implementations

impl TrustedDocuments

pub fn new() -> Self

An empty allow-list.

pub fn with_document(self, document: impl Into<String>) -> Self

Add a document, addressed by its SHA-256.

pub fn insert(&mut self, id: impl Into<String>, document: impl Into<String>)

Add a document under an explicit manifest id.

pub fn from_json(text: &str) -> Result<Self, ManifestError>

Parse a manifest (Apollo format or a flat {id: document} map).

Errors

Returns ManifestError::Invalid for malformed JSON, an unknown Apollo manifest format/version, or a flat entry whose SHA-256 id does not match its document.

pub fn from_file(path: &Path) -> Result<Self, ManifestError>

Load a manifest file.

Errors

See from_json; plus ManifestError::Io.

pub fn extend(&mut self, other: Self)

Merge another allow-list into this one.

pub fn get(&self, id: &str) -> Option<&Arc<str>>

The document with manifest id (or SHA-256) id.

pub fn contains_document(&self, document: &str) -> bool

Whether a document with this exact text is trusted.

pub fn len(&self) -> usize

Number of distinct trusted documents.

pub fn is_empty(&self) -> bool

Whether the allow-list is empty.

Trait Implementations

impl Clone for TrustedDocuments

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for TrustedDocuments

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

Formats the value using the given formatter.

impl Default for TrustedDocuments

fn default() -> Self

Returns the “default value” for a type.