Edit this page on GitHub (opens in a new tab)
N'importe qui peut consulter les détails publics d'un paiement Zcash transparent. Un explorateur de blocs peut afficher ses adresses, ses montants et son état de confirmation.
Un paiement protégé fonctionne différemment. La chaîne prouve que la transaction a respecté les règles de Zcash, mais elle ne publie ni l'expéditeur protégé, ni le destinataire, ni le montant, ni le mémo. Partager l'identifiant de transaction peut montrer qu'une transaction a été minée, mais ne permet pas de prouver à un commerçant ou à un tiers quel paiement privé elle contenait.
Cela pose un problème concret. Un client peut avoir besoin de résoudre un litige avec un commerçant, un exchange peut devoir prouver qu'il a traité un retrait, ou un donateur peut vouloir prouver une contribution. Partager une clé pour lecture seule complète révélerait bien plus que ce qu'exige chacun de ces cas.
ZIP 311 : Zcash Payment Disclosures propose une réponse plus ciblée : divulguer et authentifier certaines informations d'une seule transaction.

Le déroulement de base est le suivant :
La conception Sapling du ZIP utilise une clé de chiffrement sortante pour récupérer chaque sortie sélectionnée. Cela peut révéler le destinataire, le montant et le mémo de la sortie. Elle exige également une preuve d'autorité de dépense pour au moins une entrée de la transaction, de sorte qu'une personne qui se contente de voir la transaction ne puisse pas créer une divulgation valide en se faisant passer pour l'expéditeur.
Une divulgation de paiement Sapling n'a pas besoin de révéler une adresse d'expéditeur. Une autorité de dépense peut contrôler de nombreuses adresses diversifiées : prouver le contrôle de la dépense n'identifie donc pas automatiquement une adresse. ZIP 311 prévoit une preuve d'adresse facultative pour les cas où il est nécessaire de lier la preuve à une adresse d'expéditeur connue.
| Méthode | Meilleur usage | Ce qu'elle révèle | Accès permanent ? | Liée cryptographiquement au paiement ? |
|---|---|---|---|---|
| Transaction ID | Vérifier qu'une transaction a été minée | Données publiques de la transaction et confirmations | Non | Oui, mais les détails du paiement protégé restent cachés |
| Screenshot or receipt | Tenue de registres informelle | Tout ce que l'expéditeur choisit d'afficher | Non | Non ; l'image peut être modifiée |
| Payment disclosure | Prouver certains détails d'un paiement | Les sorties de transaction sélectionnées et toute preuve d'expéditeur ou de défi incluse | Non, mais la preuve partagée peut être copiée | Oui |
| Incoming Viewing Key | Suivre les paiements reçus par un compte | L'activité entrante couverte par la clé | Oui | Elle déchiffre les paiements entrants correspondants |
| Full Viewing Key | Comptabilité ou audit d'un compte | L'activité entrante et sortante, les montants, les mémos et les soldes couverts par la clé |
Utilisez la divulgation la plus restreinte qui répond à la question. Un litige commercial portant sur un seul paiement ne justifie normalement pas l'accès à tous les paiements d'un compte. Un comptable qui doit examiner une période de déclaration complète peut en revanche avoir besoin d'une clé pour lecture seule.
Aucune de ces méthodes n'accorde l'autorisation de dépenser. Ne partagez jamais une phrase de récupération, une clé de dépense, une clé privée ou une sauvegarde de portefeuille comme preuve de paiement.

Aucun portefeuille actuel n'est identifié ici comme mettant en œuvre la création ou la vérification de divulgations de paiement ZIP 311. Le ZIP reste un brouillon et indique « TBD » pour son implémentation de référence. Les outils maintenus suivants peuvent néanmoins aider l'expéditeur, le destinataire ou un auditeur autorisé à examiner les registres disponibles aujourd'hui :
| Application | Utile aujourd'hui pour | Limite importante |
|---|---|---|
| Zkool | Consulter les métadonnées détaillées des transactions, les montants, les entrées et sorties des pools et les mémos ; importer des clés pour lecture seule unifiées ou Sapling dans des comptes en lecture seule | N'annonce pas la création ni la vérification de divulgations ZIP 311 |
| Zingo PC | Examiner l'historique des transactions protégées et les mémos ; importer une Full Viewing Key unifiée en mode lecture seule | Un registre de portefeuille ou un compte en lecture seule n'est pas une divulgation de paiement à portée sélective |
| Zallet | Flux de travail d'opérateur utilisant z_viewtransaction, z_exportviewingkey et z_importviewingkey |
Utilisez d'abord le portefeuille qui a envoyé ou reçu le paiement. Vérifiez les détails de la transaction, le mémo, l'identifiant de transaction et les confirmations, puis demandez à l'autre partie de comparer ces détails avec ses propres registres. N'installez pas un nouveau portefeuille et n'y saisissez pas une phrase de récupération simplement pour produire une preuve. Si un auditeur a besoin d'une visibilité continue, envisagez un compte compatible en lecture seule et comprenez la portée de la clé pour lecture seule avant de la partager.
Ces applications sont des alternatives pratiques pour vérifier des registres, pas la preuve qu'une divulgation de paiement standardisée est disponible. Une capture d'écran peut aider à comparer des registres, mais elle est modifiable et ne constitue pas une preuve cryptographique.
Un client pourrait prouver qu'un montant précis a été envoyé à l'adresse protégée du commerçant. La preuve n'établit pas que les biens ont été livrés, qu'un remboursement est dû ni que la personne qui la présente possède une identité juridique particulière. Ces questions dépendent toujours de l'enregistrement de la commande et de l'accord entre les parties.
ZIP 311 cite les retraits protégés comme cas d'utilisation visé : un exchange prouverait le destinataire et le montant sans publier ces détails on-chain. Sa preuve pour les entrées transparentes est encore inachevée : il ne s'agit donc pas encore d'un flux de travail standardisé complet. Le client doit également vérifier de manière indépendante l'état de confirmation de la transaction.
Un donateur ou une campagne pourrait prouver une contribution particulière tout en gardant privés les paiements sans rapport. Publier la divulgation rend ses détails sélectionnés publics pour toute personne qui en reçoit une copie : un canal de vérification privé est donc plus sûr lorsqu'une preuve publique n'est pas nécessaire.
Utilisez une divulgation de paiement lorsqu'un comptable a besoin d'une preuve pour une seule transaction. Utilisez la clé pour lecture seule adaptée la plus restreinte lorsque le comptable a besoin d'un accès continu à de nombreuses transactions ou à une période de déclaration complète.
ZIP 311 n'est pas encore une norme de portefeuille aboutie et largement déployable. Lorsque des outils compatibles seront disponibles pour l'expéditeur et le vérificateur, utilisez cette liste de contrôle :
Si le portefeuille ne peut pas générer de divulgation, ne lui substituez pas une clé pour lecture seule complète sans comprendre sa portée plus large et permanente. Demandez si le destinataire peut confirmer le paiement à partir de ses propres registres de portefeuille ou accepter à la place un document moins sensible.
Une vérification réussie ne prouve pas :
Le vérificateur doit contrôler séparément l'inclusion dans la chaîne et l'état de confirmation. La procédure de vérification de ZIP 311 suppose que l'appelant a déjà obtenu la transaction minée et la hauteur de son bloc.
Considérez ZIP 311 comme une norme proposée, et non comme la promesse qu'un portefeuille actuel dispose d'un bouton Prouver le paiement fonctionnel.
Le brouillon spécifie actuellement les dépenses et sorties Sapling, mais contient encore des points inachevés concernant Orchard, les entrées transparentes, l'encodage de la divulgation, la gestion des versions et la manière dont les portefeuilles doivent afficher les différents niveaux de validité. Son implémentation de référence est également indiquée comme « TBD ». Dans sa rédaction actuelle, il ne définit pas de divulgations de paiement pour les paiements Orchard ou Ironwood.
L'expéditeur peut également être dans l'impossibilité de divulguer une sortie si la transaction a été délibérément créée sans clé pour lecture seule sortante pour cette sortie. ZIP 311 préserve ce choix de confidentialité plutôt que de créer une nouvelle voie de récupération.
Une documentation plus ancienne décrit les commandes expérimentales z_getpaymentdisclosure et z_validatepaymentdisclosure dans zcashd. Ces commandes ne prenaient en charge que les sorties Sprout JoinSplit, et non la conception Sapling de ZIP 311, et elles ont été dépréciées. zcashd a atteint son arrêt définitif de fin de support en juillet 2026. N'utilisez pas ce guide historique comme instructions pour des fonds actuels.
Ces lacunes ne rendent pas l'idée inutile. Elles expliquent pourquoi un guide rigoureux doit distinguer le modèle de confidentialité et les cas d'utilisation des logiciels prêts pour les utilisateurs ordinaires.
Non. L'identifiant peut identifier la transaction et son état de confirmation, mais le destinataire protégé, le montant et le mémo ne sont pas publics.
Non. Une divulgation porte sur certains détails d'une seule transaction. Une clé pour lecture seule peut révéler dans la durée l'activité correspondante d'une adresse ou d'un compte.
Pas selon la conception de ZIP 311. Une divulgation valide doit prouver l'autorité de dépense pour au moins une entrée. Le destinataire peut confirmer un paiement à l'aide de ses propres registres de portefeuille, mais il s'agit d'une affirmation différente.
Non. Elle n'accorde pas d'accès futur au compte comme une clé pour lecture seule, mais les données révélées et la preuve peuvent être copiées. Partagez-la avec autant de précautions que n'importe quel document financier privé.
Non. Créer ou vérifier une divulgation ne dépense, ne rembourse, ne gèle ni n'annule aucun fonds.
Commencez par les registres du portefeuille du destinataire, l'identifiant de transaction et l'état de confirmation, une référence de facture dans le mémo chiffré ou un autre reçu accepté par les deux parties. N'utilisez une clé pour lecture seule que lorsque sa portée plus large est réellement nécessaire et bien comprise.
| Oui |
| Elle déchiffre l'activité correspondante du compte |
| Logiciel en version bêta ; ses RPC de clés pour lecture seule et de transactions donnent un accès plus large ou des registres locaux, pas des preuves ZIP 311 |