Edit this page on GitHub (opens in a new tab)
zecd adalah server dompet yang mengutamakan fitur terlindungi untuk Zcash, dibangun di atas librustzcash dan diekspos melalui dialek JSON-RPC Bitcoin Core. zecd memberikan API yang familiar dan kompatibel dengan Bitcoin bagi developer dan integrator pembayaran untuk berinteraksi dengan Zcash — sekaligus menjadikan Orchard (pool paling privat) sebagai default. Dikembangkan oleh zec.rocks, zecd dirancang untuk menggantikan fungsionalitas dompet zcashd dalam deployment cloud-native modern.
Versi saat ini: 0.5.0-rc3 (13 Juli 2026) — dengan dukungan Ironwood (NU6.3). Instal melalui cargo install zecd atau gunakan Docker image resmi.
zcashd adalah gabungan dari node dan dompet asli Zcash — merupakan fork dari codebase C++ Bitcoin pada tahun 2016. Seiring berjalannya waktu, hal ini menciptakan friksi: kode tersebut sulit untuk dipelihara, dompet terikat erat dengan node, dan alamat transparan disajikan sebagai opsi utama bersama dengan alamat terlindungi.
zecd memisahkan tanggung jawab dompet dari konsensus. Ini adalah lapisan dompet khusus yang berada di antara aplikasi dan Zebra full node, yang menyediakan:
zecd beroperasi dalam model tiga tingkat:
Your app / Bitcoin RPC client
↓ JSON-RPC
zecd
(keys, scanning, proving, RPC)
↓ JSON-RPC (local only)
Zebra
(full node — consensus, mempool, chain data)
zecd berkomunikasi dengan Zebra secara eksklusif melalui JSON-RPC lokal — tanpa jaringan peer-to-peer, tanpa indexer pihak ketiga, tanpa lightwalletd. Koneksi Zebra sengaja dibuat hanya untuk lokal: zecd akan menolak untuk mengirim kredensial ke host yang dapat dirutekan secara global kecuali dikonfigurasi secara eksplisit untuk terowongan aman out-of-band (misalnya WireGuard atau SSH).
zecd menggunakan Orchard Unified Addresses sebagai tipe alamat default. Pool Sapling dan transparan (t-address) memerlukan konfigurasi eksplisit per dompet. Desain ini mengurangi risiko pengiriman transparan yang tidak disengaja — sebuah celah privasi umum pada alat Zcash versi lama.
Kebijakan privasi dapat dikonfigurasi per panggilan atau secara global di [spend] privacy_policy:
| Kebijakan | Perilaku |
|---|---|
AllowRevealedRecipients (default) | Mengizinkan pengiriman ke penerima transparan; mengungkapkan jumlah dan penerima secara on-chain |
AllowRevealedAmounts | Mengizinkan pengiriman lintas pool (Sapling↔Orchard) tetapi menolak penerima transparan |
FullPrivacy | Hanya pengiriman yang sepenuhnya terlindungi dalam satu pool; menolak penerima transparan dan lintas pool |
AllowFullyTransparent | Juga mengizinkan pengiriman t→t yang didanai dari UTXO transparan |
zecd mengimplementasikan dialek JSON-RPC dari Bitcoin Core dengan kepatuhan pada:
getblockchaininfo, getbalance, getnewaddress, listtransactions, sendtoaddress, sendmany)rpcauth, dan autentikasi file cookieIni berarti banyak library pembayaran Bitcoin yang sudah ada, integrasi exchange, dan alat pemantauan dapat berinteraksi dengan Zcash melalui zecd dengan sedikit atau tanpa perubahan kode.
Rangkaian kepatuhan (140+ pemeriksaan) dijalankan pada setiap PR terhadap daemon regtest yang aktif dan juga telah divalidasi terhadap testnet publik.
zecd mengekspos fitur memo terlindungi dari Zcash melalui antarmuka Bitcoin RPC yang sudah dikenal — sesuatu yang tidak tersedia dalam alat Bitcoin standar:
sendtoaddress menerima opsional hex memo sebagai parameter tambahan di akhir (hingga 512 byte; ditolak untuk penerima transparan)listtransactions dan gettransaction menyertakan field memo (hex) dan memoStr (teks terdekode) ketika sebuah output membawanyaz_sendmany "memo-only-send")Hal ini membuat zecd cocok untuk aplikasi yang membutuhkan pengiriman pesan on-chain secara privat bersamaan dengan pembayaran.
zecd tidak menyimpan tidak ada status off-chain yang tidak dapat dibangun kembali melalui pemulihan hanya dengan seed. Database dompet (data.sqlite) sepenuhnya dapat diturunkan dari frasa pemulihan — dana terlindungi dipulihkan tanpa syarat; dana transparan dipulihkan hingga batas gap yang dikonfigurasi.
Untuk memulihkan dompet dari frasa pemulihan:
zecd init --restore --birthday <block-height>
Hal ini membuat direktori data bersifat dapat dibuang: sebuah kontainer tanpa volume persisten, yang dibangun ulang dari seed pada setiap awal dijalankan, tidak akan kehilangan data kritis apa pun. Operator bertanggung jawab untuk melacak alamat yang mereka berikan — zecd hanya mengingat alamat setelah alamat tersebut menerima dana secara on-chain.
Label sengaja tidak disertakan. Karena label tidak memiliki sumber on-chain dan tidak dapat direkonstruksi dari seed, zecd secara sederhana tidak mendukungnya. Memanggil metode label akan mengembalikan error method-not-found (-32601).
zecd memperoleh blok ringkas, status pohon, dan visibilitas mempool secara langsung dari JSON-RPC milik Zebra. Tidak ada lightwalletd yang perlu dioperasikan atau dipelihara — mengurangi kompleksitas operasional untuk deployment yang di-host sendiri.
Arsitektur stateless zecd dirancang untuk lingkungan Docker dan Kubernetes:
zebra → zecd) tersedia di dalam repositori9233 dengan probe readiness yang dapat dikonfigurasi (synced atau connected)bootstrap_from_keys (default aktif): direktori data kosong di sebelah keys.toml akan membangun ulang dompet secara otomatis saat startup — deploy dengan memasang satu Secret dan memulai dengan PVC yang kosongzecd mendukung tiga model kustodial kunci, yang sesuai untuk berbagai kebutuhan penerapan dan keamanan:
Frasa pemulihan mnemonic dalam keys.toml dibungkus ke sebuah file identitas age (identity.txt). Dengan auto_unlock = true default, frasa pemulihan didekripsi ke dalam memori saat startup sehingga pengiriman dapat dilakukan tanpa pengawasan dan tidak memerlukan panggilan walletpassphrase.
Terbaik untuk: pemroses pembayaran otomatis, hot wallet exchange, lingkungan developer.
zecd init --datadir ./data --wallet default --account-name primary
Simpan
identity.txtdi luar direktori data pada mainnet — siapa pun yang membaca kedua file tersebut memiliki otoritas pengeluaran.
Mnemonic ini dibungkus dengan passphrase (age scrypt) alih-alih menggunakan file identitas. Dompet dimulai dalam keadaan terkunci; walletpassphrase "<pass>" <timeout> membukanya untuk durasi yang ditentukan dan mengunci kembali secara otomatis saat timeout — sesuai dengan perilaku dompet terenkripsi pada Bitcoin Core.
Terbaik untuk: dompet panas di mana otoritas pengeluaran tanpa pengawasan tidak diperlukan; alur kerja operator interaktif.
zecd init --datadir ./data --encrypt
# later: walletpassphrase "my-passphrase" 300
Diinisialisasi dengan Full Viewing Key Terpadu (UFVK) yang diekspor dari dompet lain. Dapat menerima, memindai, dan melaporkan saldo — tetapi tidak dapat menandatangani transaksi. Ideal untuk pemantauan, penagihan, atau node audit yang terpisah dari dompet penandatangan.
# On the signing wallet's host:
zecd export-ufvk
# On the watch-only host:
zecd init --datadir ./data-watch --ufvk "uview1..." --birthday <height>
Dana dapat dipulihkan hanya dari frasa pemulihan saja. Segala hal lainnya hanyalah cache.
| Artefak | Lokasi | Apa yang dilindunginya | Cadangkan? |
|---|---|---|---|
| Mnemonic 24-kata | Ditampilkan sekali di zecd init | Dana — kehilangan = kehilangan permanen | Ya — offline (kertas/HSM) |
keys.toml | <wallet dir>/keys.toml | Seed terenkripsi + birthday + network | Ya — sebagai Secret |
identity.txt | [keys] age_identity | Mendekripsi keys.toml (otoritas pengeluaran) | Ya — terpisah dari keys.toml |
Direktori data harus bersifat host-lokal. Kunci instansi tunggal zecd (
<datadir>/.lock) adalah kunci advisori OS — ini tidak mencakup lintas host. Jangan pernah berbagi direktori data dengan akses baca-tulis di berbagai mesin (NFS, KubernetesReadWriteMany) — dua instansi zecd akan merusak DB dompet. Gunakan volumeReadWriteOncedi Kubernetes.
Untuk penerapan di mana kebocoran kredensial akan berakibat katastrofik, zecd mendukung pembatasan permukaan RPC ke subset metode yang dipilih:
[rpc]
allowed_methods = ["getblockchaininfo", "getbalance", "getnewaddress", "listtransactions"]
Metode apa pun yang tidak ada dalam daftar akan mengembalikan -32601 (HTTP 404) — tidak dapat dibedakan dari metode yang memang tidak ada, sehingga server yang dikunci tidak mengungkapkan apa pun tentang apa yang telah dinonaktifkan. Sebuah invoicer yang hanya menerima (receive-only) dapat menonaktifkan sendtoaddress, sendmany, dan stop untuk meminimalkan blast radius dari client yang terkompromi.
Developer yang bermigrasi dari Bitcoin atau alat zcashd harus menyadari perbedaan yang disengaja ini:
| Perilaku | Bitcoin Core | zecd |
|---|---|---|
| Format alamat | 1... / bc1... | u1... (Orchard Unified Address) — tidak dapat diurai sebagai alamat Bitcoin oleh client string-parsing |
| Label | Penyimpanan label lengkap | Belum diimplementasikan — setlabel, listlabels, dll. mengembalikan -32601 |
| Biaya | Dapat diatur pengguna; pasar biaya | ZIP-317 hanya deterministik; settxfee, fee_rate, subtractfeefromamount ditolak dengan |
Prasyarat: Zebra yang berjalan secara lokal dengan rpc.listen_addr = 127.0.0.1:18234 (testnet).
Instal dari crates.io (0.4.3+):
cargo install zecd
Atau bangun dari sumber:
git clone https://github.com/zecrocks/zecd && cd zecd
cargo build --release
# 1. Initialize a testnet wallet (generates a 24-word mnemonic and an account)
zecd --datadir ./data --testnet init --wallet default --account-name primary
# 2. Start the daemon (syncs in background, serves JSON-RPC on port 18232)
zecd --datadir ./data --testnet \
--rpcuser zec --rpcpassword secret --rpcbind 127.0.0.1 --rpcport 18232
Berinteraksi melalui curl:
curl -s --user zec:secret --data-binary \
'{"jsonrpc":"1.0","id":"1","method":"getblockchaininfo","params":[]}' \
-H 'content-type: text/plain;' http://127.0.0.1:18232/
Berinteraksi melalui Python (menggunakan pustaka Bitcoin RPC):
from bitcoinrpc.authproxy import AuthServiceProxy
rpc = AuthServiceProxy("http://zec:secret@127.0.0.1:18232")
print(rpc.getblockchaininfo())
addr = rpc.getnewaddress() # returns a u1... Orchard Unified Address
print(rpc.getbalance())
print(rpc.listtransactions("*", 20))
# Send with a shielded memo
rpc.sendtoaddress(addr, 0.001, "", "", False, "48656c6c6f205a6563617368") # hex memo
Pulihkan dari frasa pemulihan:
zecd --datadir ./data init --restore --birthday 2500000
# paste your 24-word mnemonic when prompted
| Jaringan | zecd RPC | Zebra RPC (backend) | Kesehatan |
|---|---|---|---|
| Mainnet | 8232 | 8234 | 9233 |
| Testnet | 18232 | 18234 | 9233 |
| zcashd | Zaino | zecd | |
|---|---|---|---|
| Peran | Full node + dompet | Indexer (menggantikan lightwalletd) | Hanya server dompet |
| Bahasa | C++ | Rust | Rust |
| Status | Deprecated | Aktif | Aktif (v0.5.0-rc3, Jul 2026) |
| Pool default | Transparan | N/A | Orchard (terlindungi) |
| Dialek RPC | Spesifik-zcashd | gRPC (lightwalletd) | Bitcoin Core JSON-RPC |
| Memerlukan full node | Ya (mandiri) | Zebra atau zcashd | Zebra |
| Pemulihan stateless | Tidak | N/A | Ya (hanya frasa pemulihan) |
| Birthday height | Di dalam keys.toml | Membuat pemulihan menjadi cepat (height apa pun sebelum transaksi pertama) | Catat bersama mnemonic |
data.sqlite | <wallet dir>/data.sqlite | Cache dompet — dibangun ulang dari seed saat pemulihan | Tidak — dapat dibuang |
blocks/ | <wallet dir>/blocks/ | Cache blok yang ringkas | Tidak — jangan pernah dikirim; dapat tumbuh besar |
.cookie | <datadir>/.cookie | Cookie RPC ephemeral | Tidak — dibuat ulang saat startup |
-8| Memo | Tidak didukung | sendtoaddress menerima memo hex; riwayat memiliki field memo + memoStr |
| Konfirmasi untuk membelanjakan | 1 | 3 (kembalian sendiri) / 10 (pihak ketiga) — dapat dikonfigurasi melalui trusted_confirmations / untrusted_confirmations |
listsinceblock saat reorg | Berjalan mundur ke fork | Mengembalikan -5 (Block tidak ditemukan) jika kursor tergeser oleh reorg — baseline ulang dengan panggilan tanpa parameter |
Penerima duplikat dalam sendmany | Error | JSON parser menggabungkan duplikat (yang terakhir menang) sebelum zecd melihatnya — jangan mencantumkan alamat yang sama dua kali |
| Saldo selama sinkronisasi awal | Memblokir atau pemanasan | Menyajikan saldo parsial — batasi otomatisasi pada GET /readyz (mengembalikan 503 hingga tersinkronisasi penuh dan backlog peningkatan telah dikosongkan) |
minconf 0 dalam getbalance | Saldo 0-conf | Disajikan sebagai 1 — sebuah shielded note tidak akan pernah dapat dibelanjakan sebelum ditambang |
| Memo terlindungi | Ya (z_sendmany) | N/A | Ya (permukaan Bitcoin RPC) |
| Watch-only (UFVK) | Ya | Ya | Ya |
| Cloud-native | Tidak | Parsial | Ya |
| Instalasi | Build/binary | Build | cargo install zecd |