Jumper 搜不到代币：按链、合约地址和路线条件排查
链小知 · 入门 · 核验 · 依官方文档整理
把名字未收录与无流动性、无报价分开，避免把默认列表当全部支持范围。
开始前准备
- 准备要查询的网络、代币合约地址，以及已有搜索结果或无报价提示；合约地址从项目官方资料和对应链记录核对。
- 本教程依据公开文档，当前动态界面未实测；不连接钱包或执行兑换。
1. 先固定网络与合约地址
先核网络和合约地址，再检查符号/名称。LI.FI 官方帮助明确给出 Jumper 的方法：在代币搜索字段输入代币地址；同名资产不能仅靠符号判断身份。
当前公开仓库已经归档、应用入口已转向 jumper.xyz。若页面无法加载或找不到文档所述字段，保留访问/版本问题，不把它判成代币不支持。
检查结果：记录链和地址；页面不可读时结论为未验证。
2. 分别记录名字和地址搜索的结果
默认 /tokens 列表经过有效性、已知列表、垃圾币和价格等筛选；缺少名字结果不证明链上不存在该资产。官方说明按地址会查找链上资产与可用流动性，默认列表收录才使名字在 Jumper 全局可搜。
地址也没有结果时，先复核所选链与合约身份，记录原错误或空结果；未验证的地址搜索不能写成支持所有代币。
当前Token Support页允许 verificationStatus 为 verified、unverified 或 flagged；flagged 可被钱包余额结果省略却仍出现在 /tokens。风险筛选标签不决定路由资格，列表出现也不等于安全背书。
检查结果：名字未收录、地址识别和可用流动性三项分开；空结果不填“已支持”。
3. 把找到资产和获得报价分开
识别代币后仍无报价，应核原记录的来源链、目标链、数量、地址及错误。LI.FI 文档明确：Solana 钱包没有 SOL 会被阻止返回报价，以避免 rent/Gas 失败；此条件不代表代币已下架。
文档也说明缺 USD 价格可能受 maxPriceImpact 过滤。该配置属于集成方 SDK，不据此指导用户放宽 Jumper 风险参数；无具体提示时，资金、价格数据或流动性原因保持待核。
检查结果：资产搜索结果与无报价提示分别有记录；不把 SDK 配置当应用已提供的按钮。
4. 区分局部配置和全局收录
官方区分自有 Widget 的 tokens 配置与 LI.FI/Jumper 全局名单：前者只作用于该集成，后者通过 lifinance/customized-token-list 的收录流程。发现别人 Widget 有某代币，不推断 Jumper 已全局收录。
完成时留下链/地址、名字结果、地址结果、报价条件和待核项。本文只解释资料中的收录路径，没有提交名单申请，也没有以收录替代代币风险检查。
检查结果：缺口归到身份、名单、访问或路线条件；未知项保留。
怎样确认完成
- 形成链/地址、名字列表、地址发现及报价条件的对照。
- 无法访问应用或缺少原错误时标注未验证，而非认定不支持。
常见错误与边界
- 旧帮助页里的支持数量和历史路由参数不是今日全链可用承诺。
- 社区仿冒域名不作为官方入口；应用费率在取得当前官方资料前保持待核。