Updated on 2026-08-14

domain/wallet-manager/.gitignore

@@ -0,0 +1 @@
+/build

domain/wallet-manager/build.gradle.kts

@@ -0,0 +1,44 @@
+plugins {
+    alias(deps.plugins.android.library)
+    alias(deps.plugins.kotlin.android)
+    alias(deps.plugins.ksp)
+    id("configuration")
+}
+
+android {
+    namespace = "com.tangem.domain.walletmanager"
+}
+
+dependencies {
+    /** Domain models */
+    api(projects.domain.walletManager.models)
+
+    /** Project - Domain */
+    implementation(projects.core.utils)
+    implementation(projects.core.error)
+    api(projects.domain.models)
+    implementation(projects.domain.core)
+    implementation(projects.domain.demo.models)
+    implementation(projects.domain.wallets.models)
+    implementation(projects.domain.tokens.models)
+    implementation(projects.domain.appCurrency.models)
+    implementation(projects.domain.transaction.models)
+    implementation(projects.domain.txhistory.models)
+
+    /** Tangem libs */
+    implementation(tangemDeps.card.core)
+
+    /** Libs - Other */
+    implementation(projects.libs.blockchainSdk)
+    implementation(tangemDeps.blockchain)
+    implementation(deps.moshi)
+    implementation(deps.moshi.kotlin)
+    ksp(deps.moshi.kotlin.codegen)
+
+    /** Testing libraries */
+    testImplementation(deps.test.junit5)
+    testRuntimeOnly(deps.test.junit5.engine)
+    testImplementation(deps.test.mockk)
+    testImplementation(deps.test.truth)
+    testImplementation(projects.common.test)
+}

domain/wallet-manager/models/.gitignore

@@ -0,0 +1 @@
+/build

domain/wallet-manager/models/build.gradle.kts

@@ -0,0 +1,17 @@
+plugins {
+    alias(deps.plugins.kotlin.jvm)
+    alias(deps.plugins.kotlin.serialization)
+    alias(deps.plugins.ksp)
+    id("configuration")
+}
+
+dependencies {
+    implementation(projects.domain.models)
+
+    implementation(deps.moshi.kotlin)
+    ksp(deps.moshi.kotlin.codegen)
+    implementation(deps.moshi.adapters)
+    implementation(deps.kotlin.serialization)
+    implementation(deps.jodatime)
+    implementation(projects.core.error)
+}

domain/wallet-manager/models/src/main/kotlin/com/tangem/domain/walletmanager/model/RentData.kt

@@ -0,0 +1,11 @@
+package com.tangem.domain.walletmanager.model
+
+import java.math.BigDecimal
+
+/**
+ * Represents wallet blockchain rent
+ * @param rent Amount that will be charged in overtime if the blockchain does not have an amount greater than
+ * the [exemptionAmount]
+ * @param exemptionAmount Amount that should be on the blockchain balance not to pay rent
+ */
+data class RentData(val rent: BigDecimal, val exemptionAmount: BigDecimal)

domain/wallet-manager/models/src/main/kotlin/com/tangem/domain/walletmanager/model/SmartContractMethod.kt

@@ -0,0 +1,11 @@
+package com.tangem.domain.walletmanager.model
+
+import com.squareup.moshi.Json
+import com.squareup.moshi.JsonClass
+
+@JsonClass(generateAdapter = true)
+data class SmartContractMethod(
+    @Json(name = "info") val info: String?,
+    @Json(name = "source") val source: String?,
+    @Json(name = "name") val name: String,
+)

domain/wallet-manager/models/src/main/kotlin/com/tangem/domain/walletmanager/model/TokenInfo.kt

@@ -0,0 +1,12 @@
+package com.tangem.domain.walletmanager.model
+
+import com.tangem.domain.models.network.Network
+
+data class TokenInfo(
+    val network: Network,
+    val name: String,
+    val symbol: String,
+    val contractAddress: String,
+    val decimals: Int,
+    val id: String? = null,
+)

domain/wallet-manager/src/main/kotlin/com/tangem/domain/walletmanager/WalletManagersFacade.kt

@@ -0,0 +1,282 @@
+package com.tangem.domain.walletmanager
+
+import arrow.core.Either
+import com.tangem.blockchain.blockchains.solana.RentProvider
+import com.tangem.blockchain.common.*
+import com.tangem.blockchain.common.address.Address
+import com.tangem.blockchain.common.address.AddressType
+import com.tangem.blockchain.common.pagination.Page
+import com.tangem.blockchain.common.transaction.Fee
+import com.tangem.blockchain.common.transaction.TransactionFee
+import com.tangem.blockchain.extensions.Result
+import com.tangem.blockchain.extensions.SimpleResult
+import com.tangem.blockchain.nft.models.NFTAsset
+import com.tangem.blockchain.nft.models.NFTCollection
+import com.tangem.blockchainsdk.models.UpdateWalletManagerResult
+import com.tangem.domain.models.currency.CryptoCurrency
+import com.tangem.domain.models.network.Network
+import com.tangem.domain.models.network.TxInfo
+import com.tangem.domain.models.wallet.UserWalletId
+import com.tangem.domain.transaction.models.AssetRequirementsCondition
+import com.tangem.domain.txhistory.models.PaginationWrapper
+import com.tangem.domain.txhistory.models.TxHistoryState
+import com.tangem.domain.walletmanager.model.RentData
+import com.tangem.domain.walletmanager.model.TokenInfo
+import kotlinx.coroutines.flow.Flow
+import java.math.BigDecimal
+import java.util.EnumSet
+
+/**
+ * A facade for managing wallets.
+ */
+@Suppress("TooManyFunctions")
+interface WalletManagersFacade {
+
+    /**
+     * Updates the wallet manager associated with a user's wallet and network.
+     *
+     * @param userWalletId The ID of the user's wallet.
+     * @param network The network.
+     * @param extraTokens Additional tokens.
+     * @return The result of updating the wallet manager.
+     */
+    suspend fun update(
+        userWalletId: UserWalletId,
+        network: Network,
+        extraTokens: Set<CryptoCurrency.Token>,
+    ): UpdateWalletManagerResult
+
+    /**
+     * Removes the wallet managers associated with a user's wallet and networks.
+     *
+     * @param userWalletId The ID of the user's wallet.
+     * @param networks Set of networks
+     * */
+    suspend fun remove(userWalletId: UserWalletId, networks: Set<Network>)
+
+    suspend fun removeTokens(userWalletId: UserWalletId, tokens: Set<CryptoCurrency.Token>)
+
+    suspend fun removeTokensByTokenInfo(userWalletId: UserWalletId, tokenInfos: Set<TokenInfo>)
+
+    /**
+     * Returns [UpdateWalletManagerResult] with last pending transactions
+     *
+     * @param userWalletId The ID of the user's wallet.
+     * @param network The network.
+     * @return The result of updating the wallet manager.
+     */
+    suspend fun updatePendingTransactions(userWalletId: UserWalletId, network: Network): UpdateWalletManagerResult
+
+    /**
+     * Returns network explorer URL of the wallet manager associated with a user's wallet and network.
+     *
+     * @param userWalletId The ID of the user's wallet.
+     * @param network The network.
+     * @param addressType Address type.
+     * @param contractAddress Contract address if currency is Token.
+     *
+     * @return The network explorer URL, maybe empty if the wallet manager was not found.
+     * */
+    suspend fun getExploreUrl(
+        userWalletId: UserWalletId,
+        network: Network,
+        addressType: AddressType,
+        contractAddress: String?,
+    ): String
+
+    /**
+     * Returns transactions count
+     *
+     * @param userWalletId The ID of the user's wallet.
+     * @param currency currency.
+     */
+    suspend fun getTxHistoryState(userWalletId: UserWalletId, currency: CryptoCurrency): TxHistoryState
+
+    /**
+     * Returns transaction history items wrapped to pagination
+     *
+     * @param userWalletId The ID of the user's wallet.
+     * @param currency currency.
+     * @param page Pagination page.
+     * @param pageSize Pagination size.
+     */
+    suspend fun getTxHistoryItems(
+        userWalletId: UserWalletId,
+        currency: CryptoCurrency,
+        page: Page,
+        pageSize: Int,
+    ): PaginationWrapper<TxInfo>
+
+    @Deprecated("Will be removed in future")
+    suspend fun getOrCreateWalletManager(
+        userWalletId: UserWalletId,
+        blockchain: Blockchain,
+        derivationPath: String?,
+    ): WalletManager?
+
+    @Deprecated("Will be removed in future")
+    suspend fun getOrCreateWalletManager(userWalletId: UserWalletId, network: Network): WalletManager?
+
+    @Deprecated("Will be removed in future")
+    suspend fun getStoredWalletManagers(userWalletId: UserWalletId): List<WalletManager>
+
+    /**
+     * Returns default network address for selected wallet in given network
+     *
+     * @param userWalletId selected wallet id
+     * @param network network of currency
+     */
+    suspend fun getDefaultAddress(userWalletId: UserWalletId, network: Network): String?
+
+    /** Returns list of all addresses for all currencies in selected wallet
+     *
+     * @param userWalletId selected wallet id
+     * @param network required to create wallet manager
+     */
+    suspend fun getAddresses(userWalletId: UserWalletId, network: Network): Set<Address>
+
+    /**
+     * Returns info about rent if wallet manager implemented [RentProvider], otherwise null
+     *
+     * @param userWalletId selected wallet id
+     * @param network network of currency
+     */
+    suspend fun getRentInfo(userWalletId: UserWalletId, network: Network): RentData?
+
+    @Deprecated("Will be removed in future")
+    fun getAll(userWalletId: UserWalletId): Flow<List<WalletManager>>
+
+    suspend fun validateSignatureCount(
+        userWalletId: UserWalletId,
+        network: Network,
+        signedHashes: Int,
+    ): Either<Throwable, Unit>
+
+    /**
+     * Returns fee for transaction
+     *
+     * @param amount of transaction
+     * @param destination address
+     * @param userWalletId selected wallet id
+     * @param network network of currency
+     */
+    @Deprecated("Will be removed in future")
+    suspend fun getFee(
+        amount: Amount,
+        destination: String,
+        userWalletId: UserWalletId,
+        network: Network,
+    ): Result<TransactionFee>?
+
+    /**
+     * Returns estimated fee for transaction
+     *
+     * @param amount of transaction
+     * @param userWalletId selected wallet id
+     * @param network network of currency
+     */
+    suspend fun estimateFee(amount: Amount, userWalletId: UserWalletId, network: Network): Result<TransactionFee>?
+
+    /**
+     * Validates transaction
+     *
+     * @param amount of transaction
+     * @param fee of transaction
+     * @param userWalletId selected wallet id
+     * @param network network of currency
+     */
+    @Deprecated("Will be removed in future")
+    suspend fun validateTransaction(
+        amount: Amount,
+        fee: Amount?,
+        userWalletId: UserWalletId,
+        network: Network,
+    ): EnumSet<TransactionError>?
+
+    /**
+     * Creates transaction [TransactionData]
+     *
+     * @param amount of transaction
+     * @param fee of transaction
+     * @param memo of transaction optional
+     * @param destination address
+     * @param userWalletId selected wallet id
+     * @param network network of currency
+     */
+    @Suppress("LongParameterList")
+    @Deprecated("Will be removed in future")
+    suspend fun createTransaction(
+        amount: Amount,
+        fee: Fee,
+        memo: String?,
+        destination: String,
+        userWalletId: UserWalletId,
+        network: Network,
+    ): TransactionData?
+
+    /** Get recent transactions of [userWalletId] for [currency] */
+    suspend fun getRecentTransactions(userWalletId: UserWalletId, currency: CryptoCurrency): List<TxInfo>
+
+    @Suppress("LongParameterList")
+    suspend fun tokenBalance(
+        userWalletId: UserWalletId,
+        network: Network,
+        name: String,
+        symbol: String,
+        contractAddress: String,
+        decimals: Int,
+        id: String? = null,
+    ): BigDecimal
+
+    /**
+     * Get requirements for asset(currency)
+     * @return null if there's no requirement, otherwise [AssetRequirementsCondition].
+     */
+    suspend fun getAssetRequirements(userWalletId: UserWalletId, currency: CryptoCurrency): AssetRequirementsCondition?
+
+    suspend fun fulfillRequirements(
+        userWalletId: UserWalletId,
+        currency: CryptoCurrency,
+        signer: TransactionSigner,
+    ): SimpleResult
+
+    suspend fun discardRequirements(userWalletId: UserWalletId, currency: CryptoCurrency): SimpleResult
+
+    /**
+     * Indicates UTXO consolidation availability
+     *
+     * @param userWalletId selected user wallet
+     * @param network availability for network
+     */
+    suspend fun checkUtxoConsolidationAvailability(userWalletId: UserWalletId, network: Network): Boolean
+
+    suspend fun getNFTCollections(userWalletId: UserWalletId, network: Network): List<NFTCollection>
+
+    suspend fun getNFTAssets(
+        userWalletId: UserWalletId,
+        network: Network,
+        collectionIdentifier: NFTCollection.Identifier,
+    ): List<NFTAsset>
+
+    suspend fun getNFTAsset(
+        userWalletId: UserWalletId,
+        network: Network,
+        collectionIdentifier: NFTCollection.Identifier,
+        assetIdentifier: NFTAsset.Identifier,
+    ): NFTAsset?
+
+    suspend fun getNFTSalePrice(
+        userWalletId: UserWalletId,
+        network: Network,
+        collectionIdentifier: NFTCollection.Identifier,
+        assetIdentifier: NFTAsset.Identifier,
+    ): NFTAsset.SalePrice?
+
+    suspend fun getNFTExploreUrl(network: Network, assetIdentifier: NFTAsset.Identifier): String?
+
+    /**
+     * If wallet manager implements [InitializableAccount] then returns [InitializableAccount.isAccountInitialized]
+     * value. Otherwise always return true
+     */
+    suspend fun isAccountInitialized(userWalletId: UserWalletId, network: Network): Boolean
+}

domain/wallet-manager/src/main/kotlin/com/tangem/domain/walletmanager/utils/SdkPageConverter.kt

@@ -0,0 +1,23 @@
+package com.tangem.domain.walletmanager.utils
+
+import com.tangem.domain.txhistory.models.Page
+import com.tangem.utils.converter.TwoWayConverter
+import com.tangem.blockchain.common.pagination.Page as SdkPage
+
+class SdkPageConverter : TwoWayConverter<SdkPage, Page> {
+    override fun convert(value: SdkPage): Page {
+        return when (value) {
+            is SdkPage.Initial -> Page.Initial
+            is SdkPage.LastPage -> Page.LastPage
+            is SdkPage.Next -> Page.Next(value = value.value)
+        }
+    }
+
+    override fun convertBack(value: Page): SdkPage {
+        return when (value) {
+            is Page.Initial -> SdkPage.Initial
+            is Page.LastPage -> SdkPage.LastPage
+            is Page.Next -> SdkPage.Next(value = value.value)
+        }
+    }
+}