octo
/
Zebra
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity

Better doc comment for sapling::TranmissionKey

This commit is contained in:
Deirdre Connolly 2020-03-28 15:47:04 -04:00 committed by Deirdre Connolly
parent b175d1f1ba
commit ebe5cce3bb
1 changed files with 11 additions and 4 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

15
zebra-chain/src/keys/sapling.rs
View File

@ -159,11 +159,18 @@ impl fmt::Debug for Diversifier {
}
}
/// Derived from an _IncomingViewingKey_ and a _Diversifier_
/// A (diversified) _TransmissionKey_
///
/// Derived by multiplying the diversifier (converted to an affine
/// point on the Jubjub curve) by the incoming view key:
/// pkd = gd * ivk
/// In Sapling, secrets need to be transmitted to a recipient of funds
/// in order for them to be later spent. To transmit these secrets
/// securely to a recipient without requiring an out-of-band
/// communication channel, the diversied transmission key is used to
/// encrypt them.
///
/// Derived by multiplying a JubJub point [derived][ps] from a
/// _Diversifier_ by the _IncomingViewingKey_ scalar.
///
/// [ps]: https://zips.z.cash/protocol/protocol.pdf#concretediversifyhash
pub type TransmissionKey = redjubjub::PublicKeyBytes;
/// Full Viewing Keys