从零搭建AMA Protocol质押服务:vault APY预算与收益复利机制
从零搭建AMA Protocol质押服务vault APY预算与收益复利机制【免费下载链接】node项目地址: https://gitcode.com/GitHub_Trending/node95/nodeAMA Protocol项目代号 Amadeus是一个基于 500ms 出块的 L1 公链节点项目其内置的LockupVault 质押服务允许用户把 AMA 代币锁进 vault按档位获取固定 APY并默认开启收益复利。本教程面向新手带你从零理解 vault 的APY 预算从哪来、复利机制如何工作以及如何一步步搭建属于自己的质押服务。全程只需一个节点仓库git clone https://gitcode.com/GitHub_Trending/node95/node1. 质押服务核心概念vault 是什么vault金库是链上合约LockupVault管理的一笔锁定资产每个 vault 包含这些字段实现见ex/native/rdb/src/consensus/bic/lockup_vault.rs字段含义tier档位og/3m/6m/12mamount本金单位1e-9 AMAaccrued已复利累计的收益rate_bps创建时锁定的 APY 基点mature_epoch锁仓到期 epochpayout_address收益收款地址不填 复利validator背后委托的验证人最低质押门槛是1000 AMA合约在API.Vaultex/lib/api/api_vault.ex中暴露了完整的调用入口。2. vault APY 是怎么算的4 档利率对照表 APY 在创建 vault 那一刻就被锁定之后不再变动。核心参数tier_params()定义了 4 档基础利率档位锁仓时长基础 APY备注og可自定义月数0%适合纯托管/做验证人委托3m3 个月5%短期灵活6m6 个月10%中期平衡12m12 个月15%早期可额外 5%早鸟加成在BONUS_END_EPOCH第 1150 epoch之前创建的 12 个月 vault还能额外叠加BONUS_RATE_BPS 500基点即20% 年化错过不再有。链上时间换算出块 500ms → 每天 172,800 个块 → 每个 epoch 固定 100,000 个块约 13.9 小时→ 一年约 630.72 个 epoch。因此每个 epoch 的利息公式为每 epoch 收益 (本金 已累计收益) × rate_bps ÷ 6,307,200其中APY_EPOCH_DENOM 6,307,200就是把 10,000 基点 × 630.72 个 epoch 换算成「单 epoch 利率」。3. 收益复利机制复投还是提现这是质押服务最核心的设计——收益流向由payout_address一个字段决定✅不填payout_address每个 epoch 的收益自动累加进accrued下一 epoch 连本带利一起计息即复利。链上报告的记录类型为interest_compounded。✅填写payout_address收益直接发放到该地址记录类型为interest适合想每月提现吃利息的用户。复利是「复利」还是「单利」取决于你创建 vault 时是否设置收款地址之后随时可用set_payout_address/clear_payout_address切换但解锁期内不允许修改。4. APY 预算从哪来每 epoch 的排放分配 vault APY 的预算不是凭空印的它来自每 epoch 的链上排放逻辑集中在ex/native/rdb/src/consensus/bic/epoch.rs的next()每 epoch 排放总量由曲线决定早期几何衰减第 750 epoch 起切换为1,430,936,428 / (epoch72)^1.3激活时约 23.2 万 AMA排放对半分一半给 vault APY一半给求解器solver挖矿vault 预算 本 epoch 的一半 上期未花完的池子余额vault_accrued_pool结转若本期应付利息超过预算则按比例pro rata 缩减发放绝不超发未发放的余额继续滚入下期预算池 —— 这就是 APY 预算能长期稳定的原因。另外还有25% 网络税NETWORK_TAX_BPS 2500直接从 vault 剩余预算中扣除上缴国库因此总发行量始终被曲线锁死不会额外增发。5. 参与度PFLOPS如何影响实际 APY 别高兴太早——名义 APY 会受网络参与度调节。系统按全网算力估算pflops参与度 ≥ 100 PFLOPS全额发放参与度不足按比例打折发放短款滚入预算池从第 758 epoch 起有10% 参与度下限网络再冷清也至少发放 10%从第 1150 epoch 起vault APY 也要按参与度打折不再全额兜底。一句话总结早期 12m vault20% 复利 网络活跃 收益最大化窗口。6. 从零搭建质押服务7 个操作步骤 ️质押服务是链上合约能力你只需一个节点钱包即可调用。常用操作如下调用示例见ex/lib/api/api_vault.ex步骤 1创建 vault指定档位与验证人API.Vault.create(sk, 1000, 12m, validator: validator_pk, # 可稍后再设 payout_address: nil) # nil 收益复利最低 1000 AMA创建时若指定了验证人会进入2 epoch 的待生效队列。步骤 2设置收益复利默认即复利不填payout_address即可也可随时set_payout_address(sk, index, pk)改为提现模式。步骤 3指定验证人set_validator(sk, index, validator_pk)委托给验证人后vault 才能参与分红验证人变更同样有 2 epoch 队列缓冲。步骤 4设置验证人佣金作为验证人可用set_commission(sk, bps)设置 0~10000 基点佣金0~100%。降佣立即生效涨佣需排队 3 epoch防止恶意操纵见call_set_commission。步骤 5到期解锁到期后调用unlock(sk, index)进入21 天解锁期UNLOCK_PERIOD_EPOCHS期满后本金复利自动退回账户。步骤 6延长锁仓extend_lock(sk, index, months)可把到期日往后推继续享受原利率。步骤 7查询收益调用API.Vault.by_owner(pk)查看名下所有 vault 的amount、accrued、rate_bps状态。7. 验证人机制质押 100 万 AMA 进入验证人集 ⚖️vault 不只是生息工具也是验证人选举的基础每个 epoch 结束系统统计所有 vault 的amount accrued作为投票权重累计委托 ≥100 万 AMA的验证人自动进入下一轮验证人集验证人集 所有 ≥100 万质押的验证人 求解量前 33 名求解器验证人可在每个 payout 中抽取佣金佣金路由到其emission_address若设置。因此质押服务天然是「PoS 委托 收益复利」二合一你的复利本金同时也在为验证人累积投票权。8. 用 CSV 报表核对每一笔收益 节点会为每个 epoch 生成对账报表路径为WORKFOLDER/epoch_payouts/epoch.csv默认~/.cache/amadeusd。每行一条记录地址,类型,flat金额,AMA金额类型含义interestAPY 发放到 payout 地址扣佣后净额interest_compounded复利滚入 vault 的收益commission验证人抽走的佣金tax25% 网络税emission求解器挖矿排放实现见ex/native/rdb/src/consensus/bic/epoch_report.rs文件采用「临时文件 rename」原子写入重放或重组都能收敛到一致内容方便你审计自己的质押服务收益。9. 常见问题 FAQ Q12m vault 现在还送 5% 加成吗A只有第 1150 epoch 之前创建才送之后恢复 15% 基础利率。Q解锁期内还能改 payout 地址吗A不能set_payout_address/clear_payout_address/change_owner在解锁期都会被拒绝。Q验证人佣金能随时改吗A降佣立即生效涨佣需要排队 3 个 epoch 后才生效。Q预算不足时会拖欠我的收益吗A不会拖欠——当期按比例发放剩余金额滚入池子下期预算补齐后继续支付且发放永远不超过排放曲线。总结质押服务收益最大化三要素 选对档位12m 早鸟加成 20% 名义 APY是当前最高档保持复利不设payout_address让accrued滚雪球本金每 epoch 增长看好网络参与度低于 100 PFLOPS 时收益打折关注链上算力再决定入场时机。从克隆https://gitcode.com/GitHub_Trending/node95/node开始对照lockup_vault.rs与api_vault.ex的源码你就能完整掌握 AMA Protocol 质押服务的 APY 预算与收益复利机制并搭建属于自己的质押与验证人服务。【免费下载链接】node项目地址: https://gitcode.com/GitHub_Trending/node95/node创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考