use itertools::Itertools; use plonky2::hash::hash_types::{HashOut, HashOutTarget, NUM_HASH_OUT_ELTS, RichField}; use plonky2::iop::witness::{PartialWitness, WitnessWrite}; use plonky2_field::extension::Extendable; use plonky2_poseidon2::poseidon2_hash::poseidon2::Poseidon2; use plonky2::iop::target::{BoolTarget, Target}; use plonky2::plonk::circuit_builder::CircuitBuilder; use crate::Result; use crate::error::CircuitError; // --------- helper functions --------- /// computes the `last_index` (the binary decomposition of `inp-1`) and the `mask_bits` pub fn ceiling_log2< F: RichField + Extendable + Poseidon2, const D: usize, >( builder: &mut CircuitBuilder, inp: Target, n: usize, )-> (Vec, Vec){ let one = builder.one(); let last_index = builder.sub(inp, one.clone()); let last_bits = builder.split_le(last_index,n); let mut aux: Vec = vec![builder.constant_bool(false); n + 1]; aux[n] = builder.constant_bool(true); let mut mask: Vec = vec![builder.constant_bool(false); n + 1]; for i in (0..n).rev() { // Compute the inverted last_bit and then AND let diff_bool = builder.not(last_bits[i]); aux[i] = builder.and(aux[i+1], diff_bool); // mask is simply the negation mask[i] = builder.not(aux[i]); } (last_bits, mask) } /// assign a vec of bool values to a vec of BoolTargets pub fn assign_bool_targets< F: RichField + Extendable + Poseidon2, const D: usize, >( pw: &mut PartialWitness, bool_targets: &Vec, bools: Vec, ) -> Result<()>{ if bools.len() > bool_targets.len() { return Err(CircuitError::AssignmentLengthMismatch ( bool_targets.len(), bools.len(), ) ); } for (i, bit) in bools.iter().enumerate() { pw.set_bool_target(bool_targets[i], *bit) .map_err(|e| CircuitError::ArrayBoolTargetAssignmentError(i, e.to_string()), )?; } Ok(()) } /// assign a vec of field elems to hash out target elements /// TODO: change to HashOut pub fn assign_hash_out_targets< F: RichField + Extendable + Poseidon2, const D: usize, >( pw: &mut PartialWitness, hash_out_elements_targets: &HashOutTarget, hash_out_elements: &HashOut, ) -> Result<()>{ // Assign each field element to its corresponding target for (j, (&target, &element)) in hash_out_elements_targets.elements.iter().zip(hash_out_elements.elements.iter()).enumerate() { pw.set_target(target, element).map_err(|e| { CircuitError::ArrayTargetAssignmentError(j, e.to_string()) })?; } Ok(()) } /// helper fn to multiply a HashOutTarget by a Target pub fn mul_hash_out_target< F: RichField + Extendable + Poseidon2, const D: usize, >(builder: &mut CircuitBuilder, t: &Target, hash_target: &mut HashOutTarget) -> HashOutTarget { let mut mul_elements = vec![]; for i in 0..NUM_HASH_OUT_ELTS { mul_elements.push(builder.mul(hash_target.elements[i], *t)); } HashOutTarget::from_vec(mul_elements) } /// helper fn to add AND assign a HashOutTarget (hot) to a mutable HashOutTarget (mut_hot) pub fn add_assign_hash_out_target< F: RichField + Extendable + Poseidon2, const D: usize, >(builder: &mut CircuitBuilder, mut_hot: &mut HashOutTarget, hot: &HashOutTarget) { for i in 0..NUM_HASH_OUT_ELTS { mut_hot.elements[i] = builder.add(mut_hot.elements[i], hot.elements[i]); } } /// select hash helper method /// Computes `if b { h0 } else { h1 }`. pub fn select_hash< F: RichField + Extendable + Poseidon2, const D: usize, >( builder: &mut CircuitBuilder, b: BoolTarget, h0: HashOutTarget, h1: HashOutTarget, ) -> HashOutTarget { HashOutTarget { elements: core::array::from_fn(|i| builder.select(b, h0.elements[i], h1.elements[i])), } } /// Converts a Vec into a fixed-size array [T; N], returning an error if the lengths don't match. pub fn vec_to_array(vec: Vec) -> Result<[T; N]> { vec.try_into().map_err(|v: Vec| CircuitError::ArrayLengthMismatchError(format!( "Expected exactly {} elements, got {}", N, v.len() ))) } /// Computes `if b { v0 } else { v1 }`. pub fn select_vec< F: RichField + Extendable + Poseidon2, const D: usize, >(builder: &mut CircuitBuilder, b: BoolTarget, v0: &[Target], v1: &[Target]) -> Vec { v0.iter() .zip_eq(v1) .map(|(t0, t1)| builder.select(b, *t0, *t1)) .collect() }