use crate::{
constants::{NUM_FE_WITHOUT_IO_FOR_CRHF, NUM_HASH_BITS},
gadgets::{
ecc::AllocatedPoint,
r1cs::{AllocatedR1CSInstance, AllocatedRelaxedR1CSInstance},
utils::{
alloc_num_equals, alloc_scalar_as_base, alloc_zero, conditionally_select_vec, le_bits_to_num,
},
},
r1cs::{R1CSInstance, RelaxedR1CSInstance},
traits::{
circuit::StepCircuit, commitment::CommitmentTrait, Engine, ROCircuitTrait, ROConstantsCircuit,
},
Commitment,
};
use bellpepper::gadgets::Assignment;
use bellpepper_core::{
boolean::{AllocatedBit, Boolean},
num::AllocatedNum,
ConstraintSystem, SynthesisError,
};
use ff::Field;
use serde::{Deserialize, Serialize};
#[derive(Debug, Clone, PartialEq, Eq, Serialize, Deserialize)]
pub struct NovaAugmentedCircuitParams {
limb_width: usize,
n_limbs: usize,
is_primary_circuit: bool, }
impl NovaAugmentedCircuitParams {
pub const fn new(limb_width: usize, n_limbs: usize, is_primary_circuit: bool) -> Self {
Self {
limb_width,
n_limbs,
is_primary_circuit,
}
}
}
#[derive(Debug, Serialize, Deserialize)]
#[serde(bound = "")]
pub struct NovaAugmentedCircuitInputs<E: Engine> {
params: E::Scalar,
i: E::Base,
z0: Vec<E::Base>,
zi: Option<Vec<E::Base>>,
U: Option<RelaxedR1CSInstance<E>>,
u: Option<R1CSInstance<E>>,
T: Option<Commitment<E>>,
}
impl<E: Engine> NovaAugmentedCircuitInputs<E> {
pub fn new(
params: E::Scalar,
i: E::Base,
z0: Vec<E::Base>,
zi: Option<Vec<E::Base>>,
U: Option<RelaxedR1CSInstance<E>>,
u: Option<R1CSInstance<E>>,
T: Option<Commitment<E>>,
) -> Self {
Self {
params,
i,
z0,
zi,
U,
u,
T,
}
}
}
pub struct NovaAugmentedCircuit<'a, E: Engine, SC: StepCircuit<E::Base>> {
params: &'a NovaAugmentedCircuitParams,
ro_consts: ROConstantsCircuit<E>,
inputs: Option<NovaAugmentedCircuitInputs<E>>,
step_circuit: &'a SC, }
impl<'a, E: Engine, SC: StepCircuit<E::Base>> NovaAugmentedCircuit<'a, E, SC> {
pub const fn new(
params: &'a NovaAugmentedCircuitParams,
inputs: Option<NovaAugmentedCircuitInputs<E>>,
step_circuit: &'a SC,
ro_consts: ROConstantsCircuit<E>,
) -> Self {
Self {
params,
inputs,
step_circuit,
ro_consts,
}
}
fn alloc_witness<CS: ConstraintSystem<<E as Engine>::Base>>(
&self,
mut cs: CS,
arity: usize,
) -> Result<
(
AllocatedNum<E::Base>,
AllocatedNum<E::Base>,
Vec<AllocatedNum<E::Base>>,
Vec<AllocatedNum<E::Base>>,
AllocatedRelaxedR1CSInstance<E>,
AllocatedR1CSInstance<E>,
AllocatedPoint<E>,
),
SynthesisError,
> {
let params = alloc_scalar_as_base::<E, _>(
cs.namespace(|| "params"),
self.inputs.as_ref().map(|inputs| inputs.params),
)?;
let i = AllocatedNum::alloc(cs.namespace(|| "i"), || Ok(self.inputs.get()?.i))?;
let z_0 = (0..arity)
.map(|i| {
AllocatedNum::alloc(cs.namespace(|| format!("z0_{i}")), || {
Ok(self.inputs.get()?.z0[i])
})
})
.collect::<Result<Vec<AllocatedNum<E::Base>>, _>>()?;
let zero = vec![E::Base::ZERO; arity];
let z_i = (0..arity)
.map(|i| {
AllocatedNum::alloc(cs.namespace(|| format!("zi_{i}")), || {
Ok(self.inputs.get()?.zi.as_ref().unwrap_or(&zero)[i])
})
})
.collect::<Result<Vec<AllocatedNum<E::Base>>, _>>()?;
let U: AllocatedRelaxedR1CSInstance<E> = AllocatedRelaxedR1CSInstance::alloc(
cs.namespace(|| "Allocate U"),
self.inputs.as_ref().and_then(|inputs| inputs.U.as_ref()),
self.params.limb_width,
self.params.n_limbs,
)?;
let u = AllocatedR1CSInstance::alloc(
cs.namespace(|| "allocate instance u to fold"),
self.inputs.as_ref().and_then(|inputs| inputs.u.as_ref()),
)?;
let T = AllocatedPoint::alloc(
cs.namespace(|| "allocate T"),
self
.inputs
.as_ref()
.and_then(|inputs| inputs.T.map(|T| T.to_coordinates())),
)?;
T.check_on_curve(cs.namespace(|| "check T on curve"))?;
Ok((params, i, z_0, z_i, U, u, T))
}
fn synthesize_base_case<CS: ConstraintSystem<<E as Engine>::Base>>(
&self,
mut cs: CS,
u: AllocatedR1CSInstance<E>,
) -> Result<AllocatedRelaxedR1CSInstance<E>, SynthesisError> {
let U_default: AllocatedRelaxedR1CSInstance<E> = if self.params.is_primary_circuit {
AllocatedRelaxedR1CSInstance::default(
cs.namespace(|| "Allocate U_default"),
self.params.limb_width,
self.params.n_limbs,
)?
} else {
AllocatedRelaxedR1CSInstance::from_r1cs_instance(
cs.namespace(|| "Allocate U_default"),
u,
self.params.limb_width,
self.params.n_limbs,
)?
};
Ok(U_default)
}
fn synthesize_non_base_case<CS: ConstraintSystem<<E as Engine>::Base>>(
&self,
mut cs: CS,
params: &AllocatedNum<E::Base>,
i: &AllocatedNum<E::Base>,
z_0: &[AllocatedNum<E::Base>],
z_i: &[AllocatedNum<E::Base>],
U: &AllocatedRelaxedR1CSInstance<E>,
u: &AllocatedR1CSInstance<E>,
T: &AllocatedPoint<E>,
arity: usize,
) -> Result<(AllocatedRelaxedR1CSInstance<E>, AllocatedBit), SynthesisError> {
let mut ro = E::ROCircuit::new(
self.ro_consts.clone(),
NUM_FE_WITHOUT_IO_FOR_CRHF + 2 * arity,
);
ro.absorb(params);
ro.absorb(i);
for e in z_0 {
ro.absorb(e);
}
for e in z_i {
ro.absorb(e);
}
U.absorb_in_ro(cs.namespace(|| "absorb U"), &mut ro)?;
let hash_bits = ro.squeeze(cs.namespace(|| "Input hash"), NUM_HASH_BITS)?;
let hash = le_bits_to_num(cs.namespace(|| "bits to hash"), &hash_bits)?;
let check_pass = alloc_num_equals(
cs.namespace(|| "check consistency of u.X[0] with H(params, U, i, z0, zi)"),
&u.X0,
&hash,
)?;
let U_fold = U.fold_with_r1cs(
cs.namespace(|| "compute fold of U and u"),
params,
u,
T,
self.ro_consts.clone(),
self.params.limb_width,
self.params.n_limbs,
)?;
Ok((U_fold, check_pass))
}
}
impl<'a, E: Engine, SC: StepCircuit<E::Base>> NovaAugmentedCircuit<'a, E, SC> {
pub fn synthesize<CS: ConstraintSystem<<E as Engine>::Base>>(
self,
cs: &mut CS,
) -> Result<Vec<AllocatedNum<E::Base>>, SynthesisError> {
let arity = self.step_circuit.arity();
let (params, i, z_0, z_i, U, u, T) =
self.alloc_witness(cs.namespace(|| "allocate the circuit witness"), arity)?;
let zero = alloc_zero(cs.namespace(|| "zero"));
let is_base_case = alloc_num_equals(cs.namespace(|| "Check if base case"), &i.clone(), &zero)?;
let Unew_base = self.synthesize_base_case(cs.namespace(|| "base case"), u.clone())?;
let (Unew_non_base, check_non_base_pass) = self.synthesize_non_base_case(
cs.namespace(|| "synthesize non base case"),
¶ms,
&i,
&z_0,
&z_i,
&U,
&u,
&T,
arity,
)?;
let should_be_false = AllocatedBit::nor(
cs.namespace(|| "check_non_base_pass nor base_case"),
&check_non_base_pass,
&is_base_case,
)?;
cs.enforce(
|| "check_non_base_pass nor base_case = false",
|lc| lc + should_be_false.get_variable(),
|lc| lc + CS::one(),
|lc| lc,
);
let Unew = Unew_base.conditionally_select(
cs.namespace(|| "compute U_new"),
&Unew_non_base,
&Boolean::from(is_base_case.clone()),
)?;
let i_new = AllocatedNum::alloc(cs.namespace(|| "i + 1"), || {
Ok(*i.get_value().get()? + E::Base::ONE)
})?;
cs.enforce(
|| "check i + 1",
|lc| lc,
|lc| lc,
|lc| lc + i_new.get_variable() - CS::one() - i.get_variable(),
);
let z_input = conditionally_select_vec(
cs.namespace(|| "select input to F"),
&z_0,
&z_i,
&Boolean::from(is_base_case),
)?;
let z_next = self
.step_circuit
.synthesize(&mut cs.namespace(|| "F"), &z_input)?;
if z_next.len() != arity {
return Err(SynthesisError::IncompatibleLengthVector(
"z_next".to_string(),
));
}
let mut ro = E::ROCircuit::new(self.ro_consts, NUM_FE_WITHOUT_IO_FOR_CRHF + 2 * arity);
ro.absorb(¶ms);
ro.absorb(&i_new);
for e in &z_0 {
ro.absorb(e);
}
for e in &z_next {
ro.absorb(e);
}
Unew.absorb_in_ro(cs.namespace(|| "absorb U_new"), &mut ro)?;
let hash_bits = ro.squeeze(cs.namespace(|| "output hash bits"), NUM_HASH_BITS)?;
let hash = le_bits_to_num(cs.namespace(|| "convert hash to num"), &hash_bits)?;
u.X1
.inputize(cs.namespace(|| "Output unmodified hash of the other circuit"))?;
hash.inputize(cs.namespace(|| "output new hash of this circuit"))?;
Ok(z_next)
}
}
#[cfg(test)]
mod tests {
use super::*;
use crate::{
bellpepper::{
r1cs::{NovaShape, NovaWitness},
solver::SatisfyingAssignment,
test_shape_cs::TestShapeCS,
},
constants::{BN_LIMB_WIDTH, BN_N_LIMBS},
gadgets::utils::scalar_as_base,
provider::{
poseidon::PoseidonConstantsCircuit,
{Bn256Engine, GrumpkinEngine}, {PallasEngine, VestaEngine},
{Secp256k1Engine, Secq256k1Engine},
},
traits::{circuit::TrivialCircuit, snark::default_ck_hint},
};
fn test_recursive_circuit_with<E1, E2>(
primary_params: &NovaAugmentedCircuitParams,
secondary_params: &NovaAugmentedCircuitParams,
ro_consts1: ROConstantsCircuit<E2>,
ro_consts2: ROConstantsCircuit<E1>,
num_constraints_primary: usize,
num_constraints_secondary: usize,
) where
E1: Engine<Base = <E2 as Engine>::Scalar>,
E2: Engine<Base = <E1 as Engine>::Scalar>,
{
let tc1 = TrivialCircuit::default();
let circuit1: NovaAugmentedCircuit<'_, E2, TrivialCircuit<<E2 as Engine>::Base>> =
NovaAugmentedCircuit::new(primary_params, None, &tc1, ro_consts1.clone());
let mut cs: TestShapeCS<E1> = TestShapeCS::new();
let _ = circuit1.synthesize(&mut cs);
let (shape1, ck1) = cs.r1cs_shape(&*default_ck_hint());
assert_eq!(cs.num_constraints(), num_constraints_primary);
let tc2 = TrivialCircuit::default();
let circuit2: NovaAugmentedCircuit<'_, E1, TrivialCircuit<<E1 as Engine>::Base>> =
NovaAugmentedCircuit::new(secondary_params, None, &tc2, ro_consts2.clone());
let mut cs: TestShapeCS<E2> = TestShapeCS::new();
let _ = circuit2.synthesize(&mut cs);
let (shape2, ck2) = cs.r1cs_shape(&*default_ck_hint());
assert_eq!(cs.num_constraints(), num_constraints_secondary);
let zero1 = <<E2 as Engine>::Base as Field>::ZERO;
let mut cs1 = SatisfyingAssignment::<E1>::new();
let inputs1: NovaAugmentedCircuitInputs<E2> = NovaAugmentedCircuitInputs::new(
scalar_as_base::<E1>(zero1), zero1,
vec![zero1],
None,
None,
None,
None,
);
let circuit1: NovaAugmentedCircuit<'_, E2, TrivialCircuit<<E2 as Engine>::Base>> =
NovaAugmentedCircuit::new(primary_params, Some(inputs1), &tc1, ro_consts1);
let _ = circuit1.synthesize(&mut cs1);
let (inst1, witness1) = cs1.r1cs_instance_and_witness(&shape1, &ck1).unwrap();
assert!(shape1.is_sat(&ck1, &inst1, &witness1).is_ok());
let zero2 = <<E1 as Engine>::Base as Field>::ZERO;
let mut cs2 = SatisfyingAssignment::<E2>::new();
let inputs2: NovaAugmentedCircuitInputs<E1> = NovaAugmentedCircuitInputs::new(
scalar_as_base::<E2>(zero2), zero2,
vec![zero2],
None,
None,
Some(inst1),
None,
);
let circuit2: NovaAugmentedCircuit<'_, E1, TrivialCircuit<<E1 as Engine>::Base>> =
NovaAugmentedCircuit::new(secondary_params, Some(inputs2), &tc2, ro_consts2);
let _ = circuit2.synthesize(&mut cs2);
let (inst2, witness2) = cs2.r1cs_instance_and_witness(&shape2, &ck2).unwrap();
assert!(shape2.is_sat(&ck2, &inst2, &witness2).is_ok());
}
#[test]
fn test_recursive_circuit_pasta() {
let params1 = NovaAugmentedCircuitParams::new(BN_LIMB_WIDTH, BN_N_LIMBS, true);
let params2 = NovaAugmentedCircuitParams::new(BN_LIMB_WIDTH, BN_N_LIMBS, false);
let ro_consts1: ROConstantsCircuit<VestaEngine> = PoseidonConstantsCircuit::default();
let ro_consts2: ROConstantsCircuit<PallasEngine> = PoseidonConstantsCircuit::default();
test_recursive_circuit_with::<PallasEngine, VestaEngine>(
¶ms1, ¶ms2, ro_consts1, ro_consts2, 9825, 10357,
);
}
#[test]
fn test_recursive_circuit_grumpkin() {
let params1 = NovaAugmentedCircuitParams::new(BN_LIMB_WIDTH, BN_N_LIMBS, true);
let params2 = NovaAugmentedCircuitParams::new(BN_LIMB_WIDTH, BN_N_LIMBS, false);
let ro_consts1: ROConstantsCircuit<GrumpkinEngine> = PoseidonConstantsCircuit::default();
let ro_consts2: ROConstantsCircuit<Bn256Engine> = PoseidonConstantsCircuit::default();
test_recursive_circuit_with::<Bn256Engine, GrumpkinEngine>(
¶ms1, ¶ms2, ro_consts1, ro_consts2, 9993, 10546,
);
}
#[test]
fn test_recursive_circuit_secp() {
let params1 = NovaAugmentedCircuitParams::new(BN_LIMB_WIDTH, BN_N_LIMBS, true);
let params2 = NovaAugmentedCircuitParams::new(BN_LIMB_WIDTH, BN_N_LIMBS, false);
let ro_consts1: ROConstantsCircuit<Secq256k1Engine> = PoseidonConstantsCircuit::default();
let ro_consts2: ROConstantsCircuit<Secp256k1Engine> = PoseidonConstantsCircuit::default();
test_recursive_circuit_with::<Secp256k1Engine, Secq256k1Engine>(
¶ms1, ¶ms2, ro_consts1, ro_consts2, 10272, 10969,
);
}
}