Edit this page on GitHub (opens in a new tab)
Alamat terlindungi memungkinkan Anda bertransaksi dengan mengungkap sesedikit mungkin informasi pada blockchain Zcash. Jadi, apa yang terjadi ketika Anda perlu menunjukkan kepada pihak tertentu apa yang Anda miliki, atau apa yang Anda kirim? Sebuah viewing key memberikan akses baca tanpa memberikan kemampuan untuk membelanjakan. Viewing key sudah ada untuk Sprout; Sapling menambahkan kemampuan seperti mendeteksi ketika note yang diterima dibelanjakan. ZIP 310 adalah draf informasional yang mendokumentasikan properti keamanan viewing key Sapling, bukan peningkatan yang memperkenalkan viewing key.
Viewing key adalah tools untuk pengungkapan selektif: Anda memilih siapa yang dapat melihat apa, dan Anda tidak pernah menyerahkan otoritas spending untuk melakukannya.
Sebuah viewing key memberikan akses hanya-baca ke aktivitas alamat atau akun Zcash terlindungi: siapa pun yang memilikinya dapat melihat transaksi masuk (dan, untuk full viewing key, transaksi keluar), tetapi tidak pernah dapat membelanjakan.
uivk… incoming keys) atau visibilitas masuk/keluar penuh untuk sebuah akun (uview… unified full viewing keys), serta key lama Sapling zxviews….z_exportviewingkey / z_importviewingkey) dan akun watch-only di dompet seperti Zkool; lihat halaman untuk matriks dukungan terkini.Tulisan Electric Coin Company mengenai subjek ini memaparkan situasi yang paling sering muncul, dan situasi tersebut masih menjadi hal yang umum terjadi saat ini:
Ada lebih dari satu jenis key, dan perbedaannya menentukan seberapa banyak informasi yang Anda berikan.
| Kunci | Awalan | Hak Akses |
|---|---|---|
| Unified full viewing key (UFVK) | uview… | Dapat melihat transaksi masuk dan keluar untuk setiap pool dalam akun tersebut |
| Unified incoming viewing key (UIVK) | uivk… | Hanya dapat melihat transaksi masuk, untuk setiap pool dalam akun tersebut |
| Sapling extended full viewing key | zxviews… | Dapat melihat aktivitas Sapling masuk dan keluar untuk alamat-alamat dari kunci tersebut |
Tidak ada satu pun dari ini yang dapat membelanjakan dana. Semuanya bersifat permanen dalam hal yang krusial: kunci yang telah Anda berikan tidak dapat ditarik kembali, hanya dapat dilewati masa berlakunya, dengan memindahkan dana ke akun yang kuncinya tidak dipegang oleh pihak lain tersebut.
Ada dua jebakan pengungkapan yang perlu Anda ketahui sebelum Anda membagikan apa pun.
Incoming tidak berarti sempit. Sebuah unified incoming viewing key mencakup seluruh akun, bukan hanya satu alamat yang Anda tanyakan. Mengekspor UIVK untuk satu alamat Sapling tetap memberikan visibilitas incoming di setiap pool dalam akun tersebut, sehingga ia mengungkapkan lebih banyak hal daripada alamat yang disebutkan. Zallet Book menyatakan hal ini secara eksplisit.
Alamat yang dipublikasikan sudah mengekspos incoming viewing key miliknya kepada penyerang di masa depan. ZIP 326 mencatat bahwa seorang penyerang dengan komputer kuantum dapat memulihkan incoming viewing key dari alamat diversifikasi yang dipublikasikan, yang mana hal ini memungkinkan dilakukan dengan cara yang tidak mungkin dilakukan dalam pemulihan nullifier key. Mempublikasikan sebuah alamat tidaklah sama dengan mempublikasikan sebuah viewing key saat ini, namun keduanya akan menjadi semakin berdekatan dalam jangka waktu yang cukup lama.
NU6.3 memperkenalkan Ironwood pool terlindungi dan membuat Orchard pool hanya dapat digunakan untuk pengeluaran (spend-only), sehingga dana bermigrasi dari satu ke yang lain seiring berjalannya waktu. Lihat dan untuk peningkatan jaringan itu sendiri.
Viewing key yang diterbitkan sebelum Ironwood tetap berfungsi setelah migrasi. ZIP 326 menentukan bahwa penerima, dan incoming viewing key yang sesuai, dibatasi pada protokol Orchard alih-alih pada sebuah pool: incoming viewing key yang sama melakukan trial-decrypt pada ciphertext note dari Orchard-pool dan Ironwood-pool. Zallet mengimplementasikannya dengan cara tersebut, mendeskripsikan note Ironwood sebagai berbentuk Orchard dan didekripsi secara trial menggunakan viewing keys Orchard milik akun di bawah domain enkripsi-note Ironwood.
Tiga konsekuensi bagi siapa pun yang memegang atau menerbitkan sebuah key:
use_qsk untuk key yang dapat dipulihkan secara kuantum, dan ini mengubah cara key incoming, outgoing, dan diversifier diturunkan, sehingga key use_qsk = true adalah key yang benar-benar berbeda. ZIP 326 mengharuskan flag tersebut seragam di seluruh akun dan melarang pembuatan key use_qsk = true sebelum NU6.3 diaktifkan di Mainnet. Oleh karena itu, sebuah key yang diekspor dari akun yang sudah ada sebelum Ironwood adalah key use_qsk = false, dan tetap benar untuk akun tersebut. Jangan berasumsi bahwa key yang diekspor dari satu akun mendeskripsikan akun lainnya.Zallet adalah dompet full-node yang menggantikan dompet di dalam zcashd. Ekspor dan impor viewing-key hadir pada v0.1.0-beta.2 (28 Juli 2026), jadi periksa versi Anda terlebih dahulu; build sebelumnya tidak memiliki metode ini. Setiap argumen setelah nama metode harus berupa JSON yang valid, yang berarti nilai string tetap mempertahankan tanda kutip ganda mereka sendiri. mencakup gaya perintah umum.
Daftar apa yang disimpan oleh dompet:
zallet rpc listaddresses
Ekspor unified full viewing key dari akun dengan mengirimkan unified address:
zallet rpc z_exportviewingkey '"<unified address>"'
Ekspor unified incoming viewing key dari akun tersebut sebagai gantinya, dengan menggunakan argumen opsional ivk:
zallet rpc z_exportviewingkey '"<unified address>"' true
Memasukkan alamat Sapling akan mengembalikan extended full viewing key Sapling dari akun tersebut (zxviews…), sesuai dengan perilaku zcashd yang lama. Dua batasan yang terdokumentasi: alamat Sprout akan ditolak, dan extended full viewing key Sapling tidak dapat diekspor dari akun yang dirinya sendiri diimpor sebagai view-only, karena dompet tidak dapat menyusunnya kembali. Bentuk ivk tetap berfungsi untuk akun view-only yang diimpor.
Halaman melacak dukungan viewing-key dan Ironwood kesiapan untuk setiap dompet. Pada saat penulisan ini, dompet yang mencantumkan dukungan viewing-key sekaligus Ironwood: Ready meliputi ZODL, Zingo!, Zkool, Cake, Zallet, zecd, dan Nozy. Periksa halaman tersebut daripada halaman ini sebelum mengandalkan satu dompet pun, karena kesiapan dapat berubah.
Zkool adalah opsi yang paling fleksibel di sini, karena ia menerima kunci terpadu maupun kunci lama. README miliknya mendokumentasikan akun khusus lihat yang dibuat dari unified viewing key atau Sapling extended viewing key, bersama dengan kunci extended terlindungi lama yang diekspor dari zcashd. Tambahkan akun baru, pilih rute khusus lihat, dan tempelkan kunci uview… atau zxviews…; akun tersebut kemudian akan sinkron dan melaporkan saldo serta riwayat tanpa otoritas pengeluaran.
Dukungan protokol Ironwood dan migrasi Orchard-ke-Ironwood telah hadir di Zkool 6.24.0 (20 Juli 2026), dan 6.26.1 (2 Agustus 2026) memperbaiki deteksi transaksi Ironwood di dalam mempool. Karena NU7 telah diaktifkan di Mainnet (blok 3.543.405), jalankan 6.35.0 (25 Oktober 2026) atau versi yang lebih baru: ini adalah rilis pertama Zkool yang dibuat dengan ketinggian aktivasi Mainnet NU7 (zkool2#1388).
Versi 6.35.0 juga menerima unified incoming viewing key. Tempelkan key uivk… di tempat untuk memasukkan key, lalu Zkool membuat akun khusus penerimaan: akun ini menampilkan apa yang diterima akun asli, termasuk memo, dan tidak menampilkan apa pun yang dikirimnya (zkool2#1348). Incoming key tidak dapat melihat transaksi pengeluaran, sehingga saldo akun adalah jumlah total yang diterima, bukan saldo yang tersisa, dan akun tersebut tidak dapat membelanjakan dana. Zkool juga dapat mengekspor UIVK akun (zkool2#1347).
zallet rpc z_importviewingkey '"<zxviews… key>"' '"whenkeyisnew"' 0
Argumen kedua adalah kebijakan pemindaian ulang: "whenkeyisnew" (default), "yes" atau "no". Argumen ketiga adalah tinggi blok untuk mulai memindai ulang. Zallet mengimpor kunci sebagai akun khusus viewing dengan melacak transaksi masuk dan keluar untuk alamat-alamatnya tanpa otoritas pengeluaran.
Zallet hanya mengimpor Sapling extended full viewing keys. Ini tidak akan mengimpor uview… unified full viewing key, meskipun ia dapat mengekspornya. Untuk memberikan akses baca ke seluruh akun unified, ekspor UFVK dari Zallet dan impor ke dalam dompet yang menerima unified keys, seperti Zkool.
Untuk mengubah kunci yang diimpor menjadi file riwayat transaksi lengkap, dengan txid, biaya, dan memo, lihat .
Jika Anda mengikuti versi lama dari halaman ini, atau terjemahannya, tiga rute tidak lagi berfungsi.
zcash-cli z_exportviewingkey dan z_importviewingkey. zcashd telah mencapai akhir dukungan (end-of-support) pada 18 Juli 2026 dan tidak lagi berjalan. Metode dengan nama identik milik Zallet adalah penggantinya; lihat .Anggap akun terlindungi sebagai ruang penyimpanan aman di bank:
Jendela itu menghadap ke ruangan, bukan ke dunia di luarnya. Jendela itu menampilkan aktivitas terlindungi dari akun yang dipantau; jendela itu tidak mengubah pengamat menjadi pengamat di seluruh blockchain, dan tidak memungkinkan pengamat mengorelasikan aktivitas akun tersebut dengan riwayat tidak terlindungi milik orang lain. Dan karena jendela itu dipasang pada tingkat akun, memberikan seseorang lubang intip untuk satu kotak penyimpanan (satu alamat) tetap memberi mereka tampilan transaksi masuk seluruh ruangan — yang persis merupakan alasan adanya aturan kunci paling sempit.
Viewing key adalah informasi, bukan entri izin. Setelah disalin, viewing key tetap ada hingga dana meninggalkan akun yang dipantaunya. Solusi praktisnya adalah rotasi: pindahkan saldo ke akun baru yang viewing key-nya tidak pernah diterima pihak lain, dan jendela lama menghadap ruangan kosong.
Setiap transaksi terlindungi mengenkripsi plaintext note-nya kepada penerima yang dituju. Sebuah dompet yang memiliki viewing key melakukan dekripsi percobaan: untuk setiap transaksi yang ditemukannya di chain, dompet tersebut berupaya mendekripsi ciphertext note dengan key tersebut. Keberhasilan mengungkap nilai note, diversifier penerima, dan memo; kegagalan tidak menimbulkan biaya. Inilah alasan viewing key masuk yang sama tetap berfungsi di seluruh pool Orchard dan Ironwood — ZIP 326 membatasi receiver pada protokol Orchard, sehingga ciphertext note Ironwood berbentuk Orchard dan didekripsi secara percobaan dengan viewing key Orchard milik akun dalam domain enkripsi note Ironwood.
Sebuah viewing key penuh dapat menurunkan kemampuan viewing keluar, yang memungkinkan auditor merekonstruksi sisi pengirim dari suatu transfer setelah transaksi didekripsi. Sebuah viewing key masuk sengaja berhenti pada tahap tersebut: key ini mendeteksi dan mendekripsi note masuk, tetapi tidak dapat merekonstruksi keterkaitan keluar. Derivasi di antara kemampuan-kemampuan ini bersifat satu arah — key masuk diturunkan dari key penuh, tidak pernah sebaliknya — sehingga "hanya masuk" merupakan penurunan tingkat yang nyata, bukan sekadar janji. Flag use_qsk dari ZIP 2005 mengubah derivasi itu sendiri, sehingga key yang dapat dipulihkan secara kuantum merupakan keluarga key yang sepenuhnya berbeda, bukan varian dari yang lama.
Karena migrasi ZIP 318 merupakan rangkaian acak transaksi kecil dan seragam dari Orchard ke Ironwood, seorang pengamat yang memegang kunci akan melihat pola bertangga: banyak langkah nilai berdenominasi kanonis, bukan satu lonjakan. Tidak ada satu langkah pun yang mengungkapkan total saldo yang sedang dimigrasikan, tetapi polanya dapat dikenali — yang merupakan kompromi yang disengaja dari turnstile yang dapat diaudit.
| Keyakinan umum | Kenyataan yang sebenarnya |
|---|---|
| "Viewing key dapat membelanjakan dana jika bocor." | Tidak dapat. Viewing key tidak memiliki otoritas untuk membelanjakan; hal terburuk dari kebocoran adalah riwayat terungkap. |
| "Saya dapat mencabut viewing key nanti." | Anda tidak dapat. Key yang telah diberikan akan berfungsi hingga dana dipindahkan ke akun yang key-nya tidak dimiliki pihak lain. |
| "Mengekspor UIVK untuk satu alamat hanya menampilkan alamat tersebut." | Viewing key bersifat khusus akun. UIVK menampilkan aktivitas masuk untuk setiap pool dalam akun. |
"zcash-cli z_exportviewingkey masih berfungsi." | Tidak. zcashd mencapai penghentian akhir dukungannya pada 18 Juli 2026; gunakan Zallet's z_exportviewingkey / z_importviewingkey sebagai gantinya. |
| "Menempelkan viewing key ke alat web aman karena bersifat hanya-baca." | Hanya-baca tetap berarti seluruh riwayat transaksi Anda untuk akun tersebut diberikan kepada siapa pun yang menjalankan situs itu. Impor key tersebut ke dompet yang Anda jalankan. |
| "Zallet dapat mengimpor viewing key apa pun yang dapat diekspor oleh Zallet." |
Gunakan viewing key hanya saat dibutuhkan, dan pilihlah key paling sempit yang dapat menjawab pertanyaan yang diajukan.
Tidak. Zallet hanya mengimpor extended full viewing key Sapling; key uview… terpadu harus dimasukkan ke dompet yang menerima key terpadu, seperti Zkool. |