EOSIO Dawn 4.0 系统合约解读

Dawn 4.0 发布后,基本上白皮书上提到的特性都得到了实现,特别是投票、资源抵押和内存买卖。

EOS 的网络带宽和计算资源是通过抵押代币的方式获得,如果不需要了可以解除抵押收回原先的代币。

投票的权重和抵押代币所获得的带宽和计算资源相关,抵押了越多,投票的权重越大。同时投票的权重会随着时间的推移减少,这个设定鼓励用户持续更新自己的投票。

而存储资源则是通过购买来得到,但是并不会消耗,当不再需要存储资源的时候可以出售。但是存储资源相对于EOS代币的价格会随着市场对于存储资源的需求而变动。

而这些功能都是在 eosio.system 这个智能合约中实现。

本文试图通过分析 eosio.system 中所有的功能函数来解读 eos 系统功能。

函数列表

在 eosio.system.hpp 头文件中包含以下函数声明:

delegatebw

void onblock( block_timestamp timestamp, account_name producer );

void delegatebw( account_name from, account_name receiver,asset stake_net_quantity, asset stake_cpu_quantity, bool transfer );

delegatebw 函数用来实现抵押代币获取 cpu 和带宽资源。参数定义:

  • from : 从哪个账号扣除用来抵押的代币
  • receiver : 抵押的代币的接受者,表示抵押获取的资源作用在哪个账号上
  • stake_net_quantity : 用来抵押带宽资源的代币数量
  • stake_cpu_quantity : 用来抵押计算资源的代币数量
  • transfer : 是否接受者可以主动解除抵押获得代币,如果不是,只有发起者能够解除抵押收回代币

undelegatebw

void undelegatebw( account_name from, account_name receiver,asset unstake_net_quantity, asset unstake_cpu_quantity );

undelegatebw 函数用来解除抵押,释放资源,收回代币,参数定义:

  • from : 解除用哪个账号所抵押的代币
  • receiver : 解除作用在哪个账号上的抵押代币
  • unstake_net_quantity : 解除用来获取带宽资源的代币数量
  • unstake_cpu_quantity : 解除用来获取计算资源的代币数量

解除抵押之后,资源会马上释放,同时投票权重也相应消失。但是代币需要等待一定时间才能回到账号里,目前的设定是3天。

buyram

void buyram( account_name buyer, account_name receiver, asset tokens );

void buyrambytes( account_name buyer, account_name receiver, uint32_t bytes );

这两个函数的作用是购买存储资源,区别是买特定数量的代币还是买特定大小的内容。参数定义:

  • buyer : 购买存储资源的账号
  • receiver : 接受存储资源的账号
  • tokens : 购买存储资源所用的代币数量
  • bytes : 都买存储资源空间大小的数值

sellram

void sellram( account_name receiver, int64_t bytes );

sellram函数功能是出售不需要的存储资源。参数定义:

  • receiver : 出售资源代币的接受账号
  • bytes : 出售多少空间的存储资源

出售后资源会马上释放,收入的代币也会马上入账。

refund

void refund( account_name owner );

refund 函数 在 undelegatebw 函数解除抵押后调用,作用是把抵押的代币退回账户。

regproducer

void regproducer( const account_name producer, const public_key& producer_key, const std::string& url, uint16_t location );

regproducer 函数的作用是注册成为超级节点候选人。参数定义:

  • producer : 候选节点的账户名
  • producer_key : 候选节点的账户公钥
  • url : 候选节点的网站地址
  • location : 候选节点的机房地理位置

注册成为候选人后就可以接受用户的投票了。

unregprod

void unregprod( const account_name producer );

unregprod 函数的作用的取消成为候选人。

voteproducer

void setram( uint64_t max_ram_size );

void voteproducer( const account_name voter, const account_name proxy, const std::vector<account_name>& producers );

voteproducer 函数的作用是投票。参数定义:

  • voter : 投票人
  • proxy : 代理投票人
  • producers : 得票人列表

有两种投票模式,代理模式和直接投票模式。代理模式是将投票权重委托给一个代理人,让他帮你投票。直接投票模式就是直接投票给你信任的超级节点,最多30个。

regproxy

void regproxy( const account_name proxy, bool isproxy );

regproxy 函数的作用是注册成为代理人,接受其他用户的委托。

claimrewards

void claimrewards( const account_name& owner );

claimrewards 函数的作用是支付超级节点的奖励。

void setpriv( account_name account, uint8_t ispriv );

测试方法

开发者可以通过 cleos system 子命令来测试这些功能。

如果要加入一个测试网络成为出块人,步骤应该是这样:

  • 注册账号
  • 启动节点同步区块
  • 注册成为候选人
  • 抵押代币获得资源和投票权重
  • 投票给自己
  • 当得票足够后,等待一个周期,就可以成为出块人了。
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 194,491评论 5 459
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 81,856评论 2 371
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 141,745评论 0 319
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 52,196评论 1 263
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 61,073评论 4 355
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 46,112评论 1 272
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 36,531评论 3 381
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 35,215评论 0 253
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 39,485评论 1 290
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 34,578评论 2 309
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 36,356评论 1 326
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 32,215评论 3 312
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 37,583评论 3 299
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 28,898评论 0 17
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 30,174评论 1 250
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 41,497评论 2 341
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 40,697评论 2 335

推荐阅读更多精彩内容

  • 说到EOS,币圈的人肯定都不陌生。从EOS.IO众筹开始,就引起了币圈的极大关注,无论是天才CEO,还是奇葩的众筹...
    张锦沛翀阅读 2,324评论 1 17
  • 晚饭后,女儿玩扭扭车了,我说“宝贝,妈妈去楼上了,你呢?”“我再玩会,等下和爸爸一起过来”“好的,玩车的时候那你小...
    陌忘微笑_243e阅读 100评论 0 0
  • 还记得小时候,留守在爷爷家。爷爷背着奶奶悄悄塞给我的零花钱,那时候不多久就一元,但是在那个年代都可以买很多东西了。...
    莎范儿阅读 122评论 0 0
  • Horizontal Vertical
    puppyb2m阅读 1,756评论 0 2
  • 冲出匍匐的路 以山的姿态站立起来 告别昔日的呻吟 奋起生命的另一种形态 一路激情一路豪歌 奔向山外的世界
    泛黄鸾笺阅读 161评论 0 1