1、链上下文
由于我们是应用到区块链中,所以我们需要把链的环境传递给wasmtime,这样wasmtime在运行合约的时候,就可以获取到链上数据;我们运行合约当时的环境,打包成一个变量context,传递给wasmtime。context的结果如下:
pub struct Context {
pub(crate) func_name: String, //调用函数名称
pub(crate) state: String,//合约状态
pub(crate) param: String,//调用函数的参数
pub(crate) invoker: Address, //调用者地址
pub(crate) owner: Address,//合约拥有者地址
pub(crate) self_address: Address,//合约地址
pub(crate) event: Vec<String>,//合约产生的事件
pub(crate) self_balance: u64,//合约余额
pub(crate) output_data: String,//合约返回数据
pub(crate) metadata: Metadata,//链数据,例如高度、时间等
pub(crate) gas: bool, //是否启动gas
pub(crate) gas_counter: u64,//gas计数
pub(crate) gas_limit: u64,//gas限制
pub(crate) gas_outof: bool,//gas是否超了
}
我们可以看到,都是当前交易和链的情况,例如调用函数,调用者地址,链高度,时间等这些都是当前链的情况,还有一部分数据其实正好相反,是合约产生的,要反馈给链或者用户,例如合约产生的事件,调用函数产生的返回值。
那我们是在什么时候,传递给wasmtime呢?
let mut store = Store::new(&engine, context);
就是在创建store,我们将我们context存入store中,存入的这些数据,我们后续还会继续用到
2、死循环
如果有人编写了一个死循环的合约,然后不小心调用了,怎么办?
我们在创建wasmtime的时候,可以创建一个监控线程,如果wasmtime执行时间超过了我们设定的时间,就会停止wasmitme,然后返回错误。
let engine = Engine::new(Config::new().epoch_interruption(true))?;
std::thread::spawn(move || {
std::thread::sleep(std::time::Duration::from_secs(1));
engine_clone.increment_epoch();
});
这里,我们将每次运行的时间设置为1s,超过这个时间,就会报错。
3、合约的存储格式
如果合约编译完之后,直接存储使用,效率还是差一点;我们可以提前(AOT)编译WebAssembly模块。
pub fn precompile_module(&self, bytes: &[u8]) -> Result<Vec<u8>>
存储之前,使用此方法会输出是一个编译过的模块。当我们再次使用的时候,需要调用如下函数解码,
pub unsafe fn deserialize( engine: &Engine, bytes: impl AsRef<[u8]> ) -> Result<Module>
运行现在字节码,性能会极大的提高。
4、添加linker
给wasmtime提供一系列的链环境接口,与之前合约部分,链接口是一一对应的,同样的模块鱼函数;例如获取,合约的拥有者,
linker.func_wrap(
"xq",
"get_owner",
|mut caller: Caller<'_, Context>, ptr: i32| {
charge_gas(&mut caller, GAS_ENV_FUNC_BASE);
//let owner:&[u8] = caller.data_mut().owner.deref();
let addr = caller.data_mut().owner; //
let owner = &addr.0;
let mem = match caller.get_export("memory") {
Some(Extern::Memory(mem)) => mem,
_ => anyhow::bail!("get_owner:failed to find memory"),
};
match mem.write(caller, ptr as usize, owner) {
Ok(_) => (),
Err(_) => anyhow::bail!("get_owner:MemoryAccessError"),
};
Ok(())
},
)?;
我们可以看到闭包中参数,有一个Caller<'_, Context> context就是我们定义链上下文,这样用户在调用合约中的获取合约地址的接口,就会调用到wasmtime中linker中定义的get_owner,而get_owner中,又会从context中获取到context中的合约地址,返回将他作为返回值返回给用户,其实是写入内存中的,这样合约在运行的过程中,就可以获取到合约地址了。
其他接口也是类的,需要我们自己去完成。