# YO赎回记录怎么核：份额、回执分支与待处理金额

整理：链小知（AI 辅助）
资料核对日期：2026-10-14
引用地址：https://lianxiaozhi.com/tools/guides/yo-gateway-redeem-receipt-pending-units
难度：进阶
核验方式：官方文档整理，未执行真实账户操作

用已有材料区分yoToken份额、预期输出、即时资产与异步请求编号，保留报价文档差异和缺失的实收证据。

## 使用工具
- [YO Protocol](https://lianxiaozhi.com/tools/yo-protocol) · [官方入口](https://www.yo.xyz/)

## 前置条件
- 准备已有的脱敏金库、报价参数、交易回执、待处理状态和收款材料，保留链、日期、数量单位与版本；缺项列待核。

## 1. 锁定本链金库、份额与收款对象

从已有材料记录chain、yoVault地址、yoToken、底层asset地址、收款人和记录时间，再对照官方地址表。本教程针对Ethereum、Base、Arbitrum上的yoGateway；Gateway说明在各链独立处理，例如在Base收到的yoToken须在Base赎回，不能把同名金库当跨链通用余额。

分别保留份额decimals、底层assetDecimals、shares和assets。yoToken不rebase，余额数量不等于底层资产数量；SDK样例的100n是原始整数，不等于100个完整份额。缺精度或对象时先保留未知，不据币名或美元估值补换算。

核对结果：金库、链、底层资产、收款人与两类精度对应；原始整数、完整份额和资产数量未混同。
依据：[YO：金库、底层资产、链与权限地址表](https://docs.yo.xyz/protocol/contract-addresses.md)
依据：[YO：yoGateway链内范围及报价示例](https://docs.yo.xyz/integrations/integration-guides/yogateway.md)
依据：[YO：份额代币与非rebase收益](https://docs.yo.xyz/protocol/yovault-tokens.md)
依据：[YO SDK：份额、底层资产及报价字段](https://docs.yo.xyz/integrations/integration-guides/sdk/core/vault-reads.md)

## 2. 对照报价用途与赎回输入版本

核已有报价记录的函数名、输入单位、输出单位和取得时间。SDK Vault Reads把quotePreviewRedeem(vault, shares)的结果作为资产，把quotePreviewWithdraw(vault, assets)的结果作为所需份额；Gateway专页却把后者展示为份额到资产。同名说明存在冲突，缺实际版本与记录时标为待核，不据页面函数名猜转换方向，也不照抄exchangeRate字段自行取倒数。

Actions的redeem输入是shares，recipient默认为signer；slippageBps默认50，即0.5%，但显式minAssetsOut会覆盖这一设置。只对照已有参数和报价，不能将示例的minAssetsOut=0视作建议下限。result.assets在该页标为expected assets，预期资产数不是最终收到的数量。

核对结果：报价输入/输出单位及版本差异有标记；shares、recipient和有效输出下限可核，预期值未当到账。
依据：[YO SDK：份额、底层资产及报价字段](https://docs.yo.xyz/integrations/integration-guides/sdk/core/vault-reads.md)
依据：[YO：yoGateway链内范围及报价示例](https://docs.yo.xyz/integrations/integration-guides/yogateway.md)
依据：[YO SDK：赎回输入、预期结果与回执解码](https://docs.yo.xyz/integrations/integration-guides/sdk/core/actions.md)

## 3. 先读回执状态，再解释assetsOrRequestId

将已有交易hash与确认回执对应。官方通用回执区分success与reverted；只有提交hash或预期assets，不能认定赎回已经完成。若记录失败或缺回执，保留失败/未知，不据界面预估余额填写结果。

官方waitForRedeemReceipt方法说明解码YoGatewayRedeem事件，返回instant、assetsOrRequestId和shares。instant为真时后者代表即时返回资产，为假时代表待处理请求编号；必须按分支解释，不能将请求编号当资产原始整数。将shares与第一步的份额精度对应，再核独立的底层资产实收材料。

核对结果：交易确认/失败已分开；instant控制值的含义，请求编号未当金额，缺实收证据未标到账。
依据：[YO SDK：赎回输入、预期结果与回执解码](https://docs.yo.xyz/integrations/integration-guides/sdk/core/actions.md)
依据：[YO SDK：份额、底层资产及报价字段](https://docs.yo.xyz/integrations/integration-guides/sdk/core/vault-reads.md)

## 4. 按金库、用户和链核待处理记录

对照已有pending记录的vault、user和chainId。usePendingRedemptions的查询键同时含这三个对象，只有client和用户地址均存在才启用；返回assets和shares各为FormattedValue，同时提供isLoading、isError及error。正在加载、未启用、读取失败或undefined不能当成零待处理，缺新记录也不能仅凭旧结果认定清空。

FAQ描述异步退出中yoToken会被销毁，协议退出底层仓位后自动将资产发送到钱包，不需回来另行claim。因此份额余额下降不等于资产已到账，待处理资产、份额及最终收款须分列。基础收益也不等于另行领取的$YO奖励，不能用奖励领取记录填补赎回实收缺项。

核对结果：pending对象、错误/加载状态和资产/份额分列；销毁份额、额外奖励与最终到账未互相替代。
依据：[YO SDK：待处理赎回状态、范围与错误字段](https://docs.yo.xyz/integrations/integration-guides/sdk/react/hooks/use-pending-redemptions.md)
依据：[YO：退出、费用分摊与奖励FAQ](https://docs.yo.xyz/welcome-to-yo/faq.md)
依据：[YO：份额代币与非rebase收益](https://docs.yo.xyz/protocol/yovault-tokens.md)

## 5. 保留流动性、时间和费用例外后结案

用户提现说明写少于TVL的5%可即时、大额可能等待24小时；Protocol页的技术判据是金库是否有足够即时流动性，否则由授权operator补充流动性并处理请求。将这些说明与本次回执分开；无实际完成材料时保留异步待核，不能只看比例、倒计时或文档的“几秒”完成句判到账。

核原记录的净实收、费用和观察时间。Protocol页存入/退出费目前为0，FAQ目前赞助gas但将其他金库成本分摊给存入者；这些不是全部路径永远免费。底层协议、策略、链、桥接和暂停仍可影响损失或等待。最终用确认回执、对应pending状态及同资产实际收款闭合；不足的环节明确留空。

核对结果：文档时间/比例与实际分支分别记录；费用范围、流动性和损失例外保留，结论由实收材料支撑。
依据：[YO：用户提现说明及大额等待口径](https://docs.yo.xyz/user-guides/how-to-withdraw-from-yo.md)
依据：[YO：流动性、异步赎回与当前费用](https://docs.yo.xyz/protocol/yo-protocol.md)
依据：[YO：退出、费用分摊与奖励FAQ](https://docs.yo.xyz/welcome-to-yo/faq.md)
依据：[YO：策略、流动性与底层协议风险](https://docs.yo.xyz/protocol/risks.md)
依据：[YO SDK：赎回输入、预期结果与回执解码](https://docs.yo.xyz/integrations/integration-guides/sdk/core/actions.md)

## 常见错误
- 份额不等于底层资产；原始整数需对应两类精度。
- assetsOrRequestId须结合instant解释，请求编号不是资产数量。
- 报价函数文档存在差异；成功回执、份额销毁、标准等待与最终实收不能互相替代。

## 完成检查
- 得到本链金库、单位、有效报价参数、回执分支、pending状态和实收的对照；官方方法已核，个人资金结果依原材料确认。

## 相关知识

## 官方依据
- [YO：金库、底层资产、链与权限地址表](https://docs.yo.xyz/protocol/contract-addresses.md)
- [YO：yoGateway链内范围及报价示例](https://docs.yo.xyz/integrations/integration-guides/yogateway.md)
- [YO：份额代币与非rebase收益](https://docs.yo.xyz/protocol/yovault-tokens.md)
- [YO SDK：份额、底层资产及报价字段](https://docs.yo.xyz/integrations/integration-guides/sdk/core/vault-reads.md)
- [YO SDK：赎回输入、预期结果与回执解码](https://docs.yo.xyz/integrations/integration-guides/sdk/core/actions.md)
- [YO SDK：待处理赎回状态、范围与错误字段](https://docs.yo.xyz/integrations/integration-guides/sdk/react/hooks/use-pending-redemptions.md)
- [YO：退出、费用分摊与奖励FAQ](https://docs.yo.xyz/welcome-to-yo/faq.md)
- [YO：用户提现说明及大额等待口径](https://docs.yo.xyz/user-guides/how-to-withdraw-from-yo.md)
- [YO：流动性、异步赎回与当前费用](https://docs.yo.xyz/protocol/yo-protocol.md)
- [YO：策略、流动性与底层协议风险](https://docs.yo.xyz/protocol/risks.md)