feat(sdk): add platform address transition WASM bindings (#3147)

Co-authored-by: Claude Opus 4.6 <noreply@anthropic.com>

Author: shumkov

packages/wasm-dpp2/src/data_contract/model.rs

@@ -460,8 +460,8 @@ impl DataContractWasm {
     }
 
     #[wasm_bindgen(setter = "version")]
-    pub fn set_version(&mut self, version: JsValue) -> WasmDppResult<()> {
-        self.0.set_version(try_to_u32(&version, "version")?);
+    pub fn set_version(&mut self, version: &js_sys::Number) -> WasmDppResult<()> {
+        self.0.set_version(try_to_u32(version, "version")?);
         Ok(())
     }
 

packages/wasm-dpp2/src/identity/model.rs

@@ -14,7 +14,6 @@ use dpp::platform_value::string_encoding::{decode, encode};
 use dpp::prelude::Identifier;
 use dpp::serialization::{PlatformDeserializable, PlatformSerializable, ValueConvertible};
 use dpp::version::{PlatformVersion, TryFromPlatformVersioned};
-use wasm_bindgen::JsValue;
 use wasm_bindgen::prelude::wasm_bindgen;
 
 #[wasm_bindgen(typescript_custom_section)]
@@ -86,14 +85,14 @@ impl IdentityWasm {
     }
 
     #[wasm_bindgen(setter = "balance")]
-    pub fn set_balance(&mut self, balance: JsValue) -> WasmDppResult<()> {
-        self.0.set_balance(try_to_u64(&balance, "balance")?);
+    pub fn set_balance(&mut self, balance: &js_sys::BigInt) -> WasmDppResult<()> {
+        self.0.set_balance(try_to_u64(balance, "balance")?);
         Ok(())
     }
 
     #[wasm_bindgen(setter = "revision")]
-    pub fn set_revision(&mut self, revision: JsValue) -> WasmDppResult<()> {
-        self.0.set_revision(try_to_u64(&revision, "revision")?);
+    pub fn set_revision(&mut self, revision: &js_sys::BigInt) -> WasmDppResult<()> {
+        self.0.set_revision(try_to_u64(revision, "revision")?);
         Ok(())
     }
 

packages/wasm-dpp2/src/identity/transitions/create_transition.rs

@@ -21,7 +21,6 @@ use dpp::state_transition::{
     StateTransition, StateTransitionHasUserFeeIncrease, StateTransitionSingleSigned,
 };
 use serde::Deserialize;
-use wasm_bindgen::JsValue;
 use wasm_bindgen::prelude::wasm_bindgen;
 
 #[derive(Deserialize)]
@@ -209,9 +208,9 @@ impl IdentityCreateTransitionWasm {
     }
 
     #[wasm_bindgen(setter = "userFeeIncrease")]
-    pub fn set_user_fee_increase(&mut self, amount: JsValue) -> WasmDppResult<()> {
+    pub fn set_user_fee_increase(&mut self, amount: &js_sys::Number) -> WasmDppResult<()> {
         self.0
-            .set_user_fee_increase(try_to_u16(&amount, "userFeeIncrease")?);
+            .set_user_fee_increase(try_to_u16(amount, "userFeeIncrease")?);
         Ok(())
     }
 

packages/wasm-dpp2/src/identity/transitions/masternode_vote_transition.rs

@@ -183,8 +183,8 @@ impl MasternodeVoteTransitionWasm {
     }
 
     #[wasm_bindgen(setter = nonce)]
-    pub fn set_nonce(&mut self, nonce: JsValue) -> WasmDppResult<()> {
-        let nonce = try_to_u64(&nonce, "nonce")?;
+    pub fn set_nonce(&mut self, nonce: &js_sys::BigInt) -> WasmDppResult<()> {
+        let nonce = try_to_u64(nonce, "nonce")?;
         self.0 = match self.0.clone() {
             MasternodeVoteTransition::V0(mut vote) => {
                 vote.nonce = nonce;
@@ -253,7 +253,7 @@ impl MasternodeVoteTransitionWasm {
     }
 
     #[wasm_bindgen(setter = "userFeeIncrease")]
-    pub fn set_user_fee_increase(&mut self, _amount: JsValue) -> WasmDppResult<()> {
+    pub fn set_user_fee_increase(&mut self, _amount: &js_sys::Number) -> WasmDppResult<()> {
         // MasternodeVoteTransition no longer supports user fee increase; no-op.
         Ok(())
     }

packages/wasm-dpp2/src/identity/transitions/update_transition.rs

@@ -22,7 +22,6 @@ use dpp::state_transition::{
     StateTransitionLike, StateTransitionSingleSigned,
 };
 use serde::Deserialize;
-use wasm_bindgen::JsValue;
 use wasm_bindgen::prelude::wasm_bindgen;
 
 #[wasm_bindgen(typescript_custom_section)]
@@ -212,14 +211,14 @@ impl IdentityUpdateTransitionWasm {
     }
 
     #[wasm_bindgen(setter = "revision")]
-    pub fn set_revision(&mut self, revision: JsValue) -> WasmDppResult<()> {
-        self.0.set_revision(try_to_u64(&revision, "revision")?);
+    pub fn set_revision(&mut self, revision: &js_sys::BigInt) -> WasmDppResult<()> {
+        self.0.set_revision(try_to_u64(revision, "revision")?);
         Ok(())
     }
 
     #[wasm_bindgen(setter = "nonce")]
-    pub fn set_nonce(&mut self, nonce: JsValue) -> WasmDppResult<()> {
-        self.0.set_nonce(try_to_u64(&nonce, "nonce")?);
+    pub fn set_nonce(&mut self, nonce: &js_sys::BigInt) -> WasmDppResult<()> {
+        self.0.set_nonce(try_to_u64(nonce, "nonce")?);
         Ok(())
     }
 

packages/wasm-dpp2/src/lib.rs

@@ -55,6 +55,11 @@ pub use identity::{
     IdentityUpdateTransitionWasm, IdentityWasm, MasternodeVoteTransitionWasm, PartialIdentityWasm,
     PublicKeyHashLikeJs, public_key_hash_from_js,
 };
+pub use platform_address::transitions::{
+    AddressCreditWithdrawalTransitionWasm, AddressFundingFromAssetLockTransitionWasm,
+    AddressFundsTransferTransitionWasm, IdentityCreateFromAddressesTransitionWasm,
+    IdentityCreditTransferToAddressesTransitionWasm, IdentityTopUpFromAddressesTransitionWasm,
+};
 pub use platform_address::{
     FeeStrategyStepWasm, PlatformAddressInputWasm, PlatformAddressLikeArrayJs,
     PlatformAddressLikeJs, PlatformAddressOutputWasm, PlatformAddressSignerWasm,

packages/wasm-dpp2/src/platform_address/address.rs

@@ -5,9 +5,10 @@ use crate::utils::IntoWasm;
 use dpp::address_funds::PlatformAddress;
 use dpp::dashcore::Network;
 use js_sys::Uint8Array;
-use serde::de::{self, Error, Visitor};
+use serde::de::{self, Error, MapAccess, Visitor};
 use serde::ser::Serializer;
 use serde::{Deserialize, Deserializer, Serialize};
+use serde_json::Value as JsonValue;
 use std::fmt;
 use wasm_bindgen::prelude::*;
 
@@ -197,6 +198,16 @@ impl<'de> Visitor<'de> for PlatformAddressWasmVisitor {
             .map(PlatformAddressWasm)
             .map_err(|e| A::Error::custom(e.to_string()))
     }
+
+    fn visit_map<M>(self, map: M) -> Result<Self::Value, M::Error>
+    where
+        M: MapAccess<'de>,
+    {
+        let value = JsonValue::deserialize(de::value::MapAccessDeserializer::new(map))
+            .map_err(M::Error::custom)?;
+        let js_value = serde_wasm_bindgen::to_value(&value).map_err(M::Error::custom)?;
+        PlatformAddressWasm::try_from(&js_value).map_err(|err| M::Error::custom(err.to_string()))
+    }
 }
 
 impl<'de> Deserialize<'de> for PlatformAddressWasm {

packages/wasm-dpp2/src/platform_address/fee_strategy.rs

@@ -1,3 +1,6 @@
+use crate::error::{WasmDppError, WasmDppResult};
+use crate::impl_wasm_type_info;
+use crate::utils::{IntoWasm, try_from_options_optional_with, try_to_array};
 use dpp::address_funds::{AddressFundsFeeStrategy, AddressFundsFeeStrategyStep};
 use serde::Deserialize;
 use serde::de::{self, Deserializer, MapAccess, Visitor};
@@ -56,6 +59,8 @@ impl FeeStrategyStepWasm {
     }
 }
 
+impl_wasm_type_info!(FeeStrategyStepWasm, FeeStrategyStep);
+
 impl From<FeeStrategyStepWasm> for AddressFundsFeeStrategyStep {
     fn from(step: FeeStrategyStepWasm) -> Self {
         step.0
@@ -87,6 +92,32 @@ pub fn fee_strategy_from_steps_or_default(
         .unwrap_or_else(default_fee_strategy)
 }
 
+/// Extract an optional Vec<FeeStrategyStepWasm> from a JS options object property.
+///
+/// Returns None if the property is undefined or null.
+pub fn fee_strategy_from_js_options(
+    options: &JsValue,
+    field_name: &str,
+) -> WasmDppResult<Option<Vec<FeeStrategyStepWasm>>> {
+    try_from_options_optional_with(options, field_name, |v| {
+        let array = try_to_array(v, field_name)?;
+        array
+            .iter()
+            .enumerate()
+            .map(|(i, item)| {
+                item.to_wasm::<FeeStrategyStepWasm>("FeeStrategyStep")
+                    .map(|r| (*r).clone())
+                    .map_err(|_| {
+                        WasmDppError::invalid_argument(format!(
+                            "{}[{}] is not a FeeStrategyStep",
+                            field_name, i
+                        ))
+                    })
+            })
+            .collect()
+    })
+}
+
 impl<'de> Deserialize<'de> for FeeStrategyStepWasm {
     fn deserialize<D>(deserializer: D) -> Result<Self, D::Error>
     where

packages/wasm-dpp2/src/platform_address/input_output.rs

@@ -1,6 +1,8 @@
 use super::{PlatformAddressLikeJs, PlatformAddressWasm};
-use crate::error::WasmDppResult;
-use crate::utils::try_to_u64;
+use crate::error::{WasmDppError, WasmDppResult};
+use crate::impl_try_from_js_value;
+use crate::impl_wasm_type_info;
+use crate::utils::{IntoWasm, try_from_options_with, try_to_array, try_to_u64};
 use dpp::address_funds::PlatformAddress;
 use dpp::fee::Credits;
 use dpp::prelude::AddressNonce;
@@ -22,6 +24,8 @@ pub struct PlatformAddressInputWasm {
     amount: Credits,
 }
 
+impl_wasm_type_info!(PlatformAddressInputWasm, PlatformAddressInput);
+
 #[wasm_bindgen(js_class = PlatformAddressInput)]
 impl PlatformAddressInputWasm {
     /// Creates a new PlatformAddressInput.
@@ -65,6 +69,14 @@ impl PlatformAddressInputWasm {
 }
 
 impl PlatformAddressInputWasm {
+    pub fn new(address: PlatformAddress, nonce: AddressNonce, amount: Credits) -> Self {
+        Self {
+            address: address.into(),
+            nonce,
+            amount,
+        }
+    }
+
     /// Returns the inner values as a tuple suitable for BTreeMap insertion.
     pub fn into_inner(self) -> (PlatformAddress, (AddressNonce, Credits)) {
         (self.address.into(), (self.nonce, self.amount))
@@ -86,6 +98,9 @@ pub struct PlatformAddressOutputWasm {
     amount: Option<Credits>,
 }
 
+impl_wasm_type_info!(PlatformAddressOutputWasm, PlatformAddressOutput);
+impl_try_from_js_value!(PlatformAddressOutputWasm, "PlatformAddressOutput");
+
 #[wasm_bindgen(js_class = PlatformAddressOutput)]
 impl PlatformAddressOutputWasm {
     /// Creates a new PlatformAddressOutput with a specific amount.
@@ -122,13 +137,26 @@ impl PlatformAddressOutputWasm {
 }
 
 impl PlatformAddressOutputWasm {
-    /// Returns the inner values as a tuple suitable for BTreeMap insertion.
-    /// Panics if amount is None - use `into_inner_optional` for optional amounts.
-    pub fn into_inner(self) -> (PlatformAddress, Credits) {
-        (
-            self.address.into(),
-            self.amount.expect("amount is required for this operation"),
-        )
+    pub fn new(address: PlatformAddress, amount: Credits) -> Self {
+        Self {
+            address: address.into(),
+            amount: Some(amount),
+        }
+    }
+
+    pub fn new_optional(address: PlatformAddress, amount: Option<Credits>) -> Self {
+        Self {
+            address: address.into(),
+            amount,
+        }
+    }
+
+    /// Returns the inner values as a tuple, or an error if amount is None.
+    pub fn try_into_inner(self) -> WasmDppResult<(PlatformAddress, Credits)> {
+        let amount = self.amount.ok_or_else(|| {
+            WasmDppError::invalid_argument("PlatformAddressOutput: amount is required")
+        })?;
+        Ok((self.address.into(), amount))
     }
 
     /// Returns the inner values with optional amount.
@@ -138,10 +166,11 @@ impl PlatformAddressOutputWasm {
 }
 
 /// Converts a vector of PlatformAddressOutput into a BTreeMap.
+/// Returns an error if any output has no amount set.
 pub fn outputs_to_btree_map(
     outputs: Vec<PlatformAddressOutputWasm>,
-) -> BTreeMap<PlatformAddress, Credits> {
-    outputs.into_iter().map(|o| o.into_inner()).collect()
+) -> WasmDppResult<BTreeMap<PlatformAddress, Credits>> {
+    outputs.into_iter().map(|o| o.try_into_inner()).collect()
 }
 
 /// Converts a vector of PlatformAddressOutput into a BTreeMap with optional amounts.
@@ -156,3 +185,53 @@ pub fn outputs_to_optional_btree_map(
         .map(|o| o.into_inner_optional())
         .collect()
 }
+
+/// Extract a Vec<PlatformAddressInputWasm> from a JS options object property.
+///
+/// Reads the named property as a JS array, then extracts each element
+/// as a PlatformAddressInput wasm-bindgen object via its __wbg_ptr.
+pub fn inputs_from_js_options(
+    options: &JsValue,
+    field_name: &str,
+) -> WasmDppResult<Vec<PlatformAddressInputWasm>> {
+    let array = try_from_options_with(options, field_name, |v| try_to_array(v, field_name))?;
+    array
+        .iter()
+        .enumerate()
+        .map(|(i, item)| {
+            item.to_wasm::<PlatformAddressInputWasm>("PlatformAddressInput")
+                .map(|r| (*r).clone())
+                .map_err(|_| {
+                    WasmDppError::invalid_argument(format!(
+                        "{}[{}] is not a PlatformAddressInput",
+                        field_name, i
+                    ))
+                })
+        })
+        .collect()
+}
+
+/// Extract a Vec<PlatformAddressOutputWasm> from a JS options object property.
+///
+/// Reads the named property as a JS array, then extracts each element
+/// as a PlatformAddressOutput wasm-bindgen object via its __wbg_ptr.
+pub fn outputs_from_js_options(
+    options: &JsValue,
+    field_name: &str,
+) -> WasmDppResult<Vec<PlatformAddressOutputWasm>> {
+    let array = try_from_options_with(options, field_name, |v| try_to_array(v, field_name))?;
+    array
+        .iter()
+        .enumerate()
+        .map(|(i, item)| {
+            item.to_wasm::<PlatformAddressOutputWasm>("PlatformAddressOutput")
+                .map(|r| (*r).clone())
+                .map_err(|_| {
+                    WasmDppError::invalid_argument(format!(
+                        "{}[{}] is not a PlatformAddressOutput",
+                        field_name, i
+                    ))
+                })
+        })
+        .collect()
+}

packages/wasm-dpp2/src/platform_address/mod.rs

@@ -2,14 +2,15 @@ mod address;
 mod fee_strategy;
 mod input_output;
 mod signer;
+pub mod transitions;
 
 pub use address::{PlatformAddressLikeArrayJs, PlatformAddressLikeJs, PlatformAddressWasm};
 pub use fee_strategy::{
-    FeeStrategyStepWasm, default_fee_strategy, fee_strategy_from_steps,
-    fee_strategy_from_steps_or_default,
+    FeeStrategyStepWasm, default_fee_strategy, fee_strategy_from_js_options,
+    fee_strategy_from_steps, fee_strategy_from_steps_or_default,
 };
 pub use input_output::{
-    PlatformAddressInputWasm, PlatformAddressOutputWasm, outputs_to_btree_map,
-    outputs_to_optional_btree_map,
+    PlatformAddressInputWasm, PlatformAddressOutputWasm, inputs_from_js_options,
+    outputs_from_js_options, outputs_to_btree_map, outputs_to_optional_btree_map,
 };
 pub use signer::PlatformAddressSignerWasm;