Enum WrapBehaviour 

#[non_exhaustive]
pub enum WrapBehaviour {
    Honest,
    FailWrap,
    FailUnwrap,
    Passthrough,
    WrongKeyOnUnwrap,
    EmptyWrapWithRecall,
}

How a FakeDevice behaves when asked to wrap or unwrap.

Each variant is an adversary the tier self-test must refute. The vocabulary is deliberately wide: a fixture set that cannot express a given lie reports the guard against it as safe, so every clause of the self-test contract needs a variant that violates exactly that clause.

Variants (Non-exhaustive)

Non-exhaustive enums could have additional variants added in future. Therefore, when matching against variants of non-exhaustive enums, an extra wildcard arm must be added to account for any future variants.

Honest

Correct: AES-256-GCM under the device key, round-trips.

FailWrap

wrap_key errors — models hardware that probes present but cannot be used.

FailUnwrap

wrap_key succeeds, unwrap_key errors.

Passthrough

wrap_key returns the content key verbatim — models a “wrapping” that wraps nothing, leaving the key exportable with the blob.

WrongKeyOnUnwrap

unwrap_key returns a different key rather than failing — models a provider whose round-trip silently does not reproduce the key.

EmptyWrapWithRecall

wrap_key returns an empty wrapped key while unwrap_key still reproduces the right one from an internal slot.

Models a provider that emits nothing into the envelope but remembers the key out of band. It is the only way to violate just the “a wrap that returns nothing” clause of the self-test contract: a device that returned empty and then failed to unwrap would be refuted by the round-trip clause instead, leaving the empty-wrap guard untested. Such a provider would write envelopes carrying no wrapped key at all.

Trait Implementations

impl Clone for WrapBehaviour

fn clone(&self) -> WrapBehaviour

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Copy for WrapBehaviour

impl Debug for WrapBehaviour

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

Formats the value using the given formatter.

impl Default for WrapBehaviour

fn default() -> WrapBehaviour

Returns the “default value” for a type.

impl Eq for WrapBehaviour

impl PartialEq for WrapBehaviour

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

Equality operator ==.

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

Inequality operator !=.

impl StructuralPartialEq for WrapBehaviour