feat: home screen hardware wallet ui

.agents/commands/pr.md

@@ -136,7 +136,8 @@ When the user provides custom instructions after `--`:
   #### Automated Checks
   ```
 - Keep local verification commands, Gradle tasks, detekt, lint, unit tests, build passes, cargo test, cargo clippy, npm test, typecheck, CI coverage, or similar automated checks out of `#### Manual Tests`; summarize them under `#### Automated Checks` when they add useful context.
-- Use `#### Automated Checks` to summarize automated verification evidence, prioritizing coverage added, modified, or removed with file paths and a short explanation.
+- Use `#### Automated Checks` to summarize automated verification evidence, prioritizing coverage added, modified, or removed, each with the test file name and a short explanation.
+- Reference test files by bare file name only (e.g. `HwWalletRepoTest.kt`), never the full path. Only when two referenced test files share the same name, prefix the shortest leading path segment(s) that disambiguate them (e.g. `repositories/FooTest.kt` vs `viewmodels/FooTest.kt`).
 - For removed automated coverage, state why it was removed.
 - Do not list standard CI or PR bot commands as checkbox items just because they run for every PR. If standard CI coverage is worth mentioning, summarize it in one sentence.
 - List raw commands only when they were run locally, are non-standard, use special flags or environment values, validate workflow behavior, or explain a meaningful verification gap.
@@ -184,9 +185,9 @@ Concrete style target:
   - [ ] **5b.** back: returns to Connections List.
 - [ ] **6.** `regression:` Channel Detail → tap Close Connection: works.
 #### Automated Checks
-- Unit tests added: cover invoice timeout handling in `app/src/test/.../SendInvoiceTest.kt`.
-- Unit tests modified: update channel navigation assertions in `app/src/test/.../ChannelDetailTest.kt`.
-- Test coverage removed: delete stale mock-only assertions from `app/src/test/.../OldFlowTest.kt` because the flow no longer exists.
+- Unit tests added: cover invoice timeout handling in `SendInvoiceTest.kt`.
+- Unit tests modified: update channel navigation assertions in `ChannelDetailTest.kt`.
+- Test coverage removed: delete stale mock-only assertions from `OldFlowTest.kt` because the flow no longer exists.
 - CI: standard compile, unit test, and detekt checks run by the PR bot.
 ```
 

AGENTS.md

@@ -229,6 +229,7 @@ suspend fun getData(): Result<Data> = withContext(Dispatchers.IO) {
 - ALWAYS add new localizable string resources in alphabetical order in `strings.xml`
 - NEVER add string resources for strings used only in dev settings screens and previews and never localize acronyms
 - ALWAYS use template in `.github/pull_request_template.md` for PR descriptions
+- ALWAYS reference test files in PR descriptions/QA Notes by bare file name only (e.g. `HwWalletRepoTest.kt`), NEVER the full path; only when two referenced test files share the same name, prefix the shortest leading path segment(s) that disambiguate them (e.g. `repositories/FooTest.kt` vs `viewmodels/FooTest.kt`)
 - ALWAYS wrap `ULong` numbers with `USat` in arithmetic operations, to guard against overflows
 - PREFER to use one-liners with `run {}` when applicable, e.g. `override fun someCall(value: String) = run { this.value = value }`
 - ALWAYS add imports instead of inline fully-qualified names

app/src/main/java/to/bitkit/data/TrezorStore.kt → app/src/main/java/to/bitkit/data/HwWalletStore.kt

@@ -9,25 +9,25 @@ import kotlinx.coroutines.flow.Flow
 import kotlinx.coroutines.flow.first
 import kotlinx.coroutines.withContext
 import kotlinx.serialization.Serializable
-import to.bitkit.data.serializers.TrezorDataSerializer
+import to.bitkit.data.serializers.HwWalletDataSerializer
 import to.bitkit.di.IoDispatcher
 import to.bitkit.repositories.KnownDevice
 import javax.inject.Inject
 import javax.inject.Singleton
 
-private val Context.trezorDataStore: DataStore<TrezorData> by dataStore(
+private val Context.hwWalletDataStore: DataStore<HwWalletData> by dataStore(
     fileName = "trezor_device.json",
-    serializer = TrezorDataSerializer
+    serializer = HwWalletDataSerializer
 )
 
 @Singleton
-class TrezorStore @Inject constructor(
+class HwWalletStore @Inject constructor(
     @ApplicationContext private val context: Context,
     @IoDispatcher private val ioDispatcher: CoroutineDispatcher,
 ) {
-    private val store = context.trezorDataStore
+    private val store = context.hwWalletDataStore
 
-    val data: Flow<TrezorData> = store.data
+    val data: Flow<HwWalletData> = store.data
 
     suspend fun loadKnownDevices(): List<KnownDevice> = withContext(ioDispatcher) {
         store.data.first().knownDevices
@@ -39,12 +39,12 @@ class TrezorStore @Inject constructor(
     }
 
     suspend fun reset() = withContext(ioDispatcher) {
-        store.updateData { TrezorData() }
+        store.updateData { HwWalletData() }
         Unit
     }
 }
 
 @Serializable
-data class TrezorData(
+data class HwWalletData(
     val knownDevices: List<KnownDevice> = emptyList(),
 )

app/src/main/java/to/bitkit/data/serializers/TrezorDataSerializer.kt → app/src/main/java/to/bitkit/data/serializers/HwWalletDataSerializer.kt

@@ -2,27 +2,27 @@ package to.bitkit.data.serializers
 
 import androidx.datastore.core.Serializer
 import kotlinx.serialization.SerializationException
-import to.bitkit.data.TrezorData
+import to.bitkit.data.HwWalletData
 import to.bitkit.di.json
 import to.bitkit.utils.Logger
 import java.io.InputStream
 import java.io.OutputStream
 
-object TrezorDataSerializer : Serializer<TrezorData> {
-    private const val TAG = "TrezorDataSerializer"
+object HwWalletDataSerializer : Serializer<HwWalletData> {
+    private const val TAG = "HwWalletDataSerializer"
 
-    override val defaultValue: TrezorData = TrezorData()
+    override val defaultValue: HwWalletData = HwWalletData()
 
-    override suspend fun readFrom(input: InputStream): TrezorData {
+    override suspend fun readFrom(input: InputStream): HwWalletData {
         return try {
             json.decodeFromString(input.readBytes().decodeToString())
         } catch (e: SerializationException) {
-            Logger.error("Deserialize Trezor data failed", e, context = TAG)
+            Logger.error("Deserialize hardware wallet data failed", e, context = TAG)
             defaultValue
         }
     }
 
-    override suspend fun writeTo(t: TrezorData, output: OutputStream) {
+    override suspend fun writeTo(t: HwWalletData, output: OutputStream) {
         output.write(json.encodeToString(t).encodeToByteArray())
     }
 }

app/src/main/java/to/bitkit/models/AddressType.kt

@@ -2,6 +2,7 @@
 
 package to.bitkit.models
 
+import com.synonym.bitkitcore.AccountType
 import com.synonym.bitkitcore.AddressType
 import org.lightningdevkit.ldknode.Network
 import to.bitkit.env.Env
@@ -99,6 +100,14 @@ fun AddressType.toAccountDerivationPath(network: Network = Env.network): String
     }
 }
 
+fun AddressType.toAccountType(): AccountType = when (this) {
+    AddressType.P2TR -> AccountType.TAPROOT
+    AddressType.P2WPKH -> AccountType.NATIVE_SEGWIT
+    AddressType.P2SH -> AccountType.WRAPPED_SEGWIT
+    AddressType.P2PKH -> AccountType.LEGACY
+    else -> AccountType.NATIVE_SEGWIT
+}
+
 fun AddressType.toSettingsString(): String = when (this) {
     AddressType.P2TR -> "taproot"
     AddressType.P2WPKH -> "nativeSegwit"

app/src/main/java/to/bitkit/models/BalanceState.kt

@@ -1,9 +1,9 @@
 package to.bitkit.models
 
-import androidx.compose.runtime.Immutable
+import androidx.compose.runtime.Stable
 import kotlinx.serialization.Serializable
 
-@Immutable
+@Stable
 @Serializable
 data class BalanceState(
     val totalOnchainSats: ULong = 0uL,
@@ -13,6 +13,11 @@ data class BalanceState(
     val maxSendOnchainSats: ULong = 0uL,
     val balanceInTransferToSavings: ULong = 0uL,
     val balanceInTransferToSpending: ULong = 0uL,
+    val hardwareWallets: List<HwWalletBalance> = emptyList(),
 ) {
     val totalSats get() = totalOnchainSats + totalLightningSats
+
+    val totalHardwareSats get() = hardwareWallets.fold(0uL) { acc, wallet -> acc.safe() + wallet.sats.safe() }
+
+    val totalWithHardwareSats get() = totalSats.safe() + totalHardwareSats.safe()
 }

app/src/main/java/to/bitkit/models/HwWallet.kt

@@ -0,0 +1,36 @@
+package to.bitkit.models
+
+import androidx.compose.runtime.Immutable
+import androidx.compose.runtime.Stable
+import com.synonym.bitkitcore.Activity
+import kotlinx.collections.immutable.ImmutableList
+import kotlinx.serialization.Serializable
+
+/** A paired hardware wallet tracked as a watch-only balance. */
+@Stable
+data class HwWallet(
+    val id: String,
+    val name: String,
+    val model: String?,
+    val transportType: TransportType,
+    val isConnected: Boolean,
+    val balanceSats: ULong,
+    val activities: ImmutableList<Activity>,
+)
+
+/** Serializable per-device balance snapshot carried by [BalanceState]. */
+@Immutable
+@Serializable
+data class HwWalletBalance(
+    val id: String,
+    val sats: ULong,
+)
+
+/** A newly detected inbound transaction to a watched hardware wallet. */
+@Immutable
+data class HwWalletReceivedTx(
+    val txid: String,
+    val sats: ULong,
+)
+
+fun HwWallet.toBalance() = HwWalletBalance(id = id, sats = balanceSats)

app/src/main/java/to/bitkit/models/Suggestion.kt

@@ -19,6 +19,12 @@ enum class Suggestion(
         color = Colors.Brand24,
         icon = R.drawable.b_emboss,
     ),
+    HARDWARE(
+        title = R.string.cards__hardware__title,
+        description = R.string.cards__hardware__description,
+        color = Colors.Blue24,
+        icon = R.drawable.trezor,
+    ),
     LIGHTNING(
         title = R.string.cards__lightning__title,
         description = R.string.cards__lightning__description,
@@ -46,13 +52,13 @@ enum class Suggestion(
     INVITE(
         title = R.string.cards__invite__title,
         description = R.string.cards__invite__description,
-        color = Colors.Blue24,
+        color = Colors.Green24,
         icon = R.drawable.group
     ),
     PROFILE(
         title = R.string.cards__slashtagsProfile__title,
         description = R.string.cards__slashtagsProfile__description,
-        color = Colors.PubkyGreen24,
+        color = Colors.Brand24,
         icon = R.drawable.crown,
     ),
     SHOP(

app/src/main/java/to/bitkit/models/TransportType.kt

@@ -0,0 +1,14 @@
+package to.bitkit.models
+
+import kotlinx.serialization.SerialName
+import kotlinx.serialization.Serializable
+
+/** Transport a hardware-wallet device is paired over. */
+@Serializable
+enum class TransportType {
+    @SerialName("bluetooth")
+    BLUETOOTH,
+
+    @SerialName("usb")
+    USB,
+}