Enum CryptoMode

#[non_exhaustive]
pub enum CryptoMode {
    Aes256Gcm,
    XChaCha20Poly1305,
}

Encryption schemes supportd by Discord.

Variants (Non-exhaustive)

Non-exhaustive enums could have additional variants added in future. Therefore, when matching against variants of non-exhaustive enums, an extra wildcard arm must be added to account for any future variants.

Aes256Gcm

Discord’s currently preferred non-E2EE encryption scheme.

Packets are encrypted and decrypted using the AES256GCM encryption scheme. An additional random 4B suffix is used as the source of nonce bytes for the packet. This nonce value increments by 1 with each packet.

Encrypted content begins after the RTP header and extensions, following the SRTP specification.

Nonce width of 4B (32b), at an extra 4B per packet (~0.2 kB/s).

XChaCha20Poly1305

A fallback non-E2EE encryption scheme.

Packets are encrypted and decrypted using the XChaCha20Poly1305 encryption scheme. An additional random 4B suffix is used as the source of nonce bytes for the packet. This nonce value increments by 1 with each packet.

Encrypted content begins after the RTP header and extensions, following the SRTP specification.

Nonce width of 4B (32b), at an extra 4B per packet (~0.2 kB/s).

Implementations

impl CryptoMode

pub const fn to_request_str(self) -> &'static str

Returns the name of a mode as it will appear during negotiation.

pub const fn algorithm_nonce_size(self) -> usize

Returns the nonce length in bytes required by algorithm.

pub const fn nonce_size(self) -> usize

Returns the number of bytes each nonce is stored as within a packet.

pub const fn payload_suffix_len(self) -> usize

Returns the number of bytes occupied by the encryption scheme which fall after the payload.

pub const fn tag_suffix_len(self) -> usize

Returns the number of bytes occupied by an encryption scheme’s tag which fall after the payload.

pub const fn payload_overhead(self) -> usize

Calculates the number of additional bytes required compared to an unencrypted payload.

Trait Implementations

impl Clone for CryptoMode

fn clone(&self) -> CryptoMode

Returns a copy of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for CryptoMode

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Default for CryptoMode

fn default() -> CryptoMode

Returns the “default value” for a type.

impl FromStr for CryptoMode

type Err = UnrecognisedCryptoMode

The associated error which can be returned from parsing.

fn from_str(s: &str) -> Result<Self, Self::Err>

Parses a string s to return a value of this type.

impl Hash for CryptoMode

fn hash<__H: Hasher>(&self, state: &mut __H)

Feeds this value into the given Hasher.

fn hash_slice<H>(data: &[Self], state: &mut H)

where H: Hasher, Self: Sized,

Feeds a slice of this type into the given Hasher.

impl PartialEq for CryptoMode

fn eq(&self, other: &CryptoMode) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Copy for CryptoMode

impl Eq for CryptoMode

impl StructuralPartialEq for CryptoMode