miden-client-web 0.15.0

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

use js_export_macro::js_export;
use miden_client::transaction::TransactionScript as NativeTransactionScript;

use crate::models::package::Package;
use crate::models::word::Word;
use crate::platform::JsErr;

/// A transaction script is a program that is executed in a transaction after all input notes have
/// been executed.
///
/// The `TransactionScript` object is composed of:
/// - An executable program defined by a MAST forest and an associated entrypoint.
/// - A set of transaction script inputs defined by a map of key-value inputs that are loaded into
///   the advice inputs' map such that the transaction script can access them.
#[derive(Clone)]
#[js_export]
pub struct TransactionScript(NativeTransactionScript);

#[js_export]
impl TransactionScript {
    /// Returns the MAST root commitment of the transaction script.
    pub fn root(&self) -> Word {
        miden_client::Word::from(self.0.root()).into()
    }

    /// Creates a `NoteScript` from the given `Package`.
    /// Throws if the package is invalid.
    #[js_export(js_name = "fromPackage")]
    pub fn from_package(package: &Package) -> Result<TransactionScript, JsErr> {
        let program = package.as_program()?;
        let native_transaction_script = NativeTransactionScript::new(program.into());
        Ok(native_transaction_script.into())
    }
}

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

impl From<NativeTransactionScript> for TransactionScript {
    fn from(native_transaction_script: NativeTransactionScript) -> Self {
        TransactionScript(native_transaction_script)
    }
}

impl From<&NativeTransactionScript> for TransactionScript {
    fn from(native_transaction_script: &NativeTransactionScript) -> Self {
        TransactionScript(native_transaction_script.clone())
    }
}

impl From<TransactionScript> for NativeTransactionScript {
    fn from(transaction_script: TransactionScript) -> Self {
        transaction_script.0
    }
}

impl From<&TransactionScript> for NativeTransactionScript {
    fn from(transaction_script: &TransactionScript) -> Self {
        transaction_script.0.clone()
    }
}