Struct HttpCertificationTree

pub struct HttpCertificationTree { /* private fields */ }

A certification tree for generic HTTP requests.

Implementations

impl HttpCertificationTree

pub fn new(tree: NestedTree<Vec<u8>, Vec<u8>>) -> Self

Creates a new empty HttpCertificationTree from a given CertificationTree. The default implementation should be used in most cases.

pub fn root_hash(&self) -> Sha256Digest

Returns the root hash of the tree. This hash can be used as the canister’s certified variable.

pub fn insert(&mut self, entry: &HttpCertificationTreeEntry<'_>)

Inserts a given HttpCertificationTreeEntry into the tree. After performing this operation, the canister’s certified variable will need to be updated with the new root hash of the tree.

pub fn delete(&mut self, entry: &HttpCertificationTreeEntry<'_>)

Deletes a given HttpCertificationTreeEntry from the tree. After performing this operation, the canister’s certified variable will need to be updated with the new root hash of the tree.

pub fn delete_by_path(&mut self, path: &HttpCertificationPath<'_>)

Deletes all HttpCertificationTreeEntrys that match a given HttpCertificationPath. After performing this operation, the canister’s certified variable will need to be updated with the new root hash of the tree.

pub fn clear(&mut self)

Clears the tree of all HttpCertificationTreeEntry. After performing this operation, the canister’s certified variable will need to be updated with the new root hash of the tree.

pub fn witness( &self, entry: &HttpCertificationTreeEntry<'_>, request_url: &str, ) -> HttpCertificationResult<HashTree>

Returns a pruned HashTree that will prove the presence of a given HttpCertificationTreeEntry in the full HttpCertificationTree, without needing to return the full tree.

request_url is required so that the witness can be generated with respect to the request URL.

Trait Implementations

impl Clone for HttpCertificationTree

fn clone(&self) -> HttpCertificationTree

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for HttpCertificationTree

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

Formats the value using the given formatter.

impl Default for HttpCertificationTree

fn default() -> Self

Returns the “default value” for a type.