Struct EncryptionContext

pub struct EncryptionContext;

Provides task-local context for AAD during encryption/decryption operations.

This allows passing the Redis key (or other storage identifier) as AAD to encryption operations without modifying function signatures throughout the codebase.

Implementations

impl EncryptionContext

pub async fn with_aad<F, Fut, R>(aad: String, f: F) -> R

where F: FnOnce() -> Fut, Fut: Future<Output = R>,

Runs a future with AAD context set.

The AAD context will be available to any code running within the future via EncryptionContext::get().

Arguments

• aad - The AAD string (typically the Redis key) to use for encryption
• f - A closure that returns a Future to execute with the AAD context

Example

let key = "oz-relayer:signer:my-signer-id";
let result = EncryptionContext::with_aad(key.to_string(), || async {
    // Within this block, EncryptionContext::get() returns Some(key)
    serialize_signer(&signer)
}).await;

pub fn with_aad_sync<F, R>(aad: String, f: F) -> R

where F: FnOnce() -> R,

Runs a synchronous closure with AAD context set.

This is useful when the encryption/decryption operation is synchronous (like serde serialization) but needs access to the AAD context. Unlike with_aad, this doesn’t require the closure to return a Future, avoiding Send/Sync issues with captured references.

Arguments

• aad - The AAD string (typically the Redis key) to use for encryption
• f - A synchronous closure to execute with the AAD context

Example

let key = "oz-relayer:signer:my-signer-id";
let result = EncryptionContext::with_aad_sync(key.to_string(), || {
    // Within this block, EncryptionContext::get() returns Some(key)
    serde_json::to_string(&signer)
})?;

pub fn get() -> Option<String>

Gets the current AAD context, if set.

Returns Some(aad) if called within a with_aad scope, otherwise returns None.

This is safe to call from synchronous code (like serde serializers) as long as it’s running within an async task that has set the context.

pub fn is_set() -> bool

Checks if AAD context is currently set.