> For the complete documentation index, see [llms.txt](https://guardian.hedera.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://guardian.hedera.com/docs/3.7.0/security-identity-and-privacy/bring-your-own-dids/bring-your-own-byo-dids-ui.md).

# Bring your own (BYO) DIDs Reference

1. [Step By Step Process](#id-1.-step-by-step-process)
2. [Demo Video](#id-2.-demo-video)

## 1. Step By Step Process

## 1. New Standard Registry Registration

### **1.1 Hedera Account**

<figure><img src="https://content.gitbook.com/content/p049ONtJzdmiKq7Lsv1e/blobs/xrLsKvUo8tSbQtLTzgNp/image%20(30)%20(3).png" alt=""><figcaption></figcaption></figure>

Enter Hedera network account with non-0 hbar balance to be used by the system for the Hedera transactions associated with the new Standard Registry user’s DID.

### 1.2 DID Document

#### 1.2.1 Default DID

<figure><img src="https://content.gitbook.com/content/p049ONtJzdmiKq7Lsv1e/blobs/PUWcvALTKCLBsWimQUdC/image%20(2)%20(1)%20(1)%20(1)%20(1)%20(1)%20(1)%20(1)%20(1)%20(1)%20(1)%20(1)%20(1)%20(1)%20(1)%20(1)%20(1)%20(1)%20(1)%20(2).png" alt=""><figcaption></figcaption></figure>

When the ‘Generate new DID document’ option is selected, clicking on the Next button would result in Guardian generating a new dedicated DID to be used exclusively in Guardian based on the Hedera account ID entered at the previous step. Such DID would have the following format:

```
“did:hedera:{network}:{identifier}_{topicId}”
```

```
Example:

"did:hedera:testnet:DZv8hKg4nsdS7qSAtUdmBgvcq5iiZ6E1aCWZvqJzNNbV_0.0.2666979"

```

#### 1.2.2 Externally-controlled (custom) DID

<figure><img src="https://content.gitbook.com/content/p049ONtJzdmiKq7Lsv1e/blobs/mFUWAD3qsNJnActoW4Wx/image%20(3)%20(1)%20(1)%20(1)%20(1)%20(1)%20(1)%20(1)%20(1)%20(1)%20(1)%20(1)%20(1)%20(1)%20(1)%20(1)%20(2)%20(1)%20(1).png" alt=""><figcaption></figcaption></figure>

<figure><img src="https://content.gitbook.com/content/p049ONtJzdmiKq7Lsv1e/blobs/QbSpxlrJLRAW7lxKyENQ/image.png" alt=""><figcaption></figcaption></figure>

Selecting ‘Custom DID document’ option enables the dialogue text window where the externally-generated/controlled DID document can be pasted from the clip-board. The document must contain Ed25519VerificationKey2018 and Bls12381G2Key2020 verification methods to be usable by Guardian.

### 1.3 Keys

<figure><img src="https://content.gitbook.com/content/p049ONtJzdmiKq7Lsv1e/blobs/71cobxMRGeYDWcyx0MJa/image%20(6)%20(1)%20(1)%20(1)%20(1)%20(1)%20(1)%20(1)%20(1)%20(1)%20(1)%20(1)%20(1)%20(1)%20(1)%20(1)%20(1)%20(1)%20(1)%20(1).png" alt=""><figcaption></figcaption></figure>

For BYO DID of Standard Registries, in the cases where there are multiple verification methods Standard Registry users are required to specify which one of them is to be used in Guardian, and pass the corresponding private key into Guardian to be used for signatures.

### 1.4 VC Document

<figure><img src="https://content.gitbook.com/content/p049ONtJzdmiKq7Lsv1e/blobs/DYLALE3XBzvX5lRFq7ri/image.png" alt=""><figcaption></figcaption></figure>

Final step of the registration presents a form, based on the corresponding system schema, for the user to fill out.

## 2. New User registration

### 2.1. Select the Standard Registry to be associated with

<figure><img src="https://content.gitbook.com/content/p049ONtJzdmiKq7Lsv1e/blobs/kOE4uoEvVtygcnzgb0Rf/image%20(8)%20(1)%20(1)%20(1)%20(1)%20(1)%20(1)%20(1)%20(1)%20(2).png" alt=""><figcaption></figcaption></figure>

### 2.2 User Hedera Account

<figure><img src="https://content.gitbook.com/content/p049ONtJzdmiKq7Lsv1e/blobs/jTcM3EXAmG8mAwDOmlXl/image%20(11)%20(1)%20(1)%20(1)%20(1)%20(1)%20(1)%20(1)%20(1)%20(2).png" alt=""><figcaption></figcaption></figure>

Specify the existing Hedera account with non-0 hbar balance to be used for submitting transactions associated with this user’s DID.

### 2.3 DID Document

#### 2.3.1 Default DID

<figure><img src="https://content.gitbook.com/content/p049ONtJzdmiKq7Lsv1e/blobs/zPbutwG31CGzJidssUKD/image.png" alt=""><figcaption></figcaption></figure>

For more details please refer to Section [1.2.1](#id-1.2.1-default-did).

#### 2.3.2 Custom DID

<figure><img src="https://content.gitbook.com/content/p049ONtJzdmiKq7Lsv1e/blobs/R1KxTXkEGsWnTw5CQTne/image.png" alt=""><figcaption></figcaption></figure>

For more details, please refer to Section [1.2.2](#id-1.2.2-externally-controlled-custom-did)

### 2.4 Keys

<figure><img src="https://content.gitbook.com/content/p049ONtJzdmiKq7Lsv1e/blobs/btuVVQRHY2nyfuKQh2pY/image.png" alt=""><figcaption></figcaption></figure>

For more details, please refer to section [1.3](#id-1.3-keys)

## 2. Demo Video

[YouTube](https://youtu.be/VVwHSu4LJ_w?si=warN7AxOVopv85G4\&t=117)


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://guardian.hedera.com/docs/3.7.0/security-identity-and-privacy/bring-your-own-dids/bring-your-own-byo-dids-ui.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
