FluxRPC 查不到交易：区分 Solana 近期缓存、历史范围与执行失败
链小知 · 进阶 · 核验 · 依官方文档整理
按既有请求核对 signature、网络、commitment 和历史范围，把 null、RPC error 与交易 meta.err 分开。
开始前准备
- 准备公开交易 signature、期望的网络/时间、已有脱敏请求与原响应；key 已遮盖。
- 没有真实记录时只整理字段和待补项，文档示例不是实际交易查询；不创建账户或调用付费接口。
1. 先锁定网络和数据时段
核对已用主机：Solana 示例为 eu.fluxrpc.com，Fogo 示例为 eu.fogo.fluxrpc.com。key 参数和 Authorization 原值均须遮盖。当前说明把 Solana 限于近期数据，Fogo Mainnet 则有历史支持；记录交易所在网络和大致时间，不将同样的 base58 字符串或厂商多链能力当作历史查询承诺。
检查结果：网络、方法、时间和认证位置明确，Fogo 历史能力未被套用到 Solana。
2. 复核 getTransaction 请求和版本配置
params 首项是交易 signature，不是账户公钥；配置对象保存 commitment、encoding 与 maxSupportedTransactionVersion 原值。Flux 示例填版本 1，Solana 官方示例填 0：它们是客户端愿意解析的最高版本配置，不能不看解析器能力就照抄。请求 ID 与返回 ID 要匹配，HTTP/JSON-RPC error 不得替换成 result=null。
检查结果：signature、配置、ID 和错误正文齐全，版本值与实际解析器能力一致。
3. 分开缓存错误和 null 的多种原因
Flux 的 Solana 专节明确：未命中返回 error.code=-32017、缓存不可用的 message，以及 error.data.oldestSlot。保留这三个字段和读取时间，不能把该错误填成 result=null；oldestSlot 也不是区块高度。Fogo Mainnet 专节才明确未找到返回 null。通用 Solana 方法的 null 还可表示未找到或未达到所请求的 commitment；非 null 结果再分别看 slot、blockTime、meta 与 meta.err，meta/blockTime 缺失保持未知。单次缓存未命中或 null 都不能直接证明全网交易不存在、未广播或执行失败。
检查结果：-32017/message/oldestSlot、null、确认条件不足和已观察执行错误分别记录。
4. 按输入顺序核对状态缓存
查看已有 getSignatureStatuses 记录，signatures 最多 256 项，config 中 searchTransactionHistory 是否明确设置。未开启历史搜索时，官方说明仅查询近期状态缓存；开启也不保证提供方持有全部历史。逐个按输入索引读 result.value，并保存 result.context.slot；页面参数表概括为数组不能覆盖实际 context/value 结构。confirmationStatus、err 与 confirmations 分开，finalized 情形 confirmations=null 不等于执行失败。
检查结果：每个 signature 与对应 value 原样对齐，缓存与历史搜索设置可追溯。
5. 用最早可查 slot 整理后续清单
若已有 getFirstAvailableBlock 记录，保存返回的最早可用 slot 及读取时间。Flux 说明 Solana/Fogo Testnet 返回缓存最早 slot，Fogo Mainnet 使用其历史数据；slot 不是区块高度，早于该边界只能表明本服务当时缺相应范围。输出成功结果、null、错误与未获范围记录的清单；另一个已授权历史服务的后续对照也需要自己的证据，不能把换 URL 写成已经找回交易。
检查结果：结论限定为本网络、本端点和本次记录，没有推断全网不存在。
怎样确认完成
- 形成 signature 与网络/时间/commitment/响应的对应表，并指出仍缺哪些历史或状态证据。
- 本教程为官方文档核验，未使用 key 查询真实交易。
常见错误与边界
- 请求错误、result=null、meta=null 和 meta.err 非 null 是不同状态。
- 开启 searchTransactionHistory 不会替服务生成缺失历史。
- 文档示例不是当前链上交易或账户权限的实测。