Barretenberg
The ZK-SNARK library at the core of Aztec
Loading...
Searching...
No Matches
gemini_impl.hpp
Go to the documentation of this file.
1// === AUDIT STATUS ===
2// internal: { status: Planned, auditors: [Khashayar], commit: }
3// external_1: { status: not started, auditors: [], commit: }
4// external_2: { status: not started, auditors: [], commit: }
5// =====================
6
7#pragma once
10#include "gemini.hpp"
11
48namespace bb {
49template <typename Curve>
50template <typename Transcript>
52 size_t circuit_size,
53 PolynomialBatcher& polynomial_batcher,
54 std::span<Fr> multilinear_challenge,
55 const CommitmentKey<Curve>& commitment_key,
56 const std::shared_ptr<Transcript>& transcript,
57 bool has_zk)
58{
59 // To achieve fixed proof size in Ultra and Mega, the multilinear opening challenge is be padded to a fixed size.
60 const size_t virtual_log_n = multilinear_challenge.size();
61 const size_t log_n = numeric::get_msb(circuit_size);
62
63 // Get the batching challenge
64 const Fr rho = transcript->template get_challenge<Fr>("rho");
65
66 Polynomial A_0 = polynomial_batcher.compute_batched(rho);
67
68 // Construct the d-1 Gemini foldings of A₀(X)
69 std::vector<Polynomial> fold_polynomials = compute_fold_polynomials(log_n, multilinear_challenge, A_0, has_zk);
70
71 // If virtual_log_n >= log_n, pad the fold commitments with dummy group elements [1]_1.
72 for (size_t l = 0; l < virtual_log_n - 1; l++) {
73 std::string label = "Gemini:FOLD_" + std::to_string(l + 1);
74 // When has_zk is true, we are sending commitments to 0. Seems to work, but maybe brittle.
75 transcript->send_to_verifier(label, commitment_key.commit(fold_polynomials[l]));
76 }
77 const Fr r_challenge = transcript->template get_challenge<Fr>("Gemini:r");
78
79 const bool gemini_challenge_in_small_subgroup = (has_zk) && (r_challenge.pow(Curve::SUBGROUP_SIZE) == Fr(1));
80
81 // If Gemini evaluation challenge lands in the multiplicative subgroup used by SmallSubgroupIPA protocol, the
82 // evaluations of prover polynomials at this challenge would leak witness data.
83 // TODO(https://github.com/AztecProtocol/barretenberg/issues/1194). Handle edge cases in PCS
84 if (gemini_challenge_in_small_subgroup) {
85 throw_or_abort("Gemini evaluation challenge is in the SmallSubgroup.");
86 }
87
88 // Compute polynomials A₀₊(X) = F(X) + G(X)/r and A₀₋(X) = F(X) - G(X)/r
89 auto [A_0_pos, A_0_neg] = polynomial_batcher.compute_partially_evaluated_batch_polynomials(r_challenge);
90 // Construct claims for the d + 1 univariate evaluations A₀₊(r), A₀₋(-r), and Foldₗ(−r^{2ˡ}), l = 1, ..., d-1
91 std::vector<Claim> claims = construct_univariate_opening_claims(
92 virtual_log_n, std::move(A_0_pos), std::move(A_0_neg), std::move(fold_polynomials), r_challenge);
93
94 for (size_t l = 1; l <= virtual_log_n; l++) {
95 std::string label = "Gemini:a_" + std::to_string(l);
96 transcript->send_to_verifier(label, claims[l].opening_pair.evaluation);
97 }
98
99 return claims;
100};
101
109template <typename Curve>
111 const size_t log_n, std::span<const Fr> multilinear_challenge, const Polynomial& A_0, const bool& has_zk)
112{
113 BB_BENCH_NAME("Gemini::compute_fold_polynomials");
114 const size_t virtual_log_n = multilinear_challenge.size();
115
116 // Cost per iteration: 1 subtraction + 1 multiplication + 1 addition
117 constexpr size_t fold_iteration_cost =
119
120 // Reserve and allocate space for m-1 Fold polynomials, the foldings of the full batched polynomial A₀
121 std::vector<Polynomial> fold_polynomials;
122 fold_polynomials.reserve(virtual_log_n - 1);
123 for (size_t l = 0; l < log_n - 1; ++l) {
124 // size of the previous polynomial/2
125 const size_t n_l = 1 << (log_n - l - 1);
126
127 // A_l_fold = Aₗ₊₁(X) = (1-uₗ)⋅even(Aₗ)(X) + uₗ⋅odd(Aₗ)(X)
128 fold_polynomials.emplace_back(Polynomial(n_l));
129 }
130
131 // A_l = Aₗ(X) is the polynomial being folded
132 // in the first iteration, we take the batched polynomial
133 // in the next iteration, it is the previously folded one
134 auto A_l = A_0.data();
135 for (size_t l = 0; l < log_n - 1; ++l) {
136 // size of the previous polynomial/2
137 const size_t n_l = 1 << (log_n - l - 1);
138
139 // Opening point is the same for all
140 const Fr u_l = multilinear_challenge[l];
141
142 // A_l_fold = Aₗ₊₁(X) = (1-uₗ)⋅even(Aₗ)(X) + uₗ⋅odd(Aₗ)(X)
143 auto A_l_fold = fold_polynomials[l].data();
144
146 n_l,
147 [&](size_t j) {
148 // fold(Aₗ)[j] = (1-uₗ)⋅even(Aₗ)[j] + uₗ⋅odd(Aₗ)[j]
149 // = (1-uₗ)⋅Aₗ[2j] + uₗ⋅Aₗ[2j+1]
150 // = Aₗ₊₁[j]
151 A_l_fold[j] = A_l[j << 1] + u_l * (A_l[(j << 1) + 1] - A_l[j << 1]);
152 },
153 fold_iteration_cost);
154 // set Aₗ₊₁ = Aₗ for the next iteration
155 A_l = A_l_fold;
156 }
157
158 // Perform virtual rounds.
159 // After the first `log_n - 1` rounds, the prover's `fold` univariates stabilize. With ZK, the verifier multiplies
160 // the evaluations by 0, otherwise, when `virtual_log_n > log_n`, the prover honestly computes and sends the
161 // constant folds.
162 const auto& last = fold_polynomials.back();
163 const Fr u_last = multilinear_challenge[log_n - 1];
164 const Fr final_eval = last.at(0) + u_last * (last.at(1) - last.at(0));
165 Polynomial const_fold(1);
166 // Temporary fix: when we're running a zk proof, the verifier uses a `padding_indicator_array`. So the evals in
167 // rounds past `log_n - 1` will be ignored. Hence the prover also needs to ignore them, otherwise Shplonk will fail.
168 const_fold.at(0) = final_eval * Fr(static_cast<int>(!has_zk));
169 fold_polynomials.emplace_back(const_fold);
170
171 // FOLD_{log_n+1}, ..., FOLD_{d_v-1}
172 Fr tail = Fr(1);
173 for (size_t k = log_n; k < virtual_log_n - 1; ++k) {
174 tail *= (Fr(1) - multilinear_challenge[k]); // multiply by (1 - u_k)
175 Polynomial next_const(1);
176 next_const.at(0) = final_eval * tail * Fr(static_cast<int>(!has_zk));
177 fold_polynomials.emplace_back(next_const);
178 }
179
180 return fold_polynomials;
181};
182
204template <typename Curve>
206 const size_t log_n,
207 Polynomial&& A_0_pos,
208 Polynomial&& A_0_neg,
209 std::vector<Polynomial>&& fold_polynomials,
210 const Fr& r_challenge)
211{
212 std::vector<Claim> claims;
213
214 // Compute evaluation of partially evaluated batch polynomial (positive) A₀₊(r)
215 Fr a_0_pos = A_0_pos.evaluate(r_challenge);
216 claims.emplace_back(Claim{ std::move(A_0_pos), { r_challenge, a_0_pos } });
217 // Compute evaluation of partially evaluated batch polynomial (negative) A₀₋(-r)
218 Fr a_0_neg = A_0_neg.evaluate(-r_challenge);
219 claims.emplace_back(Claim{ std::move(A_0_neg), { -r_challenge, a_0_neg } });
220
221 // Compute univariate opening queries rₗ = r^{2ˡ} for l = 0, 1, ..., m-1
222 std::vector<Fr> r_squares = gemini::powers_of_evaluation_challenge(r_challenge, log_n);
223
224 // Each fold polynomial Aₗ has to be opened at −r^{2ˡ} and r^{2ˡ}. To avoid storing two copies of Aₗ for l = 1,...,
225 // m-1, we use a flag that is processed by ShplonkProver.
226 const bool gemini_fold = true;
227
228 // Compute the remaining m opening pairs {−r^{2ˡ}, Aₗ(−r^{2ˡ})}, l = 1, ..., m-1.
229 for (size_t l = 0; l < log_n - 1; ++l) {
230 Fr evaluation = fold_polynomials[l].evaluate(-r_squares[l + 1]);
231 claims.emplace_back(Claim{ std::move(fold_polynomials[l]), { -r_squares[l + 1], evaluation }, gemini_fold });
232 }
233
234 return claims;
235};
236
237} // namespace bb
#define BB_BENCH_NAME(name)
Definition bb_bench.hpp:225
CommitmentKey object over a pairing group 𝔾₁.
Commitment commit(PolynomialSpan< const Fr > polynomial) const
Uses the ProverSRS to create a commitment to p(X)
Class responsible for computation of the batched multilinear polynomials required by the Gemini proto...
Definition gemini.hpp:125
Polynomial compute_batched(const Fr &challenge)
Compute batched polynomial A₀ = F + G/X as the linear combination of all polynomials to be opened,...
Definition gemini.hpp:159
std::pair< Polynomial, Polynomial > compute_partially_evaluated_batch_polynomials(const Fr &r_challenge)
Compute partially evaluated batched polynomials A₀(X, r) = A₀₊ = F + G/r, A₀(X, -r) = A₀₋ = F - G/r.
Definition gemini.hpp:194
static std::vector< Claim > prove(size_t circuit_size, PolynomialBatcher &polynomial_batcher, std::span< Fr > multilinear_challenge, const CommitmentKey< Curve > &commitment_key, const std::shared_ptr< Transcript > &transcript, bool has_zk=false)
static std::vector< Claim > construct_univariate_opening_claims(const size_t log_n, Polynomial &&A_0_pos, Polynomial &&A_0_neg, std::vector< Polynomial > &&fold_polynomials, const Fr &r_challenge)
Computes/aggragates d+1 univariate polynomial opening claims of the form {polynomial,...
typename Curve::ScalarField Fr
Definition gemini.hpp:105
static std::vector< Polynomial > compute_fold_polynomials(const size_t log_n, std::span< const Fr > multilinear_challenge, const Polynomial &A_0, const bool &has_zk=false)
Computes d-1 fold polynomials Fold_i, i = 1, ..., d-1.
Structured polynomial class that represents the coefficients 'a' of a_0 + a_1 x .....
Fr & at(size_t index)
Our mutable accessor, unlike operator[]. We abuse precedent a bit to differentiate at() and operator[...
Polynomial p and an opening pair (r,v) such that p(r) = v.
Definition claim.hpp:36
static constexpr size_t SUBGROUP_SIZE
Definition grumpkin.hpp:73
std::vector< Fr > powers_of_evaluation_challenge(const Fr &r, const size_t num_squares)
Compute squares of folding challenge r.
Definition gemini.hpp:93
constexpr T get_msb(const T in)
Definition get_msb.hpp:49
constexpr size_t FF_ADDITION_COST
Definition thread.hpp:132
constexpr size_t FF_MULTIPLICATION_COST
Definition thread.hpp:134
Entry point for Barretenberg command-line interface.
Definition api.hpp:5
void parallel_for_heuristic(size_t num_points, const std::function< void(size_t, size_t, size_t)> &func, size_t heuristic_cost)
Split a loop into several loops running in parallel based on operations in 1 iteration.
Definition thread.cpp:171
constexpr decltype(auto) get(::tuplet::tuple< T... > &&t) noexcept
Definition tuple.hpp:13
std::string to_string(bb::avm2::ValueTag tag)
Curve::ScalarField Fr
void throw_or_abort(std::string const &err)