Struct vodozemac::ecies::CheckCode

pub struct CheckCode { /* private fields */ }

A check code that can be used to confirm that two EstablishedEcies objects share the same secret. This is supposed to be shared out-of-band to protect against active MITM attacks.

Since the initiator device can always tell whether a MITM attack is in progress after channel establishment, this code technically carries only a single bit of information, representing whether the initiator has determined that the channel is “secure” or “not secure”.

However, given this will need to be interactively confirmed by the user, there is risk that the user would confirm the dialogue without paying attention to its content. By expanding this single bit into a deterministic two-digit check code, the user is forced to pay more attention by having to enter it instead of just clicking through a dialogue.

Implementations

impl CheckCode

pub const fn as_bytes(&self) -> &[u8; 2]

Convert the check code to an array of two bytes.

The bytes can be converted to a more user-friendly representation. The CheckCode::to_digit converts the bytes to a two-digit number.

pub const fn to_digit(&self) -> u8

Convert the check code to two base-10 numbers.

The number should be displayed with a leading 0 in case the first digit is a 0.

Examples

let check_code = check_code.to_digit();

println!("The check code of the IECS channel is: {check_code:02}");

Trait Implementations

impl Clone for CheckCode

fn clone(&self) -> CheckCode

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for CheckCode

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

Formats the value using the given formatter.

impl PartialEq for CheckCode

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

This method tests for self and other values to be equal, and is used by ==.

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

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

impl Eq for CheckCode

impl StructuralPartialEq for CheckCode