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: not started, auditors: [], date: YYYY-MM-DD }
3// external_1: { status: not started, auditors: [], date: YYYY-MM-DD }
4// external_2: { status: not started, auditors: [], date: YYYY-MM-DD }
5// =====================
6
7#pragma once
9#include "gemini.hpp"
10
47namespace bb {
48template <typename Curve>
49template <typename Transcript>
51 Fr circuit_size,
52 PolynomialBatcher& polynomial_batcher,
53 std::span<Fr> multilinear_challenge,
54 const CommitmentKey<Curve>& commitment_key,
55 const std::shared_ptr<Transcript>& transcript,
56 bool has_zk)
57{
58 // To achieve fixed proof size in Ultra and Mega, the multilinear opening challenge is be padded to a fixed size.
59 const size_t virtual_log_n = multilinear_challenge.size();
60 const size_t log_n = numeric::get_msb(static_cast<uint32_t>(circuit_size));
61
62 // Get the batching challenge
63 const Fr rho = transcript->template get_challenge<Fr>("rho");
64
65 Polynomial A_0 = polynomial_batcher.compute_batched(rho);
66
67 // Construct the d-1 Gemini foldings of A₀(X)
68 std::vector<Polynomial> fold_polynomials = compute_fold_polynomials(log_n, multilinear_challenge, A_0, has_zk);
69
70 // If virtual_log_n >= log_n, pad the fold commitments with dummy group elements [1]_1.
71 for (size_t l = 0; l < virtual_log_n - 1; l++) {
72 std::string label = "Gemini:FOLD_" + std::to_string(l + 1);
73 // When has_zk is true, we are sending commitments to 0. Seems to work, but maybe brittle.
74 transcript->send_to_verifier(label, commitment_key.commit(fold_polynomials[l]));
75 }
76 const Fr r_challenge = transcript->template get_challenge<Fr>("Gemini:r");
77
78 const bool gemini_challenge_in_small_subgroup = (has_zk) && (r_challenge.pow(Curve::SUBGROUP_SIZE) == Fr(1));
79
80 // If Gemini evaluation challenge lands in the multiplicative subgroup used by SmallSubgroupIPA protocol, the
81 // evaluations of prover polynomials at this challenge would leak witness data.
82 // TODO(https://github.com/AztecProtocol/barretenberg/issues/1194). Handle edge cases in PCS
83 if (gemini_challenge_in_small_subgroup) {
84 throw_or_abort("Gemini evaluation challenge is in the SmallSubgroup.");
85 }
86
87 // Compute polynomials A₀₊(X) = F(X) + G(X)/r and A₀₋(X) = F(X) - G(X)/r
88 auto [A_0_pos, A_0_neg] = polynomial_batcher.compute_partially_evaluated_batch_polynomials(r_challenge);
89 // Construct claims for the d + 1 univariate evaluations A₀₊(r), A₀₋(-r), and Foldₗ(−r^{2ˡ}), l = 1, ..., d-1
90 std::vector<Claim> claims = construct_univariate_opening_claims(
91 virtual_log_n, std::move(A_0_pos), std::move(A_0_neg), std::move(fold_polynomials), r_challenge);
92
93 for (size_t l = 1; l <= virtual_log_n; l++) {
94 std::string label = "Gemini:a_" + std::to_string(l);
95 transcript->send_to_verifier(label, claims[l].opening_pair.evaluation);
96 }
97
98 // If running Gemini for the Translator VM polynomials, A₀(r) = A₀₊(r) + P₊(rˢ) and A₀(-r) = A₀₋(-r) + P₋(rˢ)
99 // where s is the size of the interleaved group assumed even. The prover sends P₊(rˢ) and P₋(rˢ) to the verifier
100 // so it can reconstruct the evaluation of A₀(r) and A₀(-r) respectively
101 // TODO(https://github.com/AztecProtocol/barretenberg/issues/1282)
102 if (polynomial_batcher.has_interleaved()) {
103 auto [P_pos, P_neg] = polynomial_batcher.compute_partially_evaluated_interleaved_polynomial(r_challenge);
104 Fr r_pow = r_challenge.pow(polynomial_batcher.get_group_size());
105 Fr P_pos_eval = P_pos.evaluate(r_pow);
106 Fr P_neg_eval = P_neg.evaluate(r_pow);
107 claims.emplace_back(Claim{ std::move(P_pos), { r_pow, P_pos_eval } });
108 transcript->send_to_verifier("Gemini:P_pos", P_pos_eval);
109 claims.emplace_back(Claim{ std::move(P_neg), { r_pow, P_neg_eval } });
110 transcript->send_to_verifier("Gemini:P_neg", P_neg_eval);
111 }
112
113 return claims;
114};
115
123template <typename Curve>
125 const size_t log_n, std::span<const Fr> multilinear_challenge, const Polynomial& A_0, const bool& has_zk)
126{
127 const size_t num_threads = get_num_cpus_pow2();
128
129 const size_t virtual_log_n = multilinear_challenge.size();
130
131 constexpr size_t efficient_operations_per_thread = 64; // A guess of the number of operation for which there
132 // would be a point in sending them to a separate thread
133
134 // Reserve and allocate space for m-1 Fold polynomials, the foldings of the full batched polynomial A₀
135 std::vector<Polynomial> fold_polynomials;
136 fold_polynomials.reserve(virtual_log_n - 1);
137 for (size_t l = 0; l < log_n - 1; ++l) {
138 // size of the previous polynomial/2
139 const size_t n_l = 1 << (log_n - l - 1);
140
141 // A_l_fold = Aₗ₊₁(X) = (1-uₗ)⋅even(Aₗ)(X) + uₗ⋅odd(Aₗ)(X)
142 fold_polynomials.emplace_back(Polynomial(n_l));
143 }
144
145 // A_l = Aₗ(X) is the polynomial being folded
146 // in the first iteration, we take the batched polynomial
147 // in the next iteration, it is the previously folded one
148 auto A_l = A_0.data();
149 for (size_t l = 0; l < log_n - 1; ++l) {
150 // size of the previous polynomial/2
151 const size_t n_l = 1 << (log_n - l - 1);
152
153 // Use as many threads as it is useful so that 1 thread doesn't process 1 element, but make sure that there is
154 // at least 1
155 size_t num_used_threads = std::min(n_l / efficient_operations_per_thread, num_threads);
156 num_used_threads = num_used_threads ? num_used_threads : 1;
157 size_t chunk_size = n_l / num_used_threads;
158 size_t last_chunk_size = (n_l % chunk_size) ? (n_l % num_used_threads) : chunk_size;
159
160 // Opening point is the same for all
161 const Fr u_l = multilinear_challenge[l];
162
163 // A_l_fold = Aₗ₊₁(X) = (1-uₗ)⋅even(Aₗ)(X) + uₗ⋅odd(Aₗ)(X)
164 auto A_l_fold = fold_polynomials[l].data();
165
166 parallel_for(num_used_threads, [&](size_t i) {
167 size_t current_chunk_size = (i == (num_used_threads - 1)) ? last_chunk_size : chunk_size;
168 for (std::ptrdiff_t j = (std::ptrdiff_t)(i * chunk_size);
169 j < (std::ptrdiff_t)((i * chunk_size) + current_chunk_size);
170 j++) {
171 // fold(Aₗ)[j] = (1-uₗ)⋅even(Aₗ)[j] + uₗ⋅odd(Aₗ)[j]
172 // = (1-uₗ)⋅Aₗ[2j] + uₗ⋅Aₗ[2j+1]
173 // = Aₗ₊₁[j]
174 A_l_fold[j] = A_l[j << 1] + u_l * (A_l[(j << 1) + 1] - A_l[j << 1]);
175 }
176 });
177 // set Aₗ₊₁ = Aₗ for the next iteration
178 A_l = A_l_fold;
179 }
180
181 // Perform virtual rounds.
182 // After the first `log_n - 1` rounds, the prover's `fold` univariates stabilize. With ZK, the verifier multiplies
183 // the evaluations by 0, otherwise, when `virtual_log_n > log_n`, the prover honestly computes and sends the
184 // constant folds.
185 const auto& last = fold_polynomials.back();
186 const Fr u_last = multilinear_challenge[log_n - 1];
187 const Fr final_eval = last.at(0) + u_last * (last.at(1) - last.at(0));
188 Polynomial const_fold(1);
189 // Temporary fix: when we're running a zk proof, the verifier uses a `padding_indicator_array`. So the evals in
190 // rounds past `log_n - 1` will be ignored. Hence the prover also needs to ignore them, otherwise Shplonk will fail.
191 const_fold.at(0) = final_eval * Fr(static_cast<int>(!has_zk));
192 fold_polynomials.emplace_back(const_fold);
193
194 // FOLD_{log_n+1}, ..., FOLD_{d_v-1}
195 Fr tail = Fr(1);
196 for (size_t k = log_n; k < virtual_log_n - 1; ++k) {
197 tail *= (Fr(1) - multilinear_challenge[k]); // multiply by (1 - u_k)
198 Polynomial next_const(1);
199 next_const.at(0) = final_eval * tail * Fr(static_cast<int>(!has_zk));
200 fold_polynomials.emplace_back(next_const);
201 }
202
203 return fold_polynomials;
204};
205
227template <typename Curve>
229 const size_t log_n,
230 Polynomial&& A_0_pos,
231 Polynomial&& A_0_neg,
232 std::vector<Polynomial>&& fold_polynomials,
233 const Fr& r_challenge)
234{
235 std::vector<Claim> claims;
236
237 // Compute evaluation of partially evaluated batch polynomial (positive) A₀₊(r)
238 Fr a_0_pos = A_0_pos.evaluate(r_challenge);
239 claims.emplace_back(Claim{ std::move(A_0_pos), { r_challenge, a_0_pos } });
240 // Compute evaluation of partially evaluated batch polynomial (negative) A₀₋(-r)
241 Fr a_0_neg = A_0_neg.evaluate(-r_challenge);
242 claims.emplace_back(Claim{ std::move(A_0_neg), { -r_challenge, a_0_neg } });
243
244 // Compute univariate opening queries rₗ = r^{2ˡ} for l = 0, 1, ..., m-1
245 std::vector<Fr> r_squares = gemini::powers_of_evaluation_challenge(r_challenge, log_n);
246
247 // Each fold polynomial Aₗ has to be opened at −r^{2ˡ} and r^{2ˡ}. To avoid storing two copies of Aₗ for l = 1,...,
248 // m-1, we use a flag that is processed by ShplonkProver.
249 const bool gemini_fold = true;
250
251 // Compute the remaining m opening pairs {−r^{2ˡ}, Aₗ(−r^{2ˡ})}, l = 1, ..., m-1.
252 for (size_t l = 0; l < log_n - 1; ++l) {
253 Fr evaluation = fold_polynomials[l].evaluate(-r_squares[l + 1]);
254 claims.emplace_back(Claim{ std::move(fold_polynomials[l]), { -r_squares[l + 1], evaluation }, gemini_fold });
255 }
256
257 return claims;
258};
259
260} // namespace bb
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:126
std::pair< Polynomial, Polynomial > compute_partially_evaluated_interleaved_polynomial(const Fr &r_challenge)
Compute the partially evaluated polynomials P₊(X, r) and P₋(X, -r)
Definition gemini.hpp:261
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:173
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:229
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:106
static std::vector< Claim > prove(const Fr 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< 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:34
static constexpr size_t SUBGROUP_SIZE
Definition grumpkin.hpp:74
std::vector< Fr > powers_of_evaluation_challenge(const Fr r, const size_t num_squares)
Compute squares of folding challenge r.
Definition gemini.hpp:94
constexpr T get_msb(const T in)
Definition get_msb.hpp:47
Entry point for Barretenberg command-line interface.
Definition api.hpp:5
size_t get_num_cpus_pow2()
Definition thread.hpp:25
void parallel_for(size_t num_iterations, const std::function< void(size_t)> &func)
Definition thread.cpp:111
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)