Hyperliquid 测试网：RPC 端点、水龙头和链设置

Hyperliquid 测试网概览

Hyperliquid 测试网是 Hyperliquid 生态系统的暂存环境。它有两个实用层面：位于 app.hyperliquid-testnet.xyz 的交易应用，你可以在其中针对测试网订单簿下单；以及 HyperEVM 测试网，这是开发者通过标准 JSON-RPC 端点连接的 EVM 兼容链。

如果你的目标是测试交易策略或前端集成，你主要会使用测试网应用及其 API。如果你的目标是部署 Solidity 合约、索引事件或通过 ethers 或 viem 连接钱包，你需要 HyperEVM 测试网链设置和 RPC URL。

• 交易测试网：app.hyperliquid-testnet.xyz，拥有自己的水龙头和 API 接口。
• HyperEVM 测试网：EVM 链，链 ID 998，HYPE 作为原生 gas 代币。
• 水龙头：官方测试网水龙头要求从同一地址进行主网存款。
• RPC：存在公共端点，但可用性和速率限制各不相同；托管提供商是更高负载使用的选项。

用于钱包和应用的 HyperEVM 测试网链设置

当你将 HyperEVM 测试网添加到钱包或配置开发框架时，关键值是链 ID 和原生货币。使用以下设置作为参考，并在依赖它们用于生产工具之前，对照官方 Hyperliquid 文档进行确认。

RPC URL 是最常变化的部分。公共端点便于手动测试，但它们是共享的，可能会限速或未经通知就更改。对于可重复的开发，选择你控制的端点或记录其测试网支持的托管提供商。

从 Hyperliquid 水龙头获取测试网资金

官方 Hyperliquid 测试网水龙头不是通用的“连接并领取”水龙头。根据 Hyperliquid 文档，你需要先使用同一地址在主网存款，然后才能收到用于测试网的模拟 USDC。这种设计将测试网访问与真实主网活动绑定，并防止匿名耗尽水龙头。

如果你使用邮箱登录，钱包提供商可能为主网和测试网生成不同的地址。在这种情况下，从主网导出邮箱钱包，将其导入到浏览器钱包（如 Rabby 或 MetaMask），并将该钱包连接到测试网应用。然后使用从官方测试网应用链接的水龙头页面。

• 在连接钱包之前，确认你在官方测试网应用上。
• 检查你在测试网上使用的地址与在主网存款的地址是否匹配。
• 如果你使用了邮箱登录，导出并导入钱包，使两个环境共享同一地址。
• 领取后，在测试网应用中验证余额，对于 HyperEVM，在钱包的测试网网络视图中验证。

调试路径：为什么你的测试网连接失败

使用 curl 进行快速可达性检查可以将端点问题与应用程序问题分开。将 URL 替换为你正在使用的 HyperEVM 测试网端点：

``bash curl -s -X POST <YOUR_HYPEREVM_TESTNET_RPC_URL> \ -H 'Content-Type: application/json' \ -d '{"jsonrpc":"2.0","id":1,"method":"eth_chainId","params":[]}' ``

如果响应返回 0x3e6，则端点可达并报告链 ID 998。如果返回不同的链 ID，则你指向了错误的网络。如果超时或返回 HTTP 错误，则问题出在端点上。

何时公共测试网端点足够，何时不够

公共测试网端点适用于手动钱包测试、一次性合约部署和学习工具。它们不太适合 CI 流水线、多开发者团队或任何发送突发请求的工作流，因为共享端点可能限速或未经通知就更改。

托管 RPC 提供商为你提供文档化的端点、可预测的访问以及在出现问题时获得支持的途径。专用节点在你需要自定义配置或一致吞吐量时为你提供隔离的基础设施。OnFinality 为支持的网络提供 RPC API 访问和专用节点基础设施；查看支持的 RPC 网络页面了解当前 Hyperliquid 测试网可用性，并参阅 RPC 定价了解计划详情。

从测试网迁移到主网而不出意外

从 Hyperliquid 测试网到主网的过渡主要是配置更改，但故障模式不同。主网有真实资金、不同的 gas 经济和 production 流量模式。在切换之前，在代码和部署过程中明确环境边界。

将链 ID、RPC URL 和水龙头或资金步骤保存在环境变量中，而不是硬编码值。对测试网运行你计划对主网运行的相同合约部署和冒烟测试，并验证你的监控能够区分测试网和主网流量。

• 将链 ID 和 RPC URL 存储在环境变量中，而不是源代码中。
• 在主网推出之前，运行一个在测试网上读取状态并发送交易的冒烟测试。
• 确认钱包网络切换对测试网和主网都有效。
• 审查 gas 假设；测试网成本不能预测主网成本。
• 为 RPC 端点保留回滚计划，以防提供商发生事故。

常见问题

常见问题