purify
C++ Purify implementation with native circuit and BPP support
Loading...
Searching...
No Matches
accountable_responses.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 <span>
8#include <utility>
9#include <vector>
10
14
15namespace purify::accountable {
16
21
25
28 const SigningRoster& roster,
29 std::span<const puresign_plusplus::PublicKey> ordered_hosts,
30 purify_secp_context* secp_context);
31
33 const NonceHostBoundSigningRoster& roster,
34 std::span<const puresign_plusplus::PublicKey> ordered_hosts,
35 purify_secp_context* secp_context);
36
38class VerifiedCoalitionNonceSet {
39public:
40 using Point = std::array<unsigned char, 33>;
41
42 [[nodiscard]] std::span<const Point> member_nonces() const {
43 return member_nonces_;
44 }
45 [[nodiscard]] const Point& aggregate_nonce() const {
46 return aggregate_nonce_;
47 }
48 [[nodiscard]] const std::array<unsigned char, 32>& signing_key() const {
49 return signing_key_;
50 }
51 [[nodiscard]] const NonceHostCommitment& host_commitment() const {
52 return host_commitment_;
53 }
54 [[nodiscard]] const CoalitionCoreDigest& coalition_core_digest() const {
55 return coalition_core_digest_;
56 }
57 [[nodiscard]] const std::array<unsigned char, 32>& nonce_input() const {
58 return nonce_input_;
59 }
60
61private:
63 std::vector<Point> member_nonces, Point aggregate_nonce,
64 std::array<unsigned char, 32> signing_key,
67 std::array<unsigned char, 32> nonce_input)
68 : member_nonces_(std::move(member_nonces)),
69 aggregate_nonce_(aggregate_nonce), signing_key_(signing_key),
70 host_commitment_(host_commitment),
71 coalition_core_digest_(coalition_core_digest),
72 nonce_input_(nonce_input) {}
73
74 std::vector<Point> member_nonces_;
75 Point aggregate_nonce_{};
76 std::array<unsigned char, 32> signing_key_{};
77 NonceHostCommitment host_commitment_{};
78 CoalitionCoreDigest coalition_core_digest_{};
79 std::array<unsigned char, 32> nonce_input_{};
80
82 const NonceHostBoundSigningRoster&, const ConflictContext&,
83 std::span<const puresign_plusplus::PublicKey>,
84 std::span<const puresign_plusplus::NonceProof>,
85 purify_secp_context*, bppp::ExperimentalCircuitBackend*);
87 const NonceHostBoundSigningRoster&,
88 const VerifiedCoalitionNonceSet&,
89 std::size_t, const ConflictContext&,
90 std::span<const unsigned char>, const PartialResponse&,
93 const NonceHostBoundSigningRoster&,
94 const VerifiedCoalitionNonceSet&,
95 const ConflictContext&, std::span<const unsigned char>,
96 std::span<const PartialResponse>, purify_secp_context*);
98 const NonceHostBoundSigningRoster&,
99 const VerifiedCoalitionNonceSet&,
100 const ConflictContext&, std::span<const unsigned char>,
101 const ScalarSignature&, purify_secp_context*);
102};
103
105class VerifiedScalarResponse {
106public:
107 [[nodiscard]] const ScalarSignature& response() const {
108 return response_;
109 }
110
111private:
113 ScalarSignature response, std::array<unsigned char, 33> nonce,
114 std::array<unsigned char, 32> signing_key,
115 NonceHostCommitment host_commitment,
116 CoalitionCoreDigest coalition_core_digest, Bytes slot, Bytes body)
117 : response_(response), nonce_(nonce), signing_key_(signing_key),
118 host_commitment_(host_commitment),
119 coalition_core_digest_(coalition_core_digest),
120 slot_(std::move(slot)), body_(std::move(body)) {}
121
122 ScalarSignature response_;
123 std::array<unsigned char, 33> nonce_{};
124 std::array<unsigned char, 32> signing_key_{};
125 NonceHostCommitment host_commitment_{};
126 CoalitionCoreDigest coalition_core_digest_{};
127 Bytes slot_;
128 Bytes body_;
129
131 const NonceHostBoundSigningRoster&,
132 const VerifiedCoalitionNonceSet&,
133 const ConflictContext&, std::span<const unsigned char>,
134 std::span<const PartialResponse>, purify_secp_context*);
136 const NonceHostBoundSigningRoster&,
137 const VerifiedCoalitionNonceSet&,
138 const ConflictContext&, std::span<const unsigned char>,
139 const ScalarSignature&, purify_secp_context*);
141 const VerifiedScalarResponse&, const VerifiedScalarResponse&,
143};
144
146class ExposedCoalitionKey {
147public:
148 [[nodiscard]] const FieldElement& scalar() const { return scalar_; }
149 [[nodiscard]] const std::array<unsigned char, 32>& signing_key() const {
150 return signing_key_;
151 }
152 [[nodiscard]] const NonceHostCommitment& host_commitment() const {
153 return host_commitment_;
154 }
155 [[nodiscard]] const CoalitionCoreDigest& coalition_core_digest() const {
156 return coalition_core_digest_;
157 }
158
159private:
161 FieldElement scalar, std::array<unsigned char, 32> signing_key,
164 : scalar_(scalar), signing_key_(signing_key),
165 host_commitment_(host_commitment),
166 coalition_core_digest_(coalition_core_digest) {}
167
168 FieldElement scalar_;
169 std::array<unsigned char, 32> signing_key_{};
170 NonceHostCommitment host_commitment_{};
171 CoalitionCoreDigest coalition_core_digest_{};
172
174 const VerifiedScalarResponse&, const VerifiedScalarResponse&,
176};
177
179 const NonceHostBoundSigningRoster& roster,
180 const ConflictContext& context,
181 std::span<const puresign_plusplus::PublicKey> ordered_hosts,
182 std::span<const puresign_plusplus::NonceProof> ordered_proofs,
183 purify_secp_context* secp_context,
184 bppp::ExperimentalCircuitBackend* cache = nullptr);
185
186[[nodiscard]] Status verify_partial_response(
187 const NonceHostBoundSigningRoster& roster,
188 const VerifiedCoalitionNonceSet& nonce_set, std::size_t member_index,
189 const ConflictContext& context,
190 std::span<const unsigned char> canonical_body,
191 const PartialResponse& partial, purify_secp_context* secp_context);
192
194 const NonceHostBoundSigningRoster& roster,
195 const VerifiedCoalitionNonceSet& nonce_set,
196 const ConflictContext& context,
197 std::span<const unsigned char> canonical_body,
198 std::span<const PartialResponse> partials,
199 purify_secp_context* secp_context);
200
202 const NonceHostBoundSigningRoster& roster,
203 const VerifiedCoalitionNonceSet& nonce_set,
204 const ConflictContext& context,
205 std::span<const unsigned char> canonical_body,
206 const ScalarSignature& response, purify_secp_context* secp_context);
207
209 const VerifiedScalarResponse& first,
210 const VerifiedScalarResponse& second,
211 purify_secp_context* secp_context);
212
213} // namespace purify::accountable
Experimental public transcripts for scalar-only accountable signatures.
Field element modulo the backend scalar field used by this implementation.
Definition numeric.hpp:834
const NonceHostCommitment & host_commitment() const
friend Result< ExposedCoalitionKey > recover_verified_same_slot_key(const VerifiedScalarResponse &, const VerifiedScalarResponse &, purify_secp_context *)
const CoalitionCoreDigest & coalition_core_digest() const
const std::array< unsigned char, 32 > & signing_key() const
An ordered signing roster bound to one core and nonce-host list.
Canonical 32-byte scalar response; carries no nonce or proof.
Experimental public key aggregation for one ordered coalition roster.
friend Result< VerifiedCoalitionNonceSet > verify_coalition_nonce_set(const NonceHostBoundSigningRoster &, const ConflictContext &, std::span< const puresign_plusplus::PublicKey >, std::span< const puresign_plusplus::NonceProof >, purify_secp_context *, bppp::ExperimentalCircuitBackend *)
friend Result< VerifiedScalarResponse > aggregate_responses(const NonceHostBoundSigningRoster &, const VerifiedCoalitionNonceSet &, const ConflictContext &, std::span< const unsigned char >, std::span< const PartialResponse >, purify_secp_context *)
const NonceHostCommitment & host_commitment() const
const std::array< unsigned char, 32 > & signing_key() const
const CoalitionCoreDigest & coalition_core_digest() const
friend Status verify_partial_response(const NonceHostBoundSigningRoster &, const VerifiedCoalitionNonceSet &, std::size_t, const ConflictContext &, std::span< const unsigned char >, const PartialResponse &, purify_secp_context *)
const std::array< unsigned char, 32 > & nonce_input() const
friend Result< VerifiedScalarResponse > verify_scalar_response(const NonceHostBoundSigningRoster &, const VerifiedCoalitionNonceSet &, const ConflictContext &, std::span< const unsigned char >, const ScalarSignature &, purify_secp_context *)
friend Result< VerifiedScalarResponse > aggregate_responses(const NonceHostBoundSigningRoster &, const VerifiedCoalitionNonceSet &, const ConflictContext &, std::span< const unsigned char >, std::span< const PartialResponse >, purify_secp_context *)
friend Result< ExposedCoalitionKey > recover_verified_same_slot_key(const VerifiedScalarResponse &, const VerifiedScalarResponse &, purify_secp_context *)
friend Result< VerifiedScalarResponse > verify_scalar_response(const NonceHostBoundSigningRoster &, const VerifiedCoalitionNonceSet &, const ConflictContext &, std::span< const unsigned char >, const ScalarSignature &, purify_secp_context *)
Result< NonceHostCommitment > nonce_host_commitment(const SigningRoster &roster, std::span< const puresign_plusplus::PublicKey > ordered_hosts, purify_secp_context *secp_context)
Result< VerifiedCoalitionNonceSet > verify_coalition_nonce_set(const NonceHostBoundSigningRoster &roster, const ConflictContext &context, std::span< const puresign_plusplus::PublicKey > ordered_hosts, std::span< const puresign_plusplus::NonceProof > ordered_proofs, purify_secp_context *secp_context, bppp::ExperimentalCircuitBackend *cache=nullptr)
Result< ExposedCoalitionKey > recover_verified_same_slot_key(const VerifiedScalarResponse &first, const VerifiedScalarResponse &second, purify_secp_context *secp_context)
std::array< unsigned char, 32 > CoalitionCoreDigest
Status verify_partial_response(const NonceHostBoundSigningRoster &roster, const VerifiedCoalitionNonceSet &nonce_set, std::size_t member_index, const ConflictContext &context, std::span< const unsigned char > canonical_body, const PartialResponse &partial, purify_secp_context *secp_context)
std::array< unsigned char, 32 > NonceHostCommitment
Result< VerifiedScalarResponse > verify_scalar_response(const NonceHostBoundSigningRoster &roster, const VerifiedCoalitionNonceSet &nonce_set, const ConflictContext &context, std::span< const unsigned char > canonical_body, const ScalarSignature &response, purify_secp_context *secp_context)
Result< VerifiedScalarResponse > aggregate_responses(const NonceHostBoundSigningRoster &roster, const VerifiedCoalitionNonceSet &nonce_set, const ConflictContext &context, std::span< const unsigned char > canonical_body, std::span< const PartialResponse > partials, purify_secp_context *secp_context)
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
Experimental BPPP-backed PureSign proof(R) helpers.
struct purify_secp_context purify_secp_context
Caller-owned reusable secp256k1 context handle shared across Purify C and C++ APIs.
Public context shared by conflicting statements in one slashable slot.