parasol_runtime 0.10.0

This crate supports the Parasol CPU, providing key generation, encryption, and FHE evaluation functionality.
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56

use std::sync::{
    OnceLock,
    atomic::{AtomicUsize, Ordering},
    mpsc::{self, Receiver},
};

use log::error;

use crate::circuit_processor::RuntimeError;

/// A callback that fires when all the operations in an [`FheCircuit`](crate::FheCircuit)
/// passed to [`crate::CircuitProcessor::spawn_graph`] or
/// [`crate::CircuitProcessor::run_graph_blocking`] finish.
pub struct CompletionHandler {
    pub(crate) ops_remaining: AtomicUsize,
    pub(crate) callback: Box<dyn Fn(Option<RuntimeError>) + 'static + Sync + Send>,
    pub(crate) error: OnceLock<RuntimeError>,
}

impl CompletionHandler {
    /// Create a [`CompletionHandler`] with the passed callback.
    pub fn new<F>(callback: F) -> Self
    where
        F: Fn(Option<RuntimeError>) + Sync + Send + 'static,
    {
        Self {
            ops_remaining: AtomicUsize::new(1),
            callback: Box::new(callback),
            error: OnceLock::new(),
        }
    }

    pub(crate) fn dispatch(&self) {
        self.ops_remaining.fetch_add(1, Ordering::Acquire);
    }

    pub(crate) fn retire(&self) {
        if self.ops_remaining.fetch_sub(1, Ordering::Release) == 1 {
            (self.callback)(self.error.get().map(|x| x.to_owned()));
        }
    }

    /// Creates a new [`CompletionHandler`] that notifies the returned recv on completion
    pub fn new_notify() -> (Self, Receiver<Option<RuntimeError>>) {
        let (send, recv) = mpsc::channel();

        (
            Self::new(move |x| {
                if let Err(e) = send.send(x.map(|x| x.to_owned())) {
                    error!("Completion handler notification failed: {e}");
                }
            }),
            recv,
        )
    }
}