Updated on 2026-08-14

domain/common/src/main/java/com/tangem/domain/common/tokens/CardCryptoCurrencyFactory.kt

@@ -0,0 +1,78 @@
+package com.tangem.domain.common.tokens
+
+import com.tangem.domain.models.currency.CryptoCurrency
+import com.tangem.domain.models.network.Network
+import com.tangem.domain.models.wallet.UserWallet
+import com.tangem.domain.models.wallet.UserWalletId
+
+/**
+ * Factory for creating list of [CryptoCurrency] for selected card
+ *
+[REDACTED_AUTHOR]
+ */
+interface CardCryptoCurrencyFactory {
+
+    /**
+     * Universal method for creating list of [CryptoCurrency] in [network] for any card
+     *
+     * @param userWalletId user wallet id that determines type of card
+     * @param network      network
+     */
+    @Throws
+    suspend fun create(userWalletId: UserWalletId, network: Network): List<CryptoCurrency> {
+        return create(userWalletId = userWalletId, networks = setOf(network))[network].orEmpty()
+    }
+
+    /**
+     * Universal method for creating list of [CryptoCurrency] in [networks] for any card
+     *
+     * @param userWalletId user wallet id that determines type of card
+     * @param networks     networks
+     */
+    @Throws
+    suspend fun create(userWalletId: UserWalletId, networks: Set<Network>): Map<Network, List<CryptoCurrency>>
+
+    /**
+     * Universal method for creating list of [CryptoCurrency] in [network] for any card
+     *
+     * @param userWalletId user wallet id that determines type of card
+     * @param network      network
+     */
+    @Throws
+    suspend fun createByRawId(userWalletId: UserWalletId, network: Network.RawID): List<CryptoCurrency>
+
+    /**
+     * Create currencies for multi currency card
+     *
+     * @param userWallet user wallet
+     * @param networks   networks
+     */
+    @Throws
+    suspend fun createCurrenciesForMultiCurrencyCard(
+        userWallet: UserWallet,
+        networks: Set<Network>,
+    ): Map<Network, List<CryptoCurrency>>
+
+    /**
+     * Create default coins for multi currency card
+     *
+     * @param userWallet user wallet
+     */
+    fun createDefaultCoinsForMultiCurrencyWallet(userWallet: UserWallet): List<CryptoCurrency.Coin>
+
+    /**
+     * Create primary currency for single currency card
+     *
+     * @param userWallet user wallet
+     */
+    @Throws
+    fun createPrimaryCurrencyForSingleCurrencyCard(userWallet: UserWallet.Cold): CryptoCurrency
+
+    /**
+     * Create currencies for single currency card with token (like, NODL)
+     *
+     * @param userWallet user wallet
+     */
+    @Throws
+    fun createCurrenciesForSingleCurrencyCardWithToken(userWallet: UserWallet.Cold): List<CryptoCurrency>
+}