Rhino.fi入金未激活:核SDA监控、处理阶段与退款
链小知 · 进阶 · 核验 · 依官方文档整理
用原地址状态、历史和退款材料区分入金已见、已接收、目的执行及真实返还,避免把accepted或空列表当最终结论。
开始前准备
- 准备已有脱敏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与目的配置关联,金额单位及支持范围明确。
2. 分开监控、暂停与交易成功
状态方法GET /sda/deposit-addresses/{depositAddress}/{depositChain}中的isActive表示是否监控和处理支持资产,isPaused表示暂停;暂停地址会拒绝入金,两者都不是已到账标志。
概述写7年后不监控,schema写10年,不能据创建年数自行推仍有效。若原状态/时间缺失,记录未知,不能靠再次发送资金或修改地址配置验证。
检查结果:isActive、isPaused及状态时点明确,未由地址存在推已处理。
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分开,缺目的记录不写已激活。
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拒绝通知只监测部分不支持代币,并非任意误转都能检测。若未见通知,不能推出代币支持、零余额或资金已丢失;不靠追加转账补查。
检查结果:拒绝原因、延迟重试与目的完成通知区分,未由缺通知作余额结论。
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有对应材料,缺值和费用边界明确。
6. 核计划费用与最终业务结果
当前费用方法按订阅与可选扩展计,SDA概述还保留PAYG/Legacy说明。已有isSda=true报价用于SDA费用估计,并核expiresAt;不能把普通bridge报价或过期报价当实际SDA净到账。客户surcharge、链成本与企业月费分别记录。
1:1转换需扩展开启,postBridgeData由预定义/获准动作决定。桥EXECUTED或退款完成只证对应阶段,目的vault/card/交易余额仍需各自原业务记录。归档同SDA的支持/监控、处理阶段、目的结果和退款结论,缺项不补成功。
检查结果:得到同SDA的处理及返还对照,费用、扩展资格与最终激活各自有依据或未知。
怎样确认完成
- 已按官方方法整理原SDA监控、历史阶段、目的结果和已完成退款;实际项目资格与原账户到账仍依已有材料确认。
常见错误与边界
- 外层accepted不等内层EXECUTED,isActive/isConfirmed也不等最终目的业务完成。
- 监控7年/10年文档冲突、只监测部分误转与共享CEX发送地址都会影响排查范围,不能用统一自动退款承诺补缺。