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 adding more credentials to 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.

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. Select Continue.

    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 Continue. Alternatively, you can drag and drop the file from its location on the computer and onto the Desktop Wallet. We recommend that you double check the identicon to make sure you are adding the right person’s credentials to the account.

  4. Set an expiry date and time for your proposal. You must submit proposals to the chain within the last 2 hours up to the expiry date. This means 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, but you do need an internet connection.

Option 2: Generate and sign the transaction This option requires a Ledger 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 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

  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 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. 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 says Concordium is ready. Wait for the message in the Desktop Wallet saying Ledger Nano S is ready.

  5. The Ledger says Review Transaction. Navigate to the right, till you see Sender and then an 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 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 says Sig 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.

    • RegIdCred (must match of the credentials you added to the proposal)

    • Identity Provider

    • Revocation threshold

  8. Verify that the following information is correct, and then press both buttons.

    • Valid to date

    • Created at date

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

  10. The Ledger says Threshold again. This is the new threshold you’ve proposed for the account. Navigate to the right. The Ledger says Review transaction. When the Ledger says Sign transaction, press both buttons to confirm 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.

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.

Support & Feedback

If you have questions or feedback, join us on Discourse, or contact us at support@concordium.software.