摘要
Sepolia 测试网是以太坊主要的权益证明测试网络。它紧密镜像主网行为,足以在不花费真实 ETH 的情况下部署合约、运行集成测试和演练升级。开发者使用它是因为它稳定、被工具广泛支持,并且与已退役的测试网相比有较长的支持期限。
连接 Sepolia 主要是一项配置工作:你需要一个 RPC 端点、正确的链 ID(11155111)、一个有资金的测试账户以及一个用于验证的区块浏览器。摩擦通常来自选择一个能处理你工作负载的端点、保持测试资金流动,以及调试那些看起来像主网 bug 但实际上是测试网配置问题的故障。
本页为你提供链设置、端点选择的决策指南、请求示例和调试路径。它还解释了当公共端点不够用时,托管 RPC API 或专用节点适合在哪里。
关键要点
- Sepolia 是一个以太坊权益证明测试网,链 ID 为 11155111,原生货币为 SepoliaETH。
- 使用 Sepolia 在主网之前测试合约、升级和集成;测试 ETH 没有真实价值。
- 可靠的 RPC 端点是 Sepolia 测试和 CI 管道的主要运营依赖。
- 公共端点适合手动检查,但自动化或高容量工作负载需要托管或专用端点。
- 大多数 Sepolia 故障是配置问题:错误的链 ID、未注资的账户、过时的 nonce 或不支持所需方法的端点。
- OnFinality 通过其 API 服务和专用节点选项提供 Sepolia RPC 访问;查看网络页面获取当前端点详情。
Sepolia 链设置概览
如果你只需要将 Sepolia 添加到钱包或开发框架,这些是要使用的值。将它们保存在共享配置文件中,以便测试、脚本和钱包设置保持一致。
Sepolia 是一个以太坊测试网,因此 EVM 行为和 JSON-RPC 接口与主网接近。这就是大多数以太坊工具通过简单的网络切换支持它的原因。
- 网络名称:Sepolia
- 链 ID:11155111
- 货币符号:SepoliaETH (ETH)
- 区块浏览器:https://sepolia.etherscan.io
- 共识:权益证明
- RPC 端点:使用你的提供商的 Sepolia URL;OnFinality 端点详情在以太坊 Sepolia 网络页面上
| 标准 | 检查内容 | 为什么重要 |
|---|---|---|
| 链 ID | 11155111 | 错误的链 ID 会将交易发送到错误的网络,或导致钱包和框架错误。 |
| 原生货币 | SepoliaETH (ETH),18 位小数 | Gas 估算和余额显示依赖于正确的货币元数据。 |
| 浏览器 | sepolia.etherscan.io | 你需要它来验证合约和检查失败交易。 |
| RPC 传输 | HTTP 和 WebSocket 支持取决于提供商 | 事件驱动测试和订阅需要 WebSocket;简单的读写通过 HTTP 工作。 |
决策指南:公共端点、托管 RPC 还是专用节点
正确的 Sepolia 设置取决于你运行测试的频率以及你需要多少控制权。单个开发者检查部署可以使用公共端点。每个拉取请求都运行 CI 的团队通常需要更可预测的东西。
使用此表决定哪种选项适合你的工作负载。目标不是选择最强大的选项,而是选择能消除你实际遇到的故障模式的选项。
- 公共端点:适合快速检查和学习;预期共享容量。
- 托管 RPC API:对于希望获得稳定 URL 而无需运行基础设施的团队来说,是不错的默认选择。
- 专用节点:当你需要隔离、归档数据或大量特定方法支持时适用。
| 标准 | 检查内容 | 为什么重要 |
|---|---|---|
| 工作负载 | 手动部署、偶尔运行脚本,还是每次提交都自动 CI | 当许多作业同时运行时,共享公共端点可能会受到速率限制或拥塞。 |
| 方法要求 | 你是否需要大范围的 eth_getLogs、debug_traceTransaction 或 WebSocket 订阅? | 并非每个端点都暴露 trace 或归档方法;缺少方法会导致看起来像合约 bug 的故障。 |
| 数据深度 | 测试是读取历史状态还是仅读取最近区块? | 历史状态查询和某些调试工作流需要归档访问。 |
| 隔离性 | 其他团队的流量是否会影响你的测试运行? | 专用节点隔离吞吐量,这在测试活动时间紧迫时有帮助。 |
| 运营开销 | 你是否想自己运行和升级 Sepolia 节点? | 自托管增加了客户端升级、磁盘管理和监控工作,这些与你的产品无关。 |
从代码连接:curl、viem 和钱包配置
一旦你有了端点,在将其接入框架之前,用简单的 JSON-RPC 调用验证它。链 ID 检查是确认你正在与 Sepolia 而不是主网通信的最快方法。
下面的示例使用你的提供商 URL 的占位符。将其替换为你的 RPC 提供商的 Sepolia 端点;OnFinality 端点详情列在以太坊 Sepolia 网络页面上。
curl -X POST <SEPOLIA_RPC_URL> -H 'Content-Type: application/json' -d '{"jsonrpc":"2.0","method":"eth_chainId","params":[],"id":1}' 应返回 0xaa36a7(十六进制的 11155111)。- 在 viem 中,创建一个 id 为 11155111 和 Sepolia RPC URL 的链对象,然后调用 getBlockNumber 确认连接。
- 在钱包中,添加一个自定义网络,链 ID 为 11155111 和 Sepolia 浏览器 URL,以便合约验证链接正确解析。
- 将端点存储在环境变量中而不是硬编码,以便 CI 和本地开发可以使用不同的提供商。
获取 SepoliaETH 并保持测试资金可用
SepoliaETH 没有货币价值,但你仍然需要它来支付 gas。水龙头分发少量资金,有些需要工作量证明、社交账户或最低主网余额以减少滥用。
对于团队来说,实际问题不是为一个钱包注资,而是保持 CI 账户注资。使用少量专用测试账户,定期充值,并避免跨环境共享密钥。
- 为本地开发、CI 和手动测试使用单独的账户。
- 在测试设置中跟踪余额,并在需要水龙头充值时提前失败并给出清晰消息。
- 不要将已注资测试账户的私钥提交到仓库。
- 如果水龙头不可用,检查 Sepolia 浏览器和社区水龙头列表以寻找替代方案,而不是重用主网密钥。
常见 Sepolia 故障的调试路径
大多数 Sepolia 问题分为几类:错误的网络、缺少资金、过时的 nonce、不支持的 RPC 方法,或因为测试网状态与主网不同而行为不同的合约。在更改合约代码之前,按顺序处理症状。
| 标准 | 检查内容 | 为什么重要 |
|---|---|---|
| 症状 | 可能原因 | 下一步 |
| 交易被拒绝或发送到错误的链 | 钱包或框架链 ID | 确认 11155111 以及 RPC URL 是 Sepolia 端点 |
| gas 资金不足 | 账户余额和水龙头状态 | 为测试账户充值或切换到已注资的 CI 账户 |
| Nonce 太低或替换交易定价过低 | 待处理交易和本地 nonce 缓存 | 等待待处理交易或在工具中重置账户 nonce |
| 方法未找到或不支持 | 端点上 RPC 方法的可用性 | 如果需要,切换到支持 trace、debug 或归档方法的端点 |
| 合约调用返回意外数据 | Sepolia 上的合约地址和部署区块 | 验证你正在读取 Sepolia 部署,而不是主网地址 |
OnFinality 在 Sepolia 工作流中的位置
OnFinality 在许多网络上提供 RPC API 访问和专用节点基础设施,包括以太坊 Sepolia。对于 Sepolia,这意味着你可以将测试和工具指向托管端点,而不是依赖共享公共 URL。
如果你的团队运行频繁的 CI 作业、需要归档或 trace 方法,或在测试活动期间需要隔离容量,在选择计划之前查看以太坊 Sepolia 网络页面和 RPC 定价页面。有关更广泛的提供商评估标准,请参阅 RPC 提供商选择指南。
- 当你想要用于测试和脚本的稳定 URL 时,使用托管 Sepolia 端点。
- 当你需要隔离、归档访问或特定方法支持时,考虑专用节点。
- 检查支持的 RPC 网络以确认当前 Sepolia 可用性和传输详情。
常见问题
Sepolia 测试网用于什么?
Sepolia 用于在主网之前部署和测试智能合约、运行集成测试和演练以太坊升级。它的行为类似于以太坊主网,但使用没有真实价值的测试 ETH。
Sepolia 的链 ID 是什么?
Sepolia 的链 ID 是 11155111。在十六进制 JSON-RPC 响应中,它显示为 0xaa36a7。
如何获取 SepoliaETH?
使用 Sepolia 水龙头。一些水龙头需要工作量证明、社交账户或最低主网余额。对于团队,保持少量专用测试账户注资,而不是依赖一个钱包。
Sepolia 和以太坊主网一样吗?
不。Sepolia 是一个独立的测试网络,有自己的状态和测试 ETH。合约和工具类似,但地址、余额和部署的合约与主网不同。
我可以在 CI 中使用公共 Sepolia RPC 端点吗?
公共端点可以用于轻量使用,但自动化 CI 通常需要更可预测的容量。托管 RPC API 或专用节点通常更适合频繁或并行测试运行。
OnFinality 支持 Sepolia 吗?
OnFinality 提供以太坊 Sepolia 的 RPC 访问。查看以太坊 Sepolia 网络页面以获取当前端点详情和传输支持。