Hedera Mirror Node / Local Node 가이드

Mirror Node(데이터 조회용)와 Local Node(개발용) 설치·실행 방법입니다.
Consensus Node는 Council 전용이므로 이 가이드에서는 다루지 않습니다.

공식 문서: Hedera Docs, hedera-mirror-node, hedera-local-node.

Mirror Node

메인넷/테스트넷 데이터를 REST·gRPC API로 조회할 때 사용합니다.

• One-Click (권장): GCP Marketplace에서 Kubernetes로 배포. One-Click Deployment. GCP HMAC·빌링·버킷 정보 필요.
• 자체 설치: Java 21+, Docker, Postgres. hedera-mirror-node 클론 후 ./gradlew build 등. 상세: installation.md.

배포 후 REST: http://<endpoint>/api/v1/transactions, gRPC(예: 5600) 사용.

Local Node

로컬에서 Consensus + Mirror를 띄워 개발·테스트할 때 사용합니다.

• NPM CLI:
  npm install -g @hashgraph/hedera-local
hedera local start
  → Docker Compose로 로컬 네트워크 기동.
• GitHub: hashgraph/hedera-local-node 저장소에서 Docker Compose·설정 확인.

상세: installation.md.

파일 구조

localhost/
├── README.md           # 이 파일
├── installation.md     # Mirror Node·Local Node 설치
├── configuration.md    # 설정·API 엔드포인트 참고
├── troubleshooting.md
└── updates/
    └── README.md

Consensus Node (참고만)

Consensus Node는 Council 멤버만 운영 가능합니다. 요구사항·배포 절차는 Node Requirements, Node Deployment Process를 참고하세요.