Hyperliquid Docker 노드 가이드
Hyperliquid는 공식 Docker 이미지를 제공합니다. Non-validator(RPC) 노드는 일반 사용자가 운영 가능하며, Validator는 스테이킹 기반 권한이 필요합니다.
- 공식 저장소: https://github.com/hyperliquid-dex/node
- 공식 문서: https://hyperliquid.gitbook.io/hyperliquid-docs/non-validator-nodes
- 공식 이미지:
ghcr.io/hyperliquid-dex/hyperliquid-node
빠른 실행 (Mainnet Non-validator)
sudo mkdir -p /data/hyperliquid
sudo chown -R 1000:1000 /data/hyperliquid
docker run -d --name hl-node \
--restart unless-stopped \
-p 3001:3001 -p 4001:4001 -p 8545:8545 \
-v /data/hyperliquid:/root/hl \
ghcr.io/hyperliquid-dex/hyperliquid-node:latest \
/usr/local/bin/hl-node run-non-validator \
--chain Mainnet
- 3001: REST API (info endpoint)
- 4001: WebSocket
- 8545: HyperEVM JSON-RPC (EVM 호환)
HyperEVM 조회
curl -s -X POST http://localhost:8545 \
-H 'Content-Type: application/json' \
-d '{"jsonrpc":"2.0","method":"eth_blockNumber","params":[],"id":1}' | jq
curl -s -X POST http://localhost:8545 \
-H 'Content-Type: application/json' \
-d '{"jsonrpc":"2.0","method":"eth_chainId","params":[],"id":2}' | jq
- Mainnet HyperEVM Chain ID: 999
- Testnet HyperEVM Chain ID: 998
L1 조회
# 메타정보
curl -s http://localhost:3001/info -H 'Content-Type: application/json' \
-d '{"type":"meta"}' | jq
# 최신 블록 높이
curl -s http://localhost:3001/info -H 'Content-Type: application/json' \
-d '{"type":"blockInfo"}' | jq
스냅샷
Genesis 동기화는 오래 걸립니다. 공식 S3 스냅샷을 사용하세요.
# 최신 스냅샷 경로는 공식 문서에서 확인
aws s3 cp --no-sign-request --recursive \
s3://hl-mainnet-node-data/chain_state /data/hyperliquid/chain_state
Validator 노드
Validator 참여는 hl-node run-validator 플래그와 HYPE 스테이킹 + 지명(delegation) 이 필요합니다. 상세는 Validator 문서.