仓位模式与保证金账户
选择 v24 逐仓或 Cross 风险,并授权账户操作。
仓位模式
| 模式 | 仓位分组 | 风险承担层级 |
|---|---|---|
| Separate | 新建独立仓位 | 单个仓位 |
| Full | 显式保护的同向合并或新建桶 | 单个仓位 |
| CrossSeparate | 保证金账户内的独立仓位 | 账户 |
| CrossFull | 显式保护的账户同向仓位桶 | 账户 |
Full 模式中,NEW_ONLY 要求仓位桶为空;REQUIRE_EXACT_MERGE 要求匹配预期 position ID 和 bucket key。仓位数量、抵押、敞口和杠杆上限来自当前配置,不要沿用 v22 固定仓位桶范围。
保证金账户
PvpMarginAccountV24 是用户自有合约,用于共享一种抵押代币的受支持池。请使用匹配的账户工厂和注册表。Pool、Account、Router、schema 和部署身份必须兼容。
存入抵押资产形成有实际资产支持的可用余额。直接向账户地址转账不是相同的记账操作,syncExcessCollateral 用于核对并计入符合条件的多余余额。通过受支持账户路径开平仓,确保仓位、收益、费用及债务覆盖正确归属。
风险归属与账户权益
仓位分组与风险归属是不同选择。下图箭头表示关系与记账,不表示资金自动跨池转移。
Cross 聚合要求受支持、兼容且使用同一种抵押代币的池,并不合并各池偿付资产。普通健康度判断要求读数完整、托管有资产支持且不存在 Recovery 池。
权益与保证金
账户权益从有资产支持的可用抵押余额开始,再加上各池规范的带符号贡献。保证金要求按风险配置聚合敞口,包含配置的集中度调整。健康度不是独立刷新各仓位显示值后求和。
新增风险和提现要求账户读数完整、托管有资产支持,并满足初始保证金。可正常评估的账户在严格低于维持保证金时可被清算。清算目标使用配置的目标保证金,它高于维持要求且不高于初始要求。
读数不完整、托管缺口和存在 Recovery 池是不同健康状态,不证明普通清算条件成立。专门的降级路径可在自身保护条件下减少可读目标的风险,但不会据此宣称账户其余部分健康。
LP lot 和延期权益分别跟踪。不要将其显示值直接加入可用抵押余额,也不要承诺它们是立即可提取的保证金。池级托管须通过 claimPoolEscrowToAccount 领取到账户后才成为账户抵押余额。
清算会话与救援
条件满足时,任何人都可调用受支持的 liquidateNext、liquidatePositions 或 liquidateToTarget。分页保护绑定账户状态、目标集、执行价格和奖励预算。一页停止或取得部分进展,不等于账户已经健康。
清算会话禁止提现及新增风险。存款及受支持的降风险、恢复操作另有门禁。救援注资单独跟踪,避免不当计入清算奖励;保护应根据当前健康度和救援状态处理,不能假定每次存款都会立即结束清算。
Router 授权
代币 allowance 与账户 Router 信任是不同授权。proposeAccountRouterV24 接受必要的所有者授权,包括转发所有者签名。activateAccountRouterV24 检查激活时间窗、Router 身份及 authority 绑定。所有者可取消待生效提案。旧 setRouterApproval 不是 v24 流程。
交易代理
所有者通过 setTradingAgentV24 设置允许池、操作权限、到期时间、nonce,以及名义敞口、杠杆、协议费、keeper 费、抵押支出和每日交易量限制。使用当前授权 nonce 调用 revokeTradingAgentV24 撤销。
代理只能执行授权交易操作,不能提取托管资产、改变 Router 信任或管理代理。但获准交易仍可能亏损或产生费用,因此应使用有限余额、短有效期和较窄的允许池列表。
代理签名订单的非零 keeper 费受 maxKeeperFee 限制,由签名 maker 的钱包支付,不通过无限制账户提现支付,仍需要对应代币 allowance。