> ## Documentation Index
> Fetch the complete documentation index at: https://docs.starknet.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Troubleshooting and FAQ

> Protocol pitfalls and where to learn more

These notes are **protocol-oriented**. Build commands, version pins, and toolchain issues will be documented when the reference implementation is open sourced.

## Proof verification fails (conceptual)

* **Stale anchor** — Proofs are tied to a **recent block**; regenerating is required if chain state moved materially.
* **WriteOnce conflict** — Another transaction may have consumed the same nullifier or note slot; the flow may need fresh indices.

## Wallet / signature

* Accounts must expose **SNIP-6** `is_valid_signature` behavior expected by the virtual execution model. See [Proof generation](/build/starknet-privacy/proving).

## Privacy UX

* Avoid **opening a new channel** in the same transaction (or immediately before/after) as **public deposit or withdraw** if you want to minimize linking (see [Security](/build/starknet-privacy/security)).

## Where to learn more

* **Protocol** — [IACR 2026/474](https://eprint.iacr.org/2026/474.pdf)
* **Implementation** — operational troubleshooting will move to the open source repository docs when that phase ships.