// Copyright 2019-2021 Parity Technologies (UK) Ltd. // This file is part of Substrate. // Substrate 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. // Substrate 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 Cumulus. If not, see . //! The actual implementation of the validate block functionality. use frame_support::traits::{ExecuteBlock, ExtrinsicCall, IsSubType, Get}; use sp_runtime::traits::{Block as BlockT, Extrinsic, HashFor, Header as HeaderT, NumberFor}; use sp_io::KillChildStorageResult; use sp_std::prelude::*; use polkadot_parachain::primitives::{HeadData, ValidationParams, ValidationResult}; use codec::{Decode, Encode}; use sp_core::storage::ChildInfo; use sp_externalities::{set_and_run_with_externalities, Externalities}; use sp_trie::MemoryDB; type TrieBackend = sp_state_machine::TrieBackend>, HashFor>; type Ext<'a, B> = sp_state_machine::Ext<'a, HashFor, NumberFor, TrieBackend>; fn with_externalities R, R>(f: F) -> R { sp_externalities::with_externalities(f).expect("Environmental externalities not set.") } /// Validate a given parachain block on a validator. #[doc(hidden)] pub fn validate_block< B: BlockT, E: ExecuteBlock, PSC: crate::Config, CI: crate::CheckInherents, >( params: ValidationParams, ) -> ValidationResult where B::Extrinsic: ExtrinsicCall, ::Call: IsSubType>, { let block_data = cumulus_primitives_core::ParachainBlockData::::decode(&mut ¶ms.block_data.0[..]) .expect("Invalid parachain block data"); let parent_head = B::Header::decode(&mut ¶ms.parent_head.0[..]).expect("Invalid parent head"); let (header, extrinsics, storage_proof) = block_data.deconstruct(); let head_data = HeadData(header.encode()); let block = B::new(header, extrinsics); assert!( parent_head.hash() == *block.header().parent_hash(), "Invalid parent hash", ); // Uncompress let mut db = MemoryDB::default(); let root = match sp_trie::decode_compact::>, _, _>( &mut db, storage_proof.iter_compact_encoded_nodes(), Some(parent_head.state_root()), ) { Ok(root) => root, Err(_) => panic!("Compact proof decoding failure."), }; let backend = sp_state_machine::TrieBackend::new(db, root); let _guard = ( // Replace storage calls with our own implementations sp_io::storage::host_read.replace_implementation(host_storage_read), sp_io::storage::host_set.replace_implementation(host_storage_set), sp_io::storage::host_get.replace_implementation(host_storage_get), sp_io::storage::host_exists.replace_implementation(host_storage_exists), sp_io::storage::host_clear.replace_implementation(host_storage_clear), sp_io::storage::host_root.replace_implementation(host_storage_root), sp_io::storage::host_clear_prefix.replace_implementation(host_storage_clear_prefix), sp_io::storage::host_changes_root.replace_implementation(host_storage_changes_root), sp_io::storage::host_append.replace_implementation(host_storage_append), sp_io::storage::host_next_key.replace_implementation(host_storage_next_key), sp_io::storage::host_start_transaction .replace_implementation(host_storage_start_transaction), sp_io::storage::host_rollback_transaction .replace_implementation(host_storage_rollback_transaction), sp_io::storage::host_commit_transaction .replace_implementation(host_storage_commit_transaction), sp_io::default_child_storage::host_get .replace_implementation(host_default_child_storage_get), sp_io::default_child_storage::host_read .replace_implementation(host_default_child_storage_read), sp_io::default_child_storage::host_set .replace_implementation(host_default_child_storage_set), sp_io::default_child_storage::host_clear .replace_implementation(host_default_child_storage_clear), sp_io::default_child_storage::host_storage_kill .replace_implementation(host_default_child_storage_storage_kill), sp_io::default_child_storage::host_exists .replace_implementation(host_default_child_storage_exists), sp_io::default_child_storage::host_clear_prefix .replace_implementation(host_default_child_storage_clear_prefix), sp_io::default_child_storage::host_root .replace_implementation(host_default_child_storage_root), sp_io::default_child_storage::host_next_key .replace_implementation(host_default_child_storage_next_key), sp_io::offchain_index::host_set.replace_implementation(host_offchain_index_set), sp_io::offchain_index::host_clear.replace_implementation(host_offchain_index_clear), ); let inherent_data = block .extrinsics() .iter() .filter_map(|e| e.call().is_sub_type()) .find_map(|c| match c { crate::Call::set_validation_data(validation_data) => Some(validation_data.clone()), _ => None, }) .expect("Could not find `set_validation_data` inherent"); run_with_externalities::(&backend, || { let relay_chain_proof = crate::RelayChainStateProof::new( PSC::SelfParaId::get(), inherent_data.validation_data.relay_parent_storage_root, inherent_data.relay_chain_state.clone(), ) .expect("Invalid relay chain state proof"); let res = CI::check_inherents(block.extrinsics(), &relay_chain_proof); if !res.ok() { if log::log_enabled!(log::Level::Error) { res.into_errors().for_each(|e| { log::error!("Checking inherent with identifier `{:?}` failed", e.0) }); } panic!("Checking inherents failed"); } }); run_with_externalities::(&backend, || { super::set_and_run_with_validation_params(params, || { E::execute_block(block); let new_validation_code = crate::NewValidationCode::::get(); let upward_messages = crate::UpwardMessages::::get(); let processed_downward_messages = crate::ProcessedDownwardMessages::::get(); let horizontal_messages = crate::HrmpOutboundMessages::::get(); let hrmp_watermark = crate::HrmpWatermark::::get(); ValidationResult { head_data, new_validation_code: new_validation_code.map(Into::into), upward_messages, processed_downward_messages, horizontal_messages, hrmp_watermark, } }) }) } /// Run the given closure with the externalities set. fn run_with_externalities R>( backend: &TrieBackend, execute: F, ) -> R { let mut overlay = sp_state_machine::OverlayedChanges::default(); let mut cache = Default::default(); let mut ext = Ext::::new(&mut overlay, &mut cache, backend); set_and_run_with_externalities(&mut ext, || execute()) } fn host_storage_read(key: &[u8], value_out: &mut [u8], value_offset: u32) -> Option { match with_externalities(|ext| ext.storage(key)) { Some(value) => { let value_offset = value_offset as usize; let data = &value[value_offset.min(value.len())..]; let written = sp_std::cmp::min(data.len(), value_out.len()); value_out[..written].copy_from_slice(&data[..written]); Some(value.len() as u32) } None => None, } } fn host_storage_set(key: &[u8], value: &[u8]) { with_externalities(|ext| ext.place_storage(key.to_vec(), Some(value.to_vec()))) } fn host_storage_get(key: &[u8]) -> Option> { with_externalities(|ext| ext.storage(key).clone()) } fn host_storage_exists(key: &[u8]) -> bool { with_externalities(|ext| ext.exists_storage(key)) } fn host_storage_clear(key: &[u8]) { with_externalities(|ext| ext.place_storage(key.to_vec(), None)) } fn host_storage_root() -> Vec { with_externalities(|ext| ext.storage_root()) } fn host_storage_clear_prefix(prefix: &[u8]) { with_externalities(|ext| ext.clear_prefix(prefix)) } fn host_storage_changes_root(parent_hash: &[u8]) -> Option> { with_externalities(|ext| ext.storage_changes_root(parent_hash).ok().flatten()) } fn host_storage_append(key: &[u8], value: Vec) { with_externalities(|ext| ext.storage_append(key.to_vec(), value)) } fn host_storage_next_key(key: &[u8]) -> Option> { with_externalities(|ext| ext.next_storage_key(key)) } fn host_storage_start_transaction() { with_externalities(|ext| ext.storage_start_transaction()) } fn host_storage_rollback_transaction() { with_externalities(|ext| ext.storage_rollback_transaction().ok()) .expect("No open transaction that can be rolled back."); } fn host_storage_commit_transaction() { with_externalities(|ext| ext.storage_commit_transaction().ok()) .expect("No open transaction that can be committed."); } fn host_default_child_storage_get(storage_key: &[u8], key: &[u8]) -> Option> { let child_info = ChildInfo::new_default(storage_key); with_externalities(|ext| ext.child_storage(&child_info, key)) } fn host_default_child_storage_read( storage_key: &[u8], key: &[u8], value_out: &mut [u8], value_offset: u32, ) -> Option { let child_info = ChildInfo::new_default(storage_key); match with_externalities(|ext| ext.child_storage(&child_info, key)) { Some(value) => { let value_offset = value_offset as usize; let data = &value[value_offset.min(value.len())..]; let written = sp_std::cmp::min(data.len(), value_out.len()); value_out[..written].copy_from_slice(&data[..written]); Some(value.len() as u32) } None => None, } } fn host_default_child_storage_set(storage_key: &[u8], key: &[u8], value: &[u8]) { let child_info = ChildInfo::new_default(storage_key); with_externalities(|ext| { ext.place_child_storage(&child_info, key.to_vec(), Some(value.to_vec())) }) } fn host_default_child_storage_clear(storage_key: &[u8], key: &[u8]) { let child_info = ChildInfo::new_default(storage_key); with_externalities(|ext| ext.place_child_storage(&child_info, key.to_vec(), None)) } fn host_default_child_storage_storage_kill( storage_key: &[u8], limit: Option, ) -> KillChildStorageResult { let child_info = ChildInfo::new_default(storage_key); with_externalities(|ext| { let (all_removed, num_removed) = ext.kill_child_storage(&child_info, limit); match all_removed { true => KillChildStorageResult::AllRemoved(num_removed), false => KillChildStorageResult::SomeRemaining(num_removed), } }) } fn host_default_child_storage_exists(storage_key: &[u8], key: &[u8]) -> bool { let child_info = ChildInfo::new_default(storage_key); with_externalities(|ext| ext.exists_child_storage(&child_info, key)) } fn host_default_child_storage_clear_prefix(storage_key: &[u8], prefix: &[u8]) { let child_info = ChildInfo::new_default(storage_key); with_externalities(|ext| ext.clear_child_prefix(&child_info, prefix)) } fn host_default_child_storage_root(storage_key: &[u8]) -> Vec { let child_info = ChildInfo::new_default(storage_key); with_externalities(|ext| ext.child_storage_root(&child_info)) } fn host_default_child_storage_next_key(storage_key: &[u8], key: &[u8]) -> Option> { let child_info = ChildInfo::new_default(storage_key); with_externalities(|ext| ext.next_child_storage_key(&child_info, key)) } fn host_offchain_index_set(_key: &[u8], _value: &[u8]) {} fn host_offchain_index_clear(_key: &[u8]) {}