Barretenberg
The ZK-SNARK library at the core of Aztec
Loading...
Searching...
No Matches
api_chonk.cpp
Go to the documentation of this file.
1#include "api_chonk.hpp"
18#include <algorithm>
19#include <stdexcept>
20
21namespace bb {
22namespace { // anonymous namespace
23
34void write_chonk_vk(std::vector<uint8_t> bytecode, const std::filesystem::path& output_path, const API::Flags& flags)
35{
36 auto response = bbapi::ChonkComputeVk{ .circuit = { .bytecode = std::move(bytecode) } }.execute();
37
38 const bool is_stdout = output_path == "-";
39 if (is_stdout) {
40 write_bytes_to_stdout(response.bytes);
41 } else if (flags.output_format == "json") {
42 // Note: Chonk VK doesn't have a hash, so we pass an empty string
43 std::string json_content = VkJson::build(response.fields, "", flags.scheme);
44 write_file(output_path / "vk.json", std::vector<uint8_t>(json_content.begin(), json_content.end()));
45 info("VK (JSON) saved to ", output_path / "vk.json");
46 } else {
47 write_file(output_path / "vk", response.bytes);
48 }
49}
50} // anonymous namespace
51
52void ChonkAPI::prove(const Flags& flags,
53 const std::filesystem::path& input_path,
54 const std::filesystem::path& output_dir)
55{
56 BB_BENCH_NAME("ChonkAPI::prove");
57 bbapi::BBApiRequest request;
60
61 bbapi::ChonkStart{ .num_circuits = static_cast<uint32_t>(raw_steps.size()) }.execute(request);
62 info("Chonk: starting with ", raw_steps.size(), " circuits");
63 for (const auto& step : raw_steps) {
65 .circuit = { .name = step.function_name, .bytecode = step.bytecode, .verification_key = step.vk }
66 }.execute(request);
67
68 // NOLINTNEXTLINE(bugprone-unchecked-optional-access): we know the optional has been set here.
69 info("Chonk: accumulating " + step.function_name);
70 bbapi::ChonkAccumulate{ .witness = step.witness }.execute(request);
71 }
72
73 auto proof = bbapi::ChonkProve{}.execute(request).proof;
74
75 const bool output_to_stdout = output_dir == "-";
76
77 const auto write_proof = [&]() {
78 const auto proof_fields = proof.to_field_elements();
79 if (output_to_stdout) {
80 vinfo("writing Chonk proof to stdout");
81 write_bytes_to_stdout(to_buffer(proof_fields));
82 } else if (flags.output_format == "json") {
83 vinfo("writing Chonk proof (JSON) in directory ", output_dir);
84 // Note: Chonk proof doesn't have a vk_hash, so we pass an empty string
85 std::string json_content = ProofJson::build(proof_fields, "", flags.scheme);
86 write_file(output_dir / "proof.json", std::vector<uint8_t>(json_content.begin(), json_content.end()));
87 info("Proof (JSON) saved to ", output_dir / "proof.json");
88 } else {
89 vinfo("writing Chonk proof in directory ", output_dir);
90 write_file(output_dir / "proof", to_buffer(proof_fields));
91 }
92 };
93
94 write_proof();
95
96 if (flags.write_vk) {
97 vinfo("writing Chonk vk in directory ", output_dir);
98 // write CHONK vk using the bytecode of the Hiding kernel (the last step of the execution)
99 write_chonk_vk(raw_steps[raw_steps.size() - 1].bytecode, output_dir, flags);
100 }
101}
102
103bool ChonkAPI::verify([[maybe_unused]] const Flags& flags,
104 [[maybe_unused]] const std::filesystem::path& public_inputs_path,
105 const std::filesystem::path& proof_path,
106 const std::filesystem::path& vk_path)
107{
108 BB_BENCH_NAME("ChonkAPI::verify");
109 auto proof_fields = many_from_buffer<fr>(read_file(proof_path));
110 auto proof = ChonkProof::from_field_elements(proof_fields);
111
112 auto vk_buffer = read_vk_file(vk_path);
113
114 auto response = bbapi::ChonkVerify{ .proof = std::move(proof), .vk = std::move(vk_buffer) }.execute();
115 return response.valid;
116}
117
118bool ChonkAPI::batch_verify([[maybe_unused]] const Flags& flags, const std::filesystem::path& proofs_dir)
119{
120 BB_BENCH_NAME("ChonkAPI::batch_verify");
121
124
125 for (size_t i = 0;; ++i) {
126 auto proof_file = proofs_dir / ("proof_" + std::to_string(i));
127 auto vk_file = proofs_dir / ("vk_" + std::to_string(i));
128
129 if (!std::filesystem::exists(proof_file) || !std::filesystem::exists(vk_file)) {
130 break;
131 }
132
133 auto proof_fields = many_from_buffer<fr>(read_file(proof_file));
134 proofs.push_back(ChonkProof::from_field_elements(proof_fields));
135 vks.push_back(read_vk_file(vk_file));
136 }
137
138 if (proofs.empty()) {
139 throw_or_abort("batch_verify: no proof_0/vk_0 pairs found in " + proofs_dir.string());
140 }
141
142 info("ChonkAPI::batch_verify - found ", proofs.size(), " proof/vk pairs in ", proofs_dir.string());
143
144 auto response = bbapi::ChonkBatchVerify{ .proofs = std::move(proofs), .vks = std::move(vks) }.execute();
145 return response.valid;
146}
147
148// WORKTODO(bbapi) remove this
149bool ChonkAPI::prove_and_verify(const std::filesystem::path& input_path)
150{
153
155 // Construct the hiding kernel as the final step of the IVC
156
157 auto proof = ivc->prove();
158 auto vk_and_hash = ivc->get_hiding_kernel_vk_and_hash();
159 ChonkNativeVerifier verifier(vk_and_hash);
160 const bool verified = verifier.verify(proof);
161 return verified;
162}
163
164void ChonkAPI::gates(const Flags& flags, const std::filesystem::path& bytecode_path)
165{
166 BB_BENCH_NAME("ChonkAPI::gates");
167 chonk_gate_count(bytecode_path, flags.include_gates_per_opcode);
168}
169
170void ChonkAPI::write_solidity_verifier([[maybe_unused]] const Flags& flags,
171 [[maybe_unused]] const std::filesystem::path& output_path,
172 [[maybe_unused]] const std::filesystem::path& vk_path)
173{
174 BB_BENCH_NAME("ChonkAPI::write_solidity_verifier");
175 throw_or_abort("API function contract not implemented");
176}
177
178bool ChonkAPI::check_precomputed_vks(const Flags& flags, const std::filesystem::path& input_path)
179{
180 BB_BENCH_NAME("ChonkAPI::check_precomputed_vks");
181 bbapi::BBApiRequest request;
183
185 bool check_failed = false;
186 for (auto& step : raw_steps) {
187 if (step.vk.empty()) {
188 info("FAIL: Expected precomputed vk for function ", step.function_name);
189 return false;
190 }
191 auto response = bbapi::ChonkCheckPrecomputedVk{
192 .circuit = { .name = step.function_name, .bytecode = step.bytecode, .verification_key = step.vk }
193 }.execute();
194
195 if (!response.valid) {
196 info("VK mismatch detected for function ", step.function_name);
197 if (vk_policy != bbapi::VkPolicy::REWRITE) {
198 info("Computed VK differs from precomputed VK in ivc-inputs.msgpack");
199 return false;
200 }
201 info("Updating VK in ivc-inputs.msgpack with computed value");
202 step.vk = response.actual_vk;
203 check_failed = true;
204 }
205 }
206 if (check_failed) {
208 return false;
209 }
210 return true;
211}
212
213void ChonkAPI::write_vk(const Flags& flags,
214 const std::filesystem::path& bytecode_path,
215 const std::filesystem::path& output_path)
216{
217 BB_BENCH_NAME("ChonkAPI::write_vk");
218 write_chonk_vk(get_bytecode(bytecode_path), output_path, flags);
219}
220
221bool ChonkAPI::check([[maybe_unused]] const Flags& flags,
222 [[maybe_unused]] const std::filesystem::path& bytecode_path,
223 [[maybe_unused]] const std::filesystem::path& witness_path)
224{
225 throw_or_abort("API function check_witness not implemented");
226 return false;
227}
228
229void chonk_gate_count(const std::string& bytecode_path, bool include_gates_per_opcode)
230{
231 BB_BENCH_NAME("chonk_gate_count");
232 // All circuit reports will be built into the std::string below
233 std::string functions_string = "{\"functions\": [\n ";
234
235 bbapi::BBApiRequest request;
236
237 auto bytecode = get_bytecode(bytecode_path);
238 auto response = bbapi::ChonkStats{ .circuit = { .name = "ivc_circuit", .bytecode = std::move(bytecode) },
239 .include_gates_per_opcode = include_gates_per_opcode }
240 .execute(request);
241
242 // Build the circuit report. It always has one function, corresponding to the ACIR constraint systems.
243 // NOTE: can be reconsidered
244 std::string gates_per_opcode_str;
245 if (include_gates_per_opcode && !response.gates_per_opcode.empty()) {
246 for (size_t j = 0; j < response.gates_per_opcode.size(); j++) {
247 gates_per_opcode_str += std::to_string(response.gates_per_opcode[j]);
248 if (j != response.gates_per_opcode.size() - 1) {
249 gates_per_opcode_str += ",";
250 }
251 }
252 }
253 auto result_string = format(
254 "{\n \"acir_opcodes\": ",
255 response.acir_opcodes,
256 ",\n \"circuit_size\": ",
257 response.circuit_size,
258 (include_gates_per_opcode ? format(",\n \"gates_per_opcode\": [", gates_per_opcode_str, "]") : ""),
259 "\n }");
260 functions_string = format(functions_string, result_string);
261 std::cout << format(functions_string, "\n]}");
262}
263
264} // namespace bb
void write_bytes_to_stdout(const std::vector< uint8_t > &data)
Writes raw bytes of the vector to stdout.
Definition log.hpp:21
std::shared_ptr< Napi::ThreadSafeFunction > bytecode
#define BB_BENCH_NAME(name)
Definition bb_bench.hpp:225
bool prove_and_verify(const std::filesystem::path &input_path)
Test/debug function: prove and verify in one call (bypasses serialization).
bool batch_verify(const Flags &flags, const std::filesystem::path &proofs_dir)
Batch-verify multiple Chonk proofs from a directory of proof_N/vk_N pairs.
bool verify(const Flags &flags, const std::filesystem::path &public_inputs_path, const std::filesystem::path &proof_path, const std::filesystem::path &vk_path) override
Verify a Chonk proof against a verification key.
void write_vk(const Flags &flags, const std::filesystem::path &bytecode_path, const std::filesystem::path &output_path) override
Compute and write a MegaHonk verification key for a circuit to be accumulated in Chonk.
void prove(const Flags &flags, const std::filesystem::path &input_path, const std::filesystem::path &output_dir)
Main production entry point: generate a Chonk proof from private execution steps.
Definition api_chonk.cpp:52
bool check(const Flags &flags, const std::filesystem::path &bytecode_path, const std::filesystem::path &witness_path) override
void gates(const Flags &flags, const std::filesystem::path &bytecode_path) override
Output gate count statistics for a circuit.
bool check_precomputed_vks(const Flags &flags, const std::filesystem::path &input_path)
Validate that precomputed VKs in ivc-inputs.msgpack match computed VKs.
void write_solidity_verifier(const Flags &flags, const std::filesystem::path &output_path, const std::filesystem::path &vk_path) override
Verifier for Chonk IVC proofs (both native and recursive).
Output verify(const Proof &proof)
Verify a Chonk proof.
std::string format(Args... args)
Definition log.hpp:23
#define info(...)
Definition log.hpp:93
#define vinfo(...)
Definition log.hpp:94
std::vector< uint8_t > get_bytecode(const std::string &bytecodePath)
VkPolicy
Policy for handling verification keys during IVC accumulation.
VkPolicy parse_vk_policy(const std::string &policy)
Convert VK policy string to enum for internal use.
Entry point for Barretenberg command-line interface.
Definition api.hpp:5
void chonk_gate_count(const std::string &bytecode_path, bool include_gates_per_opcode)
std::vector< uint8_t > read_vk_file(const std::filesystem::path &vk_path)
Read a verification key file with an actionable error message if not found.
Definition file_io.hpp:143
std::vector< uint8_t > read_file(const std::string &filename, size_t bytes=0)
Definition file_io.hpp:29
void write_file(const std::string &filename, std::span< const uint8_t > data)
Definition file_io.hpp:99
constexpr decltype(auto) get(::tuplet::tuple< T... > &&t) noexcept
Definition tuple.hpp:13
std::string to_string(bb::avm2::ValueTag tag)
std::vector< uint8_t > to_buffer(T const &value)
bool include_gates_per_opcode
Definition api.hpp:22
bool write_vk
Definition api.hpp:21
std::string vk_policy
Definition api.hpp:25
std::string output_format
Definition api.hpp:29
std::string scheme
Definition api.hpp:18
static ChonkProof_ from_field_elements(const std::vector< FF > &fields)
Common logic to reconstruct proof from field elements.
std::vector< FF > to_field_elements() const
Serialize proof to field elements (native mode)
static void compress_and_save(std::vector< PrivateExecutionStepRaw > &&steps, const std::filesystem::path &output_path)
static std::vector< PrivateExecutionStepRaw > load_and_decompress(const std::filesystem::path &input_path)
Parsed private execution steps ready for Chonk accumulation.
std::shared_ptr< Chonk > accumulate()
Creates a Chonk instance and accumulates each circuit in the folding stack. Uses precomputed VKs when...
void parse(std::vector< PrivateExecutionStepRaw > &&steps)
Converts PrivateExecutionStepRaw entries (which contain raw bytecode/witness bytes) into structured A...
static std::string build(const std::vector< T > &fields, const std::string &vk_hash, const std::string &scheme)
static std::string build(const std::vector< T > &fields, const std::string &hash, const std::string &scheme)
Accumulate the previously loaded circuit into the IVC proof.
std::vector< uint8_t > witness
Serialized witness data for the last loaded circuit.
Batch-verify multiple Chonk proofs with a single IPA SRS MSM.
std::vector< ChonkProof > proofs
Verify that a precomputed verification key matches the circuit.
CircuitInput circuit
Circuit with its precomputed verification key.
Compute MegaHonk verification key for a circuit to be accumulated in Chonk.
Load a circuit into the Chonk instance for accumulation.
CircuitInput circuit
Circuit to be loaded with its bytecode and verification key.
ChonkProof proof
Complete IVC proof for all accumulated circuits.
Generate a proof for all accumulated circuits.
Response execute(BBApiRequest &request) &&
Initialize a new Chonk instance for incremental proof accumulation.
Get gate counts for a circuit.
CircuitInputNoVK circuit
The circuit to analyze.
Verify a Chonk proof with its verification key.
ChonkProof proof
The Chonk proof to verify.
std::string name
Human-readable name for the circuit.
std::string name
Human-readable name for the circuit.
std::vector< uint8_t > bytecode
Serialized bytecode representation of the circuit.
void throw_or_abort(std::string const &err)