跳到正文
← 使用教程

Aera V3退出单未成交:核份额、solver、价格与过期退款

链小知 · 进阶 · 核验 · 依官方文档整理

用已有订单材料核多存款人金库退出请求,分清固定/自动价、批次与单笔成交、solver路径、取消费用及退款资产。

开始前准备

  • 已有脱敏金库/Provisioner版本、请求参数和回执材料;缺失则按文档列待核,不连接钱包或调用接口
  • 区分V1/V2档案、现行V3概念、ProvisionerV2参考及具体gtUSDa集成示例

1. 先确认金库类型、链与当前模块

准备已有脱敏仓位或集成材料,记录chainId、金库地址、是否为MultiDepositorVault、Provisioner与feeCalculator地址及材料时间。单存款人国库的Owner供取权限,不能套到持有多存款人份额的普通读者。官方gtUSDa示例在Base;其他金库和跨链子BaseVault需分别辨认。

模块可更换,不硬编码旧Provisioner或价格计算器。gtUSDa集成页的Request与当前ProvisionerV2参考的RequestV2/receiver有版本差异;本教程只核已有材料,不调用合约或照抄示例。文档不足以确定部署版本时,后续配置项保持未知。

检查结果:类型、链、金库与两个模块及版本有证据或待核,未混用国库Owner与份额持有者。

2. 对齐份额、目标资产与订单身份

对已有requestRedeem记录分列unitsIn、minTokensOut、目标token、申请者、接收者、isFixedPrice、solverTip、deadline及maxPriceAge。gtUSDa示例份额是18位、USDC是6位,不能把界面的1000 USDC数值直接当unitsIn;每个参数与实际币种精度对应。

保存RedeemRequested中的redeemRequestHash,并与原请求完整参数对应。ProvisionerV2有带receiver和不带receiver的重载,不能从同钱包当前余额猜收款人;其内部hash包含token/user/receiver、请求种类、units/tokens、tip、deadline和maxPriceAge,参数变化后不能继续用旧单回执。

检查结果:份额和资产单位、申请者/接收者及完整订单字段对应,未以名字或余额代替请求身份。

3. 分清固定价、自动价与金库solver策略

固定价与自动价是两类订单。自动价按成交时可用的报告价处理并受最低兑出等约束;固定价可把经济差额留给solver,不能把未设置显式tip写成必然没有价差成本。还需核该金库的solver是否接受相应订单种类。

gtUSDa现行集成文要求自动价、solverTip为0,并提示非零tip不按其策略成交;3天deadline、1小时价格年龄及0.97保护量属于该文示例,不作跨金库默认、安全建议或完成保证。通用参考另有同步赎回配置,不从文档存在函数推本人可用即时出口。

检查结果:订单类型、实际solver政策和费用口径分开;示例数值未当统一配置或SLA。

4. 核价格报告、暂停和实际成交回执

记录已有材料中的价格计算器、报告时间、订单maxPriceAge和暂停状态。PriceAndFeeCalculatorV2由accountant报告anchor/drift价格,异常anchor可按配置暂停或回退,drift越界会回退;不能用网页APY、旧图表或仅有总资产数替代本单所用价格。该文时间校验一句存在not-future与too-far-future/stale表述混杂,实际判定仍待匹配实现,不自行改写成某个阈值。

ProvisionerV2参考明确部分无效单会在批次中记录PriceAgeExceeded、InvalidRequestHash或AmountBoundExceeded并返回未处理。整笔批次交易成功不代表自己的单成交;按同一个请求hash核RedeemSolved及目标资产转账、接收地址和实收数量,没有材料就记未核实。

检查结果:价格/时间/暂停有对应材料,批次成功与本单成交/实收分开,无交易材料未称退出完成。

5. 区分金库流动性结算与直接对手方

通用文档中,授权vault solver可使用金库资产并通过前后submit执行回收或部署;需要Provisioner具备相应Guardian及Merkle约束。直接solver使用自身流动性作对手方。不能把“任何人可直接solve”当任何人都能支配金库资产或保证随时有对手盘。

V2参考把direct solve描述为P2P,不经过金库存取通道,不查同一个solving gate,但仍受价格计算器的全冻结检查。前置submit失败会回退,后置submit可捕获失败;这类运维细节不等用户已经入账。按已有结算记录核实际路径,不为排查调用solver、改角色或广播。

检查结果:solver资金来源、权限和暂停边界分开,未将开放接口或运维动作当兑付保证。

6. 按过期退款或可取消条件整理结果

截止前未成交与过期是不同状态。只有支持取消的匹配版本/金库才能提前cancelRequest;V2可有取消开关、请求大小cap及以numeraire计算的固定/动态费用,预览本身不检查所有guard。未过deadline的订单不因价格不合适就当然可以无费取回。

gtUSDa文档规定过期未成交后通过refundRequest取回原投入的USDC或gtUSDa;退出单退回gtUSDa不等已兑成USDC。另核transfer hook的白/黑名单与实际接收者,不能以ERC20标签推一定可转移。最终分列待成交、已成交并实收、可退款/可取消及待核配置;本教程不实际创建、取消、领取或退款。

检查结果:退款原资产与退出目标资产、过期与可取消、预览与执行分别记录,费用/资格缺项保留。

怎样确认完成

  • 得到订单身份、单位、价格/solver策略与当前状态核对表
  • 已实收、待成交、可退/可取消及配置缺证据分别呈现

常见错误与边界

  • 把国库Owner权限套成所有多存款人份额持有人的即时退出权限。
  • 混用18位units与6位USDC、旧Request与V2receiver、固定价与自动价。
  • 把批次成功、三天deadline或通用solverTip当本单已完成或保证加速。
  • 把原份额退款、预览费用或ERC20可转让标签当最终目标资产实收。

本教程根据官方资料整理,尚未完成逐步操作验收。界面、支持范围及费用变化时,先核对官方说明。 纯文本版 · 提交纠错依据