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
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

use js_export_macro::js_export;
use miden_client::asset::{Asset as NativeAsset, FungibleAsset as NativeFungibleAsset};
use miden_client::note::SwapNote;

use crate::models::account_id::AccountId;
use crate::models::sync_summary::SyncSummary;
use crate::models::{NoteTag, NoteType};
use crate::platform::{JsErr, from_str_err, js_u64_to_u64, maybe_wrap_send};
use crate::{WebClient, js_error_with_context};

#[js_export]
impl WebClient {
    #[js_export(js_name = "buildSwapTag")]
    pub fn build_swap_tag(
        note_type: NoteType,
        offered_asset_faucet_id: &AccountId,
        offered_asset_amount: JsU64,
        requested_asset_faucet_id: &AccountId,
        requested_asset_amount: JsU64,
    ) -> Result<NoteTag, JsErr> {
        let offered_asset_amount = js_u64_to_u64(offered_asset_amount);
        let offered_fungible_asset: NativeAsset =
            NativeFungibleAsset::new(offered_asset_faucet_id.into(), offered_asset_amount)
                .map_err(|err| {
                    js_error_with_context(err, "failed to create offered fungible asset")
                })?
                .into();

        let requested_asset_amount = js_u64_to_u64(requested_asset_amount);
        let requested_fungible_asset: NativeAsset =
            NativeFungibleAsset::new(requested_asset_faucet_id.into(), requested_asset_amount)
                .map_err(|err| {
                    js_error_with_context(err, "failed to create requested fungible asset")
                })?
                .into();

        let native_note_tag = SwapNote::build_tag(
            note_type.into(),
            &offered_fungible_asset,
            &requested_fungible_asset,
        );

        Ok(native_note_tag.into())
    }

    /// Internal implementation of `sync_state` (combined NTL + chain sync).
    ///
    /// This method performs the actual sync operation. Concurrent call coordination
    /// is handled at the JavaScript layer using the Web Locks API.
    ///
    /// **Note:** Do not call this method directly. Use `syncState()` from JavaScript instead,
    /// which provides proper coordination for concurrent calls.
    #[js_export(js_name = "syncStateImpl")]
    pub async fn sync_state_impl(&self) -> Result<SyncSummary, JsErr> {
        let mut guard = self.get_mut_inner().await;
        let client = guard.as_mut().ok_or_else(|| from_str_err("Client not initialized"))?;

        let sync_summary = maybe_wrap_send(client.sync_state())
            .await
            .map_err(|err| js_error_with_context(err, "failed to sync state"))?;

        Ok(sync_summary.into())
    }

    /// Internal implementation of `sync_chain` (on-chain-only sync). Use `syncChain()` from JS.
    #[js_export(js_name = "syncChainImpl")]
    pub async fn sync_chain_impl(&self) -> Result<SyncSummary, JsErr> {
        let mut guard = self.get_mut_inner().await;
        let client = guard.as_mut().ok_or_else(|| from_str_err("Client not initialized"))?;

        let sync_summary = maybe_wrap_send(client.sync_chain())
            .await
            .map_err(|err| js_error_with_context(err, "failed to sync chain"))?;

        Ok(sync_summary.into())
    }

    /// Internal implementation of `sync_note_transport`. Use `syncNoteTransport()` from JS.
    #[js_export(js_name = "syncNoteTransportImpl")]
    pub async fn sync_note_transport_impl(&self) -> Result<(), JsErr> {
        let mut guard = self.get_mut_inner().await;
        let client = guard.as_mut().ok_or_else(|| from_str_err("Client not initialized"))?;

        maybe_wrap_send(client.sync_note_transport())
            .await
            .map_err(|err| js_error_with_context(err, "failed to sync note transport"))?;

        Ok(())
    }

    #[js_export(js_name = "getSyncHeight")]
    pub async fn get_sync_height(&self) -> Result<u32, JsErr> {
        let mut guard = self.get_mut_inner().await;
        let client = guard.as_mut().ok_or_else(|| from_str_err("Client not initialized"))?;
        let sync_height = client
            .get_sync_height()
            .await
            .map_err(|err| js_error_with_context(err, "failed to get sync height"))?;

        Ok(sync_height.as_u32())
    }
}