|
purify
C++ Purify implementation with native circuit and BPP support
|
Resettable packed circuit representation backed by one aligned owning slab. More...
#include <bulletproof.hpp>
Public Member Functions | |
| PackedWithSlack ()=default | |
| PackedWithSlack (const PackedWithSlack &other) | |
| PackedWithSlack & | operator= (const PackedWithSlack &other) |
| PackedWithSlack (PackedWithSlack &&other) noexcept | |
| PackedWithSlack & | operator= (PackedWithSlack &&other) noexcept |
| std::size_t | n_gates () const noexcept |
| std::size_t | n_commitments () const noexcept |
| std::size_t | n_bits () const noexcept |
| std::size_t | constraint_count () const noexcept |
| std::size_t | constraint_capacity () const noexcept |
| bool | has_valid_shape () const noexcept |
| void | reset () noexcept |
| Restores the packed circuit to its original base row sizes and constraint count. | |
| std::size_t | add_constraint (const FieldElement &constant=FieldElement::zero()) |
| Appends a new linear constraint constant term and returns its index. | |
| void | add_left_term (std::size_t gate_idx, std::size_t constraint_idx, const FieldElement &scalar) |
| Adds a coefficient to the left-wire matrix. | |
| void | add_right_term (std::size_t gate_idx, std::size_t constraint_idx, const FieldElement &scalar) |
| Adds a coefficient to the right-wire matrix. | |
| void | add_output_term (std::size_t gate_idx, std::size_t constraint_idx, const FieldElement &scalar) |
| Adds a coefficient to the output-wire matrix. | |
| void | add_commitment_term (std::size_t commitment_idx, std::size_t constraint_idx, const FieldElement &scalar) |
| Adds a coefficient to the commitment matrix using the Bulletproof sign convention. | |
| bool | evaluate (const BulletproofAssignmentData &assignment) const |
| Evaluates the packed circuit directly against a witness assignment. | |
| Result< NativeBulletproofCircuit > | unpack () const |
| Materializes the packed circuit back into the ergonomic row-vector representation. | |
| NativeBulletproofCircuitRow::PackedWithSlack | left_row (std::size_t gate_idx) const noexcept |
| Returns a read-only packed left-wire row view. | |
| NativeBulletproofCircuitRow::PackedWithSlack | right_row (std::size_t gate_idx) const noexcept |
| Returns a read-only packed right-wire row view. | |
| NativeBulletproofCircuitRow::PackedWithSlack | output_row (std::size_t gate_idx) const noexcept |
| Returns a read-only packed output-wire row view. | |
| NativeBulletproofCircuitRow::PackedWithSlack | commitment_row (std::size_t commitment_idx) const noexcept |
| Returns a read-only packed commitment row view. | |
| std::span< const FieldElement > | constants () const noexcept |
| Returns the live constraint constants stored in the slab. | |
Static Public Member Functions | |
| static Result< PackedWithSlack > | from_circuit (const NativeBulletproofCircuit &circuit, const PackedSlackPlan &slack) |
| Packs a native circuit into one aligned slab with caller-supplied row and constraint slack. | |
This keeps row metadata, sparse terms, and constants in one compact slab sized for the base circuit plus caller-supplied slack. It supports two cache-friendly modes: copying the object cheaply for const use, or mutating it in place and then calling reset() to return to the original packed base shape.
Definition at line 100 of file bulletproof.hpp.
|
default |
References purify::NativeBulletproofCircuit::NativeBulletproofCircuit(), and PackedWithSlack().
Referenced by from_circuit(), operator=(), operator=(), PackedWithSlack(), PackedWithSlack(), and PackedWithSlack().
| purify::NativeBulletproofCircuit::PackedWithSlack::PackedWithSlack | ( | const PackedWithSlack & | other | ) |
Definition at line 1067 of file bulletproof.cpp.
References PackedWithSlack().
|
noexcept |
Definition at line 1082 of file bulletproof.cpp.
References PackedWithSlack().
| void purify::NativeBulletproofCircuit::PackedWithSlack::add_commitment_term | ( | std::size_t | commitment_idx, |
| std::size_t | constraint_idx, | ||
| const FieldElement & | scalar ) |
Definition at line 1371 of file bulletproof.cpp.
References purify::FieldElement::negate().
| std::size_t purify::NativeBulletproofCircuit::PackedWithSlack::add_constraint | ( | const FieldElement & | constant = FieldElement::zero() | ) |
Definition at line 1331 of file bulletproof.cpp.
References constants().
| void purify::NativeBulletproofCircuit::PackedWithSlack::add_left_term | ( | std::size_t | gate_idx, |
| std::size_t | constraint_idx, | ||
| const FieldElement & | scalar ) |
Definition at line 1356 of file bulletproof.cpp.
| void purify::NativeBulletproofCircuit::PackedWithSlack::add_output_term | ( | std::size_t | gate_idx, |
| std::size_t | constraint_idx, | ||
| const FieldElement & | scalar ) |
Definition at line 1366 of file bulletproof.cpp.
| void purify::NativeBulletproofCircuit::PackedWithSlack::add_right_term | ( | std::size_t | gate_idx, |
| std::size_t | constraint_idx, | ||
| const FieldElement & | scalar ) |
Definition at line 1361 of file bulletproof.cpp.
|
nodiscardnoexcept |
Definition at line 1392 of file bulletproof.cpp.
|
nodiscardnoexcept |
Definition at line 1396 of file bulletproof.cpp.
Referenced by add_constraint(), from_circuit(), and unpack().
|
inlinenodiscardnoexcept |
Definition at line 129 of file bulletproof.hpp.
|
inlinenodiscardnoexcept |
Definition at line 125 of file bulletproof.hpp.
|
nodiscard |
Definition at line 1400 of file bulletproof.cpp.
References purify::BulletproofAssignmentData::commitments, purify::NativeBulletproofCircuit::has_valid_shape(), purify::NativeBulletproofCircuitTerm::idx, purify::BulletproofAssignmentData::left, purify::FieldElement::negate(), purify::BulletproofAssignmentData::output, purify::BulletproofAssignmentData::right, purify::NativeBulletproofCircuitTerm::scalar, and purify::FieldElement::zero().
|
staticnodiscard |
Definition at line 1483 of file bulletproof.cpp.
References purify::NativeBulletproofCircuit::c, purify::checked_add_size(), constants(), purify::NativeBulletproofCircuit::PackedSlackPlan::constraint_slack, purify::Expected< T, E >::error(), purify::NativeBulletproofCircuit::has_valid_shape(), purify::Expected< T, E >::has_value(), purify::InvalidDimensions, purify::NativeBulletproofCircuit::n_bits, purify::NativeBulletproofCircuit::n_commitments, purify::NativeBulletproofCircuit::n_gates, purify::NativeBulletproofCircuit::NativeBulletproofCircuit(), purify::Overflow, PackedWithSlack(), purify::SizeMismatch, purify::unexpected_error(), purify::NativeBulletproofCircuit::PackedSlackPlan::wl, purify::NativeBulletproofCircuit::wl, purify::NativeBulletproofCircuit::PackedSlackPlan::wo, purify::NativeBulletproofCircuit::wo, purify::NativeBulletproofCircuit::PackedSlackPlan::wr, purify::NativeBulletproofCircuit::wr, purify::NativeBulletproofCircuit::PackedSlackPlan::wv, purify::NativeBulletproofCircuit::wv, and purify::FieldElement::zero().
Referenced by purify::NativeBulletproofCircuit::pack_with_slack().
|
nodiscardnoexcept |
Definition at line 1161 of file bulletproof.cpp.
References purify::NativeBulletproofCircuitTerm::idx.
Referenced by purify::verify_experimental_circuit().
|
nodiscardnoexcept |
Definition at line 1377 of file bulletproof.cpp.
|
inlinenodiscardnoexcept |
Definition at line 121 of file bulletproof.hpp.
|
inlinenodiscardnoexcept |
Definition at line 117 of file bulletproof.hpp.
Referenced by purify::detail::circuit_n_commitments(), and purify::verify_experimental_circuit().
|
inlinenodiscardnoexcept |
Definition at line 113 of file bulletproof.hpp.
Referenced by purify::detail::circuit_n_gates(), and purify::verify_experimental_circuit().
| NativeBulletproofCircuit::PackedWithSlack & purify::NativeBulletproofCircuit::PackedWithSlack::operator= | ( | const PackedWithSlack & | other | ) |
Definition at line 1092 of file bulletproof.cpp.
References PackedWithSlack().
|
noexcept |
Definition at line 1102 of file bulletproof.cpp.
References PackedWithSlack().
|
nodiscardnoexcept |
Definition at line 1387 of file bulletproof.cpp.
|
noexcept |
Definition at line 1212 of file bulletproof.cpp.
Referenced by purify::NativeBulletproofCircuitTemplate::instantiate_packed().
|
nodiscardnoexcept |
Definition at line 1382 of file bulletproof.cpp.
|
nodiscard |
Definition at line 1455 of file bulletproof.cpp.
References purify::NativeBulletproofCircuit::c, constants(), purify::NativeBulletproofCircuit::has_valid_shape(), purify::InvalidDimensions, purify::NativeBulletproofCircuit::NativeBulletproofCircuit(), purify::unexpected_error(), purify::NativeBulletproofCircuit::wl, purify::NativeBulletproofCircuit::wo, purify::NativeBulletproofCircuit::wr, and purify::NativeBulletproofCircuit::wv.