# Voltr提款口径：核LP与底层金额、回执和等待期 整理：链小知（AI 辅助） 资料核对日期：2026-10-14 引用地址：https://lianxiaozhi.com/tools/guides/voltr-lp-underlying-request-receipt-withdraw-path 难度：进阶 核验方式：官方文档整理，未执行真实账户操作 依据官方REST/SDK/CPI方法解释已有材料中的amount单位、LP escrow、instant资格及到账证据，同时保留链外金库和旧rgUSD冲突。 ## 使用工具 - [Voltr](https://lianxiaozhi.com/tools/voltr) · [官方入口](https://voltr.xyz/) ## 前置条件 - 准备既有脱敏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或缺托管信息保持未知。 依据：[Voltr current vault identity and mechanics](https://docs.voltr.xyz/introduction/how-it-works.md) 依据：[Voltr depositor overview](https://docs.voltr.xyz/users/overview.md) 依据：[Voltr risk disclosure](https://docs.voltr.xyz/users/vault-risk-disclosure.md) 依据：[Voltr deployed program upgrade](https://docs.voltr.xyz/security/deployed-programs.md) 依据：[Voltr historical rgUSD docs conflict](https://docs.voltr.xyz/users/rgusd/index.md) 依据：[Voltr original professional project review](https://solanacompass.com/projects/voltr) ## 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时点分别记录，未以总资产当可提款。 依据：[Voltr vault state and withdraw method](https://docs.voltr.xyz/developers/endpoints/vault.md) 依据：[Voltr fees and accounting](https://docs.voltr.xyz/vault-owners/fees-and-accounting.md) 依据：[Voltr depositor overview](https://docs.voltr.xyz/users/overview.md) 依据：[Voltr SDK v2 reference](https://docs.voltr.xyz/developers/sdk-reference.md) ## 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两身份能对应，缺单位/回执不猜。 依据：[Voltr vault state and withdraw method](https://docs.voltr.xyz/developers/endpoints/vault.md) 依据：[Voltr request receipt input units](https://docs.voltr.xyz/protocols/cpi-integration/request-withdraw.md) 依据：[Voltr SDK v2 reference](https://docs.voltr.xyz/developers/sdk-reference.md) ## 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路径分开，等待结束、流动性与成功回执各有证据或未知。 依据：[Voltr receipt claim conditions](https://docs.voltr.xyz/protocols/cpi-integration/withdraw.md) 依据：[Voltr instant withdrawal conditions](https://docs.voltr.xyz/protocols/cpi-integration/instant-withdraw.md) 依据：[Voltr vault state and withdraw method](https://docs.voltr.xyz/developers/endpoints/vault.md) 依据：[Voltr risk disclosure](https://docs.voltr.xyz/users/vault-risk-disclosure.md) ## 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关闭明确分层。 依据：[Voltr vault state and withdraw method](https://docs.voltr.xyz/developers/endpoints/vault.md) 依据：[Voltr receipt claim conditions](https://docs.voltr.xyz/protocols/cpi-integration/withdraw.md) ## 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/流动性限制，未提升为实际提款验收。 依据：[Voltr SDK v2 reference](https://docs.voltr.xyz/developers/sdk-reference.md) 依据：[Voltr risk disclosure](https://docs.voltr.xyz/users/vault-risk-disclosure.md) ## 常见错误 - isAmountInLp改变amount单位；isWithdrawAll可忽略传入amount。 - 等候结束不自动证明底层idle资产充足或manager已经处理。 - REST返回unsigned TX与旧rgUSD文档的即时赎回不能证明当前成功。 ## 完成检查 - 同一vault的单位、份额、手续费和提款分支已对应或标未知。 - request、claim、LP burn、资产到账和receipt关闭分别记录，无业务调用。 ## 相关知识 ## 官方依据 - [Voltr current vault identity and mechanics](https://docs.voltr.xyz/introduction/how-it-works.md) - [Voltr depositor overview](https://docs.voltr.xyz/users/overview.md) - [Voltr risk disclosure](https://docs.voltr.xyz/users/vault-risk-disclosure.md) - [Voltr deployed program upgrade](https://docs.voltr.xyz/security/deployed-programs.md) - [Voltr historical rgUSD docs conflict](https://docs.voltr.xyz/users/rgusd/index.md) - [Voltr original professional project review](https://solanacompass.com/projects/voltr) - [Voltr vault state and withdraw method](https://docs.voltr.xyz/developers/endpoints/vault.md) - [Voltr fees and accounting](https://docs.voltr.xyz/vault-owners/fees-and-accounting.md) - [Voltr SDK v2 reference](https://docs.voltr.xyz/developers/sdk-reference.md) - [Voltr request receipt input units](https://docs.voltr.xyz/protocols/cpi-integration/request-withdraw.md) - [Voltr receipt claim conditions](https://docs.voltr.xyz/protocols/cpi-integration/withdraw.md) - [Voltr instant withdrawal conditions](https://docs.voltr.xyz/protocols/cpi-integration/instant-withdraw.md)