p2panda-encryption 0.7.0

Decentralised data- and message encryption for groups with post-compromise security and optional forward secrecy
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

// SPDX-License-Identifier: MIT OR Apache-2.0

//! Interfaces to integrate `p2panda-encryption` into custom data- and messaging types, group
//! management- and ordering strategies.
use std::fmt::Debug;
use std::hash::Hash as StdHash;

mod dgm;
mod key_bundle;
mod key_manager;
mod key_registry;
mod message;
mod ordering;

#[cfg(any(test, feature = "message_scheme"))]
pub use dgm::AckedGroupMembership;
#[cfg(any(test, feature = "data_scheme"))]
pub use dgm::GroupMembership;
pub use key_bundle::KeyBundle;
pub use key_manager::{IdentityManager, PreKeyManager};
pub use key_registry::{IdentityRegistry, PreKeyRegistry};
#[cfg(any(test, feature = "message_scheme"))]
pub use message::{ForwardSecureGroupMessage, ForwardSecureMessageContent};
#[cfg(any(test, feature = "data_scheme"))]
pub use message::{GroupMessage, GroupMessageContent};
#[cfg(any(test, feature = "message_scheme"))]
pub use ordering::ForwardSecureOrdering;
#[cfg(any(test, feature = "data_scheme"))]
pub use ordering::Ordering;

/// Handle to identify a group member.
///
/// Note that this needs to be unique within a group, can be a username, number or preferably a
/// long byte string.
pub trait IdentityHandle: Copy + Debug + PartialEq + Eq + StdHash {}

impl IdentityHandle for p2panda_core::VerifyingKey {}

#[cfg(any(test, feature = "test_utils"))]
impl IdentityHandle for &str {}

#[cfg(any(test, feature = "test_utils"))]
impl IdentityHandle for usize {}

/// Identifier for each group membership operation.
///
/// Operations trigger changes of the group state and are usually sent in form of messages over the
/// network. Each operation needs to be uniquely identifiable, preferably by a collision-resistant
/// hash.
pub trait OperationId: Copy + Debug + PartialEq + Eq + StdHash {}

impl OperationId for p2panda_core::Hash {}

#[cfg(any(test, feature = "test_utils"))]
impl OperationId for (usize, usize) {} // (ID, Seq)

#[cfg(any(test, feature = "test_utils"))]
impl OperationId for usize {}