Important: This documentation covers Yarn 1 (Classic).
For Yarn 2+ docs and migration guide, see yarnpkg.com.

Package detail

@sphereon/did-resolver-ebsi

Sphereon-Opensource2.2kApache-2.00.10.2-unstable.9TypeScript support: included

Sphereon did:ebsi resolver for Legal Entities.

Sphereon, did:key resolver, DID, KEY, EBSI, BLS, BBS+, ed25519, secp256r1, secp256r1, RSA

readme


Sphereon
Sphereon SSI SDK Crypto Extensions


BBS+, RSA, JWK, EBSI DID and key support

This mono repository, contains packages that add different crypto keys and signature suites as well as different DID methods to the SSI-SDK. The packages are also compatible with Veramo.

Key Management

DID methods Description
Key Manager The Key Manager orchestrates the various implementations of Key Management Systems, using a KeyStore to remember the link between a key reference, its metadata, and the respective key management system that provides the actual cryptographic capabilities. The methods of this plugin are used automatically by other plugins, such as DIDManager, CredentialPlugin, or DIDComm to perform their required cryptographic operations using the managed keys. You will need this version if you want to use BLS/BBS+ keys
Local Key Management System SSI-SDK and Veramo compatible Key Management System that stores keys in a local key store. It has support for RSA, BLS/BBS+ signatures, next to ed25519, es256k1, es256r1

DID Methods

The below packages can be used both in our SSI-SDK and Veramo. The below packages extend did:key and support did:jwk.

DID methods Description
DIF did:key resolver DIF DID resolver compatible did:key resolver with support for BLS/BBS+, JWK (EBSI natural persons), ed25519, es256k1, es256r1, es384r1, es521r1.
did:key provider SSI-SDK and Veramo compatible did:key provider, allows you to manage keys and DIDs with support for BLS/BBS+, JWK (EBSI natural persons), ed25519, es256k1, es256r1, es384r1, es521r1
DIF did:jwk resolver DIF DID resolver compatible did:jwk resolver with support for ed25519, es256k1, es256r1, RSA keys.
did:jwk provider SSI-SDK and Veramo compatible did:jwk provider, allows you to manage JWK keys and DIDs

Building and testing

Lerna

This package makes use of Lerna for managing multiple packages. Lerna is a tool that optimizes the workflow around managing multi-package repositories with git and npm / pnpm.

Build

The below command builds all packages for you

pnpm build

Test

The test command runs:

  • jest
  • coverage

You can also run only a single section of these tests, using for example pnpm test:watch.

pnpm test

Utility scripts

There are other utility scripts that help with development.

  • pnpm prettier - runs prettier to fix code style.

Publish

There are scripts that can publish the following versions:

  • latest
  • next
  • unstable
pnpm publish:[version]

changelog

Change Log

All notable changes to this project will be documented in this file. See Conventional Commits for commit guidelines.

0.10.1 (2023-03-10)

Note: Version bump only for package @sphereon/veramo-BBS-workspace

0.10.0 (2023-03-09)

Bug Fixes

  • Fix kms string used when importing keys, whilst we are already the KMS. Fix alias/kid handling for RSA keys (20ed263)
  • move to maintained isomorphic-webcrypto (feda9d1)
  • move to maintained isomorphic-webcrypto (53575be)
  • move to maintained isomorphic-webcrypto (4dbae0a)
  • move to maintained isomorphic-webcrypto (1d69dd8)
  • move to maintained isomorphic-webcrypto (d9e5a7e)
  • move to maintained isomorphic-webcrypto (df0bb7a)
  • move to maintained isomorphic-webcrypto (fb6b0d9)
  • move to maintained isomorphic-webcrypto (dc767a3)
  • move to maintained isomorphic-webcrypto (#2) (b392ca5)

Features

  • Add RSA support (881d794)
  • Add RSA support (6bbd283)
  • fix sigs (5c64585)
  • make sure signature is base64url and not base64urlpad (3b31a2f)
  • make sure signature is base64url and not base64urlpad (086d280)
  • make sure signature is base64url and not base64urlpad (aba391b)
  • make sure signature is base64url and not only base64 (6a7f915)
  • replace jsencrypt with isomorphic-webcrypto (4a7ca7a)

0.9.1 (2022-12-16)

Note: Version bump only for package @sphereon/veramo-BBS-workspace

0.8.0 (2022-09-03)