Expand description
Committed versus released (SPEC-v2 §6.9, §7.9). Mirrors Go
release_v2.go.
super::verify_proof_bundle_v2 commits a terminal Protocol result and
returns an opaque CommittedV2Outcome holding the handoff tuple
{claim_id, receipt_body_digest, challenge_expires_at, allow_horizon} and
the sealed receipt outbox body. It exposes no decision.
release_v2_decision is the only path to an actionable decision; it
returns released, pending (retryable), withheld (permanent for the claim
once recorded), or rejected (a result of that call’s inputs that changes
no claim state).
There is no production local-log substitute for an independent
checkpoint. The in-memory store in super::reference exists only for
tests and conformance scenarios.
Structs§
- Committed
V2Outcome - The immutable, non-actionable handoff from a committed verification to
publication and
release_v2_decision. It carries no decision. - V2Release
Config - Caller-authenticated release configuration.
- V2Release
Record - The durable release record of SPEC-v2 §6.9: the release of step 9
(
outcomereleased,reasonempty) or a withheld result of steps 7 and 8 (outcomewithheld,reasonclock_regressed,challenge_expired, orallow_horizon_passed).entry_hashandack_timestampname the verified receipt entry and its acknowledgement. The first record for a claim wins; a claim store returnsV2StoreError::ReleaseStateMismatchfor any different later record and must persist and return every field unchanged. - V2Release
Result - The result of
release_v2_decision.decisionis present only whenstatusis released;reasonis empty only when released. OnlyV2ReleasedDecision::allowedmay gate a side effect. - V2Released
Decision - The only actionable value in this crate (SPEC-v2 §6.9). It is sealed:
every field is private,
release_v2_decisionis its only constructor, it implements neitherDefault,Clonenor any deserializer, and every accessor returns a copy, so a caller can neither forge a released decision nor change one it was given. - V2Terminal
Claim Record - What the claim store returns to release (§7.3): the sealed handoff values, the recorded finalization time T_final, any receipt_abandoned marking, and any prior release record.
Enums§
- V2Release
Status - The release outcome class of §6.9.
Traits§
- V2Receipt
Checkpoint - The caller-configured independent checkpoint (§7.8).
acknowledge_v2_receiptaccepts only the next sequence of the log, linked byprevious_entry_hash, and returns the original acknowledgement on an identical retry.get_v2_acknowledgementreturns an acknowledgement,V2StoreError::AcknowledgementNotFound, or another error for unavailability. - V2Receipt
Publisher - The Part B receipt outbox drain (§7.7). It signs and appends the exact
committed body for
claim_idat the next ordered log position, or returns the receipt already appended for that claim, and returns the signed receipt wire. It refuses a body that differs from the committed outbox body. - V2Release
Claim Store - The claim-store view release needs.
load_v2_terminal_claimreports a claim the store does not hold with aclaim_not_founderror, which release answers withrejected / release_state_mismatch; any other error is store unavailability (pending / claim_store_unavailable).record_v2_releasereturnsV2StoreError::ReleaseStateMismatchwhen a different release or withheld record already exists for the claim.
Functions§
- receipt_
outbox_ digest_ v2 "sha384:" + hex(SHA-384("ratify-protocol-receipt-outbox-v2" || 0x00 || body)).- release_
v2_ decision - Go
ReleaseV2Decision: the release steps of SPEC-v2 §6.9 in order, stopping at the first that does not pass.signed_receiptis the publisher’s signed receipt wire, orNonewhen it has not been appended yet. - valid_
v2_ release_ record_ outcome - Go
ValidV2ReleaseRecordOutcome: whetheroutcomeandreasonform a release record: released with no reason, or withheld with one of the reasons release steps 7 and 8 record.