订单
通过匹配的 Router 执行受保护 v24 操作与签名订单。
即时操作与签名订单
RouterKernelV24 将受支持直接操作及 EIP-712 签名订单分派到已登记模块。请使用精确的 v24 schema 和部署当前生效的 Router,v22 或 v23 请求不兼容。
签名根类型覆盖普通及保证金仓位的开仓、追加抵押、降杠杆、部分和全部平仓,以及结算、LP 资金费、LP 费用和延期仓位权益领取。合约支持并不保证应用或 keeper 提供每种订单。
价格条件与保护
v24 订单信封使用 minPrice 和 maxPrice 区间,不包含旧版 triggerPrice / triggerAbove 字段。应用可以表达允许执行的价格范围,但止损或止盈标签不保证一定执行或按该价格成交。
信封还绑定 maker、账户、池、期限、nonce space、部署身份、执行绑定、风险配置、配置摘要和最小记账 nonce。内部操作另带精确状态及输出保护。最小记账 nonce 不能代替精确操作摘要。
价格区间直接比较,maxPrice 为零不表示无上限。maxProtocolFee 是协议费绝对上限,零表示不接受协议费。内部保护不能放宽已签名信封。状态或配置变化后,可能需要重新报价及签名。
预言机更新
受支持更新包装入口接受经过验证的 OracleUpdateBatchV24。付费更新必须使用获准适配器、正确操作绑定、期限、退款接收者和费用上限。Router 在执行前验证更新后的价格。
在 maxOracleUpdateFee 约束内提供足够原生代币。多余金额退给退款接收者;原生退款失败时,Router 记录可通过 claimNativeRefund 领取的余额。它与抵押资产结算托管不同。无更新路径的调用拒绝意外附带的原生代币。
签名与 keeper 费
签名在执行时验证,包括受支持的合约钱包签名。任何人都可提交有效订单,但仍须通过全部授权和执行检查。
非零 keeperFeeAmount 是通过 transferFrom 从 maker 钱包支付的签名金额,需要余额及 allowance。不要沿用 v22 将付款限制在平仓收益 20% 的规则。代理签名保证金订单还受账户 keeper 费用策略约束。
Keeper 费、原生预言机费、gas 和仓位清算奖励责任保证金均独立于 maxProtocolFee。有效签名本身不保证余额充足或订单可执行。
执行回执
池操作与签名订单执行由池模块和订单模块各自发出回执。保证金账户操作和 Recovery 清算路由没有自己的回执,因此 Router 在成功分派后为它们发出 RouterExecutionRoutedV24。该事件携带 Router 状态 nonce、绑定链、schema set、Router、执行序号、主体类型、主体和选择器的 actionId,以及操作者、选择器和精确返回数据的哈希。主体是保证金账户(subjectKind 为 5)或池(subjectKind 为 1)。
该回执只是索引辅助。经济事实仍以路由操作实际修改的池或账户状态为准。回退的路由不发出回执,也不改变状态。
撤单
订单过期后不能执行。提前取消使用 cancelNonce(nonceSpace, nonce) 或基于位图的 cancelNonceWord。Nonce space 具有明确操作域,请使用正确域,不要直接复用其他操作族的 nonce。成功执行会消耗 nonce,防止重放。
平仓与领取
v24 普通平仓在允许时选择 Direct 或 Escrow 结算。结算领取及延期权益领取具有独立签名根类型。不要调用旧 closePositionAndClaimV2WithPriceUpdate,也不要假定 v24 平仓会自动清空历史托管余额。