Struct CircuitCache 

pub struct CircuitCache { /* private fields */ }

Thread-safe LRU cache for compiled FHE circuits.

Cloning a CircuitCache produces a second handle that shares the same underlying cache, making it cheap to hand out per-request copies.

Example

let cache = CircuitCache::new(CircuitCacheConfig::default());
let circuit = cache.get_or_compile(&predicate, || {
    let mut compiler = PredicateCompiler::new();
    compiler.compile(&predicate, EncryptedType::U8)
})?;

Implementations

impl CircuitCache

pub fn new(config: CircuitCacheConfig) -> Self

Create a new cache with the given configuration.

pub fn get(&self, key: &CircuitCacheKey) -> Option<Circuit>

Look up a pre-computed cache key in the cache.

Returns Some(Circuit) on a hit or None on a miss.

pub fn insert(&self, key: CircuitCacheKey, circuit: Circuit)

Insert a compiled circuit into the cache.

If the key is already present the call is a no-op.

pub fn get_or_compile<F>( &self, predicate: &Predicate, compile_fn: F, ) -> Result<Circuit>

where F: FnOnce() -> Result<Circuit>,

Get a cached circuit or compile it on a miss.

On a cache miss compile_fn is called exactly once to produce the circuit, which is then stored before being returned. On a cache hit compile_fn is never called.

Errors

Returns the error produced by compile_fn on a miss if compilation fails. Cache hits never return an error from this method.

pub fn stats(&self) -> CircuitCacheStats

Return a point-in-time snapshot of the cache statistics.

pub fn len(&self) -> usize

Number of entries currently held in the cache.

pub fn is_empty(&self) -> bool

Whether the cache is empty.

Trait Implementations

impl Clone for CircuitCache

fn clone(&self) -> CircuitCache

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for CircuitCache

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

Formats the value using the given formatter.