purify
C++ Purify implementation with native circuit and BPP support
Loading...
Searching...
No Matches
certificate_parent_verifier.cpp
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
6
7#include <array>
8#include <cstddef>
9#include <cstdint>
10#include <utility>
11
13
15namespace {
16
17static_assert(
20static_assert(
21 CertificateParentVerifier::kProofSize ==
23
24Unexpected<Error> load_error(
26{
27 switch (status) {
29 return unexpected_error(
31 "certificate_parent:artifact_path");
33 return unexpected_error(
35 "certificate_parent:artifact_open");
37 return unexpected_error(
39 "certificate_parent:artifact_identity");
41 return unexpected_error(
43 "certificate_parent:artifact_snapshot");
48 return unexpected_error(
50 "certificate_parent:artifact_backend");
51 }
52 return unexpected_error(
54 "certificate_parent:artifact_status");
55}
56
57Unexpected<Error> verify_error(
59{
60 switch (status) {
62 return unexpected_error(
64 "certificate_parent:malformed");
66 return unexpected_error(
68 "certificate_parent:proof");
75 return unexpected_error(
77 "certificate_parent:backend");
78 }
79 return unexpected_error(
81 "certificate_parent:status");
82}
83
84} // namespace
85
97
98CertificateParentVerifier::CertificateParentVerifier(
99 std::unique_ptr<Impl> impl)
100 : impl_(std::move(impl)) {}
101
102CertificateParentVerifier::CertificateParentVerifier(
103 CertificateParentVerifier&&) noexcept = default;
104
105CertificateParentVerifier& CertificateParentVerifier::operator=(
106 CertificateParentVerifier&&) noexcept = default;
107
108CertificateParentVerifier::~CertificateParentVerifier() = default;
109
110Result<CertificateParentVerifier> CertificateParentVerifier::load(
111 std::string_view artifact_path)
112{
113 if (artifact_path.empty() ||
114 artifact_path.find('\0') != std::string_view::npos) {
115 return unexpected_error(
116 ErrorCode::RangeViolation,
117 "certificate_parent:artifact_path");
118 }
120 const auto status = purify_certificate_parent_verifier_load(
121 reinterpret_cast<const std::uint8_t*>(artifact_path.data()),
122 artifact_path.size(), &verifier);
123 if (status != PURIFY_CERTIFICATE_PARENT_OK) {
124 return load_error(status);
125 }
126 if (verifier == nullptr) {
127 return unexpected_error(
129 "certificate_parent:artifact_owner");
130 }
131 return CertificateParentVerifier(std::make_unique<Impl>(verifier));
132}
133
134Status CertificateParentVerifier::verify(
135 const CertificateNonceRecursiveManifestResolution& resolution,
136 std::span<const unsigned char> proof,
137 const CertificateNonceParentAccumulator& accumulator,
138 purify_secp_context* secp_context) const
139{
140 if (!impl_ || impl_->verifier == nullptr) {
141 return unexpected_error(
143 "certificate_parent:verifier");
144 }
145 if (proof.size() != kProofSize) {
146 return unexpected_error(
148 "certificate_parent:proof_size");
149 }
150 const auto step_count = resolution.step_digests().size();
151 if (!std::in_range<std::uint64_t>(step_count)) {
152 return unexpected_error(
154 "certificate_parent:step_count");
155 }
156
157 std::array<
158 unsigned char,
160 pending_root{};
161 const auto& context_digest =
162 resolution.certificate_context_digest();
163 const auto& manifest = resolution.manifest().bytes();
164 const auto status = purify_certificate_parent_verify(
165 impl_->verifier, context_digest.data(),
166 resolution.total_responses(),
167 static_cast<std::uint64_t>(step_count), manifest.data(),
168 proof.data(), proof.size(), pending_root.data(),
169 pending_root.size());
170 if (status != PURIFY_CERTIFICATE_PARENT_OK) {
171 return verify_error(status);
172 }
173
175 auto final_claim,
177 accumulator.leaves().basis(), pending_root, secp_context),
178 "certificate_parent:parse_root");
180 accumulator.leaves().basis(), final_claim, secp_context);
181}
182
183} // namespace purify::puresign_plusplus
struct purify_certificate_parent_verifier purify_certificate_parent_verifier
void purify_certificate_parent_verifier_destroy(purify_certificate_parent_verifier *verifier)
@ PURIFY_CERTIFICATE_PARENT_ROOT_SIZE
@ PURIFY_CERTIFICATE_PARENT_PROOF_SIZE
purify_certificate_parent_status purify_certificate_parent_verify(const purify_certificate_parent_verifier *verifier, const uint8_t certificate_context_digest[32], uint64_t total_responses, uint64_t total_steps, const uint8_t final_manifest[32], const uint8_t *proof, size_t proof_length, uint8_t *pending_root_output, size_t pending_root_capacity)
purify_certificate_parent_status purify_certificate_parent_verifier_load(const uint8_t *artifact_path, size_t artifact_path_length, purify_certificate_parent_verifier **verifier_output)
purify_certificate_parent_status
@ PURIFY_CERTIFICATE_PARENT_ARTIFACT_SNAPSHOT_FAILED
@ PURIFY_CERTIFICATE_PARENT_INTERNAL_ERROR
@ PURIFY_CERTIFICATE_PARENT_ARTIFACT_OPEN_FAILED
@ PURIFY_CERTIFICATE_PARENT_OK
@ PURIFY_CERTIFICATE_PARENT_MALFORMED
@ PURIFY_CERTIFICATE_PARENT_PROOF_REJECTED
@ PURIFY_CERTIFICATE_PARENT_BUFFER_TOO_SMALL
@ PURIFY_CERTIFICATE_PARENT_ARTIFACT_REJECTED
Selected recursive verification for certificate nonce parents.
#define PURIFY_ASSIGN_OR_RETURN(lhs, expr, context)
Evaluates an expected-like expression, binds the value to lhs, and propagates errors.
Definition error.hpp:338
Result< PendingClaim > parse_root_claim(const Basis &basis, std::span< const unsigned char > encoded, purify_secp_context *context)
Status decide(const Basis &basis, const PendingClaim &claim, purify_secp_context *context)
constexpr Unexpected< Error > unexpected_error(ErrorCode code, const char *context=nullptr)
Constructs an unexpected Error value from a machine-readable code.
Definition error.hpp:293
Result< std::string > verifier(const Bytes &message, const UInt512 &pubkey)
Builds the legacy serialized verifier description for a message and public key.
Definition api.cpp:197
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.