# Rhino.fi入金未激活：核SDA监控、处理阶段与退款

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

用原地址状态、历史和退款材料区分入金已见、已接收、目的执行及真实返还，避免把accepted或空列表当最终结论。

## 使用工具
- [Rhino.fi](https://lianxiaozhi.com/tools/rhino-fi) · [官方入口](https://rhino.fi/)

## 前置条件
- 准备已有脱敏SDA配置、入金链与token、原交易hash、历史/通知及可选退款结果；保留时间和原单位，不提供API key、JWT或完整客户身份。

## 1. 固定同一SDA、链与资产支持范围

用depositAddress与depositChain定位同一原SDA，不用目的钱包地址代替。核destinationChain、tokenOut及原目的地址记录；概述写destinationAddress仅SECRET key状态查询时返回，缺字段不能猜空地址或已改目的地。

对该depositChain的supportedTokens逐项核address、symbol、minDepositLimitUsd/maxDepositLimitUsd，美元限额不等token数量。多EVM链可共用地址，不推非EVM也同址；超限或不支持的入金不会自动按普通桥处理。

核对结果：SDA/原链/token与目的配置关联，金额单位及支持范围明确。
依据：[Rhino.fi：企业SDA身份、访问与配置](https://docs.rhino.fi/api-integration/smart-deposits.md)
依据：[Rhino.fi：SDA监控/暂停及支持资产状态](https://docs.rhino.fi/api-reference/sda/depositaddresses/get-deposit-address-status.md)

## 2. 分开监控、暂停与交易成功

状态方法GET /sda/deposit-addresses/{depositAddress}/{depositChain}中的isActive表示是否监控和处理支持资产，isPaused表示暂停；暂停地址会拒绝入金，两者都不是已到账标志。

概述写7年后不监控，schema写10年，不能据创建年数自行推仍有效。若原状态/时间缺失，记录未知，不能靠再次发送资金或修改地址配置验证。

核对结果：isActive、isPaused及状态时点明确，未由地址存在推已处理。
依据：[Rhino.fi：SDA监控/暂停及支持资产状态](https://docs.rhino.fi/api-reference/sda/depositaddresses/get-deposit-address-status.md)
依据：[Rhino.fi：企业SDA身份、访问与配置](https://docs.rhino.fi/api-integration/smart-deposits.md)

## 3. 按历史窗口区分detected、accepted与执行

SDA history方法是GET /sda/deposit-addresses/{depositAddress}/{depositChain}/history，只有SECRET_ key权限可查。默认过去7天，当前reference最大查询窗31天；from/to支持毫秒epoch或Date，先核已有结果覆盖日期，窗口外空列表不证明没有入金。

bridges[]外层_tag分detected、confirming、accepted、rejected、failed。detected是托管提供方在mempool见到，confirming为已进块处理中；accepted项里的history是另一层对象，state可为PENDING/PENDING_CONFIRMATION/FAILED/DEPOSIT_ACCEPTED/ACCEPTED/EXECUTED。因此_tag=accepted不能替代history.state=EXECUTED。

对accepted.history核chainIn/chainOut、token/tokenOut及amountIn/amountOut；外层txHash和history.depositTxHash是源入金，EXECUTED分支withdrawTxHash才是目的发送记录。isConfirmed仅核源确认，仍需原目的余额或目标协议记录确认最终激活。

核对结果：时间覆盖、外层_tag、内层state和两链hash分开，缺目的记录不写已激活。
依据：[Rhino.fi：SDA历史、阶段与源/目的hash](https://docs.rhino.fi/api-reference/sda/depositaddresses/obtain-a-list-of-previous-activity-for-a-smart-deposit-address.md)
依据：[Rhino.fi：企业SDA身份、访问与配置](https://docs.rhino.fi/api-integration/smart-deposits.md)

## 4. 核拒绝和延迟，避免重复入金

rejected原reason可含UNDER_MIN、OVER_MAX、UNSUPPORTED_TOKEN、SDA_PAUSED、NO_ROUTE_FOUND等；failed还可有originalErrorTag。pSDA另有PAYMENT_EXPIRED/PAYMENT_AMOUNT_MISMATCH/PAYMENT_ALREADY_RECEIVED等原因，不能把一次性支付地址规则套所有可复用SDA。

通知DEPOSIT_ADDRESS_BRIDGE_DELAYED说明系统会重试，不要求用户行动；它不同于已退款。BRIDGE_EXECUTED才是文档的目的桥完成通知，不能把BRIDGE_PENDING/ACCEPTED当完成；这里只核已有可信通知，缺验签或原记录时保持未验证。

UNSUPPORTED_TOKEN拒绝通知只监测部分不支持代币，并非任意误转都能检测。若未见通知，不能推出代币支持、零余额或资金已丢失；不靠追加转账补查。

核对结果：拒绝原因、延迟重试与目的完成通知区分，未由缺通知作余额结论。
依据：[Rhino.fi：SDA历史、阶段与源/目的hash](https://docs.rhino.fi/api-reference/sda/depositaddresses/obtain-a-list-of-previous-activity-for-a-smart-deposit-address.md)
依据：[Rhino.fi：SDA拒绝、延迟和退款通知](https://docs.rhino.fi/webhook/events-list.md)

## 5. 关联已完成退款，分清原入金与返还hash

已完成退款方法为GET /sda/deposit-addresses/{depositAddress}/{depositChain}/completed-refunds，结果items[]含refundId、depositChain、recipient、trigger、txHash、txTimestamp。txHash是退款交易；originalDepositTxHash是可选原入金hash，不可互换。

trigger._tag=REJECTED_BRIDGE时有rejectedDepositAddressBridgeId可连原拒绝记录；UNSUPPORTED_TOKEN分支原入金hash及人类可读金额可能缺失。amountWei是代币最小单位，nativeToken=true时没有tokenAddress不能补成零地址。依据实际recipient和链核原返还记录，不能从预设refundAddress推已到账。

概述提示从CEX等共享地址入金，发送人不一定是客户可访问退款地址，退款宜与项目Account Management逐案确认。空items、rejected或failed不等全额自动退，费用是否返还也要原材料。

核对结果：退款ID、原因、接收人、原入金与退款hash有对应材料，缺值和费用边界明确。
依据：[Rhino.fi：已完成SDA退款的字段与原因](https://docs.rhino.fi/api-reference/sda/depositaddresses/get-completed-sda-refunds.md)
依据：[Rhino.fi：SDA拒绝、延迟和退款通知](https://docs.rhino.fi/webhook/events-list.md)
依据：[Rhino.fi：企业SDA身份、访问与配置](https://docs.rhino.fi/api-integration/smart-deposits.md)

## 6. 核计划费用与最终业务结果

当前费用方法按订阅与可选扩展计，SDA概述还保留PAYG/Legacy说明。已有isSda=true报价用于SDA费用估计，并核expiresAt；不能把普通bridge报价或过期报价当实际SDA净到账。客户surcharge、链成本与企业月费分别记录。

1:1转换需扩展开启，postBridgeData由预定义/获准动作决定。桥EXECUTED或退款完成只证对应阶段，目的vault/card/交易余额仍需各自原业务记录。归档同SDA的支持/监控、处理阶段、目的结果和退款结论，缺项不补成功。

核对结果：得到同SDA的处理及返还对照，费用、扩展资格与最终激活各自有依据或未知。
依据：[Rhino.fi：企业订阅、报价有效期和客户附加费](https://docs.rhino.fi/get-started/fees-and-limits.md)
依据：[Rhino.fi：企业SDA身份、访问与配置](https://docs.rhino.fi/api-integration/smart-deposits.md)
依据：[Rhino.fi：SDA历史、阶段与源/目的hash](https://docs.rhino.fi/api-reference/sda/depositaddresses/obtain-a-list-of-previous-activity-for-a-smart-deposit-address.md)

## 常见错误
- 外层accepted不等内层EXECUTED，isActive/isConfirmed也不等最终目的业务完成。
- 监控7年/10年文档冲突、只监测部分误转与共享CEX发送地址都会影响排查范围，不能用统一自动退款承诺补缺。

## 完成检查
- 已按官方方法整理原SDA监控、历史阶段、目的结果和已完成退款；实际项目资格与原账户到账仍依已有材料确认。

## 相关知识

## 官方依据
- [Rhino.fi：企业SDA身份、访问与配置](https://docs.rhino.fi/api-integration/smart-deposits.md)
- [Rhino.fi：SDA监控/暂停及支持资产状态](https://docs.rhino.fi/api-reference/sda/depositaddresses/get-deposit-address-status.md)
- [Rhino.fi：SDA历史、阶段与源/目的hash](https://docs.rhino.fi/api-reference/sda/depositaddresses/obtain-a-list-of-previous-activity-for-a-smart-deposit-address.md)
- [Rhino.fi：SDA拒绝、延迟和退款通知](https://docs.rhino.fi/webhook/events-list.md)
- [Rhino.fi：已完成SDA退款的字段与原因](https://docs.rhino.fi/api-reference/sda/depositaddresses/get-completed-sda-refunds.md)
- [Rhino.fi：企业订阅、报价有效期和客户附加费](https://docs.rhino.fi/get-started/fees-and-limits.md)