Skip to content

Add p8 in ctypto x #1315

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 11 commits into from
Mar 12, 2025
28 changes: 8 additions & 20 deletions source/mainnet/docs/guides/add-delegation.rst
Original file line number Diff line number Diff line change
Expand Up @@ -20,47 +20,35 @@ When you delegate some stake to a staking pool, it can influence the chances of

.. dropdown:: |cryptox|

#. Tap the account you want to delegate from on the accounts screen.
#. Tap |cryptoX-earn| on the account balance screen.
#. In the dropdown list, select the account that you want to delegate from and tap **Earn**.

#. Tap **Continue to delegation setup**

.. image:: ../images/cryptoX/cryptoX-earning-rewards.png
.. image:: ../images/cryptoX/cryptoX-earning-rewards.png
:width: 50%
:alt: screen with earning options

#. You can now go through informational screens explaining the key concepts of delegation on the Concordium blockchain. Tap **Next** to navigate through the screens. Tap **Skip** to proceed directly to registering your delegation.
#. You can now go through informational screens explaining the key concepts of delegation on the Concordium blockchain, including the delegator role, delegation models, pay days, lock-in and cooldowns, and delegation updates. Tap **Next** to navigate through the screens. Tap **Skip** to proceed directly to registering your delegation.


#. On the **Register delegation** screen, you have two options: If you want to delegate to a specific pool, tap **Validator** and enter the Validator ID of the pool owner. If you want to register a passive delegation, tap **Passive**. Tap **Continue**.

.. image:: ../images/cryptoX/cryptoX-register-delegation.png
.. image:: ../images/cryptoX/cryptoX-register-delegation.png
:width: 50%
:alt: screen with earning options

#. You can see your balance available to delegate. Enter the Amount you want to delegate in the field. Tap **Yes, add** to restake any rewards, or tap **No, don't add** if you don’t want to restake rewards. In this case, rewards are deposited to your disposable balance at each pay day. Tap **Continue**.
#. You can see your balance available to delegate. Enter the amount you want to delegate in the field. Tap **Yes, add** to restake any rewards, or tap **No, don't add** if you don’t want to restake rewards. In this case, rewards are deposited to your disposable balance at each pay day. Then, tap **Continue**.

.. image:: ../images/cryptoX/cryptoX-register-delegation-add-rewards.png
.. image:: ../images/cryptoX/cryptox-register-delegation-add-rewards-new.png
:width: 50%
:alt: screen to register delegation amount and restake preference

#. Review the information in the transaction overview. When you are satisfied, tap **Submit delegation transaction**.

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

Once the transaction is finalized, the delegation is effective from the next pay day.

The account will be marked as Delegator in the account list.

.. image:: ../images/cryptoX/cryptoX-account-delegating.png
:width: 50%
:alt: account in list with delegating text and pie icon


You can see information about the delegation on the delegation status screen. Here, you can also make updates to your delegation or stop it.

.. image:: ../images/cryptoX/cryptoX-account-status-screen.png
:width: 50%
:alt: account details showing delegation details


.. dropdown:: Desktop Wallet
Expand Down
21 changes: 8 additions & 13 deletions source/mainnet/docs/guides/remove-delegation.rst
Original file line number Diff line number Diff line change
Expand Up @@ -20,25 +20,20 @@ If you remove the delegation, there is a :term:`cool-down period` before the amo

.. dropdown:: |cryptox|

#. Tap the account on the accounts screen.
#. In the dropdown list, select the account from which you want to remove delegation and tap **Earn**.

#. Tap |cryptoX-earn| on the account balance screen.
#. On the delegation status screen, tap **Stop delegation**.

#. Now you see your current delegation. Tap **Stop delegation**.
.. image:: ../images/cryptoX/cryptoX-delegation-status.png
:width: 50%
:alt: screen showing current delegation status with options to update or stop

.. image:: ../images/cryptoX/cryptoX-delegation-status.png
:width: 50%
:alt: screen showing current delegation status with options to update or stop

#. You can now go through informational screens explaining the implications of stopping your delegation. Tap **Next** to navigate through the screens. Tap **Skip** to proceed directly to stopping the delegation.
#. After the screen explaining the implications of stopping your delegation, tap **Continue** to proceed.

#. Review the information in the transaction overview. When you are satisfied, tap **Submit delegation transaction**.
#. Review the information in the transaction overview. When you are satisfied, tap **Submit delegation transaction**.

.. image:: ../images/cryptoX/cryptoX-stop-delegation.png
:width: 50%
:alt: screen shown to review delegation stop details

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


.. dropdown:: Desktop Wallet
Expand Down
22 changes: 10 additions & 12 deletions source/mainnet/docs/guides/update-delegation.rst
Original file line number Diff line number Diff line change
Expand Up @@ -26,12 +26,12 @@ 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
Updating delegation from a suspended 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
.. image:: ../images/browser-wallet/new/validator_suspended_banner.png
:width: 50%


Expand All @@ -42,27 +42,25 @@ Update delegation

.. dropdown:: |cryptox|

#. Tap the account on the accounts screen.
#. In the dropdown list, select the account from which you want to change your delegation preferences and tap **Earn**.

#. Tap |cryptoX-earn| on the account balance screen.
#. On the delegation status screen, tap **Update current delegation**.

#. Now you see your current delegation. Tap **Update current delegation**.

.. image:: ../images/cryptoX/cryptoX-delegation-status.png
.. image:: ../images/cryptoX/cryptoX-delegation-status.png
:width: 50%
:alt: screen showing current delegation with options to stop or update

#. You can now go through informational screens explaining the update options releated to delegation. Tap **Next** to navigate through the screens. Tap **Skip** to proceed directly to updating.
#. You can now go through informational screens explaining the update options for delegation. Tap **Next** to navigate through the screens. Tap **Skip** to proceed directly to updating.

#. If you want to delegate to a specific pool, tap **Validator** and enter the validator ID of the desired pool owner. If you want to delegate to passive delegation, tap **Passive**. Tap **Continue**.
#. If you want to delegate to a specific pool, select **Validator** and enter the validator ID of the desired pool owner. If you want to delegate to passive delegation, select **Passive**. Tap **Continue**.

.. image:: ../images/cryptoX/cryptoX-update-delegation.png
.. image:: ../images/cryptoX/cryptoX-update-delegation.png
:width: 50%
:alt: screen with options to choose delegation type

#. On the next screen you can see your balance available for delegation and the amount of your current delegation. If you want to change the amount, tap on the field **Optional: Type the new amount** and enter the amount. Tap **Yes, add** to restake any rewards or tap **No, don't add** if you don’t want to restake rewards. If you do not restake, rewards are deposited to your disposable balance. Tap **Continue**.
#. On the next screen you can see your balance available for delegation and the amount of your current delegation. If you want to change the amount, tap on the field **Optional: Type the new amount** and enter the amount. Tap **Yes, add** to restake any rewards or tap **No, don't add** if you don’t want to restake rewards. If you do not restake, rewards are deposited to your disposable balance at each payday. When satisfied with your settings, tap **Continue**.

.. image:: ../images/cryptoX/cryptoX-update-delegation-2.png
.. image:: ../images/cryptoX/cryptox-update-delegation2-new.png
:width: 50%
:alt: screen with options to choose delegation type

Expand Down
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file not shown.
Binary file not shown.
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
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.
27 changes: 9 additions & 18 deletions source/mainnet/docs/mobile-wallet/add-baker-mw.rst
Original file line number Diff line number Diff line change
Expand Up @@ -19,43 +19,43 @@ Prior to becoming a validator, read :ref:`Validator management<baker-pool>` to l

.. dropdown:: |cryptox|

#. Tap the account on the accounts screen and tap |cryptoX-earn| on the account balance screen.
#. In the dropdown list, select the account for which you will set up a validator an tap **Earn**.

#. Select **Continue to validator setup**.

.. image:: ../images/cryptoX/cryptoX-earning-rewards.png
.. image:: ../images/cryptoX/cryptoX-earning-rewards.png
:width: 50%
:alt: screen with earning options

#. You can now go through informational screens explaining the key concepts of validation on the Concordium blockchain. Tap **Next** to navigate through the screens. Tap **Skip** to proceed directly to registering your validation.
#. You can now go through informational screens explaining the key concepts of validation on the Concordium blockchain, including the validator role and key generation, node requirements, staking pool options, and suspension policies. Tap **Next** to navigate through the screens. Tap **Skip** to proceed directly to registering your validation.

#. On the register validator screen you can see your available balance. Enter the amount you want to stake in the field. Tap **Yes, add** to restake validator rewards, or tap **No, don't add** if you don’t want to restake rewards. In this case, rewards are deposited to your disposable balance at each pay day. Tap **Continue**.

.. image:: ../images/cryptoX/cryptoX-register-validator.png
.. image:: ../images/cryptoX/cryptox-register-validator_new.png
:alt: screen to register validator for first time showing balance, amount to stake, and restake parameters
:width: 50%

4. Choose whether you want to open a :term:`staking pool` or keep it closed. By opening a staking pool, others can delegate stake to your validator, thus increasing the chance that you are selected to produce a block and earn rewards. If you have a staking pool with delegators, the delegators also earn rewards when you produce blocks. Validators are also paid a commission by the delegators for producing blocks on their behalf. You can choose **Close for delegation** if you do not wish to run a staking pool. Tap **Continue**.

.. image:: ../images/cryptoX/cryptoX-register-validator-open-del.png
.. image:: ../images/cryptoX/cryptoX-register-validator-open-del.png
:alt: screen to register validator for first time showing options to open or close pool for delegation
:width: 50%

5. Set your commissions for your pool. This is the percentage you wish to earn from delegators to your pool when you have produced a block. Delegators can use this information when choosing a pool. Tap **Continue**.
5. Set commissions for your pool. This is the percentage you wish to earn from delegators to your pool when you have produced a block. Delegators can use this information when choosing a pool. Tap **Continue**.

.. image:: ../images/cryptoX/cryptoX-register-validator-commissions.png
.. image:: ../images/cryptoX/cryptox-register_validator_commissions_new.png
:alt: screen to register validator for first time showing commission rates for staking pools
:width: 50%

6. If you open a staking pool, you can optionally provide a URL with information about your validator. This allows delegators to learn more about your pool and make informed decisions. This information is not shared for closed pools or validators. Tap **Continue**.

.. image:: ../images/cryptoX/cryptoX-register-validator-metadata.png
.. image:: ../images/cryptoX/cryptoX-register-validator-metadata.png
:alt: screen to register validator for first time showing field to paste URL with metadata for staking pools
:width: 50%

6. Now, export the validator keys. You need the validator keys to start the node. Tap **Export validator keys** and navigate to the location on your device where you want to save the file. Give the file a name and the extension .json.

.. image:: ../images/cryptoX/cryptoX-register-validator-export-validator-keys.png
.. image:: ../images/cryptoX/cryptoX-register-validator-export-validator-keys.png
:alt: screen to register validator for first time showing all of the validator keys with option to export
:width: 50%

Expand All @@ -74,15 +74,6 @@ Prior to becoming a validator, read :ref:`Validator management<baker-pool>` to l
- :ref:`Docker<baking-docker>`
- :ref:`Ubuntu<baker-ubuntu>`

Once the transaction is finalized after importing your validator keys to the node, you see the status reflected in the account list and on the account balance screen.

.. image:: ../images/cryptoX/cryptoX-account-list-validator.png
:alt: account information in list showing validator badge
:width: 40%

.. image:: ../images/cryptoX/cryptoX-account-balance-screen-validator.png
:alt: account card showing staked amount with validator number
:width: 40%

.. dropdown:: Desktop wallet

Expand Down
23 changes: 18 additions & 5 deletions source/mainnet/docs/mobile-wallet/stop-validator.rst
Original file line number Diff line number Diff line change
Expand Up @@ -7,20 +7,33 @@ Stop a validator

If you remove a validator, the node that is configured with the :term:`validator keys<private keys>` will stop producing blocks after the next :term:`pay day`.

After the :term:`cool-down period`, the amount that you previously staked is returned to your disposable balance at the next pay day. When you've removed the validator,
it is recommended that you also remove the keys from the node, but you should only do this after the node has stopped producing blocks, i.e. after the payday.
After the :term:`cool-down period`, the amount that you previously staked is returned to your disposable balance at the next pay day.

If your pool has any delegators, they will be automatically moved to passive delegation, if they don't decide to do something else.



When you've removed the validator, it is recommended that you also remove the keys from the node, but you should only do this after the node has stopped producing blocks, i.e. after the payday.
If you want to use the node for validation at a later point in time, you'll then have to create a new set of validator keys.


If you no longer wish to produce blocks on this account, you can stop validation.

.. dropdown:: |cryptox|

#. Tap **Stop validation**.
#. In the dropdown list, select the account for which you want to stop validation and tap **Earn**.

#. On the Validator status screen, tap **Change validating status**.

.. image:: ../images/cryptoX/cryptox-change-validating-status.png
:width: 50%
:alt: screen showing validator status

#. You now see the options for changing the validating status. Tap **Stop validating**.

.. image:: ../images/cryptoX/cryptoX-stop-validation.png
.. image:: ../images/cryptoX/cryptox-change-validating-status-options.png
:width: 50%
:alt: screen showing all validator options
:alt: screen showing options for changing validating status

#. After the screens explaining validator removal, tap **Continue**.

Expand Down
Loading