arcanum-threshold 0.1.0

Threshold cryptography for the Arcanum cryptographic engine
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
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
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103

//! # Arcanum Threshold Cryptography
//!
//! Threshold cryptographic schemes for distributed key management and signing.
//!
//! ## Secret Sharing
//!
//! - **Shamir**: Basic (t, n) secret sharing
//! - **Feldman**: Verifiable secret sharing with public commitments
//! - **Pedersen**: Information-theoretically hiding verifiable secret sharing
//!
//! ## Threshold Signatures (FROST)
//!
//! FROST (Flexible Round-Optimized Schnorr Threshold) signatures:
//!
//! - **FROST-Ed25519**: Ed25519-compatible threshold signatures
//! - **FROST-secp256k1**: Bitcoin/Ethereum compatible signatures
//!
//! ## Distributed Key Generation (DKG)
//!
//! Generate group keys without trusted dealer:
//!
//! - **Pedersen DKG**: Two-round DKG with information-theoretic security
//! - **FROST DKG**: Integrated key generation for FROST signing
//!
//! ## Proactive Refresh
//!
//! Limit the window of compromise with periodic share refresh:
//!
//! - **Centralized refresh**: Dealer refreshes all shares at once
//! - **Distributed refresh**: Participants cooperatively refresh without dealer
//!
//! After refresh, old shares are incompatible with new shares, preventing
//! attackers from combining shares collected over different time periods.
//!
//! ## Example
//!
//! ```ignore
//! use arcanum_threshold::prelude::*;
//!
//! // Create 3-of-5 Shamir sharing
//! let secret = b"my secret key";
//! let shares = ShamirScheme::split(secret, 3, 5)?;
//!
//! // Reconstruct from any 3 shares
//! let recovered = ShamirScheme::combine(&shares[..3])?;
//! assert_eq!(secret.as_slice(), recovered.as_slice());
//! ```

#![deny(unsafe_code)]
#![warn(missing_docs, rust_2018_idioms)]
#![allow(
    clippy::needless_range_loop,
    clippy::needless_borrow,
    clippy::needless_borrows_for_generic_args
)]

mod error;

#[cfg(feature = "shamir")]
pub mod shamir;

#[cfg(feature = "frost")]
pub mod frost;

#[cfg(feature = "dkg")]
pub mod dkg;

#[cfg(feature = "proactive")]
pub mod proactive;

pub use error::{Result, ThresholdError};

#[cfg(feature = "shamir")]
pub use shamir::{ShamirScheme, Share};

#[cfg(feature = "frost")]
pub use frost::{FrostSigner, FrostVerifier, SigningShare, VerifyingShare};

#[cfg(feature = "dkg")]
pub use dkg::{DkgParticipant, DkgRound1, DkgRound2};

#[cfg(feature = "proactive")]
pub use proactive::{ProactiveRefresh, RefreshShares};

/// Prelude for convenient imports.
pub mod prelude {
    pub use crate::error::{Result, ThresholdError};

    #[cfg(feature = "shamir")]
    pub use crate::shamir::{ShamirScheme, Share};

    #[cfg(feature = "frost")]
    pub use crate::frost::{FrostSigner, FrostVerifier};

    #[cfg(feature = "dkg")]
    pub use crate::dkg::{DkgParticipant, DkgRound1, DkgRound2};

    #[cfg(feature = "proactive")]
    pub use crate::proactive::{ProactiveRefresh, RefreshShares};
}

/// Re-export identifier type for participants.
pub type Identifier = u16;