multi-sig 1.0.4 

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
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127

// SPDX-License-Identifier: Apache-2.0
use crate::{Error, Multisig};
use multi_codec::Codec;
use multi_key::ThresholdDisclosure;

/// BLS12 381 G1/G2 signature implementation
pub mod bls12381;
/// Edwards curve 25519 signature implementation
pub mod ed25519;
/// Generic Ed25519 hybrid signature view (codec-agnostic holder)
pub(crate) mod ed25519_hybrid;
/// Ed25519-MAYO2 hybrid signature implementation
pub(crate) mod ed25519_mayo2;
/// FN-DSA post-quantum signature implementation; FIPS 206 (draft)
pub mod fn_dsa;
/// MAYO post-quantum multivariate signature implementation
pub mod mayo;
/// ML-DSA post-quantum signature implementation; FIPS 204
pub mod ml_dsa;
/// NIST P-256/P-384/P-521 ECDSA signature implementation
pub mod nist_p;
/// RSA-SHA256 signature implementation
pub mod rsa;
/// Koblitz 256k1 curve implmentation (a.k.a. the Bitcoin curve)
pub mod secp256k1;
/// SLH-DSA post-quantum signature implementation; FIPS 205
pub mod slh_dsa;
/// Threshold disclosure modes and encrypted metadata helpers.
pub mod threshold_meta;
pub use threshold_meta::{DisclosureView, disclosure_mode, read_threshold_params, stamp_disclosure_attrs};

///
/// Attributes views let you inquire about the Multisig and retrieve data
/// associated with the particular view.
///
/// trait for returning the attributes of the Multisig
pub trait AttrView {
    /// get the codec that the signed message was encoded with
    fn payload_encoding(&self) -> Result<Codec, Error>;
    /// get the signing scheme identifier if any
    fn scheme(&self) -> Result<u8, Error>;
}

/// trait for returning the data from a Multisig
pub trait DataView {
    /// get the signature bytes from the Multisig
    fn sig_bytes(&self) -> Result<Vec<u8>, Error>;
}

/// trait for converting Multisigs to other formats
pub trait ConvView {
    /// convert the Multisig to an SSH signature
    fn to_ssh_signature(&self) -> Result<ssh_key::Signature, Error>;
}

/// trait for getting threshold attributes
pub trait ThresholdAttrView {
    /// get the threshold value for this multisig share
    fn threshold(&self) -> Result<usize, Error>;
    /// get the limit value for this multisig share
    fn limit(&self) -> Result<usize, Error>;
    /// get the identifier value for this multisig share
    fn identifier(&self) -> Result<&[u8], Error>;
    /// get the threshold data associated with the signature
    fn threshold_data(&self) -> Result<&[u8], Error>;
}

/// trait for accumulating shares to rebuild a threshold signature
pub trait ThresholdView {
    /// get the signature shares from this multisig
    fn shares(&self) -> Result<Vec<Multisig>, Error>;
    /// get the signature shares with a specific disclosure mode applied
    fn shares_with_disclosure(
        &self,
        mode: ThresholdDisclosure,
        meta_key: Option<&multi_key::Multikey>,
    ) -> Result<Vec<Multisig>, Error>;
    /// add a new share and return the Multisig with the share added
    fn add_share(&self, share: &Multisig) -> Result<Multisig, Error>;
    /// add a share with a meta_key for decrypting threshold params
    fn add_share_with_meta(
        &self,
        share: &Multisig,
        meta_key: Option<&multi_key::Multikey>,
    ) -> Result<Multisig, Error>;
    /// reconstruct the signature from the shares
    fn combine(&self) -> Result<Multisig, Error>;
    /// combine with a meta_key for decrypting threshold params
    fn combine_with_meta(
        &self,
        meta_key: Option<&multi_key::Multikey>,
    ) -> Result<Multisig, Error>;
}

/// trait for threshold disclosure mode operations on a Multisig
pub trait ThresholdDisclosureView {
    /// Get the current disclosure mode. Returns Full if no mode attribute is present.
    fn disclosure_mode(&self) -> Result<ThresholdDisclosure, Error>;
    /// Read t and n, decrypting if necessary. Requires `meta_key` for encrypted modes.
    fn read_threshold_params(
        &self,
        meta_key: Option<&multi_key::Multikey>,
    ) -> Result<(usize, usize), Error>;
    /// Convert to a target disclosure mode.
    fn to_disclosure(
        &self,
        target: ThresholdDisclosure,
        meta_key: Option<&multi_key::Multikey>,
        current_meta_key: Option<&multi_key::Multikey>,
    ) -> Result<Multisig, Error>;
}

/// trait for getting the other views
pub trait Views {
    /// Provide a read-only view to access the signature attributes
    fn attr_view<'a>(&'a self) -> Result<Box<dyn AttrView + 'a>, Error>;
    /// Provide a read-only view to access signature data
    fn data_view<'a>(&'a self) -> Result<Box<dyn DataView + 'a>, Error>;
    /// Provide a view for converting to other signature formats
    fn conv_view<'a>(&'a self) -> Result<Box<dyn ConvView + 'a>, Error>;
    /// Provide a read-only view to access the threshold signature attributes
    fn threshold_attr_view<'a>(&'a self) -> Result<Box<dyn ThresholdAttrView + 'a>, Error>;
    /// Provide the view for adding a share to a multisig
    fn threshold_view<'a>(&'a self) -> Result<Box<dyn ThresholdView + 'a>, Error>;
    /// Provide an interface for threshold disclosure mode operations
    fn disclosure_view<'a>(&'a self) -> Result<Box<dyn ThresholdDisclosureView + 'a>, Error>;
}