// Copyright 2021 The Grin Developers // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. // You may obtain a copy of the License at // // http://www.apache.org/licenses/LICENSE-2.0 // // Unless required by applicable law or agreed to in writing, software // distributed under the License is distributed on an "AS IS" BASIS, // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. //! common functions for tests (instantiating wallet and proxy, mostly) extern crate grin_wallet_controller as wallet; extern crate grin_wallet_impls as impls; extern crate grin_wallet_libwallet as libwallet; extern crate log; use grin_chain as chain; use grin_core as core; use grin_keychain as keychain; use grin_util as util; use self::core::global; use self::core::global::ChainTypes; use self::keychain::{ExtKeychain, Keychain}; use self::libwallet::WalletInst; use chain::Chain; use grin_wallet_controller::Error; use impls::test_framework::{self, LocalWalletClient, WalletProxy}; use impls::{DefaultLCProvider, DefaultWalletImpl}; use std::sync::atomic::AtomicBool; use std::sync::Arc; use std::thread; use util::secp::key::SecretKey; use util::{Mutex, ZeroingString}; #[macro_export] macro_rules! wallet_inst { ($wallet:ident, $w: ident) => { let mut w_lock = $wallet.lock(); let lc = w_lock.lc_provider()?; let $w = lc.wallet_inst()?; }; } #[macro_export] macro_rules! create_wallet_and_add { ($client:ident, $wallet: ident, $mask: ident, $test_dir: expr, $name: expr, $seed_phrase: expr, $proxy: expr, $create_mask: expr) => { let $client = LocalWalletClient::new($name, $proxy.tx.clone()); let ($wallet, $mask) = common::create_local_wallet( $test_dir, $name, $seed_phrase.clone(), $client.clone(), $create_mask, ); $proxy.add_wallet( $name, $client.get_send_instance(), $wallet.clone(), $mask.clone(), ); }; } #[macro_export] macro_rules! open_wallet_and_add { ($client:ident, $wallet: ident, $mask: ident, $test_dir: expr, $name: expr, $proxy: expr, $create_mask: expr) => { let $client = LocalWalletClient::new($name, $proxy.tx.clone()); let ($wallet, $mask) = common::open_local_wallet($test_dir, $name, $client.clone(), $create_mask); $proxy.add_wallet( $name, $client.get_send_instance(), $wallet.clone(), $mask.clone(), ); }; } pub fn clean_output_dir(test_dir: &str) { let path = std::path::Path::new(test_dir); if path.is_dir() { remove_dir_all::remove_dir_all(test_dir).unwrap(); } } pub fn setup(test_dir: &str) { util::init_test_logger(); clean_output_dir(test_dir); global::set_local_chain_type(ChainTypes::AutomatedTesting); } /// Some tests require the global chain_type to be configured due to threads being spawned internally. /// It is recommended to avoid relying on this if at all possible as global chain_type /// leaks across multiple tests and will likely have unintended consequences. #[allow(dead_code)] pub fn setup_global_chain_type() { global::init_global_chain_type(global::ChainTypes::AutomatedTesting); } pub fn create_wallet_proxy( test_dir: &str, ) -> WalletProxy, LocalWalletClient, ExtKeychain> { WalletProxy::new(test_dir) } pub fn create_local_wallet( test_dir: &str, name: &str, mnemonic: Option, client: LocalWalletClient, create_mask: bool, ) -> ( Arc< Mutex< Box< dyn WalletInst< 'static, DefaultLCProvider<'static, LocalWalletClient, ExtKeychain>, LocalWalletClient, ExtKeychain, >, >, >, >, Option, ) { let mut wallet = Box::new(DefaultWalletImpl::::new(client).unwrap()) as Box< dyn WalletInst< DefaultLCProvider<'static, LocalWalletClient, ExtKeychain>, LocalWalletClient, ExtKeychain, >, >; let lc = wallet.lc_provider().unwrap(); let _ = lc.set_top_level_directory(&format!("{}/{}", test_dir, name)); lc.create_wallet(None, mnemonic, 32, ZeroingString::from(""), false) .unwrap(); let mask = lc .open_wallet(None, ZeroingString::from(""), create_mask, false) .unwrap(); (Arc::new(Mutex::new(wallet)), mask) } #[allow(dead_code)] pub fn open_local_wallet( test_dir: &str, name: &str, client: LocalWalletClient, create_mask: bool, ) -> ( Arc< Mutex< Box< dyn WalletInst< 'static, DefaultLCProvider<'static, LocalWalletClient, ExtKeychain>, LocalWalletClient, ExtKeychain, >, >, >, >, Option, ) { let mut wallet = Box::new(DefaultWalletImpl::::new(client).unwrap()) as Box< dyn WalletInst< DefaultLCProvider<'static, LocalWalletClient, ExtKeychain>, LocalWalletClient, ExtKeychain, >, >; let lc = wallet.lc_provider().unwrap(); let _ = lc.set_top_level_directory(&format!("{}/{}", test_dir, name)); let mask = lc .open_wallet(None, ZeroingString::from(""), create_mask, false) .unwrap(); (Arc::new(Mutex::new(wallet)), mask) } // Creates the given number of wallets and spawns a thread that runs the wallet proxy pub fn create_wallets( wallets_def: Vec>, // a vector of boolean that represent whether we mine into a wallet test_dir: &'static str, ) -> Result< ( Vec<( Arc< Mutex< Box< dyn WalletInst< 'static, DefaultLCProvider<'static, LocalWalletClient, ExtKeychain>, LocalWalletClient, ExtKeychain, >, >, >, >, Option, )>, // wallets Arc, // chain Arc, // stopper u64, // block height ), Error, > { // Create a new proxy to simulate server and wallet responses let mut wallet_proxy = create_wallet_proxy(test_dir); let chain = wallet_proxy.chain.clone(); let stopper = wallet_proxy.running.clone(); let mut wallets = vec![]; for i in 0..wallets_def.len() { let name = format!("wallet{}", i + 1); let wclient = LocalWalletClient::new(&name, wallet_proxy.tx.clone()); let (wallet1, mask1) = create_local_wallet( test_dir, &name, None, // $seed_phrase.clone(), wclient.clone(), true, ); wallet_proxy.add_wallet( &name, wclient.get_send_instance(), wallet1.clone(), mask1.clone(), ); wallets.push((wallet1, mask1)); } // Set the wallet proxy listener running thread::spawn(move || { if let Err(e) = wallet_proxy.run() { log::error!("Wallet Proxy error: {}", e); } }); // // Mine values into wallets // // few values to keep things shorter let reward = core::consensus::REWARD; let mut bh = 0u64; for (idx, accs) in wallets_def.iter().enumerate() { let wallet1 = wallets[idx].0.clone(); let mask1 = wallets[idx].1.as_ref(); for (acc_idx, (acc_name, num_mined_blocks)) in accs.iter().enumerate() { // create the account if acc_name.to_string() != "default" { wallet::controller::owner_single_use( Some(wallet1.clone()), mask1, None, |api, m| { let new_path = api.create_account_path(m, acc_name)?; assert_eq!( new_path, ExtKeychain::derive_key_id(2, acc_idx as u32, 0, 0, 0) // NOTE: default should always be at 0 and is already created ); Ok(()) }, )?; } // Get some mining done if *num_mined_blocks == 0 { continue; } { wallet_inst!(wallet1, w); w.set_parent_key_id_by_name(acc_name)?; } let _ = test_framework::award_blocks_to_wallet( &chain, wallet1.clone(), mask1, *num_mined_blocks as usize, false, ); bh += num_mined_blocks; // Sanity check wallet 1 contents wallet::controller::owner_single_use(Some(wallet1.clone()), mask1, None, |api, m| { let (wallet1_refreshed, wallet1_info) = api.retrieve_summary_info(m, true, 1)?; assert!(wallet1_refreshed); assert_eq!(wallet1_info.last_confirmed_height, bh); assert_eq!(wallet1_info.total, num_mined_blocks * reward); Ok(()) })?; } // Sanity check the number of accounts wallet::controller::owner_single_use(Some(wallet1.clone()), mask1, None, |api, m| { let accounts = api.accounts(m)?; assert_eq!(accounts.len(), accs.len()); Ok(()) })?; // Set the account on the wallet to "default" { wallet_inst!(wallet1, w); w.set_parent_key_id_by_name("default")?; } } Ok((wallets, chain, stopper, bh)) }