摘要
Hyperliquid EVM（通常称为 HyperEVM）是作为 Hyperliquid 区块链一部分运行的 EVM 执行层。Hyperliquid 的完整执行状态，包括 HyperCore（订单簿和交易引擎）和 HyperEVM，均由 HyperBFT 共识保障安全。HyperEVM 在 Hyperliquid 的执行环境内产生 EVM 区块，因此 Solidity 合约、标准 JSON-RPC 工具和熟悉的 EVM 钱包都可以与之交互，而原生 gas 代币是 HYPE。
如果你搜索了“hyperliquid evm”，你很可能想了解 Hyperliquid 的 EVM 侧究竟是什么、它与 HyperCore 有何不同，以及如何将钱包、dApp 或后端连接到它。简而言之：HyperEVM 是一个标准的 EVM 接口，具有 JSON-RPC 端点和链 ID，但它继承了 Hyperliquid 特有的行为，例如以 HYPE 作为 gas、优先费被销毁，以及公共端点不支持 WebSocket JSON-RPC。
本页首先回答连接相关问题，然后介绍链设置、容易让开发者踩坑的差异，以及如何为生产工作负载选择 RPC 配置。如需托管访问，OnFinality 在受支持的网络中提供 RPC API 和专用节点基础设施；请查看支持的 RPC 网络和 RPC 定价页面了解当前可用性。
关键要点
- Hyperliquid EVM 也称为 HyperEVM；它是 Hyperliquid 区块链内的 EVM 执行层，与 HyperCore 一同由 HyperBFT 保障安全。
- HyperEVM 主网使用链 ID 999，原生 gas 代币为 HYPE，精度为 18 位小数。
- HyperEVM 遵循 Cancun 硬分叉但不支持 blobs，并启用了 EIP-1559；基础费和优先费均被销毁。
- 公共 Hyperliquid JSON-RPC 端点不提供 WebSocket JSON-RPC，因此实时设计需要轮询或支持订阅的提供商。
- HYPE 通过向指定地址进行原生转账在 HyperCore 和 HyperEVM 之间转移，而非通过桥合约。
- 对于生产流量，应评估 RPC 提供商的归档深度、速率限制、故障转移，以及是否支持你的应用所调用的方法。
Hyperliquid EVM 究竟是什么
Hyperliquid 是一条专门构建的区块链，其执行状态包含两个层面：HyperCore，负责订单簿、交易和清算；以及 HyperEVM，即 EVM 兼容执行层。两者均由 HyperBFT 共识保障安全，因此 HyperEVM 并非通过桥接接入 Hyperliquid 的独立链；它是同一执行环境的一部分。
对开发者而言，这意味着 HyperEVM 在合约部署和 JSON-RPC 调用方面表现得像一条 EVM 链，但它继承了 Hyperliquid 特有的规则。HYPE 是原生 gas 代币，EVM 使用 Cancun 硬分叉但不支持 blobs。EIP-1559 已启用，与大多数 EVM 链不同，优先费也会被销毁，因为排序由 HyperBFT 处理。
实际结果是，标准 EVM 工具大多可用，但你应根据网络实际情况验证费用行为、区块生产和方 法支持，而不是假设以太坊主网的默认值。
- HyperEVM 是 Hyperliquid 内部的 EVM 执行层，而非独立链。
- HyperCore 和 HyperEVM 共享 HyperBFT 共识和 HYPE 代币。
- 所有 EVM 交互均通过 JSON-RPC 进行，包括钱包网络设置。
链设置一览
大多数连接问题源于混淆主网和测试网的值，或假设公共端点支持它并不支持的功能。在调试应用代码之前，请先确认以下内容。
以下数值反映 Hyperliquid 已发布的开发者文档。上线前务必重新核对官方文档，因为链参数可能发生变化。
| 标准 | 检查内容 | 为什么重要 |
|---|---|---|
| 主网链 ID | 999 | 钱包和库会拒绝为错误链签名的交易。 |
| 测试网链 ID | 998 | 防止测试期间意外部署到主网。 |
| 原生 gas 代币 | HYPE，主网和测试网均为 18 位小数 | 费用估算和余额显示依赖正确的小数位数。 |
| 公共 JSON-RPC（主网） | https://rpc.hyperliquid.xyz/evm | 适合快速检查；不能替代生产环境中的托管提供商。 |
| 公共 JSON-RPC（测试网） | https://rpc.hyperliquid-testnet.xyz/evm | 测试网端点必须与测试网链 ID 匹配。 |
| WebSocket JSON-RPC | 公共端点不支持 | 基于订阅的设计需要轮询或提供 WebSocket 支持的提供商。 |
| 硬分叉和费用模型 | Cancun 不支持 blobs；EIP-1559，基础费和优先费均被销毁 | 影响 gas 估算、费用显示，以及任何假设优先费归验证者的逻辑。 |
如何连接钱包或 dApp
将 HyperEVM 添加到钱包的流程与任何 EVM 网络相同：提供 RPC URL、链 ID 和货币符号。下面的代码片段展示了一个典型的 wallet_addEthereumChain 请求。如果你不使用公共端点，请将 RPC URL 替换为你的提供商的端点。
如果你正在构建 dApp，请使用相同的链 ID 和 RPC URL 配置你的库。一个常见错误是钱包指向主网，而应用的提供商指向测试网，这会产生令人困惑的签名和 nonce 错误。
- 钱包网络名称：HyperEVM（或 Hyperliquid EVM）。
- 货币符号：HYPE。
- 区块浏览器：使用官方 HyperEVM 浏览器查询交易。
- 将主网和测试网配置保存在单独的环境变量中。
快速建议：公共端点还是托管 RPC？
公共 Hyperliquid 端点适合探索、钱包设置和低流量脚本。它并非为生产流量设计，也不提供 WebSocket JSON-RPC，这排除了仅依赖该端点的基于订阅的设计。
当你需要可预测的速率限制、用于历史查询的归档访问、跨区域故障转移或 WebSocket 支持时，应迁移到托管 RPC 提供商。OnFinality 在受支持的网络中提供 RPC API 访问和专用节点；在确定架构之前，请在支持的 RPC 网络页面确认当前 Hyperliquid 可用性。
如果你仍在比较提供商，RPC 提供商选择指南更深入地介绍了评估标准。
| 标准 | 检查内容 | 为什么重要 |
|---|---|---|
| 原型或钱包设置 | 公共端点已足够 | 流量低且无正常运行时间要求。 |
| 带重试的生产 dApp | 具有速率限制和故障转移的托管 RPC | 公共端点在负载下可能限流或丢弃请求。 |
| 历史或归档查询 | 提供商归档深度 | 并非所有 RPC 节点都保留完整状态历史。 |
| 实时订阅 | WebSocket 支持 | 公共端点不提供 WebSocket JSON-RPC。 |
| 隔离容量 | 专用节点选项 | 当共享 RPC 吞吐量不足时有用。 |
HyperEVM 与 HyperCore：对你的代码有何影响
HyperCore 是交易引擎：下单、撤单和清算都在那里进行。HyperEVM 是用于合约和标准 JSON-RPC 调用的通用 EVM 接口。它们共享共识和 HYPE 代币，但并非同一 API 接口。
如果你的应用需要订单簿数据或交易操作，你很可能在使用 HyperCore API 而非 EVM JSON-RPC。如果你在部署 Solidity 合约、读取余额或索引 EVM 事件，你就在 HyperEVM 一侧。混淆这两种思维模型是开发者首次集成时常见的困惑来源。
在两个层面之间转移 HYPE 使用向指定地址进行原生转账，而非桥合约。在实现转账之前，请查阅官方文档了解当前地址和说明。
- HyperCore：订单簿、交易、清算。
- HyperEVM：EVM 合约、JSON-RPC、标准钱包流程。
- 两者之间的 HYPE 转移使用原生转账机制，而非第三方桥。
HyperEVM 上可能遇到的故障模式
大多数 HyperEVM 集成问题可归为几类。下表将症状映射到可能原因，以便你更快调试。
如果你使用托管提供商，在更改应用代码之前，还应检查提供商的状态页面和请求日志。
| 标准 | 检查内容 | 为什么重要 |
|---|---|---|
| 交易因链 ID 不匹配被拒绝 | 钱包和提供商均设置为 999（主网）或 998（测试网） | 混合配置是最常见的设置错误。 |
| WebSocket 连接失败 | 公共端点不支持 WebSocket JSON-RPC | 改用轮询或支持订阅的提供商。 |
| gas 估算与以太坊不同 | EIP-1559 且优先费被销毁 | 从以太坊复制的费用逻辑可能误报成本。 |
| 历史状态查询返回空 | 你的 RPC 端点的归档支持 | 非归档节点会修剪较旧的状态。 |
| 负载下间歇性超时 | 速率限制和重试策略 | 公共端点是共享的，并非为生产流量设计。 |
生产就绪检查清单
在将真实流量路由到 HyperEVM 之前，确认基本事项：每个环境的正确链 ID、支持你所调用方法的提供商、重试和退避策略，以及回退端点。如果你的设计依赖实时事件，请明确验证 WebSocket 支持，而不是假设它存在。
对于需要隔离容量或可预测吞吐量的团队，专用节点是一个选项；有关该模式的工作方式，请参阅专用节点。对大多数应用而言，具有明确限制的托管 RPC API 是更简单的起点。
- 分离主网和测试网配置。
- 如果你的应用需要归档和 WebSocket 支持，请确认其可用性。
- 添加带退避的重试和至少一个回退端点。
- 从你自己的应用监控错误率和延迟，而不仅仅是提供商仪表板。
- 根据预期请求量审查 RPC 定价。
常见问题
Hyperliquid EVM 和 HyperEVM 是同一个东西吗？
是的。HyperEVM 是 Hyperliquid 区块链内 EVM 执行层的常用名称。它与 HyperCore 一同由 HyperBFT 保障安全。
Hyperliquid EVM 的链 ID 是什么？
根据 Hyperliquid 的开发者文档，HyperEVM 主网使用链 ID 999，测试网使用链 ID 998。部署前务必重新核对官方文档。
HyperEVM 支持 WebSocket JSON-RPC 吗？
公共 Hyperliquid JSON-RPC 端点目前不支持 WebSocket JSON-RPC。其他 RPC 实现可能支持，如果你需要订阅，请咨询你的提供商。
HyperEVM 上用什么代币支付 gas？
HYPE 是 HyperEVM 上的原生 gas 代币，主网和测试网均为 18 位小数。
如何将 HYPE 从 HyperCore 转移到 HyperEVM？
HYPE 通过向指定地址进行原生转账在 HyperCore 和 HyperEVM 之间转移，而非通过桥合约。请参阅 Hyperliquid 官方文档了解当前地址和说明。
我可以使用 OnFinality 进行 HyperEVM RPC 访问吗？
OnFinality 在受支持的网络中提供 RPC API 和专用节点基础设施。请查看支持的 RPC 网络页面了解当前 Hyperliquid 可用性和端点详情。
Ethereum
Solana
Polygon
Base
Arbitrum
BNB链
Polkadot
Optimism
