마이그레이션 가이드: zcashd에서 Zebrad/Zallet으로
Electric Coin Company (ECC) / Zodl이 유지 관리하던 기존 zcashd 풀 노드는 Zebra와 Zallet으로 대체되었습니다. zcashd는 2026년 7월 18일 지원 종료 중단에 도달했으며 더 이상 실행되지 않습니다.
- Zebra는 Zcash Foundation이 개발한 현대적인 Rust 기반 Zcash 프로토콜 구현체입니다
- Zallet은 Zodl이 개발한 Zebra 노드와 원활하게 연동하도록 만들어진 경량 지갑입니다
이 가이드에서는 설정, 지갑 가져오기, 일반적인 마이그레이션 문제 해결을 포함하여 zcashd에서 Zebrad 및 Zallet으로 마이그레이션하는 방법을 안내합니다.
zcashd는 2026년 7월 18일에 실행을 중단했습니다
이것이 의미하는 바
- zcashd는 2026년 7월 18일 지원 종료 중단에 도달했습니다. 더는 체인 팁까지 동기화되지 않으며 자금을 보내거나 받을 수 없습니다. 이는 예정된 일이 아니라 이미 완료된 일입니다.
- zcashd의 두 가지 역할은 이제 분리되었습니다. zebrad는 풀 노드이고 Zallet은 지갑입니다.
- Zallet은 베타 버전입니다. 릴리스 간 호환성을 깨는 변경이 발생할 수 있으며, 일부 zcashd JSON-RPC 메서드는 아직 구현되지 않았습니다. 특정 호출에 의존하기 전에 메서드 상태 매트릭스를 확인하세요.
- 아직 Sprout 자금을 보유하고 있다면 먼저 6단계의 경고를 읽으세요. Zallet은 Sprout 풀을 지원하지 않으며, 해당 자금을 이동하는 일반적인 방법에는 실행 중인 zcashd가 필요했습니다.
마이그레이션이 필요한 이유 - 지원 종료를 넘어
지원 종료를 제외하더라도 이전해야 할 설득력 있는 이유가 있습니다:
- 보안 및 견고성: Rust의 메모리 안전성과 현대적인 도구는 취약점 위험을 줄입니다.
- 성능 및 효율성: Zebrad는 병렬 처리, 더 효율적인 리소스 사용, 더 빠른 동기화를 고려해 설계되었습니다.
- 모듈형 아키텍처: 노드 로직(Zebrad)과 지갑 UI(Zallet)를 분리하면 경계가 더 명확해지고 업그레이드 경로가 개선됩니다.
- 미래 생태계 호환성: 도구, 개선 사항 및 Zcash 생태계의 나머지 부분은 점점 Zebrad/Zallet을 대상으로 하게 될 것입니다.
- 안심: 지원이 종료된 구성 요소를 계속 실행해야 하는 상황을 피할 수 있습니다.
이제 마이그레이션 가이드를 살펴보겠습니다
1. 모든 항목 백업
- zcashd 노드에서 wallet.dat(또는 다른 지갑 파일 / 키 저장소)를 백업하세요.
- zcash.conf와 모든 사용자 지정 설정을 저장하세요.
- 사용하는 RPC 스크립트나 자동화 도구의 사본을 내보내세요.
- 백업이 유효한지 확인하세요(예: 다른 환경에서 파일을 열거나 검사해 보세요).
- 현재 의존하고 있는 JSON-RPC 메서드를 검토하세요.
- Zcash 지원 사이트에서 유지 관리하는 예정 호환성 표와 비교하세요.
- 변경되거나 누락된 메서드에 대비하세요(일부는 우회 방법이나 조정이 필요할 수 있습니다).
2. 시스템 요구 사항 및 디스크 공간
- 사람들이 과소평가하는 요구 사항은 디스크 공간입니다. Zcash 체인은 2026년 8월에 270 GB를 넘었으므로, 가능하다면 SSD에서 최소 300 GB의 여유 공간을 확보하세요.
- 장비에 안정적인 네트워크, CPU, RAM이 있는지 확인하세요.
- 인터넷 연결
- 소스에서 컴파일할 계획이라면 Rust 및 Cargo가 설치되어 있어야 합니다.
3. Zebrad 설치 / 설정
사전 빌드된 바이너리를 다운로드하거나 소스에서 빌드할 수 있습니다.
옵션 A: 사전 빌드된 바이너리로 설치
Linux/macOS에서:
이 명령은 최신 안정 버전의 zebrad를 설치합니다.
옵션 B: 소스에서 빌드
빌드한 후 바이너리를 경로에 옮기세요:
4. 구성 및 시작
기본 구성을 생성하세요:
원하는 대로 zebrad.toml을 편집하세요(수신 주소, 포트, 상태 디렉터리, 캐싱).
노드 시작:
노드는 제네시스부터 동기화를 시작합니다. 하드웨어와 네트워크에 따라 몇 시간 이상 걸릴 수 있습니다.
5. Zallet(지갑) 설치 / 설정
Zallet은 zcashd의 지갑 부분을 대체하도록 설계되었습니다.
바이너리는 Zallet GitHub / 릴리스 페이지에서 확인하세요.
또는 소스에서 빌드:
- 설치 환경에서 제공하는 GUI 또는 CLI를 실행하세요.
- RPC 또는 API 엔드포인트를 통해 로컬 Zebrad 노드에 연결하도록 구성하세요.
6. zcashd 지갑을 Zallet으로 가져오기
이 작업에는 실행 중인 zcashd가 필요하지 않습니다. zcashd는 더 이상 시작할 수 없으므로, Zallet이 wallet.dat 파일을 직접 읽는다는 점이 중요합니다.
wallet.dat를 보관하세요. 마이그레이션은 Zallet 지갑으로 표현할 수 없는 항목을 가져오는 대신 보고하며, 해당 키 자료는 이후 wallet.dat에만 존재합니다. 마이그레이션 후에도 삭제하지 마세요.
먼저 zallet init-wallet-encryption을 실행하세요. Zallet은 키 자료를 age ID로 암호화하며, 키를 가져오기 전에 해당 ID가 존재해야 합니다.
그런 다음 구성과 지갑을 변환하세요:
Code-highlight
# zcash.conf를 zallet.toml로 변환
zallet migrate-zcash-conf --zcashd-datadir /path/to/zcashd/datadir -o /path/to/zallet/datadir/zallet.toml
# wallet.dat를 Zallet의 wallet.db로 가져오기
zallet migrate-zcashd-wallet --zcashd-datadir /path/to/zcashd/datadir
migrate-zcashd-wallet은 zcashd-import 기능이 포함된 빌드에만 있으며, wallet.dat를 읽으려면 zcashd가 사용한 버전인 Berkeley DB 6.2의 db_dump 유틸리티가 필요합니다. 지갑 파일이 여러 개라면 파일마다 한 번씩 명령을 실행하고, 이후 실행에는 --allow-multiple-wallet-imports를 추가하세요. 각 파일은 자체 계정 집합이 됩니다. Zallet의 JSON-RPC는 기본적으로 쿠키 인증을 사용하므로 rpcuser와 rpcpassword는 이전되지 않습니다. 필요하다면 zallet add-rpc-user로 자격 증명을 추가하세요.
가져와지는 항목
- 니모닉 시드 및 여기서 파생된 키. zcashd 지갑과 일치하도록 계정이 다시 구축됩니다.
- 독립적으로 가져온 Sapling 지출 키 및 투명 키
- 공개 키 또는 상환 스크립트를 포함하는 투명 감시 전용 항목
- 체인 스캔이 올바른 높이에서 시작되도록 하는 계정 생일 정보
가져와지지 않는 항목. 다음 항목은 가져오는 대신 개수와 함께 보고됩니다:
- Sprout 지출 키 및 자금. Zallet은 Sprout 풀을 지원하지 않습니다. 문서화된 방법은 zcashd를 폐기하기 전에 이를 사용해 Sprout 자금을 이동하는 것이었으며, 이제는 더 이상 가능하지 않습니다. 해당되는 경우 다른 작업을 하기 전에 Zcash R&D Discord 또는 커뮤니티 포럼에서 문의하세요.
- 주소록 항목
- 공개 키 또는 상환 스크립트 없이 저장된 감시 전용 항목 및 압축되지 않은 공개 키를 가진 항목
- Regtest 지갑
이후 백업. 가져온 키는 지갑 데이터베이스에만 존재하므로 니모닉만으로는 완전한 백업이 아닙니다. wallet.db, keystore.encryption_identity 옵션으로 지정된 age 암호화 ID 파일, 니모닉 문구의 안전한 사본을 보관하고, 원본 wallet.dat도 유지하세요. wallet.db 자체는 암호화되지 않습니다. 트랜잭션 기록과 보기 키를 평문으로 보관하므로 백업은 안전한 장소에 저장하세요.
지갑 재스캔 및 동기화
- 키를 가져오면 Zallet은 Zebrad를 통해 체인 재스캔을 실행합니다.
- Zallet이 잔액과 트랜잭션 기록을 다시 구축할 때까지 기다리세요.
7. 잔액 및 동기화 확인
가져오기가 완료되면 Zallet은 Zebrad 노드에 연결하여 블록체인을 재스캔합니다.
동기화가 완료되면 잔액과 트랜잭션이 이전과 정확히 동일하게 표시되어야 합니다.
다음을 실행하여 노드의 동기화 상태를 확인할 수 있습니다:
또는 로그를 확인하세요.
8. 문제 해결
| 문제 | 가능한 원인 | 해결 방법 |
|---|
| Zebrad가 시작되지 않음 | 사용 중인 포트 또는 잘못된 구성 | zebrad.toml을 확인하고 사용 가능한 포트를 사용하세요 |
| 느린 동기화 | 네트워크 혼잡 | 안정적인 인터넷 연결을 확인하고 Zebrad를 재시작하세요 |
| 지갑에 누락된 트랜잭션 | 불완전한 키 가져오기 | 키를 다시 가져오거나 Zallet에서 재스캔하세요 |
| Zallet이 노드에 연결할 수 없음 | 노드가 실행 중이 아니거나 엔드포인트가 잘못됨 | Zebrad를 시작하고 올바른 RPC 포트를 확인하세요 |
| Zallet 충돌 | 오래된 빌드 | GitHub에서 최신 릴리스로 업데이트하세요 |
9. 결론
zcashd에서 Zebrad 및 Zallet으로 마이그레이션하면 더 빠르고, 안전하며, 현대적인 Zcash 경험을 누릴 수 있습니다.
Rust 기반 보안, 모듈형 설계 및 향상된 도구를 갖춘 이 구성은 Zcash 생태계가 계속 발전하는 동안 노드와 지갑이 미래에 대비된 상태를 유지하도록 합니다.
팁: 지갑 키는 오프라인으로 보관하고 Zallet 데이터를 정기적으로 백업하세요.
Zebra는 zebra.zfnd.org를 방문하고, Zallet은 The Zallet Book 또는 Zallet 리포지토리를 확인하세요. The Zallet Book의 zcashd에서 마이그레이션 장은 6단계의 권위 있는 참고 자료입니다.
