# Upshift赎回未到账：核shares、epoch、接收人与即时路径

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

按已有EVM赎回材料分清请求、到期、结算和领取，处理版本参数、接收索引、费用和暂停未知项。

## 使用工具
- [Upshift](https://lianxiaozhi.com/tools/upshift) · [官方入口](https://www.upshift.finance/)

## 前置条件
- 准备自己已有的脱敏仓位、操作摘要与结果记录，保留链、版本、地址角色、份额单位和取得时间；缺失项列待核。

## 1. 固定金库版本、地址和赎回份额单位

从已有材料记录chainId、vault地址、version、原持有人和目标接收人。SDK按version检测evm-0/1/2，不能把同名金库或不同链地址当同一实现，也不能用EVM接口去解释Solana/Stellar记录。

vaultRequestRedeem的amount是要赎回的shares，SDK会按相应小数位转换；合约requestRedeem的uint256是链上份额整数。示例amount="50"表示50份，不等50 USDC，也不是裸整数50。缺股份decimals或资产/股份区分时，数量保持待核。

核对结果：链、vault/version、股份与底层资产及其单位明确，未把50份或SDK显示量当50个底层币或裸整数。
依据：[Upshift EVM方法：版本、份额和领取参数](https://docs.upshift.finance/sdk/evm-actions)
依据：[Upshift金库合约：赎回、epoch、接收人与状态](https://docs.upshift.finance/contracts/vault-interface)
依据：[Upshift单资产金库与角色](https://docs.upshift.finance/vault-architecture/single-asset-vault)

## 2. 区分请求成功、到期epoch与最终领取

标准合约requestRedeem(shares,receiverAddr,holderAddr)先发起赎回，说明中股份被烧掉并形成稍后epoch可兑的claim，返回assets与claimableEpoch的Unix时间戳。请求哈希证明的阶段有限，不是底层资产已转回接收人的凭证；股份减少也不能单独判为丢失。

资金流说明还要由operator为epoch批量结算，再由holder或代其操作的人claim。对已有记录核request、claimableEpoch、结算及claim的先后；不要把SDK示例等待lagDuration的秒数当固定24小时、自动完成承诺或人人可调用的管理权限。

核对结果：请求、到期、运营方结算及claim分别留证；请求哈希或等待结束未被推成到账。
依据：[Upshift金库合约：赎回、epoch、接收人与状态](https://docs.upshift.finance/contracts/vault-interface)
依据：[Upshift赎回资金流、NAV和收费](https://docs.upshift.finance/curators/fees-and-fund-flows)
依据：[Upshift EVM方法：版本、份额和领取参数](https://docs.upshift.finance/sdk/evm-actions)

## 3. 按版本核请求签名与领取接收标识

SDK文档将evm-0/1请求映射为requestRedeem(uint256,address,address)，evm-2为requestRedeem(uint256,address)。保留原version和参数顺序，不把通用三参数合约摘要强套给两参数实现。

合约claim(year,month,day,receiverAddr)要求接收地址与requestRedeem登记的一致，日期表示已经成熟的epoch，可以是过去日期。SDK vaultRedeem则列year/month/day/receiverIndex，例子取redemption.year.raw等并把receiverIndex写成"0"；索引不是地址，也不保证每笔都应取0或第一条可领取项。缺真实对应项就停在无法匹配。

核对结果：version与请求参数数量对应；epoch日期、登记接收地址和SDK索引分别匹配，未机械照抄首项。
依据：[Upshift EVM方法：版本、份额和领取参数](https://docs.upshift.finance/sdk/evm-actions)
依据：[Upshift金库合约：赎回、epoch、接收人与状态](https://docs.upshift.finance/contracts/vault-interface)

## 4. 将即时赎回的支持、费用与流动性分开

isInstantRedeem默认false，只有支持即时赎回的金库才可选；instantRedeem绕过epoch队列但收费，资金流说明由流动性buffer支付。即时路径的previewInstantRedemption是预估，不说明相应金库当前buffer充足、已扣费或已成功。

普通withdrawalFee、instantRedemptionFee、管理费和高水位表现费分别存在；本轮不能从无实时配置的文档给出具体净实收。vault的isWithdrawalPaused是独立状态，缺原状态或暂停记录时不保证可取。其他Atomic Redemption产品的“无队列”描述也不覆盖这里的标准epoch路径。

核对结果：即时支持、原费用、流动性及暂停状态各自有记录或未知，未把instant或preview当必可立即到账。
依据：[Upshift EVM方法：版本、份额和领取参数](https://docs.upshift.finance/sdk/evm-actions)
依据：[Upshift金库合约：赎回、epoch、接收人与状态](https://docs.upshift.finance/contracts/vault-interface)
依据：[Upshift赎回资金流、NAV和收费](https://docs.upshift.finance/curators/fees-and-fund-flows)

## 5. 核角色和结果缺项，形成可追溯记录

单资产规范把Vault Owner列为控制关键参数与紧急功能的多签，Operator负责赎回处理、NAV更新和vault/subaccount间流动性，Strategist只在白名单内配置策略。策略方不能直接提现的约束不等全部管理动作不存在，也不等某人已获个人操作权限。

最终按原request/epoch/结算/claim记录以及实际接收结果分列；preview资产金额、NAV份额价和到账不是同一件事。条款明确转移可有延迟、按具体vault规则和链处理且不保证回报。若缺version、claim接收对应或最终回执，结论保留待核，而不是重复发起请求或把余额缺失补零。

核对结果：管理角色、预估金额、赎回阶段和实收结果可对应；缺权限/回执未补成可操作或成功。
依据：[Upshift单资产金库与角色](https://docs.upshift.finance/vault-architecture/single-asset-vault)
依据：[Upshift金库合约：赎回、epoch、接收人与状态](https://docs.upshift.finance/contracts/vault-interface)
依据：[Upshift赎回资金流、NAV和收费](https://docs.upshift.finance/curators/fees-and-fund-flows)
依据：[Upshift条款：资格、延迟与不保证回报](https://docs.upshift.finance/resources/legal/terms-of-use)

## 常见错误
- 界面或方法名称相同，不代表版本、份额、资产和权限相同。
- 请求、预估和最终接收分开，未知不补零或成功。

## 完成检查
- 得到资格/版本、份额、操作阶段与实际结果缺项的对照；官方方法已核，个人权限及实际执行依原记录确认。

## 相关知识

## 官方依据
- [Upshift单资产金库与角色](https://docs.upshift.finance/vault-architecture/single-asset-vault)
- [Upshift金库合约：赎回、epoch、接收人与状态](https://docs.upshift.finance/contracts/vault-interface)
- [Upshift EVM方法：版本、份额和领取参数](https://docs.upshift.finance/sdk/evm-actions)
- [Upshift赎回资金流、NAV和收费](https://docs.upshift.finance/curators/fees-and-fund-flows)
- [Upshift条款：资格、延迟与不保证回报](https://docs.upshift.finance/resources/legal/terms-of-use)