Vaults and key recovery

How to protect your coins if your key is stolen or lost.

The two most common ways to lose cryptocurrency are having your key stolen and losing it. Qanum's consensus rules include one tool for each. They do not depend on a particular wallet or on any intermediary: every node on the network enforces them.

If your key is stolen: vaults

A vault has two keys:

Every spend with the everyday key goes through a waiting window that you choose when you create the vault, for example 1,152 blocks (about one day). During the window the spend is visible on the network, and the cold key can cancel it instantly and move the coins somewhere safe.

If someone steals your everyday key, they cannot take the coins straight away: the theft is in plain sight and you have the whole window to undo it.

How a vault works A spend with the everyday key moves the vault to a pending spend. When the waiting window ends it can be completed. During the window, the cold key can cancel it at any time. Vault Pending spend visible on the network Final spend Cancelled coins moved to safety everyday key waiting window e.g. 1,152 blocks ≈ 1 day cold key, at any time How a vault works A spend with the everyday key moves the vault to a pending spend. When the waiting window ends it can be completed. During the window, the cold key can cancel it at any time. Vault everyday key Pending spend visible on the network waiting window e.g. 1,152 blocks ≈ 1 day cold key, at any time Final spend Cancelled coins moved to safety

What consensus guarantees:

Extra post-quantum protection. If the cold key is SLH-DSA (hash-based signatures), it belongs to a different cryptographic family from the everyday key (ML-DSA, lattice-based). Breaking a single signature type is not enough to empty the vault.

If you lose your key: delayed recovery

A coin can have a main key (ML-DSA-87) and a recovery key (SLH-DSA) that you keep separately. The main key spends at any time. The recovery key can only move the coin once the number of blocks you chose has passed since you received it: from 144 blocks (about 3 hours) to about 12.5 years.

If you ever lose the main key, the recovery key gives you access back once the delay has passed.

Note: recovery protects against loss, not theft. Whoever holds your main key can still spend. Against theft, use a vault.

What they do not solve

Learn more