Barretenberg
The ZK-SNARK library at the core of Aztec
Loading...
Searching...
No Matches
batched_honk_translator_prover.cpp
Go to the documentation of this file.
2
10
11// Short-monomial translator relation definitions: the joint sumcheck round (TransProverRound) is templated on
12// TranslatorShortMonomialFlavor, so this TU instantiates the short relations' prover-side accumulate. The short
13// relations are otherwise header-only (no explicit instantiation into librelations), so include the _impl here.
20
21namespace bb {
22
25 std::shared_ptr<Transcript> transcript)
26 : mega_zk_inst(std::move(mega_zk_instance))
27 , mega_zk_vk(std::move(mega_zk_vk))
28 , transcript(std::move(transcript))
29{}
30
38{
39 BB_BENCH_NAME("BatchedHonkTranslatorProver::execute_mega_zk_oink");
41 oink_prover.prove(/*emit_alpha=*/false);
42}
43
60
79{
80 BB_BENCH_NAME("BatchedHonkTranslatorProver::execute_joint_sumcheck_rounds");
81 // Draw joint alpha after all pre-sumcheck commitments from both circuits.
82 const FF alpha = transcript->template get_challenge<FF>("Sumcheck:alpha");
83
84 // Draw joint gate challenges (17 total).
85 std::vector<FF> gate_challenges =
86 transcript->template get_dyadic_powers_of_challenge<FF>("Sumcheck:gate_challenge", JOINT_LOG_N);
87
88 // Compute α^{K_H}: offset for translator subrelation separators.
89 FF alpha_power_KH = FF(1);
90 for (size_t i = 0; i < MegaZKFlavor::NUM_SUBRELATIONS; i++) {
91 alpha_power_KH *= alpha;
92 }
93
94 // Subrelation separator arrays (powers of alpha starting at alpha^1).
95 const MegaZKSubrelationSeparators mega_zk_alphas =
97 const TransSubrelationSeparators translator_alphas =
99
100 // Derive MegaZK circuit log_circuit_size from the proving instance.
101 const size_t mega_zk_log_n = mega_zk_inst->log_dyadic_size();
102 BB_ASSERT(mega_zk_log_n <= JOINT_LOG_N);
103
104 // Joint ZK data: single Libra masking for all 17 rounds.
105 constexpr size_t log_subgroup_size = static_cast<size_t>(numeric::get_msb(Curve::SUBGROUP_SIZE));
106 MegaZKCommitmentKey small_ck(1 << (log_subgroup_size + 1));
108
109 // Single gate separator for both circuits: beta_products has size 2^JOINT_LOG_N which covers
110 // both the MegaZK real rounds (2^mega_zk_log_n) and translator rounds (2^JOINT_LOG_N).
111 GateSeparatorPolynomial<FF> gate_sep(gate_challenges, JOINT_LOG_N);
112
113 // Round helper objects.
114 MegaZKProverRound mega_zk_round(static_cast<size_t>(1) << mega_zk_log_n);
115 TransProverRound translator_round(static_cast<size_t>(1) << JOINT_LOG_N);
116
117 // Row disabling polynomial for the MegaZK circuit.
118 // (TranslatorFlavor does not use UseRowDisablingPolynomial.)
120
121 auto& mega_zk_polys = mega_zk_inst->polynomials;
122 auto& mega_zk_params = mega_zk_inst->relation_parameters;
123 auto& translator_polys = translator_key->proving_key->polynomials;
124
125 // Allocate partially evaluated polynomial tables (populated by the first partially_evaluate call).
126 MegaZKPartialEvals mega_zk_partial(mega_zk_polys, static_cast<size_t>(1) << mega_zk_log_n);
127 TransPartialEvals translator_partial(translator_polys, static_cast<size_t>(1) << JOINT_LOG_N);
128
129 // Type aliases for static partial-evaluation helpers from SumcheckProver.
130 using MegaZKSumcheck = SumcheckProver<MegaZKFlavor>;
131 using TransSumcheck = SumcheckProver<TranslatorFlavor>;
132
134
136
137 // Use committed sumcheck infrastructure: commits to round univariates and stores them for Shplemini.
138 static constexpr bool UseCommittedSumcheck = true;
140
141 auto send_round = [&](size_t round_idx) -> FF {
143 handler.process_round_univariate(round_idx, U_joint);
144 FF u = transcript->template get_challenge<FF>("Sumcheck:u_" + std::to_string(round_idx));
145 joint_challenge.emplace_back(u);
146 return u;
147 };
148
149 // Per-round helper: update ZK data, gate separators, translator round size, and optionally send
150 // translator minicircuit evaluations.
151 auto update_round_state = [&](size_t round_idx, const FF& u) {
152 if (round_idx == TranslatorFlavor::LOG_MINI_CIRCUIT_SIZE - 1) {
153 transcript->send_to_verifier("Sumcheck:minicircuit_evaluations",
155 }
157 gate_sep.partially_evaluate(u);
158 translator_round.advance_round();
159 };
160
161 // Per-round helper: compute U_joint = U_MZK + α^{K_H}·U_translator from given polynomial
162 // sources, add Libra masking, send to verifier, and return the round challenge.
163 // hpolys/tpolys are the full tables on round 0, the partial-eval tables on subsequent rounds.
164 auto do_round = [&](auto& hpolys, auto& tpolys, size_t round_idx) -> FF {
166
167 {
168 BB_BENCH_NAME("joint_sumcheck/hiding_kernel");
170 {
171 BB_BENCH_NAME("joint_sumcheck/hiding_kernel/compute_univariate");
172 U_H = mega_zk_round.compute_univariate(hpolys, mega_zk_params, gate_sep, mega_zk_alphas);
173 }
174 {
175 BB_BENCH_NAME("joint_sumcheck/hiding_kernel/disabled_contribution");
176 U_H += mega_zk_round.compute_offset_area_contribution(
177 hpolys, mega_zk_params, gate_sep, mega_zk_alphas, rdp);
178 }
179 U_joint += U_H;
180 }
181
182 {
183 BB_BENCH_NAME("joint_sumcheck/translator");
185 {
186 BB_BENCH_NAME("joint_sumcheck/translator/compute_univariate");
187 U_T = translator_round.compute_univariate(
188 tpolys, translator_relation_parameters, gate_sep, translator_alphas);
189 }
190 for (auto& eval : U_T.evaluations) {
191 eval *= alpha_power_KH;
192 }
193 U_joint += U_T;
194 }
195
196 return send_round(round_idx);
197 };
198
199 // ==================== Round 0: bootstraps mega_zk_partial and translator_partial ====================
200 // PartiallyEvaluatedMultivariates only allocates output buffers; values are populated here.
201 {
202 const FF u = do_round(mega_zk_polys, translator_polys, 0);
203 {
204 BB_BENCH_NAME("joint_sumcheck/hiding_kernel");
205 {
206 BB_BENCH_NAME("joint_sumcheck/hiding_kernel/partially_evaluate");
207 MegaZKSumcheck::partially_evaluate(mega_zk_polys, mega_zk_partial, u);
208 }
209 }
210 {
211 BB_BENCH_NAME("joint_sumcheck/translator");
212 {
213 BB_BENCH_NAME("joint_sumcheck/translator/partially_evaluate");
214 TransSumcheck::partially_evaluate(translator_polys, translator_partial, u);
215 }
216 }
217 rdp.update_evaluations(u, 0);
218 mega_zk_round.advance_round();
219 mega_zk_round.excluded_head_size = 2; // After round 0, disabled zone collapses to 1 edge pair
220 update_round_state(0, u);
221 }
222
223 // ==================== Real rounds 1..mega_zk_log_n-1 ====================
224 for (size_t round_idx = 1; round_idx < mega_zk_log_n; round_idx++) {
225 const FF u = do_round(mega_zk_partial, translator_partial, round_idx);
226 {
227 BB_BENCH_NAME("joint_sumcheck/hiding_kernel");
228 {
229 BB_BENCH_NAME("joint_sumcheck/hiding_kernel/partially_evaluate_in_place");
230 MegaZKSumcheck::partially_evaluate_in_place(mega_zk_partial, u);
231 }
232 }
233 {
234 BB_BENCH_NAME("joint_sumcheck/translator");
235 {
236 BB_BENCH_NAME("joint_sumcheck/translator/partially_evaluate_in_place");
237 TransSumcheck::partially_evaluate_in_place(translator_partial, u);
238 }
239 }
240 rdp.update_evaluations(u, round_idx);
241 mega_zk_round.advance_round();
242 update_round_state(round_idx, u);
243 }
244
245 // ==================== Virtual rounds mega_zk_log_n..JOINT_LOG_N-1 ====================
246 // MegaZK contributes a virtual (zero-extended) univariate with RDP factor; translator contributes a real round.
247 for (size_t round_idx = mega_zk_log_n; round_idx < JOINT_LOG_N; round_idx++) {
249
250 {
251 BB_BENCH_NAME("joint_sumcheck/hiding_kernel");
252 {
253 BB_BENCH_NAME("joint_sumcheck/hiding_kernel/virtual_univariate");
254 U_joint += MegaZKSumcheck::compute_virtual_round_univariate(
255 mega_zk_round, mega_zk_partial, mega_zk_params, gate_sep, mega_zk_alphas, rdp);
256 }
257 }
258
259 {
260 BB_BENCH_NAME("joint_sumcheck/translator");
262 {
263 BB_BENCH_NAME("joint_sumcheck/translator/compute_univariate");
264 U_T = translator_round.compute_univariate(
265 translator_partial, translator_relation_parameters, gate_sep, translator_alphas);
266 }
267 for (auto& eval : U_T.evaluations) {
268 eval *= alpha_power_KH;
269 }
270 U_joint += U_T;
271 }
272
273 // send_round adds libra masking, sends univariate, and returns the challenge
274 const FF u = send_round(round_idx);
275
276 {
277 BB_BENCH_NAME("joint_sumcheck/hiding_kernel");
278 {
279 BB_BENCH_NAME("joint_sumcheck/hiding_kernel/fold_for_zero_extension");
280 MegaZKSumcheck::fold_for_zero_extension(mega_zk_partial, u);
281 }
282 }
283 {
284 BB_BENCH_NAME("joint_sumcheck/translator");
285 {
286 BB_BENCH_NAME("joint_sumcheck/translator/partially_evaluate_in_place");
287 TransSumcheck::partially_evaluate_in_place(translator_partial, u);
288 }
289 }
290 rdp.update_evaluations(u, round_idx);
291 update_round_state(round_idx, u);
292 }
293
294 handler.finalize_last_round(JOINT_LOG_N, U_joint, joint_challenge.back());
295 round_univariates_list = std::move(handler.round_univariates);
296 round_evaluations_list = std::move(handler.round_evaluations);
297
298 // Extract and send MegaZK evaluations after all rounds — full N-variable evaluations.
299 for (auto [eval, poly] : zip_view(mega_zk_claimed_evals.get_all(), mega_zk_partial.get_all())) {
300 eval = poly[0];
301 }
302 transcript->send_to_verifier("Sumcheck:evaluations", mega_zk_claimed_evals.get_all());
303
304 // Extract and send translator evaluations after all rounds.
305 for (auto [eval, poly] : zip_view(trans_claimed_evals.get_all(), translator_partial.get_all())) {
306 eval = poly[0];
307 }
308 transcript->send_to_verifier("Sumcheck:evaluations_translator",
310
311 // Compute and send the claimed Libra evaluation (covers all JOINT_LOG_N rounds).
313 for (const auto& libra_eval : zk_sumcheck_data.libra_evaluations) {
314 claimed_libra_evaluation += libra_eval;
315 }
316 transcript->send_to_verifier("Libra:claimed_evaluation", claimed_libra_evaluation);
317}
318
328{
329 BB_BENCH_NAME("BatchedHonkTranslatorProver::execute_joint_pcs");
331 using PolynomialBatcher = GeminiProver_<Curve>::PolynomialBatcher;
332 using SmallSubgroupIPA = SmallSubgroupIPAProver<MegaZKFlavor>;
333
334 // Use the translator's commitment key (sized to 2^17 = joint_circuit_size) for all PCS work.
335 // The translator key is initialised by TranslatorProver in execute_translator_oink().
336 auto& ck = translator_key->proving_key->commitment_key;
337
338 // Prove the small-subgroup IPA opening for the joint Libra polynomial.
339 SmallSubgroupIPA small_subgroup_ipa(zk_sumcheck_data, joint_challenge, claimed_libra_evaluation, transcript, ck);
340 small_subgroup_ipa.prove();
341
342 // Build joint PolynomialBatcher at joint_circuit_size = 2^17.
343 // max_end_index covers hiding (2^16) and translator (2^17) polynomials; use the larger.
344 const size_t joint_circuit_size = static_cast<size_t>(1) << JOINT_LOG_N;
345 const size_t mega_zk_max_end = mega_zk_inst->polynomials.max_end_index();
346 const size_t trans_max_end = translator_key->proving_key->circuit_size; // translator polys fill 2^17
347 const size_t max_end_index = std::max(mega_zk_max_end, trans_max_end);
348
349 PolynomialBatcher polynomial_batcher(joint_circuit_size, max_end_index);
350
351 // Combine unshifted polynomials: translator first (its masking poly at position 0 for Shplemini offset=2),
352 // then MegaZK (no masking poly — translator provides the joint masking poly).
353 auto trans_unshifted = translator_key->proving_key->polynomials.get_pcs_unshifted();
354 auto mega_zk_unshifted = mega_zk_inst->polynomials.get_unshifted();
355 auto joint_unshifted = concatenate(trans_unshifted, mega_zk_unshifted);
356 polynomial_batcher.set_unshifted(joint_unshifted);
357
358 // Combine shifted polynomials: MegaZK first, then translator.
359 auto mega_zk_shifted = mega_zk_inst->polynomials.get_to_be_shifted();
360 auto trans_shifted = translator_key->proving_key->polynomials.get_pcs_to_be_shifted();
361 auto joint_shifted = concatenate(mega_zk_shifted, trans_shifted);
362 polynomial_batcher.set_to_be_shifted_by_one(joint_shifted);
363
364 const OpeningClaim prover_opening_claim =
365 ShpleminiProver_<Curve>::prove(joint_circuit_size,
366 polynomial_batcher,
368 ck,
370 small_subgroup_ipa.get_witness_polynomials(),
373
375}
376
378{
379 BB_BENCH_NAME("BatchedHonkTranslatorProver::prove_mega_zk_oink");
381 return transcript->export_proof();
382}
383
385{
386 BB_BENCH_NAME("BatchedHonkTranslatorProver::prove");
387 translator_key = std::move(translator_proving_key);
391 return transcript->export_proof();
392}
393
394} // namespace bb
#define BB_ASSERT(expression,...)
Definition assert.hpp:70
#define BB_BENCH_NAME(name)
Definition bb_bench.hpp:264
std::shared_ptr< MegaZKProverInstance > mega_zk_inst
BatchedHonkTranslatorProver(std::shared_ptr< MegaZKProverInstance > mega_zk_instance, std::shared_ptr< MegaZKVK > mega_zk_vk, std::shared_ptr< Transcript > transcript)
std::vector< Polynomial< FF > > round_univariates_list
std::shared_ptr< TranslatorProvingKey > translator_key
void execute_joint_sumcheck_rounds()
Execute the joint 17-round sumcheck.
bb::RelationParameters< FF > translator_relation_parameters
void execute_joint_pcs()
Execute the joint Shplemini / KZG PCS over both circuits' polynomials.
std::array< FF, MegaZKFlavor::NUM_SUBRELATIONS - 1 > MegaZKSubrelationSeparators
HonkProof prove(std::shared_ptr< TranslatorProvingKey > translator_proving_key)
std::vector< std::array< FF, 3 > > round_evaluations_list
std::array< FF, TranslatorFlavor::NUM_SUBRELATIONS - 1 > TransSubrelationSeparators
void execute_mega_zk_oink()
Run the MegaZK circuit's Oink phase.
void execute_translator_oink()
Run the translator's Oink phase on the shared transcript.
CommitmentKey object over a pairing group 𝔾₁.
Class responsible for computation of the batched multilinear polynomials required by the Gemini proto...
Definition gemini.hpp:129
static void compute_opening_proof(const CK &ck, const ProverOpeningClaim< Curve > &opening_claim, const std::shared_ptr< Transcript > &prover_trancript)
Computes the KZG commitment to an opening proof polynomial at a single evaluation point.
Definition kzg.hpp:44
std::span< DataType, NUM_ALL_ENTITIES > get_all()
static constexpr size_t NUM_SUBRELATIONS
Executes the "Oink" phase of the Honk proving protocol: the initial rounds that commit to witness dat...
void prove(bool emit_alpha=true)
Commit to witnesses, compute relation parameters, and prepare for Sumcheck.
Unverified claim (C,r,v) for some witness polynomial p(X) such that.
Definition claim.hpp:55
Polynomial p and an opening pair (r,v) such that p(r) = v.
Definition claim.hpp:36
static OpeningClaim prove(size_t circuit_size, PolynomialBatcher &polynomial_batcher, std::span< FF > multilinear_challenge, const CommitmentKey< Curve > &commitment_key, const std::shared_ptr< Transcript > &transcript, const std::array< Polynomial, NUM_SMALL_IPA_COMMITMENTS > &libra_polynomials={}, const std::vector< Polynomial > &sumcheck_round_univariates={}, const std::vector< std::array< FF, 3 > > &sumcheck_round_evaluations={})
Definition shplemini.hpp:37
A Curve-agnostic ZK protocol to prove inner products of small vectors.
Flavor::CommitmentKey commitment_key
The implementation of the sumcheck Prover for statements of the form for multilinear polynomials .
Definition sumcheck.hpp:304
Imlementation of the Sumcheck prover round.
SumcheckRoundUnivariate compute_univariate(ProverPolynomialsOrPartiallyEvaluatedMultivariates &polynomials, const bb::RelationParameters< FF > &relation_parameters, const bb::GateSeparatorPolynomial< FF > &gate_separators, const SubrelationSeparators &alphas)
Return the evaluations of the round univariate at .
void advance_round()
Advance to the next regular sumcheck round: halve the active hypercube size and increment the round i...
static SumcheckRoundUnivariate compute_libra_univariate(const ZKData &zk_sumcheck_data, size_t round_idx)
Compute Libra round univariate expressed given by the formula.
SumcheckRoundUnivariate compute_offset_area_contribution(ProverPolynomialsOrPartiallyEvaluatedMultivariates &polynomials, const bb::RelationParameters< FF > &relation_parameters, const bb::GateSeparatorPolynomial< FF > &gate_separators, const SubrelationSeparators &alphas, const RowDisablingPolynomial< FF > row_disabling_polynomial)
Contribution to the round univariate from the offset-area head rows (rows 0 .. TRACE_OFFSET - 1),...
static std::array< FFType, NUM_FULL_CIRCUIT_EVALUATIONS > get_full_circuit_evaluations(AllEntities< FFType > &evals)
Prover: extract the full-circuit evaluations via get_full_circuit_entities().
static constexpr size_t LOG_MINI_CIRCUIT_SIZE
static constexpr size_t NUM_SUBRELATIONS
static std::array< FF, NUM_MINICIRCUIT_EVALUATIONS > get_minicircuit_evaluations(PolyContainer &polys)
Prover: read the 154 minicircuit wire evaluations from partially-evaluated polynomials.
BB_PROFILE void execute_preamble_round()
Add circuit size and values used in the relations to the transcript.
BB_PROFILE void execute_grand_product_computation_round()
Compute permutation product polynomial and commitments.
bb::RelationParameters< FF > relation_parameters
BB_PROFILE void execute_wire_and_sorted_constraints_commitments_round()
Compute commitments to wires and ordered range constraints.
A univariate polynomial represented by its values on {0, 1,..., domain_end - 1}.
static Univariate zero()
std::array< Fr, LENGTH > evaluations
static constexpr size_t SUBGROUP_SIZE
Definition bn254.hpp:34
constexpr T get_msb(const T in)
Definition get_msb.hpp:50
Entry point for Barretenberg command-line interface.
Definition api.hpp:5
std::vector< fr > HonkProof
Definition proof.hpp:15
RefArray< T,(Ns+...)> constexpr concatenate(const RefArray< T, Ns > &... ref_arrays)
Concatenates multiple RefArray objects into a single RefArray.
CommitmentKey< Curve > ck
std::array< FF, N > initialize_relation_separator(const FF &alpha)
Definition sumcheck.hpp:954
STL namespace.
constexpr decltype(auto) get(::tuplet::tuple< T... > &&t) noexcept
Definition tuple.hpp:13
std::string to_string(bb::avm2::ValueTag tag)
void partially_evaluate(FF challenge)
Partially evaluate the -polynomial at the new challenge and update .
Handler for processing round univariates in sumcheck. Default implementation: send evaluations direct...
Definition sumcheck.hpp:27
void finalize_last_round(size_t, const bb::Univariate< FF, BATCHED_RELATION_PARTIAL_LENGTH > &, const FF &)
Definition sumcheck.hpp:47
void process_round_univariate(size_t round_idx, bb::Univariate< FF, BATCHED_RELATION_PARTIAL_LENGTH > &round_univariate)
Definition sumcheck.hpp:41
Polynomial for Sumcheck with disabled Rows.
void update_evaluations(FF round_challenge, size_t round_idx)
Compute the evaluations of L^{(i)} at 0 and 1.
ClaimedLibraEvaluations libra_evaluations
void update_zk_sumcheck_data(const FF &round_challenge, const size_t round_idx)
Upon receiving the challenge , the prover updates Libra data. If .