commonware-consensus 2026.4.0

Order opaque messages in a Byzantine environment.
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

use crate::types::Epoch;
use commonware_cryptography::certificate;
use commonware_utils::sync::Mutex;
use std::{collections::HashMap, sync::Arc};

/// A mock [`certificate::Provider`] that allows registering different schemes per epoch.
///
/// Unlike [`certificate::ConstantProvider`] which returns the same scheme for all scopes,
/// this mock supports epoch-specific schemes for multi-epoch testing scenarios.
#[derive(Clone)]
pub struct Provider<S: certificate::Scheme> {
    schemes: Arc<Mutex<HashMap<Epoch, Arc<S>>>>,
}

impl<S: certificate::Scheme> Provider<S> {
    pub fn new() -> Self {
        Self {
            schemes: Arc::new(Mutex::new(HashMap::new())),
        }
    }

    /// Registers a new signing scheme for the given epoch.
    ///
    /// Returns `false` if a scheme was already registered for the epoch.
    pub fn register(&self, epoch: Epoch, scheme: S) -> bool {
        let mut schemes = self.schemes.lock();
        schemes.insert(epoch, Arc::new(scheme)).is_none()
    }
}

impl<S: certificate::Scheme> Default for Provider<S> {
    fn default() -> Self {
        Self::new()
    }
}

impl<S: certificate::Scheme> certificate::Provider for Provider<S> {
    type Scope = Epoch;
    type Scheme = S;

    fn scoped(&self, epoch: Epoch) -> Option<Arc<Self::Scheme>> {
        let schemes = self.schemes.lock();
        schemes.get(&epoch).cloned()
    }
}