snarkvm-algorithms 4.6.1

Algorithms for a decentralized virtual machine
Documentation
// Copyright (c) 2019-2026 Provable Inc.
// This file is part of the snarkVM library.

// Licensed under the Apache License, Version 2.0 (the "License");
// you may not use this file except in compliance with the License.
// You may obtain a copy of the License at:

// http://www.apache.org/licenses/LICENSE-2.0

// Unless required by applicable law or agreed to in writing, software
// distributed under the License is distributed on an "AS IS" BASIS,
// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
// See the License for the specific language governing permissions and
// limitations under the License.

use crate::{
    r1cs::ConstraintSynthesizer,
    snark::varuna::{
        SNARKMode,
        ahp::{AHPError, AHPForR1CS, indexer::Circuit},
        prover,
    },
};
use snarkvm_fields::PrimeField;

use anyhow::Result;
use itertools::Itertools;
use rand::{CryptoRng, Rng};
use std::collections::BTreeMap;

use snarkvm_utilities::dev_println;

mod fifth;
mod first;
mod fourth;
mod prepare_third;
mod second;
mod third;

impl<F: PrimeField, SM: SNARKMode> AHPForR1CS<F, SM> {
    /// Initialize the AHP prover.
    pub fn init_prover<'a, C: ConstraintSynthesizer<F>, R: Rng + CryptoRng>(
        circuits_to_constraints: &BTreeMap<&'a Circuit<F, SM>, &[C]>,
        rng: &mut R,
    ) -> Result<prover::State<'a, F, SM>, AHPError> {
        let init_time = start_timer!(|| "AHP::Prover::Init");

        let mut randomizing_assignments = Vec::with_capacity(circuits_to_constraints.len());
        for constraints in circuits_to_constraints.values() {
            let mut circuit_assignments = Vec::with_capacity(constraints.len());
            for _ in 0..constraints.len() {
                if SM::ZK {
                    let a = F::rand(rng);
                    let b = F::rand(rng);
                    let c = a * b;
                    circuit_assignments.push(Some([a, b, c]));
                } else {
                    circuit_assignments.push(None);
                }
            }
            randomizing_assignments.push(circuit_assignments);
        }

        if randomizing_assignments.len() != circuits_to_constraints.len() {
            return Err(AHPError::AnyhowError(anyhow::anyhow!(
                "[prover Init] Expected {} randomizing assignments, but {} were provided.",
                circuits_to_constraints.len(),
                randomizing_assignments.len()
            )));
        }
        let indices_and_assignments = circuits_to_constraints
            .iter()
            .zip_eq(randomizing_assignments.into_iter())
            .map(|((circuit, constraints), circuit_rand_assignments)| {
                let assignments = constraints
                    .iter()
                    .zip(circuit_rand_assignments)
                    .enumerate()
                    .map(|(i, (instance, rand_assignments))| {
                        let constraint_time = start_timer!(|| format!(
                            "Generating constraints and witnesses for {:?} and index {i}",
                            circuit.id
                        ));

                        // i may not be used if the timer feature is disabled.
                        #[allow(unused_variables)]
                        let _ = i;

                        let mut pcs = prover::ConstraintSystem::new();
                        instance.generate_constraints(&mut pcs)?;
                        end_timer!(constraint_time);

                        let padding_time =
                            start_timer!(|| format!("Padding matrices for {:?} and index {i}", circuit.id));

                        SM::ZK.then(|| {
                            crate::snark::varuna::ahp::matrices::add_randomizing_variables::<_, _>(
                                &mut pcs,
                                rand_assignments,
                            )
                        });
                        crate::snark::varuna::ahp::matrices::pad_input_for_indexer_and_prover(&mut pcs)?;

                        end_timer!(padding_time);

                        let prover::ConstraintSystem {
                            public_variables: padded_public_variables,
                            private_variables,
                            num_constraints,
                            num_public_variables,
                            num_private_variables,
                            ..
                        } = pcs;

                        assert_eq!(padded_public_variables.len(), num_public_variables);
                        assert!(padded_public_variables[0].is_one());
                        assert_eq!(private_variables.len(), num_private_variables);

                        dev_println!("Number of padded public variables in Prover::Init: {num_public_variables}");
                        dev_println!("Number of private variables: {num_private_variables}");
                        dev_println!("Number of constraints: {num_constraints}");
                        dev_println!("Number of non-zero entries in A: {}", circuit.index_info.num_non_zero_a);
                        dev_println!("Number of non-zero entries in B: {}", circuit.index_info.num_non_zero_b);
                        dev_println!("Number of non-zero entries in C: {}", circuit.index_info.num_non_zero_c);

                        if circuit.index_info.num_constraints != num_constraints
                            || circuit.index_info.num_public_and_private_variables
                                != (num_public_variables + num_private_variables)
                        {
                            return Err(AHPError::InstanceDoesNotMatchIndex);
                        }

                        Self::formatted_public_input_is_admissible(&padded_public_variables)?;

                        let eval_z_a_time = start_timer!(|| format!("For {:?}, evaluating z_A_{i}", circuit.id));
                        let z_a = circuit
                            .a
                            .iter()
                            .map(|row| {
                                inner_product(&padded_public_variables, &private_variables, row, num_public_variables)
                            })
                            .collect();
                        end_timer!(eval_z_a_time);

                        let eval_z_b_time = start_timer!(|| format!("For {:?}, evaluating z_B_{i}", circuit.id));
                        let z_b = circuit
                            .b
                            .iter()
                            .map(|row| {
                                inner_product(&padded_public_variables, &private_variables, row, num_public_variables)
                            })
                            .collect();
                        end_timer!(eval_z_b_time);

                        let eval_z_c_time = start_timer!(|| format!("For {:?}, evaluating z_C_{i}", circuit.id));
                        let z_c = circuit
                            .c
                            .iter()
                            .map(|row| {
                                inner_product(&padded_public_variables, &private_variables, row, num_public_variables)
                            })
                            .collect();
                        end_timer!(eval_z_c_time);

                        Ok(prover::Assignments::<F>(padded_public_variables, private_variables, z_a, z_b, z_c))
                    })
                    .collect::<Result<Vec<prover::Assignments<F>>, AHPError>>()?;
                Ok((*circuit, assignments))
            })
            .collect::<Result<BTreeMap<&'a Circuit<F, SM>, Vec<prover::Assignments<F>>>, AHPError>>()?;

        let state = prover::State::initialize(indices_and_assignments)?;
        end_timer!(init_time);

        Ok(state)
    }
}

fn inner_product<F: PrimeField>(
    public_variables: &[F],
    private_variables: &[F],
    row: &[(F, usize)],
    num_public_variables: usize,
) -> F {
    let mut result = F::zero();

    for &(ref coefficient, i) in row {
        // Fetch the variable.
        let variable = match i < num_public_variables {
            true => public_variables[i],
            false => private_variables[i - num_public_variables],
        };

        result += if coefficient.is_one() { variable } else { variable * coefficient };
    }

    result
}

#[test]
fn check_division_by_vanishing_poly_preserve_sparseness() {
    use crate::fft::{EvaluationDomain, Evaluations as EvaluationsOnDomain};
    use snarkvm_curves::bls12_377::Fr;
    use snarkvm_fields::{Field, One, Zero};

    let domain = EvaluationDomain::new(16).unwrap();
    let small_domain = EvaluationDomain::new(4).unwrap();
    let val = Fr::one().double().double().double() - Fr::one();
    let mut evals = (0..16).map(|pow| val.pow([pow])).collect::<Vec<_>>();
    for i in 0..4 {
        evals[4 * i] = Fr::zero();
    }
    let p = EvaluationsOnDomain::from_vec_and_domain(evals, domain).interpolate();
    assert_eq!(p.degree(), 15);
    let (p_div_v, p_mod_v) = p.divide_by_vanishing_poly(small_domain).unwrap();
    assert!(p_mod_v.is_zero());
    dbg!(p_div_v.degree());
    dbg!(p_div_v.evaluate_over_domain(domain));
}