Struct miden_client::notes::Note

pub struct Note { /* private fields */ }

A note with all the data required for it to be consumed by executing it against the transaction kernel.

Notes consist of note metadata and details. Note metadata is always public, but details may be either public, encrypted, or private, depending on the note type. Note details consist of note assets, script, inputs, and a serial number, the three latter grouped into a recipient object.

Note details can be reduced to two unique identifiers: NoteId and Nullifier. The former is publicly associated with a note, while the latter is known only to entities which have access to full note details.

Fungible and non-fungible asset transfers are done by moving assets to the note’s assets. The note’s script determines the conditions required for the note consumption, i.e. the target account of a P2ID or conditions of a SWAP, and the effects of the note. The serial number has a double duty of preventing double spend, and providing unlikability to the consumer of a note. The note’s inputs allow for customization of its script.

To create a note, the kernel does not require all the information above, a user can create a note only with the commitment to the script, inputs, the serial number (i.e., the recipient), and the kernel only verifies the source account has the assets necessary for the note creation. See NoteRecipient for more details.

Implementations

impl Note

pub fn new( assets: NoteAssets, metadata: NoteMetadata, recipient: NoteRecipient, ) -> Note

Returns a new Note created with the specified parameters.

pub fn header(&self) -> &NoteHeader

Returns the note’s header.

pub fn id(&self) -> NoteId

Returns the note’s unique identifier.

This value is both an unique identifier and a commitment to the note.

pub fn metadata(&self) -> &NoteMetadata

Returns the note’s metadata.

pub fn assets(&self) -> &NoteAssets

Returns the note’s assets.

pub fn serial_num(&self) -> [BaseElement; 4]

Returns the note’s recipient serial_num, the secret required to consume the note.

pub fn script(&self) -> &NoteScript

Returns the note’s recipient script which locks the assets of this note.

pub fn inputs(&self) -> &NoteInputs

Returns the note’s recipient inputs which customizes the script’s behavior.

pub fn recipient(&self) -> &NoteRecipient

Returns the note’s recipient.

pub fn nullifier(&self) -> Nullifier

Returns the note’s nullifier.

This is public data, used to prevent double spend.

pub fn hash(&self) -> RpoDigest

Returns a commitment to the note and its metadata.

hash(NOTE_ID || NOTE_METADATA)

This value is used primarily for authenticating notes consumed when the are consumed in a transaction.

Methods from Deref<Target = NoteDetails>

pub fn id(&self) -> NoteId

Returns the note’s unique identifier.

This value is both an unique identifier and a commitment to the note.

pub fn assets(&self) -> &NoteAssets

Returns the note’s assets.

pub fn serial_num(&self) -> [BaseElement; 4]

Returns the note’s recipient serial_num, the secret required to consume the note.

pub fn script(&self) -> &NoteScript

Returns the note’s recipient script which locks the assets of this note.

pub fn inputs(&self) -> &NoteInputs

Returns the note’s recipient inputs which customizes the script’s behavior.

pub fn recipient(&self) -> &NoteRecipient

Returns the note’s recipient.

pub fn nullifier(&self) -> Nullifier

Returns the note’s nullifier.

This is public data, used to prevent double spend.

Trait Implementations

impl Clone for Note

fn clone(&self) -> Note

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for Note

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

Formats the value using the given formatter.

impl Deref for Note

type Target = NoteDetails

The resulting type after dereferencing.

fn deref(&self) -> &<Note as Deref>::Target

Dereferences the value.

impl Deserializable for Note

fn read_from<R>(source: &mut R) -> Result<Note, DeserializationError>

where R: ByteReader,

Reads a sequence of bytes from the provided source, attempts to deserialize these bytes into Self, and returns the result.

fn read_from_bytes(bytes: &[u8]) -> Result<Self, DeserializationError>

Attempts to deserialize the provided bytes into Self and returns the result.

impl<'de> Deserialize<'de> for Note

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl From<&Note> for NoteDetails

fn from(note: &Note) -> NoteDetails

Converts to this type from the input type.

impl From<Note> for InputNoteRecord

fn from(note: Note) -> Self

Converts to this type from the input type.

impl From<Note> for NoteDetails

fn from(note: Note) -> NoteDetails

Converts to this type from the input type.

impl From<Note> for NoteRecordDetails

fn from(note: Note) -> Self

Converts to this type from the input type.

impl From<Note> for OutputNoteRecord

fn from(note: Note) -> Self

Converts to this type from the input type.

impl PartialEq for Note

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

Tests for self and other values to be equal, and is used by ==.

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

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

impl Serializable for Note

fn write_into<W>(&self, target: &mut W)

where W: ByteWriter,

Serializes self into bytes and writes these bytes into the target.

fn to_bytes(&self) -> Vec<u8>

Serializes self into a vector of bytes.

fn get_size_hint(&self) -> usize

Returns an estimate of how many bytes are needed to represent self.

impl Serialize for Note

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

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl TryFrom<OutputNoteRecord> for Note

type Error = ClientError

The type returned in the event of a conversion error.

fn try_from(value: OutputNoteRecord) -> Result<Self, Self::Error>

Performs the conversion.

impl TryInto<Note> for InputNoteRecord

type Error = ClientError

The type returned in the event of a conversion error.

fn try_into(self) -> Result<Note, Self::Error>

Performs the conversion.

impl Eq for Note

impl StructuralPartialEq for Note