# Splits 收到分账却未到账：区分 Pull、Push、Warehouse 与提现

整理：链小知（AI 辅助）
资料核对日期：2026-10-12
引用地址：https://lianxiaozhi.com/tools/guides/splits-pull-push-warehouse-withdraw-records
难度：进阶
核验方式：官方文档整理，未执行真实账户操作

把原始收款、分配凭证和外部转账分开，按已有余额与回执解释资金停在哪个阶段。

## 使用工具
- [Splits 分账协议](https://lianxiaozhi.com/tools/splits) · [官方入口](https://splits.org/protocol/)

## 前置条件
- 已有网络、Split 类型、代币地址/精度、收款人及入金、分配、Warehouse、提现的去敏记录。
- 只核已有资料，不调用余额/RPC/withdraw，不授权、不签名或重试提现。

## 1. 按资产身份建立收款记录

核对 Split 地址收到的是哪条链的原生币或哪一个代币合约，保留原整数金额和时间。协议流程先接收，再分配，最后可能提现。

仅有入金成功不能写成各收款人已得到外部钱包转账；代币符号相同不代表同一资产。

核对结果：收款记录有链、合约和原数量，阶段未合并。
依据：[Splits：收款、分配与提现三个阶段](https://splits.org/protocol/docs/flow/)
依据：[SplitV2：Pull、Push、owner 与资产限制](https://splits.org/protocol/docs/core/split-v2/)

## 2. 根据 Pull 或 Push 定位分配去向

Pull 分配后通常计入 Warehouse；Push 尝试直接发送。以原 SplitDistributed 及实际资产移动对照，不以 UI 的 Distributed 标签替代到账。

Push 原生发送失败可进入 Warehouse；ERC20 没有该回退，任一收款转账失败可令整笔分配回滚。原生重入等情况也可能整体失败，不能一律断言已回退。

核对结果：每笔明确成功、回滚或 Warehouse 待提现，未知路径保留。
依据：[SplitV2：Pull、Push、owner 与资产限制](https://splits.org/protocol/docs/core/split-v2/)
依据：[SplitV2 SDK：配置、状态、余额与事件](https://splits.org/protocol/docs/sdk/splits-v2/)

## 3. 分开 Split 余额与个人凭证

原 getSplitBalance 返回 splitBalance 与 warehouseBalance，按该 Split/资产理解；个人已分配份额另对照 Warehouse balanceOf(ownerAddress, tokenAddress) 的已有结果。

Warehouse 使用 ERC6909 凭证记底层资产请求权，不能把凭证数量再与同一底层余额相加；精度与 bigint 原值保留。

核对结果：Split 未分配款、Split 在 Warehouse 的余额和个人份额没有串用。
依据：[SplitV2 SDK：配置、状态、余额与事件](https://splits.org/protocol/docs/sdk/splits-v2/)
依据：[Warehouse：代币凭证与提现暂停](https://splits.org/protocol/docs/core/warehouse/)
依据：[Warehouse SDK：余额、提现与激励参数](https://splits.org/protocol/docs/sdk/warehouse/)

## 4. 检查提现配置与激励路径

核对已有 getWithdrawConfig(userAddress) 的 incentive 和 paused。Warehouse 可暂停外部第三方代为提现，不等同暂停 Split 分配。

SDK withdraw 描述单资产全余额且忽略提现激励；batchWithdraw 按 tokensAddresses/amounts 并可给 withdrawerAddress 激励。记录各自方法和单位，不把调用人当收款人。

核对结果：暂停层、ownerAddress、代币和激励领取者分列。
依据：[Warehouse：代币凭证与提现暂停](https://splits.org/protocol/docs/core/warehouse/)
依据：[Warehouse SDK：余额、提现与激励参数](https://splits.org/protocol/docs/sdk/warehouse/)

## 5. 用原提现回执核对实际转账

从已有 Withdraw 回执对应网络、合约、ownerAddress、代币和转账数量，核对外部收款地址与交易成功状态。事件或请求已发送不足以证明余额已到账。

批量记录逐资产对照 amounts，不能将多种代币原整数相加。若只取得 Warehouse 余额，结论停在已有份额，不猜提现完成。

核对结果：实际到账结论绑定正确资产和成功转账，缺证仍为待提现或未确认。
依据：[Warehouse SDK：余额、提现与激励参数](https://splits.org/protocol/docs/sdk/warehouse/)
依据：[Splits：收款、分配与提现三个阶段](https://splits.org/protocol/docs/flow/)

## 6. 保留不兼容资产与恢复边界

Pull 文档警示不可转让、转账扣费和 rebasing 资产；V2.0/2.1 的主网 USDT 限制也须按原版本确认。原金额差异不自动归为平台扣费。

Push 是否可更新收款人或处理余额取决于是否可变及 owner 权限。不可变 Split 没有 owner 恢复通道，保留原错误和官方支持入口，不建议追加转账试错。

核对结果：输出资产/版本/流程差异和未核原因，不承诺可恢复或提现时限。
依据：[SplitV2：Pull、Push、owner 与资产限制](https://splits.org/protocol/docs/core/split-v2/)

## 常见错误
- 分配完成当外部到账；Push 原生回退套到所有 ERC20。
- 把 Split 的 Warehouse 余额当个人份额。
- 凭证与底层双计、不同代币整数相加，或外部暂停当 Split 暂停。

## 完成检查
- 逐资产形成接收、分配、内部份额、提现和外部转账的证据链。
- 全部结论限已有记录，未执行提现或取得当前余额。

## 相关知识
- [原始、解码和整理后的链上数据有什么区别？](https://lianxiaozhi.com/learn/raw-decoded-curated-data)
- [Gas 怎么计算？交易失败为什么仍可能扣费](https://lianxiaozhi.com/learn/gas-and-failed-transactions)
- [链上指标历史数值为什么会变？](https://lianxiaozhi.com/learn/point-in-time-metrics)

## 官方依据
- [Splits：收款、分配与提现三个阶段](https://splits.org/protocol/docs/flow/)
- [SplitV2：Pull、Push、owner 与资产限制](https://splits.org/protocol/docs/core/split-v2/)
- [SplitV2 SDK：配置、状态、余额与事件](https://splits.org/protocol/docs/sdk/splits-v2/)
- [Warehouse：代币凭证与提现暂停](https://splits.org/protocol/docs/core/warehouse/)
- [Warehouse SDK：余额、提现与激励参数](https://splits.org/protocol/docs/sdk/warehouse/)