Hedera Mirror Node / Local Node 문제 해결
Mirror Node·Local Node 실행·연결 시 참고할 사항입니다.
Mirror Node (One-Click)
- GCP 빌링·HMAC: One-Click 배포 전 “How To Obtain GCP Requester Pay Information” 단계를 완료했는지 확인. 잘못된 키·버킷이면 Importer가 스트림을 가져오지 못할 수 있습니다.
- Kubernetes:
kubectl get svc -n default등으로hedera-mirror-node-1-rest,hedera-mirror-node-1-grpc서비스와 LoadBalancer IP 확인. 방화벽·보안 그룹에서 해당 포트 허용. - REST/gRPC 응답 없음: 포드 로그
kubectl logs -n default -l app=hedera-mirror-node등으로 Importer·REST 상태 확인.
Mirror Node (자체 설치)
- Java: Java 21 이상 필요.
java -version확인. - Postgres: 버전·접속 정보가 hedera-mirror-node 설정과 일치하는지 확인.
- 스트리밍: GCS 버킷(메인넷/테스트넷) 접근 권한·HMAC 설정. 공식 Mirror Node 문서·저장소 이슈 참고.
Local Node
- Docker:
hedera local start사용 시 Docker·Docker Compose가 설치되어 있고 데몬이 동작 중인지 확인. - NPM:
hederaCLI가 전역 설치되어 있는지which hedera또는hedera --version으로 확인. - 포트 충돌: 다른 서비스가 같은 포트를 쓰고 있으면 로컬 노드가 실패할 수 있음. 로그 또는 hedera-local-node README의 포트 목록 확인.