Hyperliquid 文档：从哪里开始接入 API 和 RPC

Hyperliquid 文档实际涵盖的内容

官方 Hyperliquid 文档围绕该链的两个执行环境组织。HyperCore 包含完全链上的永续合约和现货订单簿，订单、撤单、成交和清算均以单区块最终性处理。HyperEVM 是通用智能合约层，将兼容以太坊的工具引入同一统一状态。

这种划分在你阅读文档时很重要。关于订单簿、持仓或交易所操作的问题属于 HyperCore 和 API 部分。关于 Solidity 合约、ERC-20 余额或标准 JSON-RPC 调用的问题属于 HyperEVM 部分。文档还链接到 SDK、构建工具和支持资源，当你从阅读转向实现时会很有用。

• 关于和技术概览：共识、状态模型，以及 HyperCore 与 HyperEVM 的关系。
• API 文档：交易所操作、信息查询和流式接口。
• HyperEVM 部分：EVM 兼容性细节和合约部署背景。
• SDK 和构建工具：各语言客户端和集成辅助工具。
• 支持和社区链接：文档含义不明确时去哪里提问。

决策指南：哪种连接路径适合你的项目

在编写集成代码之前，先决定你的应用如何访问 Hyperliquid。文档描述协议；它们不替你选择基础设施。这一决定取决于工作负载、你需要多少控制权，以及是否想自己运维节点。

以下表格可作为起点。它不是提供商排名；而是一种将你的需求与连接模型匹配的方法。

HyperCore API 与 HyperEVM JSON-RPC：代码中有什么变化

从工具角度看，HyperEVM 的行为类似兼容以太坊的链。你可以使用熟悉的库调用标准 JSON-RPC 方法，如 eth_chainId、eth_blockNumber 和 eth_getBalance。这意味着你现有的以太坊开发习惯在合约读写方面基本适用。

HyperCore 则不同。交易所操作、订单状态和市场数据通过 Hyperliquid 专用 API 和流暴露，而非通用 EVM 方法。文档详细描述了这些接口，包括签名和预检。如果你的应用同时涉及两层，预计同一代码库中会有两种集成风格：合约使用 EVM JSON-RPC，交易所数据使用 HyperCore API。

• 在 HyperEVM 上，使用 EVM JSON-RPC 查询合约状态、日志和标准账户信息。
• 使用 HyperCore API 获取订单、持仓、成交和订单簿数据。
• 查阅文档了解确切的请求和响应结构；不要假设 EVM 方法名适用于交易所操作。
• 将签名逻辑与传输配置分离，这样切换端点时无需重写业务逻辑。

链设置和端点配置

对于 HyperEVM，你需要在钱包或库中配置链 ID、RPC URL，通常还有区块浏览器 URL。官方文档和网络公布的链信息是这些值的权威来源。不要未经官方来源验证就从第三方博客文章复制链 ID。

通过 OnFinality 访问 RPC 时，请查看受支持网络页面了解当前可用性和确切的端点详情。如果 Hyperliquid 已列出，请使用那里提供的端点和链设置，而不是猜测 URL。如果尚未列出，你仍可按照官方文档了解协议细节，并单独规划基础设施。

进一步构建前的最小只读检查

获得端点后，在添加签名或订单逻辑之前先确认基本连通性。一个简单的 JSON-RPC 调用可以验证你的 URL、请求头和链配置是否正确。下面的示例使用占位端点；请将其替换为你的提供商或 OnFinality 受支持网络页面提供的 URL。

如果调用返回链 ID，说明传输正常。如果失败，请检查 URL、认证请求头，以及端点是否期望不同的路径。这一步可以节省后续时间，因为它将传输问题与应用逻辑问题分开。

• curl -X POST <YOUR_RPC_URL> -H 'Content-Type: application/json' -d '{"jsonrpc":"2.0","id":1,"method":"eth_chainId","params":[]}'
• 确认返回的链 ID 与官方值一致。
• 然后尝试 eth_blockNumber，验证节点已同步并能响应。
• 只有这些通过后，才应添加钱包签名或交易所 API 调用。

遵循 Hyperliquid 文档时的常见故障模式

大多数集成问题来自混淆层级或跳过验证。开发者阅读了 HyperEVM 示例，然后试图用同样的方法获取 HyperCore 订单数据，或者从过时的教程复制链 ID。文档很详细，但它们假设你知道自己正在哪一层工作。

另一个常见问题是将 RPC 提供商的文档当作协议文档的替代品。提供商解释端点、限制和传输；它们不会重新定义 Hyperliquid 订单如何签名或 HyperCore 状态如何组织。请同时打开两份参考，并各按其预期用途使用。

OnFinality 与官方文档的配合位置

OnFinality 为受支持的网络提供 RPC API 和专用节点基础设施。对于 Hyperliquid，这意味着你可以将 OnFinality 用作传输层，同时依赖官方文档了解协议行为、签名和 API 语义。这种分离使你的集成易于维护：如果你更换提供商，应用逻辑保持不变。

在确定之前，请查看 RPC 定价和受支持网络列表，确认可用性并规划容量。如果你需要隔离资源或私有端点，专用节点是一个选项。关于评估提供商的更广泛框架，请参阅 RPC 提供商选择指南。

• 使用官方文档了解 API 方法、签名和链架构。
• 在受支持的情况下，使用 OnFinality 进行端点访问、传输和节点运维。
• 在最终确定架构之前，查看受支持网络和定价。
• 为生产韧性考虑备用连接路径。

常见问题