Merge pull request #148 from zcash/pczt-user-address

pczt: Add output field for storing the user-facing address

src/builder.rs

@@ -516,6 +516,7 @@ impl PreparedOutputInfo {
             // TODO: Save this?
             ock: None,
             zip32_derivation: None,
+            user_address: None,
             proprietary: BTreeMap::new(),
         }
     }

src/pczt.rs

@@ -265,6 +265,13 @@ pub struct Output {
     /// The ZIP 32 derivation path at which the spending key can be found for the output.
     pub(crate) zip32_derivation: Option<Zip32Derivation>,
 
+    /// The user-facing address to which this output is being sent, if any.
+    ///
+    /// - This is set by an Updater.
+    /// - Signers must parse this address (if present) and confirm that it contains
+    ///   `recipient` (either directly, or e.g. as a receiver within a Unified Address).
+    pub(crate) user_address: Option<String>,
+
     /// Proprietary fields related to the note being created.
     pub(crate) proprietary: BTreeMap<String, Vec<u8>>,
 }
@@ -283,6 +290,7 @@ impl fmt::Debug for Output {
             .field("rseed", &self.rseed)
             .field("rcv", &self.rcv)
             .field("zip32_derivation", &self.zip32_derivation)
+            .field("user_address", &self.user_address)
             .field("proprietary", &self.proprietary)
             .finish_non_exhaustive()
     }

src/pczt/parse.rs

@@ -180,6 +180,7 @@ impl Output {
         rcv: Option<[u8; 32]>,
         ock: Option<[u8; 32]>,
         zip32_derivation: Option<Zip32Derivation>,
+        user_address: Option<String>,
         proprietary: BTreeMap<String, Vec<u8>>,
     ) -> Result<Self, ParseError> {
         let cv = ValueCommitment::from_bytes_not_small_order(&cv)
@@ -232,6 +233,7 @@ impl Output {
             rcv,
             ock,
             zip32_derivation,
+            user_address,
             proprietary,
         })
     }

src/pczt/updater.rs

@@ -86,6 +86,11 @@ impl<'a> OutputUpdater<'a> {
         self.0.zip32_derivation = Some(derivation);
     }
 
+    /// Sets the user-facing address that the new note is being sent to.
+    pub fn set_user_address(&mut self, user_address: String) {
+        self.0.user_address = Some(user_address);
+    }
+
     /// Stores the given proprietary value at the given key.
     pub fn set_proprietary(&mut self, key: String, value: Vec<u8>) {
         self.0.proprietary.insert(key, value);