Expand description
Ratify Protocol v2 (SPEC-v2): strict wire codecs and canonical encodings for all nine signed object codes, typed hybrid signing, the status reducer and security journal, rotation journal, witness and receipt logs, transaction and verification receipts, the ordered live verifier, and the committed-outcome release path.
This module is independent of the v1 API and requires the std feature.
Re-exports§
pub use crate::crypto::generate_hybrid_keypair;pub use crate::crypto::hybrid_keypair_from_seeds;pub use constraints::*;pub use context::*;pub use crypto::*;pub use evaluator::*;pub use errors::*;pub use limits::*;pub use operation_context::*;pub use signer::*;pub use wire::*;pub use receipt::*;pub use rotation::*;pub use transaction::*;pub use witness::*;pub use status::*;pub use cross_sdk::*;pub use checkpoint_ack::*;pub use journal::*;pub use journal_snapshot::*;pub use status_batch::*;pub use status_provenance::*;pub use status_publisher::*;pub use archival::*;pub use audience::*;pub use authorization::*;pub use challenge_issuance::*;pub use claim_store::*;pub use context_policy::*;pub use evaluation_progress::*;pub use preflight::*;pub use rate_reservation::*;pub use release::*;pub use stream_sequence::*;pub use transaction_verify::*;pub use verify::*;
Modules§
- archival
- Archival verification of stored v2 objects (SPEC-v2 §6.10). Mirrors Go
archival_v2.go. No result here is an authorization decision: no challenge was consumed, and no trust root, issuer status, revocation, current expiry, receipt log position or rotation state was evaluated. - audience
- Receiver-audience evaluation (SPEC-v2 §5.2, §6.4). Mirrors Go
audience_v2.go. - authorization
- Post-claim local authorization and the ordered post-status stages
(SPEC-v2 §5.2, §6.3 to §6.7). Mirrors Go
authorization_v2.goandevaluateConstraintV2/loadV2TimeZonefromconstraints_v2.go. - challenge_
issuance - Challenge issuance helper (SPEC-v2 Part B, §7.3). Mirrors Go
challenge_issuance_v2.go. - checkpoint_
ack - Independent checkpoint acknowledgement wire form (SPEC-v2 §7.8). Mirrors
Go
checkpoint_ack_v2.go; the struct itself is declared in Gorelease_v2.go. - claim_
store - The atomic challenge claim, the single-use evaluator capability, and
terminal finalization (SPEC-v2 §6.2, §7.2, §7.3, §7.5). Mirrors Go
claim_store_v2.go. - constraints
- Protocol v2 closed constraint registry (SPEC-v2 §5.2, Go
constraints_v2.go). - context
- Cancellation and deadlines for Protocol v2 operations (the Go reference’s
context.Context). A context is cheap to clone and safe to share between threads. Cancelling a parent cancels every context derived from it. - context_
policy - Verifier-owned context policy (SPEC-v2 §6.7). Mirrors Go
context_policy_v2.go. - cross_
sdk - Cross-SDK fixtures (SPEC-v2 §8.1,
testvectors/v2/README.mdsectioncross-sdk/; Gointernal/v2vectors/crosssdk.go). - crypto
- Typed v2 signing transcripts for every registered object code
(mirrors Go
crypto_v2.go). - errors
- Language-neutral Protocol v2 failure classes (SPEC-v2 §2.7, Go
errors_v2.go) and the typed signing error (SPEC-v2 §3.2). - evaluation_
progress - Persisted evaluation progress and lease-expiry recovery (SPEC-v2 §6.7,
§7.5). Mirrors Go
evaluation_progress_v2.go. - evaluator
- Extension constraint evaluator profiles (SPEC-v2 §5.2, Go
constraint_evaluator_v2.go). - journal
SecurityJournalV2(SPEC-v2 §6.6): the deployment’s status, role, and status-key state, its validated transitions, and the anchored compare-and-swap store contract. Mirrors Gosecurity_journal_v2.go.- journal_
snapshot SecurityJournalV2logical snapshot (SPEC-v2 §6.6). Mirrors Gosecurity_journal_snapshot_v2.go.- limits
- Protocol v2 wire limits (SPEC-v2 §2.6, Go
limits_v2.go) and configuration and clock bounds (SPEC-v2 §2.5, Goclock_bounds_v2.go). - operation_
context - Operation, session, and challenge-claim constructions (SPEC-v2 §2.4, §4;
Go
operation_context_v2.goandchallenge_claim_v2.go). - preflight
- Pre-claim checks (SPEC-v2 §6.2). Mirrors Go
verify_v2_preflight.go. - rate_
reservation - Signed
max_ratereservation batches (SPEC-v2 §5.2, §6.2). Mirrors Gorate_reservation_v2.go. - receipt
- Verification receipts (object code 0x0008), the prepared receipt body,
receipt-log verification, and receipt/bundle binding. Mirrors Go
verification_receipt_v2.goandverification_receipt_body_v2.go. - reference
- TEST/REFERENCE ONLY implementations of the Protocol v2 store contracts
(Go package
v2reference). They are in-process and are not independent, rollback-resistant, or durable; production deployments supply their own. - release
- Committed versus released (SPEC-v2 §6.9, §7.9). Mirrors Go
release_v2.go. - rotation
- Key rotation statements (codes 0x0004 old-key authorization and 0x0009
new-key proof of possession),
StatementBodyDigestV2, and the AcceptRotation journal. Mirrors Gokey_rotation_v2.goandkey_rotation_journal_v2.go. - signer
- Typed signers and the external signer interface (SPEC-v2 §3.2, Go
signer_v2.go). - status
- Issuer status reducer (rollback-protected state), status queries, and
CertificateRef status aggregation. Mirrors Go
status_state_v2.go,status_evaluation_v2.go, and the observation compaction and accepted-state validation fromsecurity_journal_v2.go. - status_
batch - Status evidence batch wire form (SPEC-v2 §6.5 step 3). Mirrors Go
status_batch_v2.go. - status_
provenance - Authenticated status at the verifier boundary (SPEC-v2 §6.5). Mirrors Go
status_provenance_v2.go. - status_
publisher - Minimal signed-status publisher (SPEC-v2 §5.4, status publisher duties).
Mirrors Go
status_publisher_v2.go. - stream_
sequence - Stream sequence (SPEC-v2 §7.4). Mirrors Go
stream_sequence_v2.go. - transaction
- Transaction receipts (party statements, object code 0x0007).
Mirrors Go
transaction_receipt_v2.go. - transaction_
verify - Composed transaction-receipt verification (SPEC-v2 §5.7). Mirrors Go
transaction_verify_v2.go. - verify
- The live Protocol v2 decision path (SPEC-v2 §6). Mirrors Go
verify_v2.go. - wire
- Delegation certificates (0x0001), proof bundles and challenge
presentations (0x0002), revocation lists (0x0003) and pushes (0x0005).
Mirrors Go
protocol_v2_wire.go. - witness
- Witness entries (object code 0x0006) and caller-head log verification.
Mirrors Go
witness_v2.go.
Functions§
- canonical_
json_ v2 - Re-encode arbitrary strict JSON as RatifyCanonicalJSON, preserving
explicit
nullmembers (unlike the v1canonical_jsonhelper).