在PyEos上集成一种新的虚拟机非常的简单。PyEos在代码中实现了VM接口层,新的VM可以很方便的接进来。接入一款新的VM只需要实现以下5个函数就可以了。
五个重要函数
void vm_init(struct vm_api* api) ;
void vm_deinit();
int vm_setcode(uint64_t account) ;
int vm_apply(uint64_t receiver, uint64_t account, uint64_t act);
int vm_call(uint64_t account, uint64_t func);
其中必须实现的函数为:vm_setcode和vm_apply
在libraries/vm/vm_example目录下是一个最简单的例子,可以拷贝来作为项目开始的初始代码。
下面对这五个函数作一一的介绍:
vm_init
初始化vm的代码,这个函数会传递一个vm_api结构体进来
struct vm_api结构是一个很重要的函数,所有的智能合约的接口函数以及VM需要用到的函数都在这个结构里。这个结构体定义在下面的头文件中。
contracts/eosiolib_native/vm_api.h
vm_deinit
在卸载VM模块的时候被调用,在升级VM模块的时候会用到,在里面可以作一些清理VM的工作。
vm_setcode
这是一个很重要的函数,在处理eosio系统合约的setcode action中会被调用, 在这里可以作一些智能合约代码的初始化工作。
vm_apply
是实现智能合约VM中最重要的一个函数。在这个函数里要实现智能合约的代码的调用。
vm_call
这个函数用于实现跨智能合约代码调用
关于vm_manager
这是智能合约VM的管理器,代码路径如下:
libraries/vm_manager/vm_manager.cpp
这个类的目的是根据不同的虚拟机代码来调用相应的VM来执行代码。
VM的五个接口实现好以后,必须将VM加入到这个管理器来进行管理。加入的方式也很简单。
以接入lua虚拟机为例,要做的事如下:
指定lua 虚拟机动态库的路径:
static const char *vm_lua = "../libs/libvm_lua" DYLIB_SUFFIX;
在bool vm_manager::init(struct vm_api* api)中加入如下的代码:
load_vm_from_path(VM_TYPE_LUA, vm_lua);
编译VM代码:
修改如下的CMakeLists.txt,将VM代码的目录包含进去。
libraries/vm/CMakeLists.txt
测试
请参考/programs/pyeos/tests目录下的hello测试用例