concordium_base 10.0.0-alpha.0

A library that defines common types and functionality that are needed by Concordium Rust projects.
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
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78

// -*- mode: rust; -*-

//! Commitment type

use crate::{common::*, curve_arithmetic::*};

use std::ops::Deref;

#[derive(Debug, PartialEq, Eq, Clone, Copy, Serialize, SerdeBase16Serialize)]
/// A Commitment is a group element.
pub struct Commitment<C: Curve>(pub C);

impl<C: Curve> Commitment<C> {
    /// Combine two commitments. If the first is a commitment to v_1 with
    /// randomness r_1 and the second is a commitment to v_2 with randomness
    /// r_2, the resulting commitment is a commitment to v_1 + v_2 with
    /// randomness r_1 + r_2. NB: The commitments must be with the same
    /// commitment key, otherwise the above property does not hold.
    #[inline]
    pub fn combine(&self, other: &Commitment<C>) -> Commitment<C> {
        Commitment(self.0.plus_point(&other.0))
    }
}

/// This trait allows automatic conversion of `&Commitment<C>` to `&C`. In
/// particular this means that we can simply write `c.mul_by_scalar`, for
/// example.
impl<C: Curve> Deref for Commitment<C> {
    type Target = C;

    fn deref(&self) -> &C {
        &self.0
    }
}

/// This trait allows automatic conversion of `&Commitment<C>` to `&C`. In
/// particular this means that we can simply write `c.mul_by_scalar`, for
/// example.
impl<C: Curve> std::borrow::Borrow<C> for Commitment<C> {
    fn borrow(&self) -> &C {
        &self.0
    }
}

#[cfg(test)]
mod tests {
    use crate::curve_arithmetic::arkworks_instances::ArkGroup;

    use super::*;
    use ark_bls12_381::{G1Projective, G2Projective};
    use rand::*;
    type G1 = ArkGroup<G1Projective>;
    type G2 = ArkGroup<G2Projective>;

    impl<C: Curve> Commitment<C> {
        pub fn generate<T: Rng>(csprng: &mut T) -> Commitment<C> {
            Commitment(C::generate(csprng))
        }
    }

    macro_rules! macro_test_commitment_to_byte_conversion {
        ($function_name:ident, $curve_type:path) => {
            #[test]
            pub fn $function_name() {
                let mut csprng = thread_rng();
                for _i in 0..20 {
                    let x = Commitment::<$curve_type>::generate(&mut csprng);
                    let y = serialize_deserialize(&x);
                    assert!(y.is_ok());
                    assert_eq!(x, y.unwrap());
                }
            }
        };
    }
    macro_test_commitment_to_byte_conversion!(commitment_to_byte_conversion_bls12_381_g1, G1);

    macro_test_commitment_to_byte_conversion!(commitment_to_byte_conversion_bls12_381_g2, G2);
}