[#1547] Adopt latest Zcash SDK v2.1.3

* [#1547] Adopt latest Zcash SDK v2.1.3

- Closes #1547
- Changelogs update

* Switch to production Zcash SDK 2.1.3

CHANGELOG.md

@@ -6,6 +6,10 @@ and this application adheres to [Semantic Versioning](https://semver.org/spec/v2
 
 ## [Unreleased]
 
+### Changed
+- Adopted the latest Zcash SDK version 2.1.3, which brings a significant block synchronization speed-up and improved 
+  UTXOs fetching logic
+
 ## [1.1.4 (700)] - 2024-07-23
 
 ### Added

docs/whatsNew/WHATS_NEW_EN.md

@@ -9,6 +9,10 @@ directly impact users rather than highlighting other key architectural updates.*
 
 ## [Unreleased]
 
+### Changed
+- Adopted the latest Zcash SDK version 2.1.3, which brings a significant block synchronization speed-up and improved
+  UTXOs fetching logic
+
 ## [1.1.4 (700)] - 2024-07-23
 
 ### Added

gradle.properties

@@ -203,7 +203,7 @@ ZXING_VERSION=3.5.3
 ZCASH_BIP39_VERSION=1.0.8
 
 # WARNING: Ensure a non-snapshot version is used before releasing to production
-ZCASH_SDK_VERSION=2.1.2
+ZCASH_SDK_VERSION=2.1.3
 
 # Toolchain is the Java version used to build the application, which is separate from the
 # Java version used to run the application.

ui-lib/src/main/java/co/electriccoin/zcash/ui/common/viewmodel/WalletViewModel.kt

@@ -517,6 +517,11 @@ sealed class SecretState {
     class Ready(val persistableWallet: PersistableWallet) : SecretState()
 }
 
+/**
+ * This constant sets the default limitation on the length of the stack trace in the [SynchronizerError]
+ */
+const val STACKTRACE_LIMIT = 250
+
 // TODO [#529]: Localize Synchronizer Errors
 // TODO [#529]: https://github.com/Electric-Coin-Company/zashi-android/issues/529
 
@@ -526,24 +531,36 @@ sealed class SecretState {
 sealed class SynchronizerError {
     abstract fun getCauseMessage(): String?
 
+    abstract fun getStackTrace(limit: Int = STACKTRACE_LIMIT): String?
+
     class Critical(val error: Throwable?) : SynchronizerError() {
         override fun getCauseMessage(): String? = error?.message
+
+        override fun getStackTrace(limit: Int): String? = error?.stackTraceToString()?.substring(0..limit)
     }
 
     class Processor(val error: Throwable?) : SynchronizerError() {
         override fun getCauseMessage(): String? = error?.message
+
+        override fun getStackTrace(limit: Int): String? = error?.stackTraceToString()?.substring(0..limit)
     }
 
     class Submission(val error: Throwable?) : SynchronizerError() {
         override fun getCauseMessage(): String? = error?.message
+
+        override fun getStackTrace(limit: Int): String? = error?.stackTraceToString()?.substring(0..limit)
     }
 
     class Setup(val error: Throwable?) : SynchronizerError() {
         override fun getCauseMessage(): String? = error?.message
+
+        override fun getStackTrace(limit: Int): String? = error?.stackTraceToString()?.substring(0..limit)
     }
 
     class Chain(val x: BlockHeight, val y: BlockHeight) : SynchronizerError() {
         override fun getCauseMessage(): String = "$x, $y"
+
+        override fun getStackTrace(limit: Int): String? = null
     }
 }
 

ui-lib/src/main/java/co/electriccoin/zcash/ui/screen/balances/model/WalletDisplayValues.kt

@@ -13,6 +13,7 @@ import co.electriccoin.zcash.ui.common.extension.toKotlinLocale
 import co.electriccoin.zcash.ui.common.model.WalletSnapshot
 import co.electriccoin.zcash.ui.common.model.spendableBalance
 import co.electriccoin.zcash.ui.common.model.totalBalance
+import co.electriccoin.zcash.ui.common.viewmodel.STACKTRACE_LIMIT
 
 data class WalletDisplayValues(
     val progress: PercentDecimal,
@@ -105,7 +106,9 @@ data class WalletDisplayValues(
                             context.getString(
                                 R.string.balances_status_error_dialog_cause,
                                 walletSnapshot.synchronizerError.getCauseMessage()
-                                    ?: context.getString(R.string.balances_status_error_dialog_unknown)
+                                    ?: context.getString(R.string.balances_status_error_dialog_cause_unknown),
+                                walletSnapshot.synchronizerError.getStackTrace(limit = STACKTRACE_LIMIT)
+                                    ?: context.getString(R.string.balances_status_error_dialog_stacktrace_unknown)
                             )
                     )
             }

ui-lib/src/main/res/ui/balances/values/strings.xml

@@ -30,12 +30,17 @@
     <string name="balances_status_error_dialog_connection">
         Disconnected. Please check your internet connection.
     </string>
-    <string name="balances_status_error_dialog_cause" formatted="true">
-        Error: <xliff:g id="error_cause" example="Block scanning problem">%1$s</xliff:g>
+    <string name="balances_status_error_dialog_cause" formatted="true">Error:
+        <xliff:g id="error_cause" example="Block scanning problem">%1$s</xliff:g>\n\nStacktrace:
+        <xliff:g id="error_stacktrace"
+        example="java.lang.IllegalStateException: Unsupported wallet state
+        at kotlinx.coroutines.DispatchedTask.run(DispatchedTask.kt:104)
+        Caused by: java.lang.RuntimeException: Failure from Rust backend">%2$s</xliff:g>
     </string>
-    <string name="balances_status_error_dialog_unknown">
+    <string name="balances_status_error_dialog_cause_unknown">
         Unknown cause. Please contact our support team if the problem persists.
     </string>
+    <string name="balances_status_error_dialog_stacktrace_unknown">Unknown stacktrace.</string>
     <string name="balances_status_dialog_stopped">Synchronization is stopped. It will resume soon.</string>
     <string name="balances_status_dialog_button">OK</string>