> 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="/files/2Ts0yWJduk1cdhlD8MJF" alt=""><figcaption><p>Address Book menu</p></figcaption></figure>

2. Click `Add`&#x20;

<figure><img src="/files/ZItNVAoR7vl6dSivyTvr" alt=""><figcaption><p>Add DID button</p></figcaption></figure>

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

<figure><img src="/files/tgYJcRGJWhQKBlPmfpSN" 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="/files/S5PJrdldkH2yL0DRvdYY" 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="/files/fC7pkdHPMUdp1FSAGh6B" alt=""><figcaption><p>Address book options</p></figcaption></figure>

<figure><img src="/files/npievWlZDdld51q34q2O" alt="" width="222"><figcaption><p>Update DID</p></figcaption></figure>

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

<figure><img src="/files/rbsa2XHWlu6mN7i6QVEs" 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="/files/PraEWBYyRkDSKoSIn9jR" 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="/files/AcvLM4Rp70LM0EmDiQSe" alt=""><figcaption><p>Address book options</p></figcaption></figure>

<figure><img src="/files/1A0lzY5pCRteoE5X7j8m" 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="/files/icMr2lWPeY4W31NadVKw" 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="/files/E8WRkl1Ka93qGefT2psM" alt="" width="375"><figcaption><p>Successfully deleted contact</p></figcaption></figure>