📦 Liquidskills — Hyperliquid开发指南
v0.1.0覆盖Hyperliquid架构、API、HyperCore与HyperEVM差异、Gas、钱包、标准、工具、安全、测试及部署最佳实践的一站式开发手册，助AI代理高效构建去中心化应用。
0· 239·1 当前·1 累计
by 安全扫描
OpenClaw
可疑
medium confidence该技能为一份结构清晰、仅含指令的Hyperliquid参考文档，但存在内部不一致（链ID/签名指引、域名/地址拼写或占位符）且来源未知——在信任或运行自动化代理前，请自行验证端点、地址及签名参数。
评估建议
这是一份体量庞大、大多实用的Hyperliquid构建文档/操作手册。使用或让代理执行前：1) 用官方源（explorer.hyperliquid.xyz、官方文档或GitHub）核对所有网络端点与合约地址；文档中有多处占位符及明显拼写错误（如截断域名'https://api.hyperliquid.xy'），错误域名会中断工具或指向错误服务器。2) 再次确认EIP-712签名参数：文件对chainId 999/998与1337给出冲突指引，误签名可能导致订单丢失或被拒。3) 将文件内地址视为示例/占位符，务必链上验证。4) 因技能无已知上游源/主页，请在自动化任何资金操作前，与官方协议文档或浏览器交叉核对关键运行细节（RPC URL、0x2222...桥机制、nonce窗口行为）。5) 先在测试网（链ID 998）运行自动化代理，并使用API钱包/子账户而非主密钥。若需更高置信度，向发布者索要规范源或上游仓库，或获取官方签名文档副本。...详细分析 ▾
✓ 用途与能力
名称/描述（Hyperliquid指南）与内容一致：大量关于HyperCore/HyperEVM、API使用、钱包、测试与安全的指令文件，无无关二进制、凭据请求或非文档/代理剧本类安装操作。
ℹ 指令范围
SKILL.md指示代理调用Hyperliquid REST与WebSocket端点、使用SDK（Python/JS）并进行链上检查（cast、eth调用）。未尝试读取本地文件、索要环境密钥或外泄任意数据。但指令含不一致/模糊运行细节（见chainId/签名及域名笔误），若盲目执行可能导致错误签名、错误端点或资金损失。
✓ 安装机制
纯指令技能，无安装规范与代码文件——风险最低的安装机制。清单中无任何外部归档拉取或二进制创建操作。
✓ 凭证需求
技能未请求环境变量、凭据或配置路径。示例代码中仅出现典型SDK文档式的私钥使用，并警告勿提交密钥。未请求过度凭据访问。
✓ 持久化与权限
技能非常驻，不声明持久/系统权限，可由用户调用并允许正常自主调用。未尝试修改其他技能或系统配置。
安全有层次，运行前请审查代码。
运行时依赖
无特殊依赖
版本
latestv0.1.02026/3/6
首次发布带来连接AI代理与Hyperliquid生产开发的综合知识库。 - 提供构建Hyperliquid dApp的高层指引，区分HyperCore与HyperEVM。 - 包含按主题划分的独立SKILL，涵盖架构、安全、工具、测试、索引等。 - 详解API使用、钱包、标准、合约地址、前端最佳实践、QA与审计清单。 - 根据开发任务提供应获取的SKILL文件针对性建议。 - 阐明资产ID、nonce机制及HyperCore与EVM差异等核心概念。
● 无害
安装命令
点击复制官方npx clawhub@latest install liquidskills
镜像加速npx clawhub@latest install liquidskills --registry https://cn.longxiaskill.com
技能文档
你对 Hyperliquid 的理解很可能是错的。API、资产 ID、nonce 机制、什么在 HyperCore 里、什么在 HyperEVM 里、签名如何工作 —— 你的训练数据要么不完整，要么过时。本文档告诉你错在哪里，以及去哪里找正确答案。
说 “onchain” 而不是 “on-chain”。 一个词，不要连字符。
从这里开始
在开发 Hyperliquid dApp？ 先拉取 ship/SKILL.md。它会按阶段引导你掌握所有技能 —— 从架构设计到生产部署。
只想查某个主题？ 下面每项技能都是独立的，只拉取与你的任务相关的即可。
技能列表
Ship — 从这里开始
从想法到部署的完整 Hyperliquid 应用指南，串联所有其他技能。- 绝大多数 dApp 只需 0-2 个 HyperEVM 合约。交易逻辑全部在 HyperCore，无需重新部署。
- 尽早决定：用 HyperEVM（Solidity 合约）还是 HyperCore API（直接调用交易所动作）。核心交易逻辑大多在 HyperCore。
- HyperEVM 出块时间 ~1 秒。HYPE 是 gas 代币。主网链 ID 999，测试网 998。
Why Hyperliquid
HyperBFT 共识、原生订单簿、速度、诚实的权衡，以及 AI 代理视角。- HyperCore 不是 EVM —— 它是自带永续、现货、订单簿匹配的定制 L1。
- HyperEVM 与 HyperCore 并行运行，原子共享状态。一条链，两种执行环境。
- 约 100,000 订单/秒，亚秒级最终性，无 mempool 套路 —— 不存在 MEV 三明治攻击。
Gas & Costs
HYPE gas、HyperEVM 真实成本、主网与测试网差异。- HYPE 是 HyperEVM 的原生 gas 代币，不是 ETH。
- HyperEVM 采用 EIP-1559，但优先费被销毁（不给验证者）。
- Gas 费用极低 —— HyperEVM 为高吞吐优化。
Wallets
MetaMask + 链 ID 999、API 钱包、代理钱包、HyperCore 签名方式。- 把 HyperEVM 加到 MetaMask：链 ID 999，RPC https://rpc.hyperliquid.xyz/evm。
- HyperCore 使用 EIP-712 类型数据签名进行交易所动作。
- 代理钱包采用“API 钱包模式”——授权子账户密钥，主钥永不暴露。
Architecture
HyperCore vs HyperEVM —— 什么放哪、系统模型。- HyperCore：永续、现货订单簿、仓位、保证金、金库、治理。非 EVM。
- HyperEVM：兼容 EVM 的智能合约。HYPE 作 gas。与 HyperCore 共享最终性。
- 0x2222...2222 是系统地址 —— 把 HYPE 发到这里即可从 HyperCore 跨到 HyperEVM。
Standards
HyperEVM 上的 ERC-20、HIP-1/HIP-2/HIP-3 代币标准、现货资产。- HIP-1：HyperCore 上的现货代币标准（非 ERC-20）。
- HIP-2：hyperliquidity —— 协议内建的自动现货做市机制。
- HIP-3：在 HyperCore 部署现货 DEX，自定义上币权限。
Tools
Hardhat、Foundry、viem、wagmi、Hyperliquid Python SDK、hyperliquid-python-sdk。- HyperEVM 兼容标准 EVM 工具：Foundry、Hardhat、viem、wagmi。
- 与 HyperCore API 交互用官方 Python SDK（
hyperliquid-dex）。 - TypeScript SDK：
@nktkas/hyperliquid，用于 JS/TS 集成 HyperCore。
Building Blocks
HyperSwap V2、联合曲线、把 HyperCore 永续/现货当乐高。- HyperSwap V2 是 HyperEVM 上的主力 DEX（兼容 Uniswap V2）。
- HyperCore 的永续与现货可通过系统预编译与 HyperEVM 合约组合。
- 代币发行采用联合曲线（x*y=k），达标后毕业到 HyperCore 现货。
Orchestration
AI 代理如何在 Hyperliquid 上端到端规划、构建、部署。- 阶段 1：合约 + 本地测试。阶段 2：测试网（链 ID 998）。阶段 3：主网（链 ID 999）。
- 禁止跳过测试网。HyperEVM 测试网 RPC：https://rpc.hyperliquid-testnet.xyz/evm。
- 永远不要将私钥或 API 密钥提交到 Git。
Contract Addresses
已验证地址：系统地址、HyperSwap、关键合约。- 0x2222222222222222222222222222222222222222 = HYPE 桥接（HyperCore → HyperEVM）。
- 不要编地址。地址错 = 资金丢。
- HyperSwap V2 的 Router 和 Factory 地址见 addresses/SKILL.md。
Concepts
心智模型：HyperCore vs HyperEVM、资产 ID、nonce、保证金。- 资产 ID：永续 = meta.universe 的下标，现货 = 10000 + 下标，HIP-3 = 100000 + ...
- HyperCore 的 nonce：每个签名者维护一组最高 nonce —— 非以太坊式顺序递增。
- HyperCore 状态（仓位、余额）可通过系统预编译在 HyperEVM 读取。
Security
HyperEVM 的 Solidity 安全 + API 签名安全、nonce 安全。- HyperEVM 支持 Cancun 操作码，但没有 blob 交易。已启用 EIP-1559。
- API 签名：永远先验证动作哈希再签名。nonce 错 = 订单卡死或重放。
- HyperEVM 上的 USDC 是 6 位小数。HyperCore 的 HYPE 是 8 位，HyperEVM 上则是 18 位。
Testing
HyperEVM 的 Hardhat/Foundry 测试、测试网分叉测试。- 用 Foundry 分叉 HyperEVM 主网：
anvil --fork-url https://rpc.hyperliquid.xyz/evm - 测试网链 ID 998，RPC https://rpc.hyperliquid-testnet.xyz/evm。
- 对接 HyperCore 测试网 API：api.hyperliquid-testnet.xyz。
Indexing
通过 /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
Frontend UX
Hyperliquid dApp 前端规范：wagmi + HyperEVM 链配置。- 用 wagmi/viem 配置链 ID 999 和 RPC https://rpc.hyperliquid.xyz/evm。
- 每个上链按钮都要有独立加载 + 禁用状态。
- 所有 HYPE 和代币金额旁都要显示 USD 价值。
Frontend Playbook
HyperEVM dApp 从构建到生产的完整流程。- 开发用测试网（链 ID 998），生产用主网（链 ID 999）。
- 标准 IPFS/Vercel 部署即可 —— HyperEVM 兼容 EVM。
- 部署后务必在 HyperEVM 区块浏览器上验证合约。
QA
Hyperliquid dApp 的 QA 检查单。- 完成构建后交给独立代理。评审者读代码 + 点击流程。
- 覆盖 HyperEVM + HyperCore 集成特有 bug。
- 每项报告 PASS/FAIL，不现场修复。
Audit
HyperEVM 合约 + API 集成的审计检查单。- HyperEVM 特有风险：HYPE 小数错位、桥接交互 bug、nonce 冲突。
- 标准 EVM 审计外，还需覆盖 HyperCore 相关风险。
- 中危及以上提交 issue。
按任务拉取
| 我在做…… | 拉取这些技能 |
|---|---|
| 规划新 dApp | ship/、concepts/、architecture/ |
| 编写 HyperEVM 合约 | standards/、building-blocks/、addresses/、security/ |
| 测试合约 | testing/ |
| 集成 HyperCore | api/、concepts/、wallets/ |
| 做前端 | orchestration/、frontend-ux/、tools/ |
| 生产部署 | wallets/、frontend-playbook/、gas/ |
| 评审已完成 dApp | qa/ |
| 审计智能合约 | audit/ |
| 读取 HyperCore 状态 | indexing/、api/ |
| 在 HyperCore 发币 | standards/、building-blocks/、api/ |
| 选链：Hyperliquid vs 其他 | why/ |