mirror of
https://github.com/pezkuwichain/pezkuwi-subxt.git
synced 2026-04-26 13:27:57 +00:00
Pierre Krieger
95 lines
3.0 KiB
Rust
95 lines
3.0 KiB
Rust
// 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 <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;
|
|
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,
|
|
);
|
|
let res = executor.call_in_wasm(
|
|
&WASM_BINARY[..],
|
|
None,
|
|
"test_empty_return",
|
|
&[],
|
|
&mut ext,
|
|
sp_core::traits::MissingHostFunctions::Allow,
|
|
).unwrap();
|
|
assert_eq!(res, vec![0u8; 0]);
|
|
}
|
|
}
|