Struct DirtyKeyShare 

pub struct DirtyKeyShare<E: Curve, L: SecurityLevel = SecurityLevel128> {
    pub core: DirtyIncompleteKeyShare<E>,
    pub aux: DirtyAuxInfo<L>,
}

Dirty (unvalidated) key share

Key share is obtained as output of key refresh protocol. It contains a core share and auxiliary data required to carry out signing.

Compared to the paper, we removed the El-Gamal private key as it’s not used for 3-round presigning, which is the only one we provide

Fields

core: DirtyIncompleteKeyShare<E>

Core key share

aux: DirtyAuxInfo<L>

Auxiliary info

Implementations

impl<E: Curve> DirtyKeyShare<E>

pub fn precompute_crt(&mut self) -> Result<(), InvalidKeyShare>

Precomputes CRT parameters

Enables optimization of modular exponentiation in Zero-Knowledge proofs validation. Precomputation should be relatively fast. It increases size of key share in RAM and on disk, but not noticeably.

Returns error if precomputation failed. In this case, the key share stays unmodified. On success, CRT parameters are saved into the key share (old params, if present, are overwritten)

Note: CRT parameters contain secret information. Leaking them exposes secret Paillier key. Keep them secret (as well as rest of the key share).

Methods from Deref<Target = DirtyIncompleteKeyShare<E>>

pub fn is_hd_wallet(&self) -> bool

Available on crate feature hd-wallet only.

Checks whether the key is HD-capable

pub fn extended_public_key(&self) -> Option<ExtendedPublicKey<E>>

Available on crate feature hd-wallet only.

Returns extended public key, if HD support was enabled

pub fn derive_child_public_key<Hd, ChildIndex>( &self, derivation_path: impl IntoIterator<Item = ChildIndex>, ) -> Result<ExtendedPublicKey<E>, HdError<<ChildIndex as TryInto<NonHardenedIndex>>::Error>>

where Hd: HdWallet<E>, NonHardenedIndex: TryFrom<ChildIndex>,

Available on crate feature hd-wallet only.

Derives child public key, if it’s HD key

Methods from Deref<Target = DirtyKeyInfo<E>>

pub fn share_preimage(&self, j: u16) -> Option<NonZero<Scalar<E>>>

Returns share preimage associated with j-th signer

• For additive shares, share preimage is defined as j+1
• For VSS-shares, share preimage is scalar $I_j$ such that $x_j = F(I_j)$ where $F(x)$ is polynomial co-shared by the signers and $x_j$ is secret share of j-th signer

Note: if you have no idea what it is, probably you don’t need it.

pub fn is_hd_wallet(&self) -> bool

Available on crate feature hd-wallet only.

Checks whether the key is HD-capable

pub fn extended_public_key(&self) -> Option<ExtendedPublicKey<E>>

Available on crate feature hd-wallet only.

Returns extended public key, if HD support was enabled

pub fn derive_child_public_key<Hd, ChildIndex>( &self, derivation_path: impl IntoIterator<Item = ChildIndex>, ) -> Result<ExtendedPublicKey<E>, HdError<<ChildIndex as TryInto<NonHardenedIndex>>::Error>>

where Hd: HdWallet<E>, NonHardenedIndex: TryFrom<ChildIndex>,

Available on crate feature hd-wallet only.

Derives child public key, if it’s HD key, using HdWallet algorithm

Trait Implementations

impl<E: Curve, L: SecurityLevel> AsRef<DirtyAuxInfo<L>> for DirtyKeyShare<E, L>

fn as_ref(&self) -> &DirtyAuxInfo<L>

Converts this type into a shared reference of the (usually inferred) input type.

impl<E: Curve, L: SecurityLevel> AsRef<DirtyCoreKeyShare<E>> for DirtyKeyShare<E, L>

fn as_ref(&self) -> &DirtyIncompleteKeyShare<E>

Converts this type into a shared reference of the (usually inferred) input type.

impl<E: Clone + Curve, L: Clone + SecurityLevel> Clone for DirtyKeyShare<E, L>

fn clone(&self) -> DirtyKeyShare<E, L>

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl<E: Curve, L: SecurityLevel> Deref for DirtyKeyShare<E, L>

type Target = DirtyCoreKeyShare<E>

The resulting type after dereferencing.

fn deref(&self) -> &Self::Target

Dereferences the value.

impl<'de, E: Curve, L: SecurityLevel> Deserialize<'de> for DirtyKeyShare<E, L>

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl<E: Curve, L: SecurityLevel> Serialize for DirtyKeyShare<E, L>

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl<E: Curve, L: SecurityLevel> Validate for DirtyKeyShare<E, L>

type Error = InvalidKeyShare

Validation error

fn is_valid(&self) -> Result<(), InvalidKeyShare>

Checks whether value is valid

fn validate(self) -> Result<Valid<Self>, ValidateError<Self, Self::Error>>

where Self: Sized,

Validates the value

fn validate_ref(&self) -> Result<&Valid<Self>, Self::Error>

where Self: Sized,

Validates the value by reference

impl<E: Curve, L: SecurityLevel> ValidateFromParts<(Valid<DirtyCoreKeyShare<E>>, Valid<DirtyAuxInfo<L>>)> for DirtyKeyShare<E, L>

fn validate_parts( (core, aux): &(IncompleteKeyShare<E>, AuxInfo<L>), ) -> Result<(), Self::Error>

Validates parts

fn from_parts((core, aux): (IncompleteKeyShare<E>, AuxInfo<L>)) -> Self

Constructs Self from parts