跳到正文
← 使用教程

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发送地址都会影响排查范围,不能用统一自动退款承诺补缺。

本教程根据官方资料整理,尚未完成逐步操作验收。界面、支持范围及费用变化时,先核对官方说明。 纯文本版 · 提交纠错依据