frost-ed448 3.0.0

A Schnorr signature scheme over Ed448 that supports FROST.
Documentation
//! FROST implementation supporting re-randomizable keys.

use alloc::collections::btree_map::BTreeMap;

/// Re-randomized FROST signing using the given `randomizer_seed`, which should
/// be sent from the Coordinator using a confidential channel.
///
/// See [`crate::round2::sign`] for documentation on the other parameters.
pub fn sign_with_randomizer_seed(
    signing_package: &crate::SigningPackage,
    signer_nonces: &crate::round1::SigningNonces,
    key_package: &crate::keys::KeyPackage,
    randomizer_seed: &[u8],
) -> Result<crate::round2::SignatureShare, crate::Error> {
    frost_rerandomized::sign_with_randomizer_seed::<crate::Ed448Shake256>(
        signing_package,
        signer_nonces,
        key_package,
        randomizer_seed,
    )
}

/// Re-randomized FROST signature share aggregation with the given
/// [`RandomizedParams`].
///
/// See [`frost_core::aggregate`] for documentation on the other parameters.
pub fn aggregate(
    signing_package: &crate::SigningPackage,
    signature_shares: &BTreeMap<crate::Identifier, crate::round2::SignatureShare>,
    pubkeys: &crate::keys::PublicKeyPackage,
    randomized_params: &RandomizedParams,
) -> Result<crate::Signature, crate::Error> {
    frost_rerandomized::aggregate::<crate::Ed448Shake256>(
        signing_package,
        signature_shares,
        pubkeys,
        randomized_params,
    )
}

/// Re-randomized FROST signature share aggregation with the given
/// [`RandomizedParams`] using the given cheater detection strategy.
///
/// See [`frost_core::aggregate_custom`] for documentation on the other parameters.
pub fn aggregate_custom(
    signing_package: &crate::SigningPackage,
    signature_shares: &BTreeMap<crate::Identifier, crate::round2::SignatureShare>,
    pubkeys: &crate::keys::PublicKeyPackage,
    cheater_detection: crate::CheaterDetection,
    randomized_params: &RandomizedParams,
) -> Result<crate::Signature, crate::Error> {
    frost_rerandomized::aggregate_custom::<crate::Ed448Shake256>(
        signing_package,
        signature_shares,
        pubkeys,
        cheater_detection,
        randomized_params,
    )
}

/// A randomizer. A random scalar which is used to randomize the key.
pub type Randomizer = frost_rerandomized::Randomizer<crate::Ed448Shake256>;

/// Randomized parameters for a signing instance of randomized FROST.
pub type RandomizedParams = frost_rerandomized::RandomizedParams<crate::Ed448Shake256>;