miden-client-web 0.14.2

Web Client library that facilitates interaction with the Miden network
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107

use miden_client::note::{Note as NativeNote, PartialNote as NativePartialNote};
use miden_client::transaction::RawOutputNote as NativeRawOutputNote;
use wasm_bindgen::prelude::*;

use super::note::Note;
use super::note_assets::NoteAssets;
use super::note_id::NoteId;
use super::note_metadata::NoteMetadata;
use super::partial_note::PartialNote;
use super::word::Word;
use crate::models::miden_arrays::OutputNoteArray;

/// Representation of a note produced by a transaction (full or partial).
#[derive(Clone)]
#[wasm_bindgen]
pub struct OutputNote(NativeRawOutputNote);

#[wasm_bindgen]
impl OutputNote {
    /// Wraps a full note output.
    pub fn full(note: &Note) -> OutputNote {
        let native_note: NativeNote = note.into();
        OutputNote(NativeRawOutputNote::Full(native_note))
    }

    /// Wraps a partial note containing assets and recipient only.
    pub fn partial(partial_note: &PartialNote) -> OutputNote {
        let native_partial_note: NativePartialNote = partial_note.into();
        OutputNote(NativeRawOutputNote::Partial(native_partial_note))
    }

    /// Returns the assets if they are present.
    pub fn assets(&self) -> Option<NoteAssets> {
        Some(self.0.assets().into())
    }

    /// Returns the note ID for this output.
    pub fn id(&self) -> NoteId {
        self.0.id().into()
    }

    /// Returns the recipient digest.
    #[wasm_bindgen(js_name = "recipientDigest")]
    pub fn recipient_digest(&self) -> Word {
        self.0.recipient_digest().into()
    }

    /// Returns the metadata that accompanies this output.
    pub fn metadata(&self) -> NoteMetadata {
        self.0.metadata().into()
    }

    /// Converts into a full note if the data is present.
    #[wasm_bindgen(js_name = "intoFull")]
    pub fn into_full(self) -> Option<Note> {
        match self.0 {
            NativeRawOutputNote::Full(note) => Some(note.into()),
            NativeRawOutputNote::Partial(_) => None,
        }
    }

    pub(crate) fn note(&self) -> &NativeRawOutputNote {
        &self.0
    }
}

// CONVERSIONS
// ================================================================================================

impl From<NativeRawOutputNote> for OutputNote {
    fn from(raw_output_note: NativeRawOutputNote) -> Self {
        OutputNote(raw_output_note)
    }
}

impl From<&NativeRawOutputNote> for OutputNote {
    fn from(raw_output_note: &NativeRawOutputNote) -> Self {
        OutputNote(raw_output_note.clone())
    }
}

impl From<OutputNote> for NativeRawOutputNote {
    fn from(output_note: OutputNote) -> Self {
        output_note.0
    }
}

impl From<&OutputNote> for NativeRawOutputNote {
    fn from(output_note: &OutputNote) -> Self {
        output_note.0.clone()
    }
}

// CONVERSIONS
// ================================================================================================

impl From<OutputNoteArray> for Vec<NativeRawOutputNote> {
    fn from(output_notes_array: OutputNoteArray) -> Self {
        output_notes_array.__inner.into_iter().map(Into::into).collect()
    }
}

impl From<&OutputNoteArray> for Vec<NativeRawOutputNote> {
    fn from(output_notes_array: &OutputNoteArray) -> Self {
        output_notes_array.__inner.iter().cloned().map(Into::into).collect()
    }
}