Merge pull request #563 from synonymdev/feat/e2e-beyond-local

feat: e2e beyond local

Author: ovitrif

AGENTS.md

@@ -20,12 +20,15 @@ This file provides guidance to AI agents like Cursor/Claude Code/Codex/WARP when
 # Run instrumented tests
 ./gradlew connectedDevDebugAndroidTest
 
-# Build for E2E tests
+# Build for E2E tests (UI hooks enabled, local Electrum by default)
 E2E=true ./gradlew assembleDevRelease
 
 # Build for E2E tests with geoblocking disabled
 GEO=false E2E=true ./gradlew assembleDevRelease
 
+# Build for E2E tests using network Electrum (not local; staging/mainnet based on flavor)
+E2E=true E2E_BACKEND=network ./gradlew assembleTnetRelease
+
 # Lint using detekt
 ./gradlew detekt
 
@@ -88,7 +91,7 @@ GEO=false E2E=true ./gradlew assembleDevRelease
 
 - **dev**: Regtest network for development
 - **tnet**: Testnet network
-- **mainnet**: Production (currently commented out)
+- **mainnet**: Production
 
 ## Common Pitfalls
 

README.md

@@ -119,12 +119,25 @@ To build the mainnet flavor:
 
 ### Build for E2E Testing
 
-Simply pass `E2E=true` as environment variable and build any flavor.
+Pass `E2E=true` and build any flavor. By default, E2E uses a local Electrum override.
 
 ```sh
 E2E=true ./gradlew assembleDevRelease
 ```
 
+#### Use Network Electrum (Staging/Mainnet)
+
+Set `E2E_BACKEND=network` to use the network Electrum based on the build flavor:
+
+```sh
+# regtest (dev flavor)
+E2E=true E2E_BACKEND=network ./gradlew assembleDevRelease
+# testnet (tnet flavor)
+E2E=true E2E_BACKEND=network ./gradlew assembleTnetRelease
+# mainnet
+E2E=true E2E_BACKEND=network ./gradlew assembleMainnetRelease
+```
+
 #### Disable Geoblocking Checks
 
 By default, geoblocking checks via API are enabled. To disable at build time, use the `GEO` environment variable:

app/build.gradle.kts

@@ -37,6 +37,7 @@ val keystoreProperties by lazy {
 }
 
 val locales = listOf("en", "ar", "ca", "cs", "de", "el", "es", "fr", "it", "nl", "pl", "pt", "ru")
+val e2eBackendEnv = System.getenv("E2E_BACKEND") ?: "local"
 
 android {
     namespace = "to.bitkit"
@@ -52,6 +53,7 @@ android {
             useSupportLibrary = true
         }
         buildConfigField("boolean", "E2E", System.getenv("E2E")?.toBoolean()?.toString() ?: "false")
+        buildConfigField("String", "E2E_BACKEND", "\"$e2eBackendEnv\"")
         buildConfigField("boolean", "GEO", System.getenv("GEO")?.toBoolean()?.toString() ?: "true")
         buildConfigField("String", "LOCALES", "\"${locales.joinToString(",")}\"")
     }

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

@@ -17,6 +17,7 @@ internal object Env {
     val isDebug = BuildConfig.DEBUG
     const val isE2eTest = BuildConfig.E2E
     const val isGeoblockingEnabled = BuildConfig.GEO
+    private val e2eBackend = BuildConfig.E2E_BACKEND.lowercase()
     val network = Network.valueOf(BuildConfig.NETWORK)
     val locales = BuildConfig.LOCALES.split(",")
     val walletSyncIntervalSecs = 10_uL // TODO review
@@ -98,7 +99,7 @@ internal object Env {
 
     val electrumServerUrl: String
         get() {
-            if (isE2eTest) return ElectrumServers.E2E
+            if (isE2eTest && e2eBackend == "local") return ElectrumServers.E2E
             return when (network) {
                 Network.REGTEST -> ElectrumServers.REGTEST
                 Network.TESTNET -> ElectrumServers.TESTNET