purify
C++ Purify implementation with native circuit and BPP support
Loading...
Searching...
No Matches
purify::puresign_plusplus Namespace Reference

Namespaces

namespace  api_impl

Data Structures

class  NonceHost
struct  PublicKey
struct  Nonce
 Public BIP340 nonce point in x-only form. More...
struct  Signature
 Standard 64-byte BIP340 signature. More...
struct  MessageProofCache
 Cacheable message-bound nonce-proof template for the BPPP-backed PureSign++ proof(R) flow. More...
struct  TopicProofCache
 Cacheable topic-bound nonce-proof template for the BPPP-backed PureSign++ proof(R) flow. More...
struct  NonceProof
struct  ProvenSignature
class  PreparedNonce
 Move-only prepared nonce bound to either a message or a topic. More...
class  PreparedNonceWithProof
class  KeyPair
struct  CertificateNonceLeafParentConstants
struct  CertificateNoncePublicLeafDescriptor
class  PreparedCertificateNonceLeaf
class  CertificateNonceLeafAccumulator
struct  CertificateNonceResponseFrame
class  CertificateNonceResponseAuthorization
class  CertificateNonceRecursiveResponseView
class  CertificateNonceRecursiveManifest
class  CertificateNonceRecursiveManifestResolution
class  CertificateNonceParentPublicInputs
struct  CertificateNonceResponseProof
struct  CertificateNonceTreeProof
class  CertificateNonceNativeResponse
class  CertificateNonceNativeReceipt
struct  CertificateNonceLinearMemberProof
struct  CertificateNonceLinearResponseProof
class  CertificateNonceLinearReceipt
class  CertificateNonceResponseVerificationView
class  PendingCertificateNonceParent
class  CertificateNonceParentAccumulator
class  CertificateNonceResponseProverView
class  WipeOnDestruction

Typedefs

using Scalar32 = std::array<unsigned char, 32>
using XOnly32 = std::array<unsigned char, 32>
using Signature64 = std::array<unsigned char, 64>
using CertificateNonceAuthorizationManifest = bppp::ScalarBytes
using CertificateParentPublicFrame

Enumerations

enum class  CertificateNonceParentScope : std::uint8_t { AccountableTopic = 1 }

Functions

Result< bppp::accumulation::Digest > certificate_nonce_recursive_member_digest (const CertificateNonceResponseAuthorization &authorization, std::uint32_t member_ordinal, const PublicKey &host, const PreparedCertificateNonceLeaf &leaf, const accountable::ConflictContext &context, purify_secp_context *secp_context)
Result< bppp::accumulation::Digest > certificate_nonce_recursive_member_digest (const CertificateNonceLeafAccumulator &leaf_accumulator, const CertificateNonceResponseAuthorization &authorization, std::uint32_t member_ordinal, const PublicKey &host, const CertificateNoncePublicLeafDescriptor &descriptor, const accountable::ConflictContext &context, purify_secp_context *secp_context)
Result< bppp::accumulation::Digest > certificate_nonce_recursive_step_digest (const CertificateNonceResponseAuthorization &authorization, const accountable::ConflictContext &context, std::span< const unsigned char > canonical_body, const accountable::ScalarSignature &response, const bppp::accumulation::Digest &member_digest, purify_secp_context *secp_context)
Result< CertificateNonceRecursiveManifest > certificate_nonce_recursive_manifest_seed (const bppp::accumulation::Digest &certificate_context_digest, std::uint64_t total_responses)
Result< CertificateNonceRecursiveManifest > certificate_nonce_recursive_manifest_step (const CertificateNonceRecursiveManifest &prior, std::uint64_t response_ordinal, std::uint32_t member_ordinal, const bppp::accumulation::Digest &step_digest)
Result< std::vector< bppp::accumulation::Digest > > certificate_nonce_recursive_response_step_digests (const CertificateNonceLeafAccumulator &leaf_accumulator, const CertificateNonceRecursiveResponseView &response, purify_secp_context *secp_context)
Result< CertificateNonceRecursiveManifestResolution > certificate_nonce_recursive_manifest (const CertificateNonceLeafAccumulator &leaf_accumulator, const bppp::accumulation::Digest &certificate_context_digest, std::span< const CertificateNonceRecursiveResponseView > ordered_responses, purify_secp_context *secp_context)
Result< CertificateNonceAuthorizationManifest > certificate_nonce_authorization_manifest_seed (const bppp::accumulation::Digest &certificate_context_digest, std::uint64_t total_responses)
Result< CertificateNonceAuthorizationManifest > certificate_nonce_authorization_manifest_step (const CertificateNonceAuthorizationManifest &prior, std::uint64_t response_ordinal, std::uint32_t member_ordinal, const bppp::accumulation::Digest &member_digest)
Result< CertificateNonceAuthorizationManifest > certificate_nonce_authorization_manifest (const bppp::accumulation::Digest &certificate_context_digest, std::uint64_t total_responses, std::span< const CertificateNonceResponseAuthorization > responses)
Result< std::size_t > certificate_nonce_native_receipt_size (std::span< const std::size_t > member_counts)
Result< Bytes > serialize_certificate_nonce_native_receipt (const CertificateNonceParentAccumulator &accumulator, const CertificateNonceNativeReceipt &receipt, purify_secp_context *secp_context)
Result< CertificateNonceNativeReceipt > parse_certificate_nonce_native_receipt (const CertificateNonceParentAccumulator &accumulator, std::span< const unsigned char > encoded, purify_secp_context *secp_context)
Result< CertificateParentPublicFrame > serialize_certificate_parent_public_frame (const CertificateNonceRecursiveManifestResolution &resolution)
Result< Bytes > serialize_accepted_certificate_nonce_parent_witness (const CertificateNonceParentAccumulator &accumulator, const CertificateNonceNativeReceipt &receipt, std::span< const CertificateNonceResponseProverView > ordered_responses, purify_secp_context *secp_context, bppp::ExperimentalCircuitBackend *cache=nullptr)
Result< Bytes > serialize_accepted_linear_certificate_nonce_parent_witness (const CertificateNonceParentAccumulator &accumulator, const CertificateNonceLinearReceipt &receipt, std::span< const CertificateNonceResponseProverView > ordered_responses, purify_secp_context *secp_context, bppp::ExperimentalCircuitBackend *cache=nullptr)

Variables

constexpr std::size_t kCertificateParentPublicFrameSize = 96
constexpr std::size_t QUALIFIED_CERTIFICATE_PARENT_PROOF_SIZE

Typedef Documentation

◆ CertificateNonceAuthorizationManifest

One canonical 255-bit field encoding for an ordered member manifest.

Definition at line 371 of file certificate_nonce_parent_accumulation.hpp.

◆ CertificateParentPublicFrame

Initial value:
std::array<unsigned char, kCertificateParentPublicFrameSize>

Definition at line 24 of file certificate_nonce_parent_prover_input.hpp.

◆ Scalar32

using purify::puresign_plusplus::Scalar32 = std::array<unsigned char, 32>

Definition at line 23 of file bppp.hpp.

◆ Signature64

using purify::puresign_plusplus::Signature64 = std::array<unsigned char, 64>

Definition at line 25 of file bppp.hpp.

◆ XOnly32

using purify::puresign_plusplus::XOnly32 = std::array<unsigned char, 32>

Definition at line 24 of file bppp.hpp.

Enumeration Type Documentation

◆ CertificateNonceParentScope

Proof scope named by a certificate nonce-response parent.

Enumerator
AccountableTopic 

Definition at line 25 of file certificate_nonce_parent_accumulation.hpp.

Function Documentation

◆ certificate_nonce_authorization_manifest()

Result< CertificateNonceAuthorizationManifest > purify::puresign_plusplus::certificate_nonce_authorization_manifest ( const bppp::accumulation::Digest & certificate_context_digest,
std::uint64_t total_responses,
std::span< const CertificateNonceResponseAuthorization > responses )
nodiscard

◆ certificate_nonce_authorization_manifest_seed()

Result< CertificateNonceAuthorizationManifest > purify::puresign_plusplus::certificate_nonce_authorization_manifest_seed ( const bppp::accumulation::Digest & certificate_context_digest,
std::uint64_t total_responses )
nodiscard

◆ certificate_nonce_authorization_manifest_step()

Result< CertificateNonceAuthorizationManifest > purify::puresign_plusplus::certificate_nonce_authorization_manifest_step ( const CertificateNonceAuthorizationManifest & prior,
std::uint64_t response_ordinal,
std::uint32_t member_ordinal,
const bppp::accumulation::Digest & member_digest )
nodiscard

◆ certificate_nonce_native_receipt_size()

Result< std::size_t > purify::puresign_plusplus::certificate_nonce_native_receipt_size ( std::span< const std::size_t > member_counts)
nodiscard

◆ certificate_nonce_recursive_manifest()

Result< CertificateNonceRecursiveManifestResolution > purify::puresign_plusplus::certificate_nonce_recursive_manifest ( const CertificateNonceLeafAccumulator & leaf_accumulator,
const bppp::accumulation::Digest & certificate_context_digest,
std::span< const CertificateNonceRecursiveResponseView > ordered_responses,
purify_secp_context * secp_context )
nodiscard

Resolve a complete ordered public response sequence and manifest.

Definition at line 876 of file certificate_nonce_parent_accumulation.cpp.

◆ certificate_nonce_recursive_manifest_seed()

Result< CertificateNonceRecursiveManifest > purify::puresign_plusplus::certificate_nonce_recursive_manifest_seed ( const bppp::accumulation::Digest & certificate_context_digest,
std::uint64_t total_responses )
nodiscard

Seed the recursive record manifest for one certificate trace.

Definition at line 829 of file certificate_nonce_parent_accumulation.cpp.

Referenced by purify::puresign_plusplus::CertificateNonceRecursiveManifestResolution::certificate_nonce_recursive_manifest.

◆ certificate_nonce_recursive_manifest_step()

Result< CertificateNonceRecursiveManifest > purify::puresign_plusplus::certificate_nonce_recursive_manifest_step ( const CertificateNonceRecursiveManifest & prior,
std::uint64_t response_ordinal,
std::uint32_t member_ordinal,
const bppp::accumulation::Digest & step_digest )
nodiscard

Append one recursive step digest at its exact canonical position.

Definition at line 851 of file certificate_nonce_parent_accumulation.cpp.

Referenced by purify::puresign_plusplus::CertificateNonceRecursiveManifestResolution::certificate_nonce_recursive_manifest.

◆ certificate_nonce_recursive_member_digest() [1/2]

Result< bppp::accumulation::Digest > purify::puresign_plusplus::certificate_nonce_recursive_member_digest ( const CertificateNonceLeafAccumulator & leaf_accumulator,
const CertificateNonceResponseAuthorization & authorization,
std::uint32_t member_ordinal,
const PublicKey & host,
const CertificateNoncePublicLeafDescriptor & descriptor,
const accountable::ConflictContext & context,
purify_secp_context * secp_context )
nodiscard

Derive the same member digest from proof-free public leaf material.

Parent constants are recomputed from the host, accountable topic, and descriptor. Callers cannot supply constants recovered from a raw proof.

Definition at line 749 of file certificate_nonce_parent_accumulation.cpp.

References purify::puresign_plusplus::TopicProofCache::build(), purify::accountable::nonce_evaluation_input(), PURIFY_ASSIGN_OR_RETURN, and PURIFY_RETURN_IF_ERROR.

◆ certificate_nonce_recursive_member_digest() [2/2]

◆ certificate_nonce_recursive_response_step_digests()

Result< std::vector< bppp::accumulation::Digest > > purify::puresign_plusplus::certificate_nonce_recursive_response_step_digests ( const CertificateNonceLeafAccumulator & leaf_accumulator,
const CertificateNonceRecursiveResponseView & response,
purify_secp_context * secp_context )
nodiscard

Derive every recursive step digest for one public response.

Definition at line 816 of file certificate_nonce_parent_accumulation.cpp.

References PURIFY_RETURN_IF_ERROR.

◆ certificate_nonce_recursive_step_digest()

Result< bppp::accumulation::Digest > purify::puresign_plusplus::certificate_nonce_recursive_step_digest ( const CertificateNonceResponseAuthorization & authorization,
const accountable::ConflictContext & context,
std::span< const unsigned char > canonical_body,
const accountable::ScalarSignature & response,
const bppp::accumulation::Digest & member_digest,
purify_secp_context * secp_context )
nodiscard

Derive the response relation digest consumed by one recursive step.

This is framing, not authorization verification. The response binding is hashed in full beside the supplied signing key, scalar response, and the challenge recomputed from the supplied context and body. A mismatched set therefore derives a different value from the verifier-recomputed manifest; callers must compare that manifest before accepting the recursive result.

Definition at line 774 of file certificate_nonce_parent_accumulation.cpp.

References purify::puresign_plusplus::CertificateNonceResponseAuthorization::frame(), purify::puresign_plusplus::CertificateNonceParentAccumulator::kMaxResponses, purify::puresign_plusplus::CertificateNonceParentPublicInputs::kMemberBatchCapacity, purify::puresign_plusplus::CertificateNonceResponseAuthorization::member_digests(), PURIFY_ASSIGN_OR_RETURN, purify::RangeViolation, purify::puresign_plusplus::CertificateNonceResponseAuthorization::response_binding(), purify::accountable::ScalarSignature::serialize(), purify::accountable::signature_challenge(), purify::accountable::ConflictContext::signing_key, and purify::unexpected_error().

Referenced by purify::puresign_plusplus::CertificateNonceParentPublicInputs::create().

◆ parse_certificate_nonce_native_receipt()

Result< CertificateNonceNativeReceipt > purify::puresign_plusplus::parse_certificate_nonce_native_receipt ( const CertificateNonceParentAccumulator & accumulator,
std::span< const unsigned char > encoded,
purify_secp_context * secp_context )
nodiscard

◆ serialize_accepted_certificate_nonce_parent_witness()

Result< Bytes > purify::puresign_plusplus::serialize_accepted_certificate_nonce_parent_witness ( const CertificateNonceParentAccumulator & accumulator,
const CertificateNonceNativeReceipt & receipt,
std::span< const CertificateNonceResponseProverView > ordered_responses,
purify_secp_context * secp_context,
bppp::ExperimentalCircuitBackend * cache = nullptr )
nodiscard

Serialize an accepted native receipt together with its exact raw leaves.

Each V4 nonce proof is reauthenticated for its ordered host and accountable topic. The resulting leaves are then used to replay every receipt reduction and accumulation step through the final native decision. Bytes are returned only after that decision succeeds.

The joined witness carries each response's canonical statement bytes, verifier-derived V4 parent constants, and raw nonce proofs, followed by the exact canonical native receipt. It is prover input, not a compact proof or certificate admission result.

Definition at line 129 of file certificate_nonce_parent_prover_input.cpp.

References purify::BindingMismatch, purify::puresign_plusplus::TopicProofCache::build(), purify::puresign_plusplus::CertificateNonceNativeReceipt::certificate_context_digest(), purify::checked_mul_size(), purify::EmptyInput, purify::InternalMismatch, purify::puresign_plusplus::NonceProof::kSerializedSize, purify::puresign_plusplus::CertificateNonceParentAccumulator::leaves(), purify::accountable::nonce_evaluation_input(), purify::Overflow, purify::puresign_plusplus::CertificateNonceLeafAccumulator::prepare(), PURIFY_ASSIGN_OR_RETURN, PURIFY_RETURN_IF_ERROR, purify::require_secp_context(), purify::puresign_plusplus::CertificateNonceNativeReceipt::responses(), serialize_certificate_nonce_native_receipt(), purify::size_fits_u64(), purify::SizeMismatch, purify::unexpected_error(), and purify::puresign_plusplus::CertificateNonceParentAccumulator::verify_native_receipt().

◆ serialize_accepted_linear_certificate_nonce_parent_witness()

Result< Bytes > purify::puresign_plusplus::serialize_accepted_linear_certificate_nonce_parent_witness ( const CertificateNonceParentAccumulator & accumulator,
const CertificateNonceLinearReceipt & receipt,
std::span< const CertificateNonceResponseProverView > ordered_responses,
purify_secp_context * secp_context,
bppp::ExperimentalCircuitBackend * cache = nullptr )
nodiscard

◆ serialize_certificate_nonce_native_receipt()

◆ serialize_certificate_parent_public_frame()

Variable Documentation

◆ kCertificateParentPublicFrameSize

std::size_t purify::puresign_plusplus::kCertificateParentPublicFrameSize = 96
inlineconstexpr

Fixed external public frame consumed by the certificate prover.

Definition at line 23 of file certificate_nonce_parent_prover_input.hpp.

◆ QUALIFIED_CERTIFICATE_PARENT_PROOF_SIZE

std::size_t purify::puresign_plusplus::QUALIFIED_CERTIFICATE_PARENT_PROOF_SIZE
inlineconstexpr
Initial value:
{
15'268}

Exact wire size selected by certificate-parent qualification.

Definition at line 22 of file certificate_parent_verifier.hpp.