> For the complete documentation index, see [llms.txt](https://docs-launchpad.energyweb.org/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs-launchpad.energyweb.org/energy-solutions/digital-spine-by-energy-web/component-guides/ddhub-client-gateway/technical-guide/address-book.md).

# Address Book

## Overview

The Address Book provides a mechanism for mapping decentralized identifiers (DIDs) to human-readable alias names, enhancing usability and identification within the system.

***

## User Guide

### Pre-requisites

* Authorization to Client Gateway

### Add a DID to the Address Book

1. Navigate to `Address Book` page

<figure><img src="https://4257445316-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fnf3YeoQlQerc93GsC2Me%2Fuploads%2Fa2w5fOc5A0olv3oCMedh%2FScreenshot%202025-05-07%20at%2011.16.30%E2%80%AFAM.png?alt=media&amp;token=ddea95da-e956-4516-b656-75f0eff3a0b1" alt=""><figcaption><p>Address Book menu</p></figcaption></figure>

2. Click `Add`&#x20;

<figure><img src="https://4257445316-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fnf3YeoQlQerc93GsC2Me%2Fuploads%2FKQ4c1jrXeQww6Av41ews%2FScreenshot%202025-05-07%20at%2011.21.27%E2%80%AFAM.png?alt=media&amp;token=fc86fa9e-49a4-40e5-8e2f-2b839a312ab7" alt=""><figcaption><p>Add DID button</p></figcaption></figure>

3. Input `Alias` and `DID` in the form and click `Save`

<figure><img src="https://4257445316-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fnf3YeoQlQerc93GsC2Me%2Fuploads%2FE2dZTsamfik8wJnl3af5%2FScreenshot%202025-05-06%20at%2011.24.54%E2%80%AFAM.png?alt=media&amp;token=2c8f887b-21be-47bb-bfed-57a505736ac9" alt="" width="375"><figcaption><p>Add DID form</p></figcaption></figure>

4. Success message will be shown, click `Dismiss` to close modal and view the address book

<figure><img src="https://4257445316-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fnf3YeoQlQerc93GsC2Me%2Fuploads%2FHEdyuAeWpARmDcsYXaPg%2Fimage.png?alt=media&amp;token=330bf87f-16d0-4f62-8ec4-76685119c5bb" alt="" width="375"><figcaption><p>Successfully created contact</p></figcaption></figure>

### Modify a DID in the Address Book

1. Click on the `︙` button of the DID record that you wish to update, and choose `Update`&#x20;

<figure><img src="https://4257445316-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fnf3YeoQlQerc93GsC2Me%2Fuploads%2Fwuvqi4aFAVTyHgpGoPWK%2FScreenshot%202025-05-06%20at%2011.36.16%E2%80%AFAM.png?alt=media&amp;token=450a84f3-84ac-411c-8837-545c73d99753" alt=""><figcaption><p>Address book options</p></figcaption></figure>

<figure><img src="https://4257445316-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fnf3YeoQlQerc93GsC2Me%2Fuploads%2FN9ohti148IXibFuFASy2%2Fimage.png?alt=media&amp;token=f246a5af-9560-4c4d-98a9-99cb5af80e21" alt="" width="222"><figcaption><p>Update DID</p></figcaption></figure>

2. Modify `Alias` in the input field. Once done, click `Save`

<figure><img src="https://4257445316-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fnf3YeoQlQerc93GsC2Me%2Fuploads%2Fv86YcElGCk3PZjTFDR3E%2FScreenshot%202025-05-06%20at%2011.42.11%E2%80%AFAM.png?alt=media&amp;token=7be49379-2db0-48df-a763-dde9b8c7cdbb" alt="" width="375"><figcaption><p>Update DID form</p></figcaption></figure>

3. Success message will be shown, click `Dismiss` to close modal and view the address book

<figure><img src="https://4257445316-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fnf3YeoQlQerc93GsC2Me%2Fuploads%2FyiIizM45nYBb5Uvf55bI%2Fimage.png?alt=media&amp;token=1a885aae-62b1-4a36-a2e3-bb6d7604038d" alt="" width="375"><figcaption><p>Successfully updated contact</p></figcaption></figure>

### Remove a DID in the Address Book

1. Click on the `︙` button of the DID record that you wish to update, and choose `Remove`&#x20;

<figure><img src="https://4257445316-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fnf3YeoQlQerc93GsC2Me%2Fuploads%2Fb8LS4OaSA34YewuPFj84%2FScreenshot%202025-05-06%20at%2011.36.16%E2%80%AFAM.png?alt=media&amp;token=45030a64-1282-4eca-b2c7-2cc5ec0d91b3" alt=""><figcaption><p>Address book options</p></figcaption></figure>

<figure><img src="https://4257445316-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fnf3YeoQlQerc93GsC2Me%2Fuploads%2FLUzJDJhu6qcUXtnMoXlW%2FScreenshot%202025-05-06%20at%2011.39.35%E2%80%AFAM.png?alt=media&amp;token=6444316f-5d9d-4c01-848d-2234e84bb04c" alt="" width="268"><figcaption><p>Remove DID</p></figcaption></figure>

2. A confirmation modal will appear, click `Confirm` to remove the DID from address book or `Cancel`&#x20;

<figure><img src="https://4257445316-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fnf3YeoQlQerc93GsC2Me%2Fuploads%2FX5a8Xc0YtKYaBuar2Ekv%2Fimage.png?alt=media&amp;token=742297f5-445c-4eb1-a5df-06f2ddaa9458" alt="" width="375"><figcaption><p>Delete DID confirmation modal</p></figcaption></figure>

3. Success message will be shown, click `Dismiss` to close modal and view the address book

<figure><img src="https://4257445316-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fnf3YeoQlQerc93GsC2Me%2Fuploads%2F3pdnvvH6iK4T2HNeHdau%2Fimage.png?alt=media&amp;token=fceda314-3d27-4532-a67f-d7187dea4b8d" alt="" width="375"><figcaption><p>Successfully deleted contact</p></figcaption></figure>