> For the complete documentation index, see [llms.txt](https://docs.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.energyweb.org/legacy-documentation/ew-dos-technology-components-2023/identity-and-access-management-iam/iam-libraries.md).

# IAM Libraries

## Identity Access and Management (IAM) Client Library

A [TypeScript](https://www.typescriptlang.org/) library that provides high-level functions related to the identity and access management (IAM) for all users, assets, organizations and applications that are anchored on the Energy Web Chain. This includes:

* Management of [Switchboard](broken://pages/-Mdw3Vke0uRCbFguK6gD#switchboard) namespaces
* [DID](/legacy-documentation/foundational-concepts/self-sovereign-identity-introduction.md#decentralized-identifiers-dids)/[DID Document](/legacy-documentation/foundational-concepts/self-sovereign-identity-introduction.md#did-documents) management
* Creation and governance of organizations, applications and their associated roles. Once created, these are persisted on the [IAM Cache Server](#identity-access-and-management-iam-cache-server)
* Claim requests, verification and issuance for role permissioning. Once created, claims are persisted on the [IAM Cache Server](#identity-access-and-management-iam-cache-server)
* [Staking ](/legacy-documentation/community-resources/using-the-energy-web-chain/staking.md#staking-overview)functionality

### Documentation Resources

* [GitHub Repository](https://github.com/energywebfoundation/iam-client-lib)
* [ReadTheDocs](https://energy-web-foundation-iam-client-lib.readthedocs-hosted.com/)
* [API](https://energy-web-foundation-iam-client-lib.readthedocs-hosted.com/api/globals/)

### Dependencies and Dependents

| EW-DOS Dependencies                                                         | EW-DOS Dependents                                              |
| --------------------------------------------------------------------------- | -------------------------------------------------------------- |
| [DID Library](#did-library)                                                 | [Decentralized Service Bus](#decentralized-service-bus)        |
| [SSI Hub](#identity-access-and-management-iam-cache-server)                 | [Switchboard](broken://pages/-Mdw3Vke0uRCbFguK6gD#switchboard) |
| [IAM Smart Contracts](https://github.com/energywebfoundation/iam-contracts) |                                                                |

## DID Library

A class-based [TypeScript ](https://www.typescriptlang.org/)library that provides an abstraction layer to manage and interact with [DIDs ](/legacy-documentation/foundational-concepts/self-sovereign-identity-introduction.md#decentralized-identities-dids)and [Verifiable Credentials](/legacy-documentation/foundational-concepts/self-sovereign-identity-introduction.md#verifiable-credentials-vcs) on the [Energy Web Chain](/legacy-documentation/ew-dos-technology-components-2023/trust-layer-energy-web-chain.md#blockchain-consensus).

The DID Library enables users to adopt and/or implement different [DID methods](https://www.w3.org/TR/did-core/#dfn-did-methods), which promotes interoperability with other methods of decentralized identifiers. The DID library currently implements the [ERC1056 standard](https://eips.ethereum.org/EIPS/eip-1056) for creating and updating identities on the blockchain.

The DID library interacts with the Energy Web Chain using the [ethers.js library](https://docs.ethers.io/v5/).

### Documentation Resources

* [GitHub repository](https://github.com/energywebfoundation/iam-client-lib) (includes documentation)

### Dependencies and Dependents

| EW-DOS Dependencies                                                                                         | EW-DOS Dependents                                                                                                        |
| ----------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------ |
| [Energy Web Chain](/legacy-documentation/ew-dos-technology-components-2023/trust-layer-energy-web-chain.md) | [IAM client librar](#identity-access-and-management-cache-server)[y](#identity-access-and-management-iam-client-library) |

#### See an overview of all Identity and Access Management (IAM) components in EW-DOS [here](/legacy-documentation/foundational-concepts/self-sovereign-identity-introduction.md#ew-dos-identity-and-access-management-stack)

### Other Resources

* ["EW’s DID Library is open-source" on](https://medium.com/energy-web-insights/ewfs-did-library-is-open-source-1f355c95503e) [Medium](https://medium.com/energy-web-insights/ewfs-did-library-is-open-source-1f355c95503e)
* ["ERC1056 ❤ ERC780 — an open identity and claims protocol for Ethereum" on ](https://medium.com/uport/erc1056-erc780-an-open-identity-and-claims-protocol-for-ethereum-aef7207bc744)[Medium](https://medium.com/uport/erc1056-erc780-an-open-identity-and-claims-protocol-for-ethereum-aef7207bc744)
* [Ethereum Improvement Proposals](https://eips.ethereum.org/EIPS/eip-1056):[ EIP-1056: Ethereum Lightweight Identity](https://eips.ethereum.org/EIPS/eip-1056)

## Passport-DID-Auth

A backend class-based [TypeScript](https://www.typescriptlang.org/) library that allows other JavaScript/TypeScript applications to easily add authentication and authorization based on [Switchboard](broken://pages/-Mdw3Vke0uRCbFguK6gD#switchboard) roles to their applications. This allows any application to use Switchboard's decentralized approach to identity and access management.

### Documentation Resources

* [GitHub repository](https://github.com/energywebfoundation/passport-did-auth)

### Dependencies and Dependents

<table><thead><tr><th width="696">EW-DOS Dependencies</th><th>EW-DOS Dependents</th></tr></thead><tbody><tr><td><a href="#did-library">DID Library</a></td><td><a href="#identity-access-and-management-cache-server">IAM client librar</a><a href="#identity-access-and-management-iam-client-library">y</a></td></tr><tr><td><a href="#identity-access-and-management-iam-cache-server">SSI Hub</a></td><td></td></tr></tbody></table>

### Other Resources

* You can refer to the [Identity and Access Management (IAM) Client Examples ](https://github.com/energywebfoundation/iam-client-examples)application to see an example of Passport-DID-Auth integration into an application

## EW Credentials Library

A multi-package library for CRUD operations specific to Energy Web Verifiable Credentials. The repository is a module-based library built with [Lerna](https://github.com/lerna/lerna).

<table><thead><tr><th width="398">Package</th><th>Description</th></tr></thead><tbody><tr><td><a href="https://github.com/energywebfoundation/ew-credentials/blob/develop/packages/vc-verification"><code>@energyweb/vc-verification</code></a></td><td>Code to verify role based verifiable credential.</td></tr><tr><td><a href="https://github.com/energywebfoundation/ew-credentials/blob/develop/packages/credential-governance"><code>@energyweb/credential-governance</code></a></td><td>Smart contract and client code specific to EnergyWeb IAM roles.</td></tr><tr><td><a href="https://github.com/energywebfoundation/ew-credentials/blob/develop/packages/onchain-claims"><code>@energyweb/onchain-claims</code></a></td><td>exposes code to support role/claim lifecycle.</td></tr></tbody></table>


---

# 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 dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.energyweb.org/legacy-documentation/ew-dos-technology-components-2023/identity-and-access-management-iam/iam-libraries.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.