Merge branch 'next' into fabrizioorsi-multicall-cli

Author: lima-limon-inc

CHANGELOG.md

@@ -8,11 +8,12 @@
 * [BREAKING] Updated `toBech32` AccountID method: it now expects a parameter to specify the NetworkID ([#1043](https://github.com/0xMiden/miden-client/pull/1043)).
 * Introduced enums instead of booleans for public APIs ([#1042](https://github.com/0xMiden/miden-client/pull/1042)).
 * [BREAKING] Made authenticator optional for `ClientBuilder` and `Client::new`. The authenticator parameter is now optional, allowing clients to be created without authentication capabilities ([#1056](https://github.com/0xMiden/miden-client/pull/1056)).
-* [BREAKING] Updated `applyStateSync` to receive a single object and then write the changes in a single transaction ([#1050](https://github.com/0xMiden/miden-client/pull/1050))
+* [BREAKING] Updated `applyStateSync` to receive a single object and then write the changes in a single transaction ([#1050](https://github.com/0xMiden/miden-client/pull/1050)).
 * [BREAKING] Refactored `OnNoteReceived` callback to return enum with update action ([#1051](https://github.com/0xMiden/miden-client/pull/1051)).
 * [BREAKING] Changed `OnNoteReceived` from closure to trait object (#1080)
 * `NoteScript` now has a `toString` method that prints its own MAST source [(#1082)](https://github.com/0xMiden/miden-client/pull/1082).
-
+* Added a `NoteScript` getter for the Web Client `Note` model ([#1135](https://github.com/0xMiden/miden-client/pull/1135/)).
+* [BREAKING] Changed `OnNoteReceived` from closure to trait object ([#1080](https://github.com/0xMiden/miden-client/pull/1080)).
 
 ### Features
 
@@ -22,7 +23,10 @@
 * Added ability to convert `Word` to `U64` array and `Felt` array in Web Client (([#1041](https://github.com/0xMiden/miden-client/pull/1041)).
 * Added `TokenSymbol` type to Web Client ([#1046](https://github.com/0xMiden/miden-client/pull/1046)).
 * [BREAKING] Added genesis commitment header to `TonicRpcClient` requests (#1045).
-* Made CLI `multicall` aware (#TBD)
+* Added authentication arguments support to `TransactionRequest` ([#1121](https://github.com/0xMiden/miden-client/pull/1121)).
+* Added bindings for retrieving storage `AccountDelta` in the web client ([#1098](https://github.com/0xMiden/miden-client/pull/1098)).
+* Added `multicall` suuport for the CLI (#TBD)
+
 
 ## 0.10.1 (2025-07-26)
 

crates/rust-client/src/transaction/mod.rs

@@ -980,10 +980,10 @@ where
         account_id: AccountId,
         transaction_request: &TransactionRequest,
     ) -> Result<(), ClientError> {
-        let current_chain_tip =
-            self.rpc_api.get_block_header_by_number(None, false).await?.0.block_num();
-
         if let Some(max_block_number_delta) = self.max_block_number_delta {
+            let current_chain_tip =
+                self.rpc_api.get_block_header_by_number(None, false).await?.0.block_num();
+
             if current_chain_tip > self.store.get_sync_height().await? + max_block_number_delta {
                 return Err(ClientError::RecencyConditionError(
                     "The client is too far behind the chain tip to execute the transaction"

crates/rust-client/src/transaction/request/builder.rs

@@ -68,6 +68,9 @@ pub struct TransactionRequestBuilder {
     /// execution. If the advice map is extended with some user defined entries, this script
     /// argument could be used as a key to access the corresponding value.
     script_arg: Option<Word>,
+    /// Optional [`Word`] that will be pushed to the stack for the authentication procedure
+    /// during transaction execution.
+    auth_arg: Option<Word>,
 }
 
 impl TransactionRequestBuilder {
@@ -89,6 +92,7 @@ impl TransactionRequestBuilder {
             foreign_accounts: BTreeMap::default(),
             ignore_invalid_input_notes: false,
             script_arg: None,
+            auth_arg: None,
         }
     }
 
@@ -240,6 +244,14 @@ impl TransactionRequestBuilder {
         self
     }
 
+    /// Sets an optional [`Word`] that will be pushed to the stack for the authentication
+    /// procedure during transaction execution.
+    #[must_use]
+    pub fn auth_arg(mut self, auth_arg: Word) -> Self {
+        self.auth_arg = Some(auth_arg);
+        self
+    }
+
     // STANDARDIZED REQUESTS
     // --------------------------------------------------------------------------------------------
 
@@ -412,6 +424,7 @@ impl TransactionRequestBuilder {
             expiration_delta: self.expiration_delta,
             ignore_invalid_input_notes: self.ignore_invalid_input_notes,
             script_arg: self.script_arg,
+            auth_arg: self.auth_arg,
         })
     }
 }

crates/rust-client/src/transaction/request/mod.rs

@@ -90,6 +90,9 @@ pub struct TransactionRequest {
     /// Optional [`Word`] that will be pushed to the operand stack before the transaction script
     /// execution.
     script_arg: Option<Word>,
+    /// Optional [`Word`] that will be pushed to the stack for the authentication procedure
+    /// during transaction execution.
+    auth_arg: Option<Word>,
 }
 
 impl TransactionRequest {
@@ -198,6 +201,16 @@ impl TransactionRequest {
         self.ignore_invalid_input_notes
     }
 
+    /// Returns the script argument for the transaction request.
+    pub fn script_arg(&self) -> &Option<Word> {
+        &self.script_arg
+    }
+
+    /// Returns the auth argument for the transaction request.
+    pub fn auth_arg(&self) -> &Option<Word> {
+        &self.auth_arg
+    }
+
     /// Builds the [`InputNotes`] needed for the transaction execution. Full valid notes for the
     /// specified authenticated notes need to be provided, otherwise an error will be returned.
     /// The transaction input notes will include both authenticated and unauthenticated notes in the
@@ -284,6 +297,10 @@ impl TransactionRequest {
             tx_args.with_tx_script(tx_script)
         };
 
+        if let Some(auth_argument) = self.auth_arg {
+            tx_args = tx_args.with_auth_args(auth_argument);
+        }
+
         tx_args
             .extend_output_note_recipients(expected_output_recipients.into_values().map(Box::new));
         tx_args.extend_merkle_store(merkle_store.inner_nodes());
@@ -338,6 +355,7 @@ impl Serializable for TransactionRequest {
         self.expiration_delta.write_into(target);
         target.write_u8(u8::from(self.ignore_invalid_input_notes));
         self.script_arg.write_into(target);
+        self.auth_arg.write_into(target);
     }
 }
 
@@ -374,6 +392,7 @@ impl Deserializable for TransactionRequest {
         let expiration_delta = Option::<u16>::read_from(source)?;
         let ignore_invalid_input_notes = source.read_u8()? == 1;
         let script_arg = Option::<Word>::read_from(source)?;
+        let auth_arg = Option::<Word>::read_from(source)?;
 
         Ok(TransactionRequest {
             unauthenticated_input_notes,
@@ -387,6 +406,7 @@ impl Deserializable for TransactionRequest {
             expiration_delta,
             ignore_invalid_input_notes,
             script_arg,
+            auth_arg,
         })
     }
 }
@@ -537,6 +557,8 @@ mod tests {
                 OutputNote::Full(notes.pop().unwrap()),
                 OutputNote::Partial(notes.pop().unwrap().into()),
             ])
+            .script_arg(rng.draw_word())
+            .auth_arg(rng.draw_word())
             .build()
             .unwrap();
 

crates/web-client/package-lock.json

@@ -1,6 +1,6 @@
 {
   "name": "@demox-labs/miden-sdk",
-  "version": "0.11.0-next.8",
+  "version": "0.11.0-next.11",
   "description": "Miden Wasm SDK",
   "collaborators": [
     "Miden",

crates/web-client/package.json

@@ -2,9 +2,7 @@ use miden_objects::account::AccountDelta as NativeAccountDelta;
 use wasm_bindgen::prelude::*;
 
 use super::{
-    // account_storage_delta::AccountStorageDelta,
-    // account_vault_delta::AccountVaultDelta,
-    felt::Felt,
+    account_storage_delta::AccountStorageDelta, account_vault_delta::AccountVaultDelta, felt::Felt,
 };
 
 #[derive(Clone)]
@@ -18,15 +16,13 @@ impl AccountDelta {
         self.0.is_empty()
     }
 
-    // TODO: storage
-    // pub fn storage(&self) -> AccountStorageDelta {
-    //     self.0.storage().into()
-    // }
+    pub fn storage(&self) -> AccountStorageDelta {
+        self.0.storage().into()
+    }
 
-    // TODO: vault
-    // pub fn vault(&self) -> AccountVaultDelta {
-    //     self.0.vault().into()
-    // }
+    pub fn vault(&self) -> AccountVaultDelta {
+        self.0.vault().into()
+    }
 
     #[wasm_bindgen(js_name = "nonceDelta")]
     pub fn nonce_delta(&self) -> Felt {

crates/web-client/src/models/account_delta.rs

@@ -0,0 +1,35 @@
+use miden_objects::account::AccountStorageDelta as NativeAccountStorageDelta;
+use wasm_bindgen::prelude::*;
+
+use super::word::Word;
+
+#[derive(Clone)]
+#[wasm_bindgen]
+pub struct AccountStorageDelta(NativeAccountStorageDelta);
+
+#[wasm_bindgen]
+impl AccountStorageDelta {
+    #[wasm_bindgen(js_name = "isEmpty")]
+    pub fn is_empty(&self) -> bool {
+        self.0.is_empty()
+    }
+
+    pub fn values(&self) -> Vec<Word> {
+        self.0.values().values().copied().map(Into::into).collect()
+    }
+}
+
+// CONVERSIONS
+// ================================================================================================
+
+impl From<NativeAccountStorageDelta> for AccountStorageDelta {
+    fn from(native_account_storage_delta: NativeAccountStorageDelta) -> Self {
+        AccountStorageDelta(native_account_storage_delta)
+    }
+}
+
+impl From<&NativeAccountStorageDelta> for AccountStorageDelta {
+    fn from(native_account_storage_delta: &NativeAccountStorageDelta) -> Self {
+        AccountStorageDelta(native_account_storage_delta.clone())
+    }
+}

crates/web-client/src/models/account_storage_delta.rs

@@ -0,0 +1,35 @@
+use miden_objects::account::AccountVaultDelta as NativeAccountVaultDelta;
+use wasm_bindgen::prelude::*;
+
+use super::fungible_asset_delta::FungibleAssetDelta;
+
+#[derive(Clone)]
+#[wasm_bindgen]
+pub struct AccountVaultDelta(NativeAccountVaultDelta);
+
+#[wasm_bindgen]
+impl AccountVaultDelta {
+    #[wasm_bindgen(js_name = "isEmpty")]
+    pub fn is_empty(&self) -> bool {
+        self.0.is_empty()
+    }
+
+    pub fn fungible(&self) -> FungibleAssetDelta {
+        self.0.fungible().into()
+    }
+}
+
+// CONVERSIONS
+// ================================================================================================
+
+impl From<NativeAccountVaultDelta> for AccountVaultDelta {
+    fn from(native_account_vault_delta: NativeAccountVaultDelta) -> Self {
+        AccountVaultDelta(native_account_vault_delta)
+    }
+}
+
+impl From<&NativeAccountVaultDelta> for AccountVaultDelta {
+    fn from(native_account_vault_delta: &NativeAccountVaultDelta) -> Self {
+        AccountVaultDelta(native_account_vault_delta.clone())
+    }
+}

crates/web-client/src/models/account_vault_delta.rs

@@ -0,0 +1,71 @@
+use miden_objects::account::{
+    AccountId as NativeAccountId, FungibleAssetDelta as NativeFungibleAssetDelta,
+};
+use wasm_bindgen::prelude::*;
+
+use super::account_id::AccountId;
+
+#[derive(Clone)]
+#[wasm_bindgen]
+pub struct FungibleAssetDeltaItem {
+    faucet_id: AccountId,
+    amount: i64,
+}
+
+#[wasm_bindgen]
+impl FungibleAssetDeltaItem {
+    #[wasm_bindgen(getter, js_name = "faucetId")]
+    pub fn faucet_id(&self) -> AccountId {
+        self.faucet_id
+    }
+
+    #[wasm_bindgen(getter)]
+    pub fn amount(&self) -> i64 {
+        self.amount
+    }
+}
+
+impl From<(&NativeAccountId, &i64)> for FungibleAssetDeltaItem {
+    fn from(native_fungible_asset_delta_item: (&NativeAccountId, &i64)) -> Self {
+        Self {
+            faucet_id: (*native_fungible_asset_delta_item.0).into(),
+            amount: *native_fungible_asset_delta_item.1,
+        }
+    }
+}
+
+#[derive(Clone)]
+#[wasm_bindgen]
+pub struct FungibleAssetDelta(NativeFungibleAssetDelta);
+
+#[wasm_bindgen]
+impl FungibleAssetDelta {
+    #[wasm_bindgen(js_name = "numAssets")]
+    pub fn num_assets(&self) -> usize {
+        self.0.num_assets()
+    }
+
+    #[wasm_bindgen(js_name = "isEmpty")]
+    pub fn is_empty(&self) -> bool {
+        self.0.is_empty()
+    }
+
+    pub fn assets(&self) -> Vec<FungibleAssetDeltaItem> {
+        self.0.iter().map(Into::into).collect()
+    }
+}
+
+// CONVERSIONS
+// ================================================================================================
+
+impl From<NativeFungibleAssetDelta> for FungibleAssetDelta {
+    fn from(native_fungible_asset_delta: NativeFungibleAssetDelta) -> Self {
+        FungibleAssetDelta(native_fungible_asset_delta)
+    }
+}
+
+impl From<&NativeFungibleAssetDelta> for FungibleAssetDelta {
+    fn from(native_fungible_asset_delta: &NativeFungibleAssetDelta) -> Self {
+        FungibleAssetDelta(native_fungible_asset_delta.clone())
+    }
+}