diff --git a/docs/tutorials/tui/img/TUI-1.png b/docs/tutorials/tui/img/TUI-1.png index 725c0068e..a656d66a4 100644 Binary files a/docs/tutorials/tui/img/TUI-1.png and b/docs/tutorials/tui/img/TUI-1.png differ diff --git a/docs/tutorials/tui/img/TUI-2.png b/docs/tutorials/tui/img/TUI-2.png deleted file mode 100644 index e3ac082ca..000000000 Binary files a/docs/tutorials/tui/img/TUI-2.png and /dev/null differ diff --git a/docs/tutorials/tui/img/TUI-8.png b/docs/tutorials/tui/img/TUI-8.png deleted file mode 100644 index 4fcdbc09e..000000000 Binary files a/docs/tutorials/tui/img/TUI-8.png and /dev/null differ diff --git a/docs/tutorials/tui/img/TUI-dpns.png b/docs/tutorials/tui/img/TUI-dpns.png deleted file mode 100644 index 03d3c5e6c..000000000 Binary files a/docs/tutorials/tui/img/TUI-dpns.png and /dev/null differ diff --git a/docs/tutorials/tui/img/contracts.png b/docs/tutorials/tui/img/contracts.png new file mode 100644 index 000000000..a8366796b Binary files /dev/null and b/docs/tutorials/tui/img/contracts.png differ diff --git a/docs/tutorials/tui/img/dpns/dpns-contested-resources-status.png b/docs/tutorials/tui/img/dpns/dpns-contested-resources-status.png new file mode 100644 index 000000000..33eb1f892 Binary files /dev/null and b/docs/tutorials/tui/img/dpns/dpns-contested-resources-status.png differ diff --git a/docs/tutorials/tui/img/dpns/dpns-contested-resources-status2.png b/docs/tutorials/tui/img/dpns/dpns-contested-resources-status2.png new file mode 100644 index 000000000..9cc79ec42 Binary files /dev/null and b/docs/tutorials/tui/img/dpns/dpns-contested-resources-status2.png differ diff --git a/docs/tutorials/tui/img/dpns/dpns-contested-resources-vote-success.png b/docs/tutorials/tui/img/dpns/dpns-contested-resources-vote-success.png new file mode 100644 index 000000000..c740a065e Binary files /dev/null and b/docs/tutorials/tui/img/dpns/dpns-contested-resources-vote-success.png differ diff --git a/docs/tutorials/tui/img/dpns/dpns-contested-resources-vote.png b/docs/tutorials/tui/img/dpns/dpns-contested-resources-vote.png new file mode 100644 index 000000000..72fdc025f Binary files /dev/null and b/docs/tutorials/tui/img/dpns/dpns-contested-resources-vote.png differ diff --git a/docs/tutorials/tui/img/dpns/dpns-contested-resources.png b/docs/tutorials/tui/img/dpns/dpns-contested-resources.png new file mode 100644 index 000000000..a092d8908 Binary files /dev/null and b/docs/tutorials/tui/img/dpns/dpns-contested-resources.png differ diff --git a/docs/tutorials/tui/img/dpns/dpns.png b/docs/tutorials/tui/img/dpns/dpns.png new file mode 100644 index 000000000..864cd0f8a Binary files /dev/null and b/docs/tutorials/tui/img/dpns/dpns.png differ diff --git a/docs/tutorials/tui/img/identities/identities.png b/docs/tutorials/tui/img/identities/identities.png new file mode 100644 index 000000000..e54d54a41 Binary files /dev/null and b/docs/tutorials/tui/img/identities/identities.png differ diff --git a/docs/tutorials/tui/img/identities/identity-load-mn-1-protx.png b/docs/tutorials/tui/img/identities/identity-load-mn-1-protx.png new file mode 100644 index 000000000..3babd2bf2 Binary files /dev/null and b/docs/tutorials/tui/img/identities/identity-load-mn-1-protx.png differ diff --git a/docs/tutorials/tui/img/identities/identity-load-mn-2-key.png b/docs/tutorials/tui/img/identities/identity-load-mn-2-key.png new file mode 100644 index 000000000..487c38efd Binary files /dev/null and b/docs/tutorials/tui/img/identities/identity-load-mn-2-key.png differ diff --git a/docs/tutorials/tui/img/identities/identity-load-mn-3-success.png b/docs/tutorials/tui/img/identities/identity-load-mn-3-success.png new file mode 100644 index 000000000..6b6cd8376 Binary files /dev/null and b/docs/tutorials/tui/img/identities/identity-load-mn-3-success.png differ diff --git a/docs/tutorials/tui/img/identities/identity-load-mn-4-refresh.png b/docs/tutorials/tui/img/identities/identity-load-mn-4-refresh.png new file mode 100644 index 000000000..e40be8e44 Binary files /dev/null and b/docs/tutorials/tui/img/identities/identity-load-mn-4-refresh.png differ diff --git a/docs/tutorials/tui/img/platform-info.png b/docs/tutorials/tui/img/platform-info.png new file mode 100644 index 000000000..838f5c281 Binary files /dev/null and b/docs/tutorials/tui/img/platform-info.png differ diff --git a/docs/tutorials/tui/index.md b/docs/tutorials/tui/index.md index 731cc5cc5..4b8a47e05 100644 --- a/docs/tutorials/tui/index.md +++ b/docs/tutorials/tui/index.md @@ -26,19 +26,19 @@ Click an option below to jump to the section describing it in more detail: This screen is where identity operations are done, including requesting identities, transferring credits, and registering [DPNS names](https://docs.dash.org/projects/platform/en/stable/docs/explanations/dpns.html). Press `p` to enable proofs. -![Identities screen](./img/TUI-2.png) +![Identities screen](./img/identities/identities.png) ## Name Service (DPNS) This screen view information related to your identities and any names linked to them. It also provides access to the voting screen where masternodes can vote on [requests for premium names](../../explanations/dpns.md#conflict-resolution). -![DPNS screen](./img/TUI-dpns.png) +![DPNS screen](./img/dpns/dpns.png) ## Contracts This screen is where you will add, manage and remove [contracts](https://docs.dash.org/projects/platform/en/stable/docs/tutorials/contracts-and-documents.html). System contracts encompass [Dashpay](https://docs.dash.org/projects/platform/en/stable/docs/explanations/dashpay.html) and [DPNS](https://docs.dash.org/projects/platform/en/stable/docs/explanations/dpns.html) contracts as of today, other contracts must be fetched by ID. -![Contracts screen](./img/TUI-8.png) +![Contracts screen](./img/contracts.png) ## Wallet @@ -57,7 +57,7 @@ This screen also provides options for you to: This screen lets you see information on the epochs and the current version voting -![Platform information screen](./img/TUI-49.png) +![Platform information screen](./img/platform-info.png) ## Strategies @@ -90,3 +90,79 @@ Remember that when adding a number of operations to the strategy, it is the numb #### Add strategy operation ![Add strategy screen](./img/TUI-29.png) + +## Name voting + +:::{tip} +Masternode and evonode owners that want to participate in voting should [load their masternode identity](#load-masternode-identity) before continuing. +::: + +Since some names may be popular, the DPNS name registration process includes a voting mechanism to +resolve conflicts when multiple identities request the same name. Anyone can view the contested +resources screen and vote status; however, voting can only be done by masternodes and evonodes. + +### DPNS Contested resources + +The following sections describe how to [view](#viewing) and [vote](#voting) on contested resources. + +#### Viewing + +From the [DPNS main screen](#name-service-dpns), press `v` to open the voting screen. + +![DPNS screen](./img/dpns/dpns.png) + +The left side of the contested resources screen lists all names requiring votes. Scroll up or down +to select a name, then press `s` to see the current voting status. + +![DPNS contested resources screen](./img/dpns/dpns-contested-resources.png) + +The vote status lists all identities currently requesting the name and the number of votes for each +one. Vote count for the abstain and lock categories are also shown. + +![DPNS contested resources screen showing status](./img/dpns/dpns-contested-resources-status.png) + +#### Voting + +:::{attention} +Voting can only be done by masternodes and evonodes, and each node can only modify its vote four +times. See the [load masternode identity section](#load-masternode-identity) for instructions on +importing your masternode voting key to vote using the TUI. +::: + +To vote on a contested resource, press `v` to open the voting screen, select your preferred option, and press `Enter` to submit your response. + +![DPNS contested resources voting screen](./img/dpns/dpns-contested-resources-vote.png) + +You will be returned to the contested resources screen and should see "Vote cast successfully". + +![DPNS contested resources vote success](./img/dpns/dpns-contested-resources-vote-success.png) + +Check the status again to confirm that your vote was successful. + +![DPNS contested resources screen showing status after vote](./img/dpns/dpns-contested-resources-status2.png) + +### Load masternode identity + +:::{note} +A bug in the Platform TUI currently requires a wallet to be loaded before a masternode identity can +be loaded. Go to the [wallet screen](#wallet) and press `r` to create a random wallet if you have +not already created one. +::: + +From the [Identities main screen](#identity-management), press `m` to load a masternode or evonode +identity. Paste the node's protx hash and press `Enter`. + +![Load masternode protx](./img/identities/identity-load-mn-1-protx.png) + +On the next screen, paste the node's voting private key and press `Enter`. + +![Load masternode voting key](./img/identities/identity-load-mn-2-key.png) + +You will be returned to the Identities main screen and should see "Loaded Evonode Identity". + +![Load masternode success](./img/identities/identity-load-mn-3-success.png) + +Refresh the screen to see the identity by pressing `q` to return to the main screen, and then reopen +the Identities screen by pressing `i`. + +![Load masternode refreshed screen](./img/identities/identity-load-mn-4-refresh.png) \ No newline at end of file