Struct Confirmation 

pub struct Confirmation { /* private fields */ }

Key confirmation message used during the handshake.

This struct contains cryptographic proof that a party can correctly derive the shared secret from the Diffie-Hellman exchange. It prevents attacks where an adversary might forward Hello messages without actually knowing the corresponding private keys.

Implementations

impl Confirmation

pub fn create( cipher: ChaCha20Poly1305, transcript: &[u8], ) -> Result<Self, Error>

Create a new Confirmation using the provided cipher and Hello transcript.

The confirmation encrypts the hello transcript to demonstrate knowledge of the shared secret and bind the confirmation to the entire hello exchange.

Security

To prevent nonce-reuse, the cipher should not be the same cipher used for future encrypted messages, but should be generated from the same shared secret. The function takes ownership of the cipher to help prevent this.

pub fn verify( &self, cipher: ChaCha20Poly1305, transcript: &[u8], ) -> Result<(), Error>

Verify the Confirmation using the provided cipher and Hello transcript.

Returns Ok(()) if the confirmation is valid, otherwise returns an error.

Trait Implementations

impl FixedSize for Confirmation

const SIZE: usize = 16usize

The size of the encoded value (in bytes).

impl Read for Confirmation

type Cfg = ()

The Cfg type parameter allows passing configuration during the read process. This is crucial for safely decoding untrusted data, for example, by providing size limits for collections or strings.

fn read_cfg(buf: &mut impl Buf, _: &()) -> Result<Self, CodecError>

Reads a value from the buffer using the provided configuration cfg.

impl Write for Confirmation

fn write(&self, buf: &mut impl BufMut)

Writes the binary representation of self to the provided buffer buf.