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 13:38:01 +00:00
{% include disclaimer.html translated="yes" translationOutdated="no" %}
2018-05-13 22:28:58 +00:00
### Udowodnij płatności
2018-03-05 21:25:07 +00:00
Jeżeli dokonasz płatności osobie, która później ją zakwestionuje, musisz być w stanie udowodnić, że pieniądze zostały przesłane.
2018-02-26 16:22:26 +00:00
2018-03-05 21:25:07 +00:00
W przypadku Bitcoina zazwyczaj dokonuje się tego, wyszukując numer identyfikacyjny transakcji, gdzie adres nadawcy i odbiorcy oraz przesłana kwota są ujawnione.
2018-02-26 16:22:26 +00:00
2018-03-05 21:25:07 +00:00
Jednak Monero jest prywatne - te informacje nie są publicznie dostępne w łańcuchu bloków. W związku z tym, kroki są trochę bardziej skomplikowane.
2018-02-26 16:22:26 +00:00
2018-03-05 21:25:07 +00:00
Aby udowodnić Pawłowi, że Ewa przesłała pieniądze Jackowi, musi ona przekazać Pawłowi trzy informacje:
2018-02-26 16:22:26 +00:00
2018-03-05 21:25:07 +00:00
- numer identyfikacyjny transakcji, tak jak się to dzieje w przypadku Bitcoina
- adres Jacka, tak jak się to dzieje w przypadku Bitcoina
- klucz transakcji, który jest wyłącznością Monero i innych walut CryptoNote.
2018-02-26 16:22:26 +00:00
2018-05-13 22:28:58 +00:00
Gdy Ewa dokonywała transakcji, jendorazowy klucz został wygenerowany tylko dla tej płatności.
#### CLI
Ewa może więc odnaleźć go w monero-wallet-cli (nowa nazwa dawnego simplewallet):
2018-02-26 16:22:26 +00:00
> get_tx_key TXID
2018-03-05 21:25:07 +00:00
Ewa zamieni TXID na swój numer identyfikacyjny transakcji. W wyniku tego, wyświetlony zostanie jednorazowy klucz transakcji.
2018-02-26 16:22:26 +00:00
2018-03-05 21:25:07 +00:00
Zauważ, że to zadziała tylko wtedy, gdy monero-wallet-cli zostanie ustawiony na zapisywanie kluczy transakcji. Aby się upewnić, że tak jest, wpisz:
2018-02-26 16:22:26 +00:00
> set
2018-03-05 21:25:07 +00:00
Jeśli ustawione jest na 0, zmień na 1:
2018-02-26 16:22:26 +00:00
> set store-tx-info 1
2018-05-13 22:28:58 +00:00
#### GUI
Ewa może otworzyć swój Graficzny Interfejs Użytkownika i przejść do Historii, gdzie wyszuka szczegóły transakcji:
2020-10-31 14:42:04 +00:00
![History ](/img/resources/user-guides/en/prove-payment/history.png )
2018-05-13 22:28:58 +00:00
Stąd może ona skopiować numer identyfikacyjny transakcji oraz adres Jacka, klikając na nie.
Następnie po kliknięciu `P` , Ewa wygeneruje dowód płatności (klucz transakcji).
2020-10-31 14:42:04 +00:00
![Payment proof ](/img/resources/user-guides/en/prove-payment/payment-proof.png )
2018-05-13 22:28:58 +00:00
---
2018-03-05 21:25:07 +00:00
Ewa może teraz przesłać Pawłowi klucz transakcji razem z numerem identyfikacyjnym transakcji oraz adresem Jacka.
2018-02-26 16:22:26 +00:00
2018-03-05 21:25:07 +00:00
Zauważ, że jeśli zostało dokonanych wiele transakcji, cały proces musi zostać powtórzony dla każdej transakcji.
2018-02-26 16:22:26 +00:00
2018-05-13 22:28:58 +00:00
### Sprawdź płatności
2018-02-26 16:22:26 +00:00
2018-05-13 22:28:58 +00:00
Paweł otrzymał trzy informacje i chce sprawdzić, czy Ewa mówi prawdę - w aktualnym łańcuchu bloków
#### CLI
2018-02-26 16:22:26 +00:00
2018-05-13 22:28:58 +00:00
Paweł wpisuje w wierszu poleceń:
2018-02-26 16:22:26 +00:00
> check_tx_key TXID TXKEY ADDRESS
2018-05-13 22:28:58 +00:00
Paweł zamienił symbole na informacje dostarczone przez Ewę. monero-wallet-cli użyje klucza transakcji do odszyfrowania jej i wyświetli kwotę przesłaną na ten konkretny adres.
#### GUI
Paweł otworzy swój Graficzny Interfejs Użytkownika i przejdzie do strony Advanced > Prove/Check, aby wypełnić pole Check informacjami dostarczonymi przez Ewę.
2020-10-31 14:42:04 +00:00
![Check payment ](/img/resources/user-guides/en/prove-payment/check-payment.png )
2018-05-13 22:28:58 +00:00
Po kliknięciu "Check" Paweł dowie się, jaka kwota została przelana na ten adres w tej konkretnej transakcji oraz ile potwierdzeń miała transakcja.
2020-10-31 14:42:04 +00:00
![Payment checked ](/img/resources/user-guides/en/prove-payment/payment-checked.png )
2018-05-13 22:28:58 +00:00
---
2018-02-26 16:22:26 +00:00
2018-05-13 22:28:58 +00:00
Oczywiście, Paweł będzie chciał się upewnić, czy adres Jacka rzeczywiście do niego należy - tak samo jak w przypadku Bitcoina.
2018-02-26 16:22:26 +00:00
2018-03-05 21:25:07 +00:00
Zauważ, że jeśli zostało dokonanych wiele transakcji, cały proces musi zostać powtórzony dla każdej transakcji.
2018-02-26 16:22:26 +00:00