purify
C++ Purify implementation with native circuit and BPP support
Loading...
Searching...
No Matches
construction_parent_bridge.h File Reference
#include <stddef.h>
#include <stdint.h>

Go to the source code of this file.

Typedefs

typedef enum purify_construction_parent_status purify_construction_parent_status
typedef struct purify_construction_parent_verifier purify_construction_parent_verifier

Enumerations

enum  { PURIFY_CONSTRUCTION_PARENT_ROOT_SIZE = 545 , PURIFY_CONSTRUCTION_PARENT_DESCRIPTOR_SIZE = 130 , PURIFY_CONSTRUCTION_PARENT_PROOF_SIZE = 15076 }
enum  purify_construction_parent_status {
  PURIFY_CONSTRUCTION_PARENT_OK = 0 , PURIFY_CONSTRUCTION_PARENT_MALFORMED = 1 , PURIFY_CONSTRUCTION_PARENT_PROOF_REJECTED = 2 , PURIFY_CONSTRUCTION_PARENT_BUFFER_TOO_SMALL = 3 ,
  PURIFY_CONSTRUCTION_PARENT_ARTIFACT_OPEN_FAILED = 4 , PURIFY_CONSTRUCTION_PARENT_ARTIFACT_REJECTED = 5 , PURIFY_CONSTRUCTION_PARENT_INTERNAL_ERROR = 6 , PURIFY_CONSTRUCTION_PARENT_ARTIFACT_SNAPSHOT_FAILED = 7
}

Functions

purify_construction_parent_status purify_construction_parent_verifier_load (const uint8_t *artifact_path, size_t artifact_path_length, purify_construction_parent_verifier **verifier_output)
purify_construction_parent_status purify_construction_parent_verify (const purify_construction_parent_verifier *verifier, const uint8_t construction_statement_digest[32], const uint8_t resolved_setup_record_digest[32], const uint8_t recovery_root[64], const uint8_t native_basis_digest[32], const uint8_t native_raw_generator_digest[32], uint32_t setup_count, uint32_t anchor_count, const uint8_t *leaf_descriptors, size_t leaf_descriptors_length, const uint8_t *proof, size_t proof_length, uint8_t *pending_root_output, size_t pending_root_capacity)
void purify_construction_parent_verifier_destroy (purify_construction_parent_verifier *verifier)

Typedef Documentation

◆ purify_construction_parent_status

◆ purify_construction_parent_verifier

Enumeration Type Documentation

◆ anonymous enum

anonymous enum

Private ABI for the selected recursive construction-parent verifier.

This header is deliberately not installed. A successful proof call returns a pending native accumulation root, never an accepted receipt. The C++ wrapper must parse that root against its fixed basis and call decide().

Enumerator
PURIFY_CONSTRUCTION_PARENT_ROOT_SIZE 
PURIFY_CONSTRUCTION_PARENT_DESCRIPTOR_SIZE 
PURIFY_CONSTRUCTION_PARENT_PROOF_SIZE 

Definition at line 23 of file construction_parent_bridge.h.

◆ purify_construction_parent_status

Enumerator
PURIFY_CONSTRUCTION_PARENT_OK 
PURIFY_CONSTRUCTION_PARENT_MALFORMED 
PURIFY_CONSTRUCTION_PARENT_PROOF_REJECTED 
PURIFY_CONSTRUCTION_PARENT_BUFFER_TOO_SMALL 
PURIFY_CONSTRUCTION_PARENT_ARTIFACT_OPEN_FAILED 
PURIFY_CONSTRUCTION_PARENT_ARTIFACT_REJECTED 
PURIFY_CONSTRUCTION_PARENT_INTERNAL_ERROR 
PURIFY_CONSTRUCTION_PARENT_ARTIFACT_SNAPSHOT_FAILED 

Definition at line 30 of file construction_parent_bridge.h.

Function Documentation

◆ purify_construction_parent_verifier_destroy()

void purify_construction_parent_verifier_destroy ( purify_construction_parent_verifier * verifier)

◆ purify_construction_parent_verifier_load()

purify_construction_parent_status purify_construction_parent_verifier_load ( const uint8_t * artifact_path,
size_t artifact_path_length,
purify_construction_parent_verifier ** verifier_output )

Opens the configured verifier at an explicit UTF-8 storage path.

The path cannot select verifier identity. verifier_output is cleared before validation and owns one verifier only on success.

Referenced by purify::accountable::ConstructionParentVerifier::load().

◆ purify_construction_parent_verify()

purify_construction_parent_status purify_construction_parent_verify ( const purify_construction_parent_verifier * verifier,
const uint8_t construction_statement_digest[32],
const uint8_t resolved_setup_record_digest[32],
const uint8_t recovery_root[64],
const uint8_t native_basis_digest[32],
const uint8_t native_raw_generator_digest[32],
uint32_t setup_count,
uint32_t anchor_count,
const uint8_t * leaf_descriptors,
size_t leaf_descriptors_length,
const uint8_t * proof,
size_t proof_length,
uint8_t * pending_root_output,
size_t pending_root_capacity )

Authenticates one exact construction parent and returns its pending root.

pending_root_output must not alias an input. It is cleared before every input and proof check. Success still requires native root parsing and the final accumulation decision.

Referenced by purify::accountable::ConstructionParentVerifier::verify().