secure-vault/io.github.alimsrepo.secure.vault/VaultException

VaultException

sealed class VaultException

Hierarchy of recoverable errors that SecureVault operations may raise.

Every public SecureVault method either succeeds or throws a VaultException; platform-specific errors are wrapped so callers can write cross-platform try/catch without depending on java.* or platform.Security.*.

Since

0.1.0

Inheritors

Types

Link copied to clipboard
class CryptoFailure(cause: Throwable) : VaultException

A cryptographic primitive (cipher, key-derivation, AEAD) failed.

Link copied to clipboard
class InvalidKey(key: String) : VaultException

The supplied key was blank or otherwise illegal.

Link copied to clipboard
class StorageUnavailable(cause: Throwable? = null) : VaultException

The backend (Keystore / Keychain / SharedPreferences file) could not be reached. Typically transient — retry after the device is unlocked or the user has authenticated.

Link copied to clipboard
class Tampered(cause: Throwable) : VaultException

The underlying ciphertext failed an integrity check — the value has been tampered with, the master key has rotated, or the data was written by a different app/installation.