adnl 2.0.0

Implementation of Abstract Datagram Network Layer
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

use crate::crypto::{KeyPair, PublicKey};

use crate::{AdnlAddress, AdnlAesParams, AdnlHandshake};

use crate::helper_types::CryptoRandom;

/// Builder of [`AdnlHandshake`] structure, which then can be transformed into [`crate::AdnlClient`]
pub struct AdnlBuilder {
    aes_params: AdnlAesParams,
}

impl AdnlBuilder {
    /// Use specified session parameters. It is recommended to use random parameters.
    pub fn with_static_aes_params(aes_params: AdnlAesParams) -> Self {
        Self { aes_params }
    }

    /// Use random session parameters (recommended).
    pub fn with_random_aes_params<R: CryptoRandom>(rng: &mut R) -> Self {
        Self {
            aes_params: {
                let mut buffer = [0u8; 160];
                rng.fill_bytes(&mut buffer);
                AdnlAesParams::from(buffer)
            },
        }
    }

    /// Specify sender, receiver, and secret on which they already agreed.
    pub fn use_static_ecdh(
        self,
        sender_public: PublicKey,
        receiver_address: AdnlAddress,
        ecdh_secret: [u8; 32],
    ) -> AdnlHandshake {
        AdnlHandshake::new(
            receiver_address,
            sender_public,
            ecdh_secret,
            self.aes_params,
        )
    }

    /// Perform key agreement using sender private key and receiver public
    pub fn perform_ecdh(
        self,
        sender_keypair: &KeyPair,
        receiver_public: &PublicKey,
    ) -> AdnlHandshake {
        AdnlHandshake::new(
            AdnlAddress::from(receiver_public),
            sender_keypair.public_key,
            sender_keypair
                .secret_key
                .compute_shared_secret(receiver_public),
            self.aes_params,
        )
    }
}