peat-mesh 0.8.1

Peat mesh networking library with CRDT sync, transport security, and topology management
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

//! # Security Primitives for Mesh Networks
//!
//! Generic cryptographic security primitives for mesh networking:
//!
//! - [`DeviceId`] - Unique device identifier derived from Ed25519 public key
//! - [`DeviceKeypair`] - Ed25519 keypair for signing and identity
//! - [`SecurityError`] - Error types for security operations
//! - [`EncryptionKeypair`] / [`EncryptionManager`] - X25519/ChaCha20 encryption
//! - [`FormationKey`] - HMAC-SHA256 PSK formation authentication
//! - [`CallsignGenerator`] - NATO phonetic callsign generation
//! - [`MeshCertificate`] / [`CertificateBundle`] - Peer certificate validation
//! - [`EnrollmentService`] - Mesh enrollment protocol
//! - [`MeshGenesis`] / [`MeshCredentials`] - Mesh creation and key derivation
//!
//! These primitives have no domain-specific dependencies and can be used
//! by any mesh networking application.

pub mod callsign;
pub mod certificate;
pub mod device_id;
pub mod encryption;
pub mod enrollment;
pub mod error;
pub mod formation_key;
#[cfg(feature = "automerge-backend")]
pub mod formation_peers;
pub mod genesis;
pub mod keypair;

pub use callsign::{
    CallsignError, CallsignGenerator, MAX_CALLSIGN_LENGTH, NATO_ALPHABET, TOTAL_CALLSIGNS,
};
pub use certificate::{CertificateBundle, MeshCertificate, MeshTier};
pub use device_id::DeviceId;
pub use encryption::{
    EncryptedCellMessage, EncryptedData, EncryptedDocument, EncryptionKeypair, EncryptionManager,
    GroupKey, SecureChannel, SymmetricKey, NONCE_SIZE, SYMMETRIC_KEY_SIZE, X25519_PUBLIC_KEY_SIZE,
};
pub use enrollment::{
    EnrollmentRequest, EnrollmentResponse, EnrollmentService, EnrollmentStatus,
    StaticEnrollmentService,
};
pub use error::SecurityError;
pub use formation_key::{
    FormationAuthResult, FormationChallenge, FormationChallengeResponse, FormationKey,
    FORMATION_CHALLENGE_SIZE, FORMATION_RESPONSE_SIZE,
};
#[cfg(feature = "automerge-backend")]
pub use formation_peers::FormationPeerSet;
pub use genesis::{MembershipPolicy, MeshCredentials, MeshGenesis};
pub use keypair::DeviceKeypair;

/// Default challenge timeout in seconds
pub const DEFAULT_CHALLENGE_TIMEOUT_SECS: u64 = 30;

/// Size of challenge nonce in bytes
pub const CHALLENGE_NONCE_SIZE: usize = 32;

/// Size of Ed25519 public key in bytes
pub const PUBLIC_KEY_SIZE: usize = 32;

/// Size of Ed25519 signature in bytes
pub const SIGNATURE_SIZE: usize = 64;

#[cfg(test)]
mod tests {
    use super::*;

    #[test]
    fn test_module_exports() {
        // Verify all public types are accessible
        let _: fn() -> DeviceKeypair = DeviceKeypair::generate;
        let _: fn() -> EncryptionKeypair = EncryptionKeypair::generate;
        let _: fn() -> CallsignGenerator = CallsignGenerator::new;
    }
}