Zebra (zebrad) adalah Zcash full node yang ditulis dalam Rust dan dikelola oleh Zcash Foundation.
Ia memvalidasi blok dan transaksi, menjaga status chain, dan berkomunikasi dengan node lain melalui jaringan peer-to-peer.
Zebra dan zcashd mengimplementasikan protokol yang sama dan dapat saling beroperasi. Sejak pensiunnya zcashd, Zebra menjalankan peran konsensus.
Dua cara untuk menjalankannya: menggunakan image Docker zfnd/zebra, atau build dari source.
Perangkat keras yang direkomendasikan adalah 4 core CPU, RAM 16 GB, dan disk 300 GB. Spesifikasi minimum adalah 2 core dan RAM 4 GB, dengan disk 300 GB yang sama.
Zebra adalah Zcash node pertama yang ditulis sepenuhnya dalam Rust. Node ini berada di jaringan peer-to-peer Zcash, di mana ia memvalidasi dan menyiarkan transaksi serta menjaga status blockchain. Memiliki implementasi independen kedua membuat infrastruktur jaringan menjadi tidak terlalu bergantung pada satu basis kode tunggal.
Zebra dan zcashd
Node Zcash asli, zcashd, dikembangkan oleh Electric Coin Company dari basis kode Bitcoin. Zebra ditulis dari awal menggunakan Rust, bahasa yang aman secara memori, dengan fokus pada keamanan dan efisiensi.
Kedua implementasi mengikuti protokol yang sama, sehingga keduanya dapat berkomunikasi dan berinteroperabilitas. zcashd mencapai penghentian End-of-Support pada 18 Juli 2026 dan tidak lagi berjalan, yang membuat Zebra dan Zakura menjadi implementasi node yang digunakan. Lihat untuk gambaran yang lebih luas.
Anda dapat menjalankan Zebra menggunakan image Docker, atau Anda dapat membangunnya secara manual. Silakan lihat bagian Persyaratan Sistem.
Penggunaan Docker
Untuk menjalankan rilis terbaru dan menyinkronkannya hingga ke ujung (tip), jalankan perintah berikut:
docker run zfnd/zebra:latest
Untuk instruksi lengkap, silakan merujuk ke dokumentasi Docker.
Membangun Zebra
Membangun Zebra memerlukan Rust, libclang, dan kompiler C++.
Pastikan Anda telah menginstal versi Rust stabil terbaru, karena Zebra secara eksklusif diuji dengan versi tersebut.
Dependensi build yang diperlukan meliputi:
libclang (juga dikenal sebagai libclang-dev atau llvm-dev)
clang atau kompiler C++ lainnya (seperti g++ untuk semua platform atau Xcode untuk macOS)
protoc (kompiler Protocol Buffers) dengan flag --experimental_allow_proto3_optional, yang diperkenalkan dalam Protocol Buffers v3.12.0 (dirilis pada 16 Mei 2020).
Instal dan Mulai
Pada x86_64 atau aarch64 Linux dengan glibc 2.34 atau yang lebih baru (Ubuntu 22.04+, Debian 12+, RHEL 9+, Amazon Linux 2023), Anda dapat melewati dependensi build dan menginstal biner pra-rilis yang telah ditandatangani:
cargo binstall zebrad
Binary yang sama dilampirkan pada setiap rilis GitHub sebagai zebrad-<version>-<target>.tar.gz, masing-masing dengan checksum SHA-256, atestasi Sigstore build-provenance, dan tanda tangan Cosign. Pada platform lama, gunakan image Docker atau bangun dari sumbernya (source).
Untuk membangun dari sumbernya, dapatkan kodenya dan bangun biner rilis:
git clone https://github.com/ZcashFoundation/zebra.git
cd zebra
cargo build --release --bin zebrad
zebrad.toml yang dihasilkan akan ditempatkan di direktori preferensi default Linux. Untuk lokasi default pada OS alternatif lainnya, silakan merujuk ke dokumentasi.
Mengonfigurasi Bilah Kemajuan
Konfigurasikan tracing.progress_bar di dalam zebrad.toml Anda untuk menampilkan metrik utama di terminal menggunakan progress bar. Catatan: Terdapat masalah yang diketahui di mana estimasi progress bar dapat menjadi sangat besar.
Mengonfigurasi Penambangan
Zebra dapat dikonfigurasi untuk penambangan dengan menentukan MINER_ADDRESS dan pemetaan port di Docker. Detail lebih lanjut dapat ditemukan dalam dokumentasi dukungan penambangan.
Fitur Build Kustom
Perluas fungsionalitas Zebra dengan fitur Cargo tambahan seperti metrik Prometheus, pemantauan Sentry, dukungan eksperimental Elasticsearch, dan banyak lagi.
Gabungkan beberapa fitur dengan mencantumkannya sebagai parameter dari flag --features selama instalasi.
Beberapa fitur debugging dan pemantauan dinonaktifkan dalam build rilis untuk mengoptimalkan performa. Untuk daftar lengkap fitur eksperimental dan developer, silakan merujuk ke dokumentasi API.
Ruang Disk: 300 GB ruang disk yang tersedia untuk mengompilasi biner dan menyimpan cache status chain
Jaringan: Koneksi jaringan 100 Mbps dengan minimum 300 GB unggahan dan unduhan per bulan
Persyaratan Minimum
CPU: 2 core CPU
RAM: 4 GB
Ruang Disk: 300 GB ruang disk yang tersedia
Rangkaian pengujian Zebra mungkin memerlukan waktu lebih dari satu jam untuk selesai tergantung pada spesifikasi mesin Anda. Sistem yang lebih lambat dapat mengompilasi dan menjalankan Zebra. Batas performa yang tepat belum ditetapkan melalui pengujian.
Persyaratan Disk
Zebra menggunakan sekitar 300 GB untuk data Mainnet yang di-cache dan 10 GB untuk data Testnet yang di-cache. Perkirakan penggunaan disk akan meningkat seiring berjalannya waktu.
Database dibersihkan secara berkala, serta saat shutdown atau restart. Perubahan dikomit menggunakan transaksi database. Perubahan yang tidak lengkap akibat penghentian paksa atau panic akan di-rollback pada saat Zebra dimulai kembali.
Persyaratan Jaringan dan Port
Zebra menggunakan port TCP berikut untuk koneksi masuk dan keluar:
8233 untuk Mainnet
18233 untuk Testnet
Mengonfigurasi Zebra dengan listen_addr tertentu akan mengiklankan alamat ini untuk koneksi masuk. Koneksi keluar diperlukan untuk sinkronisasi; koneksi masuk bersifat opsional.
Akses ke DNS seeder Zcash diperlukan melalui resolver DNS OS (biasanya port 53).
Zebra dapat melakukan koneksi keluar pada port apa pun. zcashd lebih menyukai peer pada port default untuk menghindari penggunaan sebagai serangan DDoS pada jaringan lain.
Penggunaan Jaringan Mainnet yang Umum
Sinkronisasi Awal: unduhan sebesar 300 GB diperlukan untuk sinkronisasi awal, dan angka ini diperkirakan akan terus bertambah.
Pembaruan Berkelanjutan: unggahan dan unduhan harian berkisar antara 10 MB hingga 10 GB, tergantung pada ukuran transaksi pengguna dan permintaan peer.
Zebra memulai sinkronisasi awal pada setiap perubahan versi database internal, yang dapat berarti pengunduhan seluruh chain selama peningkatan versi.
Peer dengan latensi round-trip sebesar 2 detik atau kurang lebih diutamakan. Jika latensi melebihi ambang batas ini, buka tiket di repositori Zebra.