react-native-zcash 0.8.1 → 0.9.0

package/ios/ZCashLightClientKit/ClosureSynchronizer.swift

@@ -128,7 +128,9 @@ public protocol ClosureSynchronizer {
     func refreshUTXOs(address: TransparentAddress, from height: BlockHeight, completion: @escaping (Result<RefreshedUTXOs, Error>) -> Void)
 
     func getAccountBalance(accountIndex: Int, completion: @escaping (Result<AccountBalance?, Error>) -> Void)
-    
+
+    func refreshExchangeRateUSD()
+
     /*
      It can be missleading that these two methods are returning Publisher even this protocol is closure based. Reason is that Synchronizer doesn't
      provide different implementations for these two methods. So Combine it is even here.

package/ios/ZCashLightClientKit/CombineSynchronizer.swift

@@ -97,7 +97,11 @@ public protocol CombineSynchronizer {
         memo: Memo?
     ) -> SinglePublisher<ZcashTransaction.Overview, Error>
     
-    @available(*, deprecated, message: "Upcoming SDK 2.1 will create multiple transactions at once for some recipients. use `proposeShielding:` instead")
+    @available(
+        *,
+        deprecated,
+        message: "Upcoming SDK 2.1 will create multiple transactions at once for some recipients. use `proposeShielding:` instead"
+    )
     func shieldFunds(
         spendingKey: UnifiedSpendingKey,
         memo: Memo,
@@ -125,7 +129,7 @@ public protocol CombineSynchronizer {
 
     func refreshUTXOs(address: TransparentAddress, from height: BlockHeight) -> SinglePublisher<RefreshedUTXOs, Error>
 
-    func getAccountBalance(accountIndex: Int) -> SinglePublisher<AccountBalance?, Error>
+    func refreshExchangeRateUSD()
 
     func rewind(_ policy: RewindPolicy) -> CompletablePublisher<Error>
     func wipe() -> CompletablePublisher<Error>

package/ios/ZCashLightClientKit/Constants/ZcashSDK.swift

@@ -124,6 +124,9 @@ public enum ZcashSDK {
     /// Default Name for LibRustZcash data.db
     public static let defaultDataDbName = "data.db"
 
+    /// Default Name for Tor data directory
+    public static let defaultTorDirName = "tor"
+
     /// Default Name for Compact Block file system based db
     public static let defaultFsCacheName = "fs_cache"
 
@@ -144,6 +147,9 @@ public enum ZcashSDK {
     public static let outputParamFilename = "sapling-output.params"
     // swiftlint:disable:next force_unwrapping
     public static let outputParamFileURL = URL(string: cloudParameterURL)!.appendingPathComponent(outputParamFilename)
+
+    /// A constant that helps determine if a server’s chain tip is so far away from the estimated height that we consider the server out of sync
+    public static let syncedThresholdBlocks = UInt64(288)
 }
 
 public protocol NetworkConstants {
@@ -154,6 +160,9 @@ public protocol NetworkConstants {
     /// Default Name for LibRustZcash data.db
     static var defaultDataDbName: String { get }
 
+    /// Default Name for Tor data directory
+    static var defaultTorDirName: String { get }
+
     static var defaultFsBlockDbRootName: String { get }
 
     /// Default Name for Compact Block caches db
@@ -181,6 +190,9 @@ public enum ZcashSDKMainnetConstants: NetworkConstants {
     /// Default Name for LibRustZcash data.db
     public static let defaultDataDbName = "data.db"
 
+    /// Default Name for Tor data directory
+    public static let defaultTorDirName = "tor"
+
     public static let defaultFsBlockDbRootName = "fs_cache"
 
     /// Default Name for Compact Block caches db
@@ -197,6 +209,9 @@ public enum ZcashSDKTestnetConstants: NetworkConstants {
     /// Default Name for LibRustZcash data.db
     public static let defaultDataDbName = "data.db"
 
+    /// Default Name for Tor data directory
+    public static let defaultTorDirName = "tor"
+
     /// Default Name for Compact Block caches db
     public static let defaultCacheDbName = "caches.db"
 

package/ios/ZCashLightClientKit/DAO/TransactionDao.swift

@@ -10,8 +10,8 @@ import SQLite
 
 class TransactionSQLDAO: TransactionRepository {
     enum NotesTableStructure {
-        static let transactionID = Expression<Int>("tx")
-        static let memo = Expression<Blob>("memo")
+        static let transactionID = SQLite.Expression<Int>("tx")
+        static let memo = SQLite.Expression<Blob>("memo")
     }
 
     let dbProvider: ConnectionProvider
@@ -108,6 +108,18 @@ class TransactionSQLDAO: TransactionRepository {
         return try await execute(query) { try ZcashTransaction.Overview(row: $0) }
     }
 
+    func findForResubmission(upTo: BlockHeight) async throws -> [ZcashTransaction.Overview] {
+        let query = transactionsView
+            .filter(
+                ZcashTransaction.Overview.Column.minedHeight == nil &&
+                ZcashTransaction.Overview.Column.expiryHeight > upTo
+            )
+            .filterQueryFor(kind: .sent)
+            .limit(Int.max)
+
+        return try await execute(query) { try ZcashTransaction.Overview(row: $0) }
+    }
+    
     func findReceived(offset: Int, limit: Int) async throws -> [ZcashTransaction.Overview] {
         let query = transactionsView
             .filterQueryFor(kind: .received)
@@ -135,14 +147,18 @@ class TransactionSQLDAO: TransactionRepository {
         return try await execute(query) { try ZcashTransaction.Overview(row: $0) }
     }
 
-    func findMemos(for transaction: ZcashTransaction.Overview) async throws -> [Memo] {
+    func findMemos(for rawID: Data) async throws -> [Memo] {
         do {
-            return try await getTransactionOutputs(for: transaction.rawID)
+            return try await getTransactionOutputs(for: rawID)
                 .compactMap { $0.memo }
         } catch {
             throw ZcashError.transactionRepositoryFindMemos(error)
         }
     }
+    
+    func findMemos(for transaction: ZcashTransaction.Overview) async throws -> [Memo] {
+        try await findMemos(for: transaction.rawID)
+    }
 
     func getTransactionOutputs(for rawID: Data) async throws -> [ZcashTransaction.Output] {
         let query = self.txOutputsView

package/ios/ZCashLightClientKit/Entity/TransactionEntity.swift

@@ -50,6 +50,7 @@ public enum ZcashTransaction {
         public let fee: Zatoshi?
         public let index: Int?
         public var isSentTransaction: Bool { value < Zatoshi(0) }
+        public var isShielding: Bool
         public let hasChange: Bool
         public let memoCount: Int
         public let minedHeight: BlockHeight?
@@ -94,22 +95,22 @@ public enum ZcashTransaction {
     /// Used when fetching blocks from the lightwalletd
     struct Fetched {
         public let rawID: Data
-        public let minedHeight: BlockHeight
+        public let minedHeight: UInt32?
         public let raw: Data
     }
 }
 
 extension ZcashTransaction.Output {
     enum Column {
-        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_id")
-        static let fromAccount = Expression<Int?>("from_account_id")
-        static let toAddress = Expression<String?>("to_address")
-        static let value = Expression<Int64>("value")
-        static let isChange = Expression<Bool>("is_change")
-        static let memo = Expression<Blob?>("memo")
+        static let rawID = SQLite.Expression<Blob>("txid")
+        static let pool = SQLite.Expression<Int>("output_pool")
+        static let index = SQLite.Expression<Int>("output_index")
+        static let toAccount = SQLite.Expression<Int?>("to_account_id")
+        static let fromAccount = SQLite.Expression<Int?>("from_account_id")
+        static let toAddress = SQLite.Expression<String?>("to_address")
+        static let value = SQLite.Expression<Int64>("value")
+        static let isChange = SQLite.Expression<Bool>("is_change")
+        static let memo = SQLite.Expression<Blob?>("memo")
     }
 
     init(row: Row) throws {
@@ -145,20 +146,21 @@ extension ZcashTransaction.Output {
 
 extension ZcashTransaction.Overview {
     enum Column {
-        static let accountId = Expression<Int>("account_id")
-        static let minedHeight = Expression<BlockHeight?>("mined_height")
-        static let index = Expression<Int?>("tx_index")
-        static let rawID = Expression<Blob>("txid")
-        static let expiryHeight = Expression<BlockHeight?>("expiry_height")
-        static let raw = Expression<Blob?>("raw")
-        static let value = Expression<Int64>("account_balance_delta")
-        static let fee = Expression<Int64?>("fee_paid")
-        static let hasChange = Expression<Bool>("has_change")
-        static let sentNoteCount = Expression<Int>("sent_note_count")
-        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 accountId = SQLite.Expression<Int>("account_id")
+        static let minedHeight = SQLite.Expression<BlockHeight?>("mined_height")
+        static let index = SQLite.Expression<Int?>("tx_index")
+        static let rawID = SQLite.Expression<Blob>("txid")
+        static let expiryHeight = SQLite.Expression<BlockHeight?>("expiry_height")
+        static let raw = SQLite.Expression<Blob?>("raw")
+        static let value = SQLite.Expression<Int64>("account_balance_delta")
+        static let fee = SQLite.Expression<Int64?>("fee_paid")
+        static let hasChange = SQLite.Expression<Bool>("has_change")
+        static let sentNoteCount = SQLite.Expression<Int>("sent_note_count")
+        static let receivedNoteCount = SQLite.Expression<Int>("received_note_count")
+        static let isShielding = SQLite.Expression<Bool>("is_shielding")
+        static let memoCount = SQLite.Expression<Int>("memo_count")
+        static let blockTime = SQLite.Expression<Int64?>("block_time")
+        static let expiredUnmined = SQLite.Expression<Bool?>("expired_unmined")
     }
 
     init(row: Row) throws {
@@ -171,6 +173,7 @@ extension ZcashTransaction.Overview {
             self.minedHeight = try row.get(Column.minedHeight)
             self.rawID = Data(blob: try row.get(Column.rawID))
             self.receivedNoteCount = try row.get(Column.receivedNoteCount)
+            self.isShielding = try row.get(Column.isShielding)
             self.sentNoteCount = try row.get(Column.sentNoteCount)
             self.value = Zatoshi(try row.get(Column.value))
             self.isExpiredUmined = try row.get(Column.expiredUnmined)

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

@@ -3,11 +3,11 @@
 scriptDir=${0:a:h}
 cd "${scriptDir}"
 
-sourcery_version=2.1.7
+sourcery_version=2.2.5
 
 if which sourcery >/dev/null; then
     if [[ $(sourcery --version) != $sourcery_version ]]; then
-        echo "warning: Compatible sourcer version not installed. Install sourcer $sourcery_version. Currently installed version is $(sourcer --version)"
+        echo "warning: Compatible sourcery version not installed. Install sourcery $sourcery_version. Currently installed version is $(sourcery --version)"
         exit 1
     fi
 

package/ios/ZCashLightClientKit/Error/ZcashError.swift

@@ -1,4 +1,4 @@
-// Generated using Sourcery 2.1.7 — https://github.com/krzysztofzablocki/Sourcery
+// Generated using Sourcery 2.2.5 — https://github.com/krzysztofzablocki/Sourcery
 // DO NOT EDIT
 
 /*
@@ -61,6 +61,9 @@ public enum ZcashError: Equatable, Error {
     /// LightWalletService.getSubtreeRoots failed.
     /// ZSRVC0009
     case serviceSubtreeRootsStreamFailed(_ error: LightWalletServiceError)
+    /// LightWalletService.getTaddressTxids failed.
+    /// ZSRVC0010
+    case serviceGetTaddressTxidsFailed(_ error: LightWalletServiceError)
     /// SimpleConnectionProvider init of Connection failed.
     /// ZSCPC0001
     case simpleConnectionProvider(_ error: Error)
@@ -342,6 +345,21 @@ public enum ZcashError: Equatable, Error {
     /// sourcery: code="ZRUST0061"
     /// ZRUST0061
     case rustPutOrchardSubtreeRoots(_ rustError: String)
+    /// Error from rust layer when calling TorClient.init
+    /// - `rustError` contains error generated by the rust layer.
+    /// sourcery: code="ZRUST0062"
+    /// ZRUST0062
+    case rustTorClientInit(_ rustError: String)
+    /// Error from rust layer when calling TorClient.get
+    /// - `rustError` contains error generated by the rust layer.
+    /// sourcery: code="ZRUST0063"
+    /// ZRUST0063
+    case rustTorClientGet(_ rustError: String)
+    /// Error from rust layer when calling ZcashRustBackend.transactionDataRequests
+    /// - `rustError` contains error generated by the rust layer.
+    /// sourcery: code="ZRUST0064"
+    /// ZRUST0064
+    case rustTransactionDataRequests(_ rustError: String)
     /// SQLite query failed when fetching all accounts from the database.
     /// - `sqliteError` is error produced by SQLite library.
     /// ZADAO0001
@@ -509,6 +527,9 @@ public enum ZcashError: Equatable, Error {
     /// Can't create `Recipient` because input is invalid.
     /// ZWLTP0007
     case recipientInvalidInput
+    /// Can't create `TexAddress` because input is invalid.
+    /// ZWLTP0008
+    case texAddressInvalidInput
     /// WalletTransactionEncoder wants to create transaction but files with sapling parameters are not present on disk.
     /// ZWLTE0001
     case walletTransEncoderCreateTransactionMissingSaplingParams
@@ -633,6 +654,7 @@ public enum ZcashError: Equatable, Error {
         case .serviceFetchUTXOsFailed: return "LightWalletService.fetchUTXOs failed."
         case .serviceBlockStreamFailed: return "LightWalletService.blockStream failed."
         case .serviceSubtreeRootsStreamFailed: return "LightWalletService.getSubtreeRoots failed."
+        case .serviceGetTaddressTxidsFailed: return "LightWalletService.getTaddressTxids 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."
@@ -705,6 +727,9 @@ public enum ZcashError: Equatable, Error {
         case .rustIsSeedRelevantToAnyDerivedAccount: return "Error from rust layer when calling ZcashRustBackend.rustIsSeedRelevantToAnyDerivedAccount"
         case .rustPutOrchardSubtreeRootsAllocationProblem: return "Unable to allocate memory required to write blocks when calling ZcashRustBackend.putOrchardSubtreeRoots"
         case .rustPutOrchardSubtreeRoots: return "Error from rust layer when calling ZcashRustBackend.putOrchardSubtreeRoots"
+        case .rustTorClientInit: return "Error from rust layer when calling TorClient.init"
+        case .rustTorClientGet: return "Error from rust layer when calling TorClient.get"
+        case .rustTransactionDataRequests: return "Error from rust layer when calling ZcashRustBackend.transactionDataRequests"
         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."
@@ -757,6 +782,7 @@ public enum ZcashError: Equatable, Error {
         case .saplingAddressInvalidInput: return "Can't create `SaplingAddress` because input is invalid."
         case .unifiedAddressInvalidInput: return "Can't create `UnifiedAddress` because input is invalid."
         case .recipientInvalidInput: return "Can't create `Recipient` because input is invalid."
+        case .texAddressInvalidInput: return "Can't create `TexAddress` because input is invalid."
         case .walletTransEncoderCreateTransactionMissingSaplingParams: return "WalletTransactionEncoder wants to create transaction but files with sapling parameters are not present on disk."
         case .walletTransEncoderShieldFundsMissingSaplingParams: return "WalletTransactionEncoder wants to shield funds but files with sapling parameters are not present on disk."
         case .zatoshiDecode: return "Initiatilzation fo `Zatoshi` from a decoder failed."
@@ -813,6 +839,7 @@ public enum ZcashError: Equatable, Error {
         case .serviceFetchUTXOsFailed: return .serviceFetchUTXOsFailed
         case .serviceBlockStreamFailed: return .serviceBlockStreamFailed
         case .serviceSubtreeRootsStreamFailed: return .serviceSubtreeRootsStreamFailed
+        case .serviceGetTaddressTxidsFailed: return .serviceGetTaddressTxidsFailed
         case .simpleConnectionProvider: return .simpleConnectionProvider
         case .saplingParamsInvalidSpendParams: return .saplingParamsInvalidSpendParams
         case .saplingParamsInvalidOutputParams: return .saplingParamsInvalidOutputParams
@@ -885,6 +912,9 @@ public enum ZcashError: Equatable, Error {
         case .rustIsSeedRelevantToAnyDerivedAccount: return .rustIsSeedRelevantToAnyDerivedAccount
         case .rustPutOrchardSubtreeRootsAllocationProblem: return .rustPutOrchardSubtreeRootsAllocationProblem
         case .rustPutOrchardSubtreeRoots: return .rustPutOrchardSubtreeRoots
+        case .rustTorClientInit: return .rustTorClientInit
+        case .rustTorClientGet: return .rustTorClientGet
+        case .rustTransactionDataRequests: return .rustTransactionDataRequests
         case .accountDAOGetAll: return .accountDAOGetAll
         case .accountDAOGetAllCantDecode: return .accountDAOGetAllCantDecode
         case .accountDAOFindBy: return .accountDAOFindBy
@@ -937,6 +967,7 @@ public enum ZcashError: Equatable, Error {
         case .saplingAddressInvalidInput: return .saplingAddressInvalidInput
         case .unifiedAddressInvalidInput: return .unifiedAddressInvalidInput
         case .recipientInvalidInput: return .recipientInvalidInput
+        case .texAddressInvalidInput: return .texAddressInvalidInput
         case .walletTransEncoderCreateTransactionMissingSaplingParams: return .walletTransEncoderCreateTransactionMissingSaplingParams
         case .walletTransEncoderShieldFundsMissingSaplingParams: return .walletTransEncoderShieldFundsMissingSaplingParams
         case .zatoshiDecode: return .zatoshiDecode

package/ios/ZCashLightClientKit/Error/ZcashErrorCode.swift

@@ -1,4 +1,4 @@
-// Generated using Sourcery 2.1.7 — https://github.com/krzysztofzablocki/Sourcery
+// Generated using Sourcery 2.2.5 — https://github.com/krzysztofzablocki/Sourcery
 // DO NOT EDIT
 
 /*
@@ -41,6 +41,8 @@ public enum ZcashErrorCode: String {
     case serviceBlockStreamFailed = "ZSRVC0000"
     /// LightWalletService.getSubtreeRoots failed.
     case serviceSubtreeRootsStreamFailed = "ZSRVC0009"
+    /// LightWalletService.getTaddressTxids failed.
+    case serviceGetTaddressTxidsFailed = "ZSRVC0010"
     /// SimpleConnectionProvider init of Connection failed.
     case simpleConnectionProvider = "ZSCPC0001"
     /// Downloaded file with sapling spending parameters isn't valid.
@@ -185,6 +187,12 @@ public enum ZcashErrorCode: String {
     case rustPutOrchardSubtreeRootsAllocationProblem = "ZRUST0060"
     /// Error from rust layer when calling ZcashRustBackend.putOrchardSubtreeRoots
     case rustPutOrchardSubtreeRoots = "ZRUST0061"
+    /// Error from rust layer when calling TorClient.init
+    case rustTorClientInit = "ZRUST0062"
+    /// Error from rust layer when calling TorClient.get
+    case rustTorClientGet = "ZRUST0063"
+    /// Error from rust layer when calling ZcashRustBackend.transactionDataRequests
+    case rustTransactionDataRequests = "ZRUST0064"
     /// SQLite query failed when fetching all accounts from the database.
     case accountDAOGetAll = "ZADAO0001"
     /// Fetched accounts from SQLite but can't decode them.
@@ -289,6 +297,8 @@ public enum ZcashErrorCode: String {
     case unifiedAddressInvalidInput = "ZWLTP0006"
     /// Can't create `Recipient` because input is invalid.
     case recipientInvalidInput = "ZWLTP0007"
+    /// Can't create `TexAddress` because input is invalid.
+    case texAddressInvalidInput = "ZWLTP0008"
     /// WalletTransactionEncoder wants to create transaction but files with sapling parameters are not present on disk.
     case walletTransEncoderCreateTransactionMissingSaplingParams = "ZWLTE0001"
     /// WalletTransactionEncoder wants to shield funds but files with sapling parameters are not present on disk.

package/ios/ZCashLightClientKit/Error/ZcashErrorCodeDefinition.swift

@@ -80,6 +80,9 @@ enum ZcashErrorDefinition {
     /// LightWalletService.getSubtreeRoots failed.
     // sourcery: code="ZSRVC0009"
     case serviceSubtreeRootsStreamFailed(_ error: LightWalletServiceError)
+    /// LightWalletService.getTaddressTxids failed.
+    // sourcery: code="ZSRVC0010"
+    case serviceGetTaddressTxidsFailed(_ error: LightWalletServiceError)
 
     // MARK: SQLite connection
 
@@ -367,6 +370,18 @@ enum ZcashErrorDefinition {
     /// - `rustError` contains error generated by the rust layer.
     /// sourcery: code="ZRUST0061"
     case rustPutOrchardSubtreeRoots(_ rustError: String)
+    /// Error from rust layer when calling TorClient.init
+    /// - `rustError` contains error generated by the rust layer.
+    /// sourcery: code="ZRUST0062"
+    case rustTorClientInit(_ rustError: String)
+    /// Error from rust layer when calling TorClient.get
+    /// - `rustError` contains error generated by the rust layer.
+    /// sourcery: code="ZRUST0063"
+    case rustTorClientGet(_ rustError: String)
+    /// Error from rust layer when calling ZcashRustBackend.transactionDataRequests
+    /// - `rustError` contains error generated by the rust layer.
+    /// sourcery: code="ZRUST0064"
+    case rustTransactionDataRequests(_ rustError: String)
 
     // MARK: - Account DAO
 
@@ -571,6 +586,9 @@ enum ZcashErrorDefinition {
     /// Can't create `Recipient` because input is invalid.
     // sourcery: code="ZWLTP0007"
     case recipientInvalidInput
+    /// Can't create `TexAddress` because input is invalid.
+    // sourcery: code="ZWLTP0008"
+    case texAddressInvalidInput
 
     // MARK: - WalletTransactionEncoder
 

package/ios/ZCashLightClientKit/Initializer.swift

@@ -90,6 +90,7 @@ public class Initializer {
     struct URLs {
         let fsBlockDbRoot: URL
         let dataDbURL: URL
+        let torDirURL: URL
         let generalStorageURL: URL
         let spendParamsURL: URL
         let outputParamsURL: URL
@@ -115,6 +116,7 @@ public class Initializer {
     let fsBlockDbRoot: URL
     let generalStorageURL: URL
     let dataDbURL: URL
+    let torDirURL: URL
     let spendParamsURL: URL
     let outputParamsURL: URL
     let saplingParamsSourceURL: SaplingParamsSourceURL
@@ -158,14 +160,14 @@ public class Initializer {
         fsBlockDbRoot: URL,
         generalStorageURL: URL,
         dataDbURL: URL,
+        torDirURL: URL,
         endpoint: LightWalletEndpoint,
         network: ZcashNetwork,
         spendParamsURL: URL,
         outputParamsURL: URL,
         saplingParamsSourceURL: SaplingParamsSourceURL,
         alias: ZcashSynchronizerAlias = .default,
-        loggingPolicy: LoggingPolicy = .default(.debug),
-        enableBackendTracing: Bool = false
+        loggingPolicy: LoggingPolicy = .default(.debug)
     ) {
         let container = DIContainer()
         
@@ -177,14 +179,14 @@ public class Initializer {
             fsBlockDbRoot: fsBlockDbRoot,
             generalStorageURL: generalStorageURL,
             dataDbURL: dataDbURL,
+            torDirURL: torDirURL,
             endpoint: endpoint,
             network: network,
             spendParamsURL: spendParamsURL,
             outputParamsURL: outputParamsURL,
             saplingParamsSourceURL: saplingParamsSourceURL,
             alias: alias,
-            loggingPolicy: loggingPolicy,
-            enableBackendTracing: enableBackendTracing
+            loggingPolicy: loggingPolicy
         )
         
         self.init(
@@ -207,14 +209,14 @@ public class Initializer {
         fsBlockDbRoot: URL,
         generalStorageURL: URL,
         dataDbURL: URL,
+        torDirURL: URL,
         endpoint: LightWalletEndpoint,
         network: ZcashNetwork,
         spendParamsURL: URL,
         outputParamsURL: URL,
         saplingParamsSourceURL: SaplingParamsSourceURL,
         alias: ZcashSynchronizerAlias = .default,
-        loggingPolicy: LoggingPolicy = .default(.debug),
-        enableBackendTracing: Bool = false
+        loggingPolicy: LoggingPolicy = .default(.debug)
     ) {
         // It's not possible to fail from constructor. Technically it's possible but it can be pain for the client apps to handle errors thrown
         // from constructor. So `parsingError` is just stored in initializer and `SDKSynchronizer.prepare()` throw this error if it exists.
@@ -224,14 +226,14 @@ public class Initializer {
             fsBlockDbRoot: fsBlockDbRoot,
             generalStorageURL: generalStorageURL,
             dataDbURL: dataDbURL,
+            torDirURL: torDirURL,
             endpoint: endpoint,
             network: network,
             spendParamsURL: spendParamsURL,
             outputParamsURL: outputParamsURL,
             saplingParamsSourceURL: saplingParamsSourceURL,
             alias: alias,
-            loggingPolicy: loggingPolicy,
-            enableBackendTracing: enableBackendTracing
+            loggingPolicy: loggingPolicy
         )
 
         self.init(
@@ -264,6 +266,7 @@ public class Initializer {
         self.fsBlockDbRoot = urls.fsBlockDbRoot
         self.generalStorageURL = urls.generalStorageURL
         self.dataDbURL = urls.dataDbURL
+        self.torDirURL = urls.torDirURL
         self.endpoint = endpoint
         self.spendParamsURL = urls.spendParamsURL
         self.outputParamsURL = urls.outputParamsURL
@@ -286,18 +289,19 @@ public class Initializer {
         fsBlockDbRoot: URL,
         generalStorageURL: URL,
         dataDbURL: URL,
+        torDirURL: URL,
         endpoint: LightWalletEndpoint,
         network: ZcashNetwork,
         spendParamsURL: URL,
         outputParamsURL: URL,
         saplingParamsSourceURL: SaplingParamsSourceURL,
         alias: ZcashSynchronizerAlias,
-        loggingPolicy: LoggingPolicy = .default(.debug),
-        enableBackendTracing: Bool = false
+        loggingPolicy: LoggingPolicy = .default(.debug)
     ) -> (URLs, ZcashError?) {
         let urls = URLs(
             fsBlockDbRoot: fsBlockDbRoot,
             dataDbURL: dataDbURL,
+            torDirURL: torDirURL,
             generalStorageURL: generalStorageURL,
             spendParamsURL: spendParamsURL,
             outputParamsURL: outputParamsURL
@@ -313,8 +317,7 @@ public class Initializer {
             alias: alias,
             networkType: network.networkType,
             endpoint: endpoint,
-            loggingPolicy: loggingPolicy,
-            enableBackendTracing: enableBackendTracing
+            loggingPolicy: loggingPolicy
         )
         
         return (updatedURLs, parsingError)
@@ -362,6 +365,10 @@ public class Initializer {
             return .failure(.initializerCantUpdateURLWithAlias(urls.dataDbURL))
         }
 
+        guard let updatedTorDirURL = urls.torDirURL.updateLastPathComponent(with: alias) else {
+            return .failure(.initializerCantUpdateURLWithAlias(urls.torDirURL))
+        }
+
         guard let updatedSpendParamsURL = urls.spendParamsURL.updateLastPathComponent(with: alias) else {
             return .failure(.initializerCantUpdateURLWithAlias(urls.spendParamsURL))
         }
@@ -378,6 +385,7 @@ public class Initializer {
             URLs(
                 fsBlockDbRoot: updatedFsBlockDbRoot,
                 dataDbURL: updatedDataDbURL,
+                torDirURL: updatedTorDirURL,
                 generalStorageURL: updatedGeneralStorageURL,
                 spendParamsURL: updatedSpendParamsURL,
                 outputParamsURL: updateOutputParamsURL
@@ -415,8 +423,8 @@ public class Initializer {
         if let seed, try await rustBackend.listAccounts().isEmpty {
             var chainTip: UInt32?
             
-            if walletMode == .restoreWallet {
-                chainTip = UInt32(try await lightWalletService.latestBlockHeight())
+            if walletMode == .restoreWallet, let latestBlockHeight = try? await lightWalletService.latestBlockHeight() {
+                chainTip = UInt32(latestBlockHeight)
             }
             
             _ = try await rustBackend.createAccount(

package/ios/ZCashLightClientKit/Metrics/SDKMetrics.swift

@@ -118,7 +118,6 @@ final class SDKMetricsImpl: SDKMetrics {
         try? await Task.sleep(nanoseconds: 100_000)
 
         for action in cbpOverview {
-
             let report = action.value
 
             var resText = """

package/ios/ZCashLightClientKit/Model/FiatCurrencyResult.swift

@@ -0,0 +1,25 @@
+//
+//  FiatCurrencyResult.swift
+//
+//
+//  Created by Lukáš Korba on 31.07.2024.
+//
+
+import Foundation
+
+/// The model representing currency for ZEC-XXX conversion. Initial implementation
+/// provides only USD value.
+public struct FiatCurrencyResult: Equatable {
+    public enum State: Equatable {
+        /// Last fetch failed, cached value is returned instead.
+        case error
+        /// Refresh has been triggered, returning cached value but informing about request in flight.
+        case fetching
+        /// Fetch of the value ended up as success so new value in returned.
+        case success
+    }
+    
+    public let date: Date
+    public let rate: NSDecimalNumber
+    public var state: State
+}

package/ios/ZCashLightClientKit/Model/Proposal.swift

@@ -35,7 +35,7 @@ public extension Proposal {
     /// passed to `Synchronizer.createProposedTransactions`. It should never be called in
     /// production code.
     static func testOnlyFakeProposal(totalFee: UInt64) -> Self {
-        var ffiProposal = FfiProposal()
+        let ffiProposal = FfiProposal()
         var balance = FfiTransactionBalance()
 
         balance.feeRequired = totalFee

package/ios/ZCashLightClientKit/Model/TransactionDataRequest.swift

@@ -0,0 +1,26 @@
+//
+//  TransactionDataRequest.swift
+//
+//
+//  Created by Lukáš Korba on 08-15-2024.
+//
+
+import Foundation
+
+struct SpendsFromAddress: Equatable {
+    let address: String
+    let blockRangeStart: UInt32
+    let blockRangeEnd: UInt32?
+}
+
+enum TransactionDataRequest: Equatable {
+    case getStatus([UInt8])
+    case enhancement([UInt8])
+    case spendsFromAddress(SpendsFromAddress)
+}
+
+enum TransactionStatus: Equatable {
+    case txidNotRecognized
+    case notInMainChain
+    case mined(BlockHeight)
+}