摘要
Unichain 是一个基于 OP Stack 构建的以太坊 Layer 2 网络,专为快速且低成本的 DeFi 交易而设计。要与它交互,你需要一个 RPC 端点——可以是用于测试的公共端点,也可以是用于生产工作负载的私有专用端点。本指南涵盖链设置、连接示例以及如何选择合适的基础设施。
快速建议:公共与专用 Unichain 端点
在深入配置之前,请决定哪种端点类型适合你的用例。对于快速原型或黑客松,公共端点就足够了。对于生产 dApp,专用节点可提供可预测的性能,并避免共享基础设施的速率限制。
| 使用场景 | 推荐端点 | 原因 |
|---|---|---|
| 在 Sepolia 上测试 | 公共测试网端点 | 免费、低流量、易于设置 |
| 轻流量的主网 dApp | 公共主网端点 | 简单、无成本,但共享 |
| 高流量的生产 dApp | 专用节点 | 一致的性能,无嘈杂邻居 |
| 索引或分析 | 专用归档节点 | 访问历史状态 |
如果你需要专用节点,请查看 Unichain 网络页面 了解可用性和配置选项。有关定价详情,请参阅 RPC 定价。
什么是 Unichain,为什么端点很重要?
Unichain 是一个基于 OP Stack 构建的以太坊 Layer 2 网络,由 Uniswap Labs 推出,旨在为 DeFi 应用提供快速、低成本的交易。它使用乐观卷叠来扩展以太坊,专注于提高流动性和交易效率。
端点是你的应用程序用来向网络发送 JSON-RPC 请求的 URL。它是读取区块链数据、提交交易以及与智能合约交互的门户。选择合适的端点会影响延迟、可靠性和成本。
Unichain 链设置一览
以下是配置钱包或 dApp 所需的关键网络参数:
| 参数 | 值 |
|---|---|
| 网络名称 | Unichain |
| 链 ID | 130 |
| 原生货币 | ETH(以太币) |
| 区块浏览器 | https://uniscan.xyz |
| 公共 RPC URL | https://unichain.api.onfinality.io/public |
对于 Sepolia 测试网,使用链 ID 1301 和浏览器 https://unichain-sepolia.blockscout.com。
如何连接到 Unichain:钱包和 dApp 配置
将 Unichain 添加到 MetaMask
- 打开 MetaMask 并点击网络下拉菜单。
- 点击“添加网络”并输入上表中的详细信息。
- 保存并切换到 Unichain 网络。
使用 ethers.js (v6)
import { ethers } from 'ethers';
const provider = new ethers.JsonRpcProvider('https://unichain.api.onfinality.io/public');
// 获取最新区块号
const blockNumber = await provider.getBlockNumber();
console.log('最新区块:', blockNumber);
使用 viem
import { createPublicClient, http } from 'viem';
const client = createPublicClient({
chain: {
id: 130,
name: 'Unichain',
nativeCurrency: { name: 'Ether', symbol: 'ETH', decimals: 18 },
rpcUrls: { default: { http: ['https://unichain.api.onfinality.io/public'] } },
},
transport: http(),
});
const blockNumber = await client.getBlockNumber();
console.log('最新区块:', blockNumber);
JSON-RPC 方法和示例
Unichain 支持标准的以太坊 JSON-RPC 方法。以下是一个获取最新区块的 curl 示例:
curl -X POST https://unichain.api.onfinality.io/public \
-H "Content-Type: application/json" \
-d '{"jsonrpc":"2.0","method":"eth_blockNumber","params":[],"id":1}'
预期响应:
{"jsonrpc":"2.0","id":1,"result":"0x1a2b3c"}
其他常见方法包括 eth_getBalance、eth_call、eth_sendRawTransaction 和 eth_getLogs。有关完整列表,请参阅以太坊 JSON-RPC 规范。
调试常见连接问题
如果连接遇到问题,请检查这些常见陷阱:
| 症状 | 可能原因 | 修复 |
|---|---|---|
| 连接超时 | 网络防火墙或 URL 错误 | 验证 URL 并检查防火墙设置 |
| 无效的链 ID | 钱包配置了错误的链 ID | 主网使用 130,Sepolia 使用 1301 |
| 超出速率限制 | 对公共端点的请求过多 | 切换到专用节点或实现缓存 |
| 交易未打包 | Gas 不足或 nonce 问题 | 检查 gas 价格和 nonce |
何时迁移到专用 Unichain 节点
公共端点很方便,但它们是共享的。如果你的应用遇到以下任何情况,请考虑使用专用节点:
- 高请求量导致速率限制
- 需要一致的低延迟
- 需要归档数据或 trace 方法
- 合规或安全需求需要私有基础设施
OnFinality 为 Unichain 提供专用节点,为你提供具有专用资源的私有端点。访问 Unichain 网络页面 了解更多信息。
关键要点
- Unichain 是一个基于 OP Stack 的以太坊 L2,链 ID 为 130。
- 使用公共端点
https://unichain.api.onfinality.io/public进行测试和轻量使用。 - 对于生产环境,评估专用节点以避免速率限制并确保性能。
- 始终验证链设置,并使用正确的主网与测试网端点。
常见问题解答
什么是 Unichain RPC 端点?
公共 RPC 端点是 https://unichain.api.onfinality.io/public。对于 Sepolia 测试网,使用 https://unichain-sepolia.api.onfinality.io/public。
Unichain 是以太坊 Layer 2 吗?
是的,Unichain 是一个基于 OP Stack 构建的以太坊 Layer 2 网络,专为快速且低成本的 DeFi 交易而设计。
如何获得专用的 Unichain 端点?
你可以通过 OnFinality 配置专用节点。访问 Unichain 网络页面 了解详情。
Unichain 的链 ID 是什么?
主网的链 ID 是 130,Sepolia 测试网是 1301。
我可以将公共端点用于生产环境吗?
对于轻量使用是可以的,但对于生产工作负载,建议使用专用节点以避免速率限制并确保可靠性。
有关支持网络的更多信息,请参阅 支持的网络页面。