Edit this page on GitHub (opens in a new tab)
Zallet은 Rust로 작성된 풀 노드 Zcash 지갑입니다. zcashd에 내장되었던 지갑의 대체품입니다. zcashd가 2026년 7월 18일 블록 높이 3417100에서 지원 종료 시점에 도달한 후 합의와 지갑 역할이 분할되었습니다. Zebra 또는 Zakura는 체인의 유효성을 검사하고 Zallet은 키를 보유하고 메모를 스캔하며 지갑 JSON-RPC를 노출합니다.
Zallet은 현재 베타 상태입니다. 전체 검토가 완료되지 않았습니다. 호환성을 깨는 변경으로 인해 지갑을 삭제하고 다시 만들어야 할 수 있습니다. The Zallet Book의 보안 경고를 읽지 않고 많은 양의 ZEC에 대한 프로덕션 커스터디용 소프트웨어로 취급하지 마십시오.
zcashd의 지갑 절반을 대체합니다. 노드 절반은 Zebra 또는 Zakura입니다.zebrad에 대해 직접 ReadStateService) 또는 Zaino의 두 백엔드 중 하나를 통해 체인 데이터에 접근합니다.wallet.db에 암호화되지 않은 상태로 저장됩니다.zallet (런처), zallet-zebra 및 zallet-zaino의 세 가지 바이너리를 제공합니다.zcashd는 하나의 프로세스에서 비트코인 코어 파생 합의 노드와 지갑을 번들로 제공했습니다. 그 디자인은 사라졌습니다.
| 역할 | 기존 스택 | 현재 스택 |
|---|---|---|
| 합의/P2P | zcashd | Zebra (zebrad) 또는 Zakura |
| 지갑/키/잔액 | zcashd wallet.dat | Zallet (wallet.db) |
| 라이트 클라이언트 인덱서 | lightwalletd | Zaino 또는 lightwalletd |
노드에서 지갑을 분리하면 다음을 의미합니다.
zcashd의 특성에 고정되지 않고 ZIP 32 계정, Unified Addresses 및 PCZT로 진화할 수 있습니다.Zallet은 이전에 핫 지갑, 거래소 백엔드, faucet 또는 채굴 대금 지갑으로 zcashd를 실행한 운영자를 위한 지갑입니다.
Zallet은 베타 버전입니다.
이것이 실제로 의미하는 바는 다음과 같습니다.
zcashd 지갑 RPC가 포팅된 것은 아닙니다.zcashd와 다릅니다. 통합은 altered-semantics page를 읽어야 합니다.피드백은 GitHub issues 또는 Zcash R&D Discord의 #wallet-dev 채널에 남길 수 있습니다.
의도된 RPC 기능 범위가 존재하면 나중에 안정 단계가 계획됩니다. 안정화 이후 호출자는 문서화된 의미 차이를 포함하여 Zallet의 메서드로 마이그레이션해야 합니다.
Zallet은 세 개의 Cargo 워크스페이스에 분할되어 두 개의 체인 백엔드가 서로 다른 의존성 그래프를 추적할 수 있습니다.
zallet launcher: reads `backend` in zallet.toml (default "zebra")
and execs zallet-zebra or zallet-zaino
zallet-core shared wallet: CLI, config, JSON-RPC, SQLite DB, sync
zallet-zebra zebra-state backend (ReadStateService + Zebra JSON-RPC)
zallet-zaino Zaino indexer backend
세 바이너리는 모두 동일한 wallet.db를 엽니다. 런처는 런타임에 백엔드를 선택합니다. 백엔드 전환을 위해 다시 컴파일할 필요가 없습니다.
일반적인 배포:
zebrad (or Zakura)
│ JSON-RPC / ReadStateService
▼
Zallet (zallet-zebra or zallet-zaino)
│ JSON-RPC on 127.0.0.1
▼
Your application, exchange, faucet, or operator scripts
Zallet은 풀 노드 지갑 입니다. 로컬 검증 노드가 필요합니다. 라이트 클라이언트가 아닙니다. 라이트 지갑 및 컴팩트 블록 서버에 대해서는 Zaino 및 Lightwallet Nodes를 참조하십시오.
Zcash Foundation의 Z3 Compose 스택은 Zebra + Zallet를 함께 실행하며, 외부 라이트 클라이언트를 위한 독립형 Zaino 옵션이 있습니다.
Zallet은 zcashd의 단일 암시적 계정이 아닌 ZIP 32 계정을 기반으로 구축됩니다.
zip32seedfp1…)으로 식별되는 독립적인 지출 루트입니다.(seedfp, account index)입니다.z_getaddressforaccount로 생성된 ZIP 316 Unified Addresses입니다. 하나의 계정에는 여러 다변화 주소가 있을 수 있습니다. shielded receiver는 체인 상에서 연결할 수 없습니다.z_importkey)와 watch-only 주소(z_importaddress)는 니모닉이 포함되지 않는 UUID 계정이 됩니다.z_exportviewingkey, z_importviewingkey).getnewaddress가 구현되지 않았습니다. z_getnewaccount 및 z_getaddressforaccount를 사용하십시오.
keystore.require_backup이 켜져 있는 경우 (zcashd의 walletrequirebackup의 마이그레이션된 형태), Zallet은 백업이 확인되지 않은 니모닉에서 새로운 지출 권한을 파생하는 것을 거부합니다.
키 자료는 항상 암호화됩니다. 암호화되지 않은 모드와 encryptwallet RPC가 없습니다. 이 zcashd 메서드는 완전히 지원되지 않았습니다.
{datadir}/encryption-identity.txt가 생성됩니다.wallet.db에 age 암호문으로 저장됩니다.generate-encryption-identity -p). walletpassphrase RPC로 잠금을 해제하고 walletlock으로 잠급니다.wallet.db 사본, 모든 니모닉 및 (별도로 암호화된) identity를 백업하세요.Zallet이 실행되는 동안 wallet.db를 복사하는 것은 안전한 백업이 아닙니다. SQLite 파일이 불완전하게 복사될 수 있습니다. 프로세스를 중지한 뒤 복사하거나 공식 온라인 백업 명령을 기다리십시오.
Zallet은 Basic 인증을 사용하여 HTTP를 통해 zcashd 지갑 RPC의 하위 집합을 구현합니다. 루프백 주소에 바인딩하세요. 원격 사용은 암호화된 터널을 통과해야 합니다. rpc.allow_insecure_remote_bind가 존재하며 안전하지 않습니다.
zcashd와의 주목할 만한 차이점:
getwalletinfo의 잔액 필드가 비어 있습니다. z_getbalances, z_getbalanceforaccount, z_gettotalbalance를 사용합니다.settxfee가 없습니다.ClientInInitialDownload / ForbiddenBySafeMode) 잔액과 지출 RPC를 차단합니다.의도적으로 생략된 방법에는 createrawtransaction, fundrawtransaction, getnewaddress, getrawchangeaddress, keypoolrefill, importwallet 및 encryptwallet가 포함됩니다. 대체 메서드는 Zallet Book에 나열되어 있습니다.
공식 설치 경로 (Debian 패키지, Docker, 릴리스 바이너리)는 installation guide에 있습니다. 릴리스 아카이브의 이름은 zallet-<version>-<arch>.tar.gz이며 세 가지 바이너리를 모두 포함합니다.
최소 새 지갑 흐름:
# data directory; default is $HOME/.zallet
zallet -d /path/to/zallet/datadir example-config > /path/to/zallet/datadir/zallet.toml
# edit zallet.toml: network, backend, indexer / read-state, rpc.bind
zallet -d /path/to/zallet/datadir generate-encryption-identity
zallet -d /path/to/zallet/datadir init-wallet-encryption
zallet -d /path/to/zallet/datadir generate-mnemonic
zallet -d /path/to/zallet/datadir confirm-backup
zallet -d /path/to/zallet/datadir start
로컬 zebrad JSON-RPC 엔드포인트에서 [indexer]를 가리킵니다. zebra 백엔드는 또한 [indexer.read_state_service]와 Zallet이 체인 상태를 직접 읽을 수 있도록 인덱서 기능으로 구축된 zebrad를 원합니다.
재현 가능한 이미지는 StageX (Docker 25+, containerd image store, GNU Make) 로 만들 수 있습니다.
잔액과 테스트된 복원이 확인될 때까지 이전 zcashd 데이터 디렉터리를 보관하십시오.
zallet init-wallet-encryption
zallet migrate-zcash-conf --zcashd-datadir /path/to/zcashd/datadir \
-o /path/to/zallet/datadir/zallet.toml
zallet migrate-zcashd-wallet --zcashd-datadir /path/to/zcashd/datadir
migrate-zcashd-wallet은 zcashd-import 기능으로만 빌드됩니다. wallet.dat를 읽으려면 zcashd가 사용된 버전인 Berkeley DB 6.2의 db_dump가 필요합니다.
단계별 운영자 안내: .
| Zallet | zecd | Zashi/ZODL/YWallet | Zebra/Zakura | Zaino | |
|---|---|---|---|---|---|
| 구분 | 풀 노드 RPC 지갑 | shielded 우선 지갑 서버 | 최종 사용자 지갑 | 합의 노드 | 인덱서/lightwalletd 대체 |
| 대체 대상 | zcashd 지갑 | drop-in zcashd 클론이 아님 | 모바일/데스크톱 앱 | zcashd 노드 | lightwalletd |
| 로컬 노드가 필요합니다 | 예 | 예 (기본적으로 Zebra) | 아니요 (라이트 클라이언트) | 노드입니다 | 예 |
| zcashd RPC 호환성 | 호환 경로로 설계 |
Zallet과 zecd는 모두 Zebra 앞단에서 동작할 수 있습니다. z_* 지갑 RPC 기능과 wallet.dat에서 마이그레이션 경로가 필요할 때 Zallet를 선택하십시오. zcashd 클론을 명시적으로 아닌 shielded 우선 서버를 원할 때 zecd를 선택하십시오.
zallet.io에는 이름을 재사용하는 별도의 일반 사용자용 제품이 있습니다. 해당 앱은 이 프로젝트가 아닙니다.
zcashd 노드| 선택된 소규모 하위 집합만 |
| 해당 사항 없음 |
| 부분 지원 / Zakura 호환 모드 |
| 다른 API |
| 커스터디 모델 | 운영자가 wallet.db에서 키를 보유함 | 시드 복구 가능 서버 | 사용자 장치 키 | 지갑 없음 | 키 없음 |