Release/v1.2.2

ARCHITECTURE.md

@@ -184,3 +184,13 @@ This pattern keeps business logic and validation centralized in Rust while givin
 - Swift bindings land in `ios/CoveCore/Sources/CoveCore/generated/`; Kotlin bindings live (after copy) under `android/app/src/main/java/org/bitcoinppl/cove_core/`.
 - Database file defaults to `$ROOT_DATA_DIR/cove.db` (see `cove_common::consts::ROOT_DATA_DIR`).
 - Hardware / NFC helpers: `rust/crates/cove-device`, `rust/src/tap_card/`, and platform shims in `ios/Cove/FFI/` plus Android's `org.bitcoinppl.cove_core` package.
+
+---
+
+## iOS 26 SwiftUI Bugs & Workarounds
+
+### ToolbarItem(placement: .principal) — DO NOT USE
+
+SwiftUI has a bug on iOS 26 where `ToolbarPlacementEnvironment.updateValue()` enters an infinite loop during `_UINavigationParallaxTransition` (back button / swipe back) when a `.principal` toolbar item exists at large accessibility font sizes (specifically `accessibilityExtraExtraLarge`). This causes 100% CPU freeze.
+
+**Workaround:** For screens that need custom title content (icons, context menus, dynamic colors), use `.navigationTitleView { }` from `ios/Cove/Views/NavigationTitleView.swift`. This hosts SwiftUI content inside UIKit's `navigationItem.titleView`, bypassing SwiftUI's toolbar placement system entirely. For screens with plain static text titles, use `.navigationTitle("Title").navigationBarTitleDisplayMode(.inline)` instead.

android/app/build.gradle.kts

@@ -121,7 +121,7 @@ dependencies {
     implementation("androidx.camera:camera-lifecycle:1.5.1")
     implementation("androidx.camera:camera-view:1.5.1")
     implementation("com.google.accompanist:accompanist-permissions:0.37.3")
-    implementation("com.google.android.gms:play-services-mlkit-barcode-scanning:18.3.1")
+    implementation("com.google.mlkit:barcode-scanning:17.3.0")
     implementation("com.google.zxing:core:3.5.4")
 
     // Coil for image loading (including SVG support)

android/app/proguard-rules.pro

@@ -27,6 +27,9 @@
     volatile <fields>;
 }
 
+# ML Kit bundled variant: keep registrar constructors used via reflection by ComponentDiscovery
+-keep class com.google.mlkit.** { *; }
+
 # Preserve line numbers for debugging crash reports
 -keepattributes SourceFile,LineNumberTable
 -renamesourcefileattribute SourceFile

android/app/src/main/java/org/bitcoinppl/cove/AppManager.kt

@@ -670,9 +670,19 @@ class AppManager private constructor() : FfiReconcile {
          */
         private const val MIN_LOADING_VISIBILITY_MS = 200L
 
+        private fun requireBootstrapComplete(owner: String) {
+            val step = bootstrapProgress()
+            check(step == BootstrapStep.COMPLETE) {
+                "$owner initialized before bootstrap completed: $step"
+            }
+        }
+
         fun getInstance(): AppManager =
             instance ?: synchronized(this) {
-                instance ?: AppManager().also { instance = it }
+                instance ?: run {
+                    requireBootstrapComplete("AppManager")
+                    AppManager().also { instance = it }
+                }
             }
     }
 }

android/app/src/main/java/org/bitcoinppl/cove/AuthManager.kt

@@ -61,9 +61,19 @@ class AuthManager private constructor() : AuthManagerReconciler {
         @Volatile
         private var instance: AuthManager? = null
 
+        private fun requireBootstrapComplete(owner: String) {
+            val step = bootstrapProgress()
+            check(step == BootstrapStep.COMPLETE) {
+                "$owner initialized before bootstrap completed: $step"
+            }
+        }
+
         fun getInstance(): AuthManager =
             instance ?: synchronized(this) {
-                instance ?: AuthManager().also { instance = it }
+                instance ?: run {
+                    requireBootstrapComplete("AuthManager")
+                    AuthManager().also { instance = it }
+                }
             }
     }
 

android/app/src/main/java/org/bitcoinppl/cove/MainActivity.kt

@@ -546,16 +546,12 @@ private fun GlobalAlertDialog(
                     Column(horizontalAlignment = Alignment.End) {
                         TextButton(onClick = {
                             onDismiss()
-                            app.pushRoute(Route.NewWallet(NewWalletRoute.HotWallet(HotWalletRoute.Import(NumberOfBip39Words.TWELVE, ImportType.MANUAL))))
+                            app.loadAndReset(Route.NewWallet(NewWalletRoute.HotWallet(HotWalletRoute.Import(NumberOfBip39Words.TWELVE, ImportType.MANUAL))))
                         }) { Text("Import 12 Words") }
                         TextButton(onClick = {
                             onDismiss()
-                            app.pushRoute(Route.NewWallet(NewWalletRoute.HotWallet(HotWalletRoute.Import(NumberOfBip39Words.TWENTY_FOUR, ImportType.MANUAL))))
+                            app.loadAndReset(Route.NewWallet(NewWalletRoute.HotWallet(HotWalletRoute.Import(NumberOfBip39Words.TWENTY_FOUR, ImportType.MANUAL))))
                         }) { Text("Import 24 Words") }
-                        TextButton(onClick = {
-                            onDismiss()
-                            app.alertState = TaggedItem(AppAlertState.ConfirmWatchOnly)
-                        }) { Text("Use as Watch Only") }
                         TextButton(onClick = {
                             onDismiss()
                             try {
@@ -571,6 +567,10 @@ private fun GlobalAlertDialog(
                                     )
                             }
                         }) { Text("Use with Hardware Wallet") }
+                        TextButton(onClick = {
+                            onDismiss()
+                            app.alertState = TaggedItem(AppAlertState.ConfirmWatchOnly)
+                        }) { Text("Use as Watch Only") }
                     }
                 },
             )

android/app/src/main/java/org/bitcoinppl/cove/Security.kt

@@ -2,11 +2,14 @@ package org.bitcoinppl.cove
 
 import android.content.Context
 import android.content.SharedPreferences
+import android.content.pm.PackageManager
+import android.util.Log
 import androidx.security.crypto.EncryptedSharedPreferences
 import androidx.security.crypto.MasterKey
 import org.bitcoinppl.cove_core.device.DeviceAccess
 import org.bitcoinppl.cove_core.device.KeychainAccess
 import org.bitcoinppl.cove_core.device.KeychainException
+import java.security.GeneralSecurityException
 import java.util.TimeZone
 
 class KeychainAccessor(
@@ -15,23 +18,15 @@ class KeychainAccessor(
     private val sharedPreferences: SharedPreferences
 
     init {
-        // create or retrieve the master key for encryption
-        val masterKey =
-            MasterKey
-                .Builder(context)
-                .setKeyScheme(MasterKey.KeyScheme.AES256_GCM)
-                .setRequestStrongBoxBacked(true)
-                .build()
-
-        // create encrypted shared preferences
+        val useStrongBox = hasStrongBox(context)
         sharedPreferences =
-            EncryptedSharedPreferences.create(
-                context,
-                "cove_secure_storage",
-                masterKey,
-                EncryptedSharedPreferences.PrefKeyEncryptionScheme.AES256_SIV,
-                EncryptedSharedPreferences.PrefValueEncryptionScheme.AES256_GCM,
-            )
+            try {
+                createEncryptedPrefs(context, requestStrongBox = useStrongBox)
+            } catch (e: GeneralSecurityException) {
+                if (!useStrongBox) throw e // not a StrongBox issue, no fallback available
+                Log.w("KeychainAccessor", "StrongBox-backed prefs failed, falling back to TEE", e)
+                createEncryptedPrefs(context, requestStrongBox = false)
+            }
     }
 
     override fun save(key: String, value: String) {
@@ -55,6 +50,26 @@ class KeychainAccessor(
             .commit()
 }
 
+private fun hasStrongBox(context: Context): Boolean =
+    context.packageManager.hasSystemFeature(PackageManager.FEATURE_STRONGBOX_KEYSTORE)
+
+private fun createEncryptedPrefs(context: Context, requestStrongBox: Boolean): SharedPreferences {
+    val masterKey =
+        MasterKey
+            .Builder(context)
+            .setKeyScheme(MasterKey.KeyScheme.AES256_GCM)
+            .setRequestStrongBoxBacked(requestStrongBox)
+            .build()
+
+    return EncryptedSharedPreferences.create(
+        context,
+        "cove_secure_storage",
+        masterKey,
+        EncryptedSharedPreferences.PrefKeyEncryptionScheme.AES256_SIV,
+        EncryptedSharedPreferences.PrefValueEncryptionScheme.AES256_GCM,
+    )
+}
+
 class DeviceAccessor : DeviceAccess {
     override fun timezone(): String = TimeZone.getDefault().id
 }

android/app/src/main/java/org/bitcoinppl/cove/WalletManager.kt

@@ -101,6 +101,13 @@ class WalletManager :
         this.walletMetadata = metadata
         this.unsignedTransactions = runCatching { rustManager.getUnsignedTransactions() }.getOrElse { emptyList() }
 
+        // set initial load state from Rust cached data
+        loadState = when (val rustLoadState = rustManager.initialLoadState()) {
+            is org.bitcoinppl.cove_core.WalletLoadState.Loading -> WalletLoadState.LOADING
+            is org.bitcoinppl.cove_core.WalletLoadState.Scanning -> WalletLoadState.SCANNING(rustLoadState.v1)
+            is org.bitcoinppl.cove_core.WalletLoadState.Loaded -> WalletLoadState.LOADED(rustLoadState.v1)
+        }
+
         rustManager.listenForUpdates(this)
     }
 
@@ -202,7 +209,11 @@ class WalletManager :
     private fun apply(message: WalletManagerReconcileMessage) {
         when (message) {
             is WalletManagerReconcileMessage.StartedInitialFullScan -> {
-                loadState = WalletLoadState.LOADING
+                when (val current = loadState) {
+                    is WalletLoadState.SCANNING -> if (current.txns.isEmpty()) loadState = WalletLoadState.LOADING
+                    is WalletLoadState.LOADED -> loadState = WalletLoadState.SCANNING(current.txns)
+                    else -> loadState = WalletLoadState.LOADING
+                }
             }
 
             is WalletManagerReconcileMessage.StartedExpandedFullScan -> {