Struct ExternalSource 

pub struct ExternalSource {
    key: VerifyingKey,
    path: PathBuf,
    cache: PathBuf,
    pub current: Option<Verified>,
}

Fields

key: VerifyingKey

path: PathBuf

cache: PathBuf

current: Option<Verified>

Implementations

impl ExternalSource

pub fn new( cfg: &ExternalSourceConfig, cache_dir: &Path, ) -> Result<ExternalSource, String>

The key must parse; a bad key in the generation is a configuration error.

fn verify(&self, bytes: &[u8], sig_hex: &str) -> Result<(), String>

fn read(&self, path: &Path) -> Result<(Vec<u8>, String), String>

fn check( &self, bytes: Vec<u8>, sig: &str, ) -> Result<Result<Verified, String>, String>

pub fn load_cache(&mut self) -> Result<(), String>

At start: the cache, re-verified. A cache that no longer verifies was altered on disk: Integrity. No cache is fine.

pub fn poll(&mut self) -> Poll

pub fn replayed(doc: &Verified, journal: Option<(u64, Hash)>) -> Option<String>

Whether a verified document is older than, or a different one with the same sequence number as, the last the journal accepted (B-16).

pub fn poll_against(&mut self, journal: Option<(u64, Hash)>) -> Poll

poll, held to the journal’s record of the last accepted document (B-16): the cache is root-writable, the journal is hash-chained.

fn store(&self, v: &Verified) -> Result<()>

One file, written aside, synced and renamed: a crash leaves the old cache or the new one, never a document with another’s signature.