🔑Note Keys

Note keys allow you to create a backup of your deposit notes encrypted onchain for easier management of deposits.

Note Keys are currently in beta and only support manual backup.

Note Keys Overview

Note Keys are a secure way to manage your Veil Cash deposits by encrypting notes and storing them onchain. Veil keys are different to your Web3 wallet you use for deposit - a fresh key should be used.

What Note Keys Do

• Encrypt / Decrypt deposit notes in-browser

• Allows storing encrypted note onchain in the Veil Note smart contract against your web3 wallet

• Based on a Ethereum key pair (Public + Private key)

• Encrypt notes against pubic key with X25519-XSalsa20-Poly1305

• Only the matching private key can decrypt

Getting Started

Setup Note Keys

• Click “Setup Note Keys”

• Choose Create New Keys or Import Existing Keys

• Set a password to encrypt and save your keys locally

• Download a backup of your keys (recommended)

⚠️ Your keys are only stored locally in your browser. If you clear your data or lose access, you’ll need your private key backup to recover.

Backup existing Notes

• Open the "My Notes" page on veil.cash
• Make sure web3 wallet is connected and Note key is unlocked

• Go to “Add Note”

• Paste a Veil deposit note

• Click “Backup Note” to store it encrypted onchain

Your veil note will be encrypted using your public note key, converted to hex and stored in the Veil Note smart contract against your web3 wallet. A transaction will be required to add this. The matching private key of your public key is the only way to decrypt the note later.

Viewing Your Notes

• Head to “My Notes”

• View Available and Spent balances

• See amount, creation date, and spent status

• Filter spent/available notes

• Copy notes for withdrawal from Veil pools

FAQ

What are Note Keys based on?

Note Keys are an Ethereum keypair (a public and private key) used specifically for encrypting and decrypting deposit notes.

How are deposit notes encrypted?

Notes are encrypted in your browser using the X25519-XSalsa20-Poly1305 encryption scheme, with your Note Key public key.

Who can decrypt an encrypted note?

Only the matching Note Key private key can decrypt the note.

Where are encrypted notes stored?

You can store encrypted notes onchain using the VeilNote smart contract. They’re saved against your Web3 wallet address—not your Note Key address.

Does my Note Key address need ETH or gas?

No. Your Note Key address is used only for encryption. It doesn’t need ETH or interact with the chain directly.

Where are my Note Keys stored?

Your keys are encrypted in your browser using AES-GCM and saved in local storage.