开仓与平仓
使用 v24 保护条件开仓、部分平仓、领取结算及调整抵押。
开仓前
使用部署对应的 v24 Router,以及匹配 Lens Set 的最新报价。核对方向、抵押资产、杠杆、模式、预言机价格区间、协议费和你授权的仓位清算奖励责任保证金上限。开仓准入检查当前及压力情景池级风险,以及操作后仓位保证金。
Separate 模式开立新仓位。Full 模式明确选择新建仓位桶,或要求精确匹配现有合并目标及 bucket key。合并目标变化时,不得默默改为另一个目标。
从请求到仓位
只有全部准入检查通过后才会开仓;任一检查失败都会使请求回退。
全部或部分平仓
closeAllV24 关闭整个仓位。closePartialV24 的 requestedBps 范围为 1 至 9,999。只有 allowFullClosePromotion 允许时,dust 规则才能将部分请求提升为全平,否则交易回退。检查结果的 effectiveBps 和 promotedToFull。
平仓使用有效预言机价格移除敞口,并结算实际从池中移除的带符号质量:
- 正质量:风险检查允许即时结算时,扣费后换算为抵押资产。
- 负质量:产生债务,先使用授权债务覆盖,再使用安全储备,剩余记为未覆盖损失。
- 延期退出:即时正值结算会使剩余质量不足时,
allowDeferredExit可允许转换为延期质量权益而非现金。minDeferredMass保护该权益,但不保证未来何时可以领取或领取多少抵押资产。
minOwnerPayout 保护普通抵押付款分支,不能代替延期分支的 minDeferredMass。如果你要求现金结算,就不要授权延期退出。
平仓后得到什么
下图表示普通结算分支,不保证付款成功。每条分支仍受阶段、预言机、费用及用户保护约束。图中省略零质量结算;Recovery 使用独立路径。
延期权益没有固定付款日期或抵押金额。minDeferredMass 保护质量权益,minOwnerPayout 保护普通付款。仓位清算奖励责任保证金与图中结算所得分账。
直接付款与结算托管
普通直接付款使用 payoutMode = DIRECT,要求非零接收地址。ESCROW 要求 receiver 字段为零:合约将所有者结算余额预留,稍后通过 claimSettlement 或 claimSettlementAll 领取。领取请求另有金额、接收者、期限和状态保护。
保证金账户款项必须经过账户支持的托管路径。托管金额只有领取到账户后,才成为可用抵押余额。延期仓位权益是另一种质量权益,不是结算托管。
执行保护
使用最新记账及对应操作要求的其他摘要、期限、价格区间和 maxProtocolFee。明确设置 maxDebt、maxDebtorCoverage、maxSafetyUsed 和 maxUncoveredDebt。这些上限用于拒绝不可接受的结果,零不表示无限制。价格区间直接比较:maxPrice 为零不会关闭价格上限。
maxTerminalFundingDust 限制终止仓位时资金费余数的原始抵押单位等价值,同时受更严格的协议配置上限约束。报价过期、价格变化或 allowance 不足仍可能导致交易回退。
追加抵押与降低杠杆
addPositionCollateralV24 为现有仓位增加抵押,可设置最少新增份额及费用、状态保护,不会提款。reduceLeverageV24 减少一部分敞口,把对应结算所得留在仓位中,并支持 minCollateralKept 保护,不向钱包付款。
两者仍受阶段、预言机、授权和风险检查约束。向保证金账户存入可用抵押资产,与将其分配给仓位是不同操作。
市场限制
Reduce-only 禁止新开仓。EmergencyPause 期间,原生普通平仓路径只允许在其他检查通过后全平到托管;普通部分平仓不能利用 dust 提升绕过暂停。Recovery 使用专门修复及结算路径,不使用普通开平仓。
仓位清算奖励责任保证金与交易抵押分账托管。健康、正值、非延期的自愿全平会退还该保证金;负值、零值或延期终止不承诺相同退款。参见清算。