Enum HpkeError 

pub enum HpkeError {
    ValidationError,
    DeserializeError,
    EncapError,
    DecapError,
    OpenError,
    DeriveKeyPairError,
    MessageLimitReached,
    NotSupported,
    InvalidPseudorandomKey,
    InvalidKey,
    KdfOutputTooLong,
    Aead(AeadError),
    EllipticCurve(EllipticCurveError),
    MlKem(MlKemError),
    Random(RandomError),
    Unspecified,
}

Errors that can occur during HPKE setup, key encapsulation, key derivation or message encryption/decryption.

Variants

ValidationError

A KEM input or output failed validation (e.g. an invalid or low-order public key was provided), or a pre-shared key mode input is missing (an empty pre-shared key or pre-shared key identifier).

DeserializeError

A key, encapsulated key or ciphertext could not be deserialized (e.g. wrong length or malformed encoding).

EncapError

The encapsulation step failed (e.g. the recipient’s public key is invalid).

DecapError

The decapsulation step failed (e.g. the encapsulated key is invalid, or the Diffie-Hellman output was rejected).

OpenError

The AEAD failed to decrypt the ciphertext (wrong key, tampered ciphertext or wrong associated data).

DeriveKeyPairError

Deriving a key pair from input keying material failed after exhausting all rejection-sampling candidates.

MessageLimitReached

A message length or sequence-number limit was reached: the plaintext exceeds the AEAD’s P_MAX, the ciphertext exceeds C_MAX, or the context has exhausted its sequence numbers, so no further messages can be sealed or opened with this context (draft-ietf-hpke-hpke-05 Sections 4.3 and 5.2).

NotSupported

The operation is not supported by this KEM, KDF or AEAD (e.g. an authenticated mode with a KEM that does not support it, or sealing a message with the Export-Only pseudo-AEAD).

InvalidPseudorandomKey

The pseudorandom key given to the KDF expand step does not have the expected length.

InvalidKey

The key given to the AEAD does not have the expected length.

KdfOutputTooLong

The KDF was asked for more output than it can produce (255 * OUTPUT_SIZE for two-stage KDFs, 2^16 - 1 bytes for single-stage KDFs).

Aead(AeadError)

An underlying AEAD error.

EllipticCurve(EllipticCurveError)

An underlying elliptic-curve error.

MlKem(MlKemError)

An underlying ML-KEM error.

Random(RandomError)

The operating system’s random number generator failed.

Unspecified

Something went wrong, without further details.

Trait Implementations

impl Clone for HpkeError

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Copy for HpkeError

impl Debug for HpkeError

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

Formats the value using the given formatter.

impl Display for HpkeError

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

Formats the value using the given formatter.

impl Eq for HpkeError

impl Error for HpkeError

fn source(&self) -> Option<&(dyn Error + 'static)>

Returns the lower-level source of this error, if any.

fn description(&self) -> &str

👎Deprecated since 1.42.0:

use the Display impl or to_string()

fn cause(&self) -> Option<&dyn Error>

👎Deprecated since 1.33.0:

replaced by Error::source, which can support downcasting

fn provide<'a>(&'a self, request: &mut Request<'a>)

🔬This is a nightly-only experimental API. (error_generic_member_access)

Provides type-based access to context intended for error reports.

impl From<AeadError> for HpkeError

fn from(err: AeadError) -> Self

Converts to this type from the input type.

impl From<EllipticCurveError> for HpkeError

fn from(err: EllipticCurveError) -> Self

Converts to this type from the input type.

impl From<HkdfError> for HpkeError

fn from(err: HkdfError) -> Self

Converts to this type from the input type.

impl From<MlKemError> for HpkeError

fn from(err: MlKemError) -> Self

Converts to this type from the input type.

impl From<RandomError> for HpkeError

fn from(err: RandomError) -> Self

Converts to this type from the input type.

impl From<XWingError> for HpkeError

fn from(err: XWingError) -> Self

Converts to this type from the input type.

impl PartialEq for HpkeError

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

Equality operator ==.

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

Inequality operator !=.

impl StructuralPartialEq for HpkeError