purify
C++ Purify implementation with native circuit and BPP support
Loading...
Searching...
No Matches
algebraic_circuit_proof.hpp
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
5#pragma once
6
7#include <array>
8#include <optional>
9#include <span>
10#include <utility>
11#include <vector>
12
14
16
36
42
45 const CircuitZkNormArgProofV4 &proof,
46 CircuitCommitmentModeV4 mode, std::size_t round_count,
47 purify_secp_context *secp_context);
48
51 const NativeBulletproofCircuit &circuit,
52 const CircuitZkNormArgProofV4 &proof,
53 purify_secp_context *secp_context);
54
56[[nodiscard]] Status
58 const NativeBulletproofCircuit &circuit,
59 const CircuitZkNormArgProofV4 &proof,
60 std::span<const PointBytes> public_commitments,
61 purify_secp_context *secp_context);
62
66 const NativeBulletproofCircuit &circuit,
68 purify_secp_context *secp_context,
69 std::span<const unsigned char> statement_binding);
70
74 const NativeBulletproofCircuit &circuit,
76 std::span<const PointBytes> public_commitments,
77 purify_secp_context *secp_context,
78 std::span<const unsigned char> statement_binding);
79
93class PreparedCircuitZkNormArgV4 {
94public:
95 [[nodiscard]] const CircuitTranscriptShapeV4 &shape() const noexcept {
96 return shape_;
97 }
99 const noexcept {
100 return circuit_binding_digest_;
101 }
102 [[nodiscard]] const std::vector<PointBytes> &
103 raw_generators() const noexcept {
104 return raw_generators_;
105 }
106 [[nodiscard]] const CircuitProofTranscriptInputV4 &
107 transcript_input() const noexcept {
108 return transcript_input_;
109 }
110 [[nodiscard]] const CircuitProofTranscriptResultV4 &
111 transcript() const noexcept {
112 return transcript_;
113 }
114 [[nodiscard]] const NormArgProof &norm() const noexcept { return norm_; }
115 [[nodiscard]] NormArgProof take_norm() && noexcept {
116 return std::move(norm_);
117 }
118 [[nodiscard]] const PointBytes &pending_norm_residual() const noexcept {
119 return pending_norm_residual_;
120 }
121
122private:
126 std::vector<PointBytes> raw_generators,
130 : shape_(std::move(shape)),
131 circuit_binding_digest_(std::move(circuit_binding_digest)),
132 raw_generators_(std::move(raw_generators)),
133 transcript_input_(std::move(transcript_input)),
134 transcript_(std::move(transcript)), norm_(std::move(norm)),
135 pending_norm_residual_(pending_norm_residual) {}
136
137 CircuitTranscriptShapeV4 shape_;
138 TranscriptDigest circuit_binding_digest_{};
139 std::vector<PointBytes> raw_generators_;
140 CircuitProofTranscriptInputV4 transcript_input_;
141 CircuitProofTranscriptResultV4 transcript_;
142 NormArgProof norm_;
143 PointBytes pending_norm_residual_{};
144
149 std::span<const PointBytes>, purify_secp_context *,
150 std::span<const unsigned char>, bool,
152};
153
156 const NativeBulletproofCircuit &circuit,
157 const CircuitZkNormArgPublicationV4 &publication,
158 std::span<const PointBytes> public_commitments,
159 purify_secp_context *secp_context,
160 std::span<const unsigned char> statement_binding,
161 bool externalize_commitments,
163
171
182 const NativeBulletproofCircuit &circuit,
183 const CircuitPrecommitmentDigestV4 &precommitment,
184 std::span<const PointBytes> public_commitments,
185 purify_secp_context *secp_context,
186 std::span<const unsigned char> statement_binding);
187
198 const NativeBulletproofCircuit &circuit,
199 const BulletproofAssignmentData &assignment,
200 const ScalarBytes &secret_prover_seed,
201 purify_secp_context *secp_context,
202 std::span<const unsigned char> statement_binding,
203 ExperimentalCircuitBackend *cache = nullptr);
204
216 const NativeBulletproofCircuit &circuit,
217 const BulletproofAssignmentData &assignment,
218 const ScalarBytes &secret_prover_seed,
219 std::span<const PointBytes> public_commitments,
220 purify_secp_context *secp_context,
221 std::span<const unsigned char> statement_binding,
222 ExperimentalCircuitBackend *cache = nullptr);
223
226 const NativeBulletproofCircuit &circuit,
227 const CircuitZkNormArgPublicationV4 &publication,
228 purify_secp_context *secp_context,
229 std::span<const unsigned char> statement_binding,
230 ExperimentalCircuitBackend *cache = nullptr);
231
234 const NativeBulletproofCircuit &circuit,
235 const CircuitZkNormArgPublicationV4 &publication,
236 std::span<const PointBytes> public_commitments,
237 purify_secp_context *secp_context,
238 std::span<const unsigned char> statement_binding,
239 ExperimentalCircuitBackend *cache = nullptr);
240
242 const NativeBulletproofCircuit &circuit,
243 const CircuitZkNormArgPublicationV4 &publication,
244 purify_secp_context *secp_context,
245 std::span<const unsigned char> statement_binding,
246 ExperimentalCircuitBackend *cache = nullptr);
247
248[[nodiscard]] Result<bool>
250 const NativeBulletproofCircuit &circuit,
251 const CircuitZkNormArgPublicationV4 &publication,
252 std::span<const PointBytes> public_commitments,
253 purify_secp_context *secp_context,
254 std::span<const unsigned char> statement_binding,
255 ExperimentalCircuitBackend *cache = nullptr);
256
257} // namespace purify::bppp::candidate
Common interface for reusable experimental BPPP backend state.
Definition bppp.hpp:129
const std::vector< PointBytes > & raw_generators() const noexcept
const CircuitProofTranscriptResultV4 & transcript() const noexcept
const CircuitTranscriptShapeV4 & shape() const noexcept
friend Result< std::optional< PreparedCircuitZkNormArgV4 > > prepare_circuit_zk_norm_arg_v4_impl(const NativeBulletproofCircuit &, const CircuitZkNormArgPublicationV4 &, std::span< const PointBytes >, purify_secp_context *, std::span< const unsigned char >, bool, ExperimentalCircuitBackend *)
const TranscriptDigest & circuit_binding_digest() const noexcept
const CircuitProofTranscriptInputV4 & transcript_input() const noexcept
Result< CircuitZkNormArgPublicationV4 > prove_circuit_zk_norm_arg_v4_with_public_commitments(const NativeBulletproofCircuit &circuit, const BulletproofAssignmentData &assignment, const ScalarBytes &secret_prover_seed, std::span< const PointBytes > public_commitments, purify_secp_context *secp_context, std::span< const unsigned char > statement_binding, ExperimentalCircuitBackend *cache=nullptr)
Definition bppp.cpp:3638
Result< CircuitZkNormArgPublicationV4 > reconstruct_circuit_zk_norm_arg_publication_v4_with_public_commitments(const NativeBulletproofCircuit &circuit, CircuitZkNormArgProofV4 proof, std::span< const PointBytes > public_commitments, purify_secp_context *secp_context, std::span< const unsigned char > statement_binding)
Definition bppp.cpp:3362
Result< bool > verify_circuit_zk_norm_arg_v4_with_public_commitments(const NativeBulletproofCircuit &circuit, const CircuitZkNormArgPublicationV4 &publication, std::span< const PointBytes > public_commitments, purify_secp_context *secp_context, std::span< const unsigned char > statement_binding, ExperimentalCircuitBackend *cache=nullptr)
Definition bppp.cpp:3772
Status validate_circuit_zk_norm_arg_proof_v4_encoding_with_public_commitments(const NativeBulletproofCircuit &circuit, const CircuitZkNormArgProofV4 &proof, std::span< const PointBytes > public_commitments, purify_secp_context *secp_context)
Definition bppp.cpp:3340
Status validate_circuit_zk_norm_arg_proof_v4_fixed_encoding(const CircuitZkNormArgProofV4 &proof, CircuitCommitmentModeV4 mode, std::size_t round_count, purify_secp_context *secp_context)
Definition bppp.cpp:3323
Result< std::optional< PreparedCircuitZkNormArgV4 > > prepare_circuit_zk_norm_arg_v4_with_public_commitments(const NativeBulletproofCircuit &circuit, const CircuitZkNormArgPublicationV4 &publication, std::span< const PointBytes > public_commitments, purify_secp_context *secp_context, std::span< const unsigned char > statement_binding, ExperimentalCircuitBackend *cache=nullptr)
Definition bppp.cpp:3664
Result< std::optional< PreparedCircuitZkNormArgV4 > > prepare_circuit_zk_norm_arg_v4_impl(const NativeBulletproofCircuit &circuit, const CircuitZkNormArgPublicationV4 &publication, std::span< const PointBytes > public_commitments, purify_secp_context *secp_context, std::span< const unsigned char > statement_binding, bool externalize_commitments, ExperimentalCircuitBackend *cache)
Definition bppp.cpp:3374
Result< CircuitNormParentConstantsV4 > derive_circuit_norm_parent_constants_v4_with_public_commitments(const NativeBulletproofCircuit &circuit, const CircuitPrecommitmentDigestV4 &precommitment, std::span< const PointBytes > public_commitments, purify_secp_context *secp_context, std::span< const unsigned char > statement_binding)
Definition bppp.cpp:3744
Result< CircuitZkNormArgPublicationV4 > prove_circuit_zk_norm_arg_v4(const NativeBulletproofCircuit &circuit, const BulletproofAssignmentData &assignment, const ScalarBytes &secret_prover_seed, purify_secp_context *secp_context, std::span< const unsigned char > statement_binding, ExperimentalCircuitBackend *cache=nullptr)
Definition bppp.cpp:3625
Status validate_circuit_zk_norm_arg_proof_v4_encoding(const NativeBulletproofCircuit &circuit, const CircuitZkNormArgProofV4 &proof, purify_secp_context *secp_context)
Definition bppp.cpp:3331
Result< bool > verify_circuit_zk_norm_arg_v4(const NativeBulletproofCircuit &circuit, const CircuitZkNormArgPublicationV4 &publication, purify_secp_context *secp_context, std::span< const unsigned char > statement_binding, ExperimentalCircuitBackend *cache=nullptr)
Definition bppp.cpp:3755
Result< CircuitZkNormArgPublicationV4 > reconstruct_circuit_zk_norm_arg_publication_v4(const NativeBulletproofCircuit &circuit, CircuitZkNormArgProofV4 proof, purify_secp_context *secp_context, std::span< const unsigned char > statement_binding)
Definition bppp.cpp:3350
Result< std::optional< PreparedCircuitZkNormArgV4 > > prepare_circuit_zk_norm_arg_v4(const NativeBulletproofCircuit &circuit, const CircuitZkNormArgPublicationV4 &publication, purify_secp_context *secp_context, std::span< const unsigned char > statement_binding, ExperimentalCircuitBackend *cache=nullptr)
Definition bppp.cpp:3652
TranscriptBytes32 TranscriptDigest
std::array< unsigned char, 33 > PointBytes
Compressed 33-byte curve-point encoding.
Definition bppp.hpp:32
std::array< unsigned char, 32 > ScalarBytes
Big-endian 32-byte scalar encoding.
Definition bppp.hpp:30
Expected< T, Error > Result
Expected-returning convenience alias for Purify value-producing APIs.
Definition error.hpp:99
Expected< void, Error > Status
Expected-returning convenience alias for Purify status-only APIs.
Definition error.hpp:102
std::vector< unsigned char > Bytes
Dynamically sized byte string used for messages, serialized witnesses, and proofs.
Definition common.hpp:99
Columnar witness assignment compatible with the native Bulletproof circuit layout.
Native in-memory representation of a Bulletproof-style arithmetic circuit.
Standalone BPPP norm-argument proof bundle with all verifier-side inputs.
Definition bppp.hpp:118