Struct SaplingDomain

pub struct SaplingDomain<P: Parameters> { /* private fields */ }

Implementations

impl<P: Parameters> SaplingDomain<P>

pub fn for_height(params: P, height: BlockHeight) -> Self

Trait Implementations

impl<P: Parameters> BatchDomain for SaplingDomain<P>

fn batch_kdf<'a>( items: impl Iterator<Item = (Option<Self::SharedSecret>, &'a EphemeralKeyBytes)>, ) -> Vec<Option<Self::SymmetricKey>>

Computes Self::kdf on a batch of items.

fn batch_epk( ephemeral_keys: impl Iterator<Item = EphemeralKeyBytes>, ) -> Vec<(Option<Self::EphemeralPublicKey>, EphemeralKeyBytes)>

Computes Self::epk on a batch of ephemeral keys.

impl<P: Parameters> Domain for SaplingDomain<P>

fn kdf(dhsecret: SubgroupPoint, epk: &EphemeralKeyBytes) -> Blake2bHash

Sapling KDF for note encryption.

Implements section 5.4.4.4 of the Zcash Protocol Specification.

type EphemeralSecretKey = Fr

type EphemeralPublicKey = ExtendedPoint

type SharedSecret = SubgroupPoint

type SymmetricKey = Hash

type Note = Note

type Recipient = PaymentAddress

type DiversifiedTransmissionKey = SubgroupPoint

type IncomingViewingKey = SaplingIvk

type OutgoingViewingKey = OutgoingViewingKey

type ValueCommitment = ExtendedPoint

type ExtractedCommitment = Scalar

type ExtractedCommitmentBytes = SaplingExtractedCommitmentBytes

type Memo = MemoBytes

fn derive_esk(note: &Self::Note) -> Option<Self::EphemeralSecretKey>

Derives the EphemeralSecretKey corresponding to this note.

fn get_pk_d(note: &Self::Note) -> Self::DiversifiedTransmissionKey

Extracts the DiversifiedTransmissionKey from the note.

fn ka_derive_public( note: &Self::Note, esk: &Self::EphemeralSecretKey, ) -> Self::EphemeralPublicKey

Derives EphemeralPublicKey from esk and the note’s diversifier.

fn ka_agree_enc( esk: &Self::EphemeralSecretKey, pk_d: &Self::DiversifiedTransmissionKey, ) -> Self::SharedSecret

Derives the SharedSecret from the sender’s information during note encryption.

fn ka_agree_dec( ivk: &Self::IncomingViewingKey, epk: &Self::EphemeralPublicKey, ) -> Self::SharedSecret

Derives the SharedSecret from the recipient’s information during note trial decryption.

fn note_plaintext_bytes( note: &Self::Note, to: &Self::Recipient, memo: &Self::Memo, ) -> NotePlaintextBytes

Encodes the given Note and Memo as a note plaintext.

fn derive_ock( ovk: &Self::OutgoingViewingKey, cv: &Self::ValueCommitment, cmu_bytes: &Self::ExtractedCommitmentBytes, epk: &EphemeralKeyBytes, ) -> OutgoingCipherKey

Derives the OutgoingCipherKey for an encrypted note, given the note-specific public data and an OutgoingViewingKey.

fn outgoing_plaintext_bytes( note: &Self::Note, esk: &Self::EphemeralSecretKey, ) -> OutPlaintextBytes

Encodes the outgoing plaintext for the given note.

fn epk_bytes(epk: &Self::EphemeralPublicKey) -> EphemeralKeyBytes

Returns the byte encoding of the given EphemeralPublicKey.

fn epk(ephemeral_key: &EphemeralKeyBytes) -> Option<Self::EphemeralPublicKey>

Attempts to parse ephemeral_key as an EphemeralPublicKey.

fn parse_note_plaintext_without_memo_ivk( &self, ivk: &Self::IncomingViewingKey, plaintext: &[u8], ) -> Option<(Self::Note, Self::Recipient)>

Parses the given note plaintext from the recipient’s perspective.

fn parse_note_plaintext_without_memo_ovk( &self, pk_d: &Self::DiversifiedTransmissionKey, esk: &Self::EphemeralSecretKey, ephemeral_key: &EphemeralKeyBytes, plaintext: &NotePlaintextBytes, ) -> Option<(Self::Note, Self::Recipient)>

Parses the given note plaintext from the sender’s perspective.

fn cmstar(note: &Self::Note) -> Self::ExtractedCommitment

Derives the ExtractedCommitment for this note.

fn extract_pk_d( op: &OutPlaintextBytes, ) -> Option<Self::DiversifiedTransmissionKey>

Parses the DiversifiedTransmissionKey field of the outgoing plaintext.

fn extract_esk(op: &OutPlaintextBytes) -> Option<Self::EphemeralSecretKey>

Parses the EphemeralSecretKey field of the outgoing plaintext.

fn extract_memo(&self, plaintext: &NotePlaintextBytes) -> Self::Memo

Extracts the memo field from the given note plaintext.

impl<P: Parameters> ShieldedOutput<SaplingDomain<P>, COMPACT_NOTE_SIZE> for CompactOutputDescription

fn ephemeral_key(&self) -> EphemeralKeyBytes

Exposes the ephemeral_key field of the output.

fn cmstar_bytes(&self) -> SaplingExtractedCommitmentBytes

Exposes the cmu_bytes or cmx_bytes field of the output.

fn enc_ciphertext(&self) -> &[u8; 52]

Exposes the note ciphertext of the output.

impl<P: Parameters, A> ShieldedOutput<SaplingDomain<P>, ENC_CIPHERTEXT_SIZE> for OutputDescription<A>

fn ephemeral_key(&self) -> EphemeralKeyBytes

Exposes the ephemeral_key field of the output.

fn cmstar_bytes(&self) -> SaplingExtractedCommitmentBytes

Exposes the cmu_bytes or cmx_bytes field of the output.

fn enc_ciphertext(&self) -> &[u8; 580]

Exposes the note ciphertext of the output.