Skip to main content

Module v2

Module v2 

Source
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.go and evaluateConstraintV2 / loadV2TimeZone from constraints_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 Go release_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.md section cross-sdk/; Go internal/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 Go security_journal_v2.go.
journal_snapshot
SecurityJournalV2 logical snapshot (SPEC-v2 §6.6). Mirrors Go security_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, Go clock_bounds_v2.go).
operation_context
Operation, session, and challenge-claim constructions (SPEC-v2 §2.4, §4; Go operation_context_v2.go and challenge_claim_v2.go).
preflight
Pre-claim checks (SPEC-v2 §6.2). Mirrors Go verify_v2_preflight.go.
rate_reservation
Signed max_rate reservation batches (SPEC-v2 §5.2, §6.2). Mirrors Go rate_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.go and verification_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 Go key_rotation_v2.go and key_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 from security_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 null members (unlike the v1 canonical_json helper).