feat: trezor hardware support

app/build.gradle.kts

@@ -48,6 +48,8 @@ val bcp47Locales = listOf(
 )
 val e2eBackendEnv = System.getenv("E2E_BACKEND") ?: "local"
 val e2eHomegateUrlEnv = System.getenv("E2E_HOMEGATE_URL") ?: "http://127.0.0.1:6288"
+val trezorBridgeEnv = System.getenv("TREZOR_BRIDGE")?.toBoolean()?.toString() ?: "false"
+val trezorBridgeUrlEnv = System.getenv("TREZOR_BRIDGE_URL") ?: "http://10.0.2.2:21325"
 
 android {
  namespace = "to.bitkit"
@@ -65,6 +67,8 @@ android {
  buildConfigField("boolean", "E2E", System.getenv("E2E")?.toBoolean()?.toString() ?: "false")
  buildConfigField("String", "E2E_BACKEND", "\"$e2eBackendEnv\"")
  buildConfigField("String", "E2E_HOMEGATE_URL", "\"$e2eHomegateUrlEnv\"")
+ buildConfigField("boolean", "TREZOR_BRIDGE", trezorBridgeEnv)
+ buildConfigField("String", "TREZOR_BRIDGE_URL", "\"$trezorBridgeUrlEnv\"")
  buildConfigField("boolean", "GEO", System.getenv("GEO")?.toBoolean()?.toString() ?: "true")
  buildConfigField("String", "LOCALES", "\"${bcp47Locales.joinToString(",")}\"")
  }
@@ -217,7 +221,7 @@ composeCompiler {
 }
 
 dependencies {
- implementation(fileTree("libs") { include("*.aar") })
+ implementation(fileTree("libs") { include("*.aar", "*.jar") })
  implementation(libs.jna) { artifact { type = "aar" } }
  implementation(platform(libs.kotlin.bom))
  implementation(libs.core.ktx)

app/proguard-rules.pro

@@ -18,4 +18,11 @@
 
 # If you keep the line number information, uncomment this to
 # hide the original source file name.
-#-renamesourcefileattribute SourceFile
+#-renamesourcefileattribute SourceFile
+
+# btleplug (droidplug) Android Bluetooth support
+# These classes are loaded via JNI from Rust code
+-keep class com.nonpolynomial.btleplug.** { *; }
+
+# jni-utils support library for btleplug
+-keep class io.github.gedgygedgy.rust.** { *; }

app/src/main/AndroidManifest.xml

@@ -26,6 +26,25 @@
  android:name="android.permission.FOREGROUND_SERVICE"
  tools:ignore="ForegroundServicePermission,ForegroundServicesPolicy" />
  <uses-permission android:name="android.permission.FOREGROUND_SERVICE_DATA_SYNC" />
+
+ <!-- USB Host support for Trezor hardware wallet -->
+ <uses-feature
+ android:name="android.hardware.usb.host"
+ android:required="false" />
+
+ <!-- Bluetooth permissions for Trezor Safe 7 (Android 12+) -->
+ <uses-permission android:name="android.permission.BLUETOOTH_CONNECT" />
+ <uses-permission android:name="android.permission.BLUETOOTH_SCAN"
+ android:usesPermissionFlags="neverForLocation" />
+
+ <!-- Bluetooth permissions (legacy, Android 11 and below) -->
+ <uses-permission android:name="android.permission.BLUETOOTH"
+ android:maxSdkVersion="30" />
+ <uses-permission android:name="android.permission.BLUETOOTH_ADMIN"
+ android:maxSdkVersion="30" />
+ <uses-permission android:name="android.permission.ACCESS_FINE_LOCATION"
+ android:maxSdkVersion="30" />
+
  <!-- Required for E2E tests connecting to local Electrum server (Android 16+) -->
  <uses-permission
  android:name="android.permission.NEARBY_WIFI_DEVICES"
@@ -132,6 +151,14 @@
  <data android:scheme="lnurlp" />
  </intent-filter>
 
+ <!-- USB device attached — auto-grants permission when Trezor is plugged in -->
+ <intent-filter>
+ <action android:name="android.hardware.usb.action.USB_DEVICE_ATTACHED" />
+ </intent-filter>
+ <meta-data
+ android:name="android.hardware.usb.action.USB_DEVICE_ATTACHED"
+ android:resource="@xml/usb_device_filter" />
+
  <meta-data
  android:name="android.app.shortcuts"
  android:resource="@xml/shortcuts" />

app/src/main/java/to/bitkit/App.kt

@@ -11,6 +11,7 @@ import coil3.ImageLoader
 import coil3.SingletonImageLoader
 import dagger.hilt.android.HiltAndroidApp
 import to.bitkit.env.Env
+import to.bitkit.services.BluetoothInit
 import javax.inject.Inject
 
 @HiltAndroidApp
@@ -31,6 +32,8 @@ internal open class App : Application(), Configuration.Provider {
  SingletonImageLoader.setSafe { imageLoader }
  currentActivity = CurrentActivity().also { registerActivityLifecycleCallbacks(it) }
  Env.initAppStoragePath(filesDir.absolutePath)
+ // Initialize btleplug for Bluetooth support (required before any BLE usage)
+ BluetoothInit.ensureInitialized()
  }
 
  companion object {

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

@@ -0,0 +1,43 @@
+package to.bitkit.data
+
+import android.content.Context
+import androidx.datastore.core.DataStore
+import androidx.datastore.dataStore
+import dagger.hilt.android.qualifiers.ApplicationContext
+import kotlinx.coroutines.flow.Flow
+import kotlinx.coroutines.flow.first
+import kotlinx.serialization.Serializable
+import to.bitkit.data.serializers.TrezorDataSerializer
+import to.bitkit.repositories.KnownDevice
+import javax.inject.Inject
+import javax.inject.Singleton
+
+private val Context.trezorDataStore: DataStore<TrezorData> by dataStore(
+ fileName = "trezor_device.json",
+ serializer = TrezorDataSerializer
+)
+
+@Singleton
+class TrezorStore @Inject constructor(
+ @ApplicationContext private val context: Context,
+) {
+ private val store = context.trezorDataStore
+
+ val data: Flow<TrezorData> = store.data
+
+ suspend fun loadKnownDevices(): List<KnownDevice> =
+ store.data.first().knownDevices
+
+ suspend fun saveKnownDevices(devices: List<KnownDevice>) {
+ store.updateData { it.copy(knownDevices = devices) }
+ }
+
+ suspend fun reset() {
+ store.updateData { TrezorData() }
+ }
+}
+
+@Serializable
+data class TrezorData(
+ val knownDevices: List<KnownDevice> = emptyList(),
+)

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

@@ -0,0 +1,26 @@
+package to.bitkit.data.serializers
+
+import androidx.datastore.core.Serializer
+import kotlinx.serialization.SerializationException
+import to.bitkit.data.TrezorData
+import to.bitkit.di.json
+import to.bitkit.utils.Logger
+import java.io.InputStream
+import java.io.OutputStream
+
+object TrezorDataSerializer : Serializer<TrezorData> {
+ override val defaultValue: TrezorData = TrezorData()
+
+ override suspend fun readFrom(input: InputStream): TrezorData {
+ return try {
+ json.decodeFromString(input.readBytes().decodeToString())
+ } catch (e: SerializationException) {
+ Logger.error("Failed to deserialize: $e")
+ defaultValue
+ }
+ }
+
+ override suspend fun writeTo(t: TrezorData, output: OutputStream) {
+ output.write(json.encodeToString(t).encodeToByteArray())
+ }
+}

app/src/main/java/to/bitkit/env/Env.kt

@@ -13,6 +13,7 @@ import to.bitkit.models.NodePeer
 import to.bitkit.utils.Logger
 import java.io.File
 import kotlin.io.path.Path
+import com.synonym.bitkitcore.Network as BitkitCoreNetwork
 
 @Suppress("ConstPropertyName", "KotlinConstantConditions", "SimplifyBooleanWithConstants")
 internal object Env {
@@ -199,6 +200,17 @@ internal object Env {
  else -> "https://bitkit.stag0.blocktank.to/backups-ldk"
  }
 
+ fun electrumUrlForNetwork(network: BitkitCoreNetwork): String {
+ val isE2eLocal = isE2eTest && e2eBackend == "local"
+ return when (network) {
+ BitkitCoreNetwork.BITCOIN -> ElectrumServers.MAINNET.ESPLORA
+ BitkitCoreNetwork.TESTNET, BitkitCoreNetwork.TESTNET4, BitkitCoreNetwork.SIGNET ->
+ ElectrumServers.TESTNET
+ BitkitCoreNetwork.REGTEST ->
+ if (isE2eLocal) ElectrumServers.REGTEST.LOCAL else ElectrumServers.REGTEST.STAG
+ }
+ }
+
  // endregion
 
  // region paths

app/src/main/java/to/bitkit/ext/Context.kt

@@ -3,13 +3,15 @@ package to.bitkit.ext
 import android.app.Activity
 import android.app.ActivityManager
 import android.app.NotificationManager
+import android.bluetooth.BluetoothManager
 import android.content.ClipData
 import android.content.ClipboardManager
 import android.content.Context
 import android.content.Context.NOTIFICATION_SERVICE
 import android.content.ContextWrapper
 import android.content.Intent
 import android.content.pm.PackageManager.PERMISSION_GRANTED
+import android.hardware.usb.UsbManager
 import android.provider.Settings
 import androidx.core.app.NotificationManagerCompat
 import androidx.core.content.ContextCompat
@@ -31,6 +33,12 @@ val Context.clipboardManager: ClipboardManager
 val Context.activityManager: ActivityManager
  get() = getSystemService(Context.ACTIVITY_SERVICE) as ActivityManager
 
+val Context.usbManager: UsbManager
+ get() = getSystemService(Context.USB_SERVICE) as UsbManager
+
+val Context.bluetoothManager: BluetoothManager
+ get() = getSystemService(Context.BLUETOOTH_SERVICE) as BluetoothManager
+
 // Permissions
 
 fun Context.requiresPermission(permission: String): Boolean =

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

@@ -1,6 +1,7 @@
 package to.bitkit.models
 
 import com.synonym.bitkitcore.NetworkType
+import com.synonym.bitkitcore.TrezorCoinType
 import org.lightningdevkit.ldknode.Network
 import com.synonym.bitkitcore.Network as BitkitCoreNetwork
 
@@ -11,6 +12,13 @@ fun Network.networkUiText(): String = when (this) {
  Network.REGTEST -> "Regtest"
 }
 
+fun Network.toTrezorCoinType(): TrezorCoinType = when (this) {
+ Network.BITCOIN -> TrezorCoinType.BITCOIN
+ Network.TESTNET -> TrezorCoinType.TESTNET
+ Network.SIGNET -> TrezorCoinType.SIGNET
+ Network.REGTEST -> TrezorCoinType.REGTEST
+}
+
 fun Network.toCoreNetwork(): BitkitCoreNetwork = when (this) {
  Network.BITCOIN -> BitkitCoreNetwork.BITCOIN
  Network.TESTNET -> BitkitCoreNetwork.TESTNET
@@ -31,3 +39,11 @@ fun NetworkType.toLdkNetwork(): Network = when (this) {
  NetworkType.SIGNET -> Network.SIGNET
  NetworkType.REGTEST -> Network.REGTEST
 }
+
+fun BitkitCoreNetwork.toTrezorCoinType(): TrezorCoinType = when (this) {
+ BitkitCoreNetwork.BITCOIN -> TrezorCoinType.BITCOIN
+ BitkitCoreNetwork.TESTNET -> TrezorCoinType.TESTNET
+ BitkitCoreNetwork.TESTNET4 -> TrezorCoinType.TESTNET
+ BitkitCoreNetwork.SIGNET -> TrezorCoinType.SIGNET
+ BitkitCoreNetwork.REGTEST -> TrezorCoinType.REGTEST
+}

app/build.gradle.kts

@@ -48,6 +48,8 @@ val bcp47Locales = listOf(
 )
 val e2eBackendEnv = System.getenv("E2E_BACKEND") ?: "local"
 val e2eHomegateUrlEnv = System.getenv("E2E_HOMEGATE_URL") ?: "http://127.0.0.1:6288"
+val trezorBridgeEnv = System.getenv("TREZOR_BRIDGE")?.toBoolean()?.toString() ?: "false"
+val trezorBridgeUrlEnv = System.getenv("TREZOR_BRIDGE_URL") ?: "http://10.0.2.2:21325"
 
 android {
  namespace = "to.bitkit"
@@ -65,6 +67,8 @@ android {
  buildConfigField("boolean", "E2E", System.getenv("E2E")?.toBoolean()?.toString() ?: "false")
  buildConfigField("String", "E2E_BACKEND", "\"$e2eBackendEnv\"")
  buildConfigField("String", "E2E_HOMEGATE_URL", "\"$e2eHomegateUrlEnv\"")
+ buildConfigField("boolean", "TREZOR_BRIDGE", trezorBridgeEnv)
+ buildConfigField("String", "TREZOR_BRIDGE_URL", "\"$trezorBridgeUrlEnv\"")
  buildConfigField("boolean", "GEO", System.getenv("GEO")?.toBoolean()?.toString() ?: "true")
  buildConfigField("String", "LOCALES", "\"${bcp47Locales.joinToString(",")}\"")
  }
@@ -217,7 +221,7 @@ composeCompiler {
 }
 
 dependencies {
- implementation(fileTree("libs") { include("*.aar") })
+ implementation(fileTree("libs") { include("*.aar", "*.jar") })
  implementation(libs.jna) { artifact { type = "aar" } }
  implementation(platform(libs.kotlin.bom))
  implementation(libs.core.ktx)

app/proguard-rules.pro

@@ -18,4 +18,11 @@
 
 # If you keep the line number information, uncomment this to
 # hide the original source file name.
-#-renamesourcefileattribute SourceFile
+#-renamesourcefileattribute SourceFile
+
+# btleplug (droidplug) Android Bluetooth support
+# These classes are loaded via JNI from Rust code
+-keep class com.nonpolynomial.btleplug.** { *; }
+
+# jni-utils support library for btleplug
+-keep class io.github.gedgygedgy.rust.** { *; }

app/src/main/AndroidManifest.xml

@@ -26,6 +26,25 @@
  android:name="android.permission.FOREGROUND_SERVICE"
  tools:ignore="ForegroundServicePermission,ForegroundServicesPolicy" />
  <uses-permission android:name="android.permission.FOREGROUND_SERVICE_DATA_SYNC" />
+
+ <!-- USB Host support for Trezor hardware wallet -->
+ <uses-feature
+ android:name="android.hardware.usb.host"
+ android:required="false" />
+
+ <!-- Bluetooth permissions for Trezor Safe 7 (Android 12+) -->
+ <uses-permission android:name="android.permission.BLUETOOTH_CONNECT" />
+ <uses-permission android:name="android.permission.BLUETOOTH_SCAN"
+ android:usesPermissionFlags="neverForLocation" />
+
+ <!-- Bluetooth permissions (legacy, Android 11 and below) -->
+ <uses-permission android:name="android.permission.BLUETOOTH"
+ android:maxSdkVersion="30" />
+ <uses-permission android:name="android.permission.BLUETOOTH_ADMIN"
+ android:maxSdkVersion="30" />
+ <uses-permission android:name="android.permission.ACCESS_FINE_LOCATION"
+ android:maxSdkVersion="30" />
+
  <!-- Required for E2E tests connecting to local Electrum server (Android 16+) -->
  <uses-permission
  android:name="android.permission.NEARBY_WIFI_DEVICES"
@@ -132,6 +151,14 @@
  <data android:scheme="lnurlp" />
  </intent-filter>
 
+ <!-- USB device attached — auto-grants permission when Trezor is plugged in -->
+ <intent-filter>
+ <action android:name="android.hardware.usb.action.USB_DEVICE_ATTACHED" />
+ </intent-filter>
+ <meta-data
+ android:name="android.hardware.usb.action.USB_DEVICE_ATTACHED"
+ android:resource="@xml/usb_device_filter" />
+
  <meta-data
  android:name="android.app.shortcuts"
  android:resource="@xml/shortcuts" />

app/src/main/java/to/bitkit/App.kt

@@ -11,6 +11,7 @@ import coil3.ImageLoader
 import coil3.SingletonImageLoader
 import dagger.hilt.android.HiltAndroidApp
 import to.bitkit.env.Env
+import to.bitkit.services.BluetoothInit
 import javax.inject.Inject
 
 @HiltAndroidApp
@@ -31,6 +32,8 @@ internal open class App : Application(), Configuration.Provider {
  SingletonImageLoader.setSafe { imageLoader }
  currentActivity = CurrentActivity().also { registerActivityLifecycleCallbacks(it) }
  Env.initAppStoragePath(filesDir.absolutePath)
+ // Initialize btleplug for Bluetooth support (required before any BLE usage)
+ BluetoothInit.ensureInitialized()
  }
 
  companion object {

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

@@ -0,0 +1,43 @@
+package to.bitkit.data
+
+import android.content.Context
+import androidx.datastore.core.DataStore
+import androidx.datastore.dataStore
+import dagger.hilt.android.qualifiers.ApplicationContext
+import kotlinx.coroutines.flow.Flow
+import kotlinx.coroutines.flow.first
+import kotlinx.serialization.Serializable
+import to.bitkit.data.serializers.TrezorDataSerializer
+import to.bitkit.repositories.KnownDevice
+import javax.inject.Inject
+import javax.inject.Singleton
+
+private val Context.trezorDataStore: DataStore<TrezorData> by dataStore(
+ fileName = "trezor_device.json",
+ serializer = TrezorDataSerializer
+)
+
+@Singleton
+class TrezorStore @Inject constructor(
+ @ApplicationContext private val context: Context,
+) {
+ private val store = context.trezorDataStore
+
+ val data: Flow<TrezorData> = store.data
+
+ suspend fun loadKnownDevices(): List<KnownDevice> =
+ store.data.first().knownDevices
+
+ suspend fun saveKnownDevices(devices: List<KnownDevice>) {
+ store.updateData { it.copy(knownDevices = devices) }
+ }
+
+ suspend fun reset() {
+ store.updateData { TrezorData() }
+ }
+}
+
+@Serializable
+data class TrezorData(
+ val knownDevices: List<KnownDevice> = emptyList(),
+)

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

@@ -0,0 +1,26 @@
+package to.bitkit.data.serializers
+
+import androidx.datastore.core.Serializer
+import kotlinx.serialization.SerializationException
+import to.bitkit.data.TrezorData
+import to.bitkit.di.json
+import to.bitkit.utils.Logger
+import java.io.InputStream
+import java.io.OutputStream
+
+object TrezorDataSerializer : Serializer<TrezorData> {
+ override val defaultValue: TrezorData = TrezorData()
+
+ override suspend fun readFrom(input: InputStream): TrezorData {
+ return try {
+ json.decodeFromString(input.readBytes().decodeToString())
+ } catch (e: SerializationException) {
+ Logger.error("Failed to deserialize: $e")
+ defaultValue
+ }
+ }
+
+ override suspend fun writeTo(t: TrezorData, output: OutputStream) {
+ output.write(json.encodeToString(t).encodeToByteArray())
+ }
+}

app/src/main/java/to/bitkit/env/Env.kt

@@ -13,6 +13,7 @@ import to.bitkit.models.NodePeer
 import to.bitkit.utils.Logger
 import java.io.File
 import kotlin.io.path.Path
+import com.synonym.bitkitcore.Network as BitkitCoreNetwork
 
 @Suppress("ConstPropertyName", "KotlinConstantConditions", "SimplifyBooleanWithConstants")
 internal object Env {
@@ -199,6 +200,17 @@ internal object Env {
  else -> "https://bitkit.stag0.blocktank.to/backups-ldk"
  }
 
+ fun electrumUrlForNetwork(network: BitkitCoreNetwork): String {
+ val isE2eLocal = isE2eTest && e2eBackend == "local"
+ return when (network) {
+ BitkitCoreNetwork.BITCOIN -> ElectrumServers.MAINNET.ESPLORA
+ BitkitCoreNetwork.TESTNET, BitkitCoreNetwork.TESTNET4, BitkitCoreNetwork.SIGNET ->
+ ElectrumServers.TESTNET
+ BitkitCoreNetwork.REGTEST ->
+ if (isE2eLocal) ElectrumServers.REGTEST.LOCAL else ElectrumServers.REGTEST.STAG
+ }
+ }
+
  // endregion
 
  // region paths

app/src/main/java/to/bitkit/ext/Context.kt

@@ -3,13 +3,15 @@ package to.bitkit.ext
 import android.app.Activity
 import android.app.ActivityManager
 import android.app.NotificationManager
+import android.bluetooth.BluetoothManager
 import android.content.ClipData
 import android.content.ClipboardManager
 import android.content.Context
 import android.content.Context.NOTIFICATION_SERVICE
 import android.content.ContextWrapper
 import android.content.Intent
 import android.content.pm.PackageManager.PERMISSION_GRANTED
+import android.hardware.usb.UsbManager
 import android.provider.Settings
 import androidx.core.app.NotificationManagerCompat
 import androidx.core.content.ContextCompat
@@ -31,6 +33,12 @@ val Context.clipboardManager: ClipboardManager
 val Context.activityManager: ActivityManager
  get() = getSystemService(Context.ACTIVITY_SERVICE) as ActivityManager
 
+val Context.usbManager: UsbManager
+ get() = getSystemService(Context.USB_SERVICE) as UsbManager
+
+val Context.bluetoothManager: BluetoothManager
+ get() = getSystemService(Context.BLUETOOTH_SERVICE) as BluetoothManager
+
 // Permissions
 
 fun Context.requiresPermission(permission: String): Boolean =

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

@@ -1,6 +1,7 @@
 package to.bitkit.models
 
 import com.synonym.bitkitcore.NetworkType
+import com.synonym.bitkitcore.TrezorCoinType
 import org.lightningdevkit.ldknode.Network
 import com.synonym.bitkitcore.Network as BitkitCoreNetwork
 
@@ -11,6 +12,13 @@ fun Network.networkUiText(): String = when (this) {
  Network.REGTEST -> "Regtest"
 }
 
+fun Network.toTrezorCoinType(): TrezorCoinType = when (this) {
+ Network.BITCOIN -> TrezorCoinType.BITCOIN
+ Network.TESTNET -> TrezorCoinType.TESTNET
+ Network.SIGNET -> TrezorCoinType.SIGNET
+ Network.REGTEST -> TrezorCoinType.REGTEST
+}
+
 fun Network.toCoreNetwork(): BitkitCoreNetwork = when (this) {
  Network.BITCOIN -> BitkitCoreNetwork.BITCOIN
  Network.TESTNET -> BitkitCoreNetwork.TESTNET
@@ -31,3 +39,11 @@ fun NetworkType.toLdkNetwork(): Network = when (this) {
  NetworkType.SIGNET -> Network.SIGNET
  NetworkType.REGTEST -> Network.REGTEST
 }
+
+fun BitkitCoreNetwork.toTrezorCoinType(): TrezorCoinType = when (this) {
+ BitkitCoreNetwork.BITCOIN -> TrezorCoinType.BITCOIN
+ BitkitCoreNetwork.TESTNET -> TrezorCoinType.TESTNET
+ BitkitCoreNetwork.TESTNET4 -> TrezorCoinType.TESTNET
+ BitkitCoreNetwork.SIGNET -> TrezorCoinType.SIGNET
+ BitkitCoreNetwork.REGTEST -> TrezorCoinType.REGTEST
+}

app/build.gradle.kts

@@ -48,6 +48,8 @@ val bcp47Locales = listOf(
 )
 val e2eBackendEnv = System.getenv("E2E_BACKEND") ?: "local"
 val e2eHomegateUrlEnv = System.getenv("E2E_HOMEGATE_URL") ?: "http://127.0.0.1:6288"
+val trezorBridgeEnv = System.getenv("TREZOR_BRIDGE")?.toBoolean()?.toString() ?: "false"
+val trezorBridgeUrlEnv = System.getenv("TREZOR_BRIDGE_URL") ?: "http://10.0.2.2:21325"
 
 android {
  namespace = "to.bitkit"
@@ -65,6 +67,8 @@ android {
  buildConfigField("boolean", "E2E", System.getenv("E2E")?.toBoolean()?.toString() ?: "false")
  buildConfigField("String", "E2E_BACKEND", "\"$e2eBackendEnv\"")
  buildConfigField("String", "E2E_HOMEGATE_URL", "\"$e2eHomegateUrlEnv\"")
+ buildConfigField("boolean", "TREZOR_BRIDGE", trezorBridgeEnv)
+ buildConfigField("String", "TREZOR_BRIDGE_URL", "\"$trezorBridgeUrlEnv\"")
  buildConfigField("boolean", "GEO", System.getenv("GEO")?.toBoolean()?.toString() ?: "true")
  buildConfigField("String", "LOCALES", "\"${bcp47Locales.joinToString(",")}\"")
  }
@@ -217,7 +221,7 @@ composeCompiler {
 }
 
 dependencies {
- implementation(fileTree("libs") { include("*.aar") })
+ implementation(fileTree("libs") { include("*.aar", "*.jar") })
  implementation(libs.jna) { artifact { type = "aar" } }
  implementation(platform(libs.kotlin.bom))
  implementation(libs.core.ktx)

app/proguard-rules.pro

@@ -18,4 +18,11 @@
 
 # If you keep the line number information, uncomment this to
 # hide the original source file name.
-#-renamesourcefileattribute SourceFile
+#-renamesourcefileattribute SourceFile
+
+# btleplug (droidplug) Android Bluetooth support
+# These classes are loaded via JNI from Rust code
+-keep class com.nonpolynomial.btleplug.** { *; }
+
+# jni-utils support library for btleplug
+-keep class io.github.gedgygedgy.rust.** { *; }

app/src/main/AndroidManifest.xml

@@ -26,6 +26,25 @@
  android:name="android.permission.FOREGROUND_SERVICE"
  tools:ignore="ForegroundServicePermission,ForegroundServicesPolicy" />
  <uses-permission android:name="android.permission.FOREGROUND_SERVICE_DATA_SYNC" />
+
+ <!-- USB Host support for Trezor hardware wallet -->
+ <uses-feature
+ android:name="android.hardware.usb.host"
+ android:required="false" />
+
+ <!-- Bluetooth permissions for Trezor Safe 7 (Android 12+) -->
+ <uses-permission android:name="android.permission.BLUETOOTH_CONNECT" />
+ <uses-permission android:name="android.permission.BLUETOOTH_SCAN"
+ android:usesPermissionFlags="neverForLocation" />
+
+ <!-- Bluetooth permissions (legacy, Android 11 and below) -->
+ <uses-permission android:name="android.permission.BLUETOOTH"
+ android:maxSdkVersion="30" />
+ <uses-permission android:name="android.permission.BLUETOOTH_ADMIN"
+ android:maxSdkVersion="30" />
+ <uses-permission android:name="android.permission.ACCESS_FINE_LOCATION"
+ android:maxSdkVersion="30" />
+
  <!-- Required for E2E tests connecting to local Electrum server (Android 16+) -->
  <uses-permission
  android:name="android.permission.NEARBY_WIFI_DEVICES"
@@ -132,6 +151,14 @@
  <data android:scheme="lnurlp" />
  </intent-filter>
 
+ <!-- USB device attached — auto-grants permission when Trezor is plugged in -->
+ <intent-filter>
+ <action android:name="android.hardware.usb.action.USB_DEVICE_ATTACHED" />
+ </intent-filter>
+ <meta-data
+ android:name="android.hardware.usb.action.USB_DEVICE_ATTACHED"
+ android:resource="@xml/usb_device_filter" />
+
  <meta-data
  android:name="android.app.shortcuts"
  android:resource="@xml/shortcuts" />

app/src/main/java/to/bitkit/App.kt

@@ -11,6 +11,7 @@ import coil3.ImageLoader
 import coil3.SingletonImageLoader
 import dagger.hilt.android.HiltAndroidApp
 import to.bitkit.env.Env
+import to.bitkit.services.BluetoothInit
 import javax.inject.Inject
 
 @HiltAndroidApp
@@ -31,6 +32,8 @@ internal open class App : Application(), Configuration.Provider {
  SingletonImageLoader.setSafe { imageLoader }
  currentActivity = CurrentActivity().also { registerActivityLifecycleCallbacks(it) }
  Env.initAppStoragePath(filesDir.absolutePath)
+ // Initialize btleplug for Bluetooth support (required before any BLE usage)
+ BluetoothInit.ensureInitialized()
  }
 
  companion object {

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

@@ -0,0 +1,43 @@
+package to.bitkit.data
+
+import android.content.Context
+import androidx.datastore.core.DataStore
+import androidx.datastore.dataStore
+import dagger.hilt.android.qualifiers.ApplicationContext
+import kotlinx.coroutines.flow.Flow
+import kotlinx.coroutines.flow.first
+import kotlinx.serialization.Serializable
+import to.bitkit.data.serializers.TrezorDataSerializer
+import to.bitkit.repositories.KnownDevice
+import javax.inject.Inject
+import javax.inject.Singleton
+
+private val Context.trezorDataStore: DataStore<TrezorData> by dataStore(
+ fileName = "trezor_device.json",
+ serializer = TrezorDataSerializer
+)
+
+@Singleton
+class TrezorStore @Inject constructor(
+ @ApplicationContext private val context: Context,
+) {
+ private val store = context.trezorDataStore
+
+ val data: Flow<TrezorData> = store.data
+
+ suspend fun loadKnownDevices(): List<KnownDevice> =
+ store.data.first().knownDevices
+
+ suspend fun saveKnownDevices(devices: List<KnownDevice>) {
+ store.updateData { it.copy(knownDevices = devices) }
+ }
+
+ suspend fun reset() {
+ store.updateData { TrezorData() }
+ }
+}
+
+@Serializable
+data class TrezorData(
+ val knownDevices: List<KnownDevice> = emptyList(),
+)

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

@@ -0,0 +1,26 @@
+package to.bitkit.data.serializers
+
+import androidx.datastore.core.Serializer
+import kotlinx.serialization.SerializationException
+import to.bitkit.data.TrezorData
+import to.bitkit.di.json
+import to.bitkit.utils.Logger
+import java.io.InputStream
+import java.io.OutputStream
+
+object TrezorDataSerializer : Serializer<TrezorData> {
+ override val defaultValue: TrezorData = TrezorData()
+
+ override suspend fun readFrom(input: InputStream): TrezorData {
+ return try {
+ json.decodeFromString(input.readBytes().decodeToString())
+ } catch (e: SerializationException) {
+ Logger.error("Failed to deserialize: $e")
+ defaultValue
+ }
+ }
+
+ override suspend fun writeTo(t: TrezorData, output: OutputStream) {
+ output.write(json.encodeToString(t).encodeToByteArray())
+ }
+}

app/src/main/java/to/bitkit/env/Env.kt

@@ -13,6 +13,7 @@ import to.bitkit.models.NodePeer
 import to.bitkit.utils.Logger
 import java.io.File
 import kotlin.io.path.Path
+import com.synonym.bitkitcore.Network as BitkitCoreNetwork
 
 @Suppress("ConstPropertyName", "KotlinConstantConditions", "SimplifyBooleanWithConstants")
 internal object Env {
@@ -199,6 +200,17 @@ internal object Env {
  else -> "https://bitkit.stag0.blocktank.to/backups-ldk"
  }
 
+ fun electrumUrlForNetwork(network: BitkitCoreNetwork): String {
+ val isE2eLocal = isE2eTest && e2eBackend == "local"
+ return when (network) {
+ BitkitCoreNetwork.BITCOIN -> ElectrumServers.MAINNET.ESPLORA
+ BitkitCoreNetwork.TESTNET, BitkitCoreNetwork.TESTNET4, BitkitCoreNetwork.SIGNET ->
+ ElectrumServers.TESTNET
+ BitkitCoreNetwork.REGTEST ->
+ if (isE2eLocal) ElectrumServers.REGTEST.LOCAL else ElectrumServers.REGTEST.STAG
+ }
+ }
+
  // endregion
 
  // region paths

app/src/main/java/to/bitkit/ext/Context.kt

@@ -3,13 +3,15 @@ package to.bitkit.ext
 import android.app.Activity
 import android.app.ActivityManager
 import android.app.NotificationManager
+import android.bluetooth.BluetoothManager
 import android.content.ClipData
 import android.content.ClipboardManager
 import android.content.Context
 import android.content.Context.NOTIFICATION_SERVICE
 import android.content.ContextWrapper
 import android.content.Intent
 import android.content.pm.PackageManager.PERMISSION_GRANTED
+import android.hardware.usb.UsbManager
 import android.provider.Settings
 import androidx.core.app.NotificationManagerCompat
 import androidx.core.content.ContextCompat
@@ -31,6 +33,12 @@ val Context.clipboardManager: ClipboardManager
 val Context.activityManager: ActivityManager
  get() = getSystemService(Context.ACTIVITY_SERVICE) as ActivityManager
 
+val Context.usbManager: UsbManager
+ get() = getSystemService(Context.USB_SERVICE) as UsbManager
+
+val Context.bluetoothManager: BluetoothManager
+ get() = getSystemService(Context.BLUETOOTH_SERVICE) as BluetoothManager
+
 // Permissions
 
 fun Context.requiresPermission(permission: String): Boolean =

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

@@ -1,6 +1,7 @@
 package to.bitkit.models
 
 import com.synonym.bitkitcore.NetworkType
+import com.synonym.bitkitcore.TrezorCoinType
 import org.lightningdevkit.ldknode.Network
 import com.synonym.bitkitcore.Network as BitkitCoreNetwork
 
@@ -11,6 +12,13 @@ fun Network.networkUiText(): String = when (this) {
  Network.REGTEST -> "Regtest"
 }
 
+fun Network.toTrezorCoinType(): TrezorCoinType = when (this) {
+ Network.BITCOIN -> TrezorCoinType.BITCOIN
+ Network.TESTNET -> TrezorCoinType.TESTNET
+ Network.SIGNET -> TrezorCoinType.SIGNET
+ Network.REGTEST -> TrezorCoinType.REGTEST
+}
+
 fun Network.toCoreNetwork(): BitkitCoreNetwork = when (this) {
  Network.BITCOIN -> BitkitCoreNetwork.BITCOIN
  Network.TESTNET -> BitkitCoreNetwork.TESTNET
@@ -31,3 +39,11 @@ fun NetworkType.toLdkNetwork(): Network = when (this) {
  NetworkType.SIGNET -> Network.SIGNET
  NetworkType.REGTEST -> Network.REGTEST
 }
+
+fun BitkitCoreNetwork.toTrezorCoinType(): TrezorCoinType = when (this) {
+ BitkitCoreNetwork.BITCOIN -> TrezorCoinType.BITCOIN
+ BitkitCoreNetwork.TESTNET -> TrezorCoinType.TESTNET
+ BitkitCoreNetwork.TESTNET4 -> TrezorCoinType.TESTNET
+ BitkitCoreNetwork.SIGNET -> TrezorCoinType.SIGNET
+ BitkitCoreNetwork.REGTEST -> TrezorCoinType.REGTEST
+}

app/build.gradle.kts

@@ -48,6 +48,8 @@ val bcp47Locales = listOf(
 )
 val e2eBackendEnv = System.getenv("E2E_BACKEND") ?: "local"
 val e2eHomegateUrlEnv = System.getenv("E2E_HOMEGATE_URL") ?: "http://127.0.0.1:6288"
+val trezorBridgeEnv = System.getenv("TREZOR_BRIDGE")?.toBoolean()?.toString() ?: "false"
+val trezorBridgeUrlEnv = System.getenv("TREZOR_BRIDGE_URL") ?: "http://10.0.2.2:21325"
 
 android {
  namespace = "to.bitkit"
@@ -65,6 +67,8 @@ android {
  buildConfigField("boolean", "E2E", System.getenv("E2E")?.toBoolean()?.toString() ?: "false")
  buildConfigField("String", "E2E_BACKEND", "\"$e2eBackendEnv\"")
  buildConfigField("String", "E2E_HOMEGATE_URL", "\"$e2eHomegateUrlEnv\"")
+ buildConfigField("boolean", "TREZOR_BRIDGE", trezorBridgeEnv)
+ buildConfigField("String", "TREZOR_BRIDGE_URL", "\"$trezorBridgeUrlEnv\"")
  buildConfigField("boolean", "GEO", System.getenv("GEO")?.toBoolean()?.toString() ?: "true")
  buildConfigField("String", "LOCALES", "\"${bcp47Locales.joinToString(",")}\"")
  }
@@ -217,7 +221,7 @@ composeCompiler {
 }
 
 dependencies {
- implementation(fileTree("libs") { include("*.aar") })
+ implementation(fileTree("libs") { include("*.aar", "*.jar") })
  implementation(libs.jna) { artifact { type = "aar" } }
  implementation(platform(libs.kotlin.bom))
  implementation(libs.core.ktx)

app/proguard-rules.pro

@@ -18,4 +18,11 @@
 
 # If you keep the line number information, uncomment this to
 # hide the original source file name.
-#-renamesourcefileattribute SourceFile
+#-renamesourcefileattribute SourceFile
+
+# btleplug (droidplug) Android Bluetooth support
+# These classes are loaded via JNI from Rust code
+-keep class com.nonpolynomial.btleplug.** { *; }
+
+# jni-utils support library for btleplug
+-keep class io.github.gedgygedgy.rust.** { *; }

app/src/main/AndroidManifest.xml

@@ -26,6 +26,25 @@
  android:name="android.permission.FOREGROUND_SERVICE"
  tools:ignore="ForegroundServicePermission,ForegroundServicesPolicy" />
  <uses-permission android:name="android.permission.FOREGROUND_SERVICE_DATA_SYNC" />
+
+ <!-- USB Host support for Trezor hardware wallet -->
+ <uses-feature
+ android:name="android.hardware.usb.host"
+ android:required="false" />
+
+ <!-- Bluetooth permissions for Trezor Safe 7 (Android 12+) -->
+ <uses-permission android:name="android.permission.BLUETOOTH_CONNECT" />
+ <uses-permission android:name="android.permission.BLUETOOTH_SCAN"
+ android:usesPermissionFlags="neverForLocation" />
+
+ <!-- Bluetooth permissions (legacy, Android 11 and below) -->
+ <uses-permission android:name="android.permission.BLUETOOTH"
+ android:maxSdkVersion="30" />
+ <uses-permission android:name="android.permission.BLUETOOTH_ADMIN"
+ android:maxSdkVersion="30" />
+ <uses-permission android:name="android.permission.ACCESS_FINE_LOCATION"
+ android:maxSdkVersion="30" />
+
  <!-- Required for E2E tests connecting to local Electrum server (Android 16+) -->
  <uses-permission
  android:name="android.permission.NEARBY_WIFI_DEVICES"
@@ -132,6 +151,14 @@
  <data android:scheme="lnurlp" />
  </intent-filter>
 
+ <!-- USB device attached — auto-grants permission when Trezor is plugged in -->
+ <intent-filter>
+ <action android:name="android.hardware.usb.action.USB_DEVICE_ATTACHED" />
+ </intent-filter>
+ <meta-data
+ android:name="android.hardware.usb.action.USB_DEVICE_ATTACHED"
+ android:resource="@xml/usb_device_filter" />
+
  <meta-data
  android:name="android.app.shortcuts"
  android:resource="@xml/shortcuts" />

app/src/main/java/to/bitkit/App.kt

@@ -11,6 +11,7 @@ import coil3.ImageLoader
 import coil3.SingletonImageLoader
 import dagger.hilt.android.HiltAndroidApp
 import to.bitkit.env.Env
+import to.bitkit.services.BluetoothInit
 import javax.inject.Inject
 
 @HiltAndroidApp
@@ -31,6 +32,8 @@ internal open class App : Application(), Configuration.Provider {
  SingletonImageLoader.setSafe { imageLoader }
  currentActivity = CurrentActivity().also { registerActivityLifecycleCallbacks(it) }
  Env.initAppStoragePath(filesDir.absolutePath)
+ // Initialize btleplug for Bluetooth support (required before any BLE usage)
+ BluetoothInit.ensureInitialized()
  }
 
  companion object {

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

@@ -0,0 +1,43 @@
+package to.bitkit.data
+
+import android.content.Context
+import androidx.datastore.core.DataStore
+import androidx.datastore.dataStore
+import dagger.hilt.android.qualifiers.ApplicationContext
+import kotlinx.coroutines.flow.Flow
+import kotlinx.coroutines.flow.first
+import kotlinx.serialization.Serializable
+import to.bitkit.data.serializers.TrezorDataSerializer
+import to.bitkit.repositories.KnownDevice
+import javax.inject.Inject
+import javax.inject.Singleton
+
+private val Context.trezorDataStore: DataStore<TrezorData> by dataStore(
+ fileName = "trezor_device.json",
+ serializer = TrezorDataSerializer
+)
+
+@Singleton
+class TrezorStore @Inject constructor(
+ @ApplicationContext private val context: Context,
+) {
+ private val store = context.trezorDataStore
+
+ val data: Flow<TrezorData> = store.data
+
+ suspend fun loadKnownDevices(): List<KnownDevice> =
+ store.data.first().knownDevices
+
+ suspend fun saveKnownDevices(devices: List<KnownDevice>) {
+ store.updateData { it.copy(knownDevices = devices) }
+ }
+
+ suspend fun reset() {
+ store.updateData { TrezorData() }
+ }
+}
+
+@Serializable
+data class TrezorData(
+ val knownDevices: List<KnownDevice> = emptyList(),
+)

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

@@ -0,0 +1,26 @@
+package to.bitkit.data.serializers
+
+import androidx.datastore.core.Serializer
+import kotlinx.serialization.SerializationException
+import to.bitkit.data.TrezorData
+import to.bitkit.di.json
+import to.bitkit.utils.Logger
+import java.io.InputStream
+import java.io.OutputStream
+
+object TrezorDataSerializer : Serializer<TrezorData> {
+ override val defaultValue: TrezorData = TrezorData()
+
+ override suspend fun readFrom(input: InputStream): TrezorData {
+ return try {
+ json.decodeFromString(input.readBytes().decodeToString())
+ } catch (e: SerializationException) {
+ Logger.error("Failed to deserialize: $e")
+ defaultValue
+ }
+ }
+
+ override suspend fun writeTo(t: TrezorData, output: OutputStream) {
+ output.write(json.encodeToString(t).encodeToByteArray())
+ }
+}

app/src/main/java/to/bitkit/env/Env.kt

@@ -13,6 +13,7 @@ import to.bitkit.models.NodePeer
 import to.bitkit.utils.Logger
 import java.io.File
 import kotlin.io.path.Path
+import com.synonym.bitkitcore.Network as BitkitCoreNetwork
 
 @Suppress("ConstPropertyName", "KotlinConstantConditions", "SimplifyBooleanWithConstants")
 internal object Env {
@@ -199,6 +200,17 @@ internal object Env {
  else -> "https://bitkit.stag0.blocktank.to/backups-ldk"
  }
 
+ fun electrumUrlForNetwork(network: BitkitCoreNetwork): String {
+ val isE2eLocal = isE2eTest && e2eBackend == "local"
+ return when (network) {
+ BitkitCoreNetwork.BITCOIN -> ElectrumServers.MAINNET.ESPLORA
+ BitkitCoreNetwork.TESTNET, BitkitCoreNetwork.TESTNET4, BitkitCoreNetwork.SIGNET ->
+ ElectrumServers.TESTNET
+ BitkitCoreNetwork.REGTEST ->
+ if (isE2eLocal) ElectrumServers.REGTEST.LOCAL else ElectrumServers.REGTEST.STAG
+ }
+ }
+
  // endregion
 
  // region paths

app/src/main/java/to/bitkit/ext/Context.kt

@@ -3,13 +3,15 @@ package to.bitkit.ext
 import android.app.Activity
 import android.app.ActivityManager
 import android.app.NotificationManager
+import android.bluetooth.BluetoothManager
 import android.content.ClipData
 import android.content.ClipboardManager
 import android.content.Context
 import android.content.Context.NOTIFICATION_SERVICE
 import android.content.ContextWrapper
 import android.content.Intent
 import android.content.pm.PackageManager.PERMISSION_GRANTED
+import android.hardware.usb.UsbManager
 import android.provider.Settings
 import androidx.core.app.NotificationManagerCompat
 import androidx.core.content.ContextCompat
@@ -31,6 +33,12 @@ val Context.clipboardManager: ClipboardManager
 val Context.activityManager: ActivityManager
  get() = getSystemService(Context.ACTIVITY_SERVICE) as ActivityManager
 
+val Context.usbManager: UsbManager
+ get() = getSystemService(Context.USB_SERVICE) as UsbManager
+
+val Context.bluetoothManager: BluetoothManager
+ get() = getSystemService(Context.BLUETOOTH_SERVICE) as BluetoothManager
+
 // Permissions
 
 fun Context.requiresPermission(permission: String): Boolean =

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

@@ -1,6 +1,7 @@
 package to.bitkit.models
 
 import com.synonym.bitkitcore.NetworkType
+import com.synonym.bitkitcore.TrezorCoinType
 import org.lightningdevkit.ldknode.Network
 import com.synonym.bitkitcore.Network as BitkitCoreNetwork
 
@@ -11,6 +12,13 @@ fun Network.networkUiText(): String = when (this) {
  Network.REGTEST -> "Regtest"
 }
 
+fun Network.toTrezorCoinType(): TrezorCoinType = when (this) {
+ Network.BITCOIN -> TrezorCoinType.BITCOIN
+ Network.TESTNET -> TrezorCoinType.TESTNET
+ Network.SIGNET -> TrezorCoinType.SIGNET
+ Network.REGTEST -> TrezorCoinType.REGTEST
+}
+
 fun Network.toCoreNetwork(): BitkitCoreNetwork = when (this) {
  Network.BITCOIN -> BitkitCoreNetwork.BITCOIN
  Network.TESTNET -> BitkitCoreNetwork.TESTNET
@@ -31,3 +39,11 @@ fun NetworkType.toLdkNetwork(): Network = when (this) {
  NetworkType.SIGNET -> Network.SIGNET
  NetworkType.REGTEST -> Network.REGTEST
 }
+
+fun BitkitCoreNetwork.toTrezorCoinType(): TrezorCoinType = when (this) {
+ BitkitCoreNetwork.BITCOIN -> TrezorCoinType.BITCOIN
+ BitkitCoreNetwork.TESTNET -> TrezorCoinType.TESTNET
+ BitkitCoreNetwork.TESTNET4 -> TrezorCoinType.TESTNET
+ BitkitCoreNetwork.SIGNET -> TrezorCoinType.SIGNET
+ BitkitCoreNetwork.REGTEST -> TrezorCoinType.REGTEST
+}

app/build.gradle.kts

@@ -48,6 +48,8 @@ val bcp47Locales = listOf(
 )
 val e2eBackendEnv = System.getenv("E2E_BACKEND") ?: "local"
 val e2eHomegateUrlEnv = System.getenv("E2E_HOMEGATE_URL") ?: "http://127.0.0.1:6288"
+val trezorBridgeEnv = System.getenv("TREZOR_BRIDGE")?.toBoolean()?.toString() ?: "false"
+val trezorBridgeUrlEnv = System.getenv("TREZOR_BRIDGE_URL") ?: "http://10.0.2.2:21325"
 
 android {
  namespace = "to.bitkit"
@@ -65,6 +67,8 @@ android {
  buildConfigField("boolean", "E2E", System.getenv("E2E")?.toBoolean()?.toString() ?: "false")
  buildConfigField("String", "E2E_BACKEND", "\"$e2eBackendEnv\"")
  buildConfigField("String", "E2E_HOMEGATE_URL", "\"$e2eHomegateUrlEnv\"")
+ buildConfigField("boolean", "TREZOR_BRIDGE", trezorBridgeEnv)
+ buildConfigField("String", "TREZOR_BRIDGE_URL", "\"$trezorBridgeUrlEnv\"")
  buildConfigField("boolean", "GEO", System.getenv("GEO")?.toBoolean()?.toString() ?: "true")
  buildConfigField("String", "LOCALES", "\"${bcp47Locales.joinToString(",")}\"")
  }
@@ -217,7 +221,7 @@ composeCompiler {
 }
 
 dependencies {
- implementation(fileTree("libs") { include("*.aar") })
+ implementation(fileTree("libs") { include("*.aar", "*.jar") })
  implementation(libs.jna) { artifact { type = "aar" } }
  implementation(platform(libs.kotlin.bom))
  implementation(libs.core.ktx)

app/proguard-rules.pro

@@ -18,4 +18,11 @@
 
 # If you keep the line number information, uncomment this to
 # hide the original source file name.
-#-renamesourcefileattribute SourceFile
+#-renamesourcefileattribute SourceFile
+
+# btleplug (droidplug) Android Bluetooth support
+# These classes are loaded via JNI from Rust code
+-keep class com.nonpolynomial.btleplug.** { *; }
+
+# jni-utils support library for btleplug
+-keep class io.github.gedgygedgy.rust.** { *; }

app/src/main/AndroidManifest.xml

@@ -26,6 +26,25 @@
  android:name="android.permission.FOREGROUND_SERVICE"
  tools:ignore="ForegroundServicePermission,ForegroundServicesPolicy" />
  <uses-permission android:name="android.permission.FOREGROUND_SERVICE_DATA_SYNC" />
+
+ <!-- USB Host support for Trezor hardware wallet -->
+ <uses-feature
+ android:name="android.hardware.usb.host"
+ android:required="false" />
+
+ <!-- Bluetooth permissions for Trezor Safe 7 (Android 12+) -->
+ <uses-permission android:name="android.permission.BLUETOOTH_CONNECT" />
+ <uses-permission android:name="android.permission.BLUETOOTH_SCAN"
+ android:usesPermissionFlags="neverForLocation" />
+
+ <!-- Bluetooth permissions (legacy, Android 11 and below) -->
+ <uses-permission android:name="android.permission.BLUETOOTH"
+ android:maxSdkVersion="30" />
+ <uses-permission android:name="android.permission.BLUETOOTH_ADMIN"
+ android:maxSdkVersion="30" />
+ <uses-permission android:name="android.permission.ACCESS_FINE_LOCATION"
+ android:maxSdkVersion="30" />
+
  <!-- Required for E2E tests connecting to local Electrum server (Android 16+) -->
  <uses-permission
  android:name="android.permission.NEARBY_WIFI_DEVICES"
@@ -132,6 +151,14 @@
  <data android:scheme="lnurlp" />
  </intent-filter>
 
+ <!-- USB device attached — auto-grants permission when Trezor is plugged in -->
+ <intent-filter>
+ <action android:name="android.hardware.usb.action.USB_DEVICE_ATTACHED" />
+ </intent-filter>
+ <meta-data
+ android:name="android.hardware.usb.action.USB_DEVICE_ATTACHED"
+ android:resource="@xml/usb_device_filter" />
+
  <meta-data
  android:name="android.app.shortcuts"
  android:resource="@xml/shortcuts" />

app/src/main/java/to/bitkit/App.kt

@@ -11,6 +11,7 @@ import coil3.ImageLoader
 import coil3.SingletonImageLoader
 import dagger.hilt.android.HiltAndroidApp
 import to.bitkit.env.Env
+import to.bitkit.services.BluetoothInit
 import javax.inject.Inject
 
 @HiltAndroidApp
@@ -31,6 +32,8 @@ internal open class App : Application(), Configuration.Provider {
  SingletonImageLoader.setSafe { imageLoader }
  currentActivity = CurrentActivity().also { registerActivityLifecycleCallbacks(it) }
  Env.initAppStoragePath(filesDir.absolutePath)
+ // Initialize btleplug for Bluetooth support (required before any BLE usage)
+ BluetoothInit.ensureInitialized()
  }
 
  companion object {

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

@@ -0,0 +1,43 @@
+package to.bitkit.data
+
+import android.content.Context
+import androidx.datastore.core.DataStore
+import androidx.datastore.dataStore
+import dagger.hilt.android.qualifiers.ApplicationContext
+import kotlinx.coroutines.flow.Flow
+import kotlinx.coroutines.flow.first
+import kotlinx.serialization.Serializable
+import to.bitkit.data.serializers.TrezorDataSerializer
+import to.bitkit.repositories.KnownDevice
+import javax.inject.Inject
+import javax.inject.Singleton
+
+private val Context.trezorDataStore: DataStore<TrezorData> by dataStore(
+ fileName = "trezor_device.json",
+ serializer = TrezorDataSerializer
+)
+
+@Singleton
+class TrezorStore @Inject constructor(
+ @ApplicationContext private val context: Context,
+) {
+ private val store = context.trezorDataStore
+
+ val data: Flow<TrezorData> = store.data
+
+ suspend fun loadKnownDevices(): List<KnownDevice> =
+ store.data.first().knownDevices
+
+ suspend fun saveKnownDevices(devices: List<KnownDevice>) {
+ store.updateData { it.copy(knownDevices = devices) }
+ }
+
+ suspend fun reset() {
+ store.updateData { TrezorData() }
+ }
+}
+
+@Serializable
+data class TrezorData(
+ val knownDevices: List<KnownDevice> = emptyList(),
+)

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

@@ -0,0 +1,26 @@
+package to.bitkit.data.serializers
+
+import androidx.datastore.core.Serializer
+import kotlinx.serialization.SerializationException
+import to.bitkit.data.TrezorData
+import to.bitkit.di.json
+import to.bitkit.utils.Logger
+import java.io.InputStream
+import java.io.OutputStream
+
+object TrezorDataSerializer : Serializer<TrezorData> {
+ override val defaultValue: TrezorData = TrezorData()
+
+ override suspend fun readFrom(input: InputStream): TrezorData {
+ return try {
+ json.decodeFromString(input.readBytes().decodeToString())
+ } catch (e: SerializationException) {
+ Logger.error("Failed to deserialize: $e")
+ defaultValue
+ }
+ }
+
+ override suspend fun writeTo(t: TrezorData, output: OutputStream) {
+ output.write(json.encodeToString(t).encodeToByteArray())
+ }
+}

app/src/main/java/to/bitkit/env/Env.kt

@@ -13,6 +13,7 @@ import to.bitkit.models.NodePeer
 import to.bitkit.utils.Logger
 import java.io.File
 import kotlin.io.path.Path
+import com.synonym.bitkitcore.Network as BitkitCoreNetwork
 
 @Suppress("ConstPropertyName", "KotlinConstantConditions", "SimplifyBooleanWithConstants")
 internal object Env {
@@ -199,6 +200,17 @@ internal object Env {
  else -> "https://bitkit.stag0.blocktank.to/backups-ldk"
  }
 
+ fun electrumUrlForNetwork(network: BitkitCoreNetwork): String {
+ val isE2eLocal = isE2eTest && e2eBackend == "local"
+ return when (network) {
+ BitkitCoreNetwork.BITCOIN -> ElectrumServers.MAINNET.ESPLORA
+ BitkitCoreNetwork.TESTNET, BitkitCoreNetwork.TESTNET4, BitkitCoreNetwork.SIGNET ->
+ ElectrumServers.TESTNET
+ BitkitCoreNetwork.REGTEST ->
+ if (isE2eLocal) ElectrumServers.REGTEST.LOCAL else ElectrumServers.REGTEST.STAG
+ }
+ }
+
  // endregion
 
  // region paths

app/src/main/java/to/bitkit/ext/Context.kt

@@ -3,13 +3,15 @@ package to.bitkit.ext
 import android.app.Activity
 import android.app.ActivityManager
 import android.app.NotificationManager
+import android.bluetooth.BluetoothManager
 import android.content.ClipData
 import android.content.ClipboardManager
 import android.content.Context
 import android.content.Context.NOTIFICATION_SERVICE
 import android.content.ContextWrapper
 import android.content.Intent
 import android.content.pm.PackageManager.PERMISSION_GRANTED
+import android.hardware.usb.UsbManager
 import android.provider.Settings
 import androidx.core.app.NotificationManagerCompat
 import androidx.core.content.ContextCompat
@@ -31,6 +33,12 @@ val Context.clipboardManager: ClipboardManager
 val Context.activityManager: ActivityManager
  get() = getSystemService(Context.ACTIVITY_SERVICE) as ActivityManager
 
+val Context.usbManager: UsbManager
+ get() = getSystemService(Context.USB_SERVICE) as UsbManager
+
+val Context.bluetoothManager: BluetoothManager
+ get() = getSystemService(Context.BLUETOOTH_SERVICE) as BluetoothManager
+
 // Permissions
 
 fun Context.requiresPermission(permission: String): Boolean =

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

@@ -1,6 +1,7 @@
 package to.bitkit.models
 
 import com.synonym.bitkitcore.NetworkType
+import com.synonym.bitkitcore.TrezorCoinType
 import org.lightningdevkit.ldknode.Network
 import com.synonym.bitkitcore.Network as BitkitCoreNetwork
 
@@ -11,6 +12,13 @@ fun Network.networkUiText(): String = when (this) {
  Network.REGTEST -> "Regtest"
 }
 
+fun Network.toTrezorCoinType(): TrezorCoinType = when (this) {
+ Network.BITCOIN -> TrezorCoinType.BITCOIN
+ Network.TESTNET -> TrezorCoinType.TESTNET
+ Network.SIGNET -> TrezorCoinType.SIGNET
+ Network.REGTEST -> TrezorCoinType.REGTEST
+}
+
 fun Network.toCoreNetwork(): BitkitCoreNetwork = when (this) {
  Network.BITCOIN -> BitkitCoreNetwork.BITCOIN
  Network.TESTNET -> BitkitCoreNetwork.TESTNET
@@ -31,3 +39,11 @@ fun NetworkType.toLdkNetwork(): Network = when (this) {
  NetworkType.SIGNET -> Network.SIGNET
  NetworkType.REGTEST -> Network.REGTEST
 }
+
+fun BitkitCoreNetwork.toTrezorCoinType(): TrezorCoinType = when (this) {
+ BitkitCoreNetwork.BITCOIN -> TrezorCoinType.BITCOIN
+ BitkitCoreNetwork.TESTNET -> TrezorCoinType.TESTNET
+ BitkitCoreNetwork.TESTNET4 -> TrezorCoinType.TESTNET
+ BitkitCoreNetwork.SIGNET -> TrezorCoinType.SIGNET
+ BitkitCoreNetwork.REGTEST -> TrezorCoinType.REGTEST
+}

app/build.gradle.kts

@@ -48,6 +48,8 @@ val bcp47Locales = listOf(
 )
 val e2eBackendEnv = System.getenv("E2E_BACKEND") ?: "local"
 val e2eHomegateUrlEnv = System.getenv("E2E_HOMEGATE_URL") ?: "http://127.0.0.1:6288"
+val trezorBridgeEnv = System.getenv("TREZOR_BRIDGE")?.toBoolean()?.toString() ?: "false"
+val trezorBridgeUrlEnv = System.getenv("TREZOR_BRIDGE_URL") ?: "http://10.0.2.2:21325"
 
 android {
  namespace = "to.bitkit"
@@ -65,6 +67,8 @@ android {
  buildConfigField("boolean", "E2E", System.getenv("E2E")?.toBoolean()?.toString() ?: "false")
  buildConfigField("String", "E2E_BACKEND", "\"$e2eBackendEnv\"")
  buildConfigField("String", "E2E_HOMEGATE_URL", "\"$e2eHomegateUrlEnv\"")
+ buildConfigField("boolean", "TREZOR_BRIDGE", trezorBridgeEnv)
+ buildConfigField("String", "TREZOR_BRIDGE_URL", "\"$trezorBridgeUrlEnv\"")
  buildConfigField("boolean", "GEO", System.getenv("GEO")?.toBoolean()?.toString() ?: "true")
  buildConfigField("String", "LOCALES", "\"${bcp47Locales.joinToString(",")}\"")
  }
@@ -217,7 +221,7 @@ composeCompiler {
 }
 
 dependencies {
- implementation(fileTree("libs") { include("*.aar") })
+ implementation(fileTree("libs") { include("*.aar", "*.jar") })
  implementation(libs.jna) { artifact { type = "aar" } }
  implementation(platform(libs.kotlin.bom))
  implementation(libs.core.ktx)

app/proguard-rules.pro

@@ -18,4 +18,11 @@
 
 # If you keep the line number information, uncomment this to
 # hide the original source file name.
-#-renamesourcefileattribute SourceFile
+#-renamesourcefileattribute SourceFile
+
+# btleplug (droidplug) Android Bluetooth support
+# These classes are loaded via JNI from Rust code
+-keep class com.nonpolynomial.btleplug.** { *; }
+
+# jni-utils support library for btleplug
+-keep class io.github.gedgygedgy.rust.** { *; }

app/src/main/AndroidManifest.xml

@@ -26,6 +26,25 @@
  android:name="android.permission.FOREGROUND_SERVICE"
  tools:ignore="ForegroundServicePermission,ForegroundServicesPolicy" />
  <uses-permission android:name="android.permission.FOREGROUND_SERVICE_DATA_SYNC" />
+
+ <!-- USB Host support for Trezor hardware wallet -->
+ <uses-feature
+ android:name="android.hardware.usb.host"
+ android:required="false" />
+
+ <!-- Bluetooth permissions for Trezor Safe 7 (Android 12+) -->
+ <uses-permission android:name="android.permission.BLUETOOTH_CONNECT" />
+ <uses-permission android:name="android.permission.BLUETOOTH_SCAN"
+ android:usesPermissionFlags="neverForLocation" />
+
+ <!-- Bluetooth permissions (legacy, Android 11 and below) -->
+ <uses-permission android:name="android.permission.BLUETOOTH"
+ android:maxSdkVersion="30" />
+ <uses-permission android:name="android.permission.BLUETOOTH_ADMIN"
+ android:maxSdkVersion="30" />
+ <uses-permission android:name="android.permission.ACCESS_FINE_LOCATION"
+ android:maxSdkVersion="30" />
+
  <!-- Required for E2E tests connecting to local Electrum server (Android 16+) -->
  <uses-permission
  android:name="android.permission.NEARBY_WIFI_DEVICES"
@@ -132,6 +151,14 @@
  <data android:scheme="lnurlp" />
  </intent-filter>
 
+ <!-- USB device attached — auto-grants permission when Trezor is plugged in -->
+ <intent-filter>
+ <action android:name="android.hardware.usb.action.USB_DEVICE_ATTACHED" />
+ </intent-filter>
+ <meta-data
+ android:name="android.hardware.usb.action.USB_DEVICE_ATTACHED"
+ android:resource="@xml/usb_device_filter" />
+
  <meta-data
  android:name="android.app.shortcuts"
  android:resource="@xml/shortcuts" />

app/src/main/java/to/bitkit/App.kt

@@ -11,6 +11,7 @@ import coil3.ImageLoader
 import coil3.SingletonImageLoader
 import dagger.hilt.android.HiltAndroidApp
 import to.bitkit.env.Env
+import to.bitkit.services.BluetoothInit
 import javax.inject.Inject
 
 @HiltAndroidApp
@@ -31,6 +32,8 @@ internal open class App : Application(), Configuration.Provider {
  SingletonImageLoader.setSafe { imageLoader }
  currentActivity = CurrentActivity().also { registerActivityLifecycleCallbacks(it) }
  Env.initAppStoragePath(filesDir.absolutePath)
+ // Initialize btleplug for Bluetooth support (required before any BLE usage)
+ BluetoothInit.ensureInitialized()
  }
 
  companion object {

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

@@ -0,0 +1,43 @@
+package to.bitkit.data
+
+import android.content.Context
+import androidx.datastore.core.DataStore
+import androidx.datastore.dataStore
+import dagger.hilt.android.qualifiers.ApplicationContext
+import kotlinx.coroutines.flow.Flow
+import kotlinx.coroutines.flow.first
+import kotlinx.serialization.Serializable
+import to.bitkit.data.serializers.TrezorDataSerializer
+import to.bitkit.repositories.KnownDevice
+import javax.inject.Inject
+import javax.inject.Singleton
+
+private val Context.trezorDataStore: DataStore<TrezorData> by dataStore(
+ fileName = "trezor_device.json",
+ serializer = TrezorDataSerializer
+)
+
+@Singleton
+class TrezorStore @Inject constructor(
+ @ApplicationContext private val context: Context,
+) {
+ private val store = context.trezorDataStore
+
+ val data: Flow<TrezorData> = store.data
+
+ suspend fun loadKnownDevices(): List<KnownDevice> =
+ store.data.first().knownDevices
+
+ suspend fun saveKnownDevices(devices: List<KnownDevice>) {
+ store.updateData { it.copy(knownDevices = devices) }
+ }
+
+ suspend fun reset() {
+ store.updateData { TrezorData() }
+ }
+}
+
+@Serializable
+data class TrezorData(
+ val knownDevices: List<KnownDevice> = emptyList(),
+)

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

@@ -0,0 +1,26 @@
+package to.bitkit.data.serializers
+
+import androidx.datastore.core.Serializer
+import kotlinx.serialization.SerializationException
+import to.bitkit.data.TrezorData
+import to.bitkit.di.json
+import to.bitkit.utils.Logger
+import java.io.InputStream
+import java.io.OutputStream
+
+object TrezorDataSerializer : Serializer<TrezorData> {
+ override val defaultValue: TrezorData = TrezorData()
+
+ override suspend fun readFrom(input: InputStream): TrezorData {
+ return try {
+ json.decodeFromString(input.readBytes().decodeToString())
+ } catch (e: SerializationException) {
+ Logger.error("Failed to deserialize: $e")
+ defaultValue
+ }
+ }
+
+ override suspend fun writeTo(t: TrezorData, output: OutputStream) {
+ output.write(json.encodeToString(t).encodeToByteArray())
+ }
+}

app/src/main/java/to/bitkit/env/Env.kt

@@ -13,6 +13,7 @@ import to.bitkit.models.NodePeer
 import to.bitkit.utils.Logger
 import java.io.File
 import kotlin.io.path.Path
+import com.synonym.bitkitcore.Network as BitkitCoreNetwork
 
 @Suppress("ConstPropertyName", "KotlinConstantConditions", "SimplifyBooleanWithConstants")
 internal object Env {
@@ -199,6 +200,17 @@ internal object Env {
  else -> "https://bitkit.stag0.blocktank.to/backups-ldk"
  }
 
+ fun electrumUrlForNetwork(network: BitkitCoreNetwork): String {
+ val isE2eLocal = isE2eTest && e2eBackend == "local"
+ return when (network) {
+ BitkitCoreNetwork.BITCOIN -> ElectrumServers.MAINNET.ESPLORA
+ BitkitCoreNetwork.TESTNET, BitkitCoreNetwork.TESTNET4, BitkitCoreNetwork.SIGNET ->
+ ElectrumServers.TESTNET
+ BitkitCoreNetwork.REGTEST ->
+ if (isE2eLocal) ElectrumServers.REGTEST.LOCAL else ElectrumServers.REGTEST.STAG
+ }
+ }
+
  // endregion
 
  // region paths

app/src/main/java/to/bitkit/ext/Context.kt

@@ -3,13 +3,15 @@ package to.bitkit.ext
 import android.app.Activity
 import android.app.ActivityManager
 import android.app.NotificationManager
+import android.bluetooth.BluetoothManager
 import android.content.ClipData
 import android.content.ClipboardManager
 import android.content.Context
 import android.content.Context.NOTIFICATION_SERVICE
 import android.content.ContextWrapper
 import android.content.Intent
 import android.content.pm.PackageManager.PERMISSION_GRANTED
+import android.hardware.usb.UsbManager
 import android.provider.Settings
 import androidx.core.app.NotificationManagerCompat
 import androidx.core.content.ContextCompat
@@ -31,6 +33,12 @@ val Context.clipboardManager: ClipboardManager
 val Context.activityManager: ActivityManager
  get() = getSystemService(Context.ACTIVITY_SERVICE) as ActivityManager
 
+val Context.usbManager: UsbManager
+ get() = getSystemService(Context.USB_SERVICE) as UsbManager
+
+val Context.bluetoothManager: BluetoothManager
+ get() = getSystemService(Context.BLUETOOTH_SERVICE) as BluetoothManager
+
 // Permissions
 
 fun Context.requiresPermission(permission: String): Boolean =

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

@@ -1,6 +1,7 @@
 package to.bitkit.models
 
 import com.synonym.bitkitcore.NetworkType
+import com.synonym.bitkitcore.TrezorCoinType
 import org.lightningdevkit.ldknode.Network
 import com.synonym.bitkitcore.Network as BitkitCoreNetwork
 
@@ -11,6 +12,13 @@ fun Network.networkUiText(): String = when (this) {
  Network.REGTEST -> "Regtest"
 }
 
+fun Network.toTrezorCoinType(): TrezorCoinType = when (this) {
+ Network.BITCOIN -> TrezorCoinType.BITCOIN
+ Network.TESTNET -> TrezorCoinType.TESTNET
+ Network.SIGNET -> TrezorCoinType.SIGNET
+ Network.REGTEST -> TrezorCoinType.REGTEST
+}
+
 fun Network.toCoreNetwork(): BitkitCoreNetwork = when (this) {
  Network.BITCOIN -> BitkitCoreNetwork.BITCOIN
  Network.TESTNET -> BitkitCoreNetwork.TESTNET
@@ -31,3 +39,11 @@ fun NetworkType.toLdkNetwork(): Network = when (this) {
  NetworkType.SIGNET -> Network.SIGNET
  NetworkType.REGTEST -> Network.REGTEST
 }
+
+fun BitkitCoreNetwork.toTrezorCoinType(): TrezorCoinType = when (this) {
+ BitkitCoreNetwork.BITCOIN -> TrezorCoinType.BITCOIN
+ BitkitCoreNetwork.TESTNET -> TrezorCoinType.TESTNET
+ BitkitCoreNetwork.TESTNET4 -> TrezorCoinType.TESTNET
+ BitkitCoreNetwork.SIGNET -> TrezorCoinType.SIGNET
+ BitkitCoreNetwork.REGTEST -> TrezorCoinType.REGTEST
+}

app/build.gradle.kts

@@ -48,6 +48,8 @@ val bcp47Locales = listOf(
 )
 val e2eBackendEnv = System.getenv("E2E_BACKEND") ?: "local"
 val e2eHomegateUrlEnv = System.getenv("E2E_HOMEGATE_URL") ?: "http://127.0.0.1:6288"
+val trezorBridgeEnv = System.getenv("TREZOR_BRIDGE")?.toBoolean()?.toString() ?: "false"
+val trezorBridgeUrlEnv = System.getenv("TREZOR_BRIDGE_URL") ?: "http://10.0.2.2:21325"
 
 android {
  namespace = "to.bitkit"
@@ -65,6 +67,8 @@ android {
  buildConfigField("boolean", "E2E", System.getenv("E2E")?.toBoolean()?.toString() ?: "false")
  buildConfigField("String", "E2E_BACKEND", "\"$e2eBackendEnv\"")
  buildConfigField("String", "E2E_HOMEGATE_URL", "\"$e2eHomegateUrlEnv\"")
+ buildConfigField("boolean", "TREZOR_BRIDGE", trezorBridgeEnv)
+ buildConfigField("String", "TREZOR_BRIDGE_URL", "\"$trezorBridgeUrlEnv\"")
  buildConfigField("boolean", "GEO", System.getenv("GEO")?.toBoolean()?.toString() ?: "true")
  buildConfigField("String", "LOCALES", "\"${bcp47Locales.joinToString(",")}\"")
  }
@@ -217,7 +221,7 @@ composeCompiler {
 }
 
 dependencies {
- implementation(fileTree("libs") { include("*.aar") })
+ implementation(fileTree("libs") { include("*.aar", "*.jar") })
  implementation(libs.jna) { artifact { type = "aar" } }
  implementation(platform(libs.kotlin.bom))
  implementation(libs.core.ktx)

app/proguard-rules.pro

@@ -18,4 +18,11 @@
 
 # If you keep the line number information, uncomment this to
 # hide the original source file name.
-#-renamesourcefileattribute SourceFile
+#-renamesourcefileattribute SourceFile
+
+# btleplug (droidplug) Android Bluetooth support
+# These classes are loaded via JNI from Rust code
+-keep class com.nonpolynomial.btleplug.** { *; }
+
+# jni-utils support library for btleplug
+-keep class io.github.gedgygedgy.rust.** { *; }

app/src/main/AndroidManifest.xml

@@ -26,6 +26,25 @@
  android:name="android.permission.FOREGROUND_SERVICE"
  tools:ignore="ForegroundServicePermission,ForegroundServicesPolicy" />
  <uses-permission android:name="android.permission.FOREGROUND_SERVICE_DATA_SYNC" />
+
+ <!-- USB Host support for Trezor hardware wallet -->
+ <uses-feature
+ android:name="android.hardware.usb.host"
+ android:required="false" />
+
+ <!-- Bluetooth permissions for Trezor Safe 7 (Android 12+) -->
+ <uses-permission android:name="android.permission.BLUETOOTH_CONNECT" />
+ <uses-permission android:name="android.permission.BLUETOOTH_SCAN"
+ android:usesPermissionFlags="neverForLocation" />
+
+ <!-- Bluetooth permissions (legacy, Android 11 and below) -->
+ <uses-permission android:name="android.permission.BLUETOOTH"
+ android:maxSdkVersion="30" />
+ <uses-permission android:name="android.permission.BLUETOOTH_ADMIN"
+ android:maxSdkVersion="30" />
+ <uses-permission android:name="android.permission.ACCESS_FINE_LOCATION"
+ android:maxSdkVersion="30" />
+
  <!-- Required for E2E tests connecting to local Electrum server (Android 16+) -->
  <uses-permission
  android:name="android.permission.NEARBY_WIFI_DEVICES"
@@ -132,6 +151,14 @@
  <data android:scheme="lnurlp" />
  </intent-filter>
 
+ <!-- USB device attached — auto-grants permission when Trezor is plugged in -->
+ <intent-filter>
+ <action android:name="android.hardware.usb.action.USB_DEVICE_ATTACHED" />
+ </intent-filter>
+ <meta-data
+ android:name="android.hardware.usb.action.USB_DEVICE_ATTACHED"
+ android:resource="@xml/usb_device_filter" />
+
  <meta-data
  android:name="android.app.shortcuts"
  android:resource="@xml/shortcuts" />

app/src/main/java/to/bitkit/App.kt

@@ -11,6 +11,7 @@ import coil3.ImageLoader
 import coil3.SingletonImageLoader
 import dagger.hilt.android.HiltAndroidApp
 import to.bitkit.env.Env
+import to.bitkit.services.BluetoothInit
 import javax.inject.Inject
 
 @HiltAndroidApp
@@ -31,6 +32,8 @@ internal open class App : Application(), Configuration.Provider {
  SingletonImageLoader.setSafe { imageLoader }
  currentActivity = CurrentActivity().also { registerActivityLifecycleCallbacks(it) }
  Env.initAppStoragePath(filesDir.absolutePath)
+ // Initialize btleplug for Bluetooth support (required before any BLE usage)
+ BluetoothInit.ensureInitialized()
  }
 
  companion object {

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

@@ -0,0 +1,43 @@
+package to.bitkit.data
+
+import android.content.Context
+import androidx.datastore.core.DataStore
+import androidx.datastore.dataStore
+import dagger.hilt.android.qualifiers.ApplicationContext
+import kotlinx.coroutines.flow.Flow
+import kotlinx.coroutines.flow.first
+import kotlinx.serialization.Serializable
+import to.bitkit.data.serializers.TrezorDataSerializer
+import to.bitkit.repositories.KnownDevice
+import javax.inject.Inject
+import javax.inject.Singleton
+
+private val Context.trezorDataStore: DataStore<TrezorData> by dataStore(
+ fileName = "trezor_device.json",
+ serializer = TrezorDataSerializer
+)
+
+@Singleton
+class TrezorStore @Inject constructor(
+ @ApplicationContext private val context: Context,
+) {
+ private val store = context.trezorDataStore
+
+ val data: Flow<TrezorData> = store.data
+
+ suspend fun loadKnownDevices(): List<KnownDevice> =
+ store.data.first().knownDevices
+
+ suspend fun saveKnownDevices(devices: List<KnownDevice>) {
+ store.updateData { it.copy(knownDevices = devices) }
+ }
+
+ suspend fun reset() {
+ store.updateData { TrezorData() }
+ }
+}
+
+@Serializable
+data class TrezorData(
+ val knownDevices: List<KnownDevice> = emptyList(),
+)

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

@@ -0,0 +1,26 @@
+package to.bitkit.data.serializers
+
+import androidx.datastore.core.Serializer
+import kotlinx.serialization.SerializationException
+import to.bitkit.data.TrezorData
+import to.bitkit.di.json
+import to.bitkit.utils.Logger
+import java.io.InputStream
+import java.io.OutputStream
+
+object TrezorDataSerializer : Serializer<TrezorData> {
+ override val defaultValue: TrezorData = TrezorData()
+
+ override suspend fun readFrom(input: InputStream): TrezorData {
+ return try {
+ json.decodeFromString(input.readBytes().decodeToString())
+ } catch (e: SerializationException) {
+ Logger.error("Failed to deserialize: $e")
+ defaultValue
+ }
+ }
+
+ override suspend fun writeTo(t: TrezorData, output: OutputStream) {
+ output.write(json.encodeToString(t).encodeToByteArray())
+ }
+}

app/src/main/java/to/bitkit/env/Env.kt

@@ -13,6 +13,7 @@ import to.bitkit.models.NodePeer
 import to.bitkit.utils.Logger
 import java.io.File
 import kotlin.io.path.Path
+import com.synonym.bitkitcore.Network as BitkitCoreNetwork
 
 @Suppress("ConstPropertyName", "KotlinConstantConditions", "SimplifyBooleanWithConstants")
 internal object Env {
@@ -199,6 +200,17 @@ internal object Env {
  else -> "https://bitkit.stag0.blocktank.to/backups-ldk"
  }
 
+ fun electrumUrlForNetwork(network: BitkitCoreNetwork): String {
+ val isE2eLocal = isE2eTest && e2eBackend == "local"
+ return when (network) {
+ BitkitCoreNetwork.BITCOIN -> ElectrumServers.MAINNET.ESPLORA
+ BitkitCoreNetwork.TESTNET, BitkitCoreNetwork.TESTNET4, BitkitCoreNetwork.SIGNET ->
+ ElectrumServers.TESTNET
+ BitkitCoreNetwork.REGTEST ->
+ if (isE2eLocal) ElectrumServers.REGTEST.LOCAL else ElectrumServers.REGTEST.STAG
+ }
+ }
+
  // endregion
 
  // region paths

app/src/main/java/to/bitkit/ext/Context.kt

@@ -3,13 +3,15 @@ package to.bitkit.ext
 import android.app.Activity
 import android.app.ActivityManager
 import android.app.NotificationManager
+import android.bluetooth.BluetoothManager
 import android.content.ClipData
 import android.content.ClipboardManager
 import android.content.Context
 import android.content.Context.NOTIFICATION_SERVICE
 import android.content.ContextWrapper
 import android.content.Intent
 import android.content.pm.PackageManager.PERMISSION_GRANTED
+import android.hardware.usb.UsbManager
 import android.provider.Settings
 import androidx.core.app.NotificationManagerCompat
 import androidx.core.content.ContextCompat
@@ -31,6 +33,12 @@ val Context.clipboardManager: ClipboardManager
 val Context.activityManager: ActivityManager
  get() = getSystemService(Context.ACTIVITY_SERVICE) as ActivityManager
 
+val Context.usbManager: UsbManager
+ get() = getSystemService(Context.USB_SERVICE) as UsbManager
+
+val Context.bluetoothManager: BluetoothManager
+ get() = getSystemService(Context.BLUETOOTH_SERVICE) as BluetoothManager
+
 // Permissions
 
 fun Context.requiresPermission(permission: String): Boolean =

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

@@ -1,6 +1,7 @@
 package to.bitkit.models
 
 import com.synonym.bitkitcore.NetworkType
+import com.synonym.bitkitcore.TrezorCoinType
 import org.lightningdevkit.ldknode.Network
 import com.synonym.bitkitcore.Network as BitkitCoreNetwork
 
@@ -11,6 +12,13 @@ fun Network.networkUiText(): String = when (this) {
  Network.REGTEST -> "Regtest"
 }
 
+fun Network.toTrezorCoinType(): TrezorCoinType = when (this) {
+ Network.BITCOIN -> TrezorCoinType.BITCOIN
+ Network.TESTNET -> TrezorCoinType.TESTNET
+ Network.SIGNET -> TrezorCoinType.SIGNET
+ Network.REGTEST -> TrezorCoinType.REGTEST
+}
+
 fun Network.toCoreNetwork(): BitkitCoreNetwork = when (this) {
  Network.BITCOIN -> BitkitCoreNetwork.BITCOIN
  Network.TESTNET -> BitkitCoreNetwork.TESTNET
@@ -31,3 +39,11 @@ fun NetworkType.toLdkNetwork(): Network = when (this) {
  NetworkType.SIGNET -> Network.SIGNET
  NetworkType.REGTEST -> Network.REGTEST
 }
+
+fun BitkitCoreNetwork.toTrezorCoinType(): TrezorCoinType = when (this) {
+ BitkitCoreNetwork.BITCOIN -> TrezorCoinType.BITCOIN
+ BitkitCoreNetwork.TESTNET -> TrezorCoinType.TESTNET
+ BitkitCoreNetwork.TESTNET4 -> TrezorCoinType.TESTNET
+ BitkitCoreNetwork.SIGNET -> TrezorCoinType.SIGNET
+ BitkitCoreNetwork.REGTEST -> TrezorCoinType.REGTEST
+}

app/build.gradle.kts

@@ -48,6 +48,8 @@ val bcp47Locales = listOf(
 )
 val e2eBackendEnv = System.getenv("E2E_BACKEND") ?: "local"
 val e2eHomegateUrlEnv = System.getenv("E2E_HOMEGATE_URL") ?: "http://127.0.0.1:6288"
+val trezorBridgeEnv = System.getenv("TREZOR_BRIDGE")?.toBoolean()?.toString() ?: "false"
+val trezorBridgeUrlEnv = System.getenv("TREZOR_BRIDGE_URL") ?: "http://10.0.2.2:21325"
 
 android {
  namespace = "to.bitkit"
@@ -65,6 +67,8 @@ android {
  buildConfigField("boolean", "E2E", System.getenv("E2E")?.toBoolean()?.toString() ?: "false")
  buildConfigField("String", "E2E_BACKEND", "\"$e2eBackendEnv\"")
  buildConfigField("String", "E2E_HOMEGATE_URL", "\"$e2eHomegateUrlEnv\"")
+ buildConfigField("boolean", "TREZOR_BRIDGE", trezorBridgeEnv)
+ buildConfigField("String", "TREZOR_BRIDGE_URL", "\"$trezorBridgeUrlEnv\"")
  buildConfigField("boolean", "GEO", System.getenv("GEO")?.toBoolean()?.toString() ?: "true")
  buildConfigField("String", "LOCALES", "\"${bcp47Locales.joinToString(",")}\"")
  }
@@ -217,7 +221,7 @@ composeCompiler {
 }
 
 dependencies {
- implementation(fileTree("libs") { include("*.aar") })
+ implementation(fileTree("libs") { include("*.aar", "*.jar") })
  implementation(libs.jna) { artifact { type = "aar" } }
  implementation(platform(libs.kotlin.bom))
  implementation(libs.core.ktx)

app/proguard-rules.pro

@@ -18,4 +18,11 @@
 
 # If you keep the line number information, uncomment this to
 # hide the original source file name.
-#-renamesourcefileattribute SourceFile
+#-renamesourcefileattribute SourceFile
+
+# btleplug (droidplug) Android Bluetooth support
+# These classes are loaded via JNI from Rust code
+-keep class com.nonpolynomial.btleplug.** { *; }
+
+# jni-utils support library for btleplug
+-keep class io.github.gedgygedgy.rust.** { *; }

app/src/main/AndroidManifest.xml

@@ -26,6 +26,25 @@
  android:name="android.permission.FOREGROUND_SERVICE"
  tools:ignore="ForegroundServicePermission,ForegroundServicesPolicy" />
  <uses-permission android:name="android.permission.FOREGROUND_SERVICE_DATA_SYNC" />
+
+ <!-- USB Host support for Trezor hardware wallet -->
+ <uses-feature
+ android:name="android.hardware.usb.host"
+ android:required="false" />
+
+ <!-- Bluetooth permissions for Trezor Safe 7 (Android 12+) -->
+ <uses-permission android:name="android.permission.BLUETOOTH_CONNECT" />
+ <uses-permission android:name="android.permission.BLUETOOTH_SCAN"
+ android:usesPermissionFlags="neverForLocation" />
+
+ <!-- Bluetooth permissions (legacy, Android 11 and below) -->
+ <uses-permission android:name="android.permission.BLUETOOTH"
+ android:maxSdkVersion="30" />
+ <uses-permission android:name="android.permission.BLUETOOTH_ADMIN"
+ android:maxSdkVersion="30" />
+ <uses-permission android:name="android.permission.ACCESS_FINE_LOCATION"
+ android:maxSdkVersion="30" />
+
  <!-- Required for E2E tests connecting to local Electrum server (Android 16+) -->
  <uses-permission
  android:name="android.permission.NEARBY_WIFI_DEVICES"
@@ -132,6 +151,14 @@
  <data android:scheme="lnurlp" />
  </intent-filter>
 
+ <!-- USB device attached — auto-grants permission when Trezor is plugged in -->
+ <intent-filter>
+ <action android:name="android.hardware.usb.action.USB_DEVICE_ATTACHED" />
+ </intent-filter>
+ <meta-data
+ android:name="android.hardware.usb.action.USB_DEVICE_ATTACHED"
+ android:resource="@xml/usb_device_filter" />
+
  <meta-data
  android:name="android.app.shortcuts"
  android:resource="@xml/shortcuts" />

app/src/main/java/to/bitkit/App.kt

@@ -11,6 +11,7 @@ import coil3.ImageLoader
 import coil3.SingletonImageLoader
 import dagger.hilt.android.HiltAndroidApp
 import to.bitkit.env.Env
+import to.bitkit.services.BluetoothInit
 import javax.inject.Inject
 
 @HiltAndroidApp
@@ -31,6 +32,8 @@ internal open class App : Application(), Configuration.Provider {
  SingletonImageLoader.setSafe { imageLoader }
  currentActivity = CurrentActivity().also { registerActivityLifecycleCallbacks(it) }
  Env.initAppStoragePath(filesDir.absolutePath)
+ // Initialize btleplug for Bluetooth support (required before any BLE usage)
+ BluetoothInit.ensureInitialized()
  }
 
  companion object {

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

@@ -0,0 +1,43 @@
+package to.bitkit.data
+
+import android.content.Context
+import androidx.datastore.core.DataStore
+import androidx.datastore.dataStore
+import dagger.hilt.android.qualifiers.ApplicationContext
+import kotlinx.coroutines.flow.Flow
+import kotlinx.coroutines.flow.first
+import kotlinx.serialization.Serializable
+import to.bitkit.data.serializers.TrezorDataSerializer
+import to.bitkit.repositories.KnownDevice
+import javax.inject.Inject
+import javax.inject.Singleton
+
+private val Context.trezorDataStore: DataStore<TrezorData> by dataStore(
+ fileName = "trezor_device.json",
+ serializer = TrezorDataSerializer
+)
+
+@Singleton
+class TrezorStore @Inject constructor(
+ @ApplicationContext private val context: Context,
+) {
+ private val store = context.trezorDataStore
+
+ val data: Flow<TrezorData> = store.data
+
+ suspend fun loadKnownDevices(): List<KnownDevice> =
+ store.data.first().knownDevices
+
+ suspend fun saveKnownDevices(devices: List<KnownDevice>) {
+ store.updateData { it.copy(knownDevices = devices) }
+ }
+
+ suspend fun reset() {
+ store.updateData { TrezorData() }
+ }
+}
+
+@Serializable
+data class TrezorData(
+ val knownDevices: List<KnownDevice> = emptyList(),
+)

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

@@ -0,0 +1,26 @@
+package to.bitkit.data.serializers
+
+import androidx.datastore.core.Serializer
+import kotlinx.serialization.SerializationException
+import to.bitkit.data.TrezorData
+import to.bitkit.di.json
+import to.bitkit.utils.Logger
+import java.io.InputStream
+import java.io.OutputStream
+
+object TrezorDataSerializer : Serializer<TrezorData> {
+ override val defaultValue: TrezorData = TrezorData()
+
+ override suspend fun readFrom(input: InputStream): TrezorData {
+ return try {
+ json.decodeFromString(input.readBytes().decodeToString())
+ } catch (e: SerializationException) {
+ Logger.error("Failed to deserialize: $e")
+ defaultValue
+ }
+ }
+
+ override suspend fun writeTo(t: TrezorData, output: OutputStream) {
+ output.write(json.encodeToString(t).encodeToByteArray())
+ }
+}

app/src/main/java/to/bitkit/env/Env.kt

@@ -13,6 +13,7 @@ import to.bitkit.models.NodePeer
 import to.bitkit.utils.Logger
 import java.io.File
 import kotlin.io.path.Path
+import com.synonym.bitkitcore.Network as BitkitCoreNetwork
 
 @Suppress("ConstPropertyName", "KotlinConstantConditions", "SimplifyBooleanWithConstants")
 internal object Env {
@@ -199,6 +200,17 @@ internal object Env {
  else -> "https://bitkit.stag0.blocktank.to/backups-ldk"
  }
 
+ fun electrumUrlForNetwork(network: BitkitCoreNetwork): String {
+ val isE2eLocal = isE2eTest && e2eBackend == "local"
+ return when (network) {
+ BitkitCoreNetwork.BITCOIN -> ElectrumServers.MAINNET.ESPLORA
+ BitkitCoreNetwork.TESTNET, BitkitCoreNetwork.TESTNET4, BitkitCoreNetwork.SIGNET ->
+ ElectrumServers.TESTNET
+ BitkitCoreNetwork.REGTEST ->
+ if (isE2eLocal) ElectrumServers.REGTEST.LOCAL else ElectrumServers.REGTEST.STAG
+ }
+ }
+
  // endregion
 
  // region paths

app/src/main/java/to/bitkit/ext/Context.kt

@@ -3,13 +3,15 @@ package to.bitkit.ext
 import android.app.Activity
 import android.app.ActivityManager
 import android.app.NotificationManager
+import android.bluetooth.BluetoothManager
 import android.content.ClipData
 import android.content.ClipboardManager
 import android.content.Context
 import android.content.Context.NOTIFICATION_SERVICE
 import android.content.ContextWrapper
 import android.content.Intent
 import android.content.pm.PackageManager.PERMISSION_GRANTED
+import android.hardware.usb.UsbManager
 import android.provider.Settings
 import androidx.core.app.NotificationManagerCompat
 import androidx.core.content.ContextCompat
@@ -31,6 +33,12 @@ val Context.clipboardManager: ClipboardManager
 val Context.activityManager: ActivityManager
  get() = getSystemService(Context.ACTIVITY_SERVICE) as ActivityManager
 
+val Context.usbManager: UsbManager
+ get() = getSystemService(Context.USB_SERVICE) as UsbManager
+
+val Context.bluetoothManager: BluetoothManager
+ get() = getSystemService(Context.BLUETOOTH_SERVICE) as BluetoothManager
+
 // Permissions
 
 fun Context.requiresPermission(permission: String): Boolean =

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

@@ -1,6 +1,7 @@
 package to.bitkit.models
 
 import com.synonym.bitkitcore.NetworkType
+import com.synonym.bitkitcore.TrezorCoinType
 import org.lightningdevkit.ldknode.Network
 import com.synonym.bitkitcore.Network as BitkitCoreNetwork
 
@@ -11,6 +12,13 @@ fun Network.networkUiText(): String = when (this) {
  Network.REGTEST -> "Regtest"
 }
 
+fun Network.toTrezorCoinType(): TrezorCoinType = when (this) {
+ Network.BITCOIN -> TrezorCoinType.BITCOIN
+ Network.TESTNET -> TrezorCoinType.TESTNET
+ Network.SIGNET -> TrezorCoinType.SIGNET
+ Network.REGTEST -> TrezorCoinType.REGTEST
+}
+
 fun Network.toCoreNetwork(): BitkitCoreNetwork = when (this) {
  Network.BITCOIN -> BitkitCoreNetwork.BITCOIN
  Network.TESTNET -> BitkitCoreNetwork.TESTNET
@@ -31,3 +39,11 @@ fun NetworkType.toLdkNetwork(): Network = when (this) {
  NetworkType.SIGNET -> Network.SIGNET
  NetworkType.REGTEST -> Network.REGTEST
 }
+
+fun BitkitCoreNetwork.toTrezorCoinType(): TrezorCoinType = when (this) {
+ BitkitCoreNetwork.BITCOIN -> TrezorCoinType.BITCOIN
+ BitkitCoreNetwork.TESTNET -> TrezorCoinType.TESTNET
+ BitkitCoreNetwork.TESTNET4 -> TrezorCoinType.TESTNET
+ BitkitCoreNetwork.SIGNET -> TrezorCoinType.SIGNET
+ BitkitCoreNetwork.REGTEST -> TrezorCoinType.REGTEST
+}