miden-client-web 0.14.8

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

use serde_wasm_bindgen::{from_value, to_value};
use wasm_bindgen::prelude::*;

use crate::{WebClient, js_error_with_context};

#[wasm_bindgen]
impl WebClient {
    /// Retrieves the setting value for `key`, or `None` if it hasn’t been set.
    #[wasm_bindgen(js_name = "getSetting")]
    pub async fn get_setting(&mut self, key: String) -> Result<Option<JsValue>, JsValue> {
        if let Some(client) = self.get_mut_inner() {
            let result: Option<Vec<u8>> = client.get_setting(key).await.map_err(|err| {
                js_error_with_context(err, "failed to get setting value from the store")
            })?;
            let deserialized_result = result
                .map(|bytes| {
                    to_value(&bytes).map_err(|err| {
                        js_error_with_context(
                            err,
                            "failed to deserialize setting value into a JsValue",
                        )
                    })
                })
                .transpose()?;
            Ok(deserialized_result)
        } else {
            Err(JsValue::from_str("Client not initialized"))
        }
    }

    /// Sets a setting key-value in the store. It can then be retrieved using `get_setting`.
    #[wasm_bindgen(js_name = "setSetting")]
    pub async fn set_setting(&mut self, key: String, value: JsValue) -> Result<(), JsValue> {
        let value_bytes: Vec<u8> = from_value(value).map_err(|err| {
            js_error_with_context(err, "failed to serialize given value into bytes")
        })?;
        if let Some(client) = self.get_mut_inner() {
            client.set_setting(key, value_bytes).await.map_err(|err| {
                js_error_with_context(err, "failed to set setting value in the store")
            })?;
            Ok(())
        } else {
            Err(JsValue::from_str("Client not initialized"))
        }
    }

    /// Deletes a setting key-value from the store.
    #[wasm_bindgen(js_name = "removeSetting")]
    pub async fn remove_setting(&mut self, key: String) -> Result<(), JsValue> {
        if let Some(client) = self.get_mut_inner() {
            client.remove_setting(key).await.map_err(|err| {
                js_error_with_context(err, "failed to delete setting value in the store")
            })?;
            Ok(())
        } else {
            Err(JsValue::from_str("Client not initialized"))
        }
    }

    /// Returns all the existing setting keys from the store.
    #[wasm_bindgen(js_name = "listSettingKeys")]
    pub async fn list_setting_keys(&mut self) -> Result<Vec<String>, JsValue> {
        if let Some(client) = self.get_mut_inner() {
            client.list_setting_keys().await.map_err(|err| {
                js_error_with_context(err, "failed to list setting keys in the store")
            })
        } else {
            Err(JsValue::from_str("Client not initialized"))
        }
    }
}