Struct sn_transfers::MainPubkey

pub struct MainPubkey(pub PublicKey);

Types used in the public API This is the MainPubkey to which tokens are send.

The MainPubkey may be published and multiple payments sent to this address by various parties.
It is useful for accepting donations, for example.

The CashNote can only be spent by the party holding the MainSecretKey that corresponds to the MainPubkey, ie the CashNote recipient.

This MainPubkey is only a client/wallet concept. It is NOT actually used in the transaction and never seen by the spentbook nodes.

The UniquePubkey used in the transaction is derived from this MainPubkey using a random derivation index, which is stored in derivation_index.

When someone wants to send tokens to this MainPubkey, they generate the id of the CashNote - the UniquePubkey - that shall hold the tokens. The UniquePubkey is generated from this MainPubkey, and only the sender will at this point know that the UniquePubkey is related to this MainPubkey. When creating the CashNote using that UniquePubkey, the sender will also include the DerivationIndex that was used to generate the UniquePubkey, so that the recipient behind the MainPubkey can also see that the UniquePubkey is related to this MainPubkey. The recipient can then use the received DerivationIndex to generate the DerivedSecretKey corresponding to that UniquePubkey, and thus unlock the value of the CashNote by using that DerivedSecretKey.

Tuple Fields

0: PublicKey

Implementations

impl MainPubkey

pub fn new(public_key: PublicKey) -> Self

pub fn verify(&self, sig: &Signature, msg: &[u8]) -> bool

Verify that the signature is valid for the message.

pub fn new_unique_pubkey(&self, index: &DerivationIndex) -> UniquePubkey

Generate a new UniquePubkey from provided DerivationIndex. This is supposed to be a unique identifier of a CashNote. A new CashNote id is generated by someone who wants to send tokens to the MainPubkey. When they create the new CashNote they will use this id, but that only works if this id was never used before.

pub fn to_bytes(self) -> [u8; 48]

pub fn public_key(&self) -> PublicKey

pub fn to_hex(&self) -> String

pub fn from_hex<T: AsRef<[u8]>>(hex: T) -> Result<Self>

Trait Implementations

impl Clone for MainPubkey

fn clone(&self) -> MainPubkey

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for MainPubkey

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for MainPubkey

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Hash for MainPubkey

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, Self: Sized,

Feeds a slice of this type into the given Hasher.

impl Ord for MainPubkey

fn cmp(&self, other: &MainPubkey) -> Ordering

This method returns an Ordering between self and other.

fn max(self, other: Self) -> Self

where Self: Sized,

Compares and returns the maximum of two values.

fn min(self, other: Self) -> Self

where Self: Sized,

Compares and returns the minimum of two values.

fn clamp(self, min: Self, max: Self) -> Self

where Self: Sized + PartialOrd,

Restrict a value to a certain interval.

impl PartialEq for MainPubkey

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

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

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

This method tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl PartialOrd for MainPubkey

fn partial_cmp(&self, other: &MainPubkey) -> Option<Ordering>

This method returns an ordering between self and other values if one exists.

fn lt(&self, other: &Rhs) -> bool

This method tests less than (for self and other) and is used by the < operator.

fn le(&self, other: &Rhs) -> bool

This method tests less than or equal to (for self and other) and is used by the <= operator.

fn gt(&self, other: &Rhs) -> bool

This method tests greater than (for self and other) and is used by the > operator.

fn ge(&self, other: &Rhs) -> bool

This method tests greater than or equal to (for self and other) and is used by the >= operator.

impl Serialize for MainPubkey

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

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl Copy for MainPubkey

impl Eq for MainPubkey

impl StructuralPartialEq for MainPubkey