use crate::field::extension_field::target::ExtensionTarget; use crate::field::extension_field::Extendable; use crate::field::field_types::{Field, RichField}; use crate::fri::commitment::SALT_SIZE; use crate::iop::target::Target; use crate::plonk::circuit_builder::CircuitBuilder; use crate::util::reducing::ReducingFactorTarget; /// Holds the Merkle tree index and blinding flag of a set of polynomials used in FRI. #[derive(Debug, Copy, Clone)] pub struct PolynomialsIndexBlinding { pub(crate) index: usize, pub(crate) blinding: bool, } impl PolynomialsIndexBlinding { pub fn salt_size(&self, zero_knowledge: bool) -> usize { if zero_knowledge & self.blinding { SALT_SIZE } else { 0 } } } /// Holds the indices and blinding flags of the Plonk polynomials. pub struct PlonkPolynomials; impl PlonkPolynomials { pub const CONSTANTS_SIGMAS: PolynomialsIndexBlinding = PolynomialsIndexBlinding { index: 0, blinding: false, }; pub const WIRES: PolynomialsIndexBlinding = PolynomialsIndexBlinding { index: 1, blinding: true, }; pub const ZS_PARTIAL_PRODUCTS: PolynomialsIndexBlinding = PolynomialsIndexBlinding { index: 2, blinding: true, }; pub const QUOTIENT: PolynomialsIndexBlinding = PolynomialsIndexBlinding { index: 3, blinding: true, }; #[cfg(test)] pub fn polynomials(i: usize) -> PolynomialsIndexBlinding { match i { 0 => Self::CONSTANTS_SIGMAS, 1 => Self::WIRES, 2 => Self::ZS_PARTIAL_PRODUCTS, 3 => Self::QUOTIENT, _ => panic!("There are only 4 sets of polynomials in Plonk."), } } } /// Evaluate the polynomial which vanishes on any multiplicative subgroup of a given order `n`. pub(crate) fn eval_zero_poly(n: usize, x: F) -> F { // Z(x) = x^n - 1 x.exp_u64(n as u64) - F::ONE } /// Precomputations of the evaluation of `Z_H(X) = X^n - 1` on a coset `gK` with `H <= K`. pub(crate) struct ZeroPolyOnCoset { /// `n = |H|`. n: F, /// `rate = |K|/|H|`. rate: usize, /// Holds `g^n * (w^n)^i - 1 = g^n * v^i - 1` for `i in 0..rate`, with `w` a generator of `K` and `v` a /// `rate`-primitive root of unity. evals: Vec, /// Holds the multiplicative inverses of `evals`. inverses: Vec, } impl ZeroPolyOnCoset { pub fn new(n_log: usize, rate_bits: usize) -> Self { let g_pow_n = F::coset_shift().exp_power_of_2(n_log); let evals = F::two_adic_subgroup(rate_bits) .into_iter() .map(|x| g_pow_n * x - F::ONE) .collect::>(); let inverses = F::batch_multiplicative_inverse(&evals); Self { n: F::from_canonical_usize(1 << n_log), rate: 1 << rate_bits, evals, inverses, } } /// Returns `Z_H(g * w^i)`. pub fn eval(&self, i: usize) -> F { self.evals[i % self.rate] } /// Returns `1 / Z_H(g * w^i)`. pub fn eval_inverse(&self, i: usize) -> F { self.inverses[i % self.rate] } /// Returns `L_1(x) = Z_H(x)/(n * (x - 1))` with `x = w^i`. pub fn eval_l1(&self, i: usize, x: F) -> F { // Could also precompute the inverses using Montgomery. self.eval(i) * (self.n * (x - F::ONE)).inverse() } } /// Evaluate the Lagrange basis `L_1` with `L_1(1) = 1`, and `L_1(x) = 0` for other members of an /// order `n` multiplicative subgroup. pub(crate) fn eval_l_1(n: usize, x: F) -> F { if x.is_one() { // The code below would divide by zero, since we have (x - 1) in both the numerator and // denominator. return F::ONE; } // L_1(x) = (x^n - 1) / (n * (x - 1)) // = Z(x) / (n * (x - 1)) eval_zero_poly(n, x) / (F::from_canonical_usize(n) * (x - F::ONE)) } /// Evaluates the Lagrange basis L_1(x), which has L_1(1) = 1 and vanishes at all other points in /// the order-`n` subgroup. /// /// Assumes `x != 1`; if `x` could be 1 then this is unsound. pub(crate) fn eval_l_1_recursively, const D: usize>( builder: &mut CircuitBuilder, n: usize, x: ExtensionTarget, x_pow_n: ExtensionTarget, ) -> ExtensionTarget { // L_1(x) = (x^n - 1) / (n * (x - 1)) // = Z(x) / (n * (x - 1)) let one = builder.one_extension(); let neg_one = builder.neg_one(); let neg_one = builder.convert_to_ext(neg_one); let eval_zero_poly = builder.sub_extension(x_pow_n, one); let denominator = builder.arithmetic_extension( F::from_canonical_usize(n), F::from_canonical_usize(n), x, one, neg_one, ); builder.div_extension(eval_zero_poly, denominator) } /// For each alpha in alphas, compute a reduction of the given terms using powers of alpha. pub(crate) fn reduce_with_powers_multi(terms: &[F], alphas: &[F]) -> Vec { alphas .iter() .map(|&alpha| reduce_with_powers(terms, alpha)) .collect() } pub(crate) fn reduce_with_powers(terms: &[F], alpha: F) -> F { let mut sum = F::ZERO; for &term in terms.iter().rev() { sum = sum * alpha + term; } sum } pub(crate) fn reduce_with_powers_ext_recursive, const D: usize>( builder: &mut CircuitBuilder, terms: &[ExtensionTarget], alpha: Target, ) -> ExtensionTarget { let alpha = builder.convert_to_ext(alpha); let mut alpha = ReducingFactorTarget::new(alpha); alpha.reduce(terms, builder) }