质押概述

​

关键概念

​

纪元(Epoch)和时序

• 纪元 n+1 —— 如果在边界区块之前提交
• 纪元 n+2 —— 如果在边界区块之后提交(在纪元延迟期内)

(uint64 epoch, bool inEpochDelayPeriod) = IMonadStaking(STAKING_ADDRESS).getEpoch();
// If inEpochDelayPeriod is false: changes take effect in epoch + 1
// If inEpochDelayPeriod is true:  changes take effect in epoch + 2

​

提现延迟

​

常见操作

​

委托(Delegate)

IMonadStaking(STAKING_ADDRESS).delegate{value: amount}(validatorId);

• msg.value 必须至少为 DUST_THRESHOLD(1 gwei)。
• 您的委托将在下一个纪元(或再下一个纪元,如果已过边界区块)生效。
• 如果这使得验证者的总质押达到 ACTIVE_VALIDATOR_STAKE,则该验证者将被加入活跃集合。

​

解除委托和提现

IMonadStaking(STAKING_ADDRESS).undelegate(validatorId, amount, withdrawId);

IMonadStaking(STAKING_ADDRESS).withdraw(validatorId, withdrawId);

质押可提现性相对于 undelegate 的时间线

• 您只能解除委托 活跃 状态的质押(不包括待生效的委托)。
• 每个 (validator, delegator) 对最多支持 256 个并发提现请求。
• withdrawId 可以在提现完成后重复使用。

​

领取和复投奖励

• 领取奖励 —— 将累积奖励提取到您的账户:
  IMonadStaking(STAKING_ADDRESS).claimRewards(validatorId);
  
  领取 立即 生效 —— 无纪元延迟。
• 复投奖励 —— 将累积奖励重新委托,增加您的质押:
  IMonadStaking(STAKING_ADDRESS).compound(validatorId);
  
  复投的奖励将在下一个纪元激活(遵循标准的时序规则)。

​

查询质押状态

​

约束

• 只允许 CALL。 STATICCALL、DELEGATECALL 和 CALLCODE 会回滚。这意味着所有视图方法使用 nonpayable 状态可变性,而不是 view。
• 无 fork 环境测试。 质押系统是预编译合约,而非智能合约 —— 该地址上没有代码,所以 fork 测试环境无法工作。
• 边界区块时序。 在纪元延迟期内(边界区块之后)提交的操作,要到两个纪元之后才生效。如果时序很重要,请检查 getEpoch()。
• 粉尘阈值。 低于 DUST_THRESHOLD(1 gwei)的委托将回滚。
• EIP-7702 注意事项。 如果某账户使用 EIP-7702 将其委托设置为质押预编译合约地址,则对其发起的所有调用都会回滚。

​

延伸阅读

• API 参考 —— 质押预编译合约的完整参考,包含方法签名、参数、gas 成本、事件、结构体和 ABI
• 质押如何工作 —— Monad 质押系统如何确定验证者投票权重、纪元调度和奖励分配