Skip to main content

Export Your Viewing Key

Your viewing key is an orbview1:… string that lets a system you run read every payment to your privacy address, for example for accounting, without any power to spend. You export it yourself from the vault; nothing is published on chain.

You may not need it

To confirm single orders, a backend needs no key: it verifies each payer's payment proof with your public privacy address alone. Export the viewing key only when a system must read all your incoming payments.


What the key gives​

Someone holding your viewing key canThey cannot
See every payment your address has received or will receive: amounts, assets and the sender identity each payer choseSpend your notes or sign anything
Check a payment slip sent to you against the chainTell a spent note from an unspent one
See who you paid

The key is your incoming viewing key together with your owner key. Like any incoming viewing key, it opens every memo sealed to your address — see Viewing-only access.

It covers the privacy address of this account on the current network. The same account has a different privacy address, and a different viewing key, on another network.

NeedUse
Confirm one order's payment on a serverThe payer's payment proof, no key
Read all incoming payments, for accounting or reconciliationThe viewing key
Prove one note's contents to someoneA disclosure key

Risks​

Read before you export
  • Anyone with this key sees every payment this address has received or will receive: amounts and senders.
  • It cannot be revoked. If it leaks, receive on a different account from then on.
  • Keep it in your server's secrets. Never paste it into a website.

Use an account just for your business, so the key does not expose your personal payments.


Export it​

  1. Open Shielded Pool and unlock the vault.
  2. Open More actions (…) → Export Viewing Key.
  3. Read the warnings and tick "I understand this key reveals all payments to this address and cannot be revoked."
  4. Press Show key. The orbview1:… key appears.
  5. Press Copy key, store the key in your server's secrets, then press Done.
The Export Viewing Key dialog with its warning, the confirmation box and the Show key button

The app builds the key only when you press Show key, and forgets it when the dialog closes; it never stores it.

MessageWhat to do
"Unlock the vault before exporting the viewing key."Unlock the vault first.
"Could not build the viewing key."Lock and unlock the vault, then try again.

Verify payments with it​

A backend loads the key from its secrets and uses it with @orbinum/protocol:

StepWhat happens
DecodeThe key is read from its orbview1:{viewing secret key}:{owner key}:{checksum} form. The checksum catches a mistyped key; it is not a password
ReadA payment slip sent to your address opens with the key: amount, asset and declared sender
VerifyThe payment is checked for the expected amount and asset, and against the chain

A slip proves that a note to you exists, not who made it: settle an order on a slip only when it comes from a party you already trust. For orders from the public, verify the payer's payment proof instead. The full flow, with code: Verifying Payments.