Starknet 호스트 설치 가이드 (Juno 기준)

Ubuntu 22.04 기준 Juno 소스 빌드·실행 개요입니다. Pathfinder/Madara도 유사한 패턴이며 각 저장소 README를 참고하세요.

• Juno 저장소: https://github.com/NethermindEth/juno
• 공식 문서: https://juno.nethermind.io/

시스템 요구사항 (Juno Full Node)

빌드

sudo apt update && sudo apt install -y git build-essential

# Go 1.22+
wget https://go.dev/dl/go1.22.8.linux-amd64.tar.gz
sudo tar -C /usr/local -xzf go1.22.8.linux-amd64.tar.gz
export PATH=$PATH:/usr/local/go/bin

git clone https://github.com/NethermindEth/juno.git
cd juno
git checkout v0.13.0
make juno
sudo mv build/juno /usr/local/bin/
juno --version

실행

mkdir -p ~/juno-data

juno \
  --network mainnet \
  --http --http-host 0.0.0.0 --http-port 6060 \
  --ws --ws-host 0.0.0.0 --ws-port 6061 \
  --db-path $HOME/juno-data \
  --eth-node https://<L1_MAINNET_RPC>

systemd 서비스

# /etc/systemd/system/juno.service
[Unit]
Description=Juno Starknet Node
After=network-online.target

[Service]
User=juno
ExecStart=/usr/local/bin/juno --network mainnet \
  --http --http-host 0.0.0.0 --http-port 6060 \
  --db-path /home/juno/juno-data \
  --eth-node https://<L1_MAINNET_RPC>
Restart=on-failure
LimitNOFILE=65535

[Install]
WantedBy=multi-user.target

sudo systemctl daemon-reload
sudo systemctl enable --now juno
journalctl -u juno -f

상태 확인

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

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

참고

• Juno releases
• Starknet JSON-RPC Spec