Updated on 2026-08-14

core/datasource/src/main/java/com/tangem/datasource/api/addressbook/AddressBookApi.kt

@@ -0,0 +1,25 @@
+package com.tangem.datasource.api.addressbook
+
+import com.tangem.datasource.api.addressbook.models.SyncAddressBooksRequest
+import com.tangem.datasource.api.addressbook.models.SyncAddressBooksResponse
+import com.tangem.datasource.api.addressbook.models.UpdateAddressBookRequest
+import com.tangem.datasource.api.addressbook.models.UpdateAddressBookResponse
+import com.tangem.datasource.api.common.response.ApiResponse
+import retrofit2.http.Body
+import retrofit2.http.Header
+import retrofit2.http.PUT
+import retrofit2.http.POST
+import retrofit2.http.Path
+
+interface AddressBookApi {
+
+    @POST("v1/address-books/sync")
+    suspend fun syncAddressBooks(@Body body: SyncAddressBooksRequest): ApiResponse<SyncAddressBooksResponse>
+
+    @PUT("v1/address-books/{walletId}")
+    suspend fun updateAddressBook(
+        @Path("walletId") walletId: String,
+        @Header("If-Match") eTag: String?,
+        @Body body: UpdateAddressBookRequest,
+    ): ApiResponse<UpdateAddressBookResponse>
+}

core/datasource/src/main/java/com/tangem/datasource/api/addressbook/models/SyncAddressBooksRequest.kt

@@ -0,0 +1,22 @@
+package com.tangem.datasource.api.addressbook.models
+
+import com.squareup.moshi.Json
+import com.squareup.moshi.JsonClass
+
+/**
+ * Request body for `POST /address-books/sync`.
+ *
+ * Each [Wallet.etag] is optional: when it matches the backend's etag, that wallet is omitted from the
+ * response and the local copy is kept.
+ */
+@JsonClass(generateAdapter = true)
+data class SyncAddressBooksRequest(
+    @Json(name = "wallets") val wallets: List<Wallet>,
+) {
+
+    @JsonClass(generateAdapter = true)
+    data class Wallet(
+        @Json(name = "walletId") val walletId: String,
+        @Json(name = "etag") val etag: String? = null,
+    )
+}

core/datasource/src/main/java/com/tangem/datasource/api/addressbook/models/SyncAddressBooksResponse.kt

@@ -0,0 +1,27 @@
+package com.tangem.datasource.api.addressbook.models
+
+import com.squareup.moshi.Json
+import com.squareup.moshi.JsonClass
+
+/**
+ * Response body for `POST /address-books/sync`.
+ *
+ * [items] contains only the wallets whose backend etag differs from the one sent in the request; wallets
+ * with a matching etag are omitted and their local copy must be kept.
+ */
+@JsonClass(generateAdapter = true)
+data class SyncAddressBooksResponse(
+    @Json(name = "items") val items: List<Item>,
+) {
+
+    @JsonClass(generateAdapter = true)
+    data class Item(
+        @Json(name = "walletId") val walletId: String,
+        @Json(name = "etag") val etag: String,
+        @Json(name = "version") val version: String,
+        @Json(name = "updatedAt") val updatedAt: String,
+        @Json(name = "nonce") val nonce: String,
+        @Json(name = "ciphertext") val ciphertext: String,
+        @Json(name = "authTag") val authTag: String,
+    )
+}

core/datasource/src/main/java/com/tangem/datasource/api/addressbook/models/UpdateAddressBookRequest.kt

@@ -0,0 +1,13 @@
+package com.tangem.datasource.api.addressbook.models
+
+import com.squareup.moshi.Json
+import com.squareup.moshi.JsonClass
+
+/** Request body for `PUT /address-books/{walletId}`. */
+@JsonClass(generateAdapter = true)
+data class UpdateAddressBookRequest(
+    @Json(name = "version") val version: String,
+    @Json(name = "nonce") val nonce: String,
+    @Json(name = "ciphertext") val ciphertext: String,
+    @Json(name = "authTag") val authTag: String,
+)

core/datasource/src/main/java/com/tangem/datasource/api/addressbook/models/UpdateAddressBookResponse.kt

@@ -0,0 +1,12 @@
+package com.tangem.datasource.api.addressbook.models
+
+import com.squareup.moshi.Json
+import com.squareup.moshi.JsonClass
+
+/** Response body for `PUT /address-books/{walletId}`. */
+@JsonClass(generateAdapter = true)
+data class UpdateAddressBookResponse(
+    @Json(name = "walletId") val walletId: String,
+    @Json(name = "etag") val etag: String,
+    @Json(name = "updatedAt") val updatedAt: String,
+)

core/datasource/src/main/java/com/tangem/datasource/di/NetworkModule.kt

@@ -1,6 +1,7 @@
 package com.tangem.datasource.di
 
 import com.tangem.datasource.BuildConfig
+import com.tangem.datasource.api.addressbook.AddressBookApi
 import com.tangem.datasource.api.auth.AuthApi
 import com.tangem.datasource.api.common.blockaid.BlockAidApi
 import com.tangem.datasource.api.surveysparrow.SurveySparrowApi
@@ -118,6 +119,16 @@ internal object NetworkModule {
         )
     }
 
+    @Provides
+    @Singleton
+    fun provideAddressBookApi(retrofitApiBuilder: RetrofitApiBuilder): AddressBookApi {
+        return retrofitApiBuilder.build(
+            apiConfigId = ApiConfig.ID.TangemTech,
+            applyTimeoutAnnotations = false,
+            sessionAuth = false,
+        )
+    }
+
     @Provides
     @Singleton
     fun provideYieldSupplyApi(retrofitApiBuilder: RetrofitApiBuilder): YieldSupplyApi {