Simplify versioning system for user guides
This new approach doesn't require version numbers and make easier for contributors to understand the status
of the document. There are only 3 states:
- Outdated: The page is outdated and might not work as expected
- Untranslated: The page needs to be translated
- Translation outdated: The page is translated, but the original (English) document has been updated
To mark a guide as outdated, we change the boolean of the front matter entry 'outdated' in /resources/user-guides/GUIDE.
If 'False', the guide is updated. If 'True' all versions of the guide (English included) will show a warning at the bottom
of the page.
The other 2 states are related to the status of the translated pages and we control them from the language-specific
user guides: /_i18n/LANG/resources/user-guides/GUIDE. At the top of the page a snippet will include 2 parameters:
- translated: "yes" if the page is translated, "no" if it's not.
- translationOutdated: "yes" if the translation is outdated, "no" if it's not
This new system aims to be simpler than the precedent, avoiding to compare versioning numbers and using a higher level
system instead (yes, no, True, False). I also removed the middle way status 'only minor changes', because if there are
only minor changes that don't affect the usability of the guide, we don't need to point it out.
The old system was complex and people didn't use it. These changes will hopefully make things easier for translators and
other contributors.
2020-05-03 16:38:01 +03:00
{% include disclaimer.html translated="yes" translationOutdated="no" %}
2018-05-14 01:28:58 +03:00
### Prouver un paiement
2018-04-05 10:11:44 +03:00
Lorsque vous envoyez un paiement à une partie qui conteste qu'il ait été effectué, vous devez pouvoir prouver qu'il a bien été effectué.
Avec Bitcoin, cela est généralement fait en recherchant l'ID de transaction, où les adresses d'origine et de destination sont
visibles, accompagnées du montant de la transaction.
Monero cependant est confidentiel : cette information n'est pas disponible publiquement sur la chaîne de blocs. Les étapes sont donc
un peu plus complexes.
Pour prouver à Charlie qu'elle a payée Bob, Alice doit fournir à Charlie ces données :
- L'ID de transaction, comme c'est le cas avec Bitcoin ;
- L'adresse de Bob, comme c'est le cas avec Bitcoin ;
- La clef de la transaction, qui est une nouveauté de Monero et d'autres monnaies CryptoNote.
Lorsqu'Alice a réalisé la transaction, une clef à usage unique a été automatiquement générée pour cette unique transaction.
2018-05-14 01:28:58 +03:00
#### CLI
2018-04-05 10:11:44 +03:00
Alice peut la demander dans monero-wallet-cli (nouveau nom de l'ancien simplewallet) :
> get_tx_key IDTX
Alice va indiquer son ID de transaction en lieu et place de ce IDTX. Une fois fait, la clef de transaction à usage unique
sera affichée.
Notez que cela ne fonctionnera que si monero-wallet-cli est configuré pour sauvegarder les clefs de transaction. Pour le vérifier :
> set
Si la valeur est fixée à 0, positionnez-la à 1 :
> set store-tx-info 1
2018-05-14 01:28:58 +03:00
#### GUI
2018-04-05 10:11:44 +03:00
2018-05-14 01:28:58 +03:00
Alice peut ouvrir son monero-wallet-gui et aller à la page historique pour voir les détails de la transaction :
![History ](png/prove-payment/history.png )
Ici, elle peut copier l'ID de transaction et l'adresse de Bob en cliquant sur chacun d'eux.
Puis elle peut cliquer sur `P` pour obtenir une preuve de paiement (clef de transaction) :
![Payment proof ](png/prove-payment/payment-proof.png )
2018-04-05 10:11:44 +03:00
---
2018-05-14 01:28:58 +03:00
Alice peut maintenant envoyer la clef de transaction à Charlie avec l'ID de transaction et l'adresse de Bob.
Notez : si plusieurs transactions ont été effectuées, il faudra répéter l'opération pour chacune de ces transactions.
### Vérifier un paiement
2018-04-05 10:11:44 +03:00
Charlie a maintenant reçu les trois données et veut vérifier qu'Alice dit la vérité à Bob : sur une chaîne de blocs à
2018-05-14 01:28:58 +03:00
jour,
#### CLI
Charlie entre dans monero-wallet-cli :
2018-04-05 10:11:44 +03:00
> check_tx_key IDTX CLEFTX ADRESSE
Les données fournies par Alice entrées en lieux et place de leurs identifiants respectifs. monero-wallet-clu va se servir
de la clef de transaction pour décoder la transaction et afficher quel montant a été envoyé à cette adresse pour cette
2018-05-14 01:28:58 +03:00
transaction spécifique.
#### GUI
Charlie ouvre son monero-wallet-gui et va à la page Avancé > Prouver/vérifier afin de remplir la section Vérifier avec les éléments transmis par Alice :
![Check payment ](png/prove-payment/check-payment.png )
Puis cliquer sur Vérifier indiquera à Charlie combien a été envoyé à cette adresse pour cette transaction spécifique et combien de confirmation la transaction a eu :
![Payment checked ](png/prove-payment/payment-checked.png )
---
2018-04-05 10:11:44 +03:00
2018-05-14 01:28:58 +03:00
Évidemment, Charlie voudra vérifier si l'adresse de Bob est bien la sienne, comme avec Bitcoin.
2018-04-05 10:11:44 +03:00
Notez : si plusieurs transactions ont été effectuées, il faudra répéter l'opération pour chacune de ces transactions.