// This file is part of Substrate. // Copyright (C) 2017-2021 Parity Technologies (UK) Ltd. // SPDX-License-Identifier: Apache-2.0 // 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. //! Testing utilities. use crate::{ codec::{Codec, Decode, Encode}, generic, traits::{ self, Applyable, BlakeTwo256, Checkable, DispatchInfoOf, Dispatchable, OpaqueKeys, PostDispatchInfoOf, SignedExtension, ValidateUnsigned, }, transaction_validity::{TransactionSource, TransactionValidity, TransactionValidityError}, ApplyExtrinsicResultWithInfo, CryptoTypeId, KeyTypeId, }; use serde::{de::Error as DeError, Deserialize, Deserializer, Serialize, Serializer}; use sp_core::{ crypto::{key_types, CryptoType, Dummy, Public}, U256, }; pub use sp_core::{sr25519, H256}; use std::{ cell::RefCell, fmt::{self, Debug}, ops::Deref, }; /// A dummy type which can be used instead of regular cryptographic primitives. /// /// 1. Wraps a `u64` `AccountId` and is able to `IdentifyAccount`. /// 2. Can be converted to any `Public` key. /// 3. Implements `RuntimeAppPublic` so it can be used instead of regular application-specific /// crypto. #[derive( Default, PartialEq, Eq, Clone, Encode, Decode, Debug, Hash, Serialize, Deserialize, PartialOrd, Ord, )] pub struct UintAuthorityId(pub u64); impl From for UintAuthorityId { fn from(id: u64) -> Self { UintAuthorityId(id) } } impl From for u64 { fn from(id: UintAuthorityId) -> u64 { id.0 } } impl UintAuthorityId { /// Convert this authority id into a public key. pub fn to_public_key(&self) -> T { let bytes: [u8; 32] = U256::from(self.0).into(); T::from_slice(&bytes) } } impl CryptoType for UintAuthorityId { type Pair = Dummy; } impl AsRef<[u8]> for UintAuthorityId { fn as_ref(&self) -> &[u8] { // Unsafe, i know, but it's test code and it's just there because it's really convenient to // keep `UintAuthorityId` as a u64 under the hood. unsafe { std::slice::from_raw_parts( &self.0 as *const u64 as *const _, std::mem::size_of::(), ) } } } thread_local! { /// A list of all UintAuthorityId keys returned to the runtime. static ALL_KEYS: RefCell> = RefCell::new(vec![]); } impl UintAuthorityId { /// Set the list of keys returned by the runtime call for all keys of that type. pub fn set_all_keys>(keys: impl IntoIterator) { ALL_KEYS.with(|l| *l.borrow_mut() = keys.into_iter().map(Into::into).collect()) } } impl sp_application_crypto::RuntimeAppPublic for UintAuthorityId { const ID: KeyTypeId = key_types::DUMMY; const CRYPTO_ID: CryptoTypeId = CryptoTypeId(*b"dumm"); type Signature = TestSignature; fn all() -> Vec { ALL_KEYS.with(|l| l.borrow().clone()) } fn generate_pair(_: Option>) -> Self { use rand::RngCore; UintAuthorityId(rand::thread_rng().next_u64()) } fn sign>(&self, msg: &M) -> Option { Some(TestSignature(self.0, msg.as_ref().to_vec())) } fn verify>(&self, msg: &M, signature: &Self::Signature) -> bool { traits::Verify::verify(signature, msg.as_ref(), &self.0) } fn to_raw_vec(&self) -> Vec { AsRef::<[u8]>::as_ref(self).to_vec() } } impl OpaqueKeys for UintAuthorityId { type KeyTypeIdProviders = (); fn key_ids() -> &'static [KeyTypeId] { &[key_types::DUMMY] } fn get_raw(&self, _: KeyTypeId) -> &[u8] { self.as_ref() } fn get(&self, _: KeyTypeId) -> Option { self.using_encoded(|mut x| T::decode(&mut x)).ok() } } impl crate::BoundToRuntimeAppPublic for UintAuthorityId { type Public = Self; } impl traits::IdentifyAccount for UintAuthorityId { type AccountId = u64; fn into_account(self) -> Self::AccountId { self.0 } } /// A dummy signature type, to match `UintAuthorityId`. #[derive(Eq, PartialEq, Clone, Debug, Hash, Serialize, Deserialize, Encode, Decode)] pub struct TestSignature(pub u64, pub Vec); impl traits::Verify for TestSignature { type Signer = UintAuthorityId; fn verify>(&self, mut msg: L, signer: &u64) -> bool { signer == &self.0 && msg.get() == &self.1[..] } } /// Digest item pub type DigestItem = generic::DigestItem; /// Header Digest pub type Digest = generic::Digest; /// Block Header pub type Header = generic::Header; impl Header { /// A new header with the given number and default hash for all other fields. pub fn new_from_number(number: ::Number) -> Self { Self { number, extrinsics_root: Default::default(), state_root: Default::default(), parent_hash: Default::default(), digest: Default::default(), } } } /// An opaque extrinsic wrapper type. #[derive(PartialEq, Eq, Clone, Debug, Encode, Decode, parity_util_mem::MallocSizeOf)] pub struct ExtrinsicWrapper(Xt); impl traits::Extrinsic for ExtrinsicWrapper where Xt: parity_util_mem::MallocSizeOf, { type Call = (); type SignaturePayload = (); fn is_signed(&self) -> Option { None } } impl serde::Serialize for ExtrinsicWrapper { fn serialize(&self, seq: S) -> Result where S: ::serde::Serializer, { self.using_encoded(|bytes| seq.serialize_bytes(bytes)) } } impl From for ExtrinsicWrapper { fn from(xt: Xt) -> Self { ExtrinsicWrapper(xt) } } impl Deref for ExtrinsicWrapper { type Target = Xt; fn deref(&self) -> &Self::Target { &self.0 } } /// Testing block #[derive(PartialEq, Eq, Clone, Serialize, Debug, Encode, Decode, parity_util_mem::MallocSizeOf)] pub struct Block { /// Block header pub header: Header, /// List of extrinsics pub extrinsics: Vec, } impl< Xt: 'static + Codec + Sized + Send + Sync + Serialize + Clone + Eq + Debug + traits::Extrinsic, > traits::Block for Block { type Extrinsic = Xt; type Header = Header; type Hash =
::Hash; fn header(&self) -> &Self::Header { &self.header } fn extrinsics(&self) -> &[Self::Extrinsic] { &self.extrinsics[..] } fn deconstruct(self) -> (Self::Header, Vec) { (self.header, self.extrinsics) } fn new(header: Self::Header, extrinsics: Vec) -> Self { Block { header, extrinsics } } fn encode_from(header: &Self::Header, extrinsics: &[Self::Extrinsic]) -> Vec { (header, extrinsics).encode() } } impl<'a, Xt> Deserialize<'a> for Block where Block: Decode, { fn deserialize>(de: D) -> Result { let r = >::deserialize(de)?; Decode::decode(&mut &r[..]) .map_err(|e| DeError::custom(format!("Invalid value passed into decode: {}", e))) } } /// Test transaction, tuple of (sender, call, signed_extra) /// with index only used if sender is some. /// /// If sender is some then the transaction is signed otherwise it is unsigned. #[derive(PartialEq, Eq, Clone, Encode, Decode)] pub struct TestXt { /// Signature of the extrinsic. pub signature: Option<(u64, Extra)>, /// Call of the extrinsic. pub call: Call, } impl TestXt { /// Create a new `TextXt`. pub fn new(call: Call, signature: Option<(u64, Extra)>) -> Self { Self { call, signature } } } // Non-opaque extrinsics always 0. parity_util_mem::malloc_size_of_is_0!(any: TestXt); impl Serialize for TestXt where TestXt: Encode, { fn serialize(&self, seq: S) -> Result where S: Serializer, { self.using_encoded(|bytes| seq.serialize_bytes(bytes)) } } impl Debug for TestXt { fn fmt(&self, f: &mut fmt::Formatter) -> fmt::Result { write!(f, "TestXt({:?}, ...)", self.signature.as_ref().map(|x| &x.0)) } } impl Checkable for TestXt { type Checked = Self; fn check(self, _: &Context) -> Result { Ok(self) } } impl traits::Extrinsic for TestXt { type Call = Call; type SignaturePayload = (u64, Extra); fn is_signed(&self) -> Option { Some(self.signature.is_some()) } fn new(c: Call, sig: Option) -> Option { Some(TestXt { signature: sig, call: c }) } } impl traits::ExtrinsicMetadata for TestXt where Call: Codec + Sync + Send, Extra: SignedExtension, { type SignedExtensions = Extra; const VERSION: u8 = 0u8; } impl Applyable for TestXt where Call: 'static + Sized + Send + Sync + Clone + Eq + Codec + Debug + Dispatchable, Extra: SignedExtension, Origin: From>, { type Call = Call; /// Checks to see if this is a valid *transaction*. It returns information on it if so. fn validate>( &self, source: TransactionSource, info: &DispatchInfoOf, len: usize, ) -> TransactionValidity { if let Some((ref id, ref extra)) = self.signature { Extra::validate(extra, id, &self.call, info, len) } else { let valid = Extra::validate_unsigned(&self.call, info, len)?; let unsigned_validation = U::validate_unsigned(source, &self.call)?; Ok(valid.combine_with(unsigned_validation)) } } /// Executes all necessary logic needed prior to dispatch and deconstructs into function call, /// index and sender. fn apply>( self, info: &DispatchInfoOf, len: usize, ) -> ApplyExtrinsicResultWithInfo> { let maybe_who = if let Some((who, extra)) = self.signature { Extra::pre_dispatch(extra, &who, &self.call, info, len)?; Some(who) } else { Extra::pre_dispatch_unsigned(&self.call, info, len)?; U::pre_dispatch(&self.call)?; None }; Ok(self.call.dispatch(maybe_who.into())) } }