Struct AttachmentEncryptionStream 

pub struct AttachmentEncryptionStream { /* private fields */ }

Incremental encryption compatible with released clients’ combined nonce12 || ciphertext || tag16 attachment format.

The host writes Self::nonce first, each Self::update result to a private staged file, then AttachmentStreamFinal::authentication_tag. It publishes the staged file only after finish succeeds.

Guide and performance

Implementations

impl AttachmentEncryptionStream

pub fn random() -> Result<Self, SoftchatError>

Start one stream with a Rust-generated 256-bit attachment key.

The returned Self::encryption_descriptor is the released base64-encoded enc value retained in authenticated attachment metadata. Raw key bytes never cross the language boundary.

Errors

Returns a stable attachment-encryption failure.

pub fn new(key_bytes: Vec<u8>) -> Result<Self, SoftchatError>

Start one random-nonce attachment encryption stream.

Errors

Returns a stable failure unless key_bytes contains exactly 32 bytes.

pub fn encryption_descriptor(&self) -> String

Return the released-client base64 enc metadata value.

This descriptor grants decryption authority and must never be logged.

pub fn nonce(&self) -> Vec<u8>

Return the 12-byte prefix that must be written before ciphertext.

pub fn update(&self, plaintext: Vec<u8>) -> Result<Vec<u8>, SoftchatError>

Encrypt one bounded plaintext chunk.

Errors

Returns a stable failure after finish/cancel or when cumulative or per-call bounds are exceeded.

pub fn finish(&self) -> Result<AttachmentStreamFinal, SoftchatError>

Finish authentication and consume the stream.

Errors

Returns a stable failure after finish or cancellation.

pub fn cancel(&self)

Cancel and zeroize remaining stream state.

Trait Implementations

impl Debug for AttachmentEncryptionStream

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

Formats the value using the given formatter.

impl<UT> LiftRef<UT> for AttachmentEncryptionStream

type LiftType = Arc<AttachmentEncryptionStream>

impl<UT> LowerError<UT> for AttachmentEncryptionStream

fn lower_error(obj: Self) -> RustBuffer

Lower this value for scaffolding function return

impl<UT> LowerReturn<UT> for AttachmentEncryptionStream

type ReturnType = <Arc<AttachmentEncryptionStream> as LowerReturn<UniFfiTag>>::ReturnType

The type that should be returned by scaffolding functions for this type.

fn lower_return(obj: Self) -> Result<Self::ReturnType, RustCallError>

Lower the return value from an scaffolding call

fn handle_failed_lift( error: LiftArgsError, ) -> Result<Self::ReturnType, RustCallError>

Lower the return value for failed argument lifts

impl<UT> TypeId<UT> for AttachmentEncryptionStream

const TYPE_ID_META: MetadataBuffer