react-native-zcash 0.9.13 → 0.10.0

package/ios/ZCashLightClientKit/Resources/checkpoints/testnet/3620000.json

@@ -0,0 +1,8 @@
+{
+  "network": "test",
+  "height": "3620000",
+  "hash": "00052a1efb59ac73963ffa56c29eb2543f16b06024ef9ea447ee603a75fb01e5",
+  "time": 1760455780,
+  "saplingTree": "0132f66e1d070bfc0a96827abfc6512c459ea415d10f425936650d89f7eefbf1620180a9e72c08992751cb877a6b78189330ce82a7ff2c107530286502dd6b6ca9581f0159fa19f986909db72bfe1ca0960bda00c5b2ddd7882c02be4d0de683bdd70816000170067eeba09b47394b8063db861a2cb595283a34fd6ae037dcbd1b21f46f2f4f017ba274fcb3ebe11e270e06755b479a74bb80d9b2f055f469d08c81d841839c5000015f407330d2f48b1764f1ee2240c9a8acf19ce74c17572f8bcedf8bf7a7af4a0b000001846bfb982baf84c4d5832f9d8e267c3cc444dc54151dd02c2b2b50b4d8f6de2800000001381aa6dfe03e945e943fe6d128cb664fe3fd78de4cafebd334c231e243bba31b00016c9647f801e7c1048fc845ec265ec3e886df91c1acdacad501de9608b54a63490000016c8ccd12a93c240aa208bfcd527270aab8afd0b7e9f160114a10335b8167d34900000000000000000000000000",
+  "orchardTree": "01eb4c5568aca8a2ef026692dd0450d8f89d45733e5eb219f5e54c01822c841320001f01252669207efc73a6ce4dcd8ab0134813964f7c8b153a35223d19316e3c8b230201e3d317ef91ddf86df4bb941d8dc803f6fbcd787ed5863e33321a7b7f5380b13401ad8edf346446bab37d5cd8648213441bc623236ba6927583cfb4b31153402526014873756dcbe9aca4c43c2f24c1f567840989e18d74ab9ef763dd97e7e65a930001148c5620d32811e1d6822e80d92f188927002f3c0fe05a352fcd0788aa58000f0191ae9319eb928a8bc080cc1ac1a43991d3511ed864cebc7083b0db1b7797840701550682643aef66fb9d829f26b7cdf36c14abfd0457481658b31e61fad3e18b05000001baddc63339bcecc8faed385b6f16576c6378d9cae9ec60974265b4afc1781f050173ae007fce7670a9f40639ef998b23b8e8b7990c9894b13de595d7592f32c22301622c7605d17857460d412e4fff3265e15416029f607b7a5daaf2511a4020151101067fc882d2ebfdf7969fc02814cbe49dda32e267e963a0e79fad8eb7e0694b0400017f93215cf466b333690a951c86254d6729672189dc06160f378267efb70b580a0125934a8c8cde7b4ba7e51d78f2321c7e286d140811a192f692f29d3f0ecce510000000000000000000000000000000"
+}

package/ios/ZCashLightClientKit/Resources/checkpoints/testnet/3630000.json

@@ -0,0 +1,8 @@
+{
+  "network": "test",
+  "height": "3630000",
+  "hash": "000ea2233e0ac4b3ce39c6754b1bb31818733bbcc56f6c415cfcf77e1d72bdca",
+  "time": 1760942071,
+  "saplingTree": "019c8a519919379f9d0214082ef1a63ef491bb4c806a3ca8e738215f4b364e1532001f0000000000000000000001e7cc0b98ed9a79a2265e371157a60b9500e3050d427e327c869fe7d99c29e0720001381aa6dfe03e945e943fe6d128cb664fe3fd78de4cafebd334c231e243bba31b00016c9647f801e7c1048fc845ec265ec3e886df91c1acdacad501de9608b54a63490000016c8ccd12a93c240aa208bfcd527270aab8afd0b7e9f160114a10335b8167d34900000000000000000000000000",
+  "orchardTree": "01821d33d6136168987e34cd53f8a36a4f91259e1e9d80477c000fd33aa9508429001f000001c3d687aa7ba53bc60f4ec86dbc904184c9349a74a6446967b156cbcf26a3f121016f96229df53a9b48a1d6250a9ebc824f9c124c6461b603e1ce20596652e6b5040001c522d7422ba81f39a07e8e0a4ba4e626c9435da7570ce7a772201ac03fba401f01291b7e15ca410ea6f32f2d9da3900c288e0f841be8281f6228d1bafcd0f34d1e01499225d6d20b571e3f7378de8918a3d87942198f5f49fe79526c00b65be580110001baddc63339bcecc8faed385b6f16576c6378d9cae9ec60974265b4afc1781f050173ae007fce7670a9f40639ef998b23b8e8b7990c9894b13de595d7592f32c22301622c7605d17857460d412e4fff3265e15416029f607b7a5daaf2511a4020151101067fc882d2ebfdf7969fc02814cbe49dda32e267e963a0e79fad8eb7e0694b0400017f93215cf466b333690a951c86254d6729672189dc06160f378267efb70b580a0125934a8c8cde7b4ba7e51d78f2321c7e286d140811a192f692f29d3f0ecce510000000000000000000000000000000"
+}

package/ios/ZCashLightClientKit/Resources/checkpoints/testnet/3640000.json

@@ -0,0 +1,8 @@
+{
+  "network": "test",
+  "height": "3640000",
+  "hash": "00603418682be6315c6c3fb5f95f5b109c26e9fa5e8d7fdd027649830ce5160d",
+  "time": 1761349315,
+  "saplingTree": "0162ef7cb81362b6059dbc395509763f71f960618bb80ccb1b038eb7710e265a45001f019cec46b4150a816a044e70d80c1049fc13374239ebb4d3451f2d3249693c8355017e194dd47f8847c19e8d92cff6a259d2786d91aae1e8e6202177ce9861e544640183df6f677445e2b9e7d0559fe08bdb6a081cdf57f7f6c93fcddbe313ef83c42e01c10dc9d7451d9ca1ee065fb17b45ed3d0ab0c454fd99af88335b2f0e6b865d27000001ad9c49434f1b3ac45a49b1c45044ce21567f777da1dab6038a0e12d40d40322401cd0c3aaaa17c135171045a6f4f282da4cf87c54a1684909d7cc123a1377e641a00015e95cd8e34301c9675721d490965828837420c68d2442042539d2723ada8482601e7cc0b98ed9a79a2265e371157a60b9500e3050d427e327c869fe7d99c29e0720001381aa6dfe03e945e943fe6d128cb664fe3fd78de4cafebd334c231e243bba31b00016c9647f801e7c1048fc845ec265ec3e886df91c1acdacad501de9608b54a63490000016c8ccd12a93c240aa208bfcd527270aab8afd0b7e9f160114a10335b8167d34900000000000000000000000000",
+  "orchardTree": "0197a6997e2220a367b5027f932829106cf5bea6279dd4d83894abb29dfa3ffa1d01c8bb6987eea34321aedaa4b8b3678f35410e02036ccc09c0cefb79e9d8b6501e1f000001d3c6308d75b3ccf34b258914265420908a5063133a3c3633ce85bcee980a9f2f0109617761ee652cc9a895a1639bc4cd2cce38a3068982827012833f177a8d1b220001012e55fdb78e846c44975dd9c6cfe6edd2bf605964fe141690a992bdabc1183c0000019e1bfb94f5dc4b7c15092ad23d89c4e3f197db541f54b3587f404c1d4d981b0a01baddc63339bcecc8faed385b6f16576c6378d9cae9ec60974265b4afc1781f050173ae007fce7670a9f40639ef998b23b8e8b7990c9894b13de595d7592f32c22301622c7605d17857460d412e4fff3265e15416029f607b7a5daaf2511a4020151101067fc882d2ebfdf7969fc02814cbe49dda32e267e963a0e79fad8eb7e0694b0400017f93215cf466b333690a951c86254d6729672189dc06160f378267efb70b580a0125934a8c8cde7b4ba7e51d78f2321c7e286d140811a192f692f29d3f0ecce510000000000000000000000000000000"
+}

package/ios/ZCashLightClientKit/Resources/checkpoints/testnet/3650000.json

@@ -0,0 +1,8 @@
+{
+  "network": "test",
+  "height": "3650000",
+  "hash": "00067490f8cf65a5e769efefbc781f151e1ee3b1803a39c6282587acd6d19171",
+  "time": 1761796831,
+  "saplingTree": "01926500b947cb82b43c4a6d6a01b9fe4593c08dc53960ed1853efe29eb903f94101613fdda68e22f9abf54080348476c16e680c169d2d4ccd02ea0e166fa5f4394f1f0000019d0f27d77319f2f7384521f24f44469e099c94838998366d917429c6d62e731f00011ceb5e5afbb2c104ad016d06d956468b5ea34c6c74a4ff9980f6fb997f43773400019af801d182789c520fa0acce68f062c4d6ef1a64fb5c567b781373af4ef79c30017ac683606139b0c7f3c635d90eb3661fd0ac0f09a340672effb211696c609b060190bf43e79655eaf302bd5fcd32e12013179e8efa8348c18fd536e6b92757e850000001b61a4aeb2a01567a25f746b7fd28a636a7ff5fc6489bee86d4da03d4a77d573f01381aa6dfe03e945e943fe6d128cb664fe3fd78de4cafebd334c231e243bba31b00016c9647f801e7c1048fc845ec265ec3e886df91c1acdacad501de9608b54a63490000016c8ccd12a93c240aa208bfcd527270aab8afd0b7e9f160114a10335b8167d34900000000000000000000000000",
+  "orchardTree": "01501b3d441b6b3903ee09681da2dd617d617db3cf446763a6cc576ff6bd94393a01ad965d4ab33f722e96b6716626e907c98d6b3a59a13c589d6c8783ab5e1499211f000001c5f99f1f55bb5be2324301827b5f7f1a2c58db6d5a5af584e8633c1f6b1217270001b33b32a4d69abd2d17b830b17e965a99444e8e5f28c48a1a7e59afa747087e0300017bb74adcadc0aeee4333c9303b6b4ca42761f510cd430168bcce42b0cc80643700019e1bfb94f5dc4b7c15092ad23d89c4e3f197db541f54b3587f404c1d4d981b0a01baddc63339bcecc8faed385b6f16576c6378d9cae9ec60974265b4afc1781f050173ae007fce7670a9f40639ef998b23b8e8b7990c9894b13de595d7592f32c22301622c7605d17857460d412e4fff3265e15416029f607b7a5daaf2511a4020151101067fc882d2ebfdf7969fc02814cbe49dda32e267e963a0e79fad8eb7e0694b0400017f93215cf466b333690a951c86254d6729672189dc06160f378267efb70b580a0125934a8c8cde7b4ba7e51d78f2321c7e286d140811a192f692f29d3f0ecce510000000000000000000000000000000"
+}

package/ios/ZCashLightClientKit/Resources/checkpoints/testnet/3660000.json

@@ -0,0 +1,8 @@
+{
+  "network": "test",
+  "height": "3660000",
+  "hash": "000060175a33760c57e4b76d163917588a589eb6fb1cb14b782c868d187c7db5",
+  "time": 1762246118,
+  "saplingTree": "0177787b949a0328f7d6b8d7bf12096c53c34235e3c3224fa8e3fa7c625cde4648001f019ae360e3607817c2016bce012db81de5542c6b06258146e6e1b35c855f35364a018498cd69a459c0fedf6fdc04ad2cd93fd044492ebd836119384255bb847b11170001d32e1d2e50310291859c3ffe6dc1a26aad99a806fe75b88021668942e64fb047010d4d64feda8fcbbf2cbab0deec5b3749d60b70be00deeb02a25dc850d97b6b3d00011cb597eca8d34adced5e082c70d07976c872c6202ce4bd2e0b9d3bc7e58e7a050001b6f4d2455328ded63cf99ba4d55865a485da4f2a7bff9694cc5881ceef367c710001bbff4bc7f0695b8e9362fc4ea2b205f248648f22ca0a670d373d5cb45aabec2301b61a4aeb2a01567a25f746b7fd28a636a7ff5fc6489bee86d4da03d4a77d573f01381aa6dfe03e945e943fe6d128cb664fe3fd78de4cafebd334c231e243bba31b00016c9647f801e7c1048fc845ec265ec3e886df91c1acdacad501de9608b54a63490000016c8ccd12a93c240aa208bfcd527270aab8afd0b7e9f160114a10335b8167d34900000000000000000000000000",
+  "orchardTree": "01b4c3a89e0f4a5e2b4ae8dfd9e85ac12062a7bb4c97db4d3894591628c2619309001f01c467188e86f4f597019dcdfdb97a30c9bb61e02c64d46cf58563a1a805e2410f01ed400d833428359f7d5df7d7386ff95bf88b956aa78a6d35da0aa34d74d9a23b00000191af6bc58f747ba41c76162fad7fd01390b033a7043f3f751f85e00dd5168808000001ff003576721efedc9ec62db4bcba91fc1a0738b18cac5c15eb316f77c5243826019e1bfb94f5dc4b7c15092ad23d89c4e3f197db541f54b3587f404c1d4d981b0a01baddc63339bcecc8faed385b6f16576c6378d9cae9ec60974265b4afc1781f050173ae007fce7670a9f40639ef998b23b8e8b7990c9894b13de595d7592f32c22301622c7605d17857460d412e4fff3265e15416029f607b7a5daaf2511a4020151101067fc882d2ebfdf7969fc02814cbe49dda32e267e963a0e79fad8eb7e0694b0400017f93215cf466b333690a951c86254d6729672189dc06160f378267efb70b580a0125934a8c8cde7b4ba7e51d78f2321c7e286d140811a192f692f29d3f0ecce510000000000000000000000000000000"
+}

package/ios/ZCashLightClientKit/Resources/checkpoints/testnet/3670000.json

@@ -0,0 +1,8 @@
+{
+  "network": "test",
+  "height": "3670000",
+  "hash": "007b830e2085459d6664744e23bbccade5419321f75f403da984cbbe8738a203",
+  "time": 1762637018,
+  "saplingTree": "0173a970c890d8d7b995a670f06725e2e6d776b342c878ab3e5c516069d4feb548012e8eb25af1e8114b0fa656ba7d7409b75f26196fa6b4feea428f0bfed7edb71a1f0152c6d9861e4104318622347eb8f9fc9d3ec3786ddd66f4619d4ee2470096024b01a9f423c5d9a6ac89f2bbc16bc6cf52f63f1f5b56da1ab15b47f176abe9f7f1530101b35b4342a14380384925d41c4e7c1bda66d0c6810cd2c7c4c54e4f591e9c460001f7a1f87d0a650e6c491ce43905b844d968fd5d1a10769d0f9ceba06592a6d52701c1cd287cf0f8685f301e2acf83d50df8a00a24dc7fcd451b12375a454538950e019b4189ad65743e8a119fa7e16bec8c88352a0e1003e4e3f219d840d16e19fc3b000000000000018b0a3f358e958d827dd8e9df4da31aa2cf8b6844220553d0df9b40cce3a50d09016c9647f801e7c1048fc845ec265ec3e886df91c1acdacad501de9608b54a63490000016c8ccd12a93c240aa208bfcd527270aab8afd0b7e9f160114a10335b8167d34900000000000000000000000000",
+  "orchardTree": "01ec23d10d549e8edcb8eef56c090b67f1551aa374e8ff56dddf782e3d77cb8312001f013fb80b00d2d1172892712812cd957f4d64180baa04db66290b8c30c52348c013000000000114685d870f35ab94efc2972908c0d3121295750745bda57af9f62f4f9cdf8c130186c7a8020a25e94fa40b606eab684131bd9a9593f6f27b615cdd55e56b423d1801ff003576721efedc9ec62db4bcba91fc1a0738b18cac5c15eb316f77c5243826019e1bfb94f5dc4b7c15092ad23d89c4e3f197db541f54b3587f404c1d4d981b0a01baddc63339bcecc8faed385b6f16576c6378d9cae9ec60974265b4afc1781f050173ae007fce7670a9f40639ef998b23b8e8b7990c9894b13de595d7592f32c22301622c7605d17857460d412e4fff3265e15416029f607b7a5daaf2511a4020151101067fc882d2ebfdf7969fc02814cbe49dda32e267e963a0e79fad8eb7e0694b0400017f93215cf466b333690a951c86254d6729672189dc06160f378267efb70b580a0125934a8c8cde7b4ba7e51d78f2321c7e286d140811a192f692f29d3f0ecce510000000000000000000000000000000"
+}

package/ios/ZCashLightClientKit/Rust/ZcashKeyDerivationBackend.swift

@@ -93,26 +93,46 @@ struct ZcashKeyDerivationBackend: ZcashKeyDerivationBackendWelding {
 
     // MARK: Address Derivation
 
+    func deriveUnifiedAddressFrom(ufvk: String) throws -> UnifiedAddress {
+        let ffiAddressPtr = zcashlc_derive_address_from_ufvk(
+            networkType.networkId,
+            [CChar](ufvk.utf8CString),
+            nil
+        )
+        
+        guard let ffiAddressPtr else {
+            throw ZcashError.rustDeriveAddressFromUfvk(
+                ZcashKeyDerivationBackend.lastErrorMessage(fallback: "`deriveAddressFromUfvk` failed with unknown error")
+            )
+        }
+
+        defer { zcashlc_free_ffi_address(ffiAddressPtr) }
+        
+        return ffiAddressPtr.pointee.unsafeToUnifiedAddress(networkType)
+    }
+    
     func deriveUnifiedSpendingKey(
         from seed: [UInt8],
-        accountIndex: Int32
+        accountIndex: Zip32AccountIndex
     ) throws -> UnifiedSpendingKey {
-        let binaryKeyPtr = seed.withUnsafeBufferPointer { seedBufferPtr in
+        let boxedSlicePtr = seed.withUnsafeBufferPointer { seedBufferPtr in
             return zcashlc_derive_spending_key(
                 seedBufferPtr.baseAddress,
                 UInt(seed.count),
-                accountIndex,
+                LCZip32Index(accountIndex.index),
                 networkType.networkId
             )
         }
 
-        defer { zcashlc_free_binary_key(binaryKeyPtr) }
+        defer { zcashlc_free_boxed_slice(boxedSlicePtr) }
 
-        guard let binaryKey = binaryKeyPtr?.pointee else {
-            throw ZcashError.rustDeriveUnifiedSpendingKey(lastErrorMessage(fallback: "`deriveUnifiedSpendingKey` failed with unknown error"))
+        guard let boxedSlice = boxedSlicePtr?.pointee else {
+            throw ZcashError.rustDeriveUnifiedSpendingKey(
+                ZcashKeyDerivationBackend.lastErrorMessage(fallback: "`deriveUnifiedSpendingKey` failed with unknown error")
+            )
         }
 
-        return binaryKey.unsafeToUnifiedSpendingKey(network: networkType)
+        return boxedSlice.unsafeToUnifiedSpendingKey(network: networkType)
     }
     
     func deriveUnifiedFullViewingKey(from spendingKey: UnifiedSpendingKey) throws -> UnifiedFullViewingKey {
@@ -123,7 +143,7 @@ struct ZcashKeyDerivationBackend: ZcashKeyDerivationBackendWelding {
                 networkType.networkId
             ) else {
                 throw ZcashError.rustDeriveUnifiedFullViewingKey(
-                    lastErrorMessage(fallback: "`deriveUnifiedFullViewingKey` failed with unknown error")
+                    ZcashKeyDerivationBackend.lastErrorMessage(fallback: "`deriveUnifiedFullViewingKey` failed with unknown error")
                 )
             }
 
@@ -136,7 +156,7 @@ struct ZcashKeyDerivationBackend: ZcashKeyDerivationBackendWelding {
             throw ZcashError.rustDeriveUnifiedFullViewingKeyInvalidDerivedKey
         }
 
-        return UnifiedFullViewingKey(validatedEncoding: derived, account: spendingKey.account)
+        return UnifiedFullViewingKey(validatedEncoding: derived)
     }
 
     func getSaplingReceiver(for uAddr: UnifiedAddress) throws -> SaplingAddress {
@@ -171,9 +191,68 @@ struct ZcashKeyDerivationBackend: ZcashKeyDerivationBackendWelding {
         return TransparentAddress(validatedEncoding: transparentReceiverStr)
     }
 
+    static func deriveArbitraryWalletKey(
+        contextString: [UInt8],
+        from seed: [UInt8]
+    ) throws -> [UInt8] {
+        let boxedSlicePtr = contextString.withUnsafeBufferPointer { contextStringBufferPtr in
+            seed.withUnsafeBufferPointer { seedBufferPtr in
+                return zcashlc_derive_arbitrary_wallet_key(
+                    contextStringBufferPtr.baseAddress,
+                    UInt(contextString.count),
+                    seedBufferPtr.baseAddress,
+                    UInt(seed.count)
+                )
+            }
+        }
+
+        defer { zcashlc_free_boxed_slice(boxedSlicePtr) }
+
+        guard let key = boxedSlicePtr?.pointee else {
+            throw ZcashError.rustDeriveArbitraryWalletKey(
+                ZcashKeyDerivationBackend.lastErrorMessage(fallback: "`deriveArbitraryWalletKey` failed with unknown error")
+            )
+        }
+
+        return key.ptr.toByteArray(
+            length: Int(key.len)
+        )
+    }
+
+    func deriveArbitraryAccountKey(
+        contextString: [UInt8],
+        from seed: [UInt8],
+        accountIndex: Zip32AccountIndex
+    ) throws -> [UInt8] {
+        let boxedSlicePtr = contextString.withUnsafeBufferPointer { contextStringBufferPtr in
+            seed.withUnsafeBufferPointer { seedBufferPtr in
+                return zcashlc_derive_arbitrary_account_key(
+                    contextStringBufferPtr.baseAddress,
+                    UInt(contextString.count),
+                    seedBufferPtr.baseAddress,
+                    UInt(seed.count),
+                    LCZip32Index(accountIndex.index),
+                    networkType.networkId
+                )
+            }
+        }
+
+        defer { zcashlc_free_boxed_slice(boxedSlicePtr) }
+
+        guard let key = boxedSlicePtr?.pointee else {
+            throw ZcashError.rustDeriveArbitraryAccountKey(
+                ZcashKeyDerivationBackend.lastErrorMessage(fallback: "`deriveArbitraryAccountKey` failed with unknown error")
+            )
+        }
+
+        return key.ptr.toByteArray(
+            length: Int(key.len)
+        )
+    }
+
     // MARK: Error Handling
 
-    private func lastErrorMessage(fallback: String) -> String {
+    private static func lastErrorMessage(fallback: String) -> String {
         let errorLen = zcashlc_last_error_length()
         defer { zcashlc_clear_last_error() }
 

package/ios/ZCashLightClientKit/Rust/ZcashKeyDerivationBackendWelding.swift

@@ -40,12 +40,17 @@ protocol ZcashKeyDerivationBackendWelding {
     /// - Returns: true when the encoded string is a valid UFVK. false in any other case
     func isValidUnifiedFullViewingKey(_ ufvk: String) -> Bool
 
-    /// Derives and returns a unified spending key from the given seed for the given account ID.
+    /// Derives and returns a UnifiedAddress from a UnifiedFullViewingKey
+    /// - Parameter ufvk: UTF-8 encoded String containing a valid UFVK
+    /// - Returns: the corresponding default `UnifiedAddress`
+    func deriveUnifiedAddressFrom(ufvk: String) throws -> UnifiedAddress
+
+    /// Derives and returns a unified spending key from the given seed and ZIP 32 account index.
     /// Returns the binary encoding of the spending key. The caller should manage the memory of (and store, if necessary) the returned spending key in a secure fashion.
     /// - Parameter seed: a Byte Array with the seed
-    /// - Parameter accountIndex:account index that the key can spend from
+    /// - Parameter accountIndex: the ZIP 32 index of the account from which the key can spend
     /// - Throws: `rustDeriveUnifiedSpendingKey` if rust layer returns error.
-    func deriveUnifiedSpendingKey(from seed: [UInt8], accountIndex: Int32) throws -> UnifiedSpendingKey
+    func deriveUnifiedSpendingKey(from seed: [UInt8], accountIndex: Zip32AccountIndex) throws -> UnifiedSpendingKey
 
     /// Derives a `UnifiedFullViewingKey` from a `UnifiedSpendingKey`
     /// - Parameter spendingKey: the `UnifiedSpendingKey` to derive from
@@ -70,4 +75,35 @@ protocol ZcashKeyDerivationBackendWelding {
     ///     - `rustGetTransparentReceiverInvalidAddress` if failed to get transparent receiver for unified address.
     ///     - `rustGetTransparentReceiverInvalidReceiver` if generated transparent receiver is invalid.
     func getTransparentReceiver(for uAddr: UnifiedAddress) throws -> TransparentAddress
+
+    /// Derives and returns a ZIP 32 Arbitrary Key from the given seed at the "wallet level", i.e.
+    /// directly from the seed with no ZIP 32 path applied.
+    ///
+    /// The resulting key will be the same across all networks (Zcash mainnet, Zcash testnet,
+    /// OtherCoin mainnet, and so on). You can think of it as a context-specific seed fingerprint
+    /// that can be used as (static) key material.
+    ///
+    /// - Parameter contextString: a globally-unique non-empty sequence of at most 252 bytes that identifies the desired context.
+    /// - Parameter seed: `[Uint8]` seed bytes
+    /// - Throws:
+    ///     - some `ZcashError.rust*` error if the derivation fails.
+    /// - Returns a `[Uint8]`
+    static func deriveArbitraryWalletKey(
+        contextString: [UInt8],
+        from seed: [UInt8]
+    ) throws -> [UInt8]
+
+    /// Derives and returns a ZIP 32 Arbitrary Key from the given seed at the account level.
+    ///
+    /// - Parameter contextString: a globally-unique non-empty sequence of at most 252 bytes that identifies the desired context.
+    /// - Parameter seed: `[Uint8]` seed bytes
+    /// - Parameter accountIndex: the ZIP 32 index of the account
+    /// - Throws:
+    ///     - some `ZcashError.rust*` error if the derivation fails.
+    /// - Returns a `[Uint8]`
+    func deriveArbitraryAccountKey(
+        contextString: [UInt8],
+        from seed: [UInt8],
+        accountIndex: Zip32AccountIndex
+    ) throws -> [UInt8]
 }