Struct Enclave 

pub struct Enclave<T> {
    pub metadata: T,
    pub encrypted_bytes: Box<[u8]>,
    pub nonce: [u8; 12],
}

Enclave acts as a container for encrypted data, including metadata and the encrypted content itself.

Metadata is unencrypted and can be used to store information about the data, while the actual data is securely encrypted.

Type Parameters

• T: The type of metadata associated with the encrypted data.

Fields

metadata: T

Metadata associated with the encrypted data.

encrypted_bytes: Box<[u8]>

The encrypted data.

nonce: [u8; 12]

The nonce used in the encryption process, 8 bytes long (ChaCha20).

Implementations

impl<T> Enclave<T>

where T: TryFrom<Vec<u8>> + Into<Vec<u8>> + Clone,

pub fn from_plain_bytes( metadata: T, key: [u8; 32], plain_bytes: Vec<u8>, ) -> Result<Self, String>

Creates a new Enclave instance from unencrypted data.

Arguments

• metadata: The metadata to be associated with the encrypted data.
• key: A 32-byte cipher key used for encryption.
• plain_bytes: The data to be encrypted.

Returns

A Result containing the newly created Enclave instance, or an error string if encryption fails.

pub fn decrypt(&self, key: [u8; 32]) -> Result<Vec<u8>, EnclaveError>

Decrypts the contents of the enclave using a provided key.

Arguments

• key: The 32-byte cipher key used for decryption.

Returns

A Result containing the decrypted data as a vector of bytes, or an error string if decryption fails.

pub fn recover_key( encrypted_bytes: &[u8], password: &[u8], ) -> Result<Key<KEY_SIZE, 16>, EnclaveError>

Recovers the key used to encrypt the enclave using a provided password.

Arguments

• encrypted_bytes: The encrypted enclave.

Returns

A Result containing the recovered key, or an error string if recovery fails.

Trait Implementations

impl<T: Clone> Clone for Enclave<T>

fn clone(&self) -> Enclave<T>

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl<T: Debug> Debug for Enclave<T>

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

Formats the value using the given formatter.

impl<T> From<Enclave<T>> for Vec<u8>

where T: TryFrom<Vec<u8>> + Into<Vec<u8>>,

fn from(enclave: Enclave<T>) -> Vec<u8>

Serializes an Enclave instance into a byte vector.

Arguments

• enclave: The Enclave instance to be serialized.

Returns

A Vec<u8> representing the serialized enclave.

impl<T> PartialEq for Enclave<T>

where T: PartialEq + TryFrom<Vec<u8>> + Into<Vec<u8>>,

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

Compares two Enclave instances for equality.

Arguments

• other: Another Enclave instance to compare with.

Returns

true if both Enclave instances are equal, false otherwise.

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<T> TryFrom<Vec<u8>> for Enclave<T>

where T: TryFrom<Vec<u8>> + Into<Vec<u8>>,

fn try_from(bytes: Vec<u8>) -> Result<Self, EnclaveError>

Deserializes a byte vector into an Enclave instance.

Arguments

• bytes: The byte vector representing the serialized enclave.

Returns

A Result containing the deserialized Enclave instance, or an EnclaveError if deserialization fails.

type Error = EnclaveError

The type returned in the event of a conversion error.