Wallet Guide
Abstract
This volume of The Zcash Arboretum states the protocols that a Zcash wallet runs: the derivation of its keys and addresses from one seed; the discovery of its notes from the chain through an untrusted light-client server, and what that server learns; and the construction, authorisation and submission of its payments. Each protocol is stated as a definition, construction or rule, and its correctness, security or privacy guarantee as a lemma, proposition or theorem under named assumptions. The subject is the wallet of a user of the Orchard protocol who holds funds in the Ironwood pool, the sealed Orchard pool, the Sapling pool and the transparent pool; the light-client service is an abstract query and response interface, and no implementation is described. The volume assumes the Math Guide, the Crypto Guide, the Halo 2 Guide and the Consensus Guide, and cites the Ironwood Guide for every construction of the shielded protocol. It is non-normative: the Zcash Protocol Specification and the Zcash Improvement Proposals are authoritative.
Contents
- 1 Introduction
- 2 Hierarchical key derivation (ZIP 32)
- 3 Addresses and viewing keys (ZIP 316)
- 4 Compact blocks (ZIP 307)
- 5 The light-client service
- 6 Note discovery
- 7 Commitment-tree synchronisation
- 8 Leakage to the light-client server
- 9 Anchors, confirmations, and expiry
- 10 Fees (ZIP 317)
- 11 Transaction construction
- 12 Partially created transactions (PCZT)
- 13 The transaction lifecycle
- 14 Payment requests (ZIP 321)