Skip to content

sgns::PruneCandidateResult

Structured verdict for one candidate transaction key. More...

#include <PruneEligibility.hpp>

Public Attributes

Name
std::string tx_path
Full CRDT key of the candidate (the /bc-/tx/ path enumerated).
std::optional< std::string > cid
CID of the candidate from the tx->CID map (nullopt when unresolved).
bool eligible
True only when every gate passed — reasons then carries no failure code.
std::vector< PruneReason > reasons
std::optional< uint64_t > spend_height

Detailed Description

struct sgns::PruneCandidateResult;

Structured verdict for one candidate transaction key.

Named-evidence discipline (PublicChainInputValidator shape): fields are recorded only after the check that produces them ran; an eligible verdict carries no FAILURE reasons — the only permitted non-empty reasons on an eligible verdict is the sole evidence code SPENDER_PRUNED_WINDOW_SATISFIED.

Public Attributes Documentation

variable tx_path

std::string tx_path;

Full CRDT key of the candidate (the /bc-/tx/ path enumerated).

variable cid

std::optional< std::string > cid;

CID of the candidate from the tx->CID map (nullopt when unresolved).

variable eligible

bool eligible = false;

True only when every gate passed — reasons then carries no failure code.

variable reasons

std::vector< PruneReason > reasons;

Every failed check, in evaluation order, plus (on eligible verdicts) the affirmative SPENDER_PRUNED_WINDOW_SATISFIED evidence if any.

variable spend_height

std::optional< uint64_t > spend_height;

Diagnostic: the MOST-RECENT spend height (max spender priority over outputs); nullopt when no binding spend height could be computed.


Updated on 2026-10-22 at 19:28:22 +0000