Edit this page on GitHub (opens in a new tab)
シールドされたアドレスでは、Zcashブロックチェーン上で可能な限り情報を明かさずにトランザクションを行えます。では、保有しているものや送信したものを特定の相手に見せる必要がある場合はどうなるでしょうか。ビューイングキー(viewing key)は、支出する能力を付与せずに読み取りアクセスを与えます。ビューイングキーはすでにSproutに存在していました。Saplingでは、受信したノートが支出されたことを検出する機能などが追加されました。ZIP 310は、Saplingビューイングキーのセキュリティ特性を記録した情報提供用のドラフトであり、ビューイングキーを導入したアップグレードではありません。
ビューイングキーは、選択的開示(selective disclosure)のためのツールです。誰に何を見せるかを選択でき、そのために支出権限を渡すことはありません。
ビューイングキーは、シールドされたZcashアドレスまたはアカウントの活動に対する読み取り専用アクセスを付与します。保持者は受信トランザクション(およびフルビューイングキーの場合は送信トランザクション)を確認できますが、支出することは決してできません。
uivk…受信キー)またはアカウントの完全な入出金可視性(uview…統合フルビューイングキー)、および旧式のSaplingzxviews…キーです。z_exportviewingkey / z_importviewingkey)でのエクスポート/インポート、およびZkoolなどのウォレットにおける監視専用アカウントです。現在の対応表についてはページを参照してください。このテーマに関するElectric Coin Companyの記述では、最も頻繁に発生する状況が示されており、現在も一般的な用途です。
キーには複数の種類があり、その違いによってどれだけの情報を渡すかが決まります。
| キー | プレフィックス | 付与されるもの |
|---|---|---|
| 統合フルビューイングキー(UFVK) | uview… | アカウント内のすべてのプールについて、受信および送信トランザクションを確認できます |
| 統合受信ビューイングキー(UIVK) | uivk… | アカウント内のすべてのプールについて、受信トランザクションのみを確認できます |
| Sapling拡張フルビューイングキー | zxviews… | キーのアドレスにおける受信および送信Sapling活動を確認できます |
これらのいずれも支出することはできません。重要な意味では、すべて恒久的です。渡したキーは取り消せず、相手がキーを保有していないアカウントへ資金を移動することでしか、そのキーより長く存続することはできません。
何かを共有する前に知っておくべき、2つの開示上の落とし穴があります。
受信は限定的を意味しません。 統合受信ビューイングキーは、尋ねられた1つのアドレスではなく、アカウント全体を対象としています。単一のSaplingアドレス用にUIVKをエクスポートしても、そのアカウント内のすべてのプールにわたる受信可視性が付与されるため、名前に含まれるアドレスよりも多くが開示されます。Zallet Bookでは、この点が明記されています。
公開されたアドレスは、将来の攻撃者に対してその受信ビューイングキーをすでに露出させます。 ZIP 326では、量子コンピューターを持つ攻撃者は公開された多様化アドレスから受信ビューイングキーを復元できる可能性があり、これはヌリファイアキーの復元とは異なり実行可能であると述べられています。現在アドレスを公開することはビューイングキーを公開することと同じではありませんが、十分に長い期間では両者の距離は近くなります。
NU6.3ではIronwoodシールドされたプールが導入され、Orchardプールは支出専用となったため、資金は時間をかけて一方から他方へ移行します。アップグレード自体については、およびを参照してください。
Ironwood以前に発行されたビューイングキーは、移行後も機能し続けます。 ZIP 326では、レシーバーとそれに対応する受信ビューイングキーはプールではなくOrchardプロトコルを対象とすると定められています。同じ受信ビューイングキーで、OrchardプールとIronwoodプールの両方のノート暗号文を試行復号できます。Zalletはこのように実装しており、IronwoodノートをOrchard形状として記述し、Ironwoodノート暗号化ドメインの下でアカウントのOrchardビューイングキーにより試行復号します。
キーを保有または発行するすべての人にとって、3つの結果があります。
use_qskフラグが追加され、受信、送信、多様化キーの導出方法が変更されるため、use_qsk = trueキーは真に異なるキーです。ZIP 326では、そのフラグをアカウント全体で統一することが求められ、MainnetでNU6.3が有効化される前にuse_qsk = trueキーを生成することを禁じています。したがって、Ironwood以前に存在していたアカウントからエクスポートされたキーはuse_qsk = falseキーであり、そのアカウントでは引き続き正しいものです。あるアカウントからエクスポートしたキーが別のアカウントを表すと考えないでください。Zalletは、zcashd内のウォレットを置き換えたフルノードウォレットです。ビューイングキーのエクスポートとインポートは**v0.1.0-beta.2(2026年7月28日)**で導入されたため、まずバージョンを確認してください。以前のビルドにはこれらのメソッドはありません。メソッド名の後に続く各引数は有効なJSONである必要があり、文字列値にはそれぞれ二重引用符を付けます。一般的なコマンド形式については、を参照してください。
ウォレットが保有するものを一覧表示します。
zallet rpc listaddresses
統合アドレスを渡して、アカウントの統合フルビューイングキーをエクスポートします。
zallet rpc z_exportviewingkey '"<unified address>"'
代わりに、オプションのivk引数を使用して、アカウントの統合受信ビューイングキーをエクスポートします。
zallet rpc z_exportviewingkey '"<unified address>"' true
Saplingアドレスを渡すと、そのアカウントのSapling拡張フルビューイングキー(zxviews…)が返され、以前のzcashdの動作と一致します。文書化された制限は2つあります。Sproutアドレスは拒否され、アカウント自体が監視専用としてインポートされたものである場合は、Sapling拡張フルビューイングキーをエクスポートできません。これはウォレットがそのキーを再構築できないためです。ivk形式は、インポートされた監視専用アカウントでも機能します。
ページでは、各ウォレットのビューイングキー対応状況とIronwood対応状況を追跡しています。執筆時点で、ビューイングキー対応とIronwood: Readyの両方を記載しているウォレットには、ZODL、Zingo!、Zkool、Cake、Zallet、zecd、Nozyがあります。対応状況は変化するため、特定のウォレットに依存する前に、このページを確認してください。
Zkoolは、統合キーと旧式キーの両方を受け入れるため、ここでは最も柔軟な選択肢です。そのREADMEには、統合ビューイングキーまたはSapling拡張ビューイングキーから作成する監視専用アカウントと、zcashdからエクスポートされた旧式のシールドされた拡張キーが記載されています。新しいアカウントを追加し、監視専用の手順を選択して、uview…またはzxviews…キーを貼り付けてください。するとアカウントが同期し、支出権限なしで残高と履歴を報告します。
Ironwoodプロトコル対応とOrchardからIronwoodへの移行は、Zkool 6.24.0(2026年7月20日)で導入され、6.26.1(2026年8月2日)ではメモリプール内のIronwoodトランザクション検出が修正されました。6.26.1以降を実行してください。
zallet rpc z_importviewingkey '"<zxviews… key>"' '"whenkeyisnew"' 0
2番目の引数は再スキャンポリシーです。"whenkeyisnew"(デフォルト)、"yes"、または"no"を指定できます。3番目は再スキャンを開始するブロック高です。Zalletはキーを監視専用アカウントとしてインポートし、支出権限なしでそのアドレスの受信および送信トランザクションを追跡します。
ZalletがインポートできるのはSapling拡張フルビューイングキーのみです。 統合フルビューイングキーをエクスポートできても、uview…統合フルビューイングキーはインポートできません。統合アカウント全体への読み取りアクセスを渡すには、ZalletからUFVKをエクスポートし、Zkoolのように統合キーを受け入れるウォレットへインポートしてください。
インポートしたキーをtxid、手数料、メモを含む完全なトランザクション履歴ファイルに変換するには、を参照してください。
このページの古いバージョン、またはその翻訳を参照していた場合、3つの方法はもう機能しません。
zcash-cli z_exportviewingkeyとz_importviewingkey。 zcashdは2026年7月18日にサポート終了停止に達し、もはや動作しません。Zalletの同名メソッドが代替です。を参照してください。シールドされたアカウントを、銀行の貸金庫室だと考えてください。
窓は部屋に面しており、その外の世界には面していません。これは監視対象アカウントのシールドされた活動を示しますが、閲覧者をブロックチェーン全体の観測者にするものではなく、アカウントの活動を他者の非シールド履歴と関連付けることもできません。また、窓はアカウント単位で設置されるため、1つの貸金庫箱(単一アドレス)の覗き穴を誰かに渡しても、その人には部屋全体の受信ビューが与えられます。これこそが、最も限定的なキーを選ぶというルールが存在する理由です。
ビューイングキーは許可エントリではなく、情報の一部です。一度コピーされると、そのキーが監視するアカウントから資金が離れるまで存在し続けます。実用的な対処法はローテーションです。残高を、相手がキーを一度も受け取っていない新しいアカウントへ移せば、古い窓は空の部屋に面することになります。
すべてのシールドされたトランザクションは、ノートの平文を意図された受取人向けに暗号化します。ビューイングキーを持つウォレットは、試行復号を実行します。チェーン上で見つけた各トランザクションについて、キーを使ってノート暗号文の復号を試みます。成功するとノートの価値、受取人の多様化子、メモが明らかになり、失敗してもコストはかかりません。これが、同じ受信ビューイングキーがOrchardとIronwoodのプールをまたいで機能し続ける理由です。ZIP 326では、レシーバーをOrchardプロトコルの対象と定めているため、Ironwoodノート暗号文はOrchard形状であり、Ironwoodノート暗号化ドメインの下でアカウントのOrchardビューイングキーにより試行復号されます。
フルビューイングキー(full viewing key)は送信ビューイング機能(outgoing-viewing capability)を導出でき、トランザクション(transaction)が復号されると、監査担当者は送金の送信者側を再構築できます。受信ビューイングキー(incoming viewing key)は意図的にそこまで到達しません。受信ノート(incoming notes)を検出して復号できますが、送信リンクを再構築することはできません。これらの機能間の導出は一方向です。受信キーはフルキーから導出され、その逆は決してありません。これにより、「受信のみ」は約束ではなく、実際のダウングレードになります。use_qskのフラグ(flag)はZIP 2005から導出そのものを変更するため、量子で復元可能なキー(quantum-recoverable keys)は、古いもののバリアントではなく、まったく異なるキーファミリーです。
ZIP 318の移行は、小さく均一なOrchardからIronwoodへのトランザクションをランダム化して連続実行するものであるため、キーを持つ閲覧者には階段状に見えます。1回の大きな移動ではなく、標準額面の価値が多数の段階に分かれて見えるのです。1つのステップで移行中の総残高が明らかになることはありませんが、パターンは認識可能です。これは監査可能なターンスタイルが意図するトレードオフです。
| よくある考え | 実際の状況 |
|---|---|
| 「ビューイングキーが漏洩すると資金を支出できる。」 | できません。ビューイングキーには支出権限がなく、漏洩による最悪の結果は履歴の開示です。 |
| 「後からビューイングキーを取り消せる。」 | できません。渡したキーは、相手がキーを保有していないアカウントへ資金が移動するまで機能します。 |
| 「1つのアドレス用にUIVKをエクスポートすれば、そのアドレスだけが表示される。」 | ビューイングキーはアカウント単位です。UIVKはアカウント内のすべてのプールにおける受信活動を表示します。 |
「zcash-cli z_exportviewingkeyはまだ機能する。」 | いいえ。zcashdは2026年7月18日にサポート終了停止に達しました。代わりにZalletのz_exportviewingkey / z_importviewingkeyを使用してください。 |
| 「閲覧専用なので、ビューイングキーをウェブツールに貼り付けても安全だ。」 | 閲覧専用であっても、そのアカウントのトランザクション履歴全体をサイト運営者に渡すことを意味します。自分で運用するウォレットへキーをインポートしてください。 |
| 「ZalletはZalletがエクスポートできるすべてのビューイングキーをインポートできる。」 | いいえ。ZalletがインポートできるのはSapling拡張フルビューイングキーのみです。統合uview…キーは、Zkoolのように統合キーを受け入れるウォレットに入れる必要があります。 |
ビューイングキーは必要に応じて使用し、尋ねられた質問に答えるために最も限定的なキーを選んでください。