Skip to content

平行链质押Pallet

概览

Moonbeam使用委托权益证明(DPoS)共识,该共识根据收集人在网络中的总质押数额决定哪些收集人有资格生产区块。有关质押的一般信息,例如术语、质押变量等,请参阅质押页面。

DPOS共识系统利用平行链质押pallet,允许Token持有者(委托人)以准确表示他们希望支持的候选人(收集人)以及对收集人的质押量。此项平行链质押pallet的设计使得委托人和候选人(收集人)之间强制共享链上的风险/奖励。

平行链质押pallet的一些功能也可以通过质押预编译获得。预编译使您能够通过以太坊 API执行质押操作。请参阅 质押预编译页面了解更多相关信息。

此教程将概述平行链质押pallet中可用的extrinsics、存储函数、pallet常量getter。

退出生效期

一些质押pallet extrinsics包括退出生效期,在请求执行前您必须等待。需要注意的退出生效期如下:

变量
减少候选人(收集人)绑定量 28轮次(168小时)
减少委托人绑定量 28轮次(168小时)
撤销委托 28轮次(168小时)
离开候选人(收集人)池 28轮次(168小时)
离开委托人池 28轮次168小时)
变量
减少候选人(收集人)绑定量 24轮次(48小时)
减少委托人绑定量 24轮次(48小时)
撤销委托 24轮次 (48小时)
离开候选人(收集人)池 24轮次(48小时)
离开委托人池 24轮次(48小时)
变量
减少候选人(收集人)绑定量 2轮次(4小时)
减少委托人绑定量 2轮次(4小时)
撤销委托 2轮次(4小时)
离开候选人(收集人)池 2轮次(4小时)
离开委托人池 2轮次(4小时)

平行链质押Pallet接口

Extrinsics

平行链质押pallet提供以下extrinsics(函数):

  • cancelCandidateBondLess() - 取消一个待定中的已计划请求,以减少候选人(收集人)自身绑定数量
  • cancelDelegationRequest(candidate) - 取消提供候选人(收集人)的地址的任何待定中委托的请求
  • cancelLeaveCandidates(candidateCount) - 取消一个候选人(收集人)的待定中的已计划的请求,就目前在池中候选人的数量,以离开该池
  • candidateBondMore(more) - 请求增加有具体数量的候选人(收集人)自身绑定量
  • delegate(candidate, amount, candidateDelegationCount, delegationCount) - 从runtime 2400停止使用 - 请求为特定候选人(收集人)添加一定数额的委托。改为通过delegateWithAutoCompound extrinsic实现
  • delegateWithAutoCompound(candidate, amount, autoCompound, candidateDelegationCount, candidateAutoCompoundingDelegationCount, delegationCount) - 委托一个收集人候选人并用amount,一个0-100之间的整数(无小数)设置自动复合奖励百分比。如果调用者不是委托人,则此函数将它们添加到委托人集合中。如果调用者已经是委托人,则调整他们的委托数量。
  • delegatorBondMore(candidate, more) - 请求增加委托人针对特定候选人(收集人)的委托数量
  • enableMarkingOffline(value) - 启用或停止收集人的离线标记(mark offline)功能。必须通过治理 中的Root track来执行
  • executeCandidateBondLess(candidate) - 执行任何已计划的到期请求,以减少候选人(收集人)自身绑定量
  • executeDelegationRequest(delegator, candidate) - 为提供候选人(收集人)的地址的特定委托人执行任何已计划的到期委托请求
  • executeLeaveCandidates(candidate, candidateDelegationCount) - 执行任何已计划的到期请求,以离开候选人(收集人)池
  • goOffline() - 无需解绑,允许收集人暂时离开池
  • goOnline() - 在之前调用goOffline()之后,允许收集人重新加入池
  • joinCandidates(bond, candidateCount) - 请求在特定绑定量并提供现有候选人(收集人)数量的情况下加入收集人池
  • notifyInactiveCollator(collator) - 将一个收集人标记为不活跃。这是根据其是否停止制造区块,并且没有在最大允许离线回合内恢复上线来决定的,最大允许离线回合使用maxOfflineRounds pallet 参数获取
  • scheduleCandidateBondLess(less) - 计划一个请求,以特定数量来减少候选人(收集人)自身绑定。这里有退出生效期,即在您通过executeCandidateBondLess extrinsic执行请求之前必须等待
  • scheduleDelegatorBondLess(candidate, less) - 为委托人针对候选人(收集人)绑定更少的量计划一个请求。这里有退出生效期,即您通过executeDelegationRequest extrinsic执行请求之前必须等待
  • scheduleLeaveCandidates(candidateCount) - 为候选人(收集人)自行从池移出计划一个请求。这里有退出生效期,即您通过executeLeaveCandidates extrinsic执行请求之前必须等待
  • scheduleRevokeDelegation(collator) - 计划一个请求,以撤销一个给定候选人(收集人)地址的委托。这里有退出生效期,即您通过executeDelegationRequest extrinsic执行请求之前必须等待
  • setAutoCompound(candidate, value, candidateAutoCompoundingDelegationCountHint, delegationCountHint) - 给定value,一个0-100之间的整数(无小数),设置现有委托自动复合的奖励百分比
  • setBlocksPerRound(new) - 设定每个轮次的区块。如果new值少于目前轮次的长度,将立即转换下一个区块
  • setCollatorCommission(new) - 设定给所有收集人new值的佣金
  • setInflation(schedule) - 设定年通胀率以导出每轮通胀率
  • setParachainBondAccount(new) - 设定为平行链资金预留的持有资金账户
  • setParachainBondReservePercent(new) - 设定为平行链资金预留的通胀的百分比
  • setStakingExpectations(expectations) - 设定所有质押的期望
  • setTotalSelected(new) - 设定每轮选择的收集人的总数

存储模式

平行链质押pallet包括了以下只读存储模式以获取链状态数据:

  • atStake(u32, AccountId20) - 提供收集人委托质押的快照,以及给定一个整数设置为自动复合的奖励百分比,并且可选,收集人的地址
  • autoCompoundingDelegations(AccountId20) - 返回已设置自动复合的给定候选人的委托人列表以及设置为自动复合的奖励百分比
  • awardedPts(u32, AccountId20) - 给定一轮数量,返回每轮每个收集人的奖励积分,并且可选,收集人的地址
  • bottomDelegations(AccountId20) - 为所有候选人(收集人)或者一个给定候选人(收集人)的地址返回最底部的50个委托
  • candidateInfo(AccountId20) - 为所有候选人(收集人)或者一个给定的候选人(收集人)的地址返回候选人(收集人)信息,如绑定量、委托数量及更多
  • candidatePool() - 返回每一个在池中的候选人(收集人)列表以及他们总支持质押量
  • candidateState(AccountId20) - 运行时1200弃用,现使用candidateInfo代替
  • collatorCommission() - 返回从所有收集人的奖励中扣除的佣金百分比
  • collatorState2(AccountId20) - 运行时1200弃用,现使用candidateInfo代替
  • delayedPayouts(u32) - 返回所有轮次或给定轮次的延迟支付
  • delegationScheduledRequests(AccountId20) - 返回所有收集人或给定收集人地址中未处理的已计划委托请求
  • delegatorState(AccountId20) - 为所有委托人或一个给定委托人地址返回委托人信息,如委托情况、委托状态,以及总委托量
  • enabledMarkingOffline() - 返回一个表明收集者离线标记功能是否开启的布尔值
  • inflationConfig() - 返回通胀配置
  • nominatorState2(AccountId20) - 运行时1200弃用,现使用delegatorState代替
  • palletVersion() - 返回目前pallet版本
  • parachainBondInfo() - 返回平行链储备账户和年通胀的百分比
  • points(u32) - 返回在所有轮次或给定轮次中,给与收集人参与生产区块而获得奖励的总点数
  • round() - 返回目前轮次数,目前轮次的第一个区块,以及轮次的长度
  • selectedCandidates() - 返回被选为目前轮次的活跃集的收集人
  • staked(u32) - 返回所有轮次或给定轮次的在活跃集中的收集人的质押总数
  • topDelegations(AccountId20) - 返回给所有收集人或给定收集人的地址的最高的300个委托
  • total() - 返回在质押pallet中的总锁定资产
  • totalSelected() - 返回可被选做活跃集的收集人的总数

Pallet常量

平行链质押pallet包括了以下只读函数以获取pallet常量:

  • candidateBondLessDelay() - 返回必须等待的轮次数,直到已计划的候选人(收集人)减少其自身绑定的请求可以被执行
  • defaultBlocksPerRound() - 从runtime 1900停止使用 - 返回每个轮次的默认区块数
  • defaultCollatorCommission() - 从runtime 1900停止使用 - 返回收集人的默认佣金
  • defaultParachainBondReservePercent() - 从runtime 1900停止使用 - 返回平行链账户预留的默认通胀百分比
  • delegationBondLessDelay() - 返回必须等待的轮次数,直到已计划的减少委托的请求可以被执行
  • leaveCandidatesDelay() - 在已计划的候选人(收集人)离开池的请求可以被执行之前,返回必须等待的轮次数
  • leaveDelegatorsDelay() - 在已计划的委托人离开委托人集的请求可以被执行之前,返回必须等待的轮次数
  • maxBottomDelegationsPerCandidate() - 返回每个候选人(收集人)最多的排名靠后的委托数
  • maxCandidates() - 返回一个候选人池允许的最大候选人数
  • maxDelegationsPerDelegator() - 返回每个委托人的最大委托数
  • maxOfflineRounds() - 返回在多少个回合之内,一个收集人如果不产出区块,它将被标记为不活跃
  • maxTopDelegationsPerCandidate() - 返回每个候选人(收集人)的最多的排名靠前的委托数
  • minBlocksPerRound() - 返回每个轮次的最低区块数
  • minCandidateStk() - 返回成为候选人(收集人)所需的最低质押
  • minCollatorStk() - 运行时2400弃用 - 返回成为收集人活跃集中所需的最低质押
  • minDelegation() - 返回最低委托数
  • minDelegatorStk() - 运行时2500弃用 - 返回账户成为委托人的最低质押
  • minSelectedCandidates() - 返回每个轮次在活跃集中选出的收集人(收集人)的最低数量
  • revokeDelegationDelay() - 在已计划的撤销委托的请求可以被执行之前,返回必须等待的轮次数
  • rewardPaymentDelay() - 在区块生产者被奖励之后,返回必须等待的轮次数
Last update: January 31, 2024
| Created: July 1, 2021