refactor(swift-sdk): add ViewModels for address operations (#3034)

Co-authored-by: Quantum Explorer <quantum@dash.org>

Author: alfie-dash

packages/swift-sdk/SwiftExampleApp/SwiftExampleApp/ViewModels/AddressTransferViewModel.swift

@@ -0,0 +1,100 @@
+import Foundation
+import SwiftUI
+import SwiftDashSDK
+
+/// ViewModel for the Transfer Address Funds form.
+/// Holds form state, validation, and executes the transfer via SDK.
+@MainActor
+final class AddressTransferViewModel: BaseViewModel {
+
+    // MARK: - Form inputs
+
+    @Published var inputAddressHex = ""
+    @Published var inputAmount = ""
+    @Published var inputPrivateKeyHex = ""
+    @Published var outputAddressHex = ""
+    @Published var outputAmount = ""
+
+    // MARK: - Result
+
+    @Published var result: PlatformAddressInfosResult?
+
+    // MARK: - Validation
+
+    private var validationResult: ValidationResult {
+        TransferInputValidator.validate(
+            inputAddressHex: inputAddressHex,
+            inputPrivateKeyHex: inputPrivateKeyHex,
+            outputAddressHex: outputAddressHex,
+            inputAmount: inputAmount,
+            outputAmount: outputAmount
+        )
+    }
+
+    var isFormValid: Bool {
+        validationResult.isValid
+    }
+
+    var validationErrors: [String] {
+        validationResult.errors
+    }
+
+    // MARK: - Actions
+
+    override func reset() {
+        super.reset()
+        inputAddressHex = ""
+        inputAmount = ""
+        inputPrivateKeyHex = ""
+        outputAddressHex = ""
+        outputAmount = ""
+        result = nil
+    }
+
+    /// Execute the transfer using the given SDK. Updates result or errorMessage on main actor.
+    func executeTransfer(sdk: SDK) async {
+        guard let inputAddressData = Data(hexString: inputAddressHex),
+              let privateKeyData = Data(hexString: inputPrivateKeyHex),
+              let outputAddressData = Data(hexString: outputAddressHex),
+              let inputAmt = UInt64(inputAmount),
+              let outputAmt = UInt64(outputAmount)
+        else {
+            errorMessage = "Invalid input data"
+            showResult = true
+            return
+        }
+
+        isLoading = true
+        errorMessage = nil
+        result = nil
+        showResult = false
+
+        do {
+            let inputs = [
+                Addresses.AddressTransferInput(
+                    addressBytes: inputAddressData,
+                    amount: inputAmt,
+                    nonce: 0,
+                    privateKey: privateKeyData
+                )
+            ]
+            let outputs = [
+                Addresses.AddressTransferOutput(
+                    addressBytes: outputAddressData,
+                    amount: outputAmt
+                )
+            ]
+            let transferResult = try sdk.addresses.transferFunds(
+                inputs: inputs,
+                outputs: outputs,
+                feeFromInputIndex: 0
+            )
+            result = transferResult
+            showResult = true
+        } catch {
+            errorMessage = error.localizedDescription
+            showResult = true
+        }
+        isLoading = false
+    }
+}

packages/swift-sdk/SwiftExampleApp/SwiftExampleApp/ViewModels/BaseViewModel.swift

@@ -0,0 +1,24 @@
+import Foundation
+import SwiftUI
+
+/// Base ViewModel with common loading, error, and result state.
+/// Subclass for form/action ViewModels that need consistent UX.
+@MainActor
+class BaseViewModel: ObservableObject {
+
+    @Published var isLoading = false
+    @Published var errorMessage: String?
+    @Published var showResult = false
+
+    /// Set error message and show result section.
+    func handleError(_ error: Error) {
+        errorMessage = error.localizedDescription
+        showResult = true
+    }
+
+    /// Clear error and result visibility. Override to also clear form fields and result data.
+    func reset() {
+        errorMessage = nil
+        showResult = false
+    }
+}

packages/swift-sdk/SwiftExampleApp/SwiftExampleApp/ViewModels/GetAddressInfoViewModel.swift

@@ -0,0 +1,55 @@
+import Foundation
+import SwiftDashSDK
+import SwiftUI
+
+/// ViewModel for the Get Address Info query view.
+@MainActor
+final class GetAddressInfoViewModel: BaseViewModel {
+
+  @Published var addressInput = ""
+  @Published var result: PlatformAddressInfo?
+
+  static let testBech32m = "tdashevo1qqyfsqyzcn5hzu7echru54njypdq0v4d7gv8pkdf"
+  static let testAddressHex = "00" + "1234567890abcdef1234567890abcdef12345678"
+
+  var isFormValid: Bool { !addressInput.trimmingCharacters(in: .whitespacesAndNewlines).isEmpty }
+
+  var detectedFormat: (icon: String, color: Color, description: String) {
+    let trimmed = addressInput.trimmingCharacters(in: .whitespacesAndNewlines).lowercased()
+    if trimmed.hasPrefix("dashevo1") || trimmed.hasPrefix("tdashevo1") {
+      if Bech32m.isValidPlatformAddress(trimmed) {
+        return ("checkmark.circle.fill", .green, "Valid bech32m address")
+      } else {
+        return ("xmark.circle.fill", .red, "Invalid bech32m address")
+      }
+    } else if trimmed.count == 42 && trimmed.allSatisfy({ $0.isHexDigit }) {
+      return ("checkmark.circle.fill", .green, "Hex format (42 characters)")
+    } else if !trimmed.isEmpty {
+      return ("questionmark.circle", .orange, "Unknown format")
+    }
+    return ("circle", .gray, "")
+  }
+
+  override func reset() {
+    super.reset()
+    addressInput = ""
+    result = nil
+  }
+
+  func fetchAddressInfo(sdk: SDK) async {
+    isLoading = true
+    errorMessage = nil
+    result = nil
+    showResult = false
+
+    do {
+      let info = try sdk.addresses.getInfo(address: addressInput)
+      result = info
+      showResult = true
+    } catch {
+      errorMessage = error.localizedDescription
+      showResult = true
+    }
+    isLoading = false
+  }
+}

packages/swift-sdk/SwiftExampleApp/SwiftExampleApp/ViewModels/GetAddressesInfosViewModel.swift

@@ -0,0 +1,65 @@
+import Foundation
+import SwiftDashSDK
+import SwiftUI
+
+/// ViewModel for the Get Addresses Infos query view.
+@MainActor
+final class GetAddressesInfosViewModel: BaseViewModel {
+
+  @Published var addressesText = ""
+  @Published var result: PlatformAddressInfosResult?
+
+  static let testBech32mAddresses = """
+    tdashevo1qqyfsqyzcn5hzu7echru54njypdq0v4d7gv8pkdf
+    tdashevo1qq0rs5w7e3xv6ls3f7s4hz82e44p29e38fqlmhs
+    """
+
+  static let testHexAddresses = """
+    001234567890abcdef1234567890abcdef12345678
+    00abcdef1234567890abcdef1234567890abcdef12
+    """
+
+  var isFormValid: Bool {
+    !addressesText
+      .components(separatedBy: .newlines)
+      .map { $0.trimmingCharacters(in: .whitespaces) }
+      .filter { !$0.isEmpty }
+      .isEmpty
+  }
+
+  override func reset() {
+    super.reset()
+    addressesText = ""
+    result = nil
+  }
+
+  func fetchAddressesInfos(sdk: SDK) async {
+    isLoading = true
+    errorMessage = nil
+    result = nil
+    showResult = false
+
+    let addresses =
+      addressesText
+      .components(separatedBy: .newlines)
+      .map { $0.trimmingCharacters(in: .whitespaces) }
+      .filter { !$0.isEmpty }
+
+    guard !addresses.isEmpty else {
+      errorMessage = "No valid addresses entered"
+      showResult = true
+      isLoading = false
+      return
+    }
+
+    do {
+      let infosResult = try sdk.addresses.getInfos(addresses: addresses)
+      result = infosResult
+      showResult = true
+    } catch {
+      errorMessage = error.localizedDescription
+      showResult = true
+    }
+    isLoading = false
+  }
+}

packages/swift-sdk/SwiftExampleApp/SwiftExampleApp/ViewModels/TopUpAddressFromAssetLockViewModel.swift

@@ -0,0 +1,122 @@
+import Foundation
+import SwiftDashSDK
+import SwiftUI
+
+/// ViewModel for the Top Up Address From Asset Lock form.
+@MainActor
+final class TopUpAddressFromAssetLockViewModel: BaseViewModel {
+
+  @Published var proofType: Addresses.AssetLockProofType = .instant
+  @Published var outputAddressHex = ""
+  @Published var outputAmount = ""
+  @Published var assetLockPrivateKeyHex = ""
+  @Published var instantLockHex = ""
+  @Published var transactionHex = ""
+  @Published var outputIndex = "0"
+  @Published var coreChainLockedHeight = ""
+  @Published var outPointHex = ""
+  @Published var result: PlatformAddressInfosResult?
+
+  private var validationResult: ValidationResult {
+    let proof: AssetLockProofTypeForValidation = proofType == .instant ? .instant : .chain
+    return TopUpAddressFromAssetLockValidator.validate(
+      outputAddressHex: outputAddressHex,
+      assetLockPrivateKeyHex: assetLockPrivateKeyHex,
+      proofType: proof,
+      instantLockHex: instantLockHex,
+      transactionHex: transactionHex,
+      outputIndex: outputIndex,
+      coreChainLockedHeight: coreChainLockedHeight,
+      outPointHex: outPointHex
+    )
+  }
+
+  var isFormValid: Bool { validationResult.isValid }
+  var validationErrors: [String] { validationResult.errors }
+
+  override func reset() {
+    super.reset()
+    outputAddressHex = ""
+    outputAmount = ""
+    assetLockPrivateKeyHex = ""
+    instantLockHex = ""
+    transactionHex = ""
+    outputIndex = "0"
+    coreChainLockedHeight = ""
+    outPointHex = ""
+    result = nil
+  }
+
+  func executeTopUp(sdk: SDK) async {
+    guard let outputAddressData = Data(hexString: outputAddressHex),
+      let privateKeyData = Data(hexString: assetLockPrivateKeyHex)
+    else {
+      errorMessage = "Invalid input data"
+      showResult = true
+      return
+    }
+
+    let outputAmountValue = UInt64(outputAmount) ?? 0
+    isLoading = true
+    errorMessage = nil
+    result = nil
+    showResult = false
+
+    do {
+      let outputs = [
+        Addresses.AddressTransferOutput(
+          addressBytes: outputAddressData,
+          amount: outputAmountValue
+        )
+      ]
+
+      let topUpResult: PlatformAddressInfosResult
+      if proofType == .instant {
+        guard let instantLockData = Data(hexString: instantLockHex),
+          let transactionData = Data(hexString: transactionHex),
+          let outputIdx = UInt32(outputIndex)
+        else {
+          errorMessage = "Invalid instant lock data"
+          showResult = true
+          isLoading = false
+          return
+        }
+        topUpResult = try sdk.addresses.topUpAddressFromAssetLock(
+          proofType: .instant,
+          instantLockData: instantLockData,
+          transactionData: transactionData,
+          outputIndex: outputIdx,
+          coreChainLockedHeight: 0,
+          outPoint: nil,
+          assetLockPrivateKey: privateKeyData,
+          outputs: outputs
+        )
+      } else {
+        guard let outPointData = Data(hexString: outPointHex),
+          let height = UInt32(coreChainLockedHeight)
+        else {
+          errorMessage = "Invalid chain lock data"
+          showResult = true
+          isLoading = false
+          return
+        }
+        topUpResult = try sdk.addresses.topUpAddressFromAssetLock(
+          proofType: .chain,
+          instantLockData: nil,
+          transactionData: nil,
+          outputIndex: 0,
+          coreChainLockedHeight: height,
+          outPoint: outPointData,
+          assetLockPrivateKey: privateKeyData,
+          outputs: outputs
+        )
+      }
+      result = topUpResult
+      showResult = true
+    } catch {
+      errorMessage = error.localizedDescription
+      showResult = true
+    }
+    isLoading = false
+  }
+}