Updated on 2026-08-14

app/build.gradle.kts

@@ -110,6 +110,7 @@ dependencies {
     implementation(project(":network"))
     implementation(project(":common"))
     implementation(project(":core:ui"))
+    implementation(project(":libs:crypto"))
 
     /** AndroidX libraries */
     implementation(AndroidX.coreKtx)

app/src/main/java/com/tangem/tap/proxy/DerivationManagerImpl.kt

@@ -0,0 +1,14 @@
+package com.tangem.tap.proxy
+
+import com.tangem.crypto.DerivationManager
+
+class DerivationManagerImpl : DerivationManager {
+
+    override fun deriveMissingBlockchains(networkId: String?) {
+        TODO("Not yet implemented")
+    }
+
+    override fun hasDerivation(): Boolean {
+        TODO("Not yet implemented")
+    }
+}

app/src/main/java/com/tangem/tap/proxy/UserWalletManagerImpl.kt

@@ -0,0 +1,27 @@
+package com.tangem.tap.proxy
+
+import com.tangem.crypto.UserWalletManager
+import com.tangem.crypto.models.Token
+
+class UserWalletManagerImpl : UserWalletManager {
+
+    override fun getUserTokens(): List<Token> {
+        TODO("Not yet implemented")
+    }
+
+    override fun getWalletId(): String {
+        TODO("Not yet implemented")
+    }
+
+    override fun isTokenAdded(token: Token): Boolean {
+        TODO("Not yet implemented")
+    }
+
+    override fun addToken(token: Token) {
+        TODO("Not yet implemented")
+    }
+
+    override fun getWalletAddress(token: Token): String {
+        TODO("Not yet implemented")
+    }
+}

core/datasource/src/main/java/com/tangem/datasource/api/referral/models/ReferralResponse.kt

@@ -26,7 +26,7 @@ data class Token(
     @Json(name = "symbol") val symbol: String,
     @Json(name = "networkId") val networkId: String?,
     @Json(name = "contractAddress") val contractAddress: String?,
-    @Json(name = "decimalCount") val decimalCount: Int,
+    @Json(name = "decimalCount") val decimalCount: Int?,
 )
 
 data class Referral(

features/referral/domain/build.gradle.kts

@@ -26,6 +26,10 @@ android {
 
 dependencies {
 
+    /** Libs */
+    implementation(project(":core:utils"))
+    implementation(project(":libs:crypto"))
+
     /** Time */
     implementation(Library.jodatime)
 

features/referral/domain/src/main/java/com/tangem/feature/referral/domain/ReferralInteractor.kt

@@ -0,0 +1,10 @@
+package com.tangem.feature.referral.domain
+
+import com.tangem.feature.referral.domain.models.ReferralData
+
+interface ReferralInteractor {
+
+    suspend fun getReferralStatus(): ReferralData
+
+    suspend fun startReferral(): ReferralData
+}

features/referral/domain/src/main/java/com/tangem/feature/referral/domain/ReferralInteractorImpl.kt

@@ -0,0 +1,54 @@
+package com.tangem.feature.referral.domain
+
+import com.tangem.crypto.DerivationManager
+import com.tangem.crypto.UserWalletManager
+import com.tangem.crypto.models.Token
+import com.tangem.feature.referral.domain.converter.TokensConverter
+import com.tangem.feature.referral.domain.models.ReferralData
+import com.tangem.feature.referral.domain.models.TokenData
+
+internal class ReferralInteractorImpl(
+    private val repository: ReferralRepository,
+    private val derivationManager: DerivationManager,
+    private val userWalletManager: UserWalletManager,
+    private val tokensConverter: TokensConverter,
+) : ReferralInteractor {
+
+    private val tokensForReferral = mutableListOf<TokenData>()
+
+    override suspend fun getReferralStatus(): ReferralData {
+        val refStatus = repository.getReferralStatus(userWalletManager.getWalletId())
+        saveRefTokens(refStatus.tokens)
+        return refStatus
+    }
+
+    override suspend fun startReferral(): ReferralData {
+        if (tokensForReferral.isNotEmpty()) {
+            val token = tokensConverter.convert(tokensForReferral.first())
+            deriveOrAddTokens(token)
+            val publicAddress = userWalletManager.getWalletAddress(token)
+            return repository.startReferral(
+                walletId = userWalletManager.getWalletId(),
+                networkId = token.networkId ?: "",
+                tokenId = token.id,
+                address = publicAddress,
+            )
+        } else {
+            throw IllegalStateException("tokens for ref is empty")
+        }
+    }
+
+    private fun deriveOrAddTokens(token: Token) {
+        if (!derivationManager.hasDerivation()) {
+            derivationManager.deriveMissingBlockchains(token.networkId)
+        }
+        if (!userWalletManager.isTokenAdded(token)) {
+            userWalletManager.addToken(token)
+        }
+    }
+
+    private fun saveRefTokens(tokens: List<TokenData>) {
+        tokensForReferral.clear()
+        tokensForReferral.addAll(tokens)
+    }
+}

features/referral/domain/src/main/java/com/tangem/feature/referral/domain/converter/TokensConverter.kt

@@ -0,0 +1,19 @@
+package com.tangem.feature.referral.domain.converter
+
+import com.tangem.crypto.models.Token
+import com.tangem.feature.referral.domain.models.TokenData
+import com.tangem.utils.converter.Converter
+
+class TokensConverter : Converter<TokenData, Token> {
+
+    override fun convert(value: TokenData): Token {
+        return Token(
+            id = value.id,
+            name = value.name,
+            symbol = value.symbol,
+            networkId = value.networkId,
+            contractAddress = value.contractAddress,
+            decimalCount = value.decimalCount,
+        )
+    }
+}

features/referral/domain/src/main/java/com/tangem/feature/referral/domain/models/ReferralData.kt

@@ -36,7 +36,7 @@ data class TokenData(
     val symbol: String,
     val networkId: String?,
     val contractAddress: String?,
-    val decimalCount: Int,
+    val decimalCount: Int?,
 )
 
 data class ReferralInfo(

libs/crypto/.gitignore

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

libs/crypto/build.gradle.kts

@@ -0,0 +1,29 @@
+plugins {
+    id("com.android.library")
+    kotlin("android")
+}
+
+android {
+
+    defaultConfig {
+        compileSdk = AppConfig.compileSdkVersion
+        minSdk = AppConfig.minSdkVersion
+        targetSdk = AppConfig.targetSdkVersion
+    }
+
+    kotlinOptions {
+        jvmTarget = JavaVersion.VERSION_1_8.toString()
+    }
+
+    compileOptions {
+        sourceCompatibility = JavaVersion.VERSION_1_8
+        targetCompatibility = JavaVersion.VERSION_1_8
+        isCoreLibraryDesugaringEnabled = false
+    }
+}
+
+dependencies {
+
+    /** Coroutines */
+    implementation(Library.coroutine)
+}

libs/crypto/src/main/AndroidManifest.xml

@@ -0,0 +1,2 @@
+<?xml version="1.0" encoding="utf-8"?>
+<manifest package="com.tangem.lib.crypto" />

libs/crypto/src/main/java/com/tangem/lib/crypto/DerivationManager.kt

@@ -0,0 +1,8 @@
+package com.tangem.crypto
+
+interface DerivationManager {
+
+    fun deriveMissingBlockchains(networkId: String?)
+
+    fun hasDerivation(): Boolean
+}

libs/crypto/src/main/java/com/tangem/lib/crypto/UserWalletManager.kt

@@ -0,0 +1,40 @@
+package com.tangem.crypto
+
+import com.tangem.crypto.models.Token
+
+/**
+ * Provider for user tokens data
+ */
+interface UserWalletManager {
+
+    /**
+     * Returns all user tokens (merged from local and backend)
+     */
+    fun getUserTokens(): List<Token>
+
+    /**
+     * Returns user walletId
+     */
+    fun getWalletId(): String
+
+    /**
+     * Checks that token added to user wallet
+     *
+     * @param token to receive referral payments
+     */
+    fun isTokenAdded(token: Token): Boolean
+
+    /**
+     * Adds token to wallet if its not
+     *
+     * @param token to add to wallet
+     */
+    fun addToken(token: Token)
+
+    /**
+     * Returns wallet public address for token
+     *
+     * @param token for which find address
+     */
+    fun getWalletAddress(token: Token): String
+}

libs/crypto/src/main/java/com/tangem/lib/crypto/models/Token.kt

@@ -0,0 +1,10 @@
+package com.tangem.crypto.models
+
+data class Token(
+    val id: String,
+    val name: String,
+    val symbol: String,
+    val networkId: String?,
+    val contractAddress: String?,
+    val decimalCount: Int?,
+)

settings.gradle.kts

@@ -9,6 +9,10 @@ include(":core:utils")
 include(":core:ui")
 // endregion Core modules
 
+// region Libs modules
+include(":libs:crypto")
+// endregion Libs modules
+
 // region Feature modules
 include(":features:referral:data")
 include(":features:referral:domain")