Struct sn_dbc::DbcContent

pub struct DbcContent {
    pub parents: BTreeSet<Hash>,
    pub amount_secrets_cipher: Ciphertext,
    pub commitment: CompressedRistretto,
    pub range_proof_bytes: Vec<u8>,
    pub owner: BlindedOwner,
}

Fields

parents: BTreeSet<Hash>

amount_secrets_cipher: Ciphertext

commitment: CompressedRistretto

range_proof_bytes: Vec<u8>

owner: BlindedOwner

Implementations

impl DbcContent

Represents the content of a DBC.

pub fn new(
    parents: BTreeSet<Hash>,
    amount: Amount,
    owner_key: PublicKey,
    blinding_factor: Scalar
) -> Result<Self, Error>

pub fn random_blinding_factor() -> Scalar

pub fn validate_unblinding(&self, owner_key: &PublicKey) -> Result<(), Error>

pub fn hash(&self) -> Hash

pub fn amount_secret_by_secret_key(
    &self,
    secret_key: &SecretKey
) -> Result<AmountSecrets, Error>

Decrypt AmountSecrets using a SecretKey

pub fn amount_secrets_by_secret_key_set(
    &self,
    secret_key_set: &SecretKeySet
) -> Result<AmountSecrets, Error>

Decrypt AmountSecrets using a SecretKeySet

pub fn amount_secrets_by_secret_key_shares(
    &self,
    public_key_set: &PublicKeySet,
    secret_key_shares: &BTreeMap<usize, SecretKeyShare>
) -> Result<AmountSecrets, Error>

Decrypt AmountSecrets using threshold+1 SecretKeyShares

pub fn amount_secrets_by_decryption_shares(
    &self,
    public_key_set: &PublicKeySet,
    decryption_shares: &BTreeMap<usize, DecryptionShare>
) -> Result<AmountSecrets, Error>

Decrypt AmountSecrets using threshold+1 DecryptionShares

This fn should be used when keys (SecretKeyShare) are distributed across multiple parties. In which case each party will need to call SecretKeyShare::decrypt_share() or decrypt_share_no_verify() to generate a DecryptionShare and one party will need to obtain/aggregate all the shares together somehow.

pub fn verify_range_proof(&self) -> Result<(), Error>

Verifies range proof, ie that the committed amount is a non-negative u64.

pub fn confirm_amount_matches_commitment(
    &self,
    public_key_set: &PublicKeySet,
    decryption_shares: &BTreeMap<usize, DecryptionShare>
) -> Result<bool, Error>

Checks if the secret (encrypted) amount matches the amount commitment. returns true if they match, false if not, or an error if decryption fails.

pub fn confirm_provided_amount_matches_commitment(
    &self,
    amount: &AmountSecrets
) -> bool

Checks if the provided AmountSecrets matches the amount commitment. note that both the amount and blinding_factor must be correct.

pub fn calc_blinding_factor(
    is_last: bool,
    inputs_bf_sum: Scalar,
    outputs_bf_sum: Scalar
) -> Scalar

Calculates the blinding factor for the next output, typically used inside a loop.

is_last: must be true if this is the last output, else false. inputs_bf_sum: sum of blinding factors for all transaction inputs. outputs_bf_sum: sum of blinding factors for preceding transaction outputs.

Trait Implementations

impl Clone for DbcContent

fn clone(&self) -> DbcContent

Returns a copy of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for DbcContent

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for DbcContent

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error> where
    __D: Deserializer<'de>, 

Deserialize this value from the given Serde deserializer.

impl Hash for DbcContent

fn hash<__H: Hasher>(&self, state: &mut __H)

Feeds this value into the given Hasher.

fn hash_slice<H>(data: &[Self], state: &mut H) where
    H: Hasher, 

Feeds a slice of this type into the given Hasher.

impl PartialEq<DbcContent> for DbcContent

fn eq(&self, other: &DbcContent) -> bool

This method tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &DbcContent) -> bool

This method tests for !=.

impl Serialize for DbcContent

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error> where
    __S: Serializer, 

Serialize this value into the given Serde serializer.

impl Eq for DbcContent

impl StructuralEq for DbcContent

impl StructuralPartialEq for DbcContent