Hyperliquid 호스트 설치 가이드

Ubuntu 22.04 기준 hl-node 바이너리 실행 개요입니다.

• 공식 문서: https://hyperliquid.gitbook.io/hyperliquid-docs/non-validator-nodes
• 소스: https://github.com/hyperliquid-dex/node

시스템 요구사항

매우 I/O 집약적입니다. SSD로는 블록 처리 지연이 자주 발생 — NVMe 필수.

바이너리 다운로드

VERSION=latest
wget https://github.com/hyperliquid-dex/node/releases/download/${VERSION}/hl-node-linux-amd64.tar.gz
tar -xzf hl-node-linux-amd64.tar.gz
sudo mv hl-node /usr/local/bin/
hl-node --version

설정

mkdir -p ~/hl
cd ~/hl

# 공식 config 템플릿 복사
wget https://raw.githubusercontent.com/hyperliquid-dex/node/main/config/mainnet.json -O config.json

스냅샷 가져오기 (권장)

pip install awscli
aws s3 cp --no-sign-request --recursive \
  s3://hl-mainnet-node-data/chain_state ~/hl/chain_state

실행

hl-node run-non-validator \
  --chain Mainnet \
  --home $HOME/hl \
  --evm-rpc-addr 0.0.0.0:8545 \
  --info-addr 0.0.0.0:3001

systemd 서비스

# /etc/systemd/system/hl-node.service
[Unit]
Description=Hyperliquid non-validator node
After=network-online.target

[Service]
User=hyperliquid
ExecStart=/usr/local/bin/hl-node run-non-validator \
  --chain Mainnet \
  --home /home/hyperliquid/hl \
  --evm-rpc-addr 0.0.0.0:8545 \
  --info-addr 0.0.0.0:3001
Restart=on-failure
LimitNOFILE=65535

[Install]
WantedBy=multi-user.target

상태 조회

# L1
curl -s http://localhost:3001/info \
  -H 'Content-Type: application/json' \
  -d '{"type":"blockInfo"}' | jq

# HyperEVM
curl -s -X POST http://localhost:8545 \
  -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","method":"eth_blockNumber","params":[],"id":1}' | jq

참고

• Validator Setup
• Node Releases