Vault encryption
Paw uses age to encrypt all vault data.
Hybrid post-quantum encryption
Paw protects vaults using a hybrid post-quantum age identity that combines classical X25519 key agreement with the post-quantum ML-KEM-768 key encapsulation mechanism.
This hybrid approach ensures that vault contents are protected against both current classical computers and future quantum computers capable of breaking classical public-key cryptography (protecting against “harvest now, decrypt later” attacks).
The private identity is encrypted using age’s scrypt-based password derivation and stored in identities/scrypt.age. When you unlock a vault, Paw decrypts this identity using your master password and holds it in memory to decrypt vault files, history, and attachments.
The master password protects the identity file; it is not used to encrypt each individual item directly.
Encrypted and unencrypted data
- Encrypted: The vault index (
vault.age), all item files initems/, revision history, and file attachments infiles/. - Unencrypted: The vault name, icon, and display color in
metadata.json(used to display locked vaults in the vault selector).
Changing the master password
When you change the master password of a vault, Paw re-encrypts the existing age private identity (identities/scrypt.age) with the new password. It does not regenerate the vault’s underlying hybrid key. Because the vault key remains unchanged, Paw does not need to re-encrypt stored items and attachments.
Scope
Encryption protects stored data at rest from unauthorized access. It does not protect against a compromised operating system while Paw is running and unlocked. See the Threat model.