blsful 3.1.0

BLS signature implementation according to the IETF spec on the BLS12-381 curve.
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

use crate::impls::inner_types::*;
use crate::*;

/// BLS signature augmentation trait
pub trait BlsSignatureMessageAugmentation: BlsSignatureCore {
    /// The domain separation tag
    const DST: &'static [u8];

    /// The signing algorithm
    fn sign<B: AsRef<[u8]>>(
        sk: &<Self::PublicKey as Group>::Scalar,
        msg: B,
    ) -> BlsResult<Self::Signature> {
        let mut overhead = Self::pk_bytes(Self::public_key(sk), msg.as_ref().len());
        overhead.extend_from_slice(msg.as_ref());
        <Self as BlsSignatureCore>::core_sign(sk, overhead.as_slice(), Self::DST)
    }

    /// The verification algorithm
    fn verify<B: AsRef<[u8]>>(pk: Self::PublicKey, sig: Self::Signature, msg: B) -> BlsResult<()> {
        let mut overhead = Self::pk_bytes(pk, msg.as_ref().len());
        overhead.extend_from_slice(msg.as_ref());
        <Self as BlsSignatureCore>::core_verify(pk, sig, overhead.as_slice(), Self::DST)
    }

    /// The aggregate verification algorithm
    fn aggregate_verify<P, B>(pks: P, sig: Self::Signature) -> BlsResult<()>
    where
        P: Iterator<Item = (Self::PublicKey, B)>,
        B: AsRef<[u8]>,
    {
        let new_pks = pks.map(|(pk, m)| {
            let mut overhead = Self::pk_bytes(pk, m.as_ref().len());
            overhead.extend_from_slice(m.as_ref());
            (pk, overhead)
        });
        <Self as BlsSignatureCore>::core_aggregate_verify(new_pks, sig, Self::DST)
    }

    /// The bytes of a public key
    fn pk_bytes(pk: Self::PublicKey, size_hint: usize) -> Vec<u8> {
        let pk_bytes = pk.to_bytes();
        let pk_bytes_ref = pk_bytes.as_ref();
        let mut overhead = Vec::with_capacity(pk_bytes_ref.len() + size_hint);
        overhead.extend_from_slice(pk_bytes_ref);
        overhead
    }
}