Mayan MPS已检测入金却未结算：核来源配置、重试与终止

开始前准备

• 准备已有脱敏MPS quote/入金地址来源、deposit_detected、/source-config、/swaps导出和接收回执，带生成时间；不提供API key。
• 公开文档整理；未申请密钥、调用Quote/MPS/Explorer业务API、RPC或事件连接，也不创建地址、request-index、充值或退款。

1. 固定MPS对象与链ID体系

MPS是入金地址结算服务；/swaps条目是一个钱包某币的settlement request，不保证一条等于一笔消费者付款。普通SDK交换/Explorer clientStatus是另一套状态，不混用。

来源chainId用Wormhole ID：Solana1、Ethereum2、Base30，不是EVM的Ethereum1或Base8453。协议链表支持方向另核；具体扫描自动来源要对照原source-config，不从GET /chains列所有目的/浏览器链推源检测可用。

检查结果：服务、钱包/币结算对象和Wormhole ID明确，方向范围未混用。

• 依据：Mayan MPS：来源配置、金额快照与结算记录 ↗
• 依据：Mayan：Wormhole chain ID与方向支持 ↗

2. 按source-config核资产和最小額单位

source-config.tokens列address、standard、minDeposit和decimals；minDeposit为人读币量，/swaps.amount通常为最小单位字符串或null。核原资产与单位，不能直接把1000000和minDeposit=3比较。

Solana SOL与WSOL是不同项/余额，原生SOL用系统程序地址、WSOL用其mint。低于token minimum或链级USD floor仍可能deposit_detected，但queued:false及ignoredReason=below_token_min/below_min表示未排结算，不等已付款成功。

检查结果：资产标准/地址、精度、最低额及检测/排队结果分开。

• 依据：Mayan MPS：来源配置、金额快照与结算记录 ↗

3. 先看排队标识和重复活动任务

原request-index响应可用queued、queueItemId、reason对应已有任务；already_queued表示该钱包该币已有活动结算，仍会取新的实时余额，不能当新重复订单或缺资产。below_token_min与below_min要分别核原配置。

自动扫描只检测白名单；其他资产需另核已有请求/策略，不由没事件判余额为0。未注册入金地址的404与缺钥匙401/无效403也不是未入账证明；本文不触发补索引。

检查结果：检测、已排/重复活动任务、最小额及访问错误分别记录。

• 依据：Mayan MPS：来源配置、金额快照与结算记录 ↗

4. 重试失败与terminal分开

EVM经deploy/swap，Solana经settle；failed_deploy、failed_swap、failed_settle和deferred均通常category=retrying、terminal=false。deferred代表暂时阻塞，不一定是链交易失败。

completed是success且error:null；dead是terminal失败。自动回退序列5s/15s/30s/45s/1m/5m/15m，7次尝试或非可重试错误可dead；原error.code、retryCount和retryable一起核，不按message文字或“failed”前缀提前认定全流程失败/退款。

检查结果：phase/category/terminal/status与error、retryCount有一致解释。

• 依据：Mayan MPS：phase/category/terminal及重试状态 ↗
• 依据：Mayan MPS：来源配置、金额快照与结算记录 ↗

5. 核实际结算而不把amount快照当到账

/swaps.amount是best-effort快照，request-index结算可能null，执行时实际扫该钱包该币live balance。后续入金可被同一活动任务合并，不能只按快照金额履行单一订单或统计付款笔数。

swapTxHash定位结算交易，不直接替代目标收款资产/地址/最终结果。核destChain/destWallet/destToken及原接收回执。列表默认20最多100，nextCursor为创建时间的ISO游标；只一页或失败读取不证明全量。

检查结果：快照、结算对象、目标及接收证据能关联，列表范围可复原。

• 依据：Mayan MPS：来源配置、金额快照与结算记录 ↗
• 依据：Mayan MPS：phase/category/terminal及重试状态 ↗

6. dead与普通交换退款各自留证

MPS dead只是停止自动转换，不是普通order已经REFUNDED。普通交换按deadline64逾期后可退款；Swift可能先换成USDC/ETH锁定，退回币未必最初输入，退款有refundRelayerFee等费用。

普通Explorer需clientStatus=REFUNDED及接收证据；不得把MPS error或deadline已经过写成退款成功。当前Swift协议费0与旧媒体约3bps不同，实际总成本还含具体路由/relayer/referrer费，未核回执时不算净到账。

检查结果：MPS终止、可退款边界、实际退款币与费用/接收结果分别说明。

• 依据：Mayan：普通交换deadline、退款资产与费用 ↗
• 依据：Mayan：Swift协议费、其他费用及报价口径 ↗
• 依据：Mayan MPS：phase/category/terminal及重试状态 ↗

怎样确认完成

• 留下对象、输入、原回执、计算口径和未验证项；没有资料不补假值，也不操作账户或资金。

常见错误与边界

• 当前MPS方法有据，不声称9月7日推出MPS；媒体速度/旧收费和统计量不做本任务实测或采用证明。