privacy state

Usage

$ beam privacy state reset
$ beam privacy state repair

What's in the file

The resume cache lives at ~/.beam/privacy-state.json and stores:

• Owned-note checkpoints returned by the privacy client
• Incoming scan cursors and incoming transfer summaries
• Pending operation records for submitted privacy transactions
• Standard-version + bridge-address metadata so Beam can detect stale state after a chain profile change

Invariants

• The file is a resume cache, not the authority. Beam revalidates cached checkpoints and live bridge state before balance reads or spends.
• Invalid JSON fails closed. Beam will not rewrite the file until you repair or restore it.
• Mismatching standard version, chain id, bridge address, wallet, or private address causes Beam to reject stale state on load.

reset

$ beam privacy state reset

Clears state for the active wallet + chain only. Other chains and wallets are untouched. Useful when you want to force a full rescan after a clean slate.

repair

$ beam privacy state repair

Moves the corrupted state file aside (privacy-state.json.broken-<timestamp>) and starts with a fresh, empty cache. Use this when ~/.beam/privacy-state.json has invalid JSON and Beam is failing closed on load.