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
62
63
64
65
66
67
68
69
70
71
72

use js_export_macro::js_export;
use miden_client::account::{
    StorageSlot as NativeStorageSlot,
    StorageSlotName as NativeStorageSlotName,
};

use crate::models::storage_map::StorageMap;
use crate::models::word::Word;
use crate::platform::{JsErr, from_str_err};

/// A single storage slot value or map for an account component.
#[js_export]
#[derive(Clone)]
pub struct StorageSlot(NativeStorageSlot);

#[js_export]
impl StorageSlot {
    /// Creates a storage slot holding a single value.
    #[js_export(js_name = "fromValue")]
    pub fn from_value(name: String, value: &Word) -> Result<StorageSlot, JsErr> {
        let name = NativeStorageSlotName::new(name)
            .map_err(|err| from_str_err(&format!("invalid storage slot name: {err}")))?;

        Ok(NativeStorageSlot::with_value(name, value.into()).into())
    }

    /// Returns an empty value slot (zeroed).
    #[js_export(js_name = "emptyValue")]
    pub fn empty_value(name: String) -> Result<StorageSlot, JsErr> {
        let name = NativeStorageSlotName::new(name)
            .map_err(|err| from_str_err(&format!("invalid storage slot name: {err}")))?;

        Ok(NativeStorageSlot::with_empty_value(name).into())
    }

    /// Creates a storage slot backed by a map.
    pub fn map(name: String, storage_map: &StorageMap) -> Result<StorageSlot, JsErr> {
        let name = NativeStorageSlotName::new(name)
            .map_err(|err| from_str_err(&format!("invalid storage slot name: {err}")))?;

        Ok(NativeStorageSlot::with_map(name, storage_map.into()).into())
    }
}

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

impl From<NativeStorageSlot> for StorageSlot {
    fn from(native_storage_slot: NativeStorageSlot) -> Self {
        StorageSlot(native_storage_slot)
    }
}

impl From<&NativeStorageSlot> for StorageSlot {
    fn from(native_storage_slot: &NativeStorageSlot) -> Self {
        StorageSlot(native_storage_slot.clone())
    }
}

impl From<StorageSlot> for NativeStorageSlot {
    fn from(storage_slot: StorageSlot) -> Self {
        storage_slot.0
    }
}

impl From<&StorageSlot> for NativeStorageSlot {
    fn from(storage_slot: &StorageSlot) -> Self {
        storage_slot.0.clone()
    }
}

impl_napi_from_value!(StorageSlot);