eosiolib依赖库

阅读更多

eosiolib库位于eos/contracts目录下,合约代码都会用到里面定义的类和函数,包含40多个文件

1.types.h,types.hpp:定义了EOS项目中的内建类型和相关的函数.eosiolib所有使用到的类型都在这里定义,name标识符与std::string类型之间转换函数也在这里定义

2.action.h:接口函数,这些C API函数是在eos/libraries/chain/wasm_interface.cpp中实现的,主要供给基础合约使用.其主要功能有:
a.action数据的读取
b.发送事务提交后的通知消息
c.执行action所需要的权限判断
d.包含其他辅助函数

action.hpp:定义了action结构体,它是action打包后的数据形式,即所有push action产生的数据根据各自不同的数据格式进行封装,打包和传送.其中涉及一些与执行权限相关的结构体定义,如permission_level

3.print.h,print.hpp:eos中各种参数类型打印函数的定义,最终使用的是std::ostringstream类型

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

5.dispatcher.hpp:用来处理,分发传入的action.它定义了执行action的函数模板execute_action,使用远程API调用Action时,会执行这个函数.其中有三个宏:
a.EOSIO_API_CALL:用来调用内部的execute_action函数,执行一个Action
b.EOSIO_API:使用BOOST_PP_SEQ_FOR_EACH循环调用EOSIO_API_CALL,即调用多个Action
c.EOSIO_ABI:里面是一个apply函数,后面还会调用EOSIO_API这个宏,即它也是用来调用execute_action来执行action的,在我们自行编写智能合约的时候在类内部最后会加上这个宏.所以当我们加载自己编写的智能合约时,会把编写好的指定的函数功能放到action上面执行

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

7.eosiolib.cpp:提供内存管理,数据流,区块链参数设置等功能.其中memory.hpp与memory.h用于内存管理.在这里,对常见的内存分配方式进行了重新编写(其实只是简单的封装而已)

8.stdlib.hpp:是一个include集合,引用了C++标准库中的initializer_list,iterator和memory

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

10.compiler_builtins.h:用于工具链生成编译器内嵌部件的API

11.crypto.h:定义各种加载算法.对给定的数据进行各种hash运算并进行存储,或者对数据进行校验.源码在eos/libraries/chain/wasm_interface.cpp中实现

12.db.h:用于和区块链数据库交互的API接口,db.h函数都在eos/libraries/chain/wasm_interface.cpp中的database_api类中定义,部分直接定义,部分采用宏定义,源码实现在eos/libraries/chain/apply_context.cpp中.提供了数据库的存储与查询的基本功能.其中使用的数据是controller类中定义的数据,在这里只是一个引用

13.system.h:定义用于与系统级内部函数进行交互的API,如系统时间函数和静态断言的定义

14.permission.hpp与permission.h:用来检测事务相关权限,在eos/libraries/chain/wasm_interface.cpp的permission_api类中实现,事务提交时需要检验执行者的权限都在这里.具体的校验通过与controller定义的数据库比对实现

15.privileged.hpp与privileged.h:实现系统相关的授权,定义特权用户的各种资源限制,事务相关参数,块相关参数及数据传输时间间隔的各种限制

16.asset.hpp:定义帐户资产,即用一个int64_t表示资金,用symbol_type表示单位(目前被定义为SYS)

17.currency.hpp:定义有关货币(Token),所有有关货币的创建,发行,转账,余额查询都在这里实现

18.datastream.hpp:定义数据流操作,可以把自定义的类的数据成员放到vector中,需要时可以再次读取出来,方便数据的传输

19.fixed_key.hpp:用于将固定大小key按键按字典顺序排序,使用数据成员std::array实现

20.fixedpoint.hpp:是32/64/128/256位版本的不动点变量

21.optional.hpp:表示可选类型,与boost:optinal基本一致

22.producer_schedule.hpp:表示生产者(出块者)计划表

23.public_key.hpp:公钥相关的数据

24.reflect.hpp:是c++实现的反射器,带有大量的宏

25.serialize.hpp:实现序列化宏,可以对有关数据进行序列化

26.singleton.hpp:用于实现单例模式的封装,也存储在multi_index中

27.symbol.hpp:用于定义代币符号,规定为SYS

28.time.hpp:用于与时间相关的数据,类似于boost中的实现

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

30.varint.hpp:定义整型,在datastream中有应用

31.vector.hpp:定义字节数组