pub mod errors; pub mod import_object; pub mod instance; pub mod memory; pub mod module; pub mod relocation; pub mod utils; use std::panic; use std::str::FromStr; use target_lexicon; use wasmparser; pub use self::errors::{Error, ErrorKind}; pub use self::import_object::ImportObject; pub use self::instance::{Instance, VmCtx}; pub use self::memory::LinearMemory; pub use self::module::{Export, Module, ModuleInfo}; pub struct ResultObject { /// A webassembly::Module object representing the compiled WebAssembly module. /// This Module can be instantiated again pub module: Module, /// A webassembly::Instance object that contains all the Exported WebAssembly /// functions. pub instance: Instance, } /// The webassembly::instantiate() function allows you to compile and /// instantiate WebAssembly code /// Params: /// * `buffer_source`: A `Vec` containing the /// binary code of the .wasm module you want to compile. /// * `import_object`: An object containing the values to be imported /// into the newly-created Instance, such as functions or /// webassembly::Memory objects. There must be one matching property /// for each declared import of the compiled module or else a /// webassembly::LinkError is thrown. /// Errors: /// If the operation fails, the Result rejects with a /// webassembly::CompileError, webassembly::LinkError, or /// webassembly::RuntimeError, depending on the cause of the failure. pub fn instantiate( buffer_source: Vec, import_object: ImportObject<&str, &str>, ) -> Result { let module = compile(buffer_source)?; debug!("webassembly - creating instance"); let instance = Instance::new(&module, &import_object)?; debug!("webassembly - instance created"); Ok(ResultObject { module, instance }) } /// The webassembly::instantiate_streaming() function compiles and instantiates /// a WebAssembly module directly from a streamed underlying source. /// This is the most efficient, optimized way to load wasm code. pub fn instantiate_streaming( _buffer_source: Vec, _import_object: ImportObject<&str, &str>, ) -> Result { unimplemented!(); } /// The webassembly::compile() function compiles a webassembly::Module /// from WebAssembly binary code. This function is useful if it /// is necessary to a compile a module before it can be instantiated /// (otherwise, the webassembly::instantiate() function should be used). /// Params: /// * `buffer_source`: A `Vec` containing the /// binary code of the .wasm module you want to compile. /// Errors: /// If the operation fails, the Result rejects with a /// webassembly::CompileError. pub fn compile(buffer_source: Vec) -> Result { // TODO: This should be automatically validated when creating the Module let valid = validate(&buffer_source); debug!("webassembly - valid {:?}", valid); if !valid { return Err(ErrorKind::CompileError("Module not valid".to_string())); } debug!("webassembly - creating module"); let module = Module::from_bytes(buffer_source, triple!("x86_64"), None)?; debug!("webassembly - module created"); Ok(module) } /// The webassembly::validate() function validates a given typed /// array of WebAssembly binary code, returning whether the bytes /// form a valid wasm module (true) or not (false). /// Params: /// * `buffer_source`: A `Vec` containing the /// binary code of the .wasm module you want to compile. pub fn validate(buffer_source: &Vec) -> bool { wasmparser::validate(buffer_source, None) }