trust-tasks-rs 0.13.2

Reference Rust library for the Trust Tasks framework — transport-agnostic, JSON-based descriptions of verifiable work between parties.
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83

//! Reference Rust library for the [Trust Tasks] framework.
//!
//! Trust Tasks are self-contained, transport-agnostic, JSON-based descriptions
//! of the verifiable work that happens between two parties. This crate models
//! the framework-level document envelope and provides a [`TransportHandler`]
//! trait through which concrete transports (REST, DIDComm, ...) plug in their
//! identity, integrity, and freshness semantics.
//!
//! The crate tracks the `SPEC.md` framework at version `0.4`. The
//! `trust-task-error` version it emits has one definition —
//! [`trust_task_error_type_uri`] — and it still parses the `0.1` snake_case
//! error codes for backwards compatibility. See the spec sections referenced
//! from each item for the normative text.
//!
//! # The stateful §7.2 checks
//!
//! Most of §7.2 is a pure function of one document. Two items are not, and
//! both live behind seams the caller supplies:
//!
//! * [`replay`] — item 11's duplicate-execution record, so a §8.4 retry or a
//!   replayed envelope does not grant the same ACL entry twice.
//!   [`InMemoryReplayGuard`] is the default; [`ReplayGuard`] is the trait a
//!   replicated deployment implements over a shared store.
//! * [`freshness`] — the acceptance window over `issuedAt` / `expiresAt` that
//!   §7.2 makes the *same bound* as the replay record's retention.
//!
//! [`consume_inbound`] takes them together as [`ConsumeChecks`].
//!
//! [Trust Tasks]: https://trusttasks.org/

#![warn(missing_docs)]
#![warn(rust_2018_idioms)]

mod canonical;
mod ceremony;
mod consume;
mod dispatcher;
mod document;
mod error;
mod payload;
mod proof;
mod transport;
mod type_uri;

pub mod discovery;
pub mod freshness;
pub mod guards;
pub mod handlers;
pub mod replay;
pub mod specs;

#[cfg(feature = "validate")]
#[cfg_attr(docsrs, doc(cfg(feature = "validate")))]
pub mod schema_index;

#[cfg(feature = "validate")]
#[cfg_attr(docsrs, doc(cfg(feature = "validate")))]
pub mod validate;

pub use canonical::{canonical_json, sha256_hex};
pub use ceremony::{Ceremony, CeremonyPrev};
pub use consume::{
    consume_inbound, ConsumeChecks, ConsumeOutcome, NoValidator, PayloadPolicy, PayloadValidator,
    ProofPolicy, PROOF_NOT_ACCEPTED_BY_POLICY,
};
pub use dispatcher::Dispatcher;
pub use document::{trust_task_error_type_uri, ErrorResponse, JsonLdContext, TrustTask};
pub use error::{
    ErrorPayload, InResponseTo, ParseCodeError, RejectReason, StandardCode, TrustTaskCode,
    IDENTITY_MISMATCH_WIRE_MESSAGE, PROOF_INVALID_WIRE_MESSAGE, STALE_WIRE_MESSAGE,
    UNAVAILABLE_WIRE_MESSAGE, WRONG_RECIPIENT_WIRE_MESSAGE,
};
pub use freshness::{FreshnessPolicy, StaleReason, DEFAULT_MAX_AGE, DEFAULT_SKEW};
pub use payload::Payload;
pub use proof::{
    erase_verifier, DynProofVerifier, ErasedVerifier, Proof, ProofVerifier, VerificationError,
};
pub use replay::{
    document_digest, DocumentDigest, InMemoryReplayGuard, ReplayGuard, ReplayGuardError,
    ReplayPolicy, ReplayVerdict,
};
pub use transport::{ConsistencyError, ResolvedParties, TransportContext, TransportHandler};
pub use type_uri::{ParseTypeUriError, TypeUri, Variant};