Expand description
§acdp-client — consumer client for the Agent Context Distribution Protocol
Implements the acdp-consumer profile: RegistryClient
(publish/retrieve/search/capabilities with RFC-aligned timeouts, body
caps, and same-authority redirect limits), VerifiedContext
(one-shot fetch + verify), CrossRegistryResolver (RFC-ACDP-0006
§4.1), and DataRef fetching with hash verification.
Re-exports§
pub use auth::AuthFuture;pub use auth::AuthProvider;pub use auth::BearerToken;pub use auth::PerAuthorityTokens;pub use auth::StaticBearerToken;pub use cross_registry::CrossRegistryResolver;pub use cross_registry::ResolverOptions;pub use data_ref::fetch_and_verify_data_ref;pub use data_ref::DataRefFetcher;pub use data_ref::HttpsDataRefFetcher;pub use data_ref::DEFAULT_MAX_BYTES;pub use log::verify_log_checkpoint_value;pub use log::verify_log_inclusion_value;pub use receipt::verify_lineage_head_receipt_value;pub use receipt::verify_receipt_value;pub use receipt::verify_receipt_value_since;pub use receipt::verify_receipt_value_with_status_since;pub use registry::RegistryClient;pub use registry::RegistryClientBuilder;pub use registry::ACDP_ACCEPT;pub use revocation::classify_under_revocation;pub use revocation::classify_under_revocation_placed;pub use revocation::find_registry_attested_revocations;pub use revocation::find_revocations;pub use revocation::find_revocations_in_lineage;pub use revocation::verify_revocation_body;pub use revocation::verify_revocation_candidate;pub use revocation::verify_revocation_context;pub use revocation_cache::RevocationCache;pub use revocation_verdict::find_revocations_verdict;pub use revocation_verdict::RevocationAssessment;pub use revocation_verdict::RevocationVerdict;pub use revocation_verdict::RECOMMENDED_NEGATIVE_FRESHNESS;pub use transparency::CannotVerifyReason;pub use transparency::LogInclusionPolicy;pub use transparency::LogInclusionVerdict;pub use transparency::WitnessEnforcement;pub use transparency::WitnessQuorumPolicy;pub use transparency::DEFAULT_LOG_MAX_CLOCK_SKEW_SECONDS;pub use verified::DiscoveryFailurePolicy;pub use verified::DiscoveryOutcome;pub use verified::HistoricalKeyPolicy;pub use verified::KeyAuthorization;pub use verified::LineageHeadPolicy;pub use verified::ReceiptPolicy;pub use verified::RevocationDiscovery;pub use verified::RevocationPolicy;pub use verified::VerificationPolicy;pub use verified::VerificationReport;pub use verified::VerifiedContext;pub use witness::evaluate_witness_quorum;pub use witness::mint_cosignature_checked;pub use witness::verify_witness_cosignature_value;pub use witness::WitnessConsistencyCheck;pub use witness::WitnessPolicy;pub use witness::WitnessQuorumReport;pub use witness::DEFAULT_WITNESS_MAX_AGE_SECONDS;pub use witness::DEFAULT_WITNESS_MAX_CLOCK_SKEW_SECONDS;
Modules§
- auth
- Read authentication (RFC-ACDP-0008 §6.2, 0.5.0
bearer_jwt). - cross_
registry - Cross-registry resolution per RFC-ACDP-0006 (feature = “client”).
- data_
ref - Data-reference fetching + hash verification (feature = “client”).
- log
- Client-side transparency-log verification (ACDP 0.3, RFC-ACDP-0012 §9): checkpoints (§9.3) and inclusion proofs (§9.1) against the registry’s DID document.
- receipt
- Client-side registry-receipt verification (ACDP 0.2, RFC-ACDP-0010).
- registry
- HTTP client for ACDP registries (feature = “client”).
- revocation
- Consumer-side key-revocation semantics (ACDP 0.3, RFC-ACDP-0014).
- revocation_
cache - Issue #257: a cache for RFC-ACDP-0014 §7/§8 revocation discovery.
- revocation_
verdict - Typed, attributable revocation verdicts (RFC-ACDP-0014 §7/§8, 0.5.0 “Attribution”, “Producer scope”, “Discovery outcome classes”, “Caching”).
- transparency
- Opt-in transparency corroboration during verification: the
RFC-ACDP-0012 §9 log-inclusion verdict and the RFC-ACDP-0015 §8
witness-quorum verdict. Both are reachable from
VerificationPolicy, and each is reported separately from the body, receipt and revocation verdicts. - verified
- VerifiedContext: retrieve + verify in one call.
- witness
- Client-side transparency-log witness cosignature verification and the witness-side minting obligation (ACDP 0.4, RFC-ACDP-0015).
Structs§
- Revocation
Refusal - The attributed refusal carried by
AcdpError::KeyRevoked: a verified, in-scope revocation made the context’s signing key not authorized. - Sourced
Revocation - A verified revocation, attributed (RFC-ACDP-0014 §7 “Attribution”, 0.5.0): which context it is, who signed it, its trust class, which producer’s key it names, and where the consumer got it.
Enums§
- Revocation
Effect - Which RFC-ACDP-0014 §7 step a revocation verdict came from.
- Revocation
Source - Where a consumer obtained a revocation it acted on.
- Unknown
Reason - Why a revocation-discovery outcome is
unknown(RFC-ACDP-0014 §8, 0.5.0).unknownis never folded into not-revoked.