LIQUIDSKILLS — 弥合 AI 智能体与生产环境 Hyperliquid 之间的知识断层

你很可能对 Hyperliquid 的理解存在偏差。API 接口、资产 ID、nonce 机制、HyperCore 与 HyperEVM 的职责边界、签名流程——你的训练数据要么不完整，要么已过时。本文档将明确指出你错在哪里，并告诉你从何处获取准确信息。

请说 “onchain”，而非 “on-chain”。 单词形式，不加连字符。

从这里开始

正在构建 Hyperliquid dApp？ 首先获取 ship/SKILL.md。它将引导你按阶段依次完成所有其他技能模块——从架构设计到生产部署。

只需特定主题？ 下列每一项技能均独立成篇。仅获取与你当前任务相关的部分即可。

技能模块

Ship — 从这里开始

从构想到上线的端到端 Hyperliquid 应用开发指南，串联所有其他技能模块。

• 大多数 dApp 在 HyperEVM 上仅需部署 0–2 个合约。交易逻辑全部由 HyperCore 承载，你无需重新部署 HyperCore。
• 尽早决策：采用 HyperEVM（Solidity 合约）还是 HyperCore API（直接调用交易所操作）。绝大多数交易逻辑运行在 HyperCore 中。
• HyperEVM 区块时间约为 1 秒。HYPE 是其原生 Gas 代币。主网 Chain ID 为 999，测试网为 998。

为何选择 Hyperliquid

HyperBFT 共识机制、原生订单簿、极致性能、诚实权衡，以及面向 AI 智能体的独特定位。

• HyperCore 并非 EVM —— 它是专为永续合约、现货及订单簿撮合定制的 L1。
• HyperEVM 与 HyperCore 并行运行，状态原子共享。单条链，双执行环境。
• 吞吐量达约 100,000 笔订单/秒，亚秒级最终性，无内存池博弈 —— MEV 夹心攻击在此不存在。

Gas 与成本

HYPE Gas、HyperEVM 实际成本、主网与测试网差异。

• HYPE 是 HyperEVM 的原生 Gas 代币，非 ETH。
• HyperEVM 采用 EIP-1559，但优先费用被销毁（不支付给验证者）。
• Gas 成本极低 —— HyperEVM 专为高吞吐优化。

钱包

MetaMask + Chain ID 999、API 钱包、智能体钱包、HyperCore 签名方案。

• 在 MetaMask 中添加 HyperEVM：Chain ID 设为 999，RPC 地址为 https://rpc.hyperliquid.xyz/evm。
• HyperCore 使用 EIP-712 类型化数据签名处理交易所操作。
• 智能体钱包采用 API 钱包模式 —— 仅授权子账户密钥，绝不暴露主密钥。

架构

HyperCore 与 HyperEVM 的职责划分及系统模型。

• HyperCore：永续合约、现货订单簿、头寸、保证金、金库、治理 —— 非 EVM。
• HyperEVM：兼容 EVM 的智能合约。使用 HYPE 支付 Gas。与 HyperCore 共享最终性。
• 0x2222...2222 是系统地址 —— 向此地址转账 HYPE，即可将其从 HyperCore 转移至 HyperEVM。

标准规范

HyperEVM 上的 ERC-20、HIP-1 / HIP-2 / HIP-3 代币标准、现货资产。

• HIP-1：HyperCore 上的现货代币标准（非 ERC-20）。
• HIP-2：超流动性（hyperliquidity）—— 协议内建的自动化现货做市机制。
• HIP-3：在 HyperCore 上部署现货 DEX，并拥有自主代币上架权限。

工具

Hardhat、Foundry、viem、wagmi、Hyperliquid Python SDK、hyperliquid-python-sdk。

• HyperEVM 兼容标准 EVM 工具：Foundry、Hardhat、viem、wagmi。
• 使用官方 Python SDK（hyperliquid-dex）与 HyperCore API 交互。
• TypeScript SDK：@nktkas/hyperliquid，用于 JS/TS 环境下的 HyperCore 集成。

基础组件

HyperSwap V2、曲线做市、HyperCore 永续/现货作为可组合积木。

• HyperSwap V2 是 HyperEVM 上的主 DEX（兼容 Uniswap V2）。
• HyperCore 永续与现货可通过系统预编译合约（system precompile）与 HyperEVM 合约组合使用。
• 代币发行采用恒定乘积曲线（x*y=k），达到阈值后自动升级至 HyperCore 现货市场。

编排

AI 智能体如何在 Hyperliquid 上完成端到端的规划、构建与部署。

• 第一阶段：合约编写 + 本地测试；第二阶段：测试网（Chain ID 998）；第三阶段：主网（Chain ID 999）。
• 切勿跳过测试网环节。HyperEVM 测试网 RPC 地址：https://rpc.hyperliquid-testnet.xyz/evm。
• 切勿将私钥或 API 密钥提交至 Git。

合约地址

经验证的地址：系统地址、HyperSwap、关键合约地址。

• 0x2222222222222222222222222222222222222222 = HYPE 桥接地址（HyperCore → HyperEVM）。
• 切勿凭空猜测地址。错误地址 = 资金永久丢失。
• HyperSwap V2 Router 与 Factory 地址详见 addresses/SKILL.md。

核心概念

心智模型：HyperCore vs HyperEVM、资产 ID、nonce、保证金。

• 资产 ID：永续合约 = meta.universe 中索引值；现货 = 10000 + 索引值；HIP-3 = 100000 + …
• HyperCore 的 nonce：每个签名者维护一组滚动更新的最高 nonce 值 —— 并非以太坊式的严格递增序列。
• HyperCore 状态（头寸、余额）可通过系统预编译合约在 HyperEVM 中读取。

安全

HyperEVM 的 Solidity 安全实践 + API 签名安全 + nonce 安全。

• HyperEVM 支持 Cancun 操作码，但不支持 blob 交易。EIP-1559 已启用。
• API 签名：签名前务必校验操作哈希（action hash）。nonce 错误将导致订单卡死或重放。
• HyperEVM 上 USDC 为 6 位小数；HYPE 在 HyperCore 中为 8 位小数，在 HyperEVM 中为 18 位小数。

测试

HyperEVM 的 Hardhat/Foundry 测试、测试网分叉测试。

• 使用 Foundry 分叉 HyperEVM 主网：anvil --fork-url https://rpc.hyperliquid.xyz/evm
• 测试网 Chain ID 为 998，RPC 地址为 https://rpc.hyperliquid-testnet.xyz/evm。
• 通过测试网 API（api.hyperliquid-testnet.xyz）测试 HyperCore 交互。

索引

通过 /info 读取 HyperCore 数据，HyperEVM 上的事件索引。

• HyperCore 数据（头寸、订单、成交）通过 POST /info 获取 —— 不使用 RPC，也不依赖事件。
• HyperEVM 事件行为与标准 EVM 一致，可用常规工具查询。
• WebSocket 地址 wss://api.hyperliquid.xyz/ws 提供实时 HyperCore 数据流。

API — 权威参考文档

完整的 Hyperliquid API：/info、/exchange、WebSocket。

• POST /info：全部只读操作。无需认证。
• POST /exchange：全部写操作（下单、撤单、转账）。需 EIP-712 签名。
• 主网地址：https://api.hyperliquid.xyz | 测试网地址：https://api.hyperliquid-testnet.xyz

前端用户体验

Hyperliquid dApp 前端规范：wagmi + HyperEVM 链配置。

• 在 wagmi/viem 中配置 Chain ID 999 及 RPC 地址 https://rpc.hyperliquid.xyz/evm。
• 每个 onchain 按钮均需配备独立加载态（loader）与禁用态（disabled state）。
• 所有 HYPE 与代币金额旁必须同步显示 USD 折算值。

前端实施手册

HyperEVM dApp 从构建到生产的完整流水线。

• 开发阶段使用测试网（Chain ID 998），生产环境使用主网（Chain ID 999）。
• 标准 IPFS/Vercel 部署完全适用 —— HyperEVM 兼容 EVM。
• 部署后务必在 HyperEVM 区块浏览器中验证合约。

质量保障（QA）

Hyperliquid dApp 的 QA 检查清单。

• 构建完成后交由独立智能体执行该检查清单。审核员须通读代码并手动走查全部业务流程。
• 覆盖 HyperEVM 与 HyperCore 集成特有的缺陷类型。
• 逐项报告 PASS/FAIL，不进行修复。

审计

HyperEVM 合约与 API 集成的审计检查清单。

• HyperEVM 特有风险：HYPE 小数位不匹配、桥接交互缺陷、nonce 冲突。
• 通用 EVM 审计要求仍适用，并需额外覆盖 HyperCore 特有风险。
• 中危（Medium）及以上级别问题需提 Issue 记录。

按任务选取所需技能模块