Skip to content

Commit

Permalink
docs: more voting details (#85)
Browse files Browse the repository at this point in the history
* docs: add info about getting voting key from dmt

* docs: correct fee for premium names

* docs: more voting details
  • Loading branch information
thephez authored Oct 10, 2024
1 parent b434a76 commit 7886f27
Show file tree
Hide file tree
Showing 3 changed files with 28 additions and 4 deletions.
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

0 comments on commit 7886f27

Please sign in to comment.