auths-id 0.1.2

Multi-device identity and attestation crate for Auths
Documentation 
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

// crate-level allow during curve-agnostic refactor.
#![allow(clippy::disallowed_methods)]
#![deny(
    clippy::print_stdout,
    clippy::print_stderr,
    clippy::exit,
    clippy::dbg_macro
)]
#![warn(clippy::too_many_lines, clippy::cognitive_complexity)]
//! # auths-id
//!
//! Identity management and attestation logic for Auths.
//!
//! This crate provides:
//! - **Identity creation** via `did:key` and `did:keri` derivation
//! - **Attestation management** for device linking
//! - **Git storage** for identity and attestation persistence
//!
//! ## Architecture
//!
//! ```text
//! ┌─────────────┐     ┌──────────────┐     ┌─────────────┐
//! │  Identity   │────▶│  Attestation │────▶│ Git Storage │
//! │ (did:keri)  │     │   (signed)   │     │  (refs/*)   │
//! └─────────────┘     └──────────────┘     └─────────────┘
//! ```
//!
//! ## Usage
//!
//! ```rust,ignore
//! use auths_id::identity::Identity;
//! use auths_id::attestation::Attestation;
//!
//! // Create an identity from a public key
//! let identity = Identity::from_public_key(&pubkey_bytes)?;
//!
//! // Create an attestation linking a device
//! let attestation = Attestation::builder()
//!     .issuer(&identity.did)
//!     .subject("did:key:z6MkDevice...")
//!     .capability(Capability::SignCommit)
//!     .build()?;
//! ```
//!
//! ## Git Storage Layout
//!
//! | Ref | Content |
//! |-----|---------|
//! | `refs/auths/identity` | Identity metadata |
//! | `refs/auths/attestations/nodes/<did>` | Attestations keyed by subject DID |
//! | `refs/auths/device-kel/<prefix>` | Per-device KEL state |
//! | `refs/auths/shared-kel/<prefix>` | Shared identity KEL state |
//! | `refs/did/keri/<prefix>/kel` | KERI Key Event Log |
//! | `refs/did/keri/<prefix>/receipts/<said>` | Witness receipts |

#[cfg(feature = "git-storage")]
pub mod agent_identity;
pub mod attestation;
pub mod domain;
pub mod domain_separation;
pub mod error;
pub mod freeze;
pub mod identity;
pub mod keri;
pub mod policy;
pub mod ports;
pub mod storage;
pub mod trailer;
#[cfg(feature = "git-storage")]
pub mod trust;
#[cfg(feature = "git-storage")]
pub mod witness;
pub mod witness_config;

/// Test utilities for auths-id consumers (behind `test-utils` feature).
#[cfg(feature = "test-utils")]
#[allow(clippy::unwrap_used, clippy::expect_used)]
pub mod testing;