Shield and unshield CCD on an account#

Accounts on the Concordium blockchain have two balances, the Balance and the shielded balance. You can move funds between these two balances using either a shield CCD transaction or an unshield CCD transaction.

When you shield an amount on an account, only the account’s credential holder can see the shielded amounts. Other participants in the network will be able to see the shielding transaction, but can’t see the shielded balance or any shielded transfers going in or out of the account. You can’t make shielded transfers on multi-signature accounts, only on accounts with a single credential.

If you have an account with CCD in the shielded balance, you can’t add new credentials to that account. Furthermore, once a shielded transfer has been logged on an account, you’ll no longer be able to add more credentials to that account. This is also the case even if you unshield all CCD in the shielded balance.

Warning

Do not shield all of your funds or you will not have enough funds to cover transaction fees for unshielding or sending them.

Note

The amount contained in the Balance is publicly visible, while the amount on the Shielded balance is encrypted and is only visible for the account holder. Moving funds between the balances is also publicly visible, including the amount. Only shielded transfers between two different accounts have their amounts encrypted.

Note

All transfers and transactions cost a fee, including shielding and unshielding 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. You can see the fee in the transaction log.

Note

On Testnet you can request CCDs for testing purposes. Use the button in either Desktop Wallet, Concordium Wallet for Android, or Concordium Legacy Wallet to request 2000 CCDs.

Desktop Wallet
Shield CCD
  1. Go to Accounts and select the relevant account.

  2. Select Shield.

    ../../_images/dw-shield.png
  3. Enter the amount of CCD that you want to shield. If the amount you want to transfer including the transfer fee exceeds the amount in your account, you’ll see a message saying Insufficient funds. This means that there’s not enough CCD in the account and you’ll have to change the amount. Also, the amount must be greater than zero. Select Continue.

    ../../_images/dw-shield-ccd.png
  4. There’s a message saying Waiting for device. Please connect your Ledger. Connect the LEDGER device to the computer and enter your PIN on LEDGER device.

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

  6. Press both buttons on the LEDGER device to confirm the decryption.

  7. Review the transaction on the LEDGER device and verify that the information matches the Transaction details in the Desktop Wallet. Navigate to the right and verify the sender address is correct. Continue navigating to the right and verify that the amount and the recipient address are correct.

  8. Press both buttons to sign the transaction. In the Desktop Wallet, you can see that the transfer has been submitted to the chain. Select Finish. When the transaction has been finalized, you can see the shielded balance on the account overview.

Unshield CCD

The steps to unshield CCD are similar to the ones to shield CCD.

  1. Select Shielded Balance on the relevant account, and then select Unshield.

    ../../_images/dw-unshield.png
  2. Enter the amount of CCD that you want to unshield, and then select Continue.

    ../../_images/dw-unshield-ccd.png
  3. There’s a message saying Waiting for device. Please connect your Ledger. Connect the LEDGER device to the computer and enter your PIN on LEDGER device.

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

  5. Press both buttons on the LEDGER device to confirm the decryption.

  6. Review the transaction on the LEDGER device and verify that the information matches the Transaction details in the Desktop Wallet. Navigate to the right and verify the sender address is correct. Continue navigating to the right and verify that the amount and the recipient address are correct.

  7. Press both buttons to sign the transaction. In the Desktop Wallet, you can see that the transfer has been submitted to the chain. Select Finish. When the transaction has been finalized, you can see the shielded balance on the account overview.

When the transaction has been finalized, you can see that the shielded balance has changed, and you can see the the amount you unshielded in the Transfers list.

Concordium Wallet for Android
Shield CCD
  1. Go to the Accounts page.

  2. Tap the Balance area of the account you want to transfer CCD from or tap Button with double-headed arrow.

    • If the Shield button and Shielded balanace tab are not visible, tap gear wheel on blue background then select Show shielded balance.

  3. Now the totals area contains tabs for both Balance and Shielded Balance and, Shield shield on blue background and Unshield dissolving shield on blue background buttons.

    ../../_images/shield.png
  4. Tap shield on blue background. Remember to leave enough funds in your disposable balance to cover transaction fees to unshield or for other transactions.

  5. Enter the amount you want to move to the shielded balance.

    ../../_images/MW33.png
  6. Confirm your choices and tap Shield amount.

    ../../_images/MW35.png
  7. Your shielding transaction has now been submitted to the blockchain. Tap Finish.

    ../../_images/MW76.png

The transaction might take a little while to finalize on the blockchain, and you can follow the status in the transaction log. Once it has been finalized, you can browse to your shielded balance to see the newly shielded amount.

Note

You can hide the shielded balance when finished to prevent accidental shielding. In the Account transaction overview tap gear wheel on blue background and tap Hide shielded balance. This removes the shielded balance tab and the Shield button from the accounts view. Note that the shielded balance still exists on the account; it is just not shown in the interface.

Unshield CCD
  1. Go to the Accounts page.

  2. Tap the account you want to unshield CCD on or tap Button with double-headed arrow on the account card.

  3. If the Shielded balance is already shown, tap the Shielded balance tab.

    • If the Unshield button and Shielded balance tab are not visible, tap gear wheel on blue background then select Show shielded balance.

  4. Now the totals area contains tabs for both Balance and Shielded Balance and an Unhield button.

  5. Tap dissolving shield on blue background.

  6. Enter the amount you want to move to the regular balance.

    ../../_images/MW48.png
  7. Tap Unshield amount.

    ../../_images/MW49.png
  8. Confirm your choices and tap Unshield amount.

    ../../_images/MW50.png
  9. Your shielding transaction has now been submitted to the blockchain. Tap Finish.

    ../../_images/MW51.png

The transaction might take a little while to finalize on the blockchain, and you can follow the status in the transaction log. Once it has been finalized, you can browse to your shielded balance to see the newly shielded amount.

Note

You can hide the shielded balance when finished to prevent accidental shielding. In the Account transaction overview tap gear wheel on blue background and tap Hide shielded balance. This removes the shielded balance tab and the Shield button from the accounts view. Note that the shielded balance still exists on the account; it is just not shown in the interface.

Concordium Legacy Wallet
Shield CCD
  1. Go to the Accounts page.

  2. Tap the Balance area of the account you want to shield CCD from or tap Button with More and double-headed arrow.

    • If the Shield button and Shielded balanace tab are not visible, tap the Three horizontal lines menu in the upper right corner. Tap Show shielded balance on account name.

  3. Now the totals area contains tabs for both Balance and Shielded Balance and a Shield button.

    ../../_images/MW77.png
  4. Tap Shield. Remember to leave enough funds in your disposable balance to cover transaction fees to unshield or for other transactions.

  5. Enter the amount you want to move to the shielded balance.

    ../../_images/MW33.png
  6. Confirm your choices and tap Shield amount.

    ../../_images/MW35.png
  7. Your shielding transaction has now been submitted to the blockchain. Tap Finish.

    ../../_images/MW76.png

The transaction might take a little while to finalize on the blockchain, and you can follow the status in the transaction log. Once it has been finalized, you can browse to your shielded balance to see the newly shielded amount.

Note

You can hide the shielded balance when finished to prevent accidental shielding. In the Account transaction overview tap the Three horizontal lines menu and tap Hide shielded balance for account name. This removes the shielded balance tab and the Shield button from the accounts view. Note that the shielded balance still exists on the account, it is just not shown in the interface.

Unshield CCD
  1. Go to the Accounts page.

  2. Tap the account you want to unshield CCD on or tap Button with More and double-headed arrow on the account card.

  3. If the Shielded balance is already shown, tap the Shielded balance tab.

    • If the Unshield button and Shielded balance tab are not visible, tap the Three horizontal lines menu in the upper right corner. Tap Show shielded balance on account name.

  4. Now the totals area contains tabs for both Balance and Shielded Balance and an Unhield button.

  5. Tap UNSHIELD.

    ../../_images/MW47.png
  6. Enter the amount you want to move to the regular balance.

    ../../_images/MW48.png
  7. Tap Unshield amount.

    ../../_images/MW49.png
  8. Confirm your choices and tap Unshield amount.

    ../../_images/MW50.png
  9. Your shielding transaction has now been submitted to the blockchain. Tap Finish.

    ../../_images/MW51.png

The transaction might take a little while to finalize on the blockchain, and you can follow the status in the transaction log. Once it has been finalized, you can browse to your shielded balance to see the newly shielded amount.

Note

You can hide the shielded balance when finished to prevent accidental shielding. In the Account transaction overview tap the Three horizontal lines menu and tap Hide shielded balance for account name. This removes the shielded balance tab and the Shield button from the accounts view. Note that the shielded balance still exists on the account, it is just not shown in the interface.