// This file is part of Substrate. // Copyright (C) 2017-2020 Parity Technologies (UK) Ltd. // SPDX-License-Identifier: GPL-3.0-or-later WITH Classpath-exception-2.0 // This program is free software: you can redistribute it and/or modify // it under the terms of the GNU General Public License as published by // the Free Software Foundation, either version 3 of the License, or // (at your option) any later version. // This program is distributed in the hope that it will be useful, // but WITHOUT ANY WARRANTY; without even the implied warranty of // MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the // GNU General Public License for more details. // You should have received a copy of the GNU General Public License // along with this program. If not, see . use super::*; use super::state_full::split_range; use self::error::Error; use std::sync::Arc; use assert_matches::assert_matches; use futures01::stream::Stream; use sp_core::{storage::ChildInfo, ChangesTrieConfiguration}; use sp_core::hash::H256; use sc_block_builder::BlockBuilderProvider; use sp_io::hashing::blake2_256; use substrate_test_runtime_client::{ prelude::*, sp_consensus::BlockOrigin, runtime, }; use sp_runtime::generic::BlockId; use crate::testing::TaskExecutor; use futures::{executor, compat::Future01CompatExt}; const STORAGE_KEY: &[u8] = b"child"; fn prefixed_storage_key() -> PrefixedStorageKey { let child_info = ChildInfo::new_default(&STORAGE_KEY[..]); child_info.prefixed_storage_key() } #[test] fn should_return_storage() { const KEY: &[u8] = b":mock"; const VALUE: &[u8] = b"hello world"; const CHILD_VALUE: &[u8] = b"hello world !"; let child_info = ChildInfo::new_default(STORAGE_KEY); let client = TestClientBuilder::new() .add_extra_storage(KEY.to_vec(), VALUE.to_vec()) .add_extra_child_storage(&child_info, KEY.to_vec(), CHILD_VALUE.to_vec()) .build(); let genesis_hash = client.genesis_hash(); let (client, child) = new_full(Arc::new(client), SubscriptionManager::new(Arc::new(TaskExecutor))); let key = StorageKey(KEY.to_vec()); assert_eq!( client.storage(key.clone(), Some(genesis_hash).into()).wait() .map(|x| x.map(|x| x.0.len())).unwrap().unwrap() as usize, VALUE.len(), ); assert_matches!( client.storage_hash(key.clone(), Some(genesis_hash).into()).wait() .map(|x| x.is_some()), Ok(true) ); assert_eq!( client.storage_size(key.clone(), None).wait().unwrap().unwrap() as usize, VALUE.len(), ); assert_eq!( executor::block_on( child.storage(prefixed_storage_key(), key, Some(genesis_hash).into()) .map(|x| x.map(|x| x.0.len())) .compat(), ).unwrap().unwrap() as usize, CHILD_VALUE.len(), ); } #[test] fn should_return_child_storage() { let child_info = ChildInfo::new_default(STORAGE_KEY); let client = Arc::new(substrate_test_runtime_client::TestClientBuilder::new() .add_child_storage(&child_info, "key", vec![42_u8]) .build()); let genesis_hash = client.genesis_hash(); let (_client, child) = new_full(client, SubscriptionManager::new(Arc::new(TaskExecutor))); let child_key = prefixed_storage_key(); let key = StorageKey(b"key".to_vec()); assert_matches!( child.storage( child_key.clone(), key.clone(), Some(genesis_hash).into(), ).wait(), Ok(Some(StorageData(ref d))) if d[0] == 42 && d.len() == 1 ); assert_matches!( child.storage_hash( child_key.clone(), key.clone(), Some(genesis_hash).into(), ).wait().map(|x| x.is_some()), Ok(true) ); assert_matches!( child.storage_size( child_key.clone(), key.clone(), None, ).wait(), Ok(Some(1)) ); } #[test] fn should_call_contract() { let client = Arc::new(substrate_test_runtime_client::new()); let genesis_hash = client.genesis_hash(); let (client, _child) = new_full(client, SubscriptionManager::new(Arc::new(TaskExecutor))); assert_matches!( client.call("balanceOf".into(), Bytes(vec![1,2,3]), Some(genesis_hash).into()).wait(), Err(Error::Client(_)) ) } #[test] fn should_notify_about_storage_changes() { let (subscriber, id, transport) = Subscriber::new_test("test"); { let mut client = Arc::new(substrate_test_runtime_client::new()); let (api, _child) = new_full(client.clone(), SubscriptionManager::new(Arc::new(TaskExecutor))); api.subscribe_storage(Default::default(), subscriber, None.into()); // assert id assigned assert!(matches!( executor::block_on(id.compat()), Ok(Ok(SubscriptionId::String(_))) )); let mut builder = client.new_block(Default::default()).unwrap(); builder.push_transfer(runtime::Transfer { from: AccountKeyring::Alice.into(), to: AccountKeyring::Ferdie.into(), amount: 42, nonce: 0, }).unwrap(); let block = builder.build().unwrap().block; client.import(BlockOrigin::Own, block).unwrap(); } // assert notification sent to transport let (notification, next) = executor::block_on(transport.into_future().compat()).unwrap(); assert!(notification.is_some()); // no more notifications on this channel assert_eq!(executor::block_on(next.into_future().compat()).unwrap().0, None); } #[test] fn should_send_initial_storage_changes_and_notifications() { let (subscriber, id, transport) = Subscriber::new_test("test"); { let mut client = Arc::new(substrate_test_runtime_client::new()); let (api, _child) = new_full(client.clone(), SubscriptionManager::new(Arc::new(TaskExecutor))); let alice_balance_key = blake2_256(&runtime::system::balance_of_key(AccountKeyring::Alice.into())); api.subscribe_storage(Default::default(), subscriber, Some(vec![ StorageKey(alice_balance_key.to_vec()), ]).into()); // assert id assigned assert!(matches!( executor::block_on(id.compat()), Ok(Ok(SubscriptionId::String(_))) )); let mut builder = client.new_block(Default::default()).unwrap(); builder.push_transfer(runtime::Transfer { from: AccountKeyring::Alice.into(), to: AccountKeyring::Ferdie.into(), amount: 42, nonce: 0, }).unwrap(); let block = builder.build().unwrap().block; client.import(BlockOrigin::Own, block).unwrap(); } // assert initial values sent to transport let (notification, next) = executor::block_on(transport.into_future().compat()).unwrap(); assert!(notification.is_some()); // assert notification sent to transport let (notification, next) = executor::block_on(next.into_future().compat()).unwrap(); assert!(notification.is_some()); // no more notifications on this channel assert_eq!(executor::block_on(next.into_future().compat()).unwrap().0, None); } #[test] fn should_query_storage() { fn run_tests(mut client: Arc, has_changes_trie_config: bool) { let (api, _child) = new_full(client.clone(), SubscriptionManager::new(Arc::new(TaskExecutor))); let mut add_block = |nonce| { let mut builder = client.new_block(Default::default()).unwrap(); // fake change: None -> None -> None builder.push_storage_change(vec![1], None).unwrap(); // fake change: None -> Some(value) -> Some(value) builder.push_storage_change(vec![2], Some(vec![2])).unwrap(); // actual change: None -> Some(value) -> None builder.push_storage_change(vec![3], if nonce == 0 { Some(vec![3]) } else { None }).unwrap(); // actual change: None -> Some(value) builder.push_storage_change(vec![4], if nonce == 0 { None } else { Some(vec![4]) }).unwrap(); // actual change: Some(value1) -> Some(value2) builder.push_storage_change(vec![5], Some(vec![nonce as u8])).unwrap(); let block = builder.build().unwrap().block; let hash = block.header.hash(); client.import(BlockOrigin::Own, block).unwrap(); hash }; let block1_hash = add_block(0); let block2_hash = add_block(1); let genesis_hash = client.genesis_hash(); if has_changes_trie_config { assert_eq!( client.max_key_changes_range(1, BlockId::Hash(block1_hash)).unwrap(), Some((0, BlockId::Hash(block1_hash))), ); } let mut expected = vec![ StorageChangeSet { block: genesis_hash, changes: vec![ (StorageKey(vec![1]), None), (StorageKey(vec![2]), None), (StorageKey(vec![3]), None), (StorageKey(vec![4]), None), (StorageKey(vec![5]), None), ], }, StorageChangeSet { block: block1_hash, changes: vec![ (StorageKey(vec![2]), Some(StorageData(vec![2]))), (StorageKey(vec![3]), Some(StorageData(vec![3]))), (StorageKey(vec![5]), Some(StorageData(vec![0]))), ], }, ]; // Query changes only up to block1 let keys = (1..6).map(|k| StorageKey(vec![k])).collect::>(); let result = api.query_storage( keys.clone(), genesis_hash, Some(block1_hash).into(), ); assert_eq!(result.wait().unwrap(), expected); // Query all changes let result = api.query_storage( keys.clone(), genesis_hash, None.into(), ); expected.push(StorageChangeSet { block: block2_hash, changes: vec![ (StorageKey(vec![3]), None), (StorageKey(vec![4]), Some(StorageData(vec![4]))), (StorageKey(vec![5]), Some(StorageData(vec![1]))), ], }); assert_eq!(result.wait().unwrap(), expected); // Query changes up to block2. let result = api.query_storage( keys.clone(), genesis_hash, Some(block2_hash), ); assert_eq!(result.wait().unwrap(), expected); // Inverted range. let result = api.query_storage( keys.clone(), block1_hash, Some(genesis_hash), ); assert_eq!( result.wait().map_err(|e| e.to_string()), Err(Error::InvalidBlockRange { from: format!("1 ({:?})", block1_hash), to: format!("0 ({:?})", genesis_hash), details: "from number > to number".to_owned(), }).map_err(|e| e.to_string()) ); let random_hash1 = H256::random(); let random_hash2 = H256::random(); // Invalid second hash. let result = api.query_storage( keys.clone(), genesis_hash, Some(random_hash1), ); assert_eq!( result.wait().map_err(|e| e.to_string()), Err(Error::InvalidBlockRange { from: format!("{:?}", genesis_hash), to: format!("{:?}", Some(random_hash1)), details: format!("UnknownBlock: header not found in db: {}", random_hash1), }).map_err(|e| e.to_string()) ); // Invalid first hash with Some other hash. let result = api.query_storage( keys.clone(), random_hash1, Some(genesis_hash), ); assert_eq!( result.wait().map_err(|e| e.to_string()), Err(Error::InvalidBlockRange { from: format!("{:?}", random_hash1), to: format!("{:?}", Some(genesis_hash)), details: format!("UnknownBlock: header not found in db: {}", random_hash1), }).map_err(|e| e.to_string()), ); // Invalid first hash with None. let result = api.query_storage( keys.clone(), random_hash1, None, ); assert_eq!( result.wait().map_err(|e| e.to_string()), Err(Error::InvalidBlockRange { from: format!("{:?}", random_hash1), to: format!("{:?}", Some(block2_hash)), // Best block hash. details: format!("UnknownBlock: header not found in db: {}", random_hash1), }).map_err(|e| e.to_string()), ); // Both hashes invalid. let result = api.query_storage( keys.clone(), random_hash1, Some(random_hash2), ); assert_eq!( result.wait().map_err(|e| e.to_string()), Err(Error::InvalidBlockRange { from: format!("{:?}", random_hash1), // First hash not found. to: format!("{:?}", Some(random_hash2)), details: format!("UnknownBlock: header not found in db: {}", random_hash1), }).map_err(|e| e.to_string()), ); // single block range let result = api.query_storage_at( keys.clone(), Some(block1_hash), ); assert_eq!( result.wait().unwrap(), vec![ StorageChangeSet { block: block1_hash, changes: vec![ (StorageKey(vec![1_u8]), None), (StorageKey(vec![2_u8]), Some(StorageData(vec![2_u8]))), (StorageKey(vec![3_u8]), Some(StorageData(vec![3_u8]))), (StorageKey(vec![4_u8]), None), (StorageKey(vec![5_u8]), Some(StorageData(vec![0_u8]))), ] } ] ); } run_tests(Arc::new(substrate_test_runtime_client::new()), false); run_tests( Arc::new( TestClientBuilder::new() .changes_trie_config(Some(ChangesTrieConfiguration::new(4, 2))) .build(), ), true, ); } #[test] fn should_split_ranges() { assert_eq!(split_range(1, None), (0..1, None)); assert_eq!(split_range(100, None), (0..100, None)); assert_eq!(split_range(1, Some(0)), (0..1, None)); assert_eq!(split_range(100, Some(50)), (0..50, Some(50..100))); assert_eq!(split_range(100, Some(99)), (0..99, Some(99..100))); } #[test] fn should_return_runtime_version() { let client = Arc::new(substrate_test_runtime_client::new()); let (api, _child) = new_full(client.clone(), SubscriptionManager::new(Arc::new(TaskExecutor))); let result = "{\"specName\":\"test\",\"implName\":\"parity-test\",\"authoringVersion\":1,\ \"specVersion\":2,\"implVersion\":2,\"apis\":[[\"0xdf6acb689907609b\",3],\ [\"0x37e397fc7c91f5e4\",1],[\"0xd2bc9897eed08f15\",2],[\"0x40fe3ad401f8959a\",4],\ [\"0xc6e9a76309f39b09\",1],[\"0xdd718d5cc53262d4\",1],[\"0xcbca25e39f142387\",2],\ [\"0xf78b278be53f454c\",2],[\"0xab3c0572291feb8b\",1],[\"0xbc9d89904f5b923f\",1]],\ \"transactionVersion\":1}"; let runtime_version = api.runtime_version(None.into()).wait().unwrap(); let serialized = serde_json::to_string(&runtime_version).unwrap(); assert_eq!(serialized, result); let deserialized: RuntimeVersion = serde_json::from_str(result).unwrap(); assert_eq!(deserialized, runtime_version); } #[test] fn should_notify_on_runtime_version_initially() { let (subscriber, id, transport) = Subscriber::new_test("test"); { let client = Arc::new(substrate_test_runtime_client::new()); let (api, _child) = new_full(client.clone(), SubscriptionManager::new(Arc::new(TaskExecutor))); api.subscribe_runtime_version(Default::default(), subscriber); // assert id assigned assert!(matches!( executor::block_on(id.compat()), Ok(Ok(SubscriptionId::String(_))) )); } // assert initial version sent. let (notification, next) = executor::block_on(transport.into_future().compat()).unwrap(); assert!(notification.is_some()); // no more notifications on this channel assert_eq!(executor::block_on(next.into_future().compat()).unwrap().0, None); } #[test] fn should_deserialize_storage_key() { let k = "\"0x7f864e18e3dd8b58386310d2fe0919eef27c6e558564b7f67f22d99d20f587b\""; let k: StorageKey = serde_json::from_str(k).unwrap(); assert_eq!(k.0.len(), 32); }