Updated on 2026-08-14

app/src/main/java/com/tangem/tap/domain/model/TotalFiatBalance.kt

@@ -0,0 +1,25 @@
+package com.tangem.tap.domain.model
+
+import java.math.BigDecimal
+
+/**
+ * Represents fiat balance of [WalletStoreModel] list
+ * @property amount Amount of the total balance
+ * */
+sealed class TotalFiatBalance {
+    open val amount: BigDecimal = BigDecimal.ZERO
+
+    object Loading : TotalFiatBalance()
+
+    class Refreshing(
+        override val amount: BigDecimal,
+    ) : TotalFiatBalance()
+
+    class Error(
+        override val amount: BigDecimal,
+    ) : TotalFiatBalance()
+
+    class Loaded(
+        override val amount: BigDecimal,
+    ) : TotalFiatBalance()
+}

app/src/main/java/com/tangem/tap/domain/model/UserWallet.kt

@@ -2,9 +2,17 @@ package com.tangem.tap.domain.model
 
 import com.tangem.domain.common.ScanResponse
 import com.tangem.domain.common.util.UserWalletId
-import com.tangem.domain.common.util.userWalletId
-import com.tangem.tap.domain.extensions.getOrLoadCardArtworkUrl
 
+/**
+ * Represents user's wallet which stored in app persistence
+ * @param name User's wallet name
+ * @param walletId User's wallet [UserWalletId]
+ * @param artworkUrl User wallet card artwork URL
+ * @param cardsInWallet List of cards IDs assigned with this user's wallet
+ * @param scanResponse [ScanResponse] of primary user's wallet card.
+ * TODO: Replace with [com.tangem.domain.common.CardDTO]
+ * @property cardId ID of user's wallet primary card
+ * */
 data class UserWallet(
     val name: String,
     val walletId: UserWalletId,
@@ -14,24 +22,4 @@ data class UserWallet(
 ) {
     val cardId: String
         get() = scanResponse.card.cardId
-
-    val hasAccessCode: Boolean
-        get() = scanResponse.card.isAccessCodeSet
-
-    companion object {
-        suspend operator fun invoke(
-            scanResponse: ScanResponse,
-            backupCardsIds: Set<String>? = null,
-        ): UserWallet {
-            return with(scanResponse) {
-                UserWallet(
-                    walletId = card.userWalletId,
-                    name = productType.name,
-                    artworkUrl = card.getOrLoadCardArtworkUrl(),
-                    cardsInWallet = backupCardsIds?.plus(card.cardId) ?: setOf(card.cardId),
-                    scanResponse = this,
-                )
-            }
-        }
-    }
 }

app/src/main/java/com/tangem/tap/domain/model/WalletDataModel.kt

@@ -0,0 +1,79 @@
+package com.tangem.tap.domain.model
+
+import com.tangem.tap.domain.model.WalletDataModel.Status
+import com.tangem.tap.features.wallet.models.Currency
+import com.tangem.tap.features.wallet.models.PendingTransaction
+import com.tangem.tap.features.wallet.redux.AddressData
+import java.math.BigDecimal
+
+/**
+ * Contains info about wallet store currency
+ * @param currency Wallet's [Currency]
+ * @param status Wallet's [Status], represents current status of that currency
+ * @param walletAddresses List of wallet data [AddressData]
+ * @param existentialDeposit Amount that must be held on currency's balance, if balance is below that amount all
+ * founds will be destroyed. Null if currency don't have existential deposit
+ * @param fiatRate Wallet's fiat rate, used to calculate fiat balance. Null if not provided
+ * */
+data class WalletDataModel(
+    val currency: Currency,
+    val status: Status,
+    val walletAddresses: List<AddressData>,
+    val existentialDeposit: BigDecimal?,
+    val fiatRate: BigDecimal?,
+) {
+
+    /**
+     * Represent current status of currency
+     * @property amount Currency amount
+     * @property pendingTransactions List of currency [PendingTransaction] sent in currency's blockchain
+     * @property errorMessage Status error message, null if not provided
+     * @property isErrorStatus true if current status is error status, false otherwise
+     * */
+    sealed class Status {
+        open val amount: BigDecimal = BigDecimal.ZERO
+        open val pendingTransactions: List<PendingTransaction> = emptyList()
+        open val errorMessage: String? = null
+        open val isErrorStatus: Boolean = false
+    }
+
+    object Loading : Status()
+
+    data class VerifiedOnline(
+        override val amount: BigDecimal,
+    ) : Status()
+
+    data class TransactionInProgress(
+        override val amount: BigDecimal,
+        override val pendingTransactions: List<PendingTransaction>,
+    ) : Status()
+
+    data class SameCurrencyTransactionInProgress(
+        override val amount: BigDecimal,
+        override val pendingTransactions: List<PendingTransaction>,
+    ) : Status()
+
+    data class NoAccount(
+        val amountToCreateAccount: BigDecimal?,
+    ) : Status() {
+        override val isErrorStatus: Boolean = true
+    }
+
+    data class Unreachable(
+        override val errorMessage: String?,
+    ) : Status() {
+        override val isErrorStatus: Boolean = true
+    }
+
+    object MissedDerivation : Status() {
+        override val isErrorStatus: Boolean = true
+    }
+
+    data class Refreshing(
+        override val amount: BigDecimal,
+        override val pendingTransactions: List<PendingTransaction>,
+        override val errorMessage: String?,
+    ) : Status() {
+        override val isErrorStatus: Boolean = errorMessage != null
+    }
+}

app/src/main/java/com/tangem/tap/domain/model/WalletStoreModel.kt

@@ -0,0 +1,36 @@
+package com.tangem.tap.domain.model
+
+import com.tangem.blockchain.common.WalletManager
+import com.tangem.domain.common.util.UserWalletId
+import com.tangem.tap.domain.model.WalletStoreModel.WalletRent
+import com.tangem.tap.domain.tokens.models.BlockchainNetwork
+import java.math.BigDecimal
+
+/**
+ * Contains info about the blockchain and its currencies
+ * @param userWalletId ID of the [UserWallet] which uses that store
+ * @param blockchainNetwork Store's [BlockchainNetwork]
+ * @param walletManager Store's [WalletManager], may be null if it fails to create this manager
+ * @param walletsData List of [WalletDataModel] which represents store's blockchain currency and tokens currencies
+ * @param walletRent Store's [WalletRent], null if store has no rent or currency balance is greater then
+ * [WalletRent.exemptionAmount]
+ * */
+data class WalletStoreModel(
+    val userWalletId: UserWalletId,
+    val blockchainNetwork: BlockchainNetwork,
+    val walletManager: WalletManager?,
+    val walletsData: List<WalletDataModel>,
+    val walletRent: WalletRent?,
+) {
+
+    /**
+     * Represents wallet blockchain rent
+     * @param rent Amount that will be charged in overtime if the blockchain does not have an amount greater than
+     * the [WalletRent.exemptionAmount]
+     * @param exemptionAmount Amount that should be on the blockchain balance not to pay rent
+     * */
+    data class WalletRent(
+        val rent: BigDecimal,
+        val exemptionAmount: BigDecimal,
+    )
+}

app/src/main/java/com/tangem/tap/domain/model/builders/UserWalletBuilder.kt

@@ -0,0 +1,30 @@
+package com.tangem.tap.domain.model.builders
+
+import com.tangem.domain.common.ScanResponse
+import com.tangem.domain.common.util.userWalletId
+import com.tangem.tap.domain.extensions.getOrLoadCardArtworkUrl
+import com.tangem.tap.domain.model.UserWallet
+
+class UserWalletBuilder(
+    private val scanResponse: ScanResponse,
+) {
+    private var backupCardsIds: Set<String> = emptySet()
+
+    fun setBackupCardsIds(backupCardsIds: Set<String>?) = this.apply {
+        if (backupCardsIds != null) {
+            this.backupCardsIds = backupCardsIds
+        }
+    }
+
+    suspend fun build(): UserWallet {
+        return with(scanResponse) {
+            UserWallet(
+                walletId = card.userWalletId,
+                name = productType.name,
+                artworkUrl = card.getOrLoadCardArtworkUrl(),
+                cardsInWallet = backupCardsIds.plus(card.cardId),
+                scanResponse = this,
+            )
+        }
+    }
+}