摘要
NEAR Intents 浏览器是一个只读仪表盘，用于展示基于 intent 的跨链活动。它显示聚合交易量、近期兑换、推荐和联盟排行榜，以及可搜索的单个 intent 信息流，包含发送方、接收方、资产、状态和时间戳。它适用于验证跨链兑换是否已结算、审计 solver 行为，或构建 intent 流的监控视图。
如果你需要在自己的工具中获取相同数据，浏览器并不是集成接口。你通过浏览器的只读 API 查询 intent 历史，并通过 NEAR RPC 端点查询底层 NEAR 链状态。这是两项不同的工作：浏览器 API 回答“这个 intent 发生了什么”，而 RPC 回答“该账户、区块或交易的当前链上状态是什么”。
本页将两者区分开来，以便你选择正确的数据源，避免基于一个从未打算作为后端的 UI 进行构建，并保持你自己的索引器或仪表盘可靠。对于运行生产 NEAR 工作负载的团队，OnFinality 提供 NEAR RPC API 访问和专用节点基础设施，并支持许多其他网络。
关键要点
- NEAR Intents 浏览器是 intent 活动的只读视图：交易量、兑换、推荐、联盟以及每个 intent 的状态。
- 浏览器 UI 和浏览器 API 用途不同；两者都不能替代 NEAR RPC 端点来获取链状态。
- 使用浏览器 API 获取历史 intent 记录，使用 NEAR RPC 获取账户、区块和交易状态。
- processing 和 success 等 intent 状态值描述的是结算进度，而不是目标链的最终性。
- 对于生产监控，将只读 intent 数据源与可靠的 NEAR RPC 提供商以及你自己的告警机制配合使用。
- OnFinality 提供 NEAR RPC API 访问和专用节点选项；请查看支持的网络页面了解当前覆盖范围。
NEAR Intents 浏览器实际展示的内容
NEAR Intents 浏览器是一个基于 intent 的跨链活动仪表盘。其主要面板包括聚合交易量（全部时间、24 小时、7 天、30 天）、顶级兑换列表、推荐和联盟排行榜，以及单个 intent 的实时信息流。每个 intent 行通常显示资产和数量、发送方和接收方地址、路由或推荐来源、状态标签以及相对时间戳。
这使它成为一个验证和可观测性工具，而不是交易终端，也不是链浏览器。它回答诸如：这笔跨链兑换是否已结算、哪个 solver 或推荐路由了它、以及某段时间内流过了多少交易量。它不能替代通用 NEAR 区块浏览器来查询账户余额、合约状态或原始交易收据。
- 全部时间、24 小时、7 天和 30 天的聚合交易量面板
- 过去 24 小时内按名义规模排名的顶级兑换
- 按交易数量和交易量排名的推荐和联盟排行榜
- 每个 intent 的信息流，包含资产、数量、发送方、接收方、状态和时间戳
- 按钱包地址、存款地址或交易哈希搜索
浏览器 UI、浏览器 API 还是 NEAR RPC：选择正确的数据源
围绕 NEAR Intents 浏览器的大多数困惑来自将三种不同的数据源视为可互换。它们并非如此。浏览器 UI 面向人类。浏览器 API 是用于 intent 记录的只读历史接口。NEAR RPC 端点是用于账户、区块和交易状态的链接口。选择错误的数据源会导致脆弱的爬虫或数据缺失。
一个实用规则：如果问题涉及 intent 的生命周期和路由，从浏览器 API 开始。如果问题涉及链上状态，例如账户余额、合约调用结果或区块高度，使用 NEAR RPC。如果你需要在一个产品中同时使用两者，你将运行两条数据路径并在自己的后端中连接它们。
| 标准 | 检查内容 | 为什么重要 |
|---|---|---|
| 浏览器 UI | 人类可读的仪表盘、搜索框、状态标签 | 适合手动验证，但不是稳定的集成接口，也不是为自动轮询设计的。 |
| 浏览器 API | 用于 intent 和交易状态的只读历史端点 | 最适合仪表盘、对账任务和 intent 流分析，无需抓取 UI。 |
| NEAR RPC | 用于账户、区块、交易和合约调用的 JSON-RPC 方法 | 当你需要当前链状态或必须确认结算的链上效果时必需。 |
| 你自己的索引器 | 存储、重试以及 intent 记录与链状态之间的连接 | 生产监控通常需要持久副本，以免依赖单一实时数据源。 |
决策指南：哪种数据源适合你的工作负载
在编写代码之前使用这个简短指南。它可以防止常见错误：基于一个会无预警变化的 UI 构建后端，或者为了历史 API 已返回的数据而频繁请求 RPC 端点。
- 手动验证单笔兑换：使用浏览器 UI 按地址或交易哈希搜索。
- 构建 intent 交易量和状态仪表盘：使用浏览器 API 并缓存结果。
- 检查账户余额或合约状态：使用 NEAR RPC，而不是浏览器。
- 跨链对账结算：将浏览器 API 的 intent 记录与目标链 RPC 读取连接起来。
- 对卡住的 intent 运行告警：按计划轮询浏览器 API 并存储状态转换。
- 需要可预测的高吞吐量读取：使用托管或专用 NEAR RPC 端点，而不是共享公共端点。
无需抓取 UI 即可查询 intent 数据
浏览器暴露了一个只读 API，用于历史 intent 和交易状态数据。将其视为具有自身速率限制、分页和模式的数据源，并在依赖字段名称之前阅读其文档。下面的模式展示了典型请求的结构；请将路径和参数替换为你所调用 API 文档中记录的路径和参数。
将请求逻辑放在一个适配器模块中，以便模式变化被限制在局部。将原始响应与规范化记录一起存储，以便以后可以重放或重新推导字段。
- 显式分页并记录你上次使用的游标或页面令牌。
- 将非 200 响应和空结果集视为正常状态，而不是异常。
- 在规范化之前持久化原始负载，以便模式变化可恢复。
- 记录每次轮询的请求 ID 或时间戳，以便事件审查更容易。
使用 JSON-RPC 读取 NEAR 链状态
当你需要确认链上状态时，调用 NEAR RPC 端点。下面的示例使用区块查询的标准 JSON-RPC 结构。使用你的 RPC 提供商提供的端点 URL；对于 OnFinality，请查看 NEAR 网络页面获取当前端点，而不是硬编码共享公共 URL。
在代码中将链读取与 intent 读取分开。一个常见的生产模式是：intent 轮询器写入队列，链读取器为每个排队项解析链上引用。
- 使用区块或分块方法确认引用的区块存在。
- 使用账户和视图方法读取余额和合约状态。
- 设置显式超时，并在瞬时错误时使用退避重试。
- 不要假设 intent 状态成功就意味着目标链已最终确定；在重要时请在目标链上验证。
监控 intent 时可能遇到的故障模式
Intent 监控会以可预测的方式失败。下表将症状映射到可能原因和下一步调试步骤，以便你无需猜测即可分类处理。
| 标准 | 检查内容 | 为什么重要 |
|---|---|---|
| Intent 卡在 processing | Solver 可用性、目标链拥堵以及 intent 的路由 | Processing 是结算状态，不是错误；在升级之前检查目标链。 |
| 浏览器 API 对已知哈希返回空 | 分页、时间窗口以及该哈希是存款哈希还是目标哈希 | 不同的标识符解析到不同的记录；搜索错误的标识符看起来像数据缺失。 |
| 轮询期间 RPC 超时 | 请求速率、端点健康状况和重试配置 | |
| 浏览器和你的仪表盘之间状态不一致 | 轮询间隔、缓存状态和规范化逻辑 | 过时缓存和字段映射不匹配是常见原因，而不是底层数据。 |
| 交易量总计与你自己的总和不同 | 资产定价来源、时间窗口边界和包含规则 | 聚合面板可能使用与原始 intent 总和不同的定价或过滤。 |
发布 intent 监控之前的生产检查清单
在将 intent 监控呈现给用户之前，确认运营基础事项。这些项目检查成本低，但在生产中发现问题的代价很高。
- 你显示的每个字段都有文档化的数据源。
- Intent 记录和链读取分开存储，并在你的后端中连接。
- 轮询间隔遵守浏览器 API 和你的 RPC 提供商的限制。
- 你对卡住的 intent 和 RPC 错误率设置了告警。
- 你有备用 RPC 端点或托管提供商用于故障转移。
- 你已查看 RPC 定价，以免轮询量让你措手不及。
- 在发布前，你已检查支持的 RPC 网络以了解当前 NEAR 覆盖范围。
常见问题
NEAR Intents 浏览器与 NEAR 区块浏览器相同吗？
不相同。NEAR Intents 浏览器专注于基于 intent 的跨链活动，例如兑换、推荐和结算状态。NEAR 区块浏览器显示通用链数据，例如区块、账户和合约调用。当你需要将 intent 与其链上效果对账时，两者都需要使用。
我可以使用浏览器 API 而不是运行 NEAR 节点吗？
仅适用于历史 intent 数据。浏览器 API 是只读的，范围限于 intent 记录。如果你需要当前账户状态、合约调用或区块数据，你需要 NEAR RPC 端点，可以是自托管或来自托管提供商。
为什么一个 intent 长时间显示为 processing？
Processing 通常意味着 intent 已提交但结算尚未完成。检查 solver 可用性、目标链拥堵和路由。如果持续存在，请直接验证目标链，而不是仅依赖状态标签。
如何搜索特定的 intent？
使用浏览器搜索，输入钱包地址、存款地址或交易哈希。请注意，存款和目标标识符可能解析到不同的记录，因此如果第一次搜索没有结果，请尝试两者。
OnFinality 提供 NEAR RPC 访问吗？
OnFinality 在许多网络上提供 RPC API 访问和专用节点基础设施。请查看支持的 RPC 网络页面了解当前 NEAR 覆盖范围和端点详情，并查看基于请求的套餐的 RPC 定价。
Ethereum
Solana
Polygon
Base
Arbitrum
BNB链
Polkadot
Optimism
