Skip to content

errors

ClassDescription
AuthenticationErrorAEAD authentication failed. A wrong key and modified authenticated data are intentionally reported as the same error.
ChunkCountExceededErrorA chunk count derived from a plaintext or ciphertext length exceeds MAX_CHUNK_COUNT.
CriticalHeaderErrorA crit (label 2) listing was rejected — wrong bucket, wrong shape, or naming a label this profile does not understand or does not actually carry.
CryptoOperationErrorA cryptographic runtime operation failed for a reason other than authentication.
EnvelopeErrorBase class for every error raised by this package.
InvalidChunkSizeErrorchunkSize is not an integer within [MIN_CHUNK_SIZE, MAX_CHUNK_SIZE].
InvalidCiphertextLengthErrorThe ciphertext length cannot represent a valid object for the selected scheme.
InvalidKeyErrorA CEK or KEK is not a 32-byte, non-zero AES-256 key.
InvalidNonceErrorA base nonce, chunk index, or last-chunk flag is not valid for per-chunk nonce derivation.
InvalidPlaintextErrorPlaintext supplied to an encryption operation is not a byte string.
InvalidPlaintextLengthErrorplaintextLength is not a non-negative safe integer or exceeds the limit for the selected scheme or encoded layout.
MalformedEnvelopeErrorThe envelope, or a value destined for one, does not match this package’s wire profile. Raised on both paths: by encode when a caller’s input would produce bytes this package could not read back, and by decode on anything the profile forbids.
NoUsableRecipientErrorNo recipient in a valid envelope could provide a CEK.
RecipientAttemptLimitErrorA recipient unwrapper reached its configured limit of key-unwrap attempts.
RecipientUnwrapErrorA recipient unwrapper failed instead of declining the available recipients.
UnsupportedSchemeErrorThe protected header’s alg is not one of the schemes this package implements (ALG_AES_256_GCM or ALG_CHUNKED_AES_256_GCM_STREAM).