react-native-zcash 0.9.13 → 0.10.0

package/ios/ZCashLightClientKit/Transaction/WalletTransactionEncoder.swift

@@ -12,6 +12,7 @@ class WalletTransactionEncoder: TransactionEncoder {
     let rustBackend: ZcashRustBackendWelding
     let repository: TransactionRepository
     let logger: Logger
+    let sdkFlags: SDKFlags
 
     private let outputParamsURL: URL
     private let spendParamsURL: URL
@@ -28,7 +29,8 @@ class WalletTransactionEncoder: TransactionEncoder {
         outputParams: URL,
         spendParams: URL,
         networkType: NetworkType,
-        logger: Logger
+        logger: Logger,
+        sdkFlags: SDKFlags
     ) {
         self.rustBackend = rustBackend
         self.dataDbURL = dataDb
@@ -39,9 +41,12 @@ class WalletTransactionEncoder: TransactionEncoder {
         self.spendParamsURL = spendParams
         self.networkType = networkType
         self.logger = logger
+        self.sdkFlags = sdkFlags
     }
     
     convenience init(initializer: Initializer) {
+        let sdkFlags = initializer.container.resolve(SDKFlags.self)
+        
         self.init(
             rustBackend: initializer.rustBackend,
             dataDb: initializer.dataDbURL,
@@ -51,18 +56,19 @@ class WalletTransactionEncoder: TransactionEncoder {
             outputParams: initializer.outputParamsURL,
             spendParams: initializer.spendParamsURL,
             networkType: initializer.network.networkType,
-            logger: initializer.logger
+            logger: initializer.logger,
+            sdkFlags: sdkFlags
         )
     }
 
     func proposeTransfer(
-        accountIndex: Int,
+        accountUUID: AccountUUID,
         recipient: String,
         amount: Zatoshi,
         memoBytes: MemoBytes?
     ) async throws -> Proposal {
         let proposal = try await rustBackend.proposeTransfer(
-            account: Int32(accountIndex),
+            accountUUID: accountUUID,
             to: recipient,
             value: amount.amount,
             memo: memoBytes
@@ -72,13 +78,13 @@ class WalletTransactionEncoder: TransactionEncoder {
     }
 
     func proposeShielding(
-        accountIndex: Int,
+        accountUUID: AccountUUID,
         shieldingThreshold: Zatoshi,
         memoBytes: MemoBytes?,
         transparentReceiver: String? = nil
     ) async throws -> Proposal? {
         guard let proposal = try await rustBackend.proposeShielding(
-            account: Int32(accountIndex),
+            accountUUID: accountUUID,
             memo: memoBytes,
             shieldingThreshold: shieldingThreshold,
             transparentReceiver: transparentReceiver
@@ -89,11 +95,11 @@ class WalletTransactionEncoder: TransactionEncoder {
 
     func proposeFulfillingPaymentFromURI(
         _ uri: String,
-        accountIndex: Int
+        accountUUID: AccountUUID
     ) async throws -> Proposal {
         let proposal = try await rustBackend.proposeTransferFromURI(
             uri,
-            account: Int32(accountIndex)
+            accountUUID: accountUUID
         )
         return Proposal(inner: proposal)
     }
@@ -111,6 +117,10 @@ class WalletTransactionEncoder: TransactionEncoder {
             usk: spendingKey
         )
 
+        return try await fetchTransactionsForTxIds(txIds)
+    }
+
+    func fetchTransactionsForTxIds(_ txIds: [Data]) async throws -> [ZcashTransaction.Overview] {
         logger.debug("transaction ids: \(txIds)")
 
         var txs: [ZcashTransaction.Overview] = []
@@ -125,7 +135,12 @@ class WalletTransactionEncoder: TransactionEncoder {
     func submit(
         transaction: EncodedTransaction
     ) async throws {
-        let response = try await self.lightWalletService.submit(spendTransaction: transaction.raw)
+        let response = try await self.lightWalletService.submit(
+            spendTransaction: transaction.raw,
+            mode: await sdkFlags.torEnabled
+            ? ServiceMode.txIdGroup(prefix: "submit", txId: transaction.transactionId)
+            : ServiceMode.direct
+        )
 
         guard response.errorCode >= 0 else {
             throw TransactionEncoderError.submitError(code: Int(response.errorCode), message: response.errorMessage)

package/ios/ZCashLightClientKit/Utils/SDKFlags.swift

@@ -0,0 +1,71 @@
+//
+//  SDKFlags.swift
+//  ZcashLightClientKit
+//
+//  Created by Lukáš Korba on 2025-07-18.
+//
+
+/// A singleton actor with control flags for the SDK.
+actor SDKFlags {
+    /// `torEnabled` controls `SeviceMode` for the connection to the `LightWalletService`.
+    /// When disabled, the `ServiceMode.direct` (GRPC) is enforced.
+    /// When enabled, all Tor cases in `ServiceMode` are allowed.
+    /// Accessible only internally inside the SDK to control the connection
+    var torEnabled: Bool
+    
+    /// `exchangeRateEnabled` controls whether fetch of exnchage rate is enabled or disabled.
+    /// When enabled, the `TorClient` is initialized but is not used for lwdService calls.
+    var exchangeRateEnabled: Bool
+    
+    /// This flag communicates state of initialization of `TorClient`
+    /// `nil` = the attempt to initialize `TorClient` hasn't been initiated
+    /// `false` = initialization of `TorClient` failed
+    /// `true` = initialization of `TorClient` succeeded
+    var torClientInitializationSuccessfullyDone: Bool?
+    
+    /// Runtime helper flag used to mark whether chainTip CBP action has been done.
+    var chainTipUpdated = false
+    
+    init(
+        torEnabled: Bool,
+        exchangeRateEnabled: Bool
+    ) {
+        self.torEnabled = torEnabled
+        self.exchangeRateEnabled = exchangeRateEnabled
+    }
+    
+    /// Helper method that wraps the decision logic for `ServiceMode`.
+    /// When Tor is not enabled, it always must use fallback to `.direct` mode.
+    func ifTor(_ serviceMode: ServiceMode) -> ServiceMode {
+        torEnabled ? serviceMode : .direct
+    }
+    
+    /// Use to update the `torEnabled` flag
+    func torFlagUpdate(_ newFlag: Bool) {
+        torEnabled = newFlag
+    }
+    
+    // Use to update the `exchangeRateEnabled` flag
+    func exchangeRateFlagUpdate(_ newFlag: Bool) {
+        exchangeRateEnabled = newFlag
+    }
+    
+    /// Use to update the `torClientInitializationSuccessfullyDone` flag
+    func torClientInitializationSuccessfullyDoneFlagUpdate(_ newFlag: Bool?) {
+        torClientInitializationSuccessfullyDone = newFlag
+    }
+    
+    /// Use to update the `chainTipUpdated` flag
+    func markChainTipAsUpdated() {
+        chainTipUpdated = true
+    }
+    
+    /// The client using the SDK called `stop()`, for example when the app is about to enter the background lifecycle.
+    /// Use this to reset or update any relevant flags if needed.
+    func sdkStopped() {
+        // The SDK is stopped, so there will be a gap before the next start (doesn’t matter whether it’s a cold or foreground start).
+        // The chain tip might be old enough to cause issues when attempting to send or shield funds before the next chain tip update call finishes.
+        // Therefore, it is reset here.
+        chainTipUpdated = false
+    }
+}

package/ios/libzcashlc.xcframework/Info.plist

@@ -8,32 +8,32 @@
 			<key>BinaryPath</key>
 			<string>libzcashlc.a</string>
 			<key>LibraryIdentifier</key>
-			<string>ios-arm64_x86_64-simulator</string>
+			<string>ios-arm64</string>
 			<key>LibraryPath</key>
 			<string>libzcashlc.a</string>
 			<key>SupportedArchitectures</key>
 			<array>
 				<string>arm64</string>
-				<string>x86_64</string>
 			</array>
 			<key>SupportedPlatform</key>
 			<string>ios</string>
-			<key>SupportedPlatformVariant</key>
-			<string>simulator</string>
 		</dict>
 		<dict>
 			<key>BinaryPath</key>
 			<string>libzcashlc.a</string>
 			<key>LibraryIdentifier</key>
-			<string>ios-arm64</string>
+			<string>ios-arm64_x86_64-simulator</string>
 			<key>LibraryPath</key>
 			<string>libzcashlc.a</string>
 			<key>SupportedArchitectures</key>
 			<array>
 				<string>arm64</string>
+				<string>x86_64</string>
 			</array>
 			<key>SupportedPlatform</key>
 			<string>ios</string>
+			<key>SupportedPlatformVariant</key>
+			<string>simulator</string>
 		</dict>
 	</array>
 	<key>CFBundlePackageType</key>