Skip to content

Update validator and delegator pages for browser wallet #1298

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

Merged
merged 14 commits into from
Mar 6, 2025
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
2 changes: 2 additions & 0 deletions source/mainnet/docs/guides/account-activities-lp.rst
Original file line number Diff line number Diff line change
Expand Up @@ -21,6 +21,8 @@ If you need to know how to send CCDs, connect dApps, manage fungible and non-fun
export-transaction-logs
../mobile-wallet/add-baker-mw
../mobile-wallet/update-baker-mw
../mobile-wallet/stop-validator
../mobile-wallet/suspend-unsuspend-validator
add-delegation
remove-delegation
update-delegation
43 changes: 20 additions & 23 deletions source/mainnet/docs/guides/add-delegation.rst
Original file line number Diff line number Diff line change
Expand Up @@ -175,44 +175,41 @@ When you delegate some stake to a staking pool, it can influence the chances of

.. dropdown:: |bw|

#. Click |earn| on the navigation bar. Use the left and right arrow to locate the button if necessary.
#. In the dropdown list, select the account that you want to delegate from and click **Earn**.

.. image:: ../images/browser-wallet/setup-baking-delegation.png
:width: 40%
#. In the *Delegation* section, click **Continue to delegation setup**.

#. Click **Setup delegation**. If you are delegating for the first time on the account, you see some information about delegation.
.. image:: ../images/browser-wallet/new/add_delegation1.png
:width: 50%

.. image:: ../images/browser-wallet/add-delegation-baking.png
:width: 40%
#. You can now go through anumber of informational screens explaining the key concepts of delegation on the Concordium blockchain, including delegation models, staking pools, passive delegation, pay days, and lock-ins/cool-downs. Click **Next** to navigate through the screens. Click **Skip** to proceed directly to registering your validation.

#. On the **Register delegation** screen choose whether to delegate to a specific pool click **Staking pool** and enter the Validator ID of the pool owner. If you are delegating to passive delegation, click **Passive delegation**. Click **Continue**.
.. image:: ../images/browser-wallet/new/add_delegation2.png
:width: 50%

.. image:: ../images/browser-wallet/delegation-target.png
:width: 40%
#. On the Register delegation screen, you have two options: If you want to delegate to a specific pool, click **Validator** and enter the Validator ID of the pool owner. If you want to register a passive delegation, click **Passive**. Click **Continue** to proceed.

#. Select your restake preference. Click **Yes, restake** to restake any rewards or click **No, don't restake** if you don’t want to restake rewards. If you do not restake, rewards are deposited to your disposable balance. Click **Continue**.
.. image:: ../images/browser-wallet/new/add_delegation3.png
:width: 50%

.. image:: ../images/browser-wallet/delegation-restake-preference.png
:width: 40%
#. You can see your balance available to delegate. Enter the amount you want to delegate in the field and select your restake preference. Delegators receive rewards proportional to their stake, and by default, these rewards can be automatically added to your delegation amount. Use the **Restake rewards** toggle to enable this feature if you prefer to have your rewards automatically added to your delegation amount at each pay day, increasing your stake and future rewards. If disabled, rewards will be deposited to your disposable balance instead. Click **Continue** to proceed.

#. You can see your available balance to delegate on the account that is in focus. You can change the account from the Accounts drop-down at the top of the screen if you want to set up delegation on a different account than the one in focus. **Enter the Amount you want to delegate** in the field. Click **Continue**.
.. image:: ../images/browser-wallet/new/add_delegation4.png
:width: 50%

.. image:: ../images/browser-wallet/create-delegation-amount.png
:width: 40%
#. Review the information including your delegation style and amount, amount, reward settings, and commission rates. When you're satisfied with the configuration, scroll down and click **Send** to finalize the transaction.

#. Review the information in the transaction overview. When you are satisfied, click **Send**.
.. image:: ../images/browser-wallet/new/add_delegation_send.png
:width: 50%

#. Once the transaction is submitted you see a confirmation screen. Click **Finish** to complete the action.
#. The wallet shows a confirmation screen with a green checkmark indicating that your delegation transaction has been successfully submitted to the chain. You can see the amount you're delegating with. You can click **Transaction details** to view more information about the transaction, or **Return to account** to return to your account overview.

Once the transaction is finalized, the delegation is effective from the next pay day. You can see the delegation type and amount on the account card.
.. image:: ../images/browser-wallet/new/add_delegation6.png
:width: 50%

.. image:: ../images/browser-wallet/delegated-amount.png
:width: 40%
Once the transaction is finalized, the delegation is effective from the next pay day. You can see the delegation type and amount on the account card.

Accounts with delegation also have a badge in the account list.

.. image:: ../images/browser-wallet/delegation-acct-list.png
:width: 40%

.. |earn| image:: ../images/earn.png
:alt: Hand receiving money
Expand Down
31 changes: 10 additions & 21 deletions source/mainnet/docs/guides/remove-delegation.rst
Original file line number Diff line number Diff line change
Expand Up @@ -151,35 +151,24 @@ If you remove the delegation, there is a :term:`cool-down period` before the amo

.. dropdown:: |bw|

#. Bring the account whose delegation you want to stop into focus by clicking the **Accounts** drop-down at the top of the screen and selecting the account.
#. In the dropdown list, select the delegating account and click **Earn**.

.. image:: ../images/browser-wallet/select-account.png
:width: 40%
:alt: screen with accounts drop-down activated and account selection shown
#. On the next screen, click **Stop**

#. Click |earn| on the navigation bar. Use the left and right arrow to locate the button if necessary.
.. image:: ../images/browser-wallet/new/stop_delegation1.png
:width: 50%

.. image:: ../images/browser-wallet/delegation-update-stop.png
:width: 40%
:alt: screen showing current delegation and buttons to update or stop
#. Review the information. Note that your delegated stake will be released after 7 days. Click **Send** to finalize the transaction.

#. You see your current delegation. Click **Stop**. Review the information about the cool-down period.
.. image:: ../images/browser-wallet/new/stop_delegation_send.png
:width: 50%

.. image:: ../images/browser-wallet/update-stop-delegation-baking.png
:width: 40%
:alt: screen showing current delegation and buttons to update or stop
#. The wallet shows a confirmation screen with a green checkmark indicating that your delegation has been successfully stopped. You can click **Transaction details** to view more information about the transaction, or **Return to account** to return to your account overview.

#. Review the information in the transaction overview. When you are satisfied, click **Send**.
.. image:: ../images/browser-wallet/new/stop_delegation3.png
:width: 50%

.. image:: ../images/browser-wallet/delegation-stop-xact-confirm.png
:width: 40%
:alt: screen showing the transaction details that will be submitted to the chain

#. Once the transaction is submitted you see a confirmation screen. Click **Finish** to complete the action.

.. image:: ../images/browser-wallet/delegation-xact-submit.png
:width: 40%
:alt: screen showing the transaction submitted to the chain and finish button

.. |earn| image:: ../images/earn.png
:alt: Hand receiving money
Expand Down
74 changes: 31 additions & 43 deletions source/mainnet/docs/guides/update-delegation.rst
Original file line number Diff line number Diff line change
Expand Up @@ -12,6 +12,7 @@ Note that if you decrease or remove the delegation, there is a :term:`cool-down

Before delegating stake to a staking pool, it is important to research the pool using :ref:`CCDScan<ccd-scan>`. You can only have one delegation per account.


.. Note::

Any changes made in the last epoch before the upcoming pay day are applied not in the upcoming pay day but the pay day after that.
Expand All @@ -25,6 +26,20 @@ Before delegating stake to a staking pool, it is important to research the pool
.. Warning::
Make sure you have enough funds in your disposable balance to cover transaction fees.

Updating delegation from a suspendet validator
----------------------------------------------
If a validator you've delegated to becomes suspended, you'll see a warning banner in your wallet interface indicating *Your validator has been suspended*. When a validator is suspended, both the validator and its delegators stop earning rewards.
To maintain your earning potential, you may consider moving your delegation to another active validator or to passive delegation.

.. image:: ../images/browser-wallet/new/your_validator_suspended_banner.png
:width: 50%


To update your delegation from a suspended validator, follow the same update process described below for each wallet type.

Update delegation
-----------------

.. dropdown:: |cryptox|

#. Tap the account on the accounts screen.
Expand Down Expand Up @@ -172,60 +187,33 @@ Before delegating stake to a staking pool, it is important to research the pool

.. dropdown:: |bw|

#. Bring the account whose delegation you want to update into focus by clicking the **Accounts** drop-down at the top of the screen and selecting the account.

.. image:: ../images/browser-wallet/select-account.png
:width: 40%
:alt: screen with accounts drop-down activated and account selection shown

#. Click |earn| on the navigation bar. Use the left and right arrow to locate the button if necessary.

.. image:: ../images/browser-wallet/delegation-update-stop.png
:width: 40%
:alt: screen showing current delegation and buttons to update or stop

#. You see your current delegation. Click **Update**. Review the information about updating your delegation.

.. image:: ../images/browser-wallet/update-stop-delegation-baking.png
:width: 40%
:alt: screen showing current delegation and buttons to update or stop

#. If you want to delegate to a specific pool click **Target** and enter the validator ID of the pool owner you want to switch the delegation to. If you want to delegate to passive delegation, click **Passive**. Click **Continue**.

.. image:: ../images/browser-wallet/delegation-update-target.png
:width: 40%
:alt: screen showing current delegation and buttons to select target
#. In the dropdown list, select the delegating account and click **Earn**.

#. Click **Update**.

.. image:: ../images/browser-wallet/delegation-update-target1.png
:width: 40%
:alt: screen showing current delegation and buttons to select target
.. image:: ../images/browser-wallet/new/update_delegation1.png
:width: 50%

#. Select your restake preference. Click **Yes, restake** to restake any rewards or click **No, don't restake** if you don’t want to restake rewards. If you do not restake, rewards are deposited to your disposable balance. Click **Continue**.
#. On the next screen, you can modify delegation preferences. Select *Validator* to delegate to a specific validator pool of your choice, select *Passive* to use passive delegation. Click **Continue** to proceed.

.. image:: ../images/browser-wallet/delegation-update-restaking-pref.png
:width: 40%
:alt: screen with buttons to select restaking rewards preference
.. image:: ../images/browser-wallet/new/update_delegation2.png
:width: 50%

#. You can see your balance available to delegate at the top of screen and the amount of your current delegation. If you want to change the amount enter that in the **Enter the Amount you want to delegate** field. Click **Continue**.
#. On the next screen, you can make any desired changes to your delegation amount and change your restake rewards options. Click **Continue** to proceed.

.. image:: ../images/browser-wallet/delegation-update-amount.png
:width: 40%
:alt: screen to enter delegation amount
.. image:: ../images/browser-wallet/new/update_delegation3.png
:width: 50%

#. Review the information in the transaction overview. When you are satisfied, click **Send**.
#. Review the information including your delegation amount, and commission rates. When you're satisfied with the configuration, click **Send** to finalize the transaction.

.. image:: ../images/browser-wallet/delegation-update-xact-confirm.png
:width: 40%
:alt: screen showing delegation transaction details for review
.. image:: ../images/browser-wallet/new/update_delegation_send.png
:width: 50%

#. Once the transaction is submitted you see a confirmation screen. Click **Finish** to complete the action.
#. The wallet shows a confirmation screen with a green checkmark indicating that your delegation settings have been successfully updated. You can click **Transaction details** to view more information about the transaction, or **Return to account** to return to your account overview.

.. image:: ../images/browser-wallet/delegation-update-submit.png
:width: 40%
:alt: screen showing transaction details submitted to chain
.. image:: ../images/browser-wallet/new/update_delegation5.png
:width: 50%

Once the transaction is finalized, the delegation update is effective from the next pay day for most transactions, except reducing your stake.


.. |earn| image:: ../images/earn.png
Expand Down
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file modified source/mainnet/docs/images/browser-wallet/new/add_validator1.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading