commonware-reshare 2026.4.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

use commonware_consensus::types::Epoch;
use commonware_cryptography::bls12381::{
    dkg::Output,
    primitives::{group::Share, variant::Variant},
};
use std::{future::Future, pin::Pin};

/// An update from the DKG Actor.
#[allow(dead_code)]
pub enum Update<V: Variant, P> {
    /// DKG at this epoch has failed.
    Failure { epoch: Epoch },
    /// DKG at this epoch has succeeded.
    Success {
        epoch: Epoch,
        /// The public output, shared by all parties.
        output: Output<V, P>,
        /// We will be missing a share if we were not a player.
        share: Option<Share>,
    },
}

/// What to do post update.
#[derive(Clone, Copy, Debug, PartialEq)]
pub enum PostUpdate {
    Continue,
    Stop,
}

/// A callback to process updates produced by the actor.
///
/// The return value should be true if
///
/// This can be used to, e.g.
/// - save the result to a file,
/// - send the result across a channel.
pub trait UpdateCallBack<V: Variant, P>: Send {
    fn on_update(
        &mut self,
        update: Update<V, P>,
    ) -> Pin<Box<dyn Future<Output = PostUpdate> + Send>>;
}

/// An implementor of [UpdateCallBack] which always continues.
pub struct ContinueOnUpdate;

impl ContinueOnUpdate {
    pub fn boxed() -> Box<Self> {
        Box::new(Self)
    }
}

impl<V: Variant, P> UpdateCallBack<V, P> for ContinueOnUpdate {
    fn on_update(
        &mut self,
        _update: Update<V, P>,
    ) -> Pin<Box<dyn Future<Output = PostUpdate> + Send>> {
        Box::pin(async { PostUpdate::Continue })
    }
}