Set up the Desktop Wallet#

The Concordium Desktop Wallet is a digital wallet that enables you to create and manage your Concordium identities, credentials, and accounts, and to create transactions such as sending CCD, adding a validator, and exporting and importing account information.

The Desktop Wallet also supports storing of your private keys on a hardware device. Currently, the LEDGER NANO S, LEDGER NANO S Plus, and LEDGER Nano X are supported.

This topic contains an overview of each task you need to complete to set up and start using the Desktop Wallet. The guide assumes that you’ll be using the Desktop Wallet in combination with a LEDGER device to generate and store keys and sign transactions.

Before you start#

Before you start, make sure you’ve completed the following steps:

  • You’ve set up the LEDGER Nano S, LEDGER Nano S Plus, or the LEDGER Nano X and you have saved your 24-word recovery phrase generated on the LEDGER securely. This is the only backup of your private keys, and you need it to access you accounts if you lose your LEDGER device.

  • You’ve downloaded Ledger Live.

Step 1: Set up the node

The Desktop Wallet must be connected to a running trusted node on the Concordium blockchain. The node enables the Desktop Wallet to interact with the Concordium blockchain to receive updates and submit transactions. A default Virtual Hive node (concordiumwalletnode.com) is provided. But you can run a node yourself using Windows, macOS, and with Docker or a Debian package on Linux. You can also have a third-party provider run a node for you.

Step 2: Install the Desktop Wallet
  1. Download the latest version of the Desktop Wallet for Mainnet or Testnet.

  2. Open the Desktop Wallet and create a password that contains at least 6 characters. Keep the password safe. You’ll need it to sign into the Desktop Wallet again.

  3. If this is the first time you’re opening the Desktop Wallet, you’re asked to connect to a node. If you don’t see this message, go to Settings, and then select Node settings. The Virtual Hive node (concordiumwalletnode.com) is inserted by default, but you can change this to any other node that you prefer or the node provided by your third-party provider. Enter the Address and Port of the node you’re running. The address is the network address of the node.

  • If you’re running the mainnet version of the Desktop Wallet, you must connect to a mainnet node. In the Address field, enter 127.0.0.1, and in the Port field enter 20000.

  • If you’re running the testnet version of the Desktop Wallet, you must connect to a testnet node. In the Address field, enter 127.0.0.1, and in the Port field enter 20001.

    ../../_images/Node-setup-win-9.png
  1. Select Set connection. If the connection is working properly, there’s a message saying Successfully connected.

Step 3: Install the Concordium LEDGER app using LEDGER Live

The Desktop Wallet requires that you store your keys on a LEDGER device. This is to ensure that your private account keys are kept secure. To be able to use the LEDGER device with the Desktop Wallet, you must install the Concordium LEDGER App on the hardware wallet.

  1. Open LEDGER Live and click Settings gear wheel on black background. Select Experimental features and turn on Developer mode.

  2. Connect the LEDGER device to your computer, and enter your PIN code to unlock the LEDGER.

  3. In the LEDGER Live app select My Ledger in the left side panel.

  4. The LEDGER says Allow Ledger Manager. Press both buttons simultaneously to allow the manager on your LEDGER.

  5. Press the right button to navigate to Install app, and then press both buttons.

  6. Search for Concordium Ledger App in the App catalog in Ledger Live, and then select Install.

Note

The LEDGER app can also be updated from LEDGER Live.

Step 4: Set up an identity and an initial account

Once you’ve installed the Desktop Wallet, you must set up an identity and an initial account. If you want to be a validator, Concordium also recommends that you create a separate account to use as a validator account. See Create an identity and an initial account in the Desktop Wallet and Create an account in the Desktop Wallet.

Once you have completed these four steps, you’re ready to start using the Desktop Wallet.

Note

Without CCD you can’t submit transactions on the Concordium blockchain. This includes creating multi-signature accounts and creating validator transactions. However, you can create identities, accounts that only require one signature, and you can add account addresses to your address book.

You can buy CCD on many exchanges. If you are running on testnet, you can request CCD for testing using a button in the wallet.

Warning

Currently, it is not possible to exchange identities and accounts between the Concordium Legacy Wallet or Concordium Wallet for Mobile and the Desktop Wallet. If you try to import a file that has been exported from the Concordium Legacy Wallet into the Desktop Wallet, the import will fail, and likewise, if you try to import a file exported from the Desktop Wallet into the Concordium Legacy Wallet.