Module: aead

class doubleratchet.aead.AEAD[source]

Bases: ABC

Authenticated Encryption with Associated Data (AEAD).

abstractmethod async static encrypt(plaintext, key, associated_data)[source]

Parameters:

plaintext (bytes) – The plaintext to encrypt.
key (bytes) – The encryption key.
associated_data (bytes) – Additional data to authenticate without including it in the ciphertext.

Return type:

bytes

Returns:

The ciphertext.

abstractmethod async static decrypt(ciphertext, key, associated_data)[source]

Parameters:

ciphertext (bytes) – The ciphertext to decrypt.
key (bytes) – The decryption key.
associated_data (bytes) – Additional data to authenticate without including it in the ciphertext.

Return type:

bytes

Returns:

The plaintext.

Raises:

AuthenticationFailedException – if the message could not be authenticated using the associated data.
DecryptionFailedException – if the decryption failed for a different reason (e.g. invalid padding).

exception doubleratchet.aead.AuthenticationFailedException[source]

Raised by AEAD.decrypt() in case of authentication failure.

exception doubleratchet.aead.DecryptionFailedException[source]

Raised by AEAD.decrypt() in case of decryption failure.