react-native-zcash 0.4.2 → 0.6.0

package/ios/ZCashLightClientKit/DAO/TransactionDao.swift

@@ -8,6 +8,22 @@
 import Foundation
 import SQLite
 
+extension Connection {
+    public func scalarLocked<V: Value>(_ query: ScalarQuery<V?>) throws -> V.ValueType? {
+        globalDBLock.lock()
+        defer { globalDBLock.unlock() }
+
+        return try scalar(query)
+    }
+    
+    public func scalarLocked<V: Value>(_ query: ScalarQuery<V>) throws -> V {
+        globalDBLock.lock()
+        defer { globalDBLock.unlock() }
+
+        return try scalar(query)
+    }
+}
+
 class TransactionSQLDAO: TransactionRepository {
     enum NotesTableStructure {
         static let transactionID = Expression<Int>("tx")
@@ -16,14 +32,12 @@ class TransactionSQLDAO: TransactionRepository {
 
     let dbProvider: ConnectionProvider
     
-    private let blockDao: BlockSQLDAO
     private let transactionsView = View("v_transactions")
     private let txOutputsView = View("v_tx_outputs")
     private let traceClosure: ((String) -> Void)?
     
     init(dbProvider: ConnectionProvider, traceClosure: ((String) -> Void)? = nil) {
         self.dbProvider = dbProvider
-        self.blockDao = BlockSQLDAO(dbProvider: dbProvider)
         self.traceClosure = traceClosure
     }
 
@@ -37,25 +51,13 @@ class TransactionSQLDAO: TransactionRepository {
         dbProvider.close()
     }
 
-    func blockForHeight(_ height: BlockHeight) async throws -> Block? {
-        try blockDao.block(at: height)
-    }
-
-    func lastScannedHeight() async throws -> BlockHeight {
-        try blockDao.latestBlockHeight()
-    }
-
-    func lastScannedBlock() async throws -> Block? {
-        try blockDao.latestBlock()
-    }
-
     func isInitialized() async throws -> Bool {
         true
     }
     
     func countAll() async throws -> Int {
         do {
-            return try connection().scalar(transactionsView.count)
+            return try connection().scalarLocked(transactionsView.count)
         } catch {
             throw ZcashError.transactionRepositoryCountAll(error)
         }
@@ -63,20 +65,12 @@ class TransactionSQLDAO: TransactionRepository {
     
     func countUnmined() async throws -> Int {
         do {
-            return try connection().scalar(transactionsView.filter(ZcashTransaction.Overview.Column.minedHeight == nil).count)
+            return try connection().scalarLocked(transactionsView.filter(ZcashTransaction.Overview.Column.minedHeight == nil).count)
         } catch {
             throw ZcashError.transactionRepositoryCountUnmined(error)
         }
     }
 
-    func find(id: Int) async throws -> ZcashTransaction.Overview {
-        let query = transactionsView
-            .filter(ZcashTransaction.Overview.Column.id == id)
-            .limit(1)
-
-        return try execute(query) { try ZcashTransaction.Overview(row: $0) }
-    }
-
     func find(rawID: Data) async throws -> ZcashTransaction.Overview {
         let query = transactionsView
             .filter(ZcashTransaction.Overview.Column.rawID == Blob(bytes: rawID.bytes))
@@ -87,7 +81,7 @@ class TransactionSQLDAO: TransactionRepository {
 
     func find(offset: Int, limit: Int, kind: TransactionKind) async throws -> [ZcashTransaction.Overview] {
         let query = transactionsView
-            .order((ZcashTransaction.Overview.Column.minedHeight ?? BlockHeight.max).desc, ZcashTransaction.Overview.Column.id.desc)
+            .order((ZcashTransaction.Overview.Column.minedHeight ?? BlockHeight.max).desc)
             .filterQueryFor(kind: kind)
             .limit(limit, offset: offset)
 
@@ -96,7 +90,7 @@ class TransactionSQLDAO: TransactionRepository {
 
     func find(in range: CompactBlockRange, limit: Int, kind: TransactionKind) async throws -> [ZcashTransaction.Overview] {
         let query = transactionsView
-            .order((ZcashTransaction.Overview.Column.minedHeight ?? BlockHeight.max).desc, ZcashTransaction.Overview.Column.id.desc)
+            .order((ZcashTransaction.Overview.Column.minedHeight ?? BlockHeight.max).desc)
             .filter(
                 ZcashTransaction.Overview.Column.minedHeight >= BlockHeight(range.lowerBound) &&
                 ZcashTransaction.Overview.Column.minedHeight <= BlockHeight(range.upperBound)
@@ -109,17 +103,18 @@ class TransactionSQLDAO: TransactionRepository {
 
     func find(from transaction: ZcashTransaction.Overview, limit: Int, kind: TransactionKind) async throws -> [ZcashTransaction.Overview] {
         guard
-            let transactionIndex = transaction.index,
-            let transactionBlockTime = transaction.blockTime
+            let transactionBlockHeight = transaction.minedHeight
         else { throw ZcashError.transactionRepositoryTransactionMissingRequiredFields }
         
+        let transactionIndex = transaction.index ?? Int.max
         let query = transactionsView
-            .order(
-                (ZcashTransaction.Overview.Column.minedHeight ?? BlockHeight.max).desc, ZcashTransaction.Overview.Column.id.desc
-            )
+            .order((ZcashTransaction.Overview.Column.minedHeight ?? BlockHeight.max).desc)
             .filter(
-                Int64(transactionBlockTime) > ZcashTransaction.Overview.Column.blockTime
-                && transactionIndex > ZcashTransaction.Overview.Column.index
+                transactionBlockHeight > ZcashTransaction.Overview.Column.minedHeight
+                || (
+                    transactionBlockHeight == ZcashTransaction.Overview.Column.minedHeight &&
+                    transactionIndex > (ZcashTransaction.Overview.Column.index ?? -1)
+                )
             )
             .filterQueryFor(kind: kind)
             .limit(limit)
@@ -130,7 +125,7 @@ class TransactionSQLDAO: TransactionRepository {
     func findReceived(offset: Int, limit: Int) async throws -> [ZcashTransaction.Overview] {
         let query = transactionsView
             .filterQueryFor(kind: .received)
-            .order(ZcashTransaction.Overview.Column.id.desc, (ZcashTransaction.Overview.Column.minedHeight ?? BlockHeight.max).desc)
+            .order((ZcashTransaction.Overview.Column.minedHeight ?? BlockHeight.max).desc)
             .limit(limit, offset: offset)
 
         return try execute(query) { try ZcashTransaction.Overview(row: $0) }
@@ -139,7 +134,7 @@ class TransactionSQLDAO: TransactionRepository {
     func findSent(offset: Int, limit: Int) async throws -> [ZcashTransaction.Overview] {
         let query = transactionsView
             .filterQueryFor(kind: .sent)
-            .order((ZcashTransaction.Overview.Column.minedHeight ?? BlockHeight.max).desc, ZcashTransaction.Overview.Column.id.desc)
+            .order((ZcashTransaction.Overview.Column.minedHeight ?? BlockHeight.max).desc)
             .limit(limit, offset: offset)
 
         return try execute(query) { try ZcashTransaction.Overview(row: $0) }
@@ -148,7 +143,7 @@ class TransactionSQLDAO: TransactionRepository {
     func findPendingTransactions(latestHeight: BlockHeight, offset: Int, limit: Int) async throws -> [ZcashTransaction.Overview] {
         let query = transactionsView
             .filterPendingFrom(latestHeight)
-            .order((ZcashTransaction.Overview.Column.minedHeight ?? BlockHeight.max).desc, ZcashTransaction.Overview.Column.id.desc)
+            .order((ZcashTransaction.Overview.Column.minedHeight ?? BlockHeight.max).desc)
             .limit(limit, offset: offset)
 
         return try execute(query) { try ZcashTransaction.Overview(row: $0) }
@@ -156,22 +151,22 @@ class TransactionSQLDAO: TransactionRepository {
 
     func findMemos(for transaction: ZcashTransaction.Overview) async throws -> [Memo] {
         do {
-            return try await getTransactionOutputs(for: transaction.id)
+            return try await getTransactionOutputs(for: transaction.rawID)
                 .compactMap { $0.memo }
         } catch {
             throw ZcashError.transactionRepositoryFindMemos(error)
         }
     }
 
-    func getTransactionOutputs(for id: Int) async throws -> [ZcashTransaction.Output] {
+    func getTransactionOutputs(for rawID: Data) async throws -> [ZcashTransaction.Output] {
         let query = self.txOutputsView
-            .filter(ZcashTransaction.Output.Column.idTx == id)
+            .filter(ZcashTransaction.Output.Column.rawID == Blob(bytes: rawID.bytes))
 
         return try execute(query) { try ZcashTransaction.Output(row: $0) }
     }
 
-    func getRecipients(for id: Int) async throws -> [TransactionRecipient] {
-        try await getTransactionOutputs(for: id).map { $0.recipient }
+    func getRecipients(for rawID: Data) async throws -> [TransactionRecipient] {
+        try await getTransactionOutputs(for: rawID).map { $0.recipient }
     }
 
     private func execute<Entity>(_ query: View, createEntity: (Row) throws -> Entity) throws -> Entity {
@@ -181,11 +176,14 @@ class TransactionSQLDAO: TransactionRepository {
     }
 
     private func execute<Entity>(_ query: View, createEntity: (Row) throws -> Entity) throws -> [Entity] {
+        globalDBLock.lock()
+        defer { globalDBLock.unlock() }
+        
         do {
             let entities = try connection()
                 .prepare(query)
                 .map(createEntity)
-            
+
             return entities
         } catch {
             if let error = error as? ZcashError {

package/ios/ZCashLightClientKit/DAO/UnspentTransactionOutputDao.swift

@@ -109,6 +109,9 @@ class UnspentTransactionOutputSQLDAO: UnspentTransactionOutputRepository {
             )
             """
         do {
+            globalDBLock.lock()
+            defer { globalDBLock.unlock() }
+            
             try dbProvider.connection().run(stringStatement)
         } catch {
             throw ZcashError.unspentTransactionOutputDAOCreateTable(error)
@@ -118,8 +121,11 @@ class UnspentTransactionOutputSQLDAO: UnspentTransactionOutputRepository {
     /// - Throws: `unspentTransactionOutputDAOStore` if sqlite query fails.
     func store(utxos: [UnspentTransactionOutputEntity]) async throws {
         do {
+            globalDBLock.lock()
+            defer { globalDBLock.unlock() }
+
             let db = try dbProvider.connection()
-            try dbProvider.connection().transaction {
+            try db.transaction {
                 for utxo in utxos.map({ $0 as? UTXO ?? $0.asUTXO() }) {
                     try db.run(table.insert(utxo))
                 }
@@ -132,6 +138,9 @@ class UnspentTransactionOutputSQLDAO: UnspentTransactionOutputRepository {
     /// - Throws: `unspentTransactionOutputDAOClearAll` if sqlite query fails.
     func clearAll(address: String?) async throws {
         do {
+            globalDBLock.lock()
+            defer { globalDBLock.unlock() }
+
             if let tAddr = address {
                 try dbProvider.connection().run(table.filter(TableColumns.address == tAddr).delete())
             } else {
@@ -178,16 +187,16 @@ class UnspentTransactionOutputSQLDAO: UnspentTransactionOutputRepository {
     /// - Throws: `unspentTransactionOutputDAOBalance` if sqlite query fails.
     func balance(address: String, latestHeight: BlockHeight) async throws -> WalletBalance {
         do {
-            let verified = try dbProvider.connection().scalar(
+            let verified = try dbProvider.connection().scalarLocked(
                 table.select(TableColumns.valueZat.sum)
                     .filter(TableColumns.address == address)
                     .filter(TableColumns.height <= latestHeight - ZcashSDK.defaultStaleTolerance)
             ) ?? 0
-            let total = try dbProvider.connection().scalar(
+            let total = try dbProvider.connection().scalarLocked(
                 table.select(TableColumns.valueZat.sum)
                     .filter(TableColumns.address == address)
             ) ?? 0
-            
+
             return WalletBalance(
                 verified: Zatoshi(Int64(verified)),
                 total: Zatoshi(Int64(total))

package/ios/ZCashLightClientKit/Entity/AccountEntity.swift

@@ -66,6 +66,9 @@ class AccountSQDAO: AccountRepository {
     ///     - `accountDAOGetAll` if sqlite query fetching account data failed.
     func getAll() throws -> [AccountEntity] {
         do {
+            globalDBLock.lock()
+            defer { globalDBLock.unlock() }
+            
             return try dbProvider.connection()
                 .prepare(table)
                 .map { row -> DbAccount in
@@ -90,6 +93,9 @@ class AccountSQDAO: AccountRepository {
     func findBy(account: Int) throws -> AccountEntity? {
         let query = table.filter(TableColums.account == account).limit(1)
         do {
+            globalDBLock.lock()
+            defer { globalDBLock.unlock() }
+
             return try dbProvider.connection()
                 .prepare(query)
                 .map {
@@ -119,6 +125,9 @@ class AccountSQDAO: AccountRepository {
 
         let updatedRows: Int
         do {
+            globalDBLock.lock()
+            defer { globalDBLock.unlock() }
+
             updatedRows = try dbProvider.connection().run(table.filter(TableColums.account == acc.account).update(acc))
         } catch {
             throw ZcashError.accountDAOUpdate(error)

package/ios/ZCashLightClientKit/Entity/TransactionEntity.swift

@@ -25,9 +25,9 @@ public enum ZcashTransaction {
             init(
                 currentHeight: BlockHeight,
                 minedHeight: BlockHeight?,
-                expiredUnmined: Bool
+                expiredUnmined: Bool?
             ) {
-                guard !expiredUnmined else {
+                guard let expiredUnmined, !expiredUnmined else {
                     self = .expired
                     return
                 }
@@ -48,7 +48,6 @@ public enum ZcashTransaction {
         public let blockTime: TimeInterval?
         public let expiryHeight: BlockHeight?
         public let fee: Zatoshi?
-        public let id: Int
         public let index: Int?
         public var isSentTransaction: Bool { value < Zatoshi(0) }
         public let hasChange: Bool
@@ -59,7 +58,7 @@ public enum ZcashTransaction {
         public let receivedNoteCount: Int
         public let sentNoteCount: Int
         public let value: Zatoshi
-        public let isExpiredUmined: Bool
+        public let isExpiredUmined: Bool?
     }
 
     public struct Output {
@@ -79,7 +78,7 @@ public enum ZcashTransaction {
             }
         }
 
-        public let idTx: Int
+        public let rawID: Data
         public let pool: Pool
         public let index: Int
         public let fromAccount: Int?
@@ -99,7 +98,7 @@ public enum ZcashTransaction {
 
 extension ZcashTransaction.Output {
     enum Column {
-        static let idTx = Expression<Int>("id_tx")
+        static let rawID = Expression<Blob>("txid")
         static let pool = Expression<Int>("output_pool")
         static let index = Expression<Int>("output_index")
         static let toAccount = Expression<Int?>("to_account")
@@ -112,7 +111,7 @@ extension ZcashTransaction.Output {
 
     init(row: Row) throws {
         do {
-            idTx = try row.get(Column.idTx)
+            rawID = Data(blob: try row.get(Column.rawID))
             pool = .init(rawValue: try row.get(Column.pool))
             index = try row.get(Column.index)
             fromAccount = try row.get(Column.fromAccount)
@@ -144,7 +143,6 @@ extension ZcashTransaction.Output {
 extension ZcashTransaction.Overview {
     enum Column {
         static let accountId = Expression<Int>("account_id")
-        static let id = Expression<Int>("id_tx")
         static let minedHeight = Expression<BlockHeight?>("mined_height")
         static let index = Expression<Int?>("tx_index")
         static let rawID = Expression<Blob>("txid")
@@ -157,14 +155,13 @@ extension ZcashTransaction.Overview {
         static let receivedNoteCount = Expression<Int>("received_note_count")
         static let memoCount = Expression<Int>("memo_count")
         static let blockTime = Expression<Int64?>("block_time")
-        static let expiredUnmined = Expression<Bool>("expired_unmined")
+        static let expiredUnmined = Expression<Bool?>("expired_unmined")
     }
 
     init(row: Row) throws {
         do {
             self.accountId = try row.get(Column.accountId)
             self.expiryHeight = try row.get(Column.expiryHeight)
-            self.id = try row.get(Column.id)
             self.index = try row.get(Column.index)
             self.hasChange = try row.get(Column.hasChange)
             self.memoCount = try row.get(Column.memoCount)

package/ios/ZCashLightClientKit/Error/Sourcery/generateErrorCode.sh

@@ -3,7 +3,7 @@
 scriptDir=${0:a:h}
 cd "${scriptDir}"
 
-sourcery_version=2.0.2
+sourcery_version=2.0.3
 
 if which sourcery >/dev/null; then
     if [[ $(sourcery --version) != $sourcery_version ]]; then

package/ios/ZCashLightClientKit/Error/ZcashError.swift

@@ -1,4 +1,4 @@
-// Generated using Sourcery 2.0.2 — https://github.com/krzysztofzablocki/Sourcery
+// Generated using Sourcery 2.0.3 — https://github.com/krzysztofzablocki/Sourcery
 // DO NOT EDIT
 
 /*
@@ -11,8 +11,9 @@ error originates. And it can help with debugging.
 import Foundation
 
 public enum ZcashError: Equatable, Error {
-    /// Some error happened that is not handled as `ZcashError`.
-    /// Use case is to map `any Error`(in the apps for example) to this one so it can be assured only `ZcashError` is floating through apps.
+    /// Some error happened that is not handled as `ZcashError`. All errors in the SDK are (should be) `ZcashError`.
+    /// This case is ideally not contructed directly or thrown by any SDK function, rather it's a wrapper for case clients expect ZcashErrot and want to pass it to a function/enum.
+    /// If this is the case, use `toZcashError()` extension of Error. This helper avoids to end up with Optional handling.
     /// ZUNKWN0001
     case unknown(_ error: Error)
     /// Updating of paths in `Initilizer` according to alias failed.
@@ -21,6 +22,15 @@ public enum ZcashError: Equatable, Error {
     /// Alias used to create this instance of the `SDKSynchronizer` is already used by other instance.
     /// ZINIT0002
     case initializerAliasAlreadyInUse(_ alias: ZcashSynchronizerAlias)
+    /// Object on disk at `generalStorageURL` path exists. But it file not directory.
+    /// ZINIT0003
+    case initializerGeneralStorageExistsButIsFile(_ generalStorageURL: URL)
+    /// Can't create directory at `generalStorageURL` path.
+    /// ZINIT0004
+    case initializerGeneralStorageCantCreate(_ generalStorageURL: URL, _ error: Error)
+    /// Can't set `isExcludedFromBackup` flag to `generalStorageURL`.
+    /// ZINIT0005
+    case initializerCantSetNoBackupFlagToGeneralStorageURL(_ generalStorageURL: URL, _ error: Error)
     /// Unknown GRPC Service error
     /// ZSRVC0001
     case serviceUnknownError(_ error: Error)
@@ -48,6 +58,9 @@ public enum ZcashError: Equatable, Error {
     /// LightWalletService.blockStream failed.
     /// ZSRVC0000
     case serviceBlockStreamFailed(_ error: LightWalletServiceError)
+    /// LightWalletService.getSubtreeRoots failed.
+    /// ZSRVC0009
+    case serviceSubtreeRootsStreamFailed(_ error: LightWalletServiceError)
     /// SimpleConnectionProvider init of Connection failed.
     /// ZSCPC0001
     case simpleConnectionProvider(_ error: Error)
@@ -84,10 +97,18 @@ public enum ZcashError: Equatable, Error {
     /// - `sqliteError` is error produced by SQLite library.
     /// ZBDAO0004
     case blockDAOLatestBlock(_ sqliteError: Error)
-    /// Fetched latesxt block information from DB but can't decode them.
+    /// Fetched latest block information from DB but can't decode them.
     /// - `error` is decoding error.
     /// ZBDAO0005
     case blockDAOLatestBlockCantDecode(_ error: Error)
+    /// SQLite query failed when fetching the first unenhanced block from the database.
+    /// - `sqliteError` is error produced by SQLite library.
+    /// ZBDAO0006
+    case blockDAOFirstUnenhancedHeight(_ sqliteError: Error)
+    /// Fetched unenhanced block information from DB but can't decode them.
+    /// - `error` is decoding error.
+    /// ZBDAO0007
+    case blockDAOFirstUnenhancedCantDecode(_ error: Error)
     /// Error from rust layer when calling ZcashRustBackend.createAccount
     /// - `rustError` contains error generated by the rust layer.
     /// ZRUST0001
@@ -202,10 +223,6 @@ public enum ZcashError: Equatable, Error {
     /// - `rustError` contains error generated by the rust layer.
     /// ZRUST0030
     case rustValidateCombinedChainValidationFailed(_ rustError: String)
-    /// Error from rust layer which means that combined chain isn't valid.
-    /// - `upperBound` is the height of the highest invalid block (on the assumption that the highest block in the cache database is correct).
-    /// ZRUST0031
-    case rustValidateCombinedChainInvalidChain(_ upperBound: Int32)
     /// Error from rust layer when calling ZcashRustBackend.rewindToHeight
     /// - `rustError` contains error generated by the rust layer.
     /// ZRUST0032
@@ -258,6 +275,48 @@ public enum ZcashError: Equatable, Error {
     /// Transparent receiver generated by rust layer is invalid when calling ZcashRustBackend.getTransparentReceiver
     /// ZRUST0045
     case rustGetTransparentReceiverInvalidReceiver
+    /// Unable to allocate memory required to write blocks when calling ZcashRustBackend.putSaplingSubtreeRoots
+    /// sourcery: code="ZRUST0046"
+    /// ZRUST0046
+    case rustPutSaplingSubtreeRootsAllocationProblem
+    /// Error from rust layer when calling ZcashRustBackend.putSaplingSubtreeRoots
+    /// - `rustError` contains error generated by the rust layer.
+    /// sourcery: code="ZRUST0047"
+    /// ZRUST0047
+    case rustPutSaplingSubtreeRoots(_ rustError: String)
+    /// Error from rust layer when calling ZcashRustBackend.updateChainTip
+    /// - `rustError` contains error generated by the rust layer.
+    /// sourcery: code="ZRUST0048"
+    /// ZRUST0048
+    case rustUpdateChainTip(_ rustError: String)
+    /// Error from rust layer when calling ZcashRustBackend.suggestScanRanges
+    /// - `rustError` contains error generated by the rust layer.
+    /// sourcery: code="ZRUST0049"
+    /// ZRUST0049
+    case rustSuggestScanRanges(_ rustError: String)
+    /// Invalid transaction ID length when calling ZcashRustBackend.getMemo. txId must be 32 bytes.
+    /// ZRUST0050
+    case rustGetMemoInvalidTxIdLength
+    /// Error from rust layer when calling ZcashRustBackend.getScanProgress
+    /// - `rustError` contains error generated by the rust layer.
+    /// ZRUST0051
+    case rustGetScanProgress(_ rustError: String)
+    /// Error from rust layer when calling ZcashRustBackend.fullyScannedHeight
+    /// - `rustError` contains error generated by the rust layer.
+    /// ZRUST0052
+    case rustFullyScannedHeight(_ rustError: String)
+    /// Error from rust layer when calling ZcashRustBackend.maxScannedHeight
+    /// - `rustError` contains error generated by the rust layer.
+    /// ZRUST0053
+    case rustMaxScannedHeight(_ rustError: String)
+    /// Error from rust layer when calling ZcashRustBackend.latestCachedBlockHeight
+    /// - `rustError` contains error generated by the rust layer.
+    /// ZRUST0054
+    case rustLatestCachedBlockHeight(_ rustError: String)
+    /// Rust layer's call ZcashRustBackend.getScanProgress returned values that after computation are outside of allowed range 0-100%.
+    /// - `progress` value reported
+    /// ZRUST0055
+    case rustScanProgressOutOfRange(_ progress: String)
     /// SQLite query failed when fetching all accounts from the database.
     /// - `sqliteError` is error produced by SQLite library.
     /// ZADAO0001
@@ -491,6 +550,18 @@ public enum ZcashError: Equatable, Error {
     /// Consensus BranchIDs don't match this is probably an API or programming error.
     /// ZCBPEO0017
     case compactBlockProcessorConsensusBranchID
+    /// Rewind of DownloadBlockAction failed as no action is possible to unwrapp.
+    /// ZCBPEO0018
+    case compactBlockProcessorDownloadBlockActionRewind
+    /// Put sapling subtree roots to the DB failed.
+    /// ZCBPEO0019
+    case compactBlockProcessorPutSaplingSubtreeRoots(_ error: Error)
+    /// Getting the `lastScannedHeight` failed but it's supposed to always provide some value.
+    /// ZCBPEO0020
+    case compactBlockProcessorLastScannedHeight
+    /// Getting the `supportedSyncAlgorithm` failed but it's supposed to always provide some value.
+    /// ZCBPEO0021
+    case compactBlockProcessorSupportedSyncAlgorithm
     /// The synchronizer is unprepared.
     /// ZSYNCO0001
     case synchronizerNotPrepared
@@ -512,9 +583,12 @@ public enum ZcashError: Equatable, Error {
 
     public var message: String {
         switch self {
-        case .unknown: return "Some error happened that is not handled as `ZcashError`."
+        case .unknown: return "Some error happened that is not handled as `ZcashError`. All errors in the SDK are (should be) `ZcashError`."
         case .initializerCantUpdateURLWithAlias: return "Updating of paths in `Initilizer` according to alias failed."
         case .initializerAliasAlreadyInUse: return "Alias used to create this instance of the `SDKSynchronizer` is already used by other instance."
+        case .initializerGeneralStorageExistsButIsFile: return "Object on disk at `generalStorageURL` path exists. But it file not directory."
+        case .initializerGeneralStorageCantCreate: return "Can't create directory at `generalStorageURL` path."
+        case .initializerCantSetNoBackupFlagToGeneralStorageURL: return "Can't set `isExcludedFromBackup` flag to `generalStorageURL`."
         case .serviceUnknownError: return "Unknown GRPC Service error"
         case .serviceGetInfoFailed: return "LightWalletService.getInfo failed."
         case .serviceLatestBlockFailed: return "LightWalletService.latestBlock failed."
@@ -524,6 +598,7 @@ public enum ZcashError: Equatable, Error {
         case .serviceFetchTransactionFailed: return "LightWalletService.fetchTransaction failed."
         case .serviceFetchUTXOsFailed: return "LightWalletService.fetchUTXOs failed."
         case .serviceBlockStreamFailed: return "LightWalletService.blockStream failed."
+        case .serviceSubtreeRootsStreamFailed: return "LightWalletService.getSubtreeRoots failed."
         case .simpleConnectionProvider: return "SimpleConnectionProvider init of Connection failed."
         case .saplingParamsInvalidSpendParams: return "Downloaded file with sapling spending parameters isn't valid."
         case .saplingParamsInvalidOutputParams: return "Downloaded file with sapling output parameters isn't valid."
@@ -533,7 +608,9 @@ public enum ZcashError: Equatable, Error {
         case .blockDAOCantDecode: return "Fetched block information from DB but can't decode them."
         case .blockDAOLatestBlockHeight: return "SQLite query failed when fetching height of the latest block from the database."
         case .blockDAOLatestBlock: return "SQLite query failed when fetching the latest block from the database."
-        case .blockDAOLatestBlockCantDecode: return "Fetched latesxt block information from DB but can't decode them."
+        case .blockDAOLatestBlockCantDecode: return "Fetched latest block information from DB but can't decode them."
+        case .blockDAOFirstUnenhancedHeight: return "SQLite query failed when fetching the first unenhanced block from the database."
+        case .blockDAOFirstUnenhancedCantDecode: return "Fetched unenhanced block information from DB but can't decode them."
         case .rustCreateAccount: return "Error from rust layer when calling ZcashRustBackend.createAccount"
         case .rustCreateToAddress: return "Error from rust layer when calling ZcashRustBackend.createToAddress"
         case .rustDecryptAndStoreTransaction: return "Error from rust layer when calling ZcashRustBackend.decryptAndStoreTransaction"
@@ -564,7 +641,6 @@ public enum ZcashError: Equatable, Error {
         case .rustListTransparentReceiversInvalidAddress: return "Transparent receiver generated by rust layer is invalid when calling ZcashRustBackend.listTransparentReceivers"
         case .rustPutUnspentTransparentOutput: return "Error from rust layer when calling ZcashRustBackend.putUnspentTransparentOutput"
         case .rustValidateCombinedChainValidationFailed: return "Error unrelated to chain validity from rust layer when calling ZcashRustBackend.validateCombinedChain"
-        case .rustValidateCombinedChainInvalidChain: return "Error from rust layer which means that combined chain isn't valid."
         case .rustRewindToHeight: return "Error from rust layer when calling ZcashRustBackend.rewindToHeight"
         case .rustRewindCacheToHeight: return "Error from rust layer when calling ZcashRustBackend.rewindCacheToHeight"
         case .rustScanBlocks: return "Error from rust layer when calling ZcashRustBackend.scanBlocks"
@@ -579,6 +655,16 @@ public enum ZcashError: Equatable, Error {
         case .rustGetSaplingReceiverInvalidReceiver: return "Sapling receiver generated by rust layer is invalid when calling ZcashRustBackend.getSaplingReceiver"
         case .rustGetTransparentReceiverInvalidAddress: return "Error from rust layer when calling ZcashRustBackend.getTransparentReceiver"
         case .rustGetTransparentReceiverInvalidReceiver: return "Transparent receiver generated by rust layer is invalid when calling ZcashRustBackend.getTransparentReceiver"
+        case .rustPutSaplingSubtreeRootsAllocationProblem: return "Unable to allocate memory required to write blocks when calling ZcashRustBackend.putSaplingSubtreeRoots"
+        case .rustPutSaplingSubtreeRoots: return "Error from rust layer when calling ZcashRustBackend.putSaplingSubtreeRoots"
+        case .rustUpdateChainTip: return "Error from rust layer when calling ZcashRustBackend.updateChainTip"
+        case .rustSuggestScanRanges: return "Error from rust layer when calling ZcashRustBackend.suggestScanRanges"
+        case .rustGetMemoInvalidTxIdLength: return "Invalid transaction ID length when calling ZcashRustBackend.getMemo. txId must be 32 bytes."
+        case .rustGetScanProgress: return "Error from rust layer when calling ZcashRustBackend.getScanProgress"
+        case .rustFullyScannedHeight: return "Error from rust layer when calling ZcashRustBackend.fullyScannedHeight"
+        case .rustMaxScannedHeight: return "Error from rust layer when calling ZcashRustBackend.maxScannedHeight"
+        case .rustLatestCachedBlockHeight: return "Error from rust layer when calling ZcashRustBackend.latestCachedBlockHeight"
+        case .rustScanProgressOutOfRange: return "Rust layer's call ZcashRustBackend.getScanProgress returned values that after computation are outside of allowed range 0-100%."
         case .accountDAOGetAll: return "SQLite query failed when fetching all accounts from the database."
         case .accountDAOGetAllCantDecode: return "Fetched accounts from SQLite but can't decode them."
         case .accountDAOFindBy: return "SQLite query failed when seaching for accounts in the database."
@@ -653,6 +739,10 @@ public enum ZcashError: Equatable, Error {
         case .compactBlockProcessorCacheDbMigrationFailedToDeleteLegacyDb: return "Deletion of readable file at the provided URL failed."
         case .compactBlockProcessorChainName: return "Chain name does not match. Expected either 'test' or 'main'. This is probably an API or programming error."
         case .compactBlockProcessorConsensusBranchID: return "Consensus BranchIDs don't match this is probably an API or programming error."
+        case .compactBlockProcessorDownloadBlockActionRewind: return "Rewind of DownloadBlockAction failed as no action is possible to unwrapp."
+        case .compactBlockProcessorPutSaplingSubtreeRoots: return "Put sapling subtree roots to the DB failed."
+        case .compactBlockProcessorLastScannedHeight: return "Getting the `lastScannedHeight` failed but it's supposed to always provide some value."
+        case .compactBlockProcessorSupportedSyncAlgorithm: return "Getting the `supportedSyncAlgorithm` failed but it's supposed to always provide some value."
         case .synchronizerNotPrepared: return "The synchronizer is unprepared."
         case .synchronizerSendMemoToTransparentAddress: return "Memos can't be sent to transparent addresses."
         case .synchronizerShieldFundsInsuficientTransparentFunds: return "There is not enough transparent funds to cover fee for the shielding."
@@ -667,6 +757,9 @@ public enum ZcashError: Equatable, Error {
         case .unknown: return .unknown
         case .initializerCantUpdateURLWithAlias: return .initializerCantUpdateURLWithAlias
         case .initializerAliasAlreadyInUse: return .initializerAliasAlreadyInUse
+        case .initializerGeneralStorageExistsButIsFile: return .initializerGeneralStorageExistsButIsFile
+        case .initializerGeneralStorageCantCreate: return .initializerGeneralStorageCantCreate
+        case .initializerCantSetNoBackupFlagToGeneralStorageURL: return .initializerCantSetNoBackupFlagToGeneralStorageURL
         case .serviceUnknownError: return .serviceUnknownError
         case .serviceGetInfoFailed: return .serviceGetInfoFailed
         case .serviceLatestBlockFailed: return .serviceLatestBlockFailed
@@ -676,6 +769,7 @@ public enum ZcashError: Equatable, Error {
         case .serviceFetchTransactionFailed: return .serviceFetchTransactionFailed
         case .serviceFetchUTXOsFailed: return .serviceFetchUTXOsFailed
         case .serviceBlockStreamFailed: return .serviceBlockStreamFailed
+        case .serviceSubtreeRootsStreamFailed: return .serviceSubtreeRootsStreamFailed
         case .simpleConnectionProvider: return .simpleConnectionProvider
         case .saplingParamsInvalidSpendParams: return .saplingParamsInvalidSpendParams
         case .saplingParamsInvalidOutputParams: return .saplingParamsInvalidOutputParams
@@ -686,6 +780,8 @@ public enum ZcashError: Equatable, Error {
         case .blockDAOLatestBlockHeight: return .blockDAOLatestBlockHeight
         case .blockDAOLatestBlock: return .blockDAOLatestBlock
         case .blockDAOLatestBlockCantDecode: return .blockDAOLatestBlockCantDecode
+        case .blockDAOFirstUnenhancedHeight: return .blockDAOFirstUnenhancedHeight
+        case .blockDAOFirstUnenhancedCantDecode: return .blockDAOFirstUnenhancedCantDecode
         case .rustCreateAccount: return .rustCreateAccount
         case .rustCreateToAddress: return .rustCreateToAddress
         case .rustDecryptAndStoreTransaction: return .rustDecryptAndStoreTransaction
@@ -716,7 +812,6 @@ public enum ZcashError: Equatable, Error {
         case .rustListTransparentReceiversInvalidAddress: return .rustListTransparentReceiversInvalidAddress
         case .rustPutUnspentTransparentOutput: return .rustPutUnspentTransparentOutput
         case .rustValidateCombinedChainValidationFailed: return .rustValidateCombinedChainValidationFailed
-        case .rustValidateCombinedChainInvalidChain: return .rustValidateCombinedChainInvalidChain
         case .rustRewindToHeight: return .rustRewindToHeight
         case .rustRewindCacheToHeight: return .rustRewindCacheToHeight
         case .rustScanBlocks: return .rustScanBlocks
@@ -731,6 +826,16 @@ public enum ZcashError: Equatable, Error {
         case .rustGetSaplingReceiverInvalidReceiver: return .rustGetSaplingReceiverInvalidReceiver
         case .rustGetTransparentReceiverInvalidAddress: return .rustGetTransparentReceiverInvalidAddress
         case .rustGetTransparentReceiverInvalidReceiver: return .rustGetTransparentReceiverInvalidReceiver
+        case .rustPutSaplingSubtreeRootsAllocationProblem: return .rustPutSaplingSubtreeRootsAllocationProblem
+        case .rustPutSaplingSubtreeRoots: return .rustPutSaplingSubtreeRoots
+        case .rustUpdateChainTip: return .rustUpdateChainTip
+        case .rustSuggestScanRanges: return .rustSuggestScanRanges
+        case .rustGetMemoInvalidTxIdLength: return .rustGetMemoInvalidTxIdLength
+        case .rustGetScanProgress: return .rustGetScanProgress
+        case .rustFullyScannedHeight: return .rustFullyScannedHeight
+        case .rustMaxScannedHeight: return .rustMaxScannedHeight
+        case .rustLatestCachedBlockHeight: return .rustLatestCachedBlockHeight
+        case .rustScanProgressOutOfRange: return .rustScanProgressOutOfRange
         case .accountDAOGetAll: return .accountDAOGetAll
         case .accountDAOGetAllCantDecode: return .accountDAOGetAllCantDecode
         case .accountDAOFindBy: return .accountDAOFindBy
@@ -805,6 +910,10 @@ public enum ZcashError: Equatable, Error {
         case .compactBlockProcessorCacheDbMigrationFailedToDeleteLegacyDb: return .compactBlockProcessorCacheDbMigrationFailedToDeleteLegacyDb
         case .compactBlockProcessorChainName: return .compactBlockProcessorChainName
         case .compactBlockProcessorConsensusBranchID: return .compactBlockProcessorConsensusBranchID
+        case .compactBlockProcessorDownloadBlockActionRewind: return .compactBlockProcessorDownloadBlockActionRewind
+        case .compactBlockProcessorPutSaplingSubtreeRoots: return .compactBlockProcessorPutSaplingSubtreeRoots
+        case .compactBlockProcessorLastScannedHeight: return .compactBlockProcessorLastScannedHeight
+        case .compactBlockProcessorSupportedSyncAlgorithm: return .compactBlockProcessorSupportedSyncAlgorithm
         case .synchronizerNotPrepared: return .synchronizerNotPrepared
         case .synchronizerSendMemoToTransparentAddress: return .synchronizerSendMemoToTransparentAddress
         case .synchronizerShieldFundsInsuficientTransparentFunds: return .synchronizerShieldFundsInsuficientTransparentFunds