Cosmos Hub (gaiad) 업데이트 로그

Cosmos Hub Full Node (gaiad) 버전별 업데이트와 체인 업그레이드(Gaia Upgrade Proposal) 진행 방법입니다.

• 공식 릴리스: https://github.com/cosmos/gaia/releases
• 업그레이드 가이드: https://hub.cosmos.network/main/hub-tutorials/upgrade-node.html
• Cosmovisor: https://docs.cosmos.network/main/tooling/cosmovisor

업데이트 체크리스트

• 다음 업그레이드 블록 높이 확인 (Governance proposal)
• 대상 gaia 버전 다운로드·해시 확인
• cosmovisor 사용 중이면 upgrades/<name>/bin/ 에 바이너리 배치
• 업그레이드 블록 도달 시 자동/수동 재기동
• 재기동 후 gaiad status 로 catching_up: false 확인

최근 업그레이드

Cosmovisor 기반 자동 업그레이드

# cosmovisor 설치 (go install)
go install cosmossdk.io/tools/cosmovisor/cmd/cosmovisor@latest

# 디렉토리 구조
# ~/.gaia/cosmovisor/
#   genesis/bin/gaiad
#   upgrades/<UPGRADE_NAME>/bin/gaiad

export DAEMON_NAME=gaiad
export DAEMON_HOME=$HOME/.gaia

# systemd
sudo systemctl start cosmovisor
journalctl -u cosmovisor -f

수동 업데이트

# 1. 현재 노드 중지
sudo systemctl stop gaiad

# 2. 새 바이너리 설치
VERSION=v21.0.0
wget https://github.com/cosmos/gaia/releases/download/${VERSION}/gaiad-${VERSION#v}-linux-amd64
chmod +x gaiad-${VERSION#v}-linux-amd64
sudo mv gaiad-${VERSION#v}-linux-amd64 /usr/local/bin/gaiad

# 3. 재기동
sudo systemctl start gaiad
journalctl -u gaiad -f

업그레이드 높이 확인

# 활성 governance proposal 확인
gaiad query gov proposals --status PASSED --output json | jq '.proposals[] | {id: .id, type: .messages[0]["@type"]}'

# 예상 업그레이드 시간
gaiad query upgrade plan

롤백

Cosmos SDK는 일반적으로 업그레이드 후 다운그레이드가 불가능합니다. Genesis/snapshot에서 이전 높이로 재기동이 유일한 방법이며, Validator는 더블 사이닝(doubling signing)을 주의해야 합니다.

참고

• Gaia Upgrade Proposals
• Cosmos Hub Governance