irontide-wire 1.0.1

BitTorrent peer wire protocol: messages, handshake, extensions
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

//! Message Stream Encryption / Protocol Encryption (MSE/PE).
//!
//! Obfuscates `BitTorrent` traffic using Diffie-Hellman key exchange and RC4 stream cipher.

pub(crate) mod cipher;
pub(crate) mod crypto;
pub(crate) mod dh;
pub mod handshake;
pub mod stream;

use serde::{Deserialize, Serialize};

pub use crypto::{CRYPTO_PLAINTEXT, CRYPTO_RC4};
pub use handshake::NegotiationResult;
pub use stream::MseStream;

/// Encryption mode for peer connections.
#[derive(Debug, Clone, Copy, PartialEq, Eq, Default, Serialize, Deserialize)]
pub enum EncryptionMode {
    /// No encryption. Plain `BitTorrent` handshake.
    #[default]
    Disabled,
    /// Offer both plaintext and RC4, let peer choose. Fallback to plain on MSE failure.
    Enabled,
    /// Offer plaintext-only first; if the peer rejects, retry offering both
    /// plaintext and RC4. This avoids unnecessary RC4 overhead when the peer
    /// accepts plaintext, while still connecting to RC4-only peers via retry.
    PreferPlaintext,
    /// Encrypted only. Reject unencrypted peers.
    Forced,
}

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

    #[test]
    fn encryption_mode_default_is_disabled() {
        assert_eq!(EncryptionMode::default(), EncryptionMode::Disabled);
    }
}