Update delegation to a baker pool or passive delegation#

You can change the delegation amount, target, and preferences on an account. You do not have to change all selections. For example, you might only want to change if rewards are restaked or not.

If you increase the delegation, the new amount will be applied at the start of the next pay day. There is one pay day every 24 hours. However, if you decrease the delegation, there is a cool-down period before the new stake is applied. During this period, you cannot stop delegation or change the amount, but you can change other delegation settings. After the cool-down period, the amount you’ve decreased the delegation by is returned to your disposable balance.

Before delegating stake to a baker pool, it is important to research the pool using CCDScan. 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.

Note

All transfers and transactions cost a fee, including staking and unstaking transactions. The fee is based on the set NRG for that transaction and the current exchange rate. The cost of transaction fees is stable in Euros, and therefore the price in CCD varies depending on the CCD to EUR exchange rate. The fee will always be deducted from the Balance of the account, so it is important to have some available CCDs to cover fees. A locked-for-staking balance cannot be used to pay for these transactions. You can see the fee in the transaction log.

Warning

Make sure you have enough funds in your disposable balance to cover transaction fees.

Desktop Wallet
Single signature account
  1. Go to Accounts and select the account on which you want to change your delegation preferences.

  2. Click More options then select Delegation and choose Update Delegation.

    ../../_images/dw-delegation-menu.png
  3. You can enter the baker ID of a different baker pool to delegate to or select passive if you prefer that. Click Continue.

    ../../_images/dw-update-delegation-target.png
  4. You can enter a new amount that you want to delegate and choose whether rewards should be redelegated or not. Click Continue.

    ../../_images/dw-update-delegation-stake.png
  5. A message says Waiting for device. Please connect your Ledger. Connect the Ledger device to the computer and enter your PIN on the Ledger device.

  6. Press the right button to navigate to the Concordium app, and then press both buttons to open the app. The Ledger says Concordium is ready. Wait for the message Ledger Nano S is ready or Ledger Nano S Plus is ready in the Desktop Wallet and select Submit.

  7. On the Ledger device, a message says Review transaction. Verify changes you made to any parameters; only changed parameters are shown. Navigate to the right to verify each parameter change.

  8. The Ledger device says Sign transaction. Press both buttons to sign the transaction. The Ledger device says Concordium is ready.

  9. In the Desktop Wallet, you can see that the transaction has been submitted to the chain. Select Finish.

Multi signature account
  1. Go to Multi Signature Transactions, select Make new proposal, and then select Update Delegation.

  2. Select the account on which you want to change your delegation preferences.

  3. You can enter the baker ID of a different baker pool to delegate to or select passive if you prefer that. Click Continue. Then you enter a new amount that you want to delegate and choose whether rewards should be redelegated or not. Click Continue.

  4. Set an expiry date and time for your proposal. Consider when you set the expiry time so that the co-signers can return their signatures in time. Select Continue. You can now generate the transaction.

Generate the transaction

There are two ways that you can generate the transaction:

  • Generate the transaction without signing. This option enables you to export the transaction proposal without signing it. You don’t need a Ledger but you do need an internet connection.

  • Generate and sign the transaction This option requires a Ledger and an internet connection.

In combination, these two options enable you to distribute the responsibility of creating and signing transfers among more people. You can, for example, have one person create the proposal and another one sign the proposal. It also makes it possible for you to sign the transaction on the Ledger in a different location than where the proposal was created.

Generate the transaction without signing

  1. Verify that the Transaction details are as you intended, and then select I am sure that the proposed changes are correct.

  2. Select Generate without signing. You can now export the proposal.

Generate and sign the transaction on the Ledger

  1. If you haven’t connected the Ledger, there’s a message in the Desktop Wallet saying Waiting for connection until you connect the Ledger. Enter your PIN code on the Ledger. Press the buttons above the up and down arrows to choose a digit, and then press both buttons to select the digit.

  2. Wait for the message in the Desktop Wallet saying Open the Concordium application on your Ledger Nano S or Open the Concordium application on your Ledger Nano S Plus. On the Ledger, press the right button to navigate to the Concordium app, and then press both buttons to open the app. The Ledger says Concordium is ready. Wait for the message in the Desktop Wallet saying Ledger is ready.

  3. In the Desktop Wallet, Verify that the Transaction details are as you intended, select I am sure that the proposed changes are correct, and then select Generate and Sign.

  4. On the Ledger, there’s a message saying Review transaction. Verify changes you made to any parameters; only changed parameters are shown. Navigate to the right to verify each parameter change.

  5. The Ledger says Sign transaction. Press both buttons to sign the transaction. The Ledger says Concordium is ready.

Note

If you want to decline the transaction, press the right button on the Ledger. The hardware wallet now says Decline to sign transaction. Press both buttons to decline. In the Desktop Wallet, there’s a message saying The action was declined on the Ledger device. Please try again.

In the Desktop Wallet, you can now see Transaction details, Signatures, and Security & Submission Details, which include the status of the transaction, the identicon, and the transaction hash. If you have all the required signatures, you can submit the transaction to the chain, otherwise, you’ll have to export the proposal and receive signatures from the co-signers.

Export proposal

If more than one signature is needed to sign off on the proposal, you have to share a file of the type JSON, which contains the transaction information, with the co-signers.

  1. In the Desktop Wallet, select Export transaction proposal.

  2. Navigate to the location on your computer where you want to save the file. If you’re on Windows make sure that All Files is selected in Save as type. Give the file a name and the extension .json, and then click Save.

  3. You have to export the transaction proposal and send it to the co-signer through a secure channel. Optionally, you can also send the Identicon to the co-signers through a different secure channel.

Receive signatures from co-signers

When the co-signers have signed the transaction, they return the signed transaction proposal to you, and you have to import the files into the Desktop Wallet before you can submit the transaction to the chain.

  1. If you’re still on the same page, go to step 3. If you left the page with the account transaction, go to Multi-signature Transactions, and then select Your proposed transactions.

  2. Select the transaction that you want to submit to the chain. You can see an overview of the transaction details and an overview of the signatures. You can also see that the status of the transaction is Unsubmitted, and you can see the identicon and the transaction hash.

  3. Select Browse to file and then navigate to the location on your computer where you saved the signed transaction files. Select the relevant files, and then select OK. The files are uploaded to the Desktop Wallet and added to the list of signatures. Alternatively, you can drag and drop the signature files from their location on the computer and onto the Desktop Wallet.

Submit the transaction to the blockchain

When you have received and added all the required signatures, you can submit the transaction to the blockchain.

  1. Review the transaction details carefully to ensure that all information is correct.

  2. Select I understand this is the final submission and that it cannot be reverted.

    If you don’t want to submit the transaction to the chain, you can select Cancel. The proposal is no longer active. However, it is still visible in the list of proposals.

  3. Select Submit transaction to chain. The transaction is submitted to the chain and finalized on the Ledger.

  4. Select Finish to leave the page.

Concordium Wallet for Android
  1. Tap Hand receiving money on the account with a delegation in the Accounts page, or tap on an account card and tap Hand receiving money with text earn on the account details screen.

  2. You see your current delegation. Tap Update current delegation.

    ../../_images/delegation-status-mw.jpg
  3. If you want to delegate to a specific pool tap Baker pool and enter the Baker ID of the pool owner you want to switch the delegation to. If you want to delegate to passive delegation, tap Passive delegation. Tap Continue.

    ../../_images/update-delegation-target-mw.jpg
  4. 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. And tap Yes, restake to restake any rewards or tap No, don’t restake if you don’t want to restake rewards. If you do not restake, rewards are deposited to your disposable balance. Tap Continue.

    ../../_images/update-delegation-amt-mw.jpg
  5. Review the information in the transaction overview. When you are satisfied, tap Submit delegation transaction.

    ../../_images/update-delegation-conf-mw.jpg
  6. Once the transaction is submitted you see a confirmation screen. Tap Finish to complete the action.

Concordium Legacy Wallet
  1. Go to the Accounts screen.

  2. Tap on the balance area of the account for which you want to update delegation or tap More Button with More and double-headed arrow.

  3. In the hamburger menu Three horizontal lines tap Delegation.

    ../../_images/account-hamburger-menu.png
  4. You see your current delegation. Tap Update current delegation.

    ../../_images/delegation-status-mw.jpg
  5. If you want to delegate to a specific pool tap Baker pool and enter the Baker ID of the pool owner you want to switch the delegation to. If you want to delegate to passive delegation, tap Passive delegation. Tap Continue.

    ../../_images/update-delegation-target-mw.jpg
  6. 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. And tap Yes, restake to restake any rewards or tap No, don’t restake if you don’t want to restake rewards. If you do not restake, rewards are deposited to your disposable balance. Tap Continue.

    ../../_images/update-delegation-amt-mw.jpg
  7. Review the information in the transaction overview. When you are satisfied, tap Submit delegation transaction.

    ../../_images/update-delegation-conf-mw.jpg
  8. Once the transaction is submitted you see a confirmation screen. Tap Finish to complete the action.

Concordium Wallet for Web

At the moment, delegation is not available in the Concordium Wallet for Web.

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

Note

Reducing your stake in any pool results in a longer cool-down period. The delegation amount will be locked during this period and no changes can be made to the amount. The reduction in stake is not effective until the first pay day after the cool-down period ends. During the cool-down period the staked amount continues earning rewards.