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(playground): improve on governance transactions page #295

Draft
wants to merge 1 commit into
base: main
Choose a base branch
from
Draft
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
Original file line number Diff line number Diff line change
Expand Up @@ -50,8 +50,8 @@ function Left() {
<p>
A DRep is retired right away when the blockchain accepts a retirement
certificate. The deposit is refunded immediately as part of the
transaction that submits the retirement certificate, just like how
deposits are returned when a stake credential is unregistered.
output of the transaction that submits the retirement certificate, just
like how deposits are returned when using a Conway stake deregistration.
</p>
<p>
First we need to get the DRep ID of the DRep we want to retire. We can
Expand All @@ -77,7 +77,7 @@ function Left() {
<Codeblock data={codeSign} />
<p>
The transaction will be submitted to the blockchain and the DRep will be
retired. The deposit will be refunded to the DRep owner.
retired. The deposit will be refunded to the provided change address.
</p>
</>
);
Expand Down
15 changes: 9 additions & 6 deletions apps/playground/src/pages/apis/txbuilder/governance/index.tsx
Original file line number Diff line number Diff line change
Expand Up @@ -29,12 +29,15 @@ const ReactPage: NextPage = () => {
heroicon={metaTxbuilderGovernance.icon}
>
<p>
In{" "}
<Link href="https://cips.cardano.org/cip/cip-1694">CIP-1694</Link>,
Cardano's on-chain governance system was proposed to allow the
community to vote on proposals and protocol updates. This system is
designed to be decentralized and transparent, allowing the community
to have a say in the future of the network.
The implementation of {" "}
<Link href="https://cips.cardano.org/cip/cip-1694">CIP-1694 | A
First Step Towards On-Chain Decentralized Governance</Link> within
the Conway ledger era is Cardano's initial on-chain governance
design. This system was allows the community to vote on how the
chain is managed, such as how treasury funds are spent and changes
to protocol parameters. This system is designed to be decentralized
and transparent, allowing the community to decide the future of the
network.
</p>
<Intro />
<p>
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -76,25 +76,27 @@ function Left() {
return (
<>
<p>
In Voltaire, stake credentials can delegate their stake to Decentralized
Representatives (DReps) for voting, in addition to the current
delegation to stake pools for block production. This DRep delegation
will work similarly to the current stake delegation process, using
on-chain certificates. Registering as a DRep will also follow the same
process as stake registration.
In Conway, stake credentials can delegate the voting rights associated
with their to ada to Delegate Representatives (DReps) to empower the
DRep's votes, this mechanism is in addition to the current delegation to
stake pools to participate in consensus and block production. This vote
delegation is modeled on current stake delegation process, using
on-chain certificates. Registering as a DRep also follows the same
process as stake pool registration.
</p>
<p>
However, registered DReps need to vote regularly to remain active. If a
DRep does not vote for a set number of epochs (defined by the new
protocol parameter, drepActivity), they are considered inactive and will
not count towards the active voting stake. To become active again, DReps
need to vote on governance actions or submit a DRep update certificate
within the drepActivity period.
However, registered DReps need to vote or provide updates regularly to
counted as active. If a DRep does not vote or submit a DRep update
certificate for a set number of epochs (defined by the new protocol
parameter, drepActivity), they are considered inactive and the voting
power delegated to them is not counted towards the active voting stake.
To become active again, DReps need to vote on governance actions or
submit a DRep update certificate within the drepActivity period.
</p>

<p>A DRep registration certificates include:</p>
<ul>
<li>a DRep ID</li>
<li>a DRep credential (DRep ID)</li>
<li>a deposit</li>
<li>an optional anchor</li>
</ul>
Expand All @@ -119,7 +121,7 @@ function Left() {
<p>
Then, we select the UTxOs to pay for the registration. According to the
current protocol parameters, the deposit for registering a DRep is 500
ADA.
ada.
</p>
<Codeblock data={codeUtxo} />
<p>
Expand All @@ -134,8 +136,8 @@ function Left() {
<Codeblock data={codeBuildSign} />
<p>
The transaction will be submitted to the blockchain and the DRep will be
registered. The deposit will be taken from the DRep owner and the DRep
will be added to the list of registered DReps.
registered. The deposit will be taken from the wallet which controls
the DRep and the DRep will be added to the list of registered DReps.
</p>
</>
);
Expand Down