Company identity creation#

A company identity is for companies that need an identity and accounts on the Concordium blockchain, but don’t want that identity to belong to a specific person. Company identities are therefore issued with documents that identify the company and not an individual. Company identities are only relevant for a few companies, such as crypto exchanges.

You can’t use the Desktop Wallet, Concordium Wallet for Android, or Concordium Legacy Wallet to create a company identity. You need to use a set of command-line tools, and you need to communicate directly with the identity provider (currently Notabene). This page describes Notabene’s process, including recovery of company identities.

The information below describes how to create a company identity. Note that the process differs for testnet and mainnet.

Mainnet
  1. Download the tools for your platform.

    • Tools for Linux
      • SHA256 checksum of the download: fd3620f3f3e2e9540b262ae68b8273c59816fbaa12d495629b07555c65bab4a2

    • Tools for Windows
      • SHA256 checksum of the download: 38433e51efa95121ee4e25a15552dd02905193e3de5d3976e4b067bd9cb46096

    • Tools for MacOS
      • SHA256 checksum of the download: 6f457a05dc2f3345b48fd7d9d387e80b46d37ceaa6ebeadd759b6de4e634a4ca

  2. Extract the files in the bundle to the same location on your computer. The bundle contains the following files:

    • user_cli (tool)

    • cryptographic-parameters.json

    • ars.json

    • ip-info.json (public keys of the identity provider Notabene)

  3. Download concordium-client for your platform. See Downloads to get the file and checksum.

  4. To generate a request for an identity object, follow the generate request instructions. Email the request.json output file to ania@notabene.id. Store the auxiliary output securely.

  5. To verify your identity towards Notabene, follow the entity verification instructions. When the identity has been verified successfully, Notabene will notify you by email, and they will send you an identity object file named id-object.json.

  6. To create additional accounts from the identity object returned by Notabene, follow the create accounts instructions. You must deploy the credential.json output file to the chain exactly as described. If you don’t, the account will not be created. You need access to a node to complete this step. Store the auxiliary output securely.

  7. To recover your identity object (e.g. if you lost it), follow the recovery of identity instructions. Email the recovery-request.json output file to ania@notabene.id. When the recovery request has been validated successfully, Notabene will notify you by email, and they will return the identity object named id-object.json that you lost. With the recovered identity object, you can then recreate your account keys, if needed.

If you experience issues with steps 1, 2, 3, 4, 6 or 7, please contact Concordium’s technical support via support@concordium.software. If you experience issues with step 5, identity verification, please contact Notabene via ania@notabene.id.

Testnet
  1. Download the tools for your platform.

    • Tools for Linux
      • SHA256 checksum of the download: fd3620f3f3e2e9540b262ae68b8273c59816fbaa12d495629b07555c65bab4a2

    • Tools for Windows
      • SHA256 checksum of the download: 38433e51efa95121ee4e25a15552dd02905193e3de5d3976e4b067bd9cb46096

    • Tools for MacOS
      • SHA256 checksum of the download: 6f457a05dc2f3345b48fd7d9d387e80b46d37ceaa6ebeadd759b6de4e634a4ca

  2. Download the testnet-specific configuration files.

  3. Extract the files in the bundle to the same location on your computer. The bundle contains the following files:

    • cryptographic-parameters-testnet.json

    • ars-testnet.json

    • ip-info-testnet.json (public keys of the identity provider)

  4. Download concordium-client for your platform. See Downloads to get the file and checksum.

  5. To generate a request for an identity object, follow the generate request instructions. Email the request.json output file to support@concordium.software with the subject line “Test company identity”. Store the auxiliary output securely.

  6. When the identity has been verified successfully, Concordium will notify you by email, and they will send you an identity object file named id-object.json.

  7. To create accounts from the identity object returned by Concordium, follow the create accounts instructions. You must deploy the credential.json output file to the chain exactly as described. If you don’t, the account will not be created. You need access to a node to complete this step. Store the auxiliary output securely.

  8. To recover your identity object (e.g. if you lost it), follow the recovery of identity instructions. Email the recovery-request.json output file to support@concordium.software with the subject line “Recover company identity”.

  9. When the recovery request has been validated successfully, Concordium will notify you by email, and they will return the identity object named id-object.json that you lost. With the recovered identity object, you can then recreate your account keys, if needed.

Once you have created accounts, you can request CCDs for testing. To request CCDs for testing, run the following command:

curl -X PUT https://wallet-proxy.testnet.concordium.com/v0/testnetGTUDrop/3GXM6cEuAwEA47EEtFpax9PLhMWchWmkaPmNZmW1kbDaWaKBxV where you replace 3GXM6cEuAwEA47EEtFpax9PLhMWchWmkaPmNZmW1kbDaWaKBxV with the account address that should receive the CCDs.

If you experience issues, please contact Concordium’s technical support via support@concordium.software.