Across 入金后查不到转移:分开持久地址、入金交易与 sweep
链小知 · 进阶 · 核验 · 依官方文档整理
复核已有持久地址记录,确认路线、命名空间及每次入金,再处理批量执行和独立列表过滤。
开始前准备
- 已有去敏地址创建结果、入金与sweep标识、逐页列表及时间;没有响应时只建立核对表。
- 本篇不创建地址、发送资产、调用API或申请key;PDA能力与普通Swap路线分别核对。
1. 按原结果定位地址模式
保留destination的token/recipient与depositInstructions每条地址的namespace和address。相同参数可得到同一持久地址,不代表它只对应一笔转移。
当前PDA资料明确排除Solana和zkSync,Tron使用独立tron/base58项;Across普通Swap支持某链不能推PDA同样支持。
检查结果:地址类型、目标和原请求参数可对应,网络范围按所用产品单列。
2. 核对路线与原数量单位
逐项对照已有supportedInputs的originChainId、inputToken、limits与decimals,支持取决于链对和两侧资产,不只看链名。
expiresAt=null描述地址不设置到期,不保证任意资产、数量或路线永久可接受。indicativeFees/fillTime只是指示值;不把它们当账单或到账时限。
检查结果:每次入金有对应路线、资产和原整数金额;未知支持没有补成可用。
3. 区分 funding 和 sweep
PDA的depositTxnRef指发往入金地址的funding交易;sweepTxnRef指随后将资金移入桥接的执行交易。两种标识分列,不能用sweep替代原入金。
一个sweep可能执行多笔转移。单结果方法无法表达多个目标时,按已有/deposits列表核对每项;depositId是字符串,不经浮点Number保存。
检查结果:每次入金与其执行关系可追溯,批量执行没有被压成一个资产结果。
4. 保留独立列表模式的过滤规则
普通/deposits过滤按AND组合;指定depositAddress或sweepTxnRef时进入独立模式,除limit和skip外其他过滤会被忽略。二者同时提供会返回400。
在PDA记录中depositor是funding发送人,不是入金地址;按recipient或status补过滤不能保证独立模式结果已筛完。保留实际请求再在已取得记录中分类。
检查结果:查询模式与原参数同时保存,没有把被忽略的过滤当成功执行。
5. 逐页解释状态和缺项
列表按depositBlockTimestamp倒序,limit默认50且最大1000、skip从0起。保持查询模式和时刻,记录页范围、重复与缺页;滚动列表不保证固定快照。
PDA可返回deposit-pending、auto-refund-pending、refund-failed或manual-refund-required,但这些不在该接口status过滤枚举内。HTTP失败和原状态分别保留,不把未取得列表填0。
检查结果:计数限定已取得页,PDA额外状态没有被强制转换成普通pending/expired。
6. 按同一记录查看详情和访问边界
单/deposit文档示例为deposit对象及pagination;/deposits示例是数组。实际响应沿原结构解包;详情支持一组选择器,旧depositTxHash已弃用而depositTxnRef保留非EVM标识。
参考总入口要求Bearer和integratorId,持久地址创建另需deposit-address权限。这里只复核已有权限说明和结果;空值、索引延迟或400/404不足以证明资金丢失。
检查结果:形成地址、funding、sweep、逐笔结果的对应表,访问和索引未知单列。
怎样确认完成
- 每笔已有入金可定位到网络、地址命名空间、路线和执行记录。
- 明确页范围、错误及未知状态;没有真实API或完整索引验收。
常见错误与边界
- 把永久地址当永久可用路线,或把普通Swap支持套到PDA。
- 独立模式仍以被忽略的recipient/status过滤断言全量。
- 混用数组与deposit对象、入金与sweep、字符串ID与Number。