Add credentials to an account

Add more credentials on an account

This guide describes how you add more credentials to an account, and how you change the signature threshold for transactions on the account. For more information about the process of sharing an account, see Overview of shared accounts with multiple credentials.

Prerequisites

• Create the account that’s going to hold more credentials and share the account address with the users whose credentials, you’re going to add to the account.

• Receive and save one or more files with the credentials that you want to associate with the account. For more information, see Create a file with credentials.

Shared accounts with multiple credentials in Desktop Wallet explains the steps involved to set up a multiple signature (shared) account.

Select an identity and an account

1. Go to the Multi Signature Transactions tab, select Make new proposal, and then select Update account credentials.

2. Select the account whose credentials you want to update. When you look at the Transaction Details in the left pane, you can see the current signature threshold and the current number of credentials associated with the account.

   If you only want to update the threshold, you can skip the next steps and go to Change the signature Threshold.

3. To add the new credentials, select Browse to file in the right pane and then navigate to the location on your computer where you saved the file with the credentials. Select the file and select Open. Alternatively, you can drag and drop the file from its location on the computer and onto the Desktop Wallet. Verify that the key and the identicon match those of the new custodian. Optionally, you can specify who owns the key.

4. Select Add Credential to proposal, and then select Continue.

5. Set an expiry date and time for your proposal. You must set the expiry time so that it’s possible for any co-signers to return their signatures in time.

Change the signature threshold

You can either keep the current signature threshold as is or change it.

• Enter the new signature threshold where it says New Signature threshold or keep the existing threshold, and then select Continue.

Generate the transaction

There are two ways that you can generate the transaction:

Option 1: Generate the transaction without signing. This option enables you to export the transaction proposal without signing it. You don’t need a LEDGER device, but you do need an internet connection.

Option 2: Generate and sign the transaction This option requires a LEDGER device but no internet connection.

In combination, these two options enable organizations to distribute the responsibility of creating and signing transfers among more people. It makes it possible to have one employee create the proposals and another one sign the proposals. It also makes it possible to sign the transaction on the LEDGER device in a different location than were the proposal was created.

Option 1: Generate the transaction without signing

1. Verify that the Transaction details are as you 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 transaction proposal.

Option 2: Generate and sign the transaction on the LEDGER device

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 and sign.

3. Connect the LEDGER device to the computer if you haven’t done so already. There’s a message saying Waiting for device. Please connect your Ledger.

4. Enter your PIN code on the LEDGER device. Press the buttons above the up and down arrows to choose a digit, and then press both buttons to select the digit. 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 Waiting for the user to finish the process on device.

5. The LEDGER device says Review transaction. Navigate to the right to view Sender and the sender address. This is the address of the account whose credentials you’re updating.

6. Continue navigating to the right. When you see Continue with transaction press both buttons. The LEDGER device says Public-key, which is the public key of the first of the credentials you are adding to the account. Navigate to the right until you’ve reached the last section of the public key and press both buttons.

7. The LEDGER device says Signature threshold which is the number of signatures that’s currently required to make transactions with the account. Navigate to the right and verify that the following information is correct, and then press both buttons.

   • AR threshold: this is the number of identity disclosure authorities required to disclose an identity on the account.

   • Cred. sig. threshold: this is the number of signatures required to sign transactions on the account.

8. Press both buttons to sign the transaction.

9. Repeat the above steps on the LEDGER device for each of the credentials you’ve added to the proposal.

10. The LEDGER device says Threshold again. This is the new threshold you’ve proposed for the account. Navigate to the right. The LEDGER device says Review transaction. When the LEDGER device says Sign transaction, press both buttons to confirm the transaction. The LEDGER device says Concordium is ready.

Note

If you want to decline the transaction, press the right button on the LEDGER device. 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.

Export the transaction proposal

If you already have more than one credential on the account, it means that more than one signature is needed to sign the proposal. You must therefore share a file of the type JSON with the co-signers. In the Signatures pane, you can see how many signatures are required before you can submit the transaction to the blockchain. When you have the necessary number of signatures, you can generate and sign the transaction.

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 Save as type is set to All Files. Give the file a name and the extension .json, and then click Save.

3. Send a copy of the file through a secure channel to the co-signers that must sign the transaction. Likewise, send a copy of the identicon through a secure channel that is different from the one used to send the file.

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 left the page with the account transaction, go to Multi-signature Transactions, and then select Your proposed transactions. If you’re still on the same proposal page, you can go straight to step 3.

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 on to 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 proposal. 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.

Warning

Transactions on the blockchain are permanent. That is, they are irreversible and can’t be deleted. Therefore, carefully review that all the transaction details are correct before submitting.