简介
本篇将为大家介绍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换取netdelegatebw命令,可以指定哪个账户出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表的更新,根据不同条件有不同操作:
开始更新refunds_table表 抵押给自己的delegatebw操作和undelegatebw操作,对refund表的更新 如果有待赎回的EOS,则三天后调用refund方法进行赎回操作 refund_delay设置为三天 from和receiver不同,触发transfer操作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所有权也一并转让。
赎回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域名竞拍相关的功能,以及源码实现,敬请期待!
网友评论