Struct akd::directory::Directory

pub struct Directory<S> { /* fields omitted */ }

The representation of a auditable key directory

Implementations

impl<S: Storage + Sync + Send> Directory<S>

pub async fn new<H: Hasher>(storage: &S) -> Result<Self, AkdError>

Creates a new (stateless) instance of a auditable key directory. Takes as input a pointer to the storage being used for this instance. The state is stored in the storage.

pub async fn publish<H: Hasher>(
    &mut self,
    updates: Vec<(AkdKey, Values)>,
    use_transaction: bool
) -> Result<EpochHash<H>, AkdError>

Updates the directory to include the updated key-value pairs.

pub async fn lookup<H: Hasher>(
    &self,
    uname: AkdKey
) -> Result<LookupProof<H>, AkdError>

Provides proof for correctness of latest version

pub async fn key_history<H: Hasher>(
    &self,
    uname: &AkdKey
) -> Result<HistoryProof<H>, AkdError>

Takes in the current state of the server and a label. If the label is present in the current state, this function returns all the values ever associated with it, and the epoch at which each value was first committed to the server state. It also returns the proof of the latest version being served at all times.

pub async fn audit<H: Hasher>(
    &self,
    audit_start_ep: u64,
    audit_end_ep: u64
) -> Result<AppendOnlyProof<H>, AkdError>

Returns an AppendOnlyProof for the leaves inserted into the underlying tree between the epochs audit_start_ep and audit_end_ep.

pub async fn retrieve_current_azks(&self) -> Result<Azks, StorageError>

Retrieves the current azks

pub fn value_to_bytes(_value: &Values) -> [u8; 64]

Gets the bytes for a value.

pub async fn get_root_hash_at_epoch<H: Hasher>(
    &self,
    current_azks: &Azks,
    epoch: u64
) -> Result<H::Digest, AkdError>

Gets the azks root hash at the provided epoch. Note that the root hash should exist at any epoch that the azks existed, so as long as epoch >= 0, we should be fine.

pub async fn get_root_hash<H: Hasher>(
    &self,
    current_azks: &Azks
) -> Result<H::Digest, AkdError>

Gets the azks root hash at the current epoch.

Trait Implementations

impl<S: Clone> Clone for Directory<S>

fn clone(&self) -> Directory<S>

Returns a copy of the value.

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

Performs copy-assignment from source.