Voltr提款口径：核LP与底层金额、回执和等待期
链小知 · 进阶 · 核验 · 依官方文档整理
依据官方REST/SDK/CPI方法解释已有材料中的amount单位、LP escrow、instant资格及到账证据，同时保留链外金库和旧rgUSD冲突。
开始前准备
- 准备既有脱敏vault地址、asset/LP mint、用户标识、请求参数与回执，保留观察时间；没有材料时只做字段映射。
- 不运行SDK/RPC/REST，不构造、签名或发送提款；本文不适用于未闭合的历史rgUSD恢复。
1. 先固定vault与资产、管理和托管对象
LP是单vault的份额收据，价值随策略profit/loss，不是Voltr公司token或1美元稳定币。按已有vault pubkey、assetMint、LP mint核身份，不能按同名策略或Ranger旧品牌代入。
当前risk区分chain内whitelist资金与链外custodian/manager CEX账户；后者Voltr可能只共签custodian提款，manager CEX类型无签名权。升级multisig地址不证门限/成员。10月12日专业评论及官方rgUSD仍即时赎回文档有冲突，该旧vault不由本教程保证提款。
检查结果：vault/asset/LP/manager与托管类型明确，旧rgUSD或缺托管信息保持未知。
2. 将LP估值与收费、锁定利润分开
官方share-price为指定Unix秒ts的interpolated asset-per-LP；fee-earned按startTs/endTs秒窗口算performance/management fees、单位是vault LP。用户balance方法是底层资产总额，不能把fee LP直接当USD或当前可用现金。
fees页说明locked profit按配置窗口逐步解锁；HWM为历史asset-per-LP峰值，首成功存入seed。当前SDK getCurrentAssetPerLpForVault/getHighWaterMarkForVault/getVaultLpSupplyBreakdown可解释已保存结果，但其RPC读本次不运行；发行/赎回/年管理/表现费按各vault核，未知值不填零。
检查结果：份额价格、LP收费、底层余额和locked-profit时点分别记录，未以总资产当可提款。
3. 核request的数量单位与单回执身份
REST request-withdrawal body含userPubkey、字符串lamportAmount及可选isAmountInLp/isWithdrawAll；CPI amount为u64，is_amount_in_lp=true是LP数量，false是底层资产数量，is_withdraw_all=true忽略amount取全部LP。API的lamport字段名不证明所有资产采用SOL9位，需对应mint单位；缺精度不能人类数转整数。
CPI request把LP转入receipt ATA，PDA由固定seed、vault、user构成，单user每vault一次只能有一个active request。SDK v2对应findRequestWithdrawVaultReceiptPda等helpers；按已有receipt匹配两身份，不凭同wallet合并不同vault，也不覆盖已有active请求。
检查结果：金额旗标、原整数、mint及receipt两身份能对应，缺单位/回执不猜。
4. 等待期与instant分支分别判资格
正常request后须等vault withdrawal_waiting_period；withdraw提前会WithdrawalNotYetAvailable。Instant CPI仅period=0，否则InstantWithdrawNotAllowed；它直接burn LP并转底层，无新receipt。REST direct-withdraw只称supported vaults，名称不能证明当前vault资格。
Risk页另说明流动性和manager responsiveness影响实际赎回、无保证时间；不能只看等待期到了就宣布现金可领。已有pending-withdrawal返回withdrawable amount/timestamp用来定位已保存请求，若缺当前材料不推所有资金已释放。
检查结果：正常request/claim与instant路径分开，等待结束、流动性与成功回执各有证据或未知。
5. 分清unsigned交易、成功claim和receipt关闭
官方REST交易创建端点返回serialized unsigned transaction，尚需客户端钱包签名/广播；HTTP成功或返回字节不是提款完成。只核既有脱敏回执；不发POST、更不签名。
正常withdraw CPI无额外业务参数，burn escrow LP并由vault_asset_idle_ata转至user_asset_ata；成功后receipt关闭并返租金。仅看到claim按钮/取消交易构建不能断定LP已burn或资产已到；没有这些记录就保留实际claim/租金未知。
检查结果：unsigned构建、链上执行、LP变化、资产转移及receipt关闭明确分层。
6. 保留当前版本与退出限制形成记录
当前SDK2.1.1使用@solana/kit、生成instruction builder/PDA/fetch/extension helpers，旧VoltrClient/BN例不直接代表当前参数。本文只按当前文档核既有材料，SDK安装或执行状态未验证。
风险页禁止美国主体与OFAC辖区、无保险或treasurybackstop；若manager停止响应Voltr不能强制处理redeem。完成同一vault的LP/资产单位、fees/锁定、request/period/instant资格和执行状态记录，不将过期品牌说明或非托管标签当任何到账保证。
检查结果：记录包含版本、权限和manager/流动性限制，未提升为实际提款验收。
怎样确认完成
- 同一vault的单位、份额、手续费和提款分支已对应或标未知。
- request、claim、LP burn、资产到账和receipt关闭分别记录，无业务调用。
常见错误与边界
- isAmountInLp改变amount单位；isWithdrawAll可忽略传入amount。
- 等候结束不自动证明底层idle资产充足或manager已经处理。
- REST返回unsigned TX与旧rgUSD文档的即时赎回不能证明当前成功。