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

Add Voting Locks section to OpenGov #5535

Merged
merged 8 commits into from
Jan 30, 2024
Merged

Add Voting Locks section to OpenGov #5535

merged 8 commits into from
Jan 30, 2024

Conversation

DrW3RK
Copy link
Member

@DrW3RK DrW3RK commented Jan 24, 2024

Clarity voting locks mechanism on Polkadot OpenGov

@DrW3RK DrW3RK requested a review from laboon January 24, 2024 11:10
@DrW3RK DrW3RK self-assigned this Jan 24, 2024
@DrW3RK DrW3RK added the A2 - Please Review Pull request is ready for review. label Jan 24, 2024
@DrW3RK DrW3RK linked an issue Jan 24, 2024 that may be closed by this pull request
Copy link
Contributor

@filippoweb3 filippoweb3 left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

lgtm, just a couple of comments

docs/learn/learn-polkadot-opengov.md Show resolved Hide resolved
Comment on lines 535 to 553
A lock is placed on the {{ polkadot: DOT :polkadot }}{{ kusama: KSM :kusama }} when you vote on an
Ongoing referendum. If you choose to remove your vote when the referendum is still in the decision period,
your voting lock is removed. Once the referendum is decided (accepted or rejected), your {{ polkadot: DOT :polkadot }}{{ kusama: KSM :kusama }}
will be available for unlocking if you voted with zero conviction. The governance app or interface you
used for participating in Polkadot OpenGov should show an option to unlock your {{ polkadot: DOT :polkadot }}{{ kusama: KSM :kusama }}.
[Here](https://support.polkadot.network/support/solutions/articles/65000184129) are the instructions to
do it on the Polkadot-JS UI.

If you voted with conviction, the corresponding locks start at the end of the Referendum and not at the moment you voted.
For instance, let's say you voted AYE with 6X conviction on a referendum, and it got accepted; the
{{ polkadot: DOT :polkadot }}{{ kusama: KSM :kusama }} you voted with is locked for 32 weeks from that moment.
If you voted NAY with 6X conviction on a referendum and it got accepted, then your {{ polkadot: DOT :polkadot }}{{ kusama: KSM :kusama }}
would be ready to be unlocked immediately. Polkadot OpenGov is designed to ensure that only the winning side
is mandated to lock their {{ polkadot: DOT :polkadot }}{{ kusama: KSM :kusama }} and the losing side can claim
{{ polkadot: DOT :polkadot }}{{ kusama: KSM :kusama }} and have it added to the transferable balance on their account.

For unlocking generic account locks, navigate to [this section](./learn-guides-accounts.md#unlocking-locks). When you
delegate your votes, the locking mechanism differs slightly. Please check the next section on Multirole Delegation for
more information.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@michalisFr can you double-check this suggestion I made?

@filippoweb3 filippoweb3 merged commit edc5fbf into master Jan 30, 2024
2 checks passed
@filippoweb3 filippoweb3 deleted the Voting-locks branch January 30, 2024 09:42
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
A2 - Please Review Pull request is ready for review.
Projects
None yet
Development

Successfully merging this pull request may close these issues.

Explain lock start time better
3 participants