zingolabs · fluidvanadium · Oct 3, 2025 · Oct 3, 2025 · Oct 3, 2025 · Oct 7, 2025
diff --git a/Cargo.lock b/Cargo.lock
diff --git a/Cargo.toml b/Cargo.toml
@@ -8,17 +8,26 @@ members = [
     "pepper-sync",
     "zingo-price",
     "zingolib_testutils",
+    "zingo_wallet",
 ]
 resolver = "2"
 
 [workspace.dependencies]
 
-# Protocol
-bip0039 = { version = "0.13", features = ["rand"] }
-bip32 = { version = "0.6.0-pre.1", default-features = false }
-zip32 = "0.2.0"
+### Internal Workspace
+# zingo-memo = { path = "zingo-memo" } # NOTE: for development between releases
+zingo-memo = "0.1.0"
+zingo-price = { path = "zingo-price" }
+# zingo-status = { path = "zingo-status" } # NOTE: for development between releases
+zingo-status = "0.1.0"
+pepper-sync = { path = "pepper-sync" }
+zingolib = { path = "zingolib" }
+
+### Zingo-common
+zingo-netutils = "1.1.0"
+zingo_common_components = { git = "https://github.com/zingolabs/zingo-common.git", version = "0.2" }
 
-# Zcash
+### nuttycom
 incrementalmerkletree = "0.8.2"
 orchard = "0.11.0"
 sapling-crypto = "0.5.0"
@@ -42,24 +51,25 @@ zcash_proofs = "0.26"
 zcash_protocol = "0.7"
 zcash_transparent = "0.6"
 
-# Zebra
+### Zebra
 zebra-chain = "5.0.0"
 
-# Zingo-common
-zingo-netutils = "1.1.0"
-zingo_common_components = { git = "https://github.com/zingolabs/zingo-common.git", version = "0.2" }
+### Blockchain Protocol
+bip0039 = { version = "0.13", features = ["rand"] }
+bip32 = { version = "0.6.0-pre.1", default-features = false }
+zip32 = "0.2.0"
 
-# Parallel processing
+### Parallel processing
 crossbeam-channel = "0.5"
 rayon = "1"
 
-# Documentation
+### Documentation
 simple-mermaid = "0.2.0"
 
-# Test Attributes
+### Test Attributes
 test-log = "0.2"
 
-# Misc
+### Misc
 append-only-vec = "0.1.7"
 bech32 = "0.11.0"
 bs58 = "0.5"
@@ -86,8 +96,6 @@ log = "0.4"
 log4rs = "1"
 memuse = "0.2"
 nonempty = "0.11.0"
-portpicker = "0.1"
-proptest = "1.6.0"
 prost = "0.14"
 rand = "0.8"
 reqwest = { version = "0.12.15", default-features = false }
@@ -103,7 +111,6 @@ serde = "1"
 serde_json = "1"
 shellwords = "1"
 subtle = "2"
-tempfile = "3"
 thiserror = "2"
 tokio = "1"
 tokio-rustls = "0.26"
@@ -115,17 +122,18 @@ tracing = "0.1"
 tracing-subscriber = "0.3"
 webpki-roots = "0.25"
 
-# Workspace
-# zingo-memo = { path = "zingo-memo" } # NOTE: for development between releases
-zingo-memo = "0.1.0"
-zingo-price = { path = "zingo-price" }
-# zingo-status = { path = "zingo-status" } # NOTE: for development between releases
-zingo-status = "0.1.0"
-pepper-sync = { path = "pepper-sync" }
-zingolib = { path = "zingolib" }
+# [workspace.dev_dependencies]
+# test framework DEVELOPMENT ONLY!
+# toDO enforce this restriction
+libtonode-tests = { path = "libtonode-tests" }
+
 zcash_local_net = { git = "https://github.com/zingolabs/infrastructure.git", rev = "e4714fd" }
 zingo_test_vectors = { git = "https://github.com/zingolabs/infrastructure.git", rev = "e4714fd" }
 
+tempfile = "3"
+portpicker = "0.1"
+proptest = "1.6.0"
+
 [profile.test]
 opt-level = 3
 
diff --git a/libtonode-tests/Cargo.toml b/libtonode-tests/Cargo.toml
@@ -12,7 +12,7 @@ ci = ["zingolib/ci"]
 
 # See more keys and their definitions at https://doc.rust-lang.org/cargo/reference/manifest.html
 [dependencies]
-zingolib = { workspace = true, features = ["darkside_tests", "testutils"] }
+zingolib = { workspace = true, features = ["regtest", "testutils"] }
 zingo-netutils = { workspace = true }
 zingo_common_components = { workspace = true, features = ["for_test"] }
 pepper-sync = { workspace = true }

diff --git a/libtonode-tests/src/chain_generics.rs b/libtonode-tests/src/chain_generics.rs
@@ -14,7 +14,7 @@ use zingolib_testutils::scenarios::custom_clients_default;
 use zingolib_testutils::scenarios::network_combo::{DefaultIndexer, DefaultValidator};
 
 /// includes utilities for connecting to zcashd regtest
-pub struct LibtonodeEnvironment {
+pub struct RegtestEnvironment {
     /// Local network
     pub local_net: LocalNet<DefaultValidator, DefaultIndexer>,
     /// Client builder
@@ -23,12 +23,12 @@ pub struct LibtonodeEnvironment {
 
 /// known issues include --slow
 /// these tests cannot portray the full range of network weather.
-impl ConductChain for LibtonodeEnvironment {
+impl ConductChain for RegtestEnvironment {
     async fn setup() -> Self {
         timestamped_test_log("starting mock libtonode network");
         let (local_net, client_builder) = custom_clients_default().await;
 
-        LibtonodeEnvironment {
+        RegtestEnvironment {
             local_net,
             client_builder,
         }

diff --git a/libtonode-tests/tests/chain_generics.rs b/libtonode-tests/tests/chain_generics.rs
@@ -2,7 +2,7 @@
 mod chain_generics {
     #[cfg(feature = "proptests")]
     mod proptests {
-        use libtonode_tests::chain_generics::LibtonodeEnvironment;
+        use libtonode_tests::chain_generics::RegtestEnvironment;
         use tokio::runtime::Runtime;
         use zingolib::testutils::chain_generics::fixtures;
         use zingolib::testutils::int_to_pooltype;
@@ -12,41 +12,41 @@ mod chain_generics {
             #[test]
             fn any_source_sends_to_any_receiver_libtonode(send_value in 0..50_000u64, change_value in 0..10_000u64, sender_protocol in 1..2, receiver_pool in 0..2) {
                 Runtime::new().unwrap().block_on(async {
-                    fixtures::any_source_sends_to_any_receiver::<LibtonodeEnvironment>(int_to_shieldedprotocol(sender_protocol), int_to_pooltype(receiver_pool), send_value, change_value, true).await;
+                    fixtures::any_source_sends_to_any_receiver::<RegtestEnvironment>(int_to_shieldedprotocol(sender_protocol), int_to_pooltype(receiver_pool), send_value, change_value, true).await;
                 });
              }
             #[test]
             fn any_source_sends_to_any_receiver_0_change_libtonode(send_value in 0..50_000u64, sender_protocol in 1..2, receiver_pool in 0..2) {
                 Runtime::new().unwrap().block_on(async {
-                    fixtures::any_source_sends_to_any_receiver::<LibtonodeEnvironment>(int_to_shieldedprotocol(sender_protocol), int_to_pooltype(receiver_pool), send_value, 0, true).await;
+                    fixtures::any_source_sends_to_any_receiver::<RegtestEnvironment>(int_to_shieldedprotocol(sender_protocol), int_to_pooltype(receiver_pool), send_value, 0, true).await;
                 });
              }
         }
     }
-    use libtonode_tests::chain_generics::LibtonodeEnvironment;
+    use libtonode_tests::chain_generics::RegtestEnvironment;
     use zcash_protocol::{PoolType, ShieldedProtocol};
     use zingolib::testutils::chain_generics::fixtures;
 
     #[tokio::test]
     async fn generate_a_range_of_value_transfers() {
-        fixtures::create_various_value_transfers::<LibtonodeEnvironment>().await;
+        fixtures::create_various_value_transfers::<RegtestEnvironment>().await;
     }
     #[tokio::test]
     async fn send_shield_cycle() {
-        fixtures::send_shield_cycle::<LibtonodeEnvironment>(1).await;
+        fixtures::send_shield_cycle::<RegtestEnvironment>(1).await;
     }
     #[tokio::test]
     #[test_log::test]
     async fn ignore_dust_inputs() {
-        fixtures::ignore_dust_inputs::<LibtonodeEnvironment>().await;
+        fixtures::ignore_dust_inputs::<RegtestEnvironment>().await;
     }
     #[tokio::test]
     async fn note_selection_order() {
-        fixtures::note_selection_order::<LibtonodeEnvironment>().await;
+        fixtures::note_selection_order::<RegtestEnvironment>().await;
     }
     #[tokio::test]
     async fn simpool_insufficient_1_sapling_to_transparent() {
-        fixtures::shpool_to_pool_insufficient_error::<LibtonodeEnvironment>(
+        fixtures::shpool_to_pool_insufficient_error::<RegtestEnvironment>(
             ShieldedProtocol::Sapling,
             PoolType::TRANSPARENT,
             1,
@@ -55,7 +55,7 @@ mod chain_generics {
     }
     #[tokio::test]
     async fn simpool_insufficient_1_sapling_to_sapling() {
-        fixtures::shpool_to_pool_insufficient_error::<LibtonodeEnvironment>(
+        fixtures::shpool_to_pool_insufficient_error::<RegtestEnvironment>(
             ShieldedProtocol::Sapling,
             PoolType::SAPLING,
             1,
@@ -64,7 +64,7 @@ mod chain_generics {
     }
     #[tokio::test]
     async fn simpool_insufficient_1_sapling_to_orchard() {
-        fixtures::shpool_to_pool_insufficient_error::<LibtonodeEnvironment>(
+        fixtures::shpool_to_pool_insufficient_error::<RegtestEnvironment>(
             ShieldedProtocol::Sapling,
             PoolType::ORCHARD,
             1,
@@ -73,7 +73,7 @@ mod chain_generics {
     }
     #[tokio::test]
     async fn simpool_insufficient_1_orchard_to_transparent() {
-        fixtures::shpool_to_pool_insufficient_error::<LibtonodeEnvironment>(
+        fixtures::shpool_to_pool_insufficient_error::<RegtestEnvironment>(
             ShieldedProtocol::Orchard,
             PoolType::TRANSPARENT,
             1,
@@ -82,7 +82,7 @@ mod chain_generics {
     }
     #[tokio::test]
     async fn simpool_insufficient_1_orchard_to_sapling() {
-        fixtures::shpool_to_pool_insufficient_error::<LibtonodeEnvironment>(
+        fixtures::shpool_to_pool_insufficient_error::<RegtestEnvironment>(
             ShieldedProtocol::Orchard,
             PoolType::SAPLING,
             1,
@@ -91,7 +91,7 @@ mod chain_generics {
     }
     #[tokio::test]
     async fn simpool_insufficient_1_orchard_to_orchard() {
-        fixtures::shpool_to_pool_insufficient_error::<LibtonodeEnvironment>(
+        fixtures::shpool_to_pool_insufficient_error::<RegtestEnvironment>(
             ShieldedProtocol::Orchard,
             PoolType::ORCHARD,
             1,
@@ -100,7 +100,7 @@ mod chain_generics {
     }
     #[tokio::test]
     async fn simpool_insufficient_10_000_sapling_to_transparent() {
-        fixtures::shpool_to_pool_insufficient_error::<LibtonodeEnvironment>(
+        fixtures::shpool_to_pool_insufficient_error::<RegtestEnvironment>(
             ShieldedProtocol::Sapling,
             PoolType::TRANSPARENT,
             10_000,
@@ -109,7 +109,7 @@ mod chain_generics {
     }
     #[tokio::test]
     async fn simpool_insufficient_10_000_sapling_to_sapling() {
-        fixtures::shpool_to_pool_insufficient_error::<LibtonodeEnvironment>(
+        fixtures::shpool_to_pool_insufficient_error::<RegtestEnvironment>(
             ShieldedProtocol::Sapling,
             PoolType::SAPLING,
             10_000,
@@ -118,7 +118,7 @@ mod chain_generics {
     }
     #[tokio::test]
     async fn simpool_insufficient_10_000_sapling_to_orchard() {
-        fixtures::shpool_to_pool_insufficient_error::<LibtonodeEnvironment>(
+        fixtures::shpool_to_pool_insufficient_error::<RegtestEnvironment>(
             ShieldedProtocol::Sapling,
             PoolType::ORCHARD,
             10_000,
@@ -127,7 +127,7 @@ mod chain_generics {
     }
     #[tokio::test]
     async fn simpool_insufficient_10_000_orchard_to_transparent() {
-        fixtures::shpool_to_pool_insufficient_error::<LibtonodeEnvironment>(
+        fixtures::shpool_to_pool_insufficient_error::<RegtestEnvironment>(
             ShieldedProtocol::Orchard,
             PoolType::TRANSPARENT,
             10_000,
@@ -136,7 +136,7 @@ mod chain_generics {
     }
     #[tokio::test]
     async fn simpool_insufficient_10_000_orchard_to_sapling() {
-        fixtures::shpool_to_pool_insufficient_error::<LibtonodeEnvironment>(
+        fixtures::shpool_to_pool_insufficient_error::<RegtestEnvironment>(
             ShieldedProtocol::Orchard,
             PoolType::SAPLING,
             10_000,
@@ -145,7 +145,7 @@ mod chain_generics {
     }
     #[tokio::test]
     async fn simpool_insufficient_10_000_orchard_to_orchard() {
-        fixtures::shpool_to_pool_insufficient_error::<LibtonodeEnvironment>(
+        fixtures::shpool_to_pool_insufficient_error::<RegtestEnvironment>(
             ShieldedProtocol::Orchard,
             PoolType::ORCHARD,
             10_000,
@@ -154,17 +154,15 @@ mod chain_generics {
     }
     #[tokio::test]
     async fn simpool_no_fund_1_000_000_to_transparent() {
-        fixtures::to_pool_unfunded_error::<LibtonodeEnvironment>(PoolType::TRANSPARENT, 1_000_000)
+        fixtures::to_pool_unfunded_error::<RegtestEnvironment>(PoolType::TRANSPARENT, 1_000_000)
             .await;
     }
     #[tokio::test]
     async fn simpool_no_fund_1_000_000_to_sapling() {
-        fixtures::to_pool_unfunded_error::<LibtonodeEnvironment>(PoolType::SAPLING, 1_000_000)
-            .await;
+        fixtures::to_pool_unfunded_error::<RegtestEnvironment>(PoolType::SAPLING, 1_000_000).await;
     }
     #[tokio::test]
     async fn simpool_no_fund_1_000_000_to_orchard() {
-        fixtures::to_pool_unfunded_error::<LibtonodeEnvironment>(PoolType::ORCHARD, 1_000_000)
-            .await;
+        fixtures::to_pool_unfunded_error::<RegtestEnvironment>(PoolType::ORCHARD, 1_000_000).await;
     }
 }
diff --git a/libtonode-tests/tests/concrete.rs b/libtonode-tests/tests/concrete.rs
@@ -163,7 +163,7 @@ mod fast {
     use zip32::AccountId;
 
     use super::*;
-    use libtonode_tests::chain_generics::LibtonodeEnvironment;
+    use libtonode_tests::chain_generics::RegtestEnvironment;
 
     // FIXME: zingo2, large test to re-integrate
     // #[tokio::test]
@@ -688,7 +688,7 @@ mod fast {
     /// This tests checks that `messages_containing` returns an empty vector when empty memos are included.
     #[tokio::test]
     async fn filter_empty_messages() {
-        let mut environment = LibtonodeEnvironment::setup().await;
+        let mut environment = RegtestEnvironment::setup().await;
 
         let mut faucet = environment.create_faucet().await;
         let mut recipient = environment.create_client().await;
@@ -920,7 +920,7 @@ mod fast {
     /// It also tests that retrieving the value transfers multiple times in a row returns the same results.
     #[tokio::test]
     async fn value_transfers() {
-        let mut environment = LibtonodeEnvironment::setup().await;
+        let mut environment = RegtestEnvironment::setup().await;
 
         let mut faucet = environment.create_faucet().await;
         let mut recipient = environment.create_client().await;