mirror of
https://github.com/pezkuwichain/pezkuwi-subxt.git
synced 2026-05-01 03:07:56 +00:00
Sergei Shulepov
eb7226bb4a
That is useful for executors like wasmtime which produces compiled code and can actually benefit from caching under some circumstances
96 lines
3.0 KiB
Rust
96 lines
3.0 KiB
Rust
// This file is part of Substrate.
|
|
|
|
// Copyright (C) 2017-2021 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 <https://www.gnu.org/licenses/>.
|
|
|
|
//! A crate that provides means of executing/dispatching calls into the runtime.
|
|
//!
|
|
//! There are a few responsibilities of this crate at the moment:
|
|
//!
|
|
//! - It provides an implementation of a common entrypoint for calling into the runtime, both
|
|
//! wasm and compiled.
|
|
//! - It defines the environment for the wasm execution, namely the host functions that are to be
|
|
//! provided into the wasm runtime module.
|
|
//! - It also provides the required infrastructure for executing the current wasm runtime (specified
|
|
//! by the current value of `:code` in the provided externalities), i.e. interfacing with
|
|
//! wasm engine used, instance cache.
|
|
|
|
#![warn(missing_docs)]
|
|
#![recursion_limit="128"]
|
|
|
|
#[macro_use]
|
|
mod native_executor;
|
|
mod wasm_runtime;
|
|
#[cfg(test)]
|
|
mod integration_tests;
|
|
|
|
pub use wasmi;
|
|
pub use native_executor::{with_externalities_safe, NativeExecutor, WasmExecutor, NativeExecutionDispatch};
|
|
pub use sp_version::{RuntimeVersion, NativeVersion};
|
|
pub use codec::Codec;
|
|
#[doc(hidden)]
|
|
pub use sp_core::traits::{Externalities, CallInWasm};
|
|
#[doc(hidden)]
|
|
pub use sp_wasm_interface;
|
|
pub use wasm_runtime::WasmExecutionMethod;
|
|
|
|
pub use sc_executor_common::{error, sandbox};
|
|
|
|
/// Provides runtime information.
|
|
pub trait RuntimeInfo {
|
|
/// Native runtime information.
|
|
fn native_version(&self) -> &NativeVersion;
|
|
|
|
/// Extract [`RuntimeVersion`](sp_version::RuntimeVersion) of the given `runtime_code`.
|
|
fn runtime_version(
|
|
&self,
|
|
ext: &mut dyn Externalities,
|
|
runtime_code: &sp_core::traits::RuntimeCode,
|
|
) -> error::Result<RuntimeVersion>;
|
|
}
|
|
|
|
#[cfg(test)]
|
|
mod tests {
|
|
use super::*;
|
|
use sc_runtime_test::wasm_binary_unwrap;
|
|
use sp_io::TestExternalities;
|
|
use sp_wasm_interface::HostFunctions;
|
|
use sp_core::traits::CallInWasm;
|
|
|
|
#[test]
|
|
fn call_in_interpreted_wasm_works() {
|
|
let mut ext = TestExternalities::default();
|
|
let mut ext = ext.ext();
|
|
|
|
let executor = WasmExecutor::new(
|
|
WasmExecutionMethod::Interpreted,
|
|
Some(8),
|
|
sp_io::SubstrateHostFunctions::host_functions(),
|
|
8,
|
|
None,
|
|
);
|
|
let res = executor.call_in_wasm(
|
|
&wasm_binary_unwrap()[..],
|
|
None,
|
|
"test_empty_return",
|
|
&[],
|
|
&mut ext,
|
|
sp_core::traits::MissingHostFunctions::Allow,
|
|
).unwrap();
|
|
assert_eq!(res, vec![0u8; 0]);
|
|
}
|
|
}
|