Struct pqc_kyber::Uake

pub struct Uake {
    pub shared_secret: SharedSecret,
    /* private fields */
}

Used for unilaterally authenticated key exchange between two parties.

let mut rng = rand::thread_rng();

let mut alice = Uake::new();
let mut bob = Uake::new();
let bob_keys = keypair(&mut rng)?;

let client_init = alice.client_init(&bob_keys.public, &mut rng)?;
let server_send = bob.server_receive(client_init, &bob_keys.secret, &mut rng)?;
let client_confirm = alice.client_confirm(server_send)?;

assert_eq!(alice.shared_secret, bob.shared_secret);

Fields

shared_secret: SharedSecret

The resulting shared secret from a key exchange

Implementations

impl Uake

pub fn new() -> Self

Builds new UAKE struct

let mut kex = Uake::new();

pub fn client_init<R>( &mut self, pubkey: &PublicKey, rng: &mut R ) -> Result<UakeSendInit, KyberError>where R: CryptoRng + RngCore,

Initiates a Unilaterally Authenticated Key Exchange.

let mut rng = rand::thread_rng();
let mut alice = Uake::new();
let bob_keys = keypair(&mut rng)?;
let client_init = alice.client_init(&bob_keys.public, &mut rng)?;

pub fn server_receive<R>( &mut self, send_a: UakeSendInit, secretkey: &SecretKey, rng: &mut R ) -> Result<UakeSendResponse, KyberError>where R: CryptoRng + RngCore,

Handles the output of a client_init() request

let mut alice = Uake::new();
let mut bob = Uake::new();
let mut bob_keys = keypair(&mut rng)?;
let client_init = alice.client_init(&bob_keys.public, &mut rng)?;
let server_send = bob.server_receive(client_init, &bob_keys.secret, &mut rng)?;

pub fn client_confirm( &mut self, send_b: UakeSendResponse ) -> Result<(), KyberError>

Decapsulates and authenticates the shared secret from the output of server_receive()

let client_init = alice.client_init(&bob_keys.public, &mut rng)?;
let server_send = bob.server_receive(client_init, &bob_keys.secret, &mut rng)?;
let client_confirm = alice.client_confirm(server_send)?;
assert_eq!(alice.shared_secret, bob.shared_secret);

Trait Implementations

impl Clone for Uake

fn clone(&self) -> Uake

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for Uake

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

Formats the value using the given formatter.

impl Default for Uake

fn default() -> Self

Returns the “default value” for a type.

impl PartialEq<Uake> for Uake

fn eq(&self, other: &Uake) -> 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 Uake

impl StructuralEq for Uake

impl StructuralPartialEq for Uake