Skip to content

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 in items/, revision history, and file attachments in files/.
  • 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.