EBSI DID Resolver

This library supports the proposed did:ebsi method from EBSI. This DID method is meant to be used by Legal Entities only. For Natural Persons, the did:key method must be used.

In order to resolve DID documents, the EBSI DID resolver requires the did-resolver library, which is the primary interface for resolving DIDs.

Table of Contents

1. Installation
2. Resolving a DID document
3. Creating a DID
4. Axios config defaults
5. License

Installation

npm install @europeum-ebsi/ebsi-did-resolver

Resolving a DID document

The library provides a resolver that is meant to be used through the did-resolver aggregator.

import { Resolver } from "did-resolver";
import { getResolver } from "@europeum-ebsi/ebsi-did-resolver";

// You must set the address of the DID Registry to be used in order to resolve Legal Entities DID documents
const resolverConfig = {
  registry: "https://api-pilot.ebsi.eu/did-registry/v5/identifiers",
};

// getResolver will return an object with a key/value pair of { "ebsi": resolver } where resolver is a function used by the generic DID resolver.
const ebsiResolver = getResolver(resolverConfig);
const didResolver = new Resolver(ebsiResolver);

didResolver
  .resolve("did:ebsi:zub5ZZUfHLLptCduwEy8xRj")
  .then((doc) => console.log);

// You can also use ES7 async/await syntax
const doc = await didResolver.resolve("did:ebsi:zub5ZZUfHLLptCduwEy8xRj");

The library supports the versionTime DID query parameter, which allows you to get the DID document at the given time:

const doc = await didResolver.resolve(
  "did:ebsi:zub5ZZUfHLLptCduwEy8xRj?versionTime=2021-05-10T17:00:00Z",
);

Creating a DID

The library exposes a method allowing you to create a DID from the given subject identifier bytes:

import { util } from "@europeum-ebsi/ebsi-did-resolver";
import { randomBytes } from "node:crypto";

const subjectIdentifierBytes = randomBytes(16); // An array of 16 random bytes
const did = util.createDid(subjectIdentifierBytes);
// Example: "did:ebsi:ztRBFfMCY7VAGHH1Ba8Q5o9"

Axios config defaults

The library uses the global axios instance to make HTTP requests. If needed, you can specify config defaults. More information on axios configuration can be found here.

For instance, if you want to override the default HTTPS agent with a custom agent using https-proxy-agent, you can do it like so:

import axios from "axios";
import { HttpsProxyAgent } from "https-proxy-agent";

axios.defaults.httpsAgent = new HttpsProxyAgent("http://168.63.76.32:3128");

License

Copyright (C) 2026 European Union

This program is free software: you can redistribute it and/or modify it under the terms of the EUROPEAN UNION PUBLIC LICENCE v. 1.2 as published by the European Union.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the EUROPEAN UNION PUBLIC LICENCE v. 1.2 for further details.

You should have received a copy of the EUROPEAN UNION PUBLIC LICENCE v. 1.2. along with this program. If not, see https://joinup.ec.europa.eu/collection/eupl/eupl-text-eupl-12.