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" %}
2019-03-11 15:28:21 +02:00
2019-10-25 01:33:41 +03:00
### Provando pagamentos
2019-03-11 15:28:21 +02:00
2019-10-25 01:33:41 +03:00
Se você enviou dinheiro para alguém, e essa pessoa precisa que você confirme para ela que o pagamento foi feito, você precisa ser capaz de provar isso.
2019-03-11 15:28:21 +02:00
2019-10-25 01:33:41 +03:00
No Bitcoin, para comprovar uma transação, normalmente se envia o ID da transação, que, ao ser pesquisado na blockchain, informará quais os endereços de origem e de destino, assim como a quantia transacionada.
2019-03-11 15:28:21 +02:00
2019-10-25 01:33:41 +03:00
O Monero, entretanto, é uma moeda privada: essas informações não estão disponíveis publicamente na blockchain. Em função disso, os passos necessários para comprovar a transação são um pouco mais complexos.
2019-03-11 15:28:21 +02:00
2019-10-25 01:33:41 +03:00
Para provar para Charlie que ela fez um pagamento para Bob, Alice precisa fornecer a Charlie três informações:
2019-03-11 15:28:21 +02:00
2019-10-25 01:33:41 +03:00
- o ID da transação, assim como é feito no Bitcoin
- a chave da transação, que é uma chave usada pelo Monero e outras moedas que usam o protocolo CryptoNote
- o endereço do Bob, assim como é feito no Bitcoin
Quando a Alice faz uma transação, uma chave de uso único é gerada automaticamente para cada transação.
2019-03-11 15:28:21 +02:00
#### CLI
2019-10-25 01:33:41 +03:00
Alice pode requisitar a chave da transação (tx_key) na monero-wallet-cli:
2019-03-11 15:28:21 +02:00
2019-10-25 01:33:41 +03:00
> get_tx_key ID_DA_TRANSAÇÃO
2019-03-11 15:28:21 +02:00
2019-10-25 01:33:41 +03:00
A ID da transação deve ser inserida no lugar de ID_DA_TRANSAÇÃO. Se tudo der certo, a chave da transação será exibida.
2019-03-11 15:28:21 +02:00
2019-10-25 01:33:41 +03:00
Note que isso só irá funcionar se a monero-wallet-cli estiver configurada para salvar as chaves de transação. Para verificar, digite:
2019-03-11 15:28:21 +02:00
> set
2019-10-25 01:33:41 +03:00
Se o salvamento das chaves de transação (store-tx-info) estiver configurado para 0 (desativado), então você terá que configurá-lo para 1 (ativado):
2019-03-11 15:28:21 +02:00
> set store-tx-info 1
#### GUI
2019-10-25 01:33:41 +03:00
Alice pode abrir sua monero-wallet-gui e ir para a página Histórico para ver os detalhes da transação:
2019-03-11 15:28:21 +02:00
2020-10-31 16:42:04 +02:00
![History ](/img/resources/user-guides/en/prove-payment/history.png )
2019-03-11 15:28:21 +02:00
2019-10-25 01:33:41 +03:00
Nesta página ela pode copiar o ID da transação e o endereço do Bob (endereço de destino), clicando em cada um deles.
Então ela pode clicar em `P` para obter uma prova de pagamento (chave da transação):
2019-03-11 15:28:21 +02:00
2020-10-31 16:42:04 +02:00
![Payment proof ](/img/resources/user-guides/en/prove-payment/payment-proof.png )
2019-03-11 15:28:21 +02:00
---
2019-10-25 01:33:41 +03:00
Agora Alice pode enviar para Charlie a ID da transação, a chave da transação e o endereço do Bob.
2019-03-11 15:28:21 +02:00
2019-10-25 01:33:41 +03:00
Nota: se várias transações forem feitas, o procedimento precisa ser repetido para cada transação.
2019-03-11 15:28:21 +02:00
2019-10-25 01:33:41 +03:00
### Verificando pagamentos
2019-03-11 15:28:21 +02:00
2019-10-25 01:33:41 +03:00
Agora que Charlie recebeu essas três informações, ele pode verificar se a Alice está falando a verdade: em uma blockchain atualizada,
2019-03-11 15:28:21 +02:00
#### CLI
2019-10-25 01:33:41 +03:00
Charlie digita na monero-wallet-cli:
2019-03-11 15:28:21 +02:00
2019-10-25 01:33:41 +03:00
> check_tx_key ID_DA_TRANSAÇÃO CHAVE_DA_TRANSAÇÃO ENDEREÇO
2019-03-11 15:28:21 +02:00
2019-10-25 01:33:41 +03:00
As informações que a Alice forneceu devem ser substituídas nos campos ID_DA_TRANSAÇÃO, CHAVE_DA_TRANSAÇÃO e ENDEREÇO. A monero-wallet-cli irá usar a chave da transação para decodificar a transação, exibindo quantos XMR essa transação enviou para o endereço. Logicamente, Charlie deverá verificar com Bob se o endereço realmente é dele, assim como seria necessário com Bitcoin.
2019-03-11 15:28:21 +02:00
#### GUI
2019-10-25 01:33:41 +03:00
Charlie irá abrir sua monero-wallet-gui e ir até a página Avançado > Provar/Conferir, preenchendo a seção "Verificar transação" com as informações fornecidas pela Alice:
2019-03-11 15:28:21 +02:00
2020-10-31 16:42:04 +02:00
![Check payment ](/img/resources/user-guides/en/prove-payment/check-payment.png )
2019-03-11 15:28:21 +02:00
2019-10-25 01:33:41 +03:00
Ao clicar em Verificar, Charlie ficará sabendo quantos XMR essa transação enviou para este endereço e quantas confirmações a transação já teve:
2019-03-11 15:28:21 +02:00
2020-10-31 16:42:04 +02:00
![Payment checked ](/img/resources/user-guides/en/prove-payment/payment-checked.png )
2019-03-11 15:28:21 +02:00
---
2019-10-25 01:33:41 +03:00
Logicamente, Charlie deverá checar com Bob se o endereço realmente é dele, assim como seria necessário com Bitcoin.
2019-03-11 15:28:21 +02:00
2019-10-25 01:33:41 +03:00
Nota: se várias transações forem feitas, o procedimento precisa ser repetido para cada transação.