【eos全家桶系列】eos系统合约介绍 — 系统操作合约eosio.system (上)

简介

本篇将为大家介绍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所有权也一并转让。

开始更新refunds_table表

抵押给自己的delegatebw操作和undelegatebw操作，对refund表的更新

如果有待赎回的EOS，则三天后调用refund方法进行赎回操作

refund_delay设置为三天

from和receiver不同，触发transfer操作

赎回EOS

上面讲的undelegatebw方法，当有需要赎回的EOS时，会触发一个三天后才生效的defer交易，这个交易会触发refund方法，进行EOS的赎回。

方法会判断refund表中的request_time+refund_delay是否小于当前时间，小于当前时间才可以进行赎回操作。request_time就undelegatebw更新refund表的时间。

refund方法源码详情

投票操作

投票操作的源码，本质上调用了update_votes方法

voteproducer方法

账户既可以注册为超级节点候选账户，还可以注册为代理账户proxy。代理账户可以集中普通账户的投票权，代替其进行投票。

进行投票操作前，先要做一系列前置校验，比如：

1）不能同时投给超级节点候选账户和代理账户

2）超级节点账户需要按照字母顺序从小到大进行排序

3）代理节点账户不能投给其他代理节点账户

投票前置校验

为了鼓励用户认真的投票，EOS引入了投票权重的概念。投票的权重会随着时间的推移不断衰减，当用户重新触发vote操作时，投票权重会更新为新权重。所以，用户需要定期为心仪的超级节点重新投票，以保证自己的投票效力不会衰减。

投票权重更新

投票权重更新

投票权重计算公式

后记

本篇文章为大家介绍了eos投票和资源质押的操作和源码，后面讲为大家介绍下eosio.system域名竞拍相关的功能，以及源码实现，敬请期待！