JavaScriptKotlinSwift

Create a DID

Decentralized Identifiers (DIDs) are how you are identified on the decentralized web. This guide covers how to use Web5 to create a DID.

You can create a DID using any of the Web5-supported DID methods by using the DID package.

Install

JavaScript

Kotlin

Swift

npm install @web5/dids@1.0.0

Import

JavaScript

Kotlin

Swift

Create DID

When creating a DID with the Web5 SDK, what's returned is a BearerDid. A BearerDid is a composite type that combines a DID with a KeyManager containing keys associated to the DID. Together, these two components form a BearerDid that can be used to sign and verify data.

The following DID methods are supported:

did:dht

JavaScript

Kotlin

Swift

Important: Weekly Republishing Required for did:dht DIDs

Temporarily DIDs created using the did:dht method must be republished weekly to prevent them from becoming unresolvable. An automatic republishing feature will be integrated into the SDK in the coming weeks.

did:jwk

JavaScript

Kotlin

Swift

Example of DID properties

Here are examples of what's returned when creating a DID with Web5:

DID

The ID of a DID Document is the DID as a string:

did:dht:cm1yqfjzfdtauh33nauwf3sqsijqziwrydicr8dbtho3cucb9nno

Portable DID

As shown above, @web5/dids provides methods to create a DID. A Portable DID is returned, which is a DID and its associated data which can be exported and used in different contexts and apps. You should securely store your Portable DID in a trustworthy identity wallet or password manager.

important

In the example below, the d property of the private key component is masked. That's because this is the critical, sensitive part that must be kept secret. It allows the holder to perform private key operations, like signing data. Do not share your private key!

{
  "did": "did:dht:cm1yqfjzfdtauh33nauwf3sqsijqziwrydicr8dbtho3cucb9nno",
  "document": {
    "id": "did:dht:cm1yqfjzfdtauh33nauwf3sqsijqziwrydicr8dbtho3cucb9nno",
    "verificationMethod": [
      {
        "id": "did:dht:cm1yqfjzfdtauh33nauwf3sqsijqziwrydicr8dbtho3cucb9nno#0",
        "type": "JsonWebKey2020",
        "controller": "did:dht:cm1yqfjzfdtauh33nauwf3sqsijqziwrydicr8dbtho3cucb9nno",
        "publicKeyJwk": {
          "alg": "EdDSA",
          "crv": "Ed25519",
          "kty": "OKP",
          "ext": "true",
          "key_ops": ["verify"],
          "x": "YuQHFTco44nzORYnQubOtVLr1oQA6sIcYY8hlk2B-IU",
          "kid": "0"
        }
      }
    ],
    "authentication": ["#0"],
    "assertionMethod": ["#0"],
    "capabilityInvocation": ["#0"],
    "capabilityDelegation": ["#0"]
  },
  "keySet": {
    "verificationMethodKeys": [
      {
        "privateKeyJwk": {
          "d": "*************",
          "alg": "EdDSA",
          "crv": "Ed25519",
          "kty": "OKP",
          "ext": "true",
          "key_ops": ["sign"],
          "x": "YuQHFTco44nzORYnQubOtVLr1oQA6sIcYY8hlk2B-IU",
          "kid": "0"
        },
        "publicKeyJwk": {
          "alg": "EdDSA",
          "crv": "Ed25519",
          "kty": "OKP",
          "ext": "true",
          "key_ops": ["verify"],
          "x": "YuQHFTco44nzORYnQubOtVLr1oQA6sIcYY8hlk2B-IU",
          "kid": "0"
        },
        "relationships": [
          "authentication",
          "assertionMethod",
          "capabilityInvocation",
          "capabilityDelegation"
        ]
      }
    ]
  }
}

DID Document

The DID Document is a self-contained representation of the DID and provides metadata and cryptographic material associated with the DID

{
  "id": "did:dht:cm1yqfjzfdtauh33nauwf3sqsijqziwrydicr8dbtho3cucb9nno",
  "verificationMethod": [
    {
      "id": "did:dht:cm1yqfjzfdtauh33nauwf3sqsijqziwrydicr8dbtho3cucb9nno#0",
      "type": "JsonWebKey2020",
      "controller": "did:dht:cm1yqfjzfdtauh33nauwf3sqsijqziwrydicr8dbtho3cucb9nno",
      "publicKeyJwk": {
        "alg": "EdDSA",
        "crv": "Ed25519",
        "kty": "OKP",
        "ext": "true",
        "key_ops": ["verify"],
        "x": "YuQHFTco44nzORYnQubOtVLr1oQA6sIcYY8hlk2B-IU",
        "kid": "0"
      }
    }
  ],
  "authentication": ["#0"],
  "assertionMethod": ["#0"],
  "capabilityInvocation": ["#0"],
  "capabilityDelegation": ["#0"]
}

Cryptographic Keys

A DID has an associated set of keys that can be used for verification and authentication. The keyset contains a DID subject's public and private keys (for signing, recovery, and updates).

important

In the example below, the d property of the private key component is masked. That's because this is the critical, sensitive part that must be kept secret. It allows the holder to perform private key operations, like signing data. Do not share your private key!

{
  "verificationMethodKeys": [
    {
      "privateKeyJwk": {
        "d": "*************",
        "alg": "EdDSA",
        "crv": "Ed25519",
        "kty": "OKP",
        "ext": "true",
        "key_ops": ["sign"],
        "x": "YuQHFTco44nzORYnQubOtVLr1oQA6sIcYY8hlk2B-IU",
        "kid": "0"
      },
      "publicKeyJwk": {
        "alg": "EdDSA",
        "crv": "Ed25519",
        "kty": "OKP",
        "ext": "true",
        "key_ops": ["verify"],
        "x": "YuQHFTco44nzORYnQubOtVLr1oQA6sIcYY8hlk2B-IU",
        "kid": "0"
      },
      "relationships": [
        "authentication",
        "assertionMethod",
        "capabilityInvocation",
        "capabilityDelegation"
      ]
    }
  ]
}