// Copyright 2017-2019 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 Substrate. If not, see .
use std::{sync::Arc, panic::UnwindSafe, result, cell::RefCell};
use codec::{Encode, Decode};
use sr_primitives::{
generic::BlockId, traits::Block as BlockT, traits::NumberFor,
};
use state_machine::{
self, OverlayedChanges, Ext, ExecutionManager, StateMachine, ExecutionStrategy,
backend::Backend as _, ChangesTrieTransaction, StorageProof,
};
use executor::{RuntimeVersion, RuntimeInfo, NativeVersion};
use hash_db::Hasher;
use primitives::{
offchain::OffchainExt, H256, Blake2Hasher, NativeOrEncoded, NeverNativeValue,
traits::{CodeExecutor, KeystoreExt},
};
use sr_api::{ProofRecorder, InitializeBlock};
use client_api::{
error, backend, call_executor::CallExecutor,
};
/// Call executor that executes methods locally, querying all required
/// data from local backend.
pub struct LocalCallExecutor {
backend: Arc,
executor: E,
keystore: Option,
}
impl LocalCallExecutor {
/// Creates new instance of local call executor.
pub fn new(
backend: Arc,
executor: E,
keystore: Option,
) -> Self {
LocalCallExecutor {
backend,
executor,
keystore,
}
}
}
impl Clone for LocalCallExecutor where E: Clone {
fn clone(&self) -> Self {
LocalCallExecutor {
backend: self.backend.clone(),
executor: self.executor.clone(),
keystore: self.keystore.clone(),
}
}
}
impl CallExecutor for LocalCallExecutor
where
B: backend::Backend,
E: CodeExecutor + RuntimeInfo,
Block: BlockT,
{
type Error = E::Error;
fn call(
&self,
id: &BlockId,
method: &str,
call_data: &[u8],
strategy: ExecutionStrategy,
side_effects_handler: Option,
) -> error::Result> {
let mut changes = OverlayedChanges::default();
let state = self.backend.state_at(*id)?;
let return_data = StateMachine::new(
&state,
self.backend.changes_trie_storage(),
side_effects_handler,
&mut changes,
&self.executor,
method,
call_data,
self.keystore.clone().map(KeystoreExt),
).execute_using_consensus_failure_handler::<_, NeverNativeValue, fn() -> _>(
strategy.get_manager(),
false,
None,
)
.map(|(result, _, _)| result)?;
self.backend.destroy_state(state)?;
Ok(return_data.into_encoded())
}
fn contextual_call<
'a,
IB: Fn() -> error::Result<()>,
EM: Fn(
Result, Self::Error>,
Result, Self::Error>
) -> Result, Self::Error>,
R: Encode + Decode + PartialEq,
NC: FnOnce() -> result::Result + UnwindSafe,
>(
&self,
initialize_block_fn: IB,
at: &BlockId,
method: &str,
call_data: &[u8],
changes: &RefCell,
initialize_block: InitializeBlock<'a, Block>,
execution_manager: ExecutionManager,
native_call: Option,
side_effects_handler: Option,
recorder: &Option>,
enable_keystore: bool,
) -> Result, error::Error> where ExecutionManager: Clone {
match initialize_block {
InitializeBlock::Do(ref init_block)
if init_block.borrow().as_ref().map(|id| id != at).unwrap_or(true) => {
initialize_block_fn()?;
},
// We don't need to initialize the runtime at a block.
_ => {},
}
let keystore = if enable_keystore {
self.keystore.clone().map(KeystoreExt)
} else {
None
};
let mut state = self.backend.state_at(*at)?;
let result = match recorder {
Some(recorder) => {
let trie_state = state.as_trie_backend()
.ok_or_else(||
Box::new(state_machine::ExecutionError::UnableToGenerateProof)
as Box
)?;
let backend = state_machine::ProvingBackend::new_with_recorder(
trie_state,
recorder.clone()
);
StateMachine::new(
&backend,
self.backend.changes_trie_storage(),
side_effects_handler,
&mut *changes.borrow_mut(),
&self.executor,
method,
call_data,
keystore,
)
.execute_using_consensus_failure_handler(
execution_manager,
false,
native_call,
)
.map(|(result, _, _)| result)
.map_err(Into::into)
}
None => StateMachine::new(
&state,
self.backend.changes_trie_storage(),
side_effects_handler,
&mut *changes.borrow_mut(),
&self.executor,
method,
call_data,
keystore,
)
.execute_using_consensus_failure_handler(
execution_manager,
false,
native_call,
)
.map(|(result, _, _)| result)
}?;
self.backend.destroy_state(state)?;
Ok(result)
}
fn runtime_version(&self, id: &BlockId) -> error::Result {
let mut overlay = OverlayedChanges::default();
let state = self.backend.state_at(*id)?;
let mut ext = Ext::new(
&mut overlay,
&state,
self.backend.changes_trie_storage(),
None,
);
let version = self.executor.runtime_version(&mut ext);
self.backend.destroy_state(state)?;
version.ok_or(error::Error::VersionInvalid.into())
}
fn call_at_state<
S: state_machine::Backend,
F: FnOnce(
Result, Self::Error>,
Result, Self::Error>,
) -> Result, Self::Error>,
R: Encode + Decode + PartialEq,
NC: FnOnce() -> result::Result + UnwindSafe,
>(&self,
state: &S,
changes: &mut OverlayedChanges,
method: &str,
call_data: &[u8],
manager: ExecutionManager,
native_call: Option,
side_effects_handler: Option,
) -> error::Result<(
NativeOrEncoded,
(S::Transaction, ::Out),
Option>>,
)> {
StateMachine::new(
state,
self.backend.changes_trie_storage(),
side_effects_handler,
changes,
&self.executor,
method,
call_data,
self.keystore.clone().map(KeystoreExt),
).execute_using_consensus_failure_handler(
manager,
true,
native_call,
)
.map(|(result, storage_tx, changes_tx)| (
result,
storage_tx.expect("storage_tx is always computed when compute_tx is true; qed"),
changes_tx,
))
.map_err(Into::into)
}
fn prove_at_trie_state>(
&self,
trie_state: &state_machine::TrieBackend,
overlay: &mut OverlayedChanges,
method: &str,
call_data: &[u8]
) -> Result<(Vec, StorageProof), error::Error> {
state_machine::prove_execution_on_trie_backend(
trie_state,
overlay,
&self.executor,
method,
call_data,
self.keystore.clone().map(KeystoreExt),
)
.map_err(Into::into)
}
fn native_runtime_version(&self) -> Option<&NativeVersion> {
Some(self.executor.native_version())
}
}