purify
C++ Purify implementation with native circuit and BPP support
Loading...
Searching...
No Matches
accountable_roster.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 <cstdint>
9#include <limits>
10#include <span>
11#include <utility>
12#include <vector>
13
14#include "purify/numeric.hpp"
16
18struct PublicKey;
19}
20
21namespace purify::accountable {
22
24using NonceHostCommitment = std::array<unsigned char, 32>;
25
26class SigningRoster;
32
41 SigningRoster roster, const CoalitionFormation& formation,
42 std::span<const puresign_plusplus::PublicKey> ordered_hosts,
43 purify_secp_context* secp_context);
44
53 SigningRoster roster, const CoalitionCoreDigest& coalition_core_digest,
54 std::span<const puresign_plusplus::PublicKey> ordered_hosts,
55 purify_secp_context* secp_context);
56
68 NonceHostBoundSigningRoster roster, const UInt512& recovery_root,
69 const RecoveryRootSetupProof& proof,
70 purify_secp_context* secp_context);
71
74 std::array<unsigned char, 33> public_key;
77};
78
88class SigningRoster {
89public:
90 static constexpr std::size_t kMaxMembers =
91 std::numeric_limits<std::uint32_t>::max();
92
93 [[nodiscard]] static Result<SigningRoster> aggregate(
94 std::span<const std::array<unsigned char, 33>> ordered_public_keys,
95 purify_secp_context* secp_context);
96
98 [[nodiscard]] std::span<const SigningRosterMember> members() const { return members_; }
99
101 [[nodiscard]] const std::array<unsigned char, 32>& signing_key() const { return signing_key_; }
102
104 [[nodiscard]] const std::array<unsigned char, 32>& key_list_hash() const { return key_list_hash_; }
105
107 [[nodiscard]] bool aggregate_was_negated() const { return aggregate_was_negated_; }
108
109private:
110 SigningRoster() = default;
111
112 std::vector<SigningRosterMember> members_;
113 std::array<unsigned char, 32> signing_key_{};
114 std::array<unsigned char, 32> key_list_hash_{};
115 bool aggregate_was_negated_ = false;
116};
117
126class NonceHostBoundSigningRoster {
127public:
129 [[nodiscard]] const SigningRoster& signing_roster() const noexcept {
130 return roster_;
131 }
132
133 [[nodiscard]] std::span<const SigningRosterMember> members() const {
134 return roster_.members();
135 }
136 [[nodiscard]] const std::array<unsigned char, 32>& signing_key() const {
137 return roster_.signing_key();
138 }
139 [[nodiscard]] const std::array<unsigned char, 32>& key_list_hash() const {
140 return roster_.key_list_hash();
141 }
142 [[nodiscard]] bool aggregate_was_negated() const {
143 return roster_.aggregate_was_negated();
144 }
145 [[nodiscard]] const CoalitionCoreDigest& coalition_core_digest() const {
146 return coalition_core_digest_;
147 }
148 [[nodiscard]] const NonceHostCommitment& nonce_host_commitment() const {
149 return nonce_host_commitment_;
150 }
151
152private:
154 SigningRoster roster,
157 : roster_(std::move(roster)),
158 coalition_core_digest_(coalition_core_digest),
159 nonce_host_commitment_(nonce_host_commitment) {}
160
161 SigningRoster roster_;
162 CoalitionCoreDigest coalition_core_digest_{};
163 NonceHostCommitment nonce_host_commitment_{};
164
166 SigningRoster, const CoalitionCoreDigest&,
167 std::span<const puresign_plusplus::PublicKey>,
170};
171
179class RecoveryBoundSigningRoster final
180 : public NonceHostBoundSigningRoster {
181public:
182 [[nodiscard]] const UInt512& recovery_root() const {
183 return recovery_root_;
184 }
185
186private:
190 : NonceHostBoundSigningRoster(std::move(roster)),
191 recovery_root_(recovery_root) {}
192
193 UInt512 recovery_root_{};
194
196 NonceHostBoundSigningRoster, const UInt512&,
197 const RecoveryRootSetupProof&, purify_secp_context*);
200};
201
202} // namespace purify::accountable
Field element modulo the backend scalar field used by this implementation.
Definition numeric.hpp:834
An ordered signing roster bound to one core and nonce-host list.
std::span< const SigningRosterMember > members() const
const std::array< unsigned char, 32 > & signing_key() const
const std::array< unsigned char, 32 > & key_list_hash() const
const SigningRoster & signing_roster() const noexcept
const NonceHostCommitment & nonce_host_commitment() const
const CoalitionCoreDigest & coalition_core_digest() const
friend Result< NonceHostBoundSigningRoster > bind_nonce_hosts(SigningRoster, const CoalitionCoreDigest &, std::span< const puresign_plusplus::PublicKey >, purify_secp_context *)
A nonce-host-bound roster with an authorized recovery-root relation.
friend Result< RecoveryBoundSigningRoster > verify_recovery_root_setup(NonceHostBoundSigningRoster, const UInt512 &, const RecoveryRootSetupProof &, purify_secp_context *)
Experimental public key aggregation for one ordered coalition roster.
bool aggregate_was_negated() const
Whether the unnormalized weighted sum had odd Y.
std::span< const SigningRosterMember > members() const
Members in their original order; effective weights include parity.
static constexpr std::size_t kMaxMembers
const std::array< unsigned char, 32 > & signing_key() const
Canonical even-Y aggregate signing key for ConflictContext.
static Result< SigningRoster > aggregate(std::span< const std::array< unsigned char, 33 > > ordered_public_keys, purify_secp_context *secp_context)
const std::array< unsigned char, 32 > & key_list_hash() const
BIP327 key-list hash; this is NOT the authenticated Purify host commitment U.
One-shot Bitcoin bindings for accountable coalition formation.
Result< NonceHostCommitment > nonce_host_commitment(const SigningRoster &roster, std::span< const puresign_plusplus::PublicKey > ordered_hosts, purify_secp_context *secp_context)
Result< RecoveryBoundSigningRoster > verify_recovery_root_setup(NonceHostBoundSigningRoster roster, const UInt512 &recovery_root, const RecoveryRootSetupProof &proof, purify_secp_context *secp_context)
Result< NonceHostBoundSigningRoster > bind_nonce_hosts(SigningRoster roster, const CoalitionCoreDigest &coalition_core_digest, std::span< const puresign_plusplus::PublicKey > ordered_hosts, purify_secp_context *secp_context)
std::array< unsigned char, 32 > CoalitionCoreDigest
std::array< unsigned char, 32 > NonceHostCommitment
Result< NonceHostBoundSigningRoster > bind_formation_nonce_hosts(SigningRoster roster, const CoalitionFormation &formation, std::span< const puresign_plusplus::PublicKey > ordered_hosts, purify_secp_context *secp_context)
BigUInt< 8 > UInt512
512-bit unsigned integer used for private and packed public keys.
Definition numeric.hpp:821
Expected< T, Error > Result
Expected-returning convenience alias for Purify value-producing APIs.
Definition error.hpp:99
Fixed-width integer and field arithmetic helpers used throughout Purify.
struct purify_secp_context purify_secp_context
Caller-owned reusable secp256k1 context handle shared across Purify C and C++ APIs.
An ordered individual signing key and its normalized public weight.
FieldElement coefficient
BIP327 key coefficient multiplied by the aggregate parity sign.
std::array< unsigned char, 33 > public_key