【eos全家桶系列】eos系统合约介绍 — 系统操作合约eosi

2018-09-26 本文已影响314人 guaiguaihw

简介

本篇将为大家介绍eos最重要的系统操作合约—eosio.system合约，合约地址详见eosio.system。eosio.system合约涵盖了非常多的功能，包括：创建账户、投票选举超级节点、质押资源、域名竞拍等，本篇将为大家介绍eosio.system是如何实现质押资源和投票选举超级节点的。

质押资源与投票步骤

eos的超级节点选举、以及超级节点投票，都是围绕账户进行的。eosio.system的投票功能，都集成在了cleos system命令里，大家可以很方便使用命令行工具进行操作。

投票分为两个角色：投票账户和候选节点账户。它们想完成投票/当选，需要进行以下步骤：

投票账户：质押EOS—投票

候选节点账户：注册为出块节点

下面，将为大家演示下具体的步骤：

1. 抵押EOS换取cpu和net，只有抵押后的EOS才能用于投票。

voter2账户抵押给自己了51个EOS换取cpu、49个EOS换取net

delegatebw命令，可以指定哪个账户出EOS，以及抵押后的资源给哪个账户使用。

delegatebw命令详细解释

2. 账户注册为超级节点候选账户，这样别的账户才能给它投票

bp1注册为超级节点候选账户

注册为超级节点候选账户，需要提供公钥，这个公钥是用于当选超级节点后，产块时签名验证用

regproducer命令详细解释

3. 投票给超级节点候选账户

voter2投票给bp1

可以看到voter2已经成功投票给了bp1

voter2账户详情

我们来看voteproducer命令的详解，cleos system voteproducer prods是直接投给超级节点的命令，可以指定投票账户，可以一次性投给多个超级节点候选账户，账户名需要按字母从小到大排序，最多不超过30个账户。

voteproducer prods命令详细解释

取消投票步骤

当投票账户想取消投票时，只需要赎回质押的EOS即可，赎回期为3天。

下面，将为大家演示赎回的步骤：

1. 取消质押，使用的是cleos system undelegatebw命令，与delegatebw命令大同小异

voter2账户取消质押

我本机的私链，将赎回期改为了3分钟，可以看到undelegatebw命令，内部调用了refund方法，33分钟后将质押的EOS赎回到账了。具体的源码详情，我马上会讲到。

undelegatebw解除质押，并内部调用refund方法将EOS赎回到账

源码详解

质押/解除质押EOS

delegatebw/undelegatebw的源码，本质上调用了changebw的方法。

delegatebw/undelegatebw源码详情

changebw会进行如下操作：

1）更新cpu、net的质押表del_bandwidth_table

2）更新receiver账户的总体资源表user_resources_table

3）更新from账户的refunds_table，这个表用于标记赎回中的资源

4）更新投票权重

系统会通过传入的参数判断，是delegatebw还是undelegatebw操作，账户是否delegatebw给自。transfer参数为true表示from和receiver账户不同，将EOS的资源抵押给receiver并将EOS所有权一并转交。

changebw的方法参数

对于refund表的更新，根据不同条件有不同操作：

1）如果是undelegatebw操作，refund表中的cpu和net资源增加，表示为待赎回，request_time更新为目前的时间，这个时间很重要，会在计算赎回周期时用到。

2）如果是delegatebw给自己的操作，会优先从refund表中取尚未赎回的cpu和net，重新做抵押。如果refund表中不够，就从余额表中取EOS进行抵押

3）如果refund表中cpu和net的额度不为0，则need_deferred_trx标记为true，表示三天赎回周期到了后，要调用refund方法赎回EOS。

4）如果from和receiver不同，会触发transfer操作，将质押的EOS所有权也一并转让。