Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

docs: more voting details #85

Merged
merged 3 commits into from
Oct 10, 2024
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
24 changes: 20 additions & 4 deletions docs/explanations/dpns.md
Original file line number Diff line number Diff line change
Expand Up @@ -37,7 +37,7 @@ In the registration phase, the domain name (e.g. `alice.dash`) is once again sub

### Conflict resolution

Since some names may be popular, the registration process includes a voting mechanism to resolve conflicts when multiple identities request the same name. Identities requesting premium names must pay a fee (200 credits) to cover the masternode voting costs.
Since some names may be popular, the registration process includes a voting mechanism to resolve conflicts when multiple identities request the same name. Identities requesting premium names must pay a fee (0.2 DASH) to cover the masternode voting costs.

:::{note}
This process only applies to names that meet the following conditions:
Expand All @@ -48,11 +48,27 @@ This process only applies to names that meet the following conditions:
All other available names can be registered immediately.
:::

The voting window begins when a name matching the criteria above is requested and ends after two weeks. Additional identities can request the same name during the first week. Masternodes and evonodes can vote for one of the identities, abstain, or vote to lock the request.
#### Timeline

After voting concludes, the name is either awarded to one of the identities or locked. If the vote locks the name, no identity receives it. Locked names can no longer be requested or awarded in Dash Platform v1.0, but future updates may add unlock capabilities.
A two-week voting window begins when a name matching the criteria above is requested. Additional identities can request the same name during the first week of the voting window.

Assuming masternodes do not vote to lock, the identity receiving the most votes takes ownership of the name. If only one identity requests the name, they will receive it even if no masternodes vote.
#### Voting details

As with governance voting, evonode votes are worth four, and regular masternode votes are worth one. Voting is done using the voting key assigned in the provider transaction used to register or update the node. Masternodes and evonodes can:

1. Vote for one of the identities.
1. Vote to abstain. These votes are not counted when determining the outcome.
1. Vote to lock the request. Locked names are not awarded to anyone.

#### Vote outcome

After voting ends, the name is either awarded to one of the identities or locked. The outcome is based on which item receives the most votes.

Assuming masternodes do not vote to lock, the identity receiving the most votes takes ownership of the name. However, if the vote locks the name, no identity receives it. If only one identity requests the name, they will receive it even if no masternodes vote.

:::{note}
Locked names can no longer be requested or awarded in Dash Platform v1, but the plan is to change this in future updates.
:::

### Implementation

Expand Down
Binary file added docs/tutorials/tui/img/dmt-voting-key.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
8 changes: 8 additions & 0 deletions docs/tutorials/tui/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -156,6 +156,14 @@ identity. Paste the node's protx hash and press `Enter`.

On the next screen, paste the node's voting private key and press `Enter`.

:::{tip}
If you use the [Dash Masternode Tool](https://github.com/Bertrand256/dash-masternode-tool), you can
get the key by opening the masternode details screen and copying the value from the *Voting private
key* field.

![DMT voting key](./img/dmt-voting-key.png)
:::

![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".
Expand Down
Loading