Updated on 2026-08-14

libs/tangem-sdk-api/.gitignore

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

libs/tangem-sdk-api/build.gradle.kts

@@ -0,0 +1,35 @@
+plugins {
+    alias(deps.plugins.android.library)
+    alias(deps.plugins.kotlin.android)
+    alias(deps.plugins.kotlin.kapt)
+    alias(deps.plugins.kotlin.serialization)
+    alias(deps.plugins.hilt.android)
+    id("configuration")
+}
+
+android {
+    namespace = "com.tangem.legacy"
+}
+
+dependencies {
+    implementation(projects.common)
+    implementation(projects.domain.models)
+    implementation(projects.domain.card)
+    implementation(projects.domain.legacy)
+    implementation(projects.domain.wallets.models)
+
+    implementation(projects.core.res)
+
+    /** Tangem libraries */
+    implementation(deps.tangem.card.core)
+    implementation(deps.tangem.card.android) {
+        exclude(module = "joda-time")
+    }
+
+    /** Other libraries */
+    implementation(deps.timber)
+
+    /** DI */
+    implementation(deps.hilt.android)
+    kapt(deps.hilt.kapt)
+}

libs/tangem-sdk-api/src/main/kotlin/com/tangem/sdk/api/CreateProductWalletTaskResponse.kt

@@ -0,0 +1,24 @@
+package com.tangem.sdk.api
+
+import com.tangem.common.card.Card
+import com.tangem.domain.models.scan.CardDTO
+import com.tangem.domain.models.scan.KeyWalletPublicKey
+import com.tangem.operations.CommandResponse
+import com.tangem.operations.backup.PrimaryCard
+import com.tangem.operations.derivation.ExtendedPublicKeysMap
+
+data class CreateProductWalletTaskResponse(
+    val card: CardDTO,
+    val derivedKeys: Map<KeyWalletPublicKey, ExtendedPublicKeysMap> = mapOf(),
+    val primaryCard: PrimaryCard? = null,
+) : CommandResponse {
+    constructor(
+        card: Card,
+        derivedKeys: Map<KeyWalletPublicKey, ExtendedPublicKeysMap> = mapOf(),
+        primaryCard: PrimaryCard? = null,
+    ) : this(
+        card = CardDTO(card),
+        derivedKeys = derivedKeys,
+        primaryCard = primaryCard,
+    )
+}

libs/tangem-sdk-api/src/main/kotlin/com/tangem/sdk/api/TangemSdkManager.kt

@@ -0,0 +1,144 @@
+package com.tangem.sdk.api
+
+import androidx.annotation.DrawableRes
+import androidx.annotation.StringRes
+import com.tangem.Message
+import com.tangem.common.CompletionResult
+import com.tangem.common.KeyPair
+import com.tangem.common.SuccessResponse
+import com.tangem.common.authentication.keystore.KeystoreManager
+import com.tangem.common.core.CardSessionRunnable
+import com.tangem.common.core.UserCodeRequestPolicy
+import com.tangem.common.extensions.ByteArrayKey
+import com.tangem.common.services.secure.SecureStorage
+import com.tangem.crypto.hdWallet.DerivationPath
+import com.tangem.crypto.hdWallet.bip32.ExtendedPublicKey
+import com.tangem.domain.models.scan.CardDTO
+import com.tangem.domain.models.scan.ScanResponse
+import com.tangem.domain.wallets.models.UserWalletId
+import com.tangem.operations.derivation.DerivationTaskResponse
+import com.tangem.operations.preflightread.PreflightReadFilter
+import com.tangem.operations.wallet.CreateWalletResponse
+
+@Suppress("TooManyFunctions")
+interface TangemSdkManager {
+
+    val canUseBiometry: Boolean
+
+    val needEnrollBiometrics: Boolean
+
+    val keystoreManager: KeystoreManager
+
+    val secureStorage: SecureStorage
+
+    val userCodeRequestPolicy: UserCodeRequestPolicy
+
+    suspend fun checkCanUseBiometry(awaitInitialization: Boolean = true): Boolean
+
+    suspend fun checkNeedEnrollBiometrics(awaitInitialization: Boolean = true): Boolean
+
+    suspend fun scanProduct(
+        cardId: String? = null,
+        messageRes: Int? = null,
+        allowsRequestAccessCodeFromRepository: Boolean = false,
+    ): CompletionResult<ScanResponse>
+
+    suspend fun createProductWallet(
+        scanResponse: ScanResponse,
+        shouldReset: Boolean = false,
+    ): CompletionResult<CreateProductWalletTaskResponse>
+
+    // Wallet2 specific
+    suspend fun importWallet(
+        scanResponse: ScanResponse,
+        mnemonic: String,
+        passphrase: String?,
+        shouldReset: Boolean,
+    ): CompletionResult<CreateProductWalletTaskResponse>
+
+    suspend fun derivePublicKeys(
+        cardId: String?,
+        derivations: Map<ByteArrayKey, List<DerivationPath>>,
+        preflightReadFilter: PreflightReadFilter?,
+    ): CompletionResult<DerivationTaskResponse>
+
+    suspend fun deriveExtendedPublicKey(
+        cardId: String?,
+        walletPublicKey: ByteArray,
+        derivation: DerivationPath,
+    ): CompletionResult<ExtendedPublicKey>
+
+    suspend fun resetToFactorySettings(
+        cardId: String,
+        allowsRequestAccessCodeFromRepository: Boolean,
+    ): CompletionResult<Boolean>
+
+    suspend fun resetBackupCard(cardNumber: Int, userWalletId: UserWalletId): CompletionResult<Boolean>
+
+    suspend fun saveAccessCode(accessCode: String, cardsIds: Set<String>): CompletionResult<Unit>
+
+    suspend fun deleteSavedUserCodes(cardsIds: Set<String>): CompletionResult<Unit>
+
+    suspend fun clearSavedUserCodes(): CompletionResult<Unit>
+
+    suspend fun setPasscode(cardId: String?): CompletionResult<SuccessResponse>
+
+    suspend fun setAccessCode(cardId: String?): CompletionResult<SuccessResponse>
+
+    suspend fun setLongTap(cardId: String?): CompletionResult<SuccessResponse>
+
+    suspend fun setAccessCodeRecoveryEnabled(cardId: String?, enabled: Boolean): CompletionResult<SuccessResponse>
+
+    suspend fun scanCard(
+        cardId: String? = null,
+        allowRequestAccessCodeFromRepository: Boolean = false,
+    ): CompletionResult<CardDTO>
+
+    @Deprecated(
+        "com.tangem.sdk.api.TangemSdkManager shouldn't run custom tasks. " +
+            "All of them should be specified in com.tangem.sdk.api.TangemSdkManager certain methods.",
+    )
+    suspend fun <T> runTaskAsync(
+        runnable: CardSessionRunnable<T>,
+        preflightReadFilter: PreflightReadFilter?,
+        cardId: String? = null,
+        initialMessage: Message? = null,
+        accessCode: String? = null,
+        @DrawableRes iconScanRes: Int? = null,
+    ): CompletionResult<T>
+
+    @Suppress("MagicNumber")
+    fun changeDisplayedCardIdNumbersCount(scanResponse: ScanResponse?)
+
+    @Deprecated("com.tangem.sdk.api.TangemSdkManager shouldn't returns a string from resources")
+    fun getString(@StringRes stringResId: Int, vararg formatArgs: Any?): String
+
+    fun setUserCodeRequestPolicy(policy: UserCodeRequestPolicy)
+
+    // region Twin-specific
+
+    suspend fun finalizeTwin(
+        secondCardPublicKey: ByteArray,
+        issuerKeyPair: KeyPair,
+        cardId: String,
+        initialMessage: Message,
+    ): CompletionResult<ScanResponse>
+
+    suspend fun createFirstTwinWallet(cardId: String, initialMessage: Message): CompletionResult<CreateWalletResponse>
+
+    @Suppress("LongParameterList")
+    suspend fun createSecondTwinWallet(
+        firstPublicKey: String,
+        firstCardId: String,
+        issuerKeys: KeyPair,
+        preparingMessage: Message,
+        creatingWalletMessage: Message,
+        initialMessage: Message,
+    ): CompletionResult<CreateWalletResponse>
+
+    fun changeProductType(isRing: Boolean)
+
+    fun clearProductType()
+
+    // endregion
+}

libs/tangem-sdk-api/src/main/kotlin/com/tangem/sdk/api/TapErrors.kt

@@ -0,0 +1,49 @@
+package com.tangem.sdk.api
+
+import androidx.annotation.StringRes
+import com.tangem.common.core.TangemError
+import com.tangem.legacy.R
+
+interface TapErrors
+
+interface ArgError {
+    val args: List<Any>?
+}
+
+interface MultiMessageError : TapErrors {
+    val errorList: List<TapError>
+    val builder: (List<String>) -> String
+}
+
+sealed class TapError(
+    @StringRes val messageResource: Int,
+    override val args: List<Any>? = null,
+) : Throwable(), TapErrors, ArgError {
+
+    object UnknownError : TapError(R.string.send_error_unknown)
+    open class CustomError(val customMessage: String) : TapError(R.string.common_custom_string, listOf(customMessage))
+
+    object NoInternetConnection : TapError(R.string.wallet_notification_no_internet)
+
+    sealed class WalletManager {
+        class NoAccountError(amountToCreateAccount: String) : CustomError(amountToCreateAccount)
+        class InternalError(message: String) : CustomError(message)
+        object BlockchainIsUnreachableTryLater : TapError(R.string.wallet_balance_blockchain_unreachable_try_later)
+    }
+}
+
+sealed class TapSdkError(override val messageResId: Int?) : TangemError(code = 50100) {
+    override var customMessage: String = code.toString()
+
+    object CardForDifferentApp : TapSdkError(R.string.alert_unsupported_card)
+    object CardNotSupportedByRelease : TapSdkError(R.string.error_wrong_card_type)
+}
+
+fun TapErrors.assembleErrors(): MutableList<Pair<Int, List<Any>?>> {
+    val idList = mutableListOf<Pair<Int, List<Any>?>>()
+    when (this) {
+        is MultiMessageError -> this.errorList.forEach { idList.addAll(it.assembleErrors()) }
+        is TapError -> idList.add(Pair(this.messageResource, this.args))
+    }
+    return idList
+}