Logo
新用户订阅 RPC,首月享 6.5 折优惠查看优惠
OnFinality Learn
网络与协议指南阅读约 9 分钟

Sepolia Scan:使用区块浏览器和 RPC 读取测试网数据

一份实用指南,介绍如何使用区块浏览器、RPC 调用和可复现的验证方法来扫描 Sepolia 交易、区块和合约。

TL;DR

Sepolia scan 指的是查询测试网活动——交易、区块、地址、代币和合约状态——可以通过区块浏览器或直接通过 RPC 端点进行。区块浏览器提供人类可读的视图,而 RPC 则提供对相同底层链数据的程序化、可验证访问。本文解释了 Sepolia 扫描的工作原理,如何使用 curl 和 JavaScript 复现区块浏览器的结果,如何验证部署或失败的交易,以及如何排查区块浏览器显示内容与应用程序所见内容之间的不一致。

Sepolia scan 实际检索的内容

Sepolia 是以太坊的公共权益证明测试网。Sepolia scan 是对链上测试网数据的任何查询:交易哈希、区块号、地址余额、代币转账或合约存储。无论您是在基于浏览器的区块浏览器中查看,还是通过 RPC 调用获取,数据都是相同的——两者都从已索引或同步链的 Sepolia 节点读取。

重要的区别在于索引视图和原始节点视图。Etherscan、Blockscout 和 Arbiscan 风格的界面等区块浏览器维护数据库,用于解码日志、标记地址和聚合统计数据。原始 RPC 返回规范链数据:区块、收据、跟踪和状态。当区块浏览器和您的应用程序不一致时,RPC 响应通常是节点接受内容的真实来源。

  • 交易查询:状态、使用的 gas、日志和回滚原因。
  • 区块查询:时间戳、基础费用、交易数量和验证者。
  • 地址查询:余额、nonce 和合约字节码。
  • 代币和日志查询:ERC-20 转账和事件解码。

假设和前提条件

本指南假设您拥有来自提供商或自己节点的 Sepolia RPC URL、要检查的钱包地址或交易哈希,以及基本的 JSON-RPC 知识。只读扫描不需要主网 ETH,但发送测试交易需要 Sepolia ETH。水龙头分发少量资金,通常有每日限制或主网活动要求。

如果您是在选择端点而不是运行节点,具体的提供商决策应放在 RPC Assistant 中,而不是这里。有关端点选项的更广泛比较,请参阅 Ethereum RPC API 指南 和 多链 RPC 端点指南。

区块浏览器和 RPC 在显示内容上的差异

区块浏览器是一个索引层。它监听新区块,解码交易和日志,并存储派生数据,如代币余额和合约标签。这使得它对人类来说很快,但依赖于索引器的同步状态。原始 RPC 端点根据节点当前对链的视图进行回答,根据节点的同步模式,可能会滞后一两个区块。

这在调试期间很重要。一笔交易可能在钱包中显示为待处理,在区块浏览器中显示为已确认,但仍然从尚未导入该区块的 RPC 节点返回空收据。始终比较同类数据:在得出数据缺失的结论之前,检查区块浏览器中的区块号与您的 RPC 报告的区块号是否一致。

  • 区块浏览器:解码、标记和聚合;对人类有用。
  • RPC:规范且程序化;对自动化和验证有用。
  • 索引器延迟:区块浏览器可能落后链头几秒钟。
  • 节点延迟:如果您的 RPC 正在追赶,它可能落后于链头。

使用 curl 扫描交易

最直接的 Sepolia scan 是交易收据查询。将 RPC_URL 替换为您的端点,将 TX_HASH 替换为您要检查的哈希。收据告诉您交易是否成功、使用了多少 gas 以及发出了哪些日志。

curl -s RPC_URL \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "eth_getTransactionReceipt",
    "params": ["TX_HASH"]
  }'

对照链头验证结果

仅凭收据无法判断节点是否最新。获取最新区块号,并与收据中的区块号进行比较。如果收据区块与链头相差几个区块以内,则扫描是新鲜的。如果链头远远落后于公共区块浏览器,您的端点可能正在同步或受到速率限制。

以短暂延迟运行同一请求两次,并记录区块号。健康的端点会在调用之间推进其链头。停滞的端点会重复返回相同的区块号。

curl -s RPC_URL \
  -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"eth_blockNumber","params":[]}'

使用 JavaScript 扫描地址活动

对于地址级扫描,您需要余额、nonce 和合约字节码。nonce 尤其有用:它告诉您该地址已发送多少笔交易,这有助于区分卡住的交易和新交易。以下脚本使用 fetch,适用于 Node.js 18 或更高版本。

const RPC_URL = process.env.RPC_URL;
const ADDRESS = process.env.ADDRESS;

async function rpc(method, params) {
  const res = await fetch(RPC_URL, {
    method: 'POST',
    headers: { 'Content-Type': 'application/json' },
    body: JSON.stringify({ jsonrpc: '2.0', id: 1, method, params })
  });
  const json = await res.json();
  if (json.error) throw new Error(json.error.message);
  return json.result;
}

const [balance, nonce, code] = await Promise.all([
  rpc('eth_getBalance', [ADDRESS, 'latest']),
  rpc('eth_getTransactionCount', [ADDRESS, 'latest']),
  rpc('eth_getCode', [ADDRESS, 'latest'])
]);

console.log({ balance, nonce, isContract: code !== '0x' });

扫描延迟的可复现测量程序

如果您想比较端点而不仅仅是读取数据,请测量从发送交易到看到确认收据的时间。不要编造数字;运行程序并记录您自己的数据。使用新钱包、固定 gas 价格,并为每个端点使用相同的交易负载。

在表格中记录以下内容:端点标签、发送时间戳、首次看到待处理的时间戳、确认时间戳、区块号和收据状态。每个端点至少重复十次,并报告中位数和最大值。这将网络差异与端点行为区分开来。

  • 使用具有已知 nonce 序列的专用测试钱包。
  • 向每个端点发送相同的值和数据负载。
  • 以 UTC 记录时间戳,并包含区块号。
  • 丢弃交易被替换或丢弃的运行。

排查常见的 Sepolia scan 不一致问题

最常见的不一致是交易在区块浏览器中显示为已确认,但从您的 RPC 返回 null。这通常意味着您的节点尚未导入该区块,或者您查询了不同的网络。使用 eth_chainId 确认链 ID,并与区块浏览器的网络标签进行比较。

第二个常见问题是失败交易没有可见原因。收据包含状态字段,但不总是包含回滚字符串。在失败的区块上使用 eth_call 重放调用并显示回滚原因,或者如果您的提供商支持 debug_traceTransaction,则检查交易跟踪。

  • 空收据:检查链 ID、区块号和节点同步状态。
  • 回滚交易:在同一区块使用 eth_call 重放。
  • 缺少日志:确认交易确实发出了事件。
  • 余额错误:记住 pending 和 latest 是不同的标签。

基于区块浏览器扫描的局限性

区块浏览器很方便,但对自动化来说并非权威。它们可能滞后、限速,或与您的应用程序以不同方式解码合约。它们也无法回答有关待处理状态或模拟未来调用的问题。对于生产工作流,将区块浏览器视为调试辅助工具,将 RPC 视为集成接口。

Sepolia 本身是一个测试网。其状态可能被操作员重置或修剪,水龙头的可用性也会变化。不要构建假设 Sepolia 历史是永久的监控。对于生产级节点访问,在确定架构之前,请查看 专用节点选项 和 RPC 定价。

可靠 Sepolia 工作流的后续步骤

一旦您能够扫描交易并验证链头,就可以转向自动化检查:使用退避轮询收据,在每次写入前断言链 ID,并将区块号与结果一起记录。如果您需要具体的端点推荐,请使用 RPC Assistant。有关网络级上下文,请浏览 支持的网路 和 API 服务概述。

  • 在脚本中添加链 ID 和区块号断言。
  • 仅在可配置的确认深度后缓存收据。
  • 将读密集型扫描路由到具有足够速率限制的端点。
  • 为扫描失败保留一个备用端点。

永远不用担心基础设施

OnFinality 消除了 DevOps 的繁重工作,让您能够更聪明、更快地构建。

开始