mpvss-rs 2.0.0

A Simple Publicly Verifiable Secret Sharing Library
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

// Copyright 2020-2021  MathxH Chen.
//
// Code is licensed under MIT Apache Dual License

//! # MPVSS - A Simple Publicly Verifiable Secret Sharing Library
//!
//! The library implements a simple PVSS scheme in Rust.
//!
//! ## What is PVSS?
//!
//! Secret sharing means a dealer can break a secret into secret shares among a group of participants which can reconstruct the secret only by collaboratively joining their parts of the secret. The library also implements threshold cryptography so that the dealer can decide whether all of the receiving participants need to collaborate or if a smaller subgroup of participants is sufficient to reconstruct the secret.
//!
//! In addition to the plain secret sharing scheme PVSS adds verifiability in the following way: All the parts the secret is split into are encrypted with the receivers' public keys respectively. The dealer publishes all the encrypted shares along with a non-interactive zero-knowledge proof that allows everbody (not only the receiving participants) to verify that the decrypted shares indeed can be used to reconstruct the secret. The participants then decrypt all their shares and exchange them along with another non-interactive zero-knowledge proof that allows the receiving participant to verify that the share is actually the result of the decryption.
//!
//! Thus PVSS can be used to share a secret among a group of participants so that either the secret can be reconstructed by the participants who all play fair or a participant that received a faked share can identify the malicious party.
//!
//! ## Documents
//!
//! See [Github README](https://github.com/AlexiaChen/mpvss-rs/blob/master/README.md)

// Core modules
pub mod dleq;
pub mod mpvss;
pub mod participant;
pub mod polynomial;
pub mod sharebox;
mod util;

// Group abstractions (new 1.0.0 API)
pub mod group;
pub mod groups;

// Public API exports
pub use dleq::DLEQ;
pub use mpvss::PVSS;
pub use participant::{ModpParticipant, Participant};
pub use sharebox::{DistributionSharesBox, ShareBox};

// Type aliases for convenience
/// Type alias for Participant with Secp256k1Group (elliptic curve cryptography)
pub type Secp256k1Participant = Participant<crate::groups::Secp256k1Group>;

/// Type alias for Participant with Ristretto255Group (prime-order group over Curve25519)
pub type Ristretto255Participant =
    Participant<crate::groups::Ristretto255Group>;

use num_bigint::{BigInt, BigUint, ToBigInt};

pub fn string_to_secret(message: &str) -> BigInt {
    BigUint::from_bytes_be(message.as_bytes())
        .to_bigint()
        .unwrap()
}

pub fn string_from_secret(secret: &BigInt) -> String {
    String::from_utf8(secret.to_biguint().unwrap().to_bytes_be()).unwrap()
}