purify
C++ Purify implementation with native circuit and BPP support
Loading...
Searching...
No Matches
bppp_bridge.h
Go to the documentation of this file.
1// Copyright (c) 2026 Judica, Inc.
2// Distributed under the MIT software license, see the accompanying
3// file COPYING or https://opensource.org/license/mit/.
4
9
10#pragma once
11
12#include <stddef.h>
13
14#include "purify/secp_bridge.h"
15
16#ifdef __cplusplus
17extern "C" {
18#endif
19
21
27 void* callback_data,
28 const unsigned char point_pair65[65],
29 size_t round,
30 unsigned char challenge32[32]);
31
38size_t purify_bppp_required_proof_size(size_t n_vec_len, size_t c_vec_len);
39
41int purify_bppp_base_generator(purify_secp_context* context, unsigned char out33[33]);
43int purify_bppp_value_generator_h(purify_secp_context* context, unsigned char out33[33]);
51int purify_bppp_create_generators(purify_secp_context* context, size_t count, unsigned char* out, size_t* out_len);
52
54 const unsigned char generator33[33],
55 const unsigned char scalar32[32],
56 unsigned char out33[33]);
57
59 const unsigned char generator33[33],
60 unsigned char out33[33]);
61
63 const unsigned char* generators33,
64 size_t generators_count);
66 const purify_bppp_backend_resources* resources);
68
70 const unsigned char rho32[32], const unsigned char* generators33, size_t generators_count,
71 const unsigned char* n_vec32, size_t n_vec_len, const unsigned char* l_vec32,
72 size_t l_vec_len, const unsigned char* c_vec32, size_t c_vec_len,
73 unsigned char commitment_out33[33]);
75 const unsigned char rho32[32],
76 const unsigned char* n_vec32, size_t n_vec_len,
77 const unsigned char* l_vec32, size_t l_vec_len,
78 const unsigned char* c_vec32, size_t c_vec_len,
79 unsigned char commitment_out33[33]);
80
82 const unsigned char* generators33, size_t generators_count,
83 const unsigned char* n_vec32, size_t n_vec_len, const unsigned char* l_vec32,
84 size_t l_vec_len, unsigned char commitment_out33[33]);
86 const unsigned char* n_vec32, size_t n_vec_len,
87 const unsigned char* l_vec32, size_t l_vec_len,
88 unsigned char commitment_out33[33]);
89
91 const unsigned char commitment33[33], const unsigned char scalar32[32],
92 unsigned char commitment_out33[33]);
93
95 const unsigned char point33[33], const unsigned char scalar32[32],
96 unsigned char out33[33]);
97
99 const unsigned char lhs33[33], const unsigned char rhs33[33],
100 unsigned char out33[33]);
101
103 purify_secp_context* context, const unsigned char lhs33[33],
104 const unsigned char rhs33[33], unsigned char out33[33]);
105
107 purify_secp_context* context, const unsigned char lhs33[33],
108 const unsigned char rhs33[33], unsigned char out33[33]);
109
120 const unsigned char blind32[32], const unsigned char value32[32],
121 const unsigned char value_gen33[33], const unsigned char blind_gen33[33],
122 unsigned char commitment_out33[33]);
123
141 const unsigned char rho32[32], const unsigned char* generators33, size_t generators_count,
142 const unsigned char* n_vec32, size_t n_vec_len, const unsigned char* l_vec32,
143 size_t l_vec_len, const unsigned char* c_vec32, size_t c_vec_len,
144 unsigned char commitment_out33[33], unsigned char* proof_out, size_t* proof_len);
146 const unsigned char rho32[32],
147 const unsigned char* n_vec32, size_t n_vec_len,
148 const unsigned char* l_vec32, size_t l_vec_len,
149 const unsigned char* c_vec32, size_t c_vec_len,
150 unsigned char commitment_out33[33], unsigned char* proof_out,
151 size_t* proof_len);
152
154 const unsigned char rho32[32], const unsigned char* generators33, size_t generators_count,
155 const unsigned char* n_vec32, size_t n_vec_len, const unsigned char* l_vec32,
156 size_t l_vec_len, const unsigned char* c_vec32, size_t c_vec_len,
157 const unsigned char commitment33[33], unsigned char* proof_out, size_t* proof_len);
159 const unsigned char rho32[32],
160 const unsigned char* n_vec32, size_t n_vec_len,
161 const unsigned char* l_vec32, size_t l_vec_len,
162 const unsigned char* c_vec32, size_t c_vec_len,
163 const unsigned char commitment33[33],
164 unsigned char* proof_out, size_t* proof_len);
165
174 purify_secp_context* context,
175 const unsigned char rho32[32],
176 const unsigned char* generators33,
177 size_t generators_count,
178 const unsigned char* n_vec32,
179 size_t n_vec_len,
180 const unsigned char* l_vec32,
181 size_t l_vec_len,
182 const unsigned char* c_vec32,
183 size_t c_vec_len,
184 const unsigned char commitment33[33],
185 purify_bppp_round_challenge_callback challenge_callback,
186 void* callback_data,
187 unsigned char* proof_out,
188 size_t* proof_len);
189
204 const unsigned char rho32[32], const unsigned char* generators33, size_t generators_count,
205 const unsigned char* c_vec32, size_t c_vec_len, size_t n_vec_len,
206 const unsigned char commitment33[33], const unsigned char* proof, size_t proof_len);
208 const unsigned char rho32[32],
209 const unsigned char* c_vec32, size_t c_vec_len, size_t n_vec_len,
210 const unsigned char commitment33[33], const unsigned char* proof,
211 size_t proof_len);
212
219 purify_secp_context* context,
220 const unsigned char rho32[32],
221 const unsigned char* generators33,
222 size_t generators_count,
223 const unsigned char* c_vec32,
224 size_t c_vec_len,
225 size_t n_vec_len,
226 const unsigned char commitment33[33],
227 const unsigned char* proof,
228 size_t proof_len,
229 const unsigned char* gammas32,
230 size_t gamma_count);
231
243 const unsigned char rho32[32],
244 const unsigned char* generators33, size_t generators_count,
245 const unsigned char* c_vec32, size_t c_vec_len, size_t n_vec_len,
246 const unsigned char commitment33[33],
247 const unsigned char* proof, size_t proof_len,
248 unsigned char terminal_n32[32], unsigned char terminal_l32[32],
249 unsigned char* gammas32, size_t gamma_count,
250 unsigned char residual33[33]);
251
257 purify_secp_context* context,
258 const unsigned char rho32[32],
259 const unsigned char* generators33,
260 size_t generators_count,
261 const unsigned char* c_vec32,
262 size_t c_vec_len,
263 size_t n_vec_len,
264 const unsigned char commitment33[33],
265 const unsigned char* proof,
266 size_t proof_len,
267 const unsigned char* gammas32,
268 size_t gamma_count,
269 unsigned char terminal_n32[32],
270 unsigned char terminal_l32[32],
271 unsigned char residual33[33]);
272
278 const unsigned char* generators33, size_t generators_count,
279 unsigned char* points_out33);
280
287 const unsigned char* points33, const unsigned char* scalars32,
288 size_t count, unsigned char out33[33]);
289
297 const unsigned char point33[33]);
298
304 const unsigned char* input, size_t input_len,
305 unsigned char out33[33]);
306
308 size_t size;
309 const size_t* indices;
310 const unsigned char* scalars32;
312
324
326 size_t n_gates;
327 size_t n_commits;
328 const unsigned char* al32;
329 const unsigned char* ar32;
330 const unsigned char* ao32;
331 const unsigned char* v32;
333
335
337
339 size_t n_gates);
341 const purify_bulletproof_backend_resources* resources);
344
345/* Commitment buffers contain circuit->n_commits packed 33-byte points. A non-null
346 * blinds32 buffer contains circuit->n_commits packed 32-byte scalars; NULL uses
347 * zero blinds. The caller owns and sizes these buffers from the circuit.
348 */
350 const purify_bulletproof_circuit_view* circuit,
351 const purify_bulletproof_assignment_view* assignment,
352 const unsigned char* blinds32,
353 const unsigned char value_gen33[33],
354 const unsigned char nonce32[32],
355 const unsigned char* extra_commit,
356 size_t extra_commit_len,
357 unsigned char* commitments_out33,
358 unsigned char* proof_out,
359 size_t* proof_len);
361 const purify_bulletproof_circuit_view* circuit,
362 const purify_bulletproof_assignment_view* assignment,
363 const unsigned char* blinds32,
364 const unsigned char value_gen33[33],
365 const unsigned char nonce32[32],
366 const unsigned char* extra_commit,
367 size_t extra_commit_len,
368 unsigned char* commitments_out33,
369 unsigned char* proof_out,
370 size_t* proof_len);
371
373 const purify_bulletproof_circuit_view* circuit,
374 const purify_bulletproof_assignment_view* assignment,
375 const unsigned char* blinds32,
376 const unsigned char value_gen33[33],
377 const unsigned char nonce32[32],
378 const unsigned char* extra_commit,
379 size_t extra_commit_len,
380 unsigned char* commitments_out33,
381 unsigned char* proof_out,
382 size_t* proof_len);
384 const purify_bulletproof_circuit_view* circuit,
385 const purify_bulletproof_assignment_view* assignment,
386 const unsigned char* blinds32,
387 const unsigned char value_gen33[33],
388 const unsigned char nonce32[32],
389 const unsigned char* extra_commit,
390 size_t extra_commit_len,
391 unsigned char* commitments_out33,
392 unsigned char* proof_out,
393 size_t* proof_len);
394
396 const purify_bulletproof_circuit_view* circuit,
397 const unsigned char* commitments33,
398 const unsigned char value_gen33[33],
399 const unsigned char* extra_commit,
400 size_t extra_commit_len,
401 const unsigned char* proof,
402 size_t proof_len);
404 const purify_bulletproof_circuit_view* circuit,
405 const unsigned char* commitments33,
406 const unsigned char value_gen33[33],
407 const unsigned char* extra_commit,
408 size_t extra_commit_len,
409 const unsigned char* proof,
410 size_t proof_len);
411
412#ifdef __cplusplus
413}
414#endif
int purify_bppp_verify_norm_arg_with_challenges(purify_secp_context *context, const unsigned char rho32[32], const unsigned char *generators33, size_t generators_count, const unsigned char *c_vec32, size_t c_vec_len, size_t n_vec_len, const unsigned char commitment33[33], const unsigned char *proof, size_t proof_len, const unsigned char *gammas32, size_t gamma_count)
int purify_bulletproof_prove_circuit_with_resources(purify_bulletproof_backend_resources *resources, const purify_bulletproof_circuit_view *circuit, const purify_bulletproof_assignment_view *assignment, const unsigned char *blinds32, const unsigned char value_gen33[33], const unsigned char nonce32[32], const unsigned char *extra_commit, size_t extra_commit_len, unsigned char *commitments_out33, unsigned char *proof_out, size_t *proof_len)
int purify_bppp_prove_norm_arg_to_commitment_with_resources(purify_bppp_backend_resources *resources, const unsigned char rho32[32], const unsigned char *n_vec32, size_t n_vec_len, const unsigned char *l_vec32, size_t l_vec_len, const unsigned char *c_vec32, size_t c_vec_len, const unsigned char commitment33[33], unsigned char *proof_out, size_t *proof_len)
int purify_bppp_commit_witness_only_with_resources(purify_bppp_backend_resources *resources, const unsigned char *n_vec32, size_t n_vec_len, const unsigned char *l_vec32, size_t l_vec_len, unsigned char commitment_out33[33])
int purify_point_subtract_allow_infinity(purify_secp_context *context, const unsigned char lhs33[33], const unsigned char rhs33[33], unsigned char out33[33])
int purify_bulletproof_verify_circuit(purify_secp_context *context, const purify_bulletproof_circuit_view *circuit, const unsigned char *commitments33, const unsigned char value_gen33[33], const unsigned char *extra_commit, size_t extra_commit_len, const unsigned char *proof, size_t proof_len)
int purify_point_scale(purify_secp_context *context, const unsigned char point33[33], const unsigned char scalar32[32], unsigned char out33[33])
int purify_bulletproof_verify_circuit_with_resources(purify_bulletproof_backend_resources *resources, const purify_bulletproof_circuit_view *circuit, const unsigned char *commitments33, const unsigned char value_gen33[33], const unsigned char *extra_commit, size_t extra_commit_len, const unsigned char *proof, size_t proof_len)
int purify_bppp_prove_norm_arg_to_commitment_with_callback(purify_secp_context *context, const unsigned char rho32[32], const unsigned char *generators33, size_t generators_count, const unsigned char *n_vec32, size_t n_vec_len, const unsigned char *l_vec32, size_t l_vec_len, const unsigned char *c_vec32, size_t c_vec_len, const unsigned char commitment33[33], purify_bppp_round_challenge_callback challenge_callback, void *callback_data, unsigned char *proof_out, size_t *proof_len)
int purify_bppp_prepare_norm_arg_claim_with_challenges(purify_secp_context *context, const unsigned char rho32[32], const unsigned char *generators33, size_t generators_count, const unsigned char *c_vec32, size_t c_vec_len, size_t n_vec_len, const unsigned char commitment33[33], const unsigned char *proof, size_t proof_len, const unsigned char *gammas32, size_t gamma_count, unsigned char terminal_n32[32], unsigned char terminal_l32[32], unsigned char residual33[33])
int purify_bppp_scale_generator(purify_secp_context *context, const unsigned char generator33[33], const unsigned char scalar32[32], unsigned char out33[33])
int purify_bulletproof_prove_circuit(purify_secp_context *context, const purify_bulletproof_circuit_view *circuit, const purify_bulletproof_assignment_view *assignment, const unsigned char *blinds32, const unsigned char value_gen33[33], const unsigned char nonce32[32], const unsigned char *extra_commit, size_t extra_commit_len, unsigned char *commitments_out33, unsigned char *proof_out, size_t *proof_len)
int purify_bppp_generator_to_point(purify_secp_context *context, const unsigned char generator33[33], unsigned char out33[33])
int purify_bulletproof_prove_circuit_assume_valid(purify_secp_context *context, const purify_bulletproof_circuit_view *circuit, const purify_bulletproof_assignment_view *assignment, const unsigned char *blinds32, const unsigned char value_gen33[33], const unsigned char nonce32[32], const unsigned char *extra_commit, size_t extra_commit_len, unsigned char *commitments_out33, unsigned char *proof_out, size_t *proof_len)
int purify_bppp_prove_norm_arg(purify_secp_context *context, const unsigned char rho32[32], const unsigned char *generators33, size_t generators_count, const unsigned char *n_vec32, size_t n_vec_len, const unsigned char *l_vec32, size_t l_vec_len, const unsigned char *c_vec32, size_t c_vec_len, unsigned char commitment_out33[33], unsigned char *proof_out, size_t *proof_len)
Produces a standalone BPPP norm argument.
int purify_bppp_commit_witness_only(purify_secp_context *context, const unsigned char *generators33, size_t generators_count, const unsigned char *n_vec32, size_t n_vec_len, const unsigned char *l_vec32, size_t l_vec_len, unsigned char commitment_out33[33])
int(* purify_bppp_round_challenge_callback)(void *callback_data, const unsigned char point_pair65[65], size_t round, unsigned char challenge32[32])
Definition bppp_bridge.h:26
int purify_bppp_commit_norm_arg(purify_secp_context *context, const unsigned char rho32[32], const unsigned char *generators33, size_t generators_count, const unsigned char *n_vec32, size_t n_vec_len, const unsigned char *l_vec32, size_t l_vec_len, const unsigned char *c_vec32, size_t c_vec_len, unsigned char commitment_out33[33])
int purify_bppp_prepare_norm_arg_claim(purify_secp_context *context, const unsigned char rho32[32], const unsigned char *generators33, size_t generators_count, const unsigned char *c_vec32, size_t c_vec_len, size_t n_vec_len, const unsigned char commitment33[33], const unsigned char *proof, size_t proof_len, unsigned char terminal_n32[32], unsigned char terminal_l32[32], unsigned char *gammas32, size_t gamma_count, unsigned char residual33[33])
int purify_bppp_public_point_validate(const unsigned char point33[33])
void purify_bppp_backend_resources_destroy(purify_bppp_backend_resources *resources)
int purify_bppp_public_msm(purify_secp_context *context, const unsigned char *points33, const unsigned char *scalars32, size_t count, unsigned char out33[33])
int purify_bulletproof_prove_circuit_assume_valid_with_resources(purify_bulletproof_backend_resources *resources, const purify_bulletproof_circuit_view *circuit, const purify_bulletproof_assignment_view *assignment, const unsigned char *blinds32, const unsigned char value_gen33[33], const unsigned char nonce32[32], const unsigned char *extra_commit, size_t extra_commit_len, unsigned char *commitments_out33, unsigned char *proof_out, size_t *proof_len)
size_t purify_bulletproof_backend_resources_scratch_capacity(const purify_bulletproof_backend_resources *resources)
int purify_bppp_value_generator_h(purify_secp_context *context, unsigned char out33[33])
Serializes the alternate value generator used by Pedersen commitments.
int purify_bppp_create_generators(purify_secp_context *context, size_t count, unsigned char *out, size_t *out_len)
Expands the generator list required by the BPPP prover and verifier.
purify_bppp_backend_resources * purify_bppp_backend_resources_clone(const purify_bppp_backend_resources *resources)
int purify_point_add(purify_secp_context *context, const unsigned char lhs33[33], const unsigned char rhs33[33], unsigned char out33[33])
int purify_bppp_verify_norm_arg(purify_secp_context *context, const unsigned char rho32[32], const unsigned char *generators33, size_t generators_count, const unsigned char *c_vec32, size_t c_vec_len, size_t n_vec_len, const unsigned char commitment33[33], const unsigned char *proof, size_t proof_len)
Verifies a standalone BPPP norm argument.
int purify_pedersen_commit_char(purify_secp_context *context, const unsigned char blind32[32], const unsigned char value32[32], const unsigned char value_gen33[33], const unsigned char blind_gen33[33], unsigned char commitment_out33[33])
Computes a Pedersen commitment to an arbitrary 32-byte scalar value.
int purify_bppp_prove_norm_arg_with_resources(purify_bppp_backend_resources *resources, const unsigned char rho32[32], const unsigned char *n_vec32, size_t n_vec_len, const unsigned char *l_vec32, size_t l_vec_len, const unsigned char *c_vec32, size_t c_vec_len, unsigned char commitment_out33[33], unsigned char *proof_out, size_t *proof_len)
int purify_bppp_offset_commitment(purify_secp_context *context, const unsigned char commitment33[33], const unsigned char scalar32[32], unsigned char commitment_out33[33])
void purify_bulletproof_backend_resources_destroy(purify_bulletproof_backend_resources *resources)
int purify_bppp_public_hash_to_point(purify_secp_context *context, const unsigned char *input, size_t input_len, unsigned char out33[33])
int purify_bppp_prove_norm_arg_to_commitment(purify_secp_context *context, const unsigned char rho32[32], const unsigned char *generators33, size_t generators_count, const unsigned char *n_vec32, size_t n_vec_len, const unsigned char *l_vec32, size_t l_vec_len, const unsigned char *c_vec32, size_t c_vec_len, const unsigned char commitment33[33], unsigned char *proof_out, size_t *proof_len)
int purify_bppp_generators_to_points(purify_secp_context *context, const unsigned char *generators33, size_t generators_count, unsigned char *points_out33)
purify_bulletproof_backend_resources * purify_bulletproof_backend_resources_create(purify_secp_context *context, size_t n_gates)
int purify_point_add_allow_infinity(purify_secp_context *context, const unsigned char lhs33[33], const unsigned char rhs33[33], unsigned char out33[33])
purify_bulletproof_backend_resources * purify_bulletproof_backend_resources_clone(const purify_bulletproof_backend_resources *resources)
int purify_bppp_base_generator(purify_secp_context *context, unsigned char out33[33])
Serializes the secp256k1 base generator into compressed form.
int purify_bppp_commit_norm_arg_with_resources(purify_bppp_backend_resources *resources, const unsigned char rho32[32], const unsigned char *n_vec32, size_t n_vec_len, const unsigned char *l_vec32, size_t l_vec_len, const unsigned char *c_vec32, size_t c_vec_len, unsigned char commitment_out33[33])
size_t purify_bppp_required_proof_size(size_t n_vec_len, size_t c_vec_len)
Computes the maximum serialized size of a BPPP norm proof.
size_t purify_bulletproof_required_proof_size(size_t n_gates)
purify_bppp_backend_resources * purify_bppp_backend_resources_create(purify_secp_context *context, const unsigned char *generators33, size_t generators_count)
int purify_bppp_verify_norm_arg_with_resources(purify_bppp_backend_resources *resources, const unsigned char rho32[32], const unsigned char *c_vec32, size_t c_vec_len, size_t n_vec_len, const unsigned char commitment33[33], const unsigned char *proof, size_t proof_len)
Narrow C ABI exposing secp256k1 scalar and HMAC helpers to the C++ headers.
const purify_bulletproof_row_view * wr
const purify_bulletproof_row_view * wo
const purify_bulletproof_row_view * wl
const purify_bulletproof_row_view * wv
const unsigned char * c32
const unsigned char * scalars32