Struct BinaryCacheStore 

pub struct BinaryCacheStore { /* private fields */ }

A read-only binary cache store accessed over HTTP.

Implementations

impl BinaryCacheStore

pub fn builder(base_url: &str) -> BinaryCacheStoreBuilder

Create a builder for a binary cache store with the given base URL.

pub fn new(base_url: &str, trusted_keys: Vec<String>) -> Self

Create a new binary cache client with default HTTP backend.

pub fn with_http_client( base_url: &str, trusted_keys: Vec<String>, client: Box<dyn HttpClient>, ) -> Self

Create a new binary cache client with a custom HTTP backend.

pub async fn fetch_narinfo(&self, hash: &str) -> StoreResult<Option<NarInfo>>

Fetch NarInfo for a store path hash.

pub fn base_url(&self) -> &str

Return the base URL of this binary cache (without trailing slash).

pub fn trusted_keys(&self) -> &[String]

Return the trusted public keys used for signature verification.

pub fn auth_header(&self) -> Option<(&str, &str)>

Return the configured authorization header, if any.

pub async fn fetch_nar(&self, url_path: &str) -> StoreResult<Vec<u8>>

Download a NAR file from the cache.

pub fn verify_narinfo_signatures( narinfo: &NarInfo, trusted_keys: &[String], ) -> StoreResult<bool>

Verify that a NarInfo has at least one valid signature from the trusted keys.

The NarInfo fingerprint is: 1;{storePath};{narHash};{narSize};{sortedReferences}. Each signature in the NarInfo is in keyname:base64sig format. Each trusted key is in keyname:base64pubkey format.

Returns Ok(true) if at least one signature matches a trusted key, Ok(false) if no trusted keys are provided or no signatures match.

Trait Implementations

impl Store for BinaryCacheStore

fn query_path_info<'life0, 'life1, 'async_trait>( &'life0 self, path: &'life1 StorePath, ) -> Pin<Box<dyn Future<Output = StoreResult<Option<PathInfo>>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait,

Query information about a store path.

fn is_valid_path<'life0, 'life1, 'async_trait>( &'life0 self, path: &'life1 StorePath, ) -> Pin<Box<dyn Future<Output = StoreResult<bool>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait,

Check whether a store path is valid (registered in the store).

fn query_all_valid_paths<'life0, 'async_trait>( &'life0 self, ) -> Pin<Box<dyn Future<Output = StoreResult<Vec<StorePath>>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait,

List all valid store paths.

fn query_references<'life0, 'life1, 'async_trait>( &'life0 self, path: &'life1 StorePath, ) -> Pin<Box<dyn Future<Output = StoreResult<Vec<StorePath>>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait,

Query the runtime references (dependencies) of a store path.

fn compute_closure<'life0, 'life1, 'async_trait>( &'life0 self, roots: &'life1 [StorePath], ) -> Pin<Box<dyn Future<Output = StoreResult<Vec<StorePath>>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait,

Compute the transitive closure of a set of store paths.

fn collect_garbage<'life0, 'life1, 'async_trait>( &'life0 self, _options: &'life1 GcOptions, ) -> Pin<Box<dyn Future<Output = StoreResult<GcResult>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait,

Run garbage collection on the store.

fn add_to_store<'life0, 'life1, 'life2, 'life3, 'async_trait>( &'life0 self, _name: &'life1 str, _nar_data: &'life2 [u8], _references: &'life3 [String], ) -> Pin<Box<dyn Future<Output = StoreResult<PathInfo>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait, 'life2: 'async_trait, 'life3: 'async_trait,

Add a store path with its NAR content. Returns the registered PathInfo.

fn register_path<'life0, 'life1, 'async_trait>( &'life0 self, _info: &'life1 PathInfo, ) -> Pin<Box<dyn Future<Output = StoreResult<()>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait,

Register a pre-built path in the store database.

fn add_signatures<'life0, 'life1, 'life2, 'async_trait>( &'life0 self, _path: &'life1 StorePath, _signatures: &'life2 [String], ) -> Pin<Box<dyn Future<Output = StoreResult<()>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait, 'life2: 'async_trait,

Add signatures to an existing store path.

fn query_referrers<'life0, 'life1, 'async_trait>( &'life0 self, _path: &'life1 StorePath, ) -> Pin<Box<dyn Future<Output = StoreResult<Vec<StorePath>>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait,

Query paths that refer to the given path (reverse dependencies).

fn verify_store<'life0, 'async_trait>( &'life0 self, ) -> Pin<Box<dyn Future<Output = StoreResult<VerifyResult>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait,

Verify store integrity by checking NAR hashes of all valid paths.

fn delete_path<'life0, 'life1, 'async_trait>( &'life0 self, _path: &'life1 StorePath, ) -> Pin<Box<dyn Future<Output = StoreResult<u64>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait,

Delete a store path from disk and the database.

fn optimise_store<'life0, 'async_trait>( &'life0 self, _dry_run: bool, ) -> Pin<Box<dyn Future<Output = StoreResult<OptimiseResult>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait,

Optimise the store by hard-linking identical files.