Enum VirtualClientsError 

pub enum VirtualClientsError {
    DerivationInfoMalformed,
    EpochInfoDecryptionFailed,
    MissingEpochEncryptionKey,
    MissingPprf,
    MissingEmulationEpochState,
    StorageError,
    EncryptionKeyMismatch,
    PprfError(PprfError),
    CryptoError(CryptoError),
    HashOutputLengthMismatch {
        actual_length: usize,
        expected_length: usize,
    },
    RandError,
    Tls(Error),
    AppDataDictionaryNotSupported,
    VcComponentNotListed,
}

Available on crate feature extensions-draft-08 and crate feature virtual-clients-draft and (32-bit or 64-bit) only.

Errors that can occur while processing virtual-clients derivation info.

Variants

DerivationInfoMalformed

The derivation-info bytes failed to deserialize.

EpochInfoDecryptionFailed

AEAD decryption of the encrypted epoch info failed (wrong key, tampered ciphertext, or mismatched AAD).

MissingEpochEncryptionKey

No virtual-clients epoch encryption key was registered for this epoch.

MissingPprf

No virtual-clients PPRF was registered for this epoch.

MissingEmulationEpochState

No virtual-clients EmulationEpochState was registered for this epoch, or it has been deleted.

StorageError

Loading or storing virtual-clients state via the storage provider failed.

EncryptionKeyMismatch

The leaf encryption key in the path does not match the key derived from the path secret.

PprfError(PprfError)

PPRF evaluation failed (e.g. the input was already punctured or out of bounds).

CryptoError(CryptoError)

A cryptographic operation failed during virtual-clients processing.

HashOutputLengthMismatch

Hash function produced output of unexpected length.

Fields

actual_length: usize

The number of bytes in the hash output.

expected_length: usize

The required number of bytes in the hash output.

RandError

Random byte generation failed.

Tls(Error)

TLS encoding/decoding of a virtual-clients structure failed. Covers both serialization on the sender side and deserialization of the decrypted EpochInfoTbe on the receiver side.

AppDataDictionaryNotSupported

The leaf carrying (or about to carry) a VC derivation-info entry does not declare AppDataDictionary in its capabilities.

VcComponentNotListed

The leaf’s AppDataDictionary extension is missing the AppComponents entry, or that entry does not list VC_COMPONENT_ID.

Trait Implementations

impl Clone for VirtualClientsError

fn clone(&self) -> VirtualClientsError

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for VirtualClientsError

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

Formats the value using the given formatter.

impl Display for VirtualClientsError

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

Formats the value using the given formatter.

impl Error for VirtualClientsError

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<CryptoError> for VirtualClientsError

fn from(source: CryptoError) -> Self

Converts to this type from the input type.

impl From<Error> for VirtualClientsError

fn from(source: Error) -> Self

Converts to this type from the input type.

impl From<PprfError> for VirtualClientsError

fn from(source: PprfError) -> Self

Converts to this type from the input type.

impl From<VirtualClientsError> for MessageDecryptionError

fn from(source: VirtualClientsError) -> Self

Converts to this type from the input type.

impl<StorageError> From<VirtualClientsError> for MessageEncryptionError<StorageError>

fn from(source: VirtualClientsError) -> Self

Converts to this type from the input type.

impl From<VirtualClientsError> for StageCommitError

fn from(source: VirtualClientsError) -> Self

Converts to this type from the input type.

impl From<VirtualClientsError> for CreateCommitError

fn from(source: VirtualClientsError) -> Self

Converts to this type from the input type.

impl<StorageError> From<VirtualClientsError> for SelfUpdateError<StorageError>

fn from(source: VirtualClientsError) -> Self

Converts to this type from the input type.

impl<StorageError> From<VirtualClientsError> for RegisterVcEmulationEpochError<StorageError>

fn from(source: VirtualClientsError) -> Self

Converts to this type from the input type.

impl PartialEq for VirtualClientsError

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

Tests for self and other values to be equal, and is used by ==.

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

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

impl StructuralPartialEq for VirtualClientsError