purify
C++ Purify implementation with native circuit and BPP support
Loading...
Searching...
No Matches
sha256_circuit_transcript.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 <cstddef>
9#include <cstdint>
10#include <span>
11#include <utility>
12#include <vector>
13
14#include "sha256_transcript.hpp"
15#include "purify/bppp.hpp"
16
18
20enum class CircuitCommitmentModeV4 : std::uint64_t {
21 Hidden = 0,
22 Public = 1,
23};
24
26class CircuitTranscriptShapeV4 {
27public:
28 [[nodiscard]] static Result<CircuitTranscriptShapeV4>
30 std::size_t commitment_count, std::size_t n_vec_len,
31 std::size_t l_vec_len);
32
33 [[nodiscard]] CircuitCommitmentModeV4 mode() const noexcept { return mode_; }
34 [[nodiscard]] std::size_t gate_count() const noexcept { return gate_count_; }
35 [[nodiscard]] std::size_t commitment_count() const noexcept {
36 return commitment_count_;
37 }
38 [[nodiscard]] std::size_t n_vec_len() const noexcept { return n_vec_len_; }
39 [[nodiscard]] std::size_t l_vec_len() const noexcept { return l_vec_len_; }
40 [[nodiscard]] std::size_t round_count() const noexcept;
41 [[nodiscard]] std::size_t public_commitment_count() const noexcept;
42
43private:
45 std::size_t commitment_count, std::size_t n_vec_len,
46 std::size_t l_vec_len)
47 : mode_(mode), gate_count_(gate_count),
48 commitment_count_(commitment_count), n_vec_len_(n_vec_len),
49 l_vec_len_(l_vec_len) {}
50
52 std::size_t gate_count_{0};
53 std::size_t commitment_count_{0};
54 std::size_t n_vec_len_{0};
55 std::size_t l_vec_len_{0};
56};
57
59class CircuitPrecommitmentDigestV4 {
60public:
61 [[nodiscard]] static Result<CircuitPrecommitmentDigestV4>
62 parse(const ScalarBytes &encoded);
63
64 [[nodiscard]] const FieldElement &scalar() const noexcept { return scalar_; }
65 [[nodiscard]] ScalarBytes bytes() const { return scalar_.to_bytes_be(); }
66
67private:
69 : scalar_(std::move(scalar)) {}
70
71 FieldElement scalar_;
72};
73
78
82
83using PackedPointPairV4 = std::array<unsigned char, 65>;
84
87 const PackedPointPairV4 &encoded,
88 purify_secp_context *secp_context);
89
106
119
127class CircuitProofTranscriptV4 {
128public:
129 [[nodiscard]] static Result<CircuitProofTranscriptV4>
131 const CircuitPrecommitmentDigestV4 &precommitment,
132 const TranscriptDigest &raw_generator_digest);
133
134 [[nodiscard]] const CircuitChallengeV4 &rho() const noexcept {
135 return rho_;
136 }
137 [[nodiscard]] const CircuitTranscriptShapeV4 &shape() const noexcept {
138 return shape_;
139 }
140 [[nodiscard]] const CircuitChallengeV4 &mul_scale() const noexcept {
141 return mul_scale_;
142 }
143 [[nodiscard]] const CircuitChallengeV4 &mul_ratio() const noexcept {
144 return mul_ratio_;
145 }
146 [[nodiscard]] const CircuitChallengeV4 &row_ratio() const noexcept {
147 return row_ratio_;
148 }
149
150 [[nodiscard]] Result<CircuitChallengeV4>
151 append_anchored_commitments(const PointBytes &coefficient_commitment,
152 const PointBytes &anchored_offset,
153 const PointBytes &anchored_commitment,
154 purify_secp_context *secp_context);
155
156 [[nodiscard]] Result<CircuitChallengeV4>
158 const PointBytes &batched_public_commitment,
159 const std::array<unsigned char, 32> &dlog_nonce,
160 purify_secp_context *secp_context);
161
162 [[nodiscard]] Status append_dlog_response(
163 const FieldElement &dlog_response);
164
165 [[nodiscard]] Result<CircuitChallengeV4>
166 append_mask(const PointBytes &mask_commitment, const FieldElement &t2,
167 purify_secp_context *secp_context);
168
170 const PointBytes &combined_commitment,
171 purify_secp_context *secp_context);
172
173 [[nodiscard]] Result<CircuitChallengeV4>
174 append_round(const PackedPointPairV4 &round,
175 purify_secp_context *secp_context);
176
177 [[nodiscard]] Result<CircuitChallengeV4>
178 finish(const FieldElement &terminal_n, const FieldElement &terminal_l);
179
180private:
181 enum class Stage {
182 AnchoredCommitments,
183 PublicOpening,
184 DlogResponse,
185 Mask,
186 CombinedCommitment,
187 Rounds,
188 Terminal,
189 Finished,
190 };
191
192 CircuitProofTranscriptV4(CircuitTranscriptShapeV4 shape,
193 Sha256Transcript transcript,
194 CircuitChallengeV4 rho,
195 CircuitChallengeV4 mul_scale,
196 CircuitChallengeV4 mul_ratio,
197 CircuitChallengeV4 row_ratio)
198 : shape_(shape), transcript_(std::move(transcript)),
199 rho_(std::move(rho)), mul_scale_(std::move(mul_scale)),
200 mul_ratio_(std::move(mul_ratio)), row_ratio_(std::move(row_ratio)) {}
201
202 CircuitTranscriptShapeV4 shape_;
203 Sha256Transcript transcript_;
204 CircuitChallengeV4 rho_;
205 CircuitChallengeV4 mul_scale_;
206 CircuitChallengeV4 mul_ratio_;
207 CircuitChallengeV4 row_ratio_;
208 Stage stage_{Stage::AnchoredCommitments};
209 std::size_t next_round_{0};
210};
211
220 const TranscriptDigest &circuit_binding_digest,
221 std::span<const PointBytes> public_commitments,
222 const PointBytes &raw_commitment,
223 purify_secp_context *secp_context);
224
228 const CircuitTranscriptShapeV4 &shape,
229 const CircuitPrecommitmentDigestV4 &precommitment,
231 purify_secp_context *secp_context);
232
233} // namespace purify::bppp::candidate
C++ wrappers for the BPPP functionality used by Purify.
Field element modulo the backend scalar field used by this implementation.
Definition numeric.hpp:834
static Result< CircuitPrecommitmentDigestV4 > parse(const ScalarBytes &encoded)
Result< CircuitChallengeV4 > finish(const FieldElement &terminal_n, const FieldElement &terminal_l)
Status append_dlog_response(const FieldElement &dlog_response)
Result< CircuitChallengeV4 > append_mask(const PointBytes &mask_commitment, const FieldElement &t2, purify_secp_context *secp_context)
const CircuitChallengeV4 & mul_ratio() const noexcept
Result< CircuitChallengeV4 > append_public_opening(const PointBytes &batched_public_commitment, const std::array< unsigned char, 32 > &dlog_nonce, purify_secp_context *secp_context)
static Result< CircuitProofTranscriptV4 > create(const CircuitTranscriptShapeV4 &shape, const CircuitPrecommitmentDigestV4 &precommitment, const TranscriptDigest &raw_generator_digest)
const CircuitTranscriptShapeV4 & shape() const noexcept
Result< CircuitChallengeV4 > append_round(const PackedPointPairV4 &round, purify_secp_context *secp_context)
const CircuitChallengeV4 & mul_scale() const noexcept
Result< CircuitChallengeV4 > append_anchored_commitments(const PointBytes &coefficient_commitment, const PointBytes &anchored_offset, const PointBytes &anchored_commitment, purify_secp_context *secp_context)
Status append_combined_commitment(const PointBytes &combined_commitment, purify_secp_context *secp_context)
const CircuitChallengeV4 & rho() const noexcept
const CircuitChallengeV4 & row_ratio() const noexcept
static Result< CircuitTranscriptShapeV4 > create(CircuitCommitmentModeV4 mode, std::size_t gate_count, std::size_t commitment_count, std::size_t n_vec_len, std::size_t l_vec_len)
Status validate_packed_point_pair_v4(const PackedPointPairV4 &encoded, purify_secp_context *secp_context)
Result< CircuitPrecommitmentResultV4 > derive_circuit_precommitment_v4(const CircuitTranscriptShapeV4 &shape, const TranscriptDigest &circuit_binding_digest, std::span< const PointBytes > public_commitments, const PointBytes &raw_commitment, purify_secp_context *secp_context)
Result< CircuitProofTranscriptResultV4 > derive_circuit_proof_transcript_v4(const CircuitTranscriptShapeV4 &shape, const CircuitPrecommitmentDigestV4 &precommitment, const CircuitProofTranscriptInputV4 &proof, purify_secp_context *secp_context)
std::array< unsigned char, 65 > PackedPointPairV4
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
struct purify_secp_context purify_secp_context
Caller-owned reusable secp256k1 context handle shared across Purify C and C++ APIs.