Struct PublicKey 

pub struct PublicKey(/* private fields */);

The public component of the encapsulation key. This is usually the key of the recipient.

For X-Wing, the key is 1216 bytes (1184 bytes for ML-KEM-768 and 32 bytes for X25519).

Implementations

impl PublicKey

pub fn to_bytes(&self) -> Vec<u8>

The raw 1216-byte encapsulation key.

pub fn from_bytes(bytes: &[u8]) -> Result<Self, Error>

Parse a raw 1216-byte encapsulation key.

Errors

Returns Error::KeyFormat if the length is wrong or the key is invalid.

impl PublicKey

pub fn seal( recipient: &PublicKey, plaintext: &[u8], info: Option<&[u8]>, ) -> Result<Vec<u8>, Error>

Seal plaintext to the recipient’s public key. This is analogous to libsodium’s Sealed Box where a message is sent anonymously to a recipient’s public key. The important difference is that a hybrid KEM is used.

With the choice of X-Wing, the ciphertext remains IND-CCA secure as long as either the security properties of X25519 or ML-KEM-768 (Kyber768) holds.

Arguments

• recipient: The public key of the recipient.
• plaintext: The plaintext message to be encrypted.
• info: Optional application-supplied information. This is usually global context (e.g. “a backup of X app”). The exact same info must be provided for sealing and unsealing, otherwise unsealing will fail.

Errors

• Error::Rng if the operating system CSPRNG is unavailable.
• Error::InfoExceedsSize if info is larger than the permitted maximum.
• Error::Seal if HPKE encapsulation or AEAD sealing unexpectedly fails.

Panics

An unavailable OS CSPRNG is reported as Error::Rng via an internal readiness check. A panic is only reachable in the residual window where the CSPRNG passes that check and then fails mid-encapsulation.

Wire Format

HEADER || ENCAPSULATED_KEY || CIPHERTEXT

Trait Implementations

impl Clone for PublicKey

fn clone(&self) -> PublicKey

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for PublicKey

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

Formats the value using the given formatter.

impl Display for PublicKey

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

Formats the value using the given formatter.

impl Eq for PublicKey

impl PartialEq for PublicKey

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

Equality operator ==.

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

Inequality operator !=.

impl StructuralPartialEq for PublicKey