eosiolib文件解析

Source base on EOS version: 1.0.5,some photo except.
 
在eos源码中,eosiolib库在源码中的位置如下:
在\eos\contracts\eosiolib一共有46个文件,其中很大部分都为头文件,具体的实现都在 eos/libraries/chain/wasm_interface.cpp中,下面我们对每个文件都做一个较为简单的介绍。
 

action.h

此头文件为接口函数,这些C API函数是在 eos/libraries/chain/wasm_interface.cpp 中实现的,主要提供给四大合约使用。
主要包含有这些功能 :
  • action数据的读取;
  • 事务提交后的通知消息(观察者模式实现);
  • 执行action所需要的权限判断;
  • 其它辅助函数;
 

action.hpp

在action.hpp中定义了action结构体,它是Action打包后的数据形式,即所有push action产生的数据根据各自不同的数据格式进行封装打包和传送。其中还涉及到一些执行权限相关的结构体的定义permission_level,它的处理流程如下图展示:
最后action将会放在对应的vector迭代器中。
 

asset.hpp

帐户资产的定义,即一个int64_t表示资金,symbol_type表示单位,目前被定义为SYS。
 

chain.h

查询区块链内部状态的API,目前用于获取活跃(Active)的生产者,是从controller中拿取的,源码在eos/libraries/chain/wasm_interface.cpp中实现。
 

compiler_builtins.h

工具链生成的编译器内嵌部件的API。
 

contract.hpp

定义所有智能合约的基类,如果自己写合约,需要从这个基类派生,然后使用eosiocpp工具将自己的头文件和源文件生成wasm文件及其相关的接口文件。编写智能合约需要注意各个文件名需要名称相同,因为加载智能合约时填写的参数是根据智能合约文件路径来的。
 

core_symbol.hpp

定义代币的单位。
 

crypto.h

对给定的数据进行各种hash运算并进行存储,或者对数据进行校验。源码在eos/libraries/chain/wasm_interface.cpp中实现。
 

currency.hpp

货币(token合约)的创建、发行、转帐、余额查询在里实现。
 

datastream.hpp & serialize.hpp

定义数据流操作,可以把自定义的类的数据成员放到vector<char>中,需要时可以再次读取出来,方便数据的传输。
 

db.h

函数都在eos/libraries/chain/wasm_interface.cpp中的database_api类中定义,部分直接定义,部分采用宏定义,源码实现在eos\libraries\chain\apply_context.cpp中。提供了数据库的存储与查询的基本功能。其中使用的数据库是controller类中定义的数据,在这里只是一个引用。
 

dispatcher.hpp

定义了执行Action的函数模板execute_action,使用远程API调用Action时,会执行这个函数。其中有两个宏:
  • EOSIO_API_CALL  内部调用了execute_action函数,执行一个Action;
  • EOSIO_API 使用BOOST_PP_SEQ_FOR_EACH循环调用EOSIO_API_CALL,即调用多个Action;
  • EOSIO_ABI 里面是一个apply函数,后面还调用EOSIO_API这个宏,即它也是用来调用 execute_action来执行action的,在我们自行编写智能合约的时候在类内部最后会加上这个宏。所以当我们加载自己编写的智能合约时,会把编写好的指定的函数功能放到action上面去执行。
 

eosio.hpp

包含其它一些类型的定义。在开发智能合约时,一般都包含这个头文件进行智能合约的开发。
 

eosiolib.cpp & memory.h & memory.hpp

eosiolib中实现了eosio项目中自定义的内存管理,对常见的内存分配方式进行了重新编写(其实只是简单的封装而已)
 

fixed_key.hpp

固定大小的按键按字典顺序排序的key,使用数据成员std::array<word_t, num_words()>实现的。
 

fixedpoint.hpp

32/64/128/256位版本的不动点变量,暂时还不知道做什么用的。
 

multi_index.hpp

重新封装了多索引容器模板,最终里面还是使用的boost:multi_index,这一点没有变化,它具有以下几个特点:
  • Multi-Index表的二级索引数量不能超过16个;
  • Multi-Index表的表名不能超过12个字符;
  • Multi-Index表支持双向迭代,即const_iterator和const_reverse_iterator。
 
很多类型都使用了它来存放,如生产者,投票,单例等等。
 

optional.hpp

可选类型,与boost:optinal基本一致
 

permission.h & permission.hpp

在eos/libraries/chain/wasm_interface.cpp的permission_api类中实现,事务提交时需要检验执行者的权限在这里。具体的校验在controller定义的数据库去比对了。
 

print.h & print.hpp

eosio中各种参数类型打印函数的定义,最终使用的是std::ostringstream类型。
 

privileged.h & privileged.hpp、

定义特权用户的各种资源限制,事务相关参数,块相关参数,以及数据传输时间间隔的各种限制。
 

producer_schedule.hpp

出块者相关信息的封装。
 

public_key.hpp

公匙
 

reflect.hpp

c++实现的反射器,带有大量的宏,可以自行分析下,下面有一个博客对此有些讲解:
 

singleton.hpp

单例模式的封装,也存储在multi_index中。
 

stdlib.hpp

//nothing
 

symbol.hpp

代币符号,规定为SYS
 

system.h

系统时间函数和静态断言的定义
 

time.hpp

时间相关,类似boost中的实现
 

transaction.h & transaction.hpp

事务相关,主要是对action用vector封装,另外,对nsaction的数据传输也做了各种限制,如预期时间,带宽,cpu算力,延迟传输等等。还有一个get action函数的实现,可以获取当前区块相关的数据。
 

types.h & types.hpp

eosiolib所有使用到的类型都在这里定义,以及name标识符与std::string类型之间转换函数的定义;
所有文件相互间的引用关系如下:
 

varint.hpp

整型的定义,在datastream中有应用。
 

vector.hpp

字节数组
posted @ 2018-06-27 17:04  HBright  阅读(2212)  评论(2编辑  收藏  举报