Full node zcashd tradisional, yang dikelola oleh Electric Coin Company (ECC) / Zodl, telah digantikan oleh Zebra dan Zallet. zcashd mencapai penghentian akhir-dukungan pada 18 Juli 2026 dan tidak lagi berjalan.

Panduan ini akan membimbing kamu melalui migrasi dari zcashd ke Zebrad dan Zallet, termasuk pengaturan, impor dompet, dan pemecahan masalah umum terkait migrasi.
Bahkan jika mengesampingkan masalah deprecation, ada alasan kuat untuk beralih:
cp ~/.zcash/wallet.dat ~/wallet_backup.datKamu bisa mengunduh biner yang sudah jadi atau membangunnya dari source.
Zcash Foundation merilis rilis dan biner untuk Zebra. Misalnya, kamu mungkin menggunakan skrip instalasi atau mengunduh biner yang sesuai untuk OS kamu.
Perhatikan bahwa pada versi Zebra terbaru, endpoint RPC tidak lagi diaktifkan secara default di Docker.
Opsi A: Instal melalui biner yang sudah jadi
Pada Linux/macOS:
curl -L https://get.zebra.zfnd.org | bashIni menginstal versi stabil terbaru dari zebrad.
git clone https://github.com/ZcashFoundation/zebra.git
cd zebra
cargo build --releaseSetelah melakukan build, pindahkan file binary ke dalam path kamu:
sudo mv target/release/zebrad /usr/local/bin/Buat konfigurasi default:
zebrad generate-config > ~/.config/zebra/zebrad.tomlEdit zebrad.toml sesuai preferensi kamu (alamat listen, port, direktori state, caching).
Mulai node:
zebrad startNode akan mulai melakukan sinkronisasi dari genesis - perkirakan beberapa jam (atau lebih) tergantung pada perangkat keras dan jaringan.
Zallet dirancang untuk menggantikan bagian dompet dari zcashd.
Periksa halaman rilis Zallet GitHub untuk mendapatkan file binary.
Atau bangun dari sumber (build from source):
git clone https://github.com/ZcashFoundation/zallet.git
cd zallet
cargo build --releaseKamu tidak memerlukan zcashd yang sedang berjalan untuk ini. Zallet membaca file wallet.dat secara langsung, hal ini penting karena zcashd tidak lagi dapat dimulai.
Tetap simpan
wallet.dat. Migrasi akan melaporkan apa pun yang tidak dapat direpresentasikannya dalam dompet Zallet alih-alih mengimpornya, dan materi kunci tersebut kemudian hanya ada diwallet.dat. Jangan menghapusnya setelah melakukan migrasi.
Jalankan zallet init-wallet-encryption terlebih dahulu. Zallet mengenkripsi materi kunci ke sebuah identitas age, dan identitas tersebut harus sudah ada sebelum kunci apa pun diimpor.
Kemudian konversi konfigurasi dan dompet kamu:
# translate zcash.conf into zallet.toml
zallet migrate-zcash-conf --zcashd-datadir /path/to/zcashd/datadir -o /path/to/zallet/datadir/zallet.toml
# import wallet.dat into Zallet's wallet.db
zallet migrate-zcashd-wallet --zcashd-datadir /path/to/zcashd/datadir
migrate-zcashd-wallet hanya tersedia pada build dengan fitur zcashd-import, dan membaca wallet.dat memerlukan utilitas db_dump dari Berkeley DB 6.2, versi yang digunakan oleh zcashd. Jika kamu memiliki lebih dari satu file dompet, jalankan perintah tersebut satu kali per file dan tambahkan --allow-multiple-wallet-imports pada proses selanjutnya; masing-masing akan menjadi set akun tersendiri. rpcuser dan rpcpassword kamu tidak akan terbawa, karena JSON-RPC milik Zallet menggunakan autentikasi cookie secara default; tambahkan kredensial dengan zallet add-rpc-user jika kamu membutuhkannya.
Apa yang tidak terbawa. Hal-hal ini dilaporkan dengan jumlah hitungan, bukan diimpor:
Mencadangkan setelahnya. Sebuah mnemonik saja bukanlah cadangan yang lengkap, karena kunci yang diimpor hanya ada di dalam database dompet. Simpan salinan aman dari wallet.db, file identitas enkripsi lama yang dinamai oleh opsi keystore.encryption_identity, dan frasa pemulihan kamu, serta simpan wallet.dat yang asli. Perhatikan bahwa wallet.db itu sendiri tidak terenkripsi: file ini menyimpan riwayat transaksi dan viewing key kamu secara terbuka, jadi simpanlah cadangan tersebut di tempat yang aman.
Setelah diimpor, Zallet akan terhubung ke node Zebrad kamu dan memindai ulang blockchain. Saat sinkronisasi selesai, saldo dan transaksi kamu seharusnya muncul persis seperti sebelumnya.
Kamu dapat memverifikasi status sinkronisasi node kamu dengan menjalankan:
zebrad metricsAtau periksa log.
tail -f ~/.local/share/zebra/zebrad.log| Masalah | Kemungkinan Penyebab | Solusi |
|---|---|---|
| Zebrad tidak mau berjalan | Port sedang digunakan atau konfigurasi buruk | Periksa zebrad.toml dan gunakan port yang bebas |
| Sinkronisasi lambat | Kongesti jaringan | Pastikan internet stabil, mulai ulang Zebrad |
| Dompet kehilangan transaksi | Impor key tidak lengkap | Impor ulang key atau pindai ulang di Zallet |
| Zallet tidak dapat terhubung ke node | Node tidak berjalan atau endpoint salah | Jalankan Zebrad dan verifikasi port RPC yang benar |
| Zallet crash | Build sudah usang | Perbarui ke rilis terbaru dari GitHub |
Beralih dari zcashd ke Zebrad dan Zallet memberi kamu pengalaman Zcash yang lebih cepat, aman, dan modern. Dengan keamanan berbasis Rust, desain modular, dan tooling yang lebih baik, pengaturan ini memastikan node dan dompet kamu tetap siap menghadapi masa depan seiring dengan ekosistem Zcash yang terus berkembang.
Tip: Simpan kunci dompet kamu secara offline dan cadangkan data Zallet kamu secara rutin. Kunjungi zebra.zfnd.org untuk Zebra, dan Buku Zallet atau repositori Zallet untuk Zallet. Bab Migrating from zcashd dari Buku Zallet adalah referensi otoritatif untuk langkah 6.