miden-client-web 0.14.3

Web Client library that facilitates interaction with the Miden network
use alloc::string::String;

use miden_client::account::{
    StorageMapKey as NativeStorageMapKey,
    StorageSlotName as NativeStorageSlotName,
};
use miden_client::rpc::domain::account::AccountStorageRequirements as NativeAccountStorageRequirements;
use wasm_bindgen::prelude::*;

use crate::models::word::Word;

/// Storage slot index paired with map keys that must be present.
#[wasm_bindgen]
#[derive(Clone)]
pub struct SlotAndKeys {
    storage_slot_name: String,
    storage_map_keys: Vec<Word>,
}

#[wasm_bindgen]
impl SlotAndKeys {
    /// Creates a new slot-and-keys entry.
    #[wasm_bindgen(constructor)]
    pub fn new(storage_slot_name: String, storage_map_keys: Vec<Word>) -> SlotAndKeys {
        SlotAndKeys { storage_slot_name, storage_map_keys }
    }

    /// Returns the slot name.
    pub fn storage_slot_name(&self) -> String {
        self.storage_slot_name.clone()
    }

    /// Returns the storage map keys required for this slot.
    pub fn storage_map_keys(&self) -> Vec<Word> {
        self.storage_map_keys.clone()
    }
}

#[derive(Clone)]
#[wasm_bindgen]
pub struct AccountStorageRequirements(NativeAccountStorageRequirements);

#[wasm_bindgen]
impl AccountStorageRequirements {
    /// Creates empty storage requirements.
    #[wasm_bindgen(constructor)]
    pub fn new() -> AccountStorageRequirements {
        AccountStorageRequirements(NativeAccountStorageRequirements::default())
    }

    /// Builds storage requirements from a list of slot/key pairs.
    #[wasm_bindgen(js_name = "fromSlotAndKeysArray")]
    pub fn from_slot_and_keys_array(
        slots_and_keys: Vec<SlotAndKeys>,
    ) -> Result<AccountStorageRequirements, JsValue> {
        let mut intermediate: Vec<(NativeStorageSlotName, Vec<NativeStorageMapKey>)> =
            Vec::with_capacity(slots_and_keys.len());

        for sk in slots_and_keys {
            let slot_name = NativeStorageSlotName::new(sk.storage_slot_name)
                .map_err(|err| JsValue::from_str(&format!("invalid storage slot name: {err}")))?;

            let native_keys: Vec<NativeStorageMapKey> = sk
                .storage_map_keys
                .into_iter()
                .map(|w| NativeStorageMapKey::new(w.into()))
                .collect();

            intermediate.push((slot_name, native_keys));
        }

        let native_req = NativeAccountStorageRequirements::new(
            intermediate
                .iter()
                .map(|(slot_name, keys_vec)| (slot_name.clone(), keys_vec.iter())),
        );

        Ok(AccountStorageRequirements(native_req))
    }
}

impl Default for AccountStorageRequirements {
    fn default() -> Self {
        Self::new()
    }
}

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

impl From<AccountStorageRequirements> for NativeAccountStorageRequirements {
    fn from(account_storage_requirements: AccountStorageRequirements) -> Self {
        account_storage_requirements.0
    }
}

impl From<&AccountStorageRequirements> for NativeAccountStorageRequirements {
    fn from(account_storage_requirements: &AccountStorageRequirements) -> Self {
        account_storage_requirements.0.clone()
    }
}

impl From<NativeAccountStorageRequirements> for AccountStorageRequirements {
    fn from(native_account_storage_requirements: NativeAccountStorageRequirements) -> Self {
        AccountStorageRequirements(native_account_storage_requirements)
    }
}

impl From<&NativeAccountStorageRequirements> for AccountStorageRequirements {
    fn from(native_account_storage_requirements: &NativeAccountStorageRequirements) -> Self {
        AccountStorageRequirements(native_account_storage_requirements.clone())
    }
}