XEN 合约代码深入解读

xyyme.eth热度: 29544

这个玩法有意思的地方在于越早参与获得的奖励越多,相当于普通的挖头矿,但是同时也取决于总体的参与人数,如果后面没有人参与,那么也没啥意义。必须是参与的早且后面还有更多人参与的情况下,奖励才会更多。

原文作者:xyyme.eth

原文来源:mirror

这两天 XEN 特别火,看了看代码,相对比较简单。这篇文章就来结合文档来解读一下合约代码,仅做学习交流用。对于玩法还不熟悉的朋友可以先看看我昨天发的推文

整个玩法分成两部分,我这里将其区别为:

  1. 时间挖矿(claim to mint),也就是在参与时指定时间,时间到期后即可领取对应的 XEN,唯一付出的成本就是 gas 费用和等待的时间
  2. stake 挖矿,通过质押 XEN 来挖矿

时间挖矿

先来看第一部分,时间挖矿。用户通过调用 claimRank(uint256 term) 来参与,term 代表用户想要挖矿的天数,在这个时间到期之后才能领取 XEN 奖励。

XEN

其中全局变量 globalRank 代表的是全局参与的总人数,只增不减。activeMinters 代表正在参与挖矿的人数,当用户参与时间挖矿时增加 1,到期领取奖励后减少 1userMints 代表用户的挖矿参数。我们看到,这里最短需要参与一天,最多参与的天数是通过 _calculateMaxTerm() 实时计算出来的。

XEN

首先如果全部参与人数没有超过 5000,那么最多只能挖 100 天。如果达到了 5000,通过对参与人数进行对数运算,计算出对应的最大天数。对应于文档中的:

XEN最大参与时间计算公式

代码中的 fromUInt() 和 log_2() 都来自于 ABDKMath64x64 库(代码)。其中 fromUInt() 的代码:

XEN

入参 x 有限制,这个最大值转换为 10 进制是 9223372036854775807,全部参与人数不可能超过这个数,所有可以安全使用。

在构造的挖矿系数 mintInfo 中,_calculateRewardAmplifier() 和 _calculateEAARate() 也是实时计算的。

XEN

可以看到,越早参与,可以获得到的 AMP 就越多,最开始一天是 3000,每过一天会减少 1,最终超过 3000 天就会恒定为 1。

对应于文档中 AMP 的计算方式:

XENAMP 计算公式

XEN

从 100 开始,每当有 十万人 参与时,下降 1,最终若达到 一千万人 参与,则恒定为 0。同样也是越早参与越好。对应于文档:

XENEAA 计算公式

由于 Solidity 中没有小数,因此在代码中将其放大了 1000 倍,后面在 getGrossReward 方法中会再缩小 1000 倍。

到这里,我们可以看到,在用户参与时间挖矿时,已经确定的数据有

  1. 用户在全局中的位置(rank)
  2. 参与时长(term),由用户在参与时指定
  3. AMP,越早参与越大
  4. EAA,越早参与越大

接下来我们来看用户领取奖励时的方法 claimMintReward():

XEN

校验限制后,计算可得奖励数量,然后 _mint 给用户,计算奖励数量的主要计算逻辑在 _calculateMintReward() 中:

XEN

这里我们先忽略 penalty 这一块,其他部分的计算正好对应于文档中的:

XEN时间挖矿奖励数量计算公式

在计算最终奖励数量的时候,自己参与的位置越靠前,后面的人越多,那么

cRG - cRu

就会越大,同样说明越早参与越好。

我们再来看 penalty 这部分,这块其实就是系统限制用户必须在到期后一定时间内领取走,如果没有领取则会随着时间越来越少,最终归零。

XEN

对应于文档中的扣除比例:

XEN扣除比例时间关系

文档中显示超过七天就全部不能领取,但是代码中显示最多只会扣除 99%。

到这里,我们就介绍完了时间挖矿的代码部分,接下来我们来看看 stake 挖矿的部分。

stake 挖矿

这里的 stake 其实比常见的挖矿计算逻辑要简单。常见的挖矿 APY 是根据用户质押数量占比以及参与时间来计算的,属于随挖随走类型的。而这里的 stake 挖矿的 APY 在参与时就已经固定了,且需要在参与时就指定参与时间,在时间到期后才能领取奖励,如果没有到期就领取,只能取回本金,没有任何的奖励。

用户可以在前面时间挖矿到期时调用 claimMintRewardAndStake 同时领取奖励并进行 stake,或者单独调用 stake(uint256 amount, uint256 term) 进行 stake 挖矿:

XEN

整体的逻辑也比较简单,参与的时候需要指定时间 term。有一个小细节是在 stake 的时候直接 burn 掉了用户的 token,而不是通过转账的方法,这样可以少一步授权操作。由于合约本身既包含了挖矿操作,同时也是 ERC20,因此可以实现这个逻辑。

接下来我们看看计算 APY 的方法 _calculateAPY():

XEN

基本逻辑也是类似于上面计算 EAA 的方法,一次函数递减,参与的时间越早,相对应的 APY 就越大。初始值为 20,每过 90 天,减少 1。最终在 1620 天后,恒定为 2。对应于文档:

XENAPY 时间关系

最终在 stake 到期后,可以调用 withdraw() 取出本金和奖励:

XEN

其中计算奖励数量的方法 _calculateStakeReward()

XEN

对应于文档中的:

XENstake 奖励计算公式

对于 stake 挖矿而言,没有领取的限制,奖励数量不会变化。

总结

到这里我们就看完了主要的逻辑代码。这个玩法有意思的地方在于越早参与获得的奖励越多,相当于普通的挖头矿,但是同时也取决于总体的参与人数,如果后面没有人参与,那么也没啥意义。必须是参与的早且后面还有更多人参与的情况下,奖励才会更多。目前时刻总参与人数已经快达到 50 万了,热度确实很高。

同时,前面的时间挖矿和后面的 stake 挖矿也存在博弈关系,如果前面选择的时间越长,获得的奖励就越多,但是来到后面的 stake 挖矿的 APY 就会降低,需要大家自行抉择。

合约本身代码没啥难度,但是整体机制比较有趣,值得花点时间了解。

责任编辑:MK

声明:本文为入驻“MarsBit 专栏”作者作品,不代表MarsBit官方立场。
转载请联系网页底部:内容合作栏目,邮件进行授权。授权后转载时请注明出处、作者和本文链接。未经许可擅自转载本站文章,将追究相关法律责任,侵权必究。
提示:投资有风险,入市须谨慎,本资讯不作为投资理财建议。
免责声明:本文不构成投资建议,用户应考虑本文中的任何意见、观点或结论是否符合其特定状况,及遵守所在国家和地区的相关法律法规。