Edit this page on GitHub (opens in a new tab)
Z3 스택은 Zcash Foundation의 패키지 노드 플랫폼입니다: Zebra (풀 노드) + Zallet (풀 노드 지갑), 선택 사항인 Zaino 인덱서. 이는 하나의 바이너리에 합의와 지갑을 함께 제공했으며 2026년 7월 18일에 지원이 종료된 독립 실행형 zcashd 프로세스를 대체하기 위한 것입니다.
기준 구현은 github.com/ZcashFoundation/z3의 Docker Compose 프로젝트입니다.
zcashd 이후 스택에서 Zebra는 체인을 검증하고 Zallet은 키를 들고 지갑 RPC를 서비스하며 Zaino(선택 사항)는 lightwalletd gRPC 프로토콜을 지원합니다.zcashd는 노드와 지갑을 함께 제공했습니다. Z3 는 해당 역할을 분할합니다. 거래소, 채굴 풀 및 기타 풀 노드 지갑 운영자는 Zebra 단독이 아닌 이 조합으로 마이그레이션합니다.Zcash의 역사 대부분 동안 zcashd는 참조 풀 노드이자 유일한 프로덕션 풀 노드 지갑이었습니다. 거래소, 채굴 풀과 커스터디 업체는 이 구조를 기준으로 통합해 왔습니다.
zcashd는 폐기되었습니다. 합의는 (그리고 현재 ) 로 이동되었습니다. 내장된 지갑이 Zallet로 이동했습니다. 라이트 지갑 서빙이 에서 로 이동하고 있습니다.
이 세 조각은 별도의 저장소, 별도의 릴리스 주기 및 별도의 설정입니다. Z3는 통합 계층입니다: 고정된 이미지, 노드가 동기화될 때까지 지갑을 시작하지 않도록 유지하는 상태 확인, 네트워크별 포트 및 볼륨, 문서화된 운영자 경로.
Z3라는 이름은 Zebra, Zaino, Zallet을 묶어 부르는 생태계의 비공식 약칭입니다. 기본 Compose 파일은 Zebra 및 Zallet만 시작합니다. Zaino는 필수 세 번째 프로세스가 아닌 Compose 프로파일입니다.
┌──────────────────────── Z3 (per network) ────────────────────────┐
│ │
peers ◄──P2P──► Zebra (zebrad) ──JSON-RPC──► Zallet │
│ full node │ embeds Zaino libraries │
│ │ wallet RPC for operators │
│ └─────────────────────────────────┤
│ │
│ Zaino (optional, --profile indexer) │
│ lightwalletd-compatible gRPC + JSON-RPC proxy │
│ │ │
└────────────┼─────────────────────────────────────────────────────┘
▼
light wallets / explorers
| 구성 요소 | Z3에서의 역할 | 필수 여부 |
|---|---|---|
| Zebra | 체인을 동기화하고 검증하며 가십, JSON-RPC, 상태 엔드포인트를 제공 | 예 |
| Zallet | 풀 노드 지갑. Zaino 라이브러리를 내장합니다. Zebra JSON-RPC에 직접 연결합니다. 독립 실행형 Zaino 컨테이너를 호출하지 않음 | 예 |
| Zaino | 독립형 인덱서. 외부 라이트 클라이언트를 위한 lightwalletd 호환 gRPC, 탐색기 및 faucet을 위한 JSON-RPC 프록시 | 아니요 — --profile indexer |
Z3는 docker-compose.yml로 이미지 버전을 고정합니다. 다른 태그가 필요하면 Z3_ZEBRA_IMAGE, Z3_ZAINO_IMAGE 또는 Z3_ZALLET_IMAGE로 재정의하세요.
| zcashd | Z3 | |
|---|---|---|
| 언어 | C++ (비트코인 포크) | Docker Compose로 오케스트레이션된 Rust 서비스 |
| 프로세스 모델 | 하나의 바이너리: 노드 + 지갑 | 노드 및 지갑 컨테이너 분리 |
| 합의 | 지원 종료 (EOS 2026년 7월 18일) | Zebra (또는 다른 호환 노드) |
| 지갑 | 내장 wallet.dat | Zallet, age로 암호화된 데이터 디렉터리 |
| 라이트 클라이언트 | 일반적으로 별도의 lightwalletd | Zaino 프로필 (선택 사항) |
| 구성 | zcash.conf | config/<network>/ + Compose env 파일 아래의 네트워크당 파일 |
| 단일 호스트의 네트워크 | 번거로운 포트 충돌 |
여전히 zcashd 지갑이 있는 경우 wallet.dat를 Z3 볼륨으로 복사하지 말고 ZecHub의 및 Zallet의 migrate-zcashd-wallet 명령을 사용하십시오.
Z3는 3개의 독립적인 Compose 프로젝트입니다. 포트나 볼륨을 공유하지 않습니다.
| 네트워크 | 프로젝트 이름 | 다음 용도로 사용하세요. | 첫 번째 동기화 | 실제 자금 사용 |
|---|---|---|---|---|
| 메인넷 | z3-mainnet | 프로덕션 | 24 ~ 72시간 | 예 |
| 테스트넷 | z3-testnet | 공개 테스트 네트워크에서의 스테이징 | 2 ~ 12시간 | 아니요 (ZEC 테스트) |
| regtest | z3-regtest | 로컬 연습: 즉시 생성되는 블록, 피어 없음 | 초 | 아니요 |
새 운영자는 regtest 에서 시작하여 RPC 및 지갑 흐름을 확인한 다음 테스트넷 또는 메인넷으로 이동해야 합니다.
세 네트워크는 모두 한 머신에 공존하기 위한 것입니다. 아래 값은 게시된 기본값입니다. 모든 값은 일치하는 Z3_* env var를 통해 재정의할 수 있습니다. 표준 구성표는 z3-contract.yaml입니다.
| 서비스 | 메인넷 | 테스트넷 | Regtest |
|---|---|---|---|
| Zebra JSON-RPC | 8232 | 18232 | 29232 |
| Zebra P2P | 8233 | 18233 | 외부에 노출하지 않음 |
Zebra 상태 확인 (/ready) | 8080 | 18080 | 28080 |
| Zaino gRPC (인덱서 프로파일) | 8137 | 18137 | 28137 |
| Zaino JSON-RPC (인덱서 프로파일) | 8237 | 18237 | 28237 |
| Zallet RPC | 28232 | 40232 | 50232 |
Compose 네트워크 내에서 서비스 이름으로 접근합니다 (zebra, zaino, zallet).
| 볼륨 | 보유 항목 | 백업 필요 여부 |
|---|---|---|
z3-<network>-chain | Zebra 체인 상태 (~ 300GB 메인넷) | 선택 사항 — 재동기화 가능 |
z3-<network>-zallet | 암호화된 지갑 데이터베이스 및 잠금을 해제하는 age identity | 예 — 백업해야 하는 유일한 볼륨입니다 |
z3-<network>-zaino | 인덱서 상태 (인덱서 프로파일이 있는 경우에만) | 선택 사항 — 재구축 가능 |
z3-<network>-cookie | Zebra RPC 쿠키 | 아니요 — 재생성됨 |
처음 시작하기 전에 다른 디스크에 체인 상태를 두려면:
export Z3_CHAIN_DATA_PATH=/mnt/ssd/zebra-state
./scripts/fix-permissions.sh zebra /mnt/ssd/zebra-state
docker compose --env-file .env.<network> --profile "*" down는 스택을 중지하고 볼륨을 유지합니다. -v를 추가하면 삭제되고 완전히 재동기화됩니다. 프로필로 활성화한 서비스 (인덱서, 모니터링) 가 실제로 종료되도록 --profile "*"를 포함하십시오.
필수 조건: Docker Engine, Docker Compose v2.24.4+, Git. openssl는 regtest에만 필요합니다.
git clone https://github.com/ZcashFoundation/z3 && cd z3
./scripts/regtest-init.sh
docker compose --env-file .env.regtest up -d
테스트 명령은 docs/regtest.md를 참조하십시오.
Zebra는 Zallet가 유용하기 전에 동기화를 완료해야 합니다. Zallet를 일찍 시작하면 /ready가 true가 될 때까지 재시작을 반복합니다.
git clone https://github.com/ZcashFoundation/z3 && cd z3
# 1. One-time setup: local config + Zallet wallet identity
./scripts/setup-network.sh mainnet
# 2. Start Zebra and wait until it is synced
docker compose --env-file .env.mainnet up -d zebra
./scripts/check-zebra-readiness.sh
# 3. Start Zallet (and anything else in the default profile)
docker compose --env-file .env.mainnet up -d
테스트넷은 .env.testnet 및 ./scripts/check-zebra-readiness.sh 18080와 동일한 흐름입니다.
config/<network>/에 따른 편집은 로컬에 유지되며 git pull 후에도 유지됩니다.
# Lightwalletd-compatible gRPC + JSON-RPC proxy
docker compose --env-file .env.mainnet --profile indexer up -d
# Prometheus, Grafana, Jaeger, Alertmanager
docker compose --env-file .env.mainnet --profile monitoring up -d
기본 Grafana 포트는 3000 (메인넷), 13000 (테스트넷), 23000 (regtest) 입니다.
:latest를 사용하지 않습니다. 검토를 거쳐 고정 버전을 변경하거나 Z3_<SERVICE>_IMAGE를 설정합니다.ZEBRA_NETWORK__EXTERNAL_ADDR를 피어가 접속할 주소로 설정합니다. Regtest에는 피어가 없습니다.linux/amd64 전용입니다. Apple Silicon에서는 소스에서 빌드하지 않는 한 에뮬레이션으로 실행됩니다. Zebra와 Zallet은 멀티 아키텍처를 지원합니다.deploy.resources.limits를 추가합니다.프로덕션 환경 체크리스트와 FAQ는 docs/faq.md 및 docs/docker-architecture.md를 참고하세요.
적합한 경우
zcashd를 노드 플러스 지갑으로 사용한 거래소, 커스터디 업체 및 채굴 풀일반적으로 적합하지 않은 경우
기본 지원: z3-mainnet, z3-testnet, z3-regtest |