区块链 + 大数据：EOS存储

链客，专为开发者而生，有问必答！

此文章来自区块链技术社区，未经允许拒绝转载。

谈到区块链的存储，我们很容易联想到它的链式存储结构，然而区块链从比特币发展到今日当红的EOS，技术形态已经演化了10年之久。目前的EOS的存储除了确认结构的链式存储以外，在状态存储方面有了很大的进步，尤其是引入了MongoDB plugin以后，可以将功能有限的状态库搭上大数据的班车。本文将全面介绍EOS的存储技术。

EOS 存储，Merkle Tree，mongodb，chainbase，源码学习，context_free_actions

EOS的链式存储结构
EOS的区块数据结构如下：

field

explanation

timestamp

时间戳

producer

生产者

confirmed

生产者确认数

previous

链式结构前一个区块的id

transaction_mroot

交易默克尔树根

action_mroot

动作默克尔树根

schedule_version

生产者版本排序号

new_producers

下一个生产者

header_extensions

区块头扩展字段

producer_signature

区块签名，由生产者签名

transactions

块打包交易内容，是数组结构，可以多个

block_extensions

区块扩展字段

id

当前块id

block_num

当前块高度

ref_block_prefix

引用区块的区块头

Merkle Tree
默克尔树的演化路线是 Hash => Hash Tree => Merkle Tree ，他们都是为解决数据一致性而存在的，具体的含义如下：

Hash 是我们都熟知的技术了，它可以为一个文件或其他数据生成一个Hash值，我们在下载一个文件时，通常会在下载页面看到这个文件的Hash值以及该Hash值的算法，下载完毕以后，我们可以在本地对整个文件进行同样的Hash算法得到Hash值，然后与网页上的Hash值进行对比，如果相同，则说明文件完整，是网页上的源文件，如果不匹配则说明文件损坏，被修改或者不完整。
仍旧是文件完整性的校验需求，当这个文件特别大的时候，对这个文件进行Hash算法是能耗巨大的，所以可以将文件切割成很多的小块，每一个小块都有一个Hash，然后将所有小块的Hash值拼在一起再次进行Hash算法得到的就是Root Hash。这样一来，我们在下载大文件的时候，会先下载一个包含Root Hash的Hash list，通过校验Root Hash可以确定Hash list的正确性，确定Hash list正确以后，再逐个下载小块文件并逐一验证Hash，当发现某个小块Hash不匹配的时候，就可以单独重新下载该小块即可，而不必重新下载全部。Hash list的结构实际上是一个Root Hash 为根，小块Hashs为叶子节点的树高为2的Hash Tree。
Merkle Tree实际上是对Hash List的优化，它极大的提高了性能。它的结构是一个二叉树（也可以是多叉树，性能优化的关键点是它的高度是大于等于2的），每个节点最多只有两个子节点，只有叶节点是根据小块文件做的Hash，每两个相邻的叶节点的父节点是由这两个Hash做的父Hash，如果叶节点的总数是单数，则会剩余一个，逐级而上，最终会有一个的根节点，这个根节点就是Merkle Root。这样以来，我们在下载大文件的时候，会首先下载一个Merkle Tree，从最左下叶节点进行校验，逐级而上，将整个Merkle Tree校验完毕。这里面不同于上面Hash Tree的是，只要最左下相邻的两个叶节点的Hash值与他们的父节点的Hash通过了匹配，则可以立即开始下载这两个叶节点对应的文件块，并行地，再校验其他叶节点，这就提高了性能，不必校验完整的Merkle Tree之后再下载文件。
Merkle Tree 与 区块链
上面的区块数据结构中包含了两个与Merkle Tree相关的字段：

transaction_mroot，一个区块中的transactions字段可以包含多笔交易，区块中的transaction_mroot是所有该区块内打包的交易的Merkle Root，可以用来校验其中的每笔交易的正确性。如果该区块中不包含任何交易，则该字段的值为0000000000000000000000000000000000000000000000000000000000000000。节点同步数据的时候，会先将交易的Merkle Tree下载并通过Merkle Root来校验，而不是将所有的交易主体全部下载下来，这样可以节省轻节点的数据量。
action_mroot，创建一个基于所有分发的action的根，在区块内接收交易时进行评估。用在轻客户端的校验，功能同上。
action_mroot是始终有值的，哪怕transaction_mroot是0，这是因为出块本身也是一个action动作onblock，这个动作调用的是system合约的onblock函数。TODO：源码分析

/**

• At the start of each block we notify the system contract with a transaction that passes in
• the block header of the prior block (which is currently our head block)

*/
signed_transaction get_on_block_transaction()
{
action on_block_act;
on_block_act.account = config::system_account_name;
on_block_act.name = N(onblock);
on_block_act.authorization = vector<permission_level>{{config::system_account_name, config::active_name}};
on_block_act.data = fc::raw::pack(self.head_block_header());

signed_transaction trx;
trx.actions.emplace_back(std::move(on_block_act));
trx.set_reference_block(self.head_block_id());
trx.expiration = self.pending_block_time() + fc::microseconds(999'999); // Round up to nearest second to avoid appearing expired
return trx;
}
context_free_actions
通过对eosio.null账户的nouce动作，可以将无签名的数据打包进入context_free_action字段，结果区块信息如下：

evsward@evsward-TM1701:~/work/src/github.com/eos/tutorials/bios-boot-tutorial$ cleos --wallet-url http://127.0.0.1:6666 --url http://127.0.0.1:8000 get block 440
{
"timestamp": "2018-08-14T08:47:09.000",
"producer": "eosio",
"confirmed": 0,
"previous": "000001b760e4a6610d122c5aa5d855aa49e29f3052ac3e40b9e1ef78e0f1fd02",
"transaction_mroot": "32cb43abd7863f162f4d8f3ab9026623ea99d3f8261d2c8b4d8bf920ab97e3d1",
"action_mroot": "09afeaf40d6988a14e9e92817d2ccf4023b280075c99f13782a6535ccc58cbb0",
"schedule_version": 0,
"new_producers": null,
"header_extensions": [],
"producer_signature": "SIG_K1_K2eFDzbxCg3hmQzpzPuLYmiesrciPmTHdeNsQDyFgcHUMFeMC3PntXTqiup5VuNmyb7qmH18FBdMuNKsc7jgCm1TSPFbaj",
"transactions": [{

  "status": "executed",
  "cpu_usage_us": 290,
  "net_usage_words": 16,
  "trx": {
    "id": "d74843749d1e255f13572b7a3b95af9ddd6df23d1d0ad19d88e1496091d4be2b",
    "signatures": [
      "SIG_K1_KVzwg3QRH6ZmempNsvAxpPQa42hF4tDpV5cqwqo7EY4oSU7NMrEFwG7gdSDCnUHHhmH1EwtVAmV1z9bqtTvvQNSXiSgaWG"
    ],
    "compression": "none",
    "packed_context_free_data": "",
    "context_free_data": [],
    "packed_trx": "8497725bb601973ea96f0000000100408c7a02ea3055000000000085269d000706686168616861010082c95865ea3055000000000000806b010082c95865ea305500000000a8ed3232080000000000d08cf200",
    "transaction": {
      "expiration": "2018-08-14T08:49:08",
      "ref_block_num": 438,
      "ref_block_prefix": 1873362583,
      "max_net_usage_words": 0,
      "max_cpu_usage_ms": 0,
      "delay_sec": 0,
      "context_free_actions": [{
          "account": "eosio.null",
          "name": "nonce",
          "authorization": [],
          "data": "06686168616861"
        }
      ],
      "actions": [{
          "account": "eosiotesta1",
          "name": "hi",
          "authorization": [{
              "actor": "eosiotesta1",
              "permission": "active"
            }
          ],
          "data": {
            "user": "yeah"
          },
          "hex_data": "0000000000d08cf2"
        }
      ],
      "transaction_extensions": []
    }
  }
}

],
"block_extensions": [],
"id": "000001b8d299602b289a9194bd698476c5d39c5ad88235460908e9d43d04edc8",
"block_num": 440,
"ref_block_prefix": 2492570152
}
正常的actions的内容是hi智能合约的调用，而context_free_action中包含了无签名的data数据，是已做数字摘要后的形态。源码中的操作：

// lets also push a context free action, the multi chain test will then also include a context free action
("context_free_actions", fc::variants({

fc::mutable_variant_object()
   ("account", name(config::null_account_name))
   ("name", "nonce")
   ("data", fc::raw::pack(v))
})

);
EOS的StateDB
我们来设想一个场景：

A账户转账给B账户100个SYS，如何查看A账户的余额？

对于不知道以上动作何时发生的我们来讲，我们要如何做呢：

首先是从头扫描区块内的交易，交易内的action，直到找到A账户被创建的action所对应的区块号。
从这个区块号开始继续扫描，要将所有A账户的转账，包括收入和支出的所有action记录下来并统计。
算出A的当前余额。
以上步骤很容易出错且繁琐，每一次的余额查询都要重复这些操作实在是毫无意义，因此StateDB就诞生了，这个库顾名思义就是用来存储状态数据的，如果有了StateDB，上面的场景的解决办法就是：

从A账户被第一次收入SYS开始，为A账户在StateDB中建立一个table，存储A账户的余额，每当A账户发生转账的action，都会同步更新StateDB中相关table中A账户的余额的值，当我们需要知道A账户的余额时，我们可以直接查找这个余额state即可。
测试用例
这里为大家提供一个测试方法，也是我的命令history：

cleos create key
cleos wallet import 5JA9oDotJHoKnjUV6NrAMx4g5gWTCVCRLybTnG1XVU3EKGZZeNY
cleos wallet import --private-key 5JA9oDotJHoKnjUV6NrAMx4g5gWTCVCRLybTnG1XVU3EKGZZeNY
cleos wallet keys
cleos wallet import --private-key 5KQwrPbwdL6PhXujxW37FSSQZ1JiwsST4cqQzDeyXtP79zkvFD3
cleos wallet keys
cleos create account eosio usertesta1 EOS761KfjhYy3FSypZGG5hePrR8K2wzmw75JCDXgypKt2DLXZoZPW
cleos create account eosio eosio.token EOS761KfjhYy3FSypZGG5hePrR8K2wzmw75JCDXgypKt2DLXZoZPW
cleos set contract eosio.token work/src/github.com/eos/build/contracts/eosio.token/
cleos push action eosio.token create '["eosio","100000000.0000 SYS"]'
cleos push action eosio.token issue
cleos push action eosio.token issue '["usertesta1","10000000.0000 SYS"]' -p eosio.token
cleos push action eosio.token issue '["usertesta1","10000000.0000 SYS"]' -p eosio
cleos get currency balance eosio.token usertesta1
cleos get table eosio.token usertesta1 accounts
cleos get table eosio.token eosio accounts
可以看到当我想获得usertesta1账户的余额时，是通过查询StateDB的table来获取的，而不是最开始的那种扫块的笨方法。

链式存储和StateDB存储的区别
链式存储，存储的是固定结构的数据：Block=> Block Header/ transactions=>actions，一个action的结构例子：
{

"account": "eosiotesta1",
"name": "hi",
"authorization": [{
  "actor": "eosiotesta1",
  "permission": "active"
}],
"data": {
"user": "yeah"
},
"hex_data": "0000000000d08cf2"

}
这个例子中，我们调用了hello合约的hi函数，data传入的格式是hi函数中自定义的，所以在链式存储中，留给我们发挥的空间也即在此。

StateDB，存储的是一个最终要记录的状态，这个状态数据必须是有意义的，是有人关心的，无关紧要的数据请不要放在StateDB中去，所以StateDB是可以增删改查的，就像一个普通数据库那样，在合约中通过multi_index来操作，具体请参照文章EOS技术研究：合约与数据库交互
很多人搞不明白为什么区块链不可篡改，却在StateDB中好像可以修改还能删除？

其实不是这样的，链式存储的内容会将所有的动作action全部记录下来，是所有的过程数据，是流水帐，元数据，这些数据一旦上链是不可修改，不可删除的。而StateDB只是为了保存一个状态信息，这个状态信息的修改与删除并不影响区块链的不可篡改的特性。

目前StateDB的主流实现方式是将它放在内存中，而当有些人对StateDB的认识有偏差造成滥用的时候，会引发内存过载，因此一方面我们要非常清楚的理解StateDB的含义，一方面EOSIO帮助我们提供了一个mongodb-plugin插件来同步StateDB数据。

mongodb
安装
下载tgz安装包
解压安装到/usr/local/bin（或者其他某路径）
sudo mkdir /data/db
普通模式
sudo mongod
mongo
服务模式
我们也可以使用ubuntu系统的服务模式。

曾经我们要定义一个系统启动时自启动服务的方式是在/etc/init.d 目录下写一个脚本来执行，现在在ubuntu的服务模式下，我们可以丢弃那种方式，服务模式的命令是service，而现在的ubuntu系统推崇使用的systemctl命令，他俩的使用方法的区别就在于参数的顺序。

定义一个配置文件mongod.conf
定义一个服务文件，放置在/etc/systemd/system/
sudo vi /etc/systemd/system/mongodb.service

[Unit]
Description=High-performance, schema-free document-oriented database
After=network.target

[Service]
User=mongodb
ExecStart=['mongod' command location] --quiet --config /etc/mongod.conf

[Install]
WantedBy=multi-user.target
查找服务状态
systemctl list-unit-files

查询mongodb服务的激活状态
systemctl is-enabled mongodb

激活系统自启动服务
sudo systemctl enable mongodb

启动mongodb服务
sudo systemctl start mongodb

查询mongodb服务状态
sudo systemctl status mongodb

停止mongodb服务
sudo systemctl stop mongodb

调试模式
IDE选择CLion，EOS源码下载最新的，保证本地可以使用脚本编译通过，安装了相关依赖包，然后在CLion中导入EOS，CLion会自动识别CMakeList.txt文件生成makefile文件并make编译执行。编译时可能会遇到错误，一般来讲要么是环境依赖没有配置好，要么就是CMakeList.txt要有修改，例如mongodb-plugin导入时要在总开关配置上开启。

set(BUILD_MONGO_DB_PLUGIN "true")
全部编译成功以后，会自动识别出可以debug的target，与EOS中配备CMakeList.txt的模块一一对应。

安装Mongo Explorer插件
上面我们介绍了MongoDB的安装方法，以及启动nodeos时的配置方法（除了上文提到的总开关，当然要在config.ini文件末尾设置上plugin = eosio::mongo_db_plugin，这部分内容演练多次，这里不再赘述。）链启动开始出块以后，会同步到mongodb中去（注意要预先启动mongod守护进程，可以理解为服务端），通过mongo命令接入可使用mongo命令查询数据，但这样很不方便。可以在CLion中安装mongo-plugin，配置好效果如下：

---