.. and press ENTER to ask a question on web5, how to write code and more.

Skip to main content

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.1

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"
]
}
]
}

Connect with us on Discord

Submit feedback: Open a GitHub issue

Edit this page: GitHub Repo

Contribute: Contributing Guide