如何质押Token¶
概览¶
获得最高质押量的候选收集人(区块生产者)可加入有效收集人池,入选后将负责为中继链提供区块。
Token持有者可以向候选人质押自己的Token,这一过程称为委托(也称为质押)。通过这种方式,Token持有者为特定候选人进行担保,而他们的委托行为则被视为对收集人的信任。进行委托时,Token会被立即扣除,并添加到用户质押的总金额中。退出流程现被分为两个动作:计划(scheduling)和执行(execution)。首先,Token持有者需要发送请求(即计划)以进行退出流程,等待退出生效期或解绑期(视网络情况而定)。在解绑期之后,用户可以执行他们的计划(scheduling)行动。
候选人加入到收集人有效集后,他们就有资格生产区块并获得部分区块奖励(Token通胀模型的一部分)。考虑到委托人对收集人在网络中质押的贡献比例,收集人与委托人共享质押奖励。
本教程将向您展示如何通过Polkadot.js Apps在Moonbase Alpha上质押。此教程同样适用于Moonbeam和Moonriver。如果希望简单质押Token,持有者可以使用Moonbeam dApp来进行操作。
有关质押的更多基本信息,请查看Moonbeam质押概述。
Extrinsic定义¶
质押pallet有很多Extrinsic,本教程无法逐一进行介绍。但以下列表已经囊括与委托流程相关的Extrinsic。在runtime升级到1001之后,一些Extrinsic已经弃用。
注意事项
随着质押pallet不断升级,Extrinsic将来可能发生变化。
加入或离开委托人集¶
- delegate(address candidate, uint256 amount, uint256 candidateDelegationCount, uint256 delegatorDelegationCount) —— 委托收集人。数额需要大于最低委托质押量。取代已弃用的
nominate
函数 - scheduleLeaveDelegators() —— 计划离开委托人集。在您通
executeLeaveDelegators
函数执行请求前,需经过一个退出延迟,随后才能执行请求。取代已弃用的leaveNominators
函数 - executeLeaveDelegators(uint256 delegatorDelegationCount) —— 执行离开委托人集。该函数仅用于已在计划之内的离开行为,且退出已生效之后。最终,所有正在进行的委托将被撤销
- cancelLeaveDelegators() —— 取消已在离开计划的委托人集的请求
以下外部函数已弃用:
- nominate(address collator, uint256 amount, uint256 collatorNominationCount, uint256 nominatorNominationCount) —— 委托收集人的函数。数额需要大于最低委托质押量
- leaveNominators(uint256 nominatorNominationCount) —— 离开委托人集的函数。最终,所有正在进行的委托将被撤销
绑定更多Token或减少绑定Token¶
- delegatorBondMore(address candidate, uint256 more) —— 向已经委托的收集人增加质押Token数量的请求。取代已弃用的
nominatorBondMore
函数 - scheduleDelegatorBondLess(address candidate, uint256 less) —— 对已经委托的收集人减少质押Token数量的请求。该数额不得使您的总质押量低于最低委托质押量。在您通过
executeCandidateBondRequest
执行请求前,需经过一个退出延迟,随后才能执行请求。取代已弃用的nominatorBondLess
函数 - executeCandidateBondRequest(address candidate) —— 对一个特定候选人减少绑定的执行行为。该函数仅用于已计划的绑定请求,且退出已生效之后
- cancelCandidateBondLess() —— 取消已计划的对特定候选人增加或者减少绑定的请求
以下外部函数已弃用:
- nominatorBondLess(address collator, uint256 less) —— 对已委托的收集人减少质押Token数量。该数额不得使您的总质押量低于最低委托质押量
- nominatorBondMore(address collator, uint256 more) —— 对已委托的收集人增加质押Token数量
撤销委托¶
- scheduleRevokeDelegation(address collator) —— 计划完全撤销现有的委托。在您通过
executeDelegationRequest
执行请求前,需经过一个退出延迟,随后才能执行请求。取代已弃用的revokeNomination
函数 - executeDelegationRequest(address delegator, address candidate) —— 执行和已处于待办委托的请求。该函数仅用于已计划的撤销请求,且退出已生效之后
- cancelDelegationRequest(address candidate) —— 取消已计划的请求以撤销委托的请求
以下外部函数已弃用:
- revokeNomination(address collator) —— 移除现有的委托
获取质押参数¶
您现在可以阅读关于质押的所有参数,如列在一般定义的参数和来自Polkadot.js Apps的参数。
导向至Polkadot.js Apps的Chain State界面,本教程会连接至Moonbase Alpha,但也可以链接至Moonbeam或是Moonriver。
接着,执行以下步骤检索各种质押参数:
-
在Chain State界面选取Constants标签
-
在selected constant query的下拉选单中选取parachainStaking
-
选取任何您希望获取数据的函数。举例而言,您可以使用maxCollatorsPerNominator,这将会返回您可委托的最大收集人数
-
点击+以获取当前数据
您应当可以看到单个委托人可委托的最大收集人数,也可以在Moonbeam质押概述中查询。
如何通过Polkadot.js Apps进行质押¶
该部分将展示委托候选收集人的整个步骤。
本教程将使用 Moonbase Alpha 上的以下候选者作为参考:
变量 | 地址 |
---|---|
候选人1 | 0x4c5A56ed5A4FF7B09aA86560AfD7d383F4831Cce |
候选人2 | 0x623c9E50647a049F92090fe55e22cC0509872FB6 |
在通过Polkadot.js Apps进行质押前,请确保您已获取一些重要参数。
获取收集人名单¶
在开始质押Token前,从网络中获取候选收集人名单至关重要。您可以执行以下步骤进行查看:
-
进入Developer标签
-
点击Chain State
-
选择进行交互的pallet。在本示例中为parachainStaking pallet
-
选择查询状态。在本示例中为selectedCandidates或candidatePool状态
-
点击+按钮发送状态查询
以下每个外部函数都会返回不同结果:
- selectedCandidates —— 返回目前的收集人有效集,也就是总Token质押量前80名的收集人(委托人的质押量也包括在内)。例如,在Moonbase Alpha上是当前的前80名收集人
- candidatePool —— 返回目前所有收集人的名单,包括不在有效集的收集人
获取收集人的委托数量¶
首先,您需要获取 candidateInfo
,其中将包含委托人数量,因为您需要在以后的交易中提交此参数。要检索参数,请确保您仍在 Developer 页面的 Chain State 选项卡上,然后执行以下步骤:
- 选择 parachainStaking 托盘进行交互
- 选择candidateInfo状态查询
- 确保 include option 滑块已启用
- 输入收集人候选人的地址
- 点击 + 按钮发送状态查询
- 复制发起委托时需要的结果
获取目前委托数据¶
如果您从来没有从这个账户进行委托,您可以跳过这步。但是如果您不确定您目前有多少个委托,您可以从Polkadot.js运行以下的Javascript代码段来获取delegationCount
:
// Simple script to get your number of existing delegations.
// Remember to replace YOUR_ADDRESS_HERE with your delegator address.
const yourDelegatorAccount = 'YOUR_ADDRESS_HERE';
const delegatorInfo = await api.query.parachainStaking.delegatorState(yourDelegatorAccount);
console.log(delegatorInfo.toHuman()["delegations"].length);
-
打开Developer标签
-
点击JavaScript
-
复制上面的代码段粘贴至代码编辑框内
-
(可选)点击存储图标并为代码段设置一个文件名,比如Get existing delegations。这样即可本地存储代码
-
点击执行按钮。这会使代码在编辑器里运行
-
复制运行结果,在您发起委托时需要用到
质押Token¶
使用Polkadot.js Apps交互界面进入质押功能。在此之前需要导入/创建以太坊式账户(H160地址),具体操作方式请见创建或引入H160账户教程。
在本示例中,我们导入了一个账户,并命名为:Alice。Alice的地址为 0xf24FF3a9CF04c71Dbc94D0b566f7A27B94566cac
。
目前,所有与质押相关的功能都需要通过Developer标签下的Extrinsics菜单进入:
委托收集人,需要提供以下信息:
- 选择希望质押Token的账户
- 选择parachainStaking pallet
- 选择delegate外部函数
- 设置您要委托的收集人地址。在本示例中为
0x4c5A56ed5A4FF7B09aA86560AfD7d383F4831Cce
- 设置您要质押的Token数量
- 输入您 之前从查询
candidateInfo
中检索到的candidateDelegationCount
- 输入
delegationCount
您从 JavaScript 控制台检索到的。如果您尚未委派候选人,则为0
- 点击Submit Transaction按钮,并签名确认交易
注意事项
第6步和第7步中用到的参数是为了估算Gas,所以不必和实际数据一致。但是,他们不应低于实际数值。
确认委托¶
交易确认后,您可以在Developer标签下的Chain state中查看委托是否成功。
随后,需要提供以下信息:
- 选择需要进行交互的pallet。在本示例中为parachainStaking pallet
- 选择状态以查询。在本示例中为delegatorState
- 验证所选地址是否正确。在本示例中为Alice的账户
- 确保include option滑块处于打开状态
- 点击 +按钮发送状态查询
在返回结果中可以看到,账户中(在本示例中为Alice的账户)有一个委托列表,每个委托都包含了候选收集人的目标地址及质押数量。
您也可以通过以上同样的步骤委托其他的候选收集人。例如,Alice也委托了0x623c9E50647a049F92090fe55e22cC0509872FB6
。
如何停止委托¶
在runtime升级(runtime version 1001)中,用户与质押功能的交互方式进行了重大升级,其中包含取消质押的方式。
如果您希望退出或者停止一个委托,首先您需要计划(schedule),等待退出生效期,再执行(execute)该退出。如果您已经是委托人,您有两个方式来请求停止委托:通过scheduleRevokeDelegation
参数,请求从一个特定的收集人处解除质押Token;或是通过scheduleLeaveDelegators
参数,请求撤销所有正在进行的委托。计划请求不会自动撤销您的委托,需等待退出生效期之后,再通过executeDelegationRequest
方式或executeLeaveDelegators
方式执行该请求。发起退出请求后并不会自动执行,需要等待退出延迟,然后通过executeDelegationRequest
或executeLeaveDelegators
函数执行请求。
计划停止委托的请求¶
本小节继续沿用上面的示例,并假设您现在有至少两个有效委托。
在Developer标签下的Extrinsics菜单中,您可以移除对某一收集人的委托。随后,请执行以下步骤:
- 选择您希望移除委托的账户
- 选择
parachainStaking
pallet - 选择
scheduleRevokeDelegation
函数 - 设置您希望移除委托的收集人地址。在本示例中为
0x623c9E50647a049F92090fe55e22cC0509872FB6
- 点击Submit Transaction按钮,并签名确认交易
注意事项
每个候选人只能计划一个请求。
如上所述,您也可以通过scheduleLeaveDelegators
外部函数Extrinsics ,继续移除所有正在进行中的委托(下图所示第3步)。这一参数无输入值。
计划该请求后,需要等待退出延迟之后,再执行该请求。如果您试图在退出生效期之前执行,将会导致该参数失败,并且您将会在Polkadot.js Apps的parachainStaking.PendingDelegationRequest
看到错误。
执行停止委托的请求¶
在发起计划请求,并已经通过退出生效期后,您可以返回Developer标签下Extrinsics菜单并执行以下步骤:
- 选择执行停止委托的账户
- 选择parachainStaking pallet
- 选择executeDelegationRequest函数
- 设置您希望移除委托的委托人地址。在本示例中为Alice的地址
0xf24FF3a9CF04c71Dbc94D0b566f7A27B94566cac
- 设置您希望移除委托的收集人地址。在本示例中为
0x623c9E50647a049F92090fe55e22cC0509872FB6
- 点击Submit Transaction按钮,并签名确认交易
如果您希望移除所有正在进行的委托,您可以调用executeLeaveDelegators
函数Extrinsics (如下图所示):
- 选择移除所有委托的账户
- 选择parachainStaking pallet
- 选择executeLeaveDelegators函数
- 输入您从JavaScript命令窗口获取的
delegationCount
函数撤销全部委托;如果您从没用这个账户委托过,这里应设置为0
- 点击Submit Transaction按钮,并签名确认交易
交易确认后,您可以在Developer标签下的Chain state中验证委托是否被成功移除。随后,执行以下步骤:
-
选择parachainStaking pallet
-
选择delegatorState查询
-
选择您的账户
-
确保include option滑块处于打开状态
-
点击+按钮发送状态查询
在返回结果中可以看到,账户中(在本示例中为Alice的账户)有一个保留委托列表,每个委托都包含了候选收集人的目标地址及质押数量。 0x623c9E50647a049F92090fe55e22cC0509872FB6
不再出现。或者如果您已经离开了委托人集,您应该看到返回结果显示为<none>
。
为确保撤销按预期执行,您可以按照上面验证委托部分中的步骤进行操作。
取消停止委托的请求¶
如果您计划了停止委托的请求,只要请求还未被执行,您仍然可以在任何时候取消,并且您所有的委托仍然保持原样。如果您通过scheduleRevokeDelegation
计划请求,您需要调用cancelDelegationRequest
。另一方面,如果您通过scheduleRevokeDelegation
计划请求,您需要调用cancelLeaveDelegators
。请执行以下步骤取消请求:
-
选择取消已计划请求的账户
-
选择parachainStaking pallet
-
选择cancelDelegationRequest或cancelLeaveDelegators函数
-
输入您希望取消请求相对应的收集人地址
-
点击Submit Transaction按钮,并签名确认交易
质押奖励¶
收集人有效集的候选人通过生产区块获得奖励,委托人也会获得奖励。您可以在Moonbeam质押概述的奖励分配页面大致了解奖励的计算方式。
总而言之,收集人获得奖励后(奖励包括收集人本身的权益),将根据占该收集人所有委托人总权益的比例对各个委托人进行奖励分成。
从上述示例可以看到,在经过两轮后,Alice获得了0.0044
Token作为奖励:
风险提示¶
MOVR/GLMR持有者在委托之前应提前做好收集人相关研究。列表上的收集人并不代表通过Moonbeam Network、Moonriver Network或Moonbeam Foundation的认可或推荐。 Moonbeam Network、Moonriver Network和Moonbeam Foundation均未审查列表上的收集人,且对任何第三方产品的选择、性能、安全性、准确性或使用概不承担任何责任。您有责任自行了解所需费用和存在的所有风险,包括积极跟踪收集人活动。
您同意并理解,Moonbeam Network、Moonriver Network和Moonbeam Foundation均不保证您将能获得的质押奖励,并且所提供的百分比 (i) 为估计值,仅供参考,(ii) 可能随时更改,并且 (iii) 可能多于或少于您获得的实际质押奖励。 Moonbeam Foundation在任何时候对任何奖励的货币价值不作任何陈述。
质押MOVR/GLMR并非毫无风险,请谨慎操作。 质押的MOVR/GLMR代币将被锁定,取回它们需要2天/7天等待期。 此外,如果收集人未能执行所需的功能或存在恶意行为,则其总质押量的一部分可能会被削减(即销毁)。其中包括他们委托人的质押量。如果发现收集人行为可疑或经常离线,委托人可以选择解除绑定或选择另一个收集人质押。委托人还可以通过将其质押量分配给多个收集人来降低风险。