Managing Identity Keys

Follow these instructions to:

1. Generate identity keys on-the-fly WITH a draft DIDDoc

2. Generate standalone identity public/private keypairs

3. Convert identity key pairs generated using Veramo agent to other key encoding formats

⚠️ Before you begin...

Make sure you've correctly for Veramo CLI

Method 1: Generating identity keys on-the-fly with DIDDocs

Instead of creating identity keys standalone, you can generate them along with a DIDDoc template. This makes it far easier to handle different inputs and arguments, such as generating DID Docs with different key types.

Command (inline)

You can use the following command in your CLI to create your DIDDoc and associated identity keys:

Command (pass as file)

You can pass the payload of the inputs and arguments as a file rather than inline using:

You can reuse this example file:

Inputs and arguments

Within this command, you are able to choose from the following inputs below to produce different types of DIDDocs:

Expected output

Once you have submitted the command above, you should receive a DID Document draft template, including a set of identity keys, including your chosen inputs and arguments. You can find an example of this output below:

Unexpected output

After running the above command, if you see an unexpected error, follow our to fix it. A common error is:

Method 2: Standalone key creation

You can generate identity keys standalone in a plug-and-play format for future use in or transactions.

Command

Converting identity keys

If you want to use identity keys outside of Veramo CLI, you can convert keys from one format to another.

For example, if you would like to convert from hex to base64, you can use the following generic approach:

This works with other encoding conversion libraries (i.e. multiformats).