功能描述

Comprehensive guide covering Hyperliquid's architecture, API, HyperCore vs HyperEVM, gas, wallets, standards, tools, security, testing, and deployment best p...

使用说明 (SKILL.md)

LIQUIDSKILLS — The missing knowledge between AI agents and production Hyperliquid.

Name: Liquidskills
Author: cloudzombie

You are probably wrong about Hyperliquid. The API, asset IDs, nonce mechanics, what lives in HyperCore vs HyperEVM, how signing works — your training data is incomplete or stale. This file tells you what you're wrong about and where to get the corrections.

Say "onchain" not "on-chain." One word, no hyphen.

Start Here

Building a Hyperliquid dApp? Fetch ship/SKILL.md first. It routes you through all other skills phase by phase — from architecture planning to production deployment.

Need a specific topic? Each skill below is standalone. Fetch only the ones relevant to your task.

Skills

Ship — Start here

End-to-end guide from idea to deployed Hyperliquid app. Routes you through all other skills.

Most dApps need 0-2 contracts on HyperEVM. HyperCore handles all the trading — you don't redeploy it.
Decide early: HyperEVM (Solidity contracts) vs HyperCore API (direct exchange actions). Most trading logic lives in HyperCore.
Block time is ~1s on HyperEVM. HYPE is the gas token. Chain ID 999 mainnet, 998 testnet.

Why Hyperliquid

HyperBFT consensus, native orderbook, speed, honest tradeoffs, the AI agent angle.

HyperCore is not EVM — it's a custom L1 with native perps, spot, and orderbook matching.
HyperEVM runs alongside HyperCore, sharing state atomically. One chain, two execution environments.
~100,000 orders/sec, sub-second finality, no mempool games — MEV sandwich attacks don't exist.

Gas & Costs

HYPE gas, actual costs on HyperEVM, mainnet vs testnet.

HYPE is the native gas token on HyperEVM, not ETH.
HyperEVM uses EIP-1559 but priority fees are burned (not to validators).
Gas costs are very low — HyperEVM is optimized for high-throughput.

Wallets

MetaMask + chain ID 999, API wallets, agent wallets, signing for HyperCore.

Add HyperEVM to MetaMask: Chain ID 999, RPC https://rpc.hyperliquid.xyz/evm.
HyperCore uses EIP-712 typed-data signatures for exchange actions.
Agent wallets use the API wallet pattern — approve a subaccount key, never expose the main key.

Architecture

HyperCore vs HyperEVM — what lives where, the system model.

HyperCore: perps, spot orderbook, positions, margin, vaults, governance. Not EVM.
HyperEVM: EVM-compatible smart contracts. HYPE gas. Shares finality with HyperCore.
0x2222...2222 is the system address — send HYPE here to move it from HyperCore to HyperEVM.

Standards

ERC-20 on HyperEVM, HIP-1/HIP-2/HIP-3 token standards, spot assets.

HIP-1: spot token standard on HyperCore (not ERC-20).
HIP-2: hyperliquidity — automated spot market-making built into the protocol.
HIP-3: deploy a spot DEX on HyperCore with your own token listing authority.

Tools

Hardhat, Foundry, viem, wagmi, Hyperliquid Python SDK, hyperliquid-python-sdk.

HyperEVM works with standard EVM tools: Foundry, Hardhat, viem, wagmi.
Use the official Python SDK (hyperliquid-dex) for HyperCore API interactions.
TypeScript SDK: @nktkas/hyperliquid for JS/TS HyperCore integration.

Building Blocks

HyperSwap V2, bonding curves, HyperCore perps/spot as legos.

HyperSwap V2 is the main DEX on HyperEVM (Uniswap V2 compatible).
HyperCore perps and spot are composable with HyperEVM contracts via the system precompile.
Token launches use bonding curves (x*y=k) that graduate to HyperCore spot at a threshold.

Orchestration

How an AI agent plans, builds, and deploys on Hyperliquid end-to-end.

Phase 1: contracts + local testing. Phase 2: testnet (chain ID 998). Phase 3: mainnet (chain ID 999).
Never skip testnet. HyperEVM testnet at https://rpc.hyperliquid-testnet.xyz/evm.
NEVER commit private keys or API keys to Git.

Contract Addresses

Verified addresses: system address, HyperSwap, key contracts.

0x2222222222222222222222222222222222222222 = HYPE bridge (HyperCore → HyperEVM).
Never hallucinate an address. Wrong address = lost funds.
HyperSwap V2 Router and Factory addresses are listed in addresses/SKILL.md.

Concepts

Mental models: HyperCore vs HyperEVM, asset IDs, nonces, margins.

Asset IDs: perps = index in meta.universe, spot = 10000 + index, HIP-3 = 100000 + ...
Nonces on HyperCore: rolling set of highest nonces per signer — NOT sequential like Ethereum.
HyperCore state (positions, balances) is readable from HyperEVM via system precompile.

Security

Solidity security for HyperEVM + API signing security, nonce safety.

HyperEVM has Cancun opcodes but no blob transactions. EIP-1559 enabled.
API signing: always verify the action hash before signing. Wrong nonce = stuck or replayed order.
USDC on HyperEVM has 6 decimals. HYPE has 8 decimals in HyperCore, 18 on HyperEVM.

Testing

Hardhat/Foundry testing for HyperEVM, testnet fork testing.

Fork HyperEVM mainnet with Foundry: anvil --fork-url https://rpc.hyperliquid.xyz/evm
Testnet chain ID 998, RPC https://rpc.hyperliquid-testnet.xyz/evm.
Test HyperCore interactions against the testnet API at api.hyperliquid-testnet.xyz.

Indexing

Reading HyperCore data via /info, event indexing on HyperEVM.

HyperCore data (positions, orders, trades) via POST /info — not RPC, not events.
HyperEVM events work like standard EVM events, queryable via standard tools.
WebSocket at wss://api.hyperliquid.xyz/ws for real-time HyperCore data.

API — The definitive reference

Complete Hyperliquid API: /info, /exchange, WebSocket.

POST /info: all read operations. No auth required.
POST /exchange: all write operations (orders, cancels, transfers). Requires EIP-712 signature.
Mainnet: https://api.hyperliquid.xyz | Testnet: https://api.hyperliquid-testnet.xyz

Frontend UX

Frontend rules for Hyperliquid dApps: wagmi + HyperEVM chain config.

Configure wagmi/viem with chain ID 999 and RPC https://rpc.hyperliquid.xyz/evm.
Every onchain button needs its own loader + disabled state.
Show USD values next to every HYPE and token amount.

Frontend Playbook

Full build-to-production pipeline for HyperEVM dApps.

Use testnet (chain ID 998) for development, mainnet (chain ID 999) for production.
Standard IPFS/Vercel deployment works — HyperEVM is EVM-compatible.
Always verify contracts on the HyperEVM block explorer after deployment.

QA

QA checklist for Hyperliquid dApps.

Give this to a separate agent after the build is complete. Reviewer reads code + clicks through flows.
Covers bugs specific to HyperEVM + HyperCore integrations.
Report PASS/FAIL per item, don't fix.

Audit

Audit checklist for HyperEVM contracts + API integrations.

HyperEVM-specific risks: HYPE decimal mismatches, bridge interaction bugs, nonce collisions.
Standard EVM audit applies plus HyperCore-specific risks.
File issues for Medium severity and above.

What to Fetch by Task

I'm doing...	Fetch these skills
Planning a new dApp	`ship/`, `concepts/`, `architecture/`
Writing HyperEVM contracts	`standards/`, `building-blocks/`, `addresses/`, `security/`
Testing contracts	`testing/`
Building HyperCore integration	`api/`, `concepts/`, `wallets/`
Building a frontend	`orchestration/`, `frontend-ux/`, `tools/`
Deploying to production	`wallets/`, `frontend-playbook/`, `gas/`
Reviewing a finished dApp	`qa/`
Auditing a smart contract	`audit/`
Reading HyperCore state	`indexing/`, `api/`
Token launch on HyperCore	`standards/`, `building-blocks/`, `api/`
Choosing Hyperliquid vs another chain	`why/`

安全使用建议

This is a large, mostly useful documentation/playbook for building on 'Hyperliquid'. Before you use it or let an agent act on it: 1) Verify any network endpoints and contract addresses against official sources (explorer.hyperliquid.xyz, official docs or GitHub). There are several placeholders and at least one apparent typo (e.g., a truncated/incorrect host 'https://api.hyperliquid.xy' appears in the docs) — a wrong domain will break tooling or could point to the wrong server. 2) Double-check EIP-712 signing parameters: the files contain conflicting guidance (audit notes expect checking chainId 999/998 for EVM signatures, while the concepts doc says HyperCore EIP-712 domain uses chainId 1337). Mis-signing can cause lost or rejected orders. 3) Treat addresses in the files as examples/placeholders until you verify them onchain — the skill itself repeatedly warns to verify addresses. 4) Because the skill has no known upstream source/homepage, prefer to cross-reference every critical operational detail (RPC URLs, bridge mechanics for 0x2222..., nonce window behavior) with official protocol docs or explorer before automating any funds-moving actions. 5) Run automated agents only on testnet first (chain ID 998) and use API wallets/subaccounts rather than main keys. If you want higher confidence, ask the publisher for a canonical source or upstream repo, or obtain a signed/official copy of the docs.

功能分析

Type: OpenClaw Skill Name: liquidskills Version: 0.1.0 The LiquidSkills bundle is a comprehensive documentation and instruction set designed for AI agents building on the Hyperliquid L1 blockchain. It provides detailed guidance on HyperCore API integration, HyperEVM smart contract development, and security best practices, such as using agent wallets and avoiding hardcoded private keys. The content is technically accurate for the Hyperliquid ecosystem and contains no evidence of malicious intent, data exfiltration, or harmful prompt injection; rather, it includes extensive security checklists (security/SKILL.md, audit/SKILL.md) to prevent common developer errors like decimal mismatches or reentrancy.

能力评估

✓ Purpose & Capability

The name/description (Hyperliquid guide) matches the actual content: a large set of instruction files about HyperCore/HyperEVM, API use, wallets, testing, and security. There are no unrelated binaries, credential requests, or install actions that don't belong to a documentation/agent-playbook skill.

ℹ Instruction Scope

SKILL.md instructs the agent to call Hyperliquid REST and WebSocket endpoints, use SDKs (Python/JS), and run onchain checks (cast, eth calls). It does not attempt to read local files, ask for environment secrets, or exfiltrate arbitrary data. However the instructions contain inconsistent/ambiguous operational details (see chainId/signing and domain typos) that could cause incorrect signing, wrong endpoints, or funds loss if followed blindly.

✓ Install Mechanism

Instruction-only skill with no install spec and no code files — lowest-risk install mechanism. Nothing in the manifest pulls external archives or creates binaries.

✓ Credentials

The skill requests no environment variables, credentials, or config paths. Examples show private key usage only in example code (typical for SDK docs) and the text warns not to commit keys. No disproportionate credential access is requested.

✓ Persistence & Privilege

The skill is not always-on, does not claim persistent/system privileges, and is user-invocable with normal autonomous invocation allowed. It does not attempt to modify other skills or system configuration.

版本历史

v0.1.0

Initial release introduces a comprehensive knowledge base bridging AI agents and Hyperliquid production development. - Provides high-level guidance for building Hyperliquid dApps, distinguishing between HyperCore and HyperEVM. - Includes topic-organized, standalone SKILLs for architecture, security, tooling, testing, indexing, and more. - Details API usage, wallets, standards, contract addresses, frontend best practices, QA, and audit checklists. - Offers targeted recommendations for which SKILL files to fetch based on developer tasks. - Clarifies key concepts such as asset IDs, nonce mechanics, and differences between HyperCore and EVM.

元数据

Slug liquidskills

版本 0.1.0

许可证 —

累计安装 1

当前安装数 1

历史版本数 1

常见问题

Liquidskills 是什么？

Comprehensive guide covering Hyperliquid's architecture, API, HyperCore vs HyperEVM, gas, wallets, standards, tools, security, testing, and deployment best p... 它是一个面向 Claude Code / OpenClaw 的 AI Agent Skill 插件，目前累计下载 264 次。

如何安装 Liquidskills？

在 OpenClaw 或 Claude Code 对话框中运行命令「/install liquidskills」即可一键安装，无需额外配置。

Liquidskills 是免费的吗？

是的，Liquidskills 完全免费（开源免费），可自由下载、安装和使用。

Liquidskills 支持哪些平台？

Liquidskills 跨平台运行，可在任意部署了 OpenClaw / Claude Code 的环境中使用（cross-platform）。

谁开发了 Liquidskills？

由 JF（@cloudzombie）开发并维护，当前版本 v0.1.0。

Liquidskills