enlace 0.2.5

Encrypted mailbox and latest-value slot fan-out.
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

#![warn(clippy::all)]
#![warn(clippy::pedantic)]
#![allow(clippy::module_name_repetitions)]
#![allow(clippy::must_use_candidate)]
#![allow(clippy::missing_errors_doc)]
#![allow(clippy::missing_panics_doc)]

//! Encrypted mailbox and latest-value slot transport fan-out.
//!
//! `enlace` exposes two namespace modes over the same transport set:
//!
//! - [`Namespace`] is shared-seed mode. Use it when every participant can safely
//!   share one 32-byte secret and should have equal read/write access to the same
//!   mailbox and slot names. This fits small trusted clusters, local recovery
//!   slots, and deployments where membership is already controlled outside the
//!   library. Optional signing keys can authenticate incoming records, but the
//!   shared seed still grants access to all peers that know it.
//! - [`PeerNamespace`] is public-key mode. Use it when peers have separate
//!   long-term identities, pair by exchanging [`PeerCard`] values, and need
//!   per-peer trust, revocation, pairwise envelopes, caller-managed group keys,
//!   or iroh endpoint allowlists. Caller code owns identity persistence, card
//!   exchange, authorization policy, group membership, and group-key rotation.
//!
//! HTTP and iroh transports can carry mailbox messages in both modes. HTTP,
//! DHT, pkarr, and iroh can carry slots; DHT and pkarr are latest-record slot
//! transports and do not provide mailbox delivery.

pub mod config;
pub mod coordinator;
pub mod crypto;
pub mod dedup;
pub mod error;
#[cfg(feature = "fuzzing")]
pub mod fuzzing;
pub mod guard;
pub mod kdf;
pub mod mailbox;
pub mod namespace;
pub mod peer;
pub mod slot;
pub mod state;
pub mod transports;

#[cfg(feature = "pkarr")]
pub use config::PkarrConfig;
#[cfg(feature = "http")]
pub use config::{BasicAuth, HttpConfig};
pub use config::{Config, ConfiguredTransport, IrohEndpointAddr};
#[cfg(feature = "dht")]
pub use config::{DhtBootstrapCacheConfig, DhtConfig};
#[cfg(feature = "iroh")]
pub use config::{IrohConfig, IrohRelayMode};
pub use error::{OpenError, RecvError, SealError, SendError, SlotError, TransportError};
pub use kdf::{ChannelKind, NameError, TransportKind};
pub use mailbox::{Mailbox, RecvMessage, SendReport};
pub use namespace::Namespace;
pub use peer::{
    GROUP_ID_LEN, GROUP_KEY_ID_LEN, GROUP_KEY_SECRET_LEN, GroupEnvelope, GroupEnvelopeEntry,
    GroupEnvelopeError, GroupEnvelopeMessage, GroupId, GroupKey, GroupKeyError, GroupKeyId,
    PEER_ID_LEN, PeerCard, PeerCardError, PeerConfig, PeerEnvelope, PeerEnvelopeError,
    PeerEnvelopeMessage, PeerId, PeerIdentity, PeerMailbox, PeerMailboxMessage, PeerNamespace,
    PeerRecipientEnvelope, PeerSendError, PeerSendReport, PeerSlot, PeerSlotError,
    PeerSlotPutReport, PeerSlotScope, PeerSlotValue, PeerSlotWatch, TrustError, TrustedPeer,
};
pub use slot::{PutReport, Slot, SlotValue, SlotWatch};
pub use state::{InMemoryStateStore, State, StateError, StateStore};
#[cfg(feature = "dht")]
pub use transports::DhtTransport;
#[cfg(feature = "http")]
pub use transports::HttpTransport;
#[cfg(feature = "iroh")]
pub use transports::IrohTransport;
#[cfg(feature = "pkarr")]
pub use transports::PkarrTransport;
pub use transports::{
    EndpointHealth, HealthReport, HealthState, HealthTransition, HealthTransitionKind,
    MailboxTransport, SlotTransport, SlotWatchStream, Transport, TransportHealth,
};