价格市场流动性
了解 Pool v24 流动性 lot、Funding、费用分成和受保护的退出。
本页描述 Pool v24,即当前已提交的协议基线。较旧的 v22 和 v23 部署使用不同的 lot、费用分成和退出机制。操作前请确认当前池版本。
流动性 lot
每次调用 addLiquidity 都会为接收方创建一个新的流动性 lot。池内首次存款按抵押品一比一铸造本金份额,后续存款按当前 effectiveMass / activeBacking 比率铸造份额。请求携带 minSharesOut、expectedCheckpointDigest 和 deadline,过期报价无法静默执行。
每个新的 v24 lot 都具有 Funding 资格:其 funding weight 等于本金份额,存款时没有退出该资格的选项。lot 记录:
- 所有者和本金份额
- 存入的本金
- 已累计的 Funding 质量和最近一次结算的 Funding 索引
- 费用分成权重和锁定期到期时间
- lot 是否仍然有效
使用 addLiquidityTo 可以为自己拥有的现有 lot 追加抵押品,而不是创建新 lot。追加按当前比率铸造份额,并携带自己的 minSharesOut、预期的记账摘要与托管摘要,以及 deadline。
Funding 如何累计与领取
市场累计资金费时,交易者支付的 Funding 质量通过池级 Funding 索引记入有资格的 LP 权重。每个 lot 记录自己累计的质量和舍入余数。
Funding 按质量记账,不代表抵押品已经转移。领取时按当前检查点将质量换算为抵押品,并受池的风险状态约束:
claimLpFunding兑现单个 lot 的已累计 Funding,claimLpFundingBatch可在一次调用中领取多个 lot。- 每次领取都携带
minCollateralOut、预期记账摘要、deadline,以及DIRECT或ESCROW的payoutMode。 - 当池在当前时刻无法安全兑现全部累计质量时,领取会被缩减或拒绝。
费用分成
费用分成独立于 Funding,需要主动加入。joinFeeSharing(lotId, shareAmount) 让整个 lot 或精确切片加入,exitFeeSharing(lotId, shareAmount) 在锁定期结束后退出。费用分成权重记录在 lot 内部,不存在单独的 LP 代币。
手续费奖励累计到所有者级别的余额,通过池的 LP fee reserve 直接以抵押品计价。该储备独立于 Funding 记账,也独立于 Safety Reserve。使用 claimLpFeeRewards 领取,请求携带领取数量、minCollateralOut、预期托管摘要、deadline 和 DIRECT 或 ESCROW 支付模式。
加入费用分成会启动锁定期。默认初始锁定为 604800 秒(7 天),由池配置。通过 addLiquidityTo 为费用分成 lot 追加资金会刷新锁定期。锁定期生效期间,该 lot 的 exitFeeSharing 和 removeLiquidity 都会被拒绝。
一个 lot,多类独立权益
存款产生本金份额及 Funding 资格;费用分成另行选择加入。分支表示不同权益,不是代币依次转换。
移除流动性
removeLiquidity 退出整个 lot 或精确的 shareAmount 切片。请求包含:
lotId和shareAmountreceiverpayoutMode:DIRECT立即转移抵押品,ESCROW记入结算托管,供之后领取minCollateralOut,对本笔交易的本金加已兑现 Funding 进行检查expectedCheckpointDigest和deadline
部分退出会保留 lot。被移除切片的已累计 Funding 在池可以安全支付时兑现,未兑现部分继续记录在剩余 lot 上。
全部退出会关闭 lot。退出时无法安全兑现的 Funding 会转换为挂在该 lot ID 上的递延 Funding,之后通过 Funding 领取流程兑现,并受池状态约束。因此全部退出不保证本金和全部已累计 Funding 同时到账。
合约持有的 lot 移除时必须使用 DIRECT 付款到该合约自身,不能选择托管。其他符合条件的所有者选择托管时,款项归所有者。在池状态承压时,退出也可能被风险引擎拒绝。
部分与全部退出的结果
两种退出均须通过锁期、阶段、预言机、风险及最低输出检查。结算所得与保留权益是同次操作的不同结果。
合约持有的 lot 必须将退出所得直接转给持有合约。普通移除拒绝非正总有效质量,不会把本金转换成延期仓位权益。
你的流动性值多少
LP 是交易者的对手方。lot 的可赎回价值不等于你的存款金额:
- 如果交易者整体亏损,池的抵押品基础增长,你的可赎回价值可能高于存款。
- 如果交易者整体盈利,你的可赎回价值可能低于存款,你可能损失本金。
- 总有效质量非正时,普通移除会拒绝执行。Recovery 和风险限制可能阻止本金提取;这条 LP 移除路径不会把本金转换为延期仓位权益。延期 Funding 仍是独立质量权益,其未来抵押价值不固定。
签名前请立即获取退出报价,携带报价摘要和 minCollateralOut,并复查池的阶段和预言机状态。参见技术细节与价格市场风险。