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 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.
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).