From e3092254955a6be8762486f8eff0c97548727df0 Mon Sep 17 00:00:00 2001 From: Daira Hopwood Date: Thu, 26 Aug 2021 19:51:18 +0100 Subject: [PATCH] ZIP 316: Update terminology to better account for viewing keys. Signed-off-by: Daira Hopwood --- zip-0316.rst | 25 +++++++++++++++++-------- 1 file changed, 17 insertions(+), 8 deletions(-) diff --git a/zip-0316.rst b/zip-0316.rst index f491ce8e..d8f27117 100644 --- a/zip-0316.rst +++ b/zip-0316.rst @@ -28,10 +28,11 @@ Recipient A wallet or other software that can receive transfers of assets (such as ZEC) or in the future potentially other transaction-based state changes. Producer - A wallet or other software that can create an Address (normally also a - Recipient). + A wallet or other software that can create an Address (in which case it is + normally also a Recipient) or a Viewing Key. Consumer - A wallet or other software that can make use of an Address that it is given. + A wallet or other software that can make use of an Address or Viewing Key + that it is given. Sender A wallet or other software that can send transfers of assets, or other consensus state side-effects defined in future. Senders are a subset of @@ -42,7 +43,12 @@ Receiver unambiguously with a specific Receiver Type, identified by an integer Typecode. Receiver Encoding An encoding of a Receiver as a byte sequence. -Legacy Address (or LA) +Viewing Key + The necessary information to view information about a payments to an Address, + or (in the case of a Full Viewing Key) from an Address. +Viewing Key Encoding + An encoding of a Viewing Key as a byte sequence. +Legacy Address A Transparent, Sprout, or Sapling Address. Unified Address (or UA) A Unified Address combines multiple Receivers. @@ -50,6 +56,8 @@ Unified Full Viewing Key (or UFVK) A Unified Full Viewing Key combines multiple Full Viewing Keys. Unified Incoming Viewing Key (or UIVK) A Unified Incoming Viewing Key combines multiple Incoming Viewing Keys. +Unified Viewing Key + Either a Unified Full Viewing Key or a Unified Incoming Viewing Key. Address Either a Legacy Address or a Unified Address. Transfer Protocol @@ -182,11 +190,12 @@ Receivers --------- Every Wallet must properly *parse* a Unified Address containing unrecognized -Receiver Types; and similarly for Unified Full Viewing Keys and Unified -Incoming Viewing Keys. +Receiver Types; and similarly for Unified Viewing Keys containing unrecognized +Viewing Key Types. -A Wallet may process unrecognized Receiver Types by indicating to the user -their presence or similar information for usability or diagnostic purposes. +A Wallet may process unrecognized Receiver Types or Viewing Key Types by +indicating to the user their presence or similar information for usability or +diagnostic purposes. Transport Encoding ------------------