commonware-reshare 2026.5.0

Reshare a threshold secret over an epoched log.
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
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83

//! Inbound communication channel for epoch transitions.

use commonware_actor::mailbox::{Policy, Sender};
use commonware_consensus::types::Epoch;
use commonware_cryptography::{
    bls12381::primitives::{group, sharing::Sharing, variant::Variant},
    PublicKey,
};
use commonware_utils::ordered::Set;
use std::collections::VecDeque;
use tracing::error;

/// Messages that can be sent to the orchestrator.
pub enum Message<V: Variant, P: PublicKey> {
    Enter(EpochTransition<V, P>),
    Exit(Epoch),
}

impl<V: Variant, P: PublicKey> Policy for Message<V, P> {
    type Overflow = VecDeque<Self>;

    fn handle(overflow: &mut VecDeque<Self>, message: Self) {
        match message {
            Self::Enter(transition) => {
                let epoch = transition.epoch;
                if let Some(index) = overflow
                    .iter()
                    .position(|pending| matches!(pending, Self::Exit(pending) if *pending == epoch))
                {
                    overflow.remove(index);
                } else {
                    overflow.push_back(Self::Enter(transition));
                }
            }
            Self::Exit(epoch) => {
                if let Some(index) = overflow.iter().position(
                    |pending| matches!(pending, Self::Enter(pending) if pending.epoch == epoch),
                ) {
                    overflow.remove(index);
                } else {
                    overflow.push_back(Self::Exit(epoch));
                }
            }
        }
    }
}

/// A notification of an epoch transition.
pub struct EpochTransition<V: Variant, P: PublicKey> {
    /// The epoch to transition to.
    pub epoch: Epoch,
    /// The public polynomial for the epoch.
    pub poly: Option<Sharing<V>>,
    /// The share for the local participant for the epoch, if participating.
    pub share: Option<group::Share>,
    /// The dealers for the epoch.
    pub dealers: Set<P>,
}

/// Inbound communication channel for epoch transitions.
#[derive(Debug, Clone)]
pub struct Mailbox<V: Variant, P: PublicKey> {
    sender: Sender<Message<V, P>>,
}

impl<V: Variant, P: PublicKey> Mailbox<V, P> {
    /// Create a new [Mailbox].
    pub const fn new(sender: Sender<Message<V, P>>) -> Self {
        Self { sender }
    }

    pub fn enter(&mut self, transition: EpochTransition<V, P>) {
        if !self.sender.enqueue(Message::Enter(transition)).accepted() {
            error!("failed to send epoch transition");
        }
    }

    pub fn exit(&mut self, epoch: Epoch) {
        if !self.sender.enqueue(Message::Exit(epoch)).accepted() {
            error!("failed to send epoch exit");
        }
    }
}