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

//! Cryptographic definitions required by commonware-p2p and select implementations
//! of different PKI schemes.

use bytes::Bytes;

pub mod ed25519;

/// Byte array representing an arbitrary public key.
pub type PublicKey = Bytes;
/// Byte array representing an arbitrary signature.
pub type Signature = Bytes;

/// Cryptographic operations required by commonware-p2p.
///
/// # Warning
///
/// Although data provided to this implementation to be signed are expected to be
/// unique to commonware-p2p, it is strongly recommended to prefix any payloads
/// with a unique identifier (dst) to prevent replay attacks.
pub trait Crypto: Send + Sync + Clone + 'static {
    /// Returns the public key of the signer.
    fn me(&self) -> PublicKey;
    /// Sign the given data (usually an IP).
    fn sign(&mut self, dst: &[u8], data: &[u8]) -> Signature;
    /// Verify that a public key is well-formatted.
    fn validate(public_key: &PublicKey) -> bool;
    /// Check that a signature is valid for the given data and public key.
    fn verify(dst: &[u8], data: &[u8], public_key: &PublicKey, signature: &Signature) -> bool;
}