//! This module provides an implementation of a commitment engine use crate::{ errors::NovaError, traits::{ commitment::{ CommitmentEngineTrait, CommitmentGensTrait, CommitmentTrait, CompressedCommitmentTrait, }, AbsorbInROTrait, AppendToTranscriptTrait, CompressedGroup, Group, ROTrait, }, }; use core::{ fmt::Debug, marker::PhantomData, ops::{Add, AddAssign, Mul, MulAssign}, }; use ff::Field; use merlin::Transcript; use rayon::prelude::*; use serde::{Deserialize, Serialize}; /// A type that holds commitment generators #[derive(Clone, Debug, PartialEq, Eq, Serialize, Deserialize)] pub struct CommitmentGens { gens: Vec, _p: PhantomData, } /// A type that holds a commitment #[derive(Clone, Copy, Debug, PartialEq, Eq, Serialize, Deserialize)] #[serde(bound = "")] pub struct Commitment { pub(crate) comm: G, } /// A type that holds a compressed commitment #[derive(Clone, Copy, Debug, PartialEq, Eq, Serialize, Deserialize)] #[serde(bound = "")] pub struct CompressedCommitment { comm: C, } impl CommitmentGensTrait for CommitmentGens { type Commitment = Commitment; type CompressedCommitment = CompressedCommitment; fn new(label: &'static [u8], n: usize) -> Self { CommitmentGens { gens: G::from_label(label, n.next_power_of_two()), _p: Default::default(), } } fn len(&self) -> usize { self.gens.len() } fn commit(&self, v: &[G::Scalar]) -> Self::Commitment { assert!(self.gens.len() >= v.len()); Commitment { comm: G::vartime_multiscalar_mul(v, &self.gens[..v.len()]), } } fn split_at(&self, n: usize) -> (CommitmentGens, CommitmentGens) { ( CommitmentGens { gens: self.gens[0..n].to_vec(), _p: Default::default(), }, CommitmentGens { gens: self.gens[n..].to_vec(), _p: Default::default(), }, ) } fn combine(&self, other: &CommitmentGens) -> CommitmentGens { let gens = { let mut c = self.gens.clone(); c.extend(other.gens.clone()); c }; CommitmentGens { gens, _p: Default::default(), } } // combines the left and right halves of `self` using `w1` and `w2` as the weights fn fold(&self, w1: &G::Scalar, w2: &G::Scalar) -> CommitmentGens { let w = vec![*w1, *w2]; let (L, R) = self.split_at(self.len() / 2); let gens = (0..self.len() / 2) .into_par_iter() .map(|i| { let gens = CommitmentGens:: { gens: [L.gens[i].clone(), R.gens[i].clone()].to_vec(), _p: Default::default(), }; gens.commit(&w).comm.preprocessed() }) .collect(); CommitmentGens { gens, _p: Default::default(), } } /// Scales each element in `self` by `r` fn scale(&self, r: &G::Scalar) -> Self { let gens_scaled = self .gens .clone() .into_par_iter() .map(|g| { let gens = CommitmentGens:: { gens: vec![g], _p: Default::default(), }; gens.commit(&[*r]).comm.preprocessed() }) .collect(); CommitmentGens { gens: gens_scaled, _p: Default::default(), } } /// reinterprets a vector of commitments as a set of generators fn reinterpret_commitments_as_gens( c: &[CompressedCommitment], ) -> Result { let d = (0..c.len()) .into_par_iter() .map(|i| c[i].decompress()) .collect::>, NovaError>>()?; let gens = (0..d.len()) .into_par_iter() .map(|i| d[i].comm.preprocessed()) .collect(); Ok(CommitmentGens { gens, _p: Default::default(), }) } } impl CommitmentTrait for Commitment { type CompressedCommitment = CompressedCommitment; fn compress(&self) -> CompressedCommitment { CompressedCommitment { comm: self.comm.compress(), } } fn to_coordinates(&self) -> (G::Base, G::Base, bool) { self.comm.to_coordinates() } } impl Default for Commitment { fn default() -> Self { Commitment { comm: G::zero() } } } impl CompressedCommitmentTrait for CompressedCommitment { type Commitment = Commitment; fn decompress(&self) -> Result { let comm = self.comm.decompress(); if comm.is_none() { return Err(NovaError::DecompressionError); } Ok(Commitment { comm: comm.unwrap(), }) } } impl AppendToTranscriptTrait for Commitment { fn append_to_transcript(&self, label: &'static [u8], transcript: &mut Transcript) { transcript.append_message(label, self.comm.compress().as_bytes()); } } impl AbsorbInROTrait for Commitment { fn absorb_in_ro(&self, ro: &mut G::RO) { let (x, y, is_infinity) = self.comm.to_coordinates(); ro.absorb(x); ro.absorb(y); ro.absorb(if is_infinity { G::Base::one() } else { G::Base::zero() }); } } impl AppendToTranscriptTrait for CompressedCommitment { fn append_to_transcript(&self, label: &'static [u8], transcript: &mut Transcript) { transcript.append_message(label, self.comm.as_bytes()); } } impl MulAssign for Commitment { fn mul_assign(&mut self, scalar: G::Scalar) { let result = (self as &Commitment).comm * scalar; *self = Commitment { comm: result }; } } impl<'a, 'b, G: Group> Mul<&'b G::Scalar> for &'a Commitment { type Output = Commitment; fn mul(self, scalar: &'b G::Scalar) -> Commitment { Commitment { comm: self.comm * scalar, } } } impl Mul for Commitment { type Output = Commitment; fn mul(self, scalar: G::Scalar) -> Commitment { Commitment { comm: self.comm * scalar, } } } impl<'b, G: Group> AddAssign<&'b Commitment> for Commitment { fn add_assign(&mut self, other: &'b Commitment) { let result = (self as &Commitment).comm + other.comm; *self = Commitment { comm: result }; } } impl<'a, 'b, G: Group> Add<&'b Commitment> for &'a Commitment { type Output = Commitment; fn add(self, other: &'b Commitment) -> Commitment { Commitment { comm: self.comm + other.comm, } } } macro_rules! define_add_variants { (G = $g:path, LHS = $lhs:ty, RHS = $rhs:ty, Output = $out:ty) => { impl<'b, G: $g> Add<&'b $rhs> for $lhs { type Output = $out; fn add(self, rhs: &'b $rhs) -> $out { &self + rhs } } impl<'a, G: $g> Add<$rhs> for &'a $lhs { type Output = $out; fn add(self, rhs: $rhs) -> $out { self + &rhs } } impl Add<$rhs> for $lhs { type Output = $out; fn add(self, rhs: $rhs) -> $out { &self + &rhs } } }; } macro_rules! define_add_assign_variants { (G = $g:path, LHS = $lhs:ty, RHS = $rhs:ty) => { impl AddAssign<$rhs> for $lhs { fn add_assign(&mut self, rhs: $rhs) { *self += &rhs; } } }; } define_add_assign_variants!(G = Group, LHS = Commitment, RHS = Commitment); define_add_variants!(G = Group, LHS = Commitment, RHS = Commitment, Output = Commitment); /// Provides a commitment engine #[derive(Clone, Debug, PartialEq, Eq, Serialize, Deserialize)] pub struct CommitmentEngine { _p: PhantomData, } impl CommitmentEngineTrait for CommitmentEngine { type CommitmentGens = CommitmentGens; type Commitment = Commitment; type CompressedCommitment = CompressedCommitment; fn commit(gens: &Self::CommitmentGens, v: &[G::Scalar]) -> Self::Commitment { gens.commit(v) } }