Edit this page on GitHub (opens in a new tab)
Zallet adalah dompet Zcash full-node yang ditulis dalam Rust. Ini merupakan pengganti untuk dompet yang sebelumnya tertanam di zcashd. Setelah zcashd mencapai penghentian End-of-Support pada 18 Juli 2026 di ketinggian blok 3417100, tugas konsensus dan dompet dibagi: Zebra atau Zakura memvalidasi chain, dan Zallet menyimpan key, memindai note, dan menyediakan wallet JSON-RPC.
Zallet saat ini berada dalam tahap beta. Fitur ini belum ditinjau sepenuhnya. Perubahan yang merusak (breaking changes) mungkin mengharuskan Anda menghapus dan membuat ulang dompet. Jangan menggunakannya sebagai kustodial produksi untuk jumlah ZEC yang besar tanpa membaca peringatan keamanan di Buku Zallet.
zcashd. Bagian node adalah Zebra atau Zakura.zebrad 7.0.0 atau lebih baru.ReadStateService terhadap direktori state zebrad pada host yang sama, serta JSON-RPC milik Zebra. Backend Zaino dihapus pada v0.1.0-beta.4.wallet.db.zallet (launcher) dan zallet-zebra. Hanya Linux yang dapat digunakan untuk menyinkronkan dompet: backend chain belum berjalan di macOS maupun Windows.zallet backup (baru di beta.4) mengambil snapshot konsisten dari dompet yang sedang berjalan atau berhenti.zcashd menggabungkan sebuah node konsensus turunan Bitcoin Core dan sebuah dompet dalam satu proses. Desain tersebut sudah tidak ada lagi.
| Peran | Stack lama | Stack saat ini |
|---|---|---|
| Konsensus / P2P | zcashd | Zebra (zebrad) atau Zakura |
| Dompet / kunci / saldo | zcashd wallet.dat | Zallet (wallet.db) |
| Indexer light-client | lightwalletd | Zaino atau lightwalletd |
Memisahkan dompet dari node berarti:
zcashd.Zallet adalah dompet yang ditujukan bagi operator yang sebelumnya menjalankan zcashd sebagai hot wallet, backend exchange, faucet, atau dompet pembayaran penambangan.
Zallet sedang dalam tahap beta.
Apa artinya hal tersebut dalam praktiknya:
zcashd telah dipindahkan.zcashd. Integrasi harus membaca halaman semantik-yang-diubah.Umpan balik dikirimkan ke GitHub masalah atau saluran #wallet-dev di Zcash R&D Discord.
Fase stabil selanjutnya direncanakan setelah permukaan RPC yang dimaksud tersedia. Pemanggil kemudian diharapkan untuk bermigrasi ke metode-metode Zallet, termasuk perbedaan semantik yang telah didokumentasikan.
Zallet dibagi ke dalam beberapa workspace Cargo agar setiap backend chain dapat melacak grafik dependensinya sendiri. Sejak v0.1.0-beta.4, hanya backend zebra yang disertakan.
zallet launcher: reads `backend` in zallet.toml (default "zebra")
and execs zallet-zebra
zallet-core shared wallet: CLI, config, JSON-RPC, SQLite DB, sync
zallet-zebra zebra-state backend (ReadStateService + Zebra JSON-RPC)
Kedua biner tersebut membuka wallet.db yang sama. Hingga v0.1.0-beta.3, tersedia juga backend zallet-zaino. Jika zallet.toml Anda bertuliskan backend = "zaino", ubah menjadi backend = "zebra". Database dompet tidak memerlukan migrasi, dan folder zaino lama di direktori data dapat dihapus.
Backend zebra membaca langsung database state milik zebrad, jadi backend ini memerlukan zebrad yang dibuat dengan fitur indexer dan direktori state-nya di host yang sama. Zallet di satu container yang berkomunikasi melalui jaringan dengan zebrad di container lain belum memiliki konfigurasi yang didukung sampai backend khusus jaringan tersedia (zallet#900).
Penerapan umum:
zebrad (or Zakura)
│ JSON-RPC / ReadStateService
▼
Zallet (zallet-zebra)
│ JSON-RPC on 127.0.0.1
▼
Your application, exchange, faucet, or operator scripts
Zallet adalah dompet full-node: ia memerlukan node validasi lokal. Ini bukan sebuah light client. Untuk dompet ringan dan server compact-block, lihat Zaino dan Node Lightwallet.
Compose stack Z3 milik Zcash Foundation menjalankan Zebra + Zallet bersama-sama, dengan Zaino opsional yang berdiri sendiri untuk light client eksternal. Image yang dipatok versinya dibuat sebelum NU7 dan beta.4 Zallet: lihat Z3 Stack sebelum menggunakannya.
Zallet dibangun di sekitar 32 akun ZIP, bukan satu akun implisit milik zcashd.
zip32seedfp1…).(seedfp, account index).z_getaddressforaccount. Satu akun dapat memiliki banyak alamat yang terdiversifikasi; penerima terlindungi tidak dapat ditautkan secara on-chain.z_importkey) dan alamat watch-only (z_importaddress) menjadi akun UUID yang tidak dicakup oleh mnemonik apa pun.z_exportviewingkey, z_importviewingkey), termasuk unified full viewing keys dan incoming viewing keys.getnewaddress belum diimplementasikan. Gunakan z_getnewaccount dan z_getaddressforaccount.
Jika keystore.require_backup berada pada (bentuk migrasi dari walletrequirebackup milik zcashd), Zallet menolak untuk menurunkan otoritas pengeluaran baru dari mnemonic yang cadangannya belum dikonfirmasi.
Materi kunci selalu dienkripsi. Tidak ada mode tanpa enkripsi dan tidak ada RPC encryptwallet — metode zcashd tersebut tidak pernah didukung sepenuhnya.
{datadir}/encryption-identity.txt.wallet.db.generate-encryption-identity -p). Buka kunci dengan RPC walletpassphrase; kunci dengan walletlock.wallet.db yang Anda simpan.Menyalin wallet.db secara manual saat Zallet berjalan bukanlah cara pencadangan yang aman: SQLite dapat mengalami kerusakan. Sejak v0.1.0-beta.4, gunakan perintah backup:
zallet -d /path/to/zallet/datadir backup /path/to/backups/
Fitur ini menulis snapshot yang konsisten terhadap transaksi dan telah diperiksa integritasnya dari dompet yang sedang berjalan atau berhenti. Jika diberi direktori, fitur ini memberi nama file zallet-wallet-backup-<UTC time>.db, dan tidak pernah menimpa file yang sudah ada. Fitur ini akan berhenti dan menampilkan kesalahan setelah sepuluh menit jika penulisan terus-menerus ke dompet (misalnya saat sinkronisasi awal) terus mengulang proses penyalinan: coba lagi nanti atau hentikan dompet terlebih dahulu. Cadangan ini tidak menyertakan file identitas age. Cadangkan file tersebut sekali dan simpan terpisah dari cadangan basis data, karena siapa pun yang memiliki keduanya dapat mendekripsi kuncinya.
Zallet mengimplementasikan subset dari RPC dompet zcashd melalui HTTP dengan Basic auth. Hubungkan ke loopback. Penggunaan jarak jauh harus melalui terowongan terenkripsi. rpc.allow_insecure_remote_bind tersedia dan tidak aman.
Perbedaan penting dari zcashd:
getwalletinfo kosong. Gunakan z_getbalances, z_getbalanceforaccount, z_gettotalbalance.settxfee.ClientInInitialDownload / ForbiddenBySafeMode).Metode yang sengaja dihilangkan meliputi createrawtransaction, fundrawtransaction, getnewaddress, getrawchangeaddress, keypoolrefill, importwallet, dan encryptwallet. Penggantinya tercantum dalam Buku Zallet.
Jalur instalasi resmi (paket Debian, Docker, biner rilis) tersedia di panduan instalasi. Arsip rilis diberi nama zallet-v<version>-linux-<amd64|arm64>.tar.gz dan berisi zallet dan zallet-zebra. Image Docker dipublikasikan sebagai zodlinc/zallet.
Alur dompet baru minimal:
# data directory; default is $HOME/.zallet
zallet -d /path/to/zallet/datadir example-config > /path/to/zallet/datadir/zallet.toml
# edit zallet.toml: network, indexer.validator_address, [indexer.read_state_service], 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
Arahkan [indexer] ke endpoint JSON-RPC zebrad lokal dengan validator_address. Ini wajib diisi dan nilai default-nya bukan localhost. Backend zebra juga memerlukan [indexer.read_state_service] dan zebrad versi 7.0.0 atau yang lebih baru, yang dibangun dengan fitur indexer, dengan direktori statusnya di host yang sama agar Zallet dapat membaca status chain secara langsung. indexer.db_path hanya mengonfigurasi backend Zaino yang telah dihapus: kini pengaturan ini diabaikan dengan peringatan.
Gambar yang dapat direproduksi dapat dibuat dengan StageX (Docker 25+, containerd image store, GNU Make).
Simpan zcashd datadir lama hingga Anda telah mengonfirmasi saldo dan melakukan pemulihan yang telah diuji.
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 hanya tersedia dalam build dengan fitur zcashd-import. Membaca wallet.dat memerlukan db_dump dari Berkeley DB 6.2, versi yang digunakan oleh zcashd.
Catatan operator langkah demi langkah: .
| Zallet | zecd | ZODL (Zashi) / Zingo / Zkool | Zebra / Zakura | Zaino | |
|---|---|---|---|---|---|
| Kegunaan | Dompet RPC full node | Server dompet yang mengutamakan alamat terlindungi | Dompet pengguna akhir | Node konsensus | Pengindeks / pengganti lightwalletd |
| Menggantikan | Dompet zcashd | Bukan tiruan zcashd yang dapat langsung digunakan | Aplikasi seluler/desktop | Node zcashd | lightwalletd |
| Membutuhkan node lokal | Ya | Ya (Zebra secara default) | Tidak (light client) | Node itu sendiri | Ya |
Zallet dan zecd keduanya dapat diletakkan di depan Zebra. Pilih Zallet saat Anda membutuhkan permukaan dompet z_* dan jalur migrasi dari wallet.dat. Pilih zecd saat Anda menginginkan server yang mengutamakan-transaksi-terlindungi yang secara eksplisit bukan merupakan klon zcashd.
Terdapat produk konsumen terpisah di zallet.io yang menggunakan nama yang sama. Aplikasi tersebut bukanlah proyek ini.
zcashd yang sudah tidak digunakan| Kompatibilitas RPC zcashd |
| Dirancang sebagai jalur kompatibilitas |
| Hanya subset kecil yang dipilih |
| T/A |
| Mode kompatibilitas parsial / Zakura |
| API berbeda |
| Model kustodi | Operator memegang kunci di wallet.db | Server yang dapat dipulihkan dengan seed | Kunci di perangkat pengguna | Tidak ada dompet | Tidak ada kunci |