Struct EncryptedStorage 

pub struct EncryptedStorage<S, C, Sec>
where
    S: StorageCoreEffects + StorageExtendedEffects,
    C: CryptoEffects,
    Sec: SecureStorageEffects,
{ /* private fields */ }

Unified encrypted storage that wraps any StorageEffects implementation.

All data passing through this layer is encrypted using a master key stored in the platform’s secure enclave via SecureStorageEffects.

Type Parameters

• S: Inner storage implementation (where encrypted blobs live)
• C: Crypto implementation (for ChaCha20-Poly1305 operations)
• Sec: Secure storage implementation (where master key lives)

Example

let encrypted = EncryptedStorage::new(
    filesystem_handler,
    crypto_handler,
    secure_storage_handler,
    EncryptedStorageConfig::default(),
).await?;

// All operations are now transparently encrypted
encrypted.store("accounts", data).await?;
let data = encrypted.retrieve("accounts").await?;

Implementations

impl<S, C, Sec> EncryptedStorage<S, C, Sec>

where S: StorageCoreEffects + StorageExtendedEffects, C: CryptoEffects, Sec: SecureStorageEffects,

pub fn new( inner: S, crypto: Arc<C>, secure: Arc<Sec>, config: EncryptedStorageConfig, ) -> Self

Create a new encrypted storage handler.

Master key initialization is lazy: the key is loaded/created on the first store/retrieve/... call. This keeps runtime assembly synchronous and avoids turning effect-system constructors into async APIs.

pub fn is_encrypted(blob: &[u8]) -> bool

Check if a blob is encrypted (has our version header).

Used for detecting unencrypted legacy data.

pub fn inner(&self) -> &S

Get reference to inner storage (for debugging/testing)

pub fn secure(&self) -> &Arc<Sec>

Get reference to secure storage (for key management)

Trait Implementations

impl<S, C, Sec> Debug for EncryptedStorage<S, C, Sec>

where S: StorageCoreEffects + StorageExtendedEffects + Debug, C: CryptoEffects, Sec: SecureStorageEffects,

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

Formats the value using the given formatter.

impl<S, C, Sec> StorageCoreEffects for EncryptedStorage<S, C, Sec>

where S: StorageCoreEffects + StorageExtendedEffects + Send + Sync, C: CryptoEffects + Send + Sync, Sec: SecureStorageEffects + Send + Sync,

fn store<'life0, 'life1, 'async_trait>( &'life0 self, key: &'life1 str, value: Vec<u8>, ) -> Pin<Box<dyn Future<Output = Result<(), StorageError>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait,

Store a value under the given key

fn retrieve<'life0, 'life1, 'async_trait>( &'life0 self, key: &'life1 str, ) -> Pin<Box<dyn Future<Output = Result<Option<Vec<u8>>, StorageError>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait,

Retrieve a value by key

fn remove<'life0, 'life1, 'async_trait>( &'life0 self, key: &'life1 str, ) -> Pin<Box<dyn Future<Output = Result<bool, StorageError>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait,

Remove a key-value pair

fn list_keys<'life0, 'life1, 'async_trait>( &'life0 self, prefix: Option<&'life1 str>, ) -> Pin<Box<dyn Future<Output = Result<Vec<String>, StorageError>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait,

List all keys with optional prefix filter

impl<S, C, Sec> StorageExtendedEffects for EncryptedStorage<S, C, Sec>

where S: StorageCoreEffects + StorageExtendedEffects + Send + Sync, C: CryptoEffects + Send + Sync, Sec: SecureStorageEffects + Send + Sync,

fn exists<'life0, 'life1, 'async_trait>( &'life0 self, key: &'life1 str, ) -> Pin<Box<dyn Future<Output = Result<bool, StorageError>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait,

Check if a key exists

fn store_batch<'life0, 'async_trait>( &'life0 self, pairs: HashMap<String, Vec<u8>>, ) -> Pin<Box<dyn Future<Output = Result<(), StorageError>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait,

Store multiple key-value pairs atomically

fn retrieve_batch<'life0, 'life1, 'async_trait>( &'life0 self, keys: &'life1 [String], ) -> Pin<Box<dyn Future<Output = Result<HashMap<String, Vec<u8>>, StorageError>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait,

Retrieve multiple values by keys

fn clear_all<'life0, 'async_trait>( &'life0 self, ) -> Pin<Box<dyn Future<Output = Result<(), StorageError>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait,

Clear all stored data

fn stats<'life0, 'async_trait>( &'life0 self, ) -> Pin<Box<dyn Future<Output = Result<StorageStats, StorageError>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait,

Get storage statistics