Huge News!Announcing our $40M Series B led by Abstract Ventures.Learn More
Socket
Sign inDemoInstall
Socket

did-ipid

Package Overview
Dependencies
Maintainers
18
Versions
7
Alerts
File Explorer

Advanced tools

Socket logo

Install Socket

Detect and block malicious and high-risk dependencies

Install

did-ipid

The IPID DID method implementation in JavaScript

  • 0.4.1
  • latest
  • Source
  • npm
  • Socket score

Version published
Maintainers
18
Created
Source

did-ipid

NPM version Downloads Build Status Coverage Status Dependency status Dev Dependency status

The IPID DID method implementation in JavaScript.

Installation

$ npm install did-ipid

This library is written in modern JavaScript and is published in both CommonJS and ES module transpiled variants. If you target older browsers please make sure to transpile accordingly.

Usage

import createIpid, { getDid } from 'did-ipid';

const did = await getDid(pem);
//=> Returns the DID associated to a private key in PEM format.

const ipid = await createIpid(ipfs);

const didDocument = await ipid.resolve('did:ipid:QmUTE4cxTxihntPEFqTprgbqyyS9YRaRcC8FXp6PACEjFG');
//=> Resolves a DID and returns the respective DID Document.

const didDocument = await ipid.create(pem, (document) => {
    const publicKey = document.addPublicKey({
    	type: 'RsaVerificationKey2018',
        publicKeyHex: '02b97c30de767f084ce3080168ee293053ba33b235d7116a3263d29f1450936b71',
    });

    const authentication = document.addAuthentication(publicKey.id);

    const service = document.addService({
    	id: 'hub',
    	type: 'HubService',
    	serviceEndpoint: 'https://hub.example.com/',
    });
});
//=> Creates a new DID and the corresponding DID Document based on the provided private key pem.
//=> The DID Document is published with the added publicKey, authentication and service.

const didDocument = await ipid.update(pem, (document) => {
    document.removeService('hub');

    document.addService({
    	id: 'messages',
    	type: 'MessagingService',
    	serviceEndpoint: 'https://example.com/messages/8377464',
    });
});
//=> Updates a DID Document based on the DID associated to the provided private key pem.
//=> The DID Document is published without the `hub` service and with a new one called `messages`. 

API

getDid(pem)

Returns the DID associated to a private key in PEM format.

pem

Type: string

A private key in PEM format.

Supported formats: pkcs1-pem or pkcs8-pem.

Example:

-----BEGIN RSA PRIVATE KEY-----
MIICXQIBAAKBgQDCQZyRCPMcBPL2J2SuI2TduR7sy28wmcRzfj8fXQTbj1zJURku
...
-----END RSA PRIVATE KEY-----

IPID

An IPFS node is required to create an IPID instance. Please be sure to check js-ipfs, the JavaScript implementation of the IPFS protocol, to learn how to create one.

There is currently only one option available during the creation of an IPID instance. The lifetime option defines the duration of the DID document availability.

Example:

import createIpid from 'did-ipid';

const ipid = await createIpid(ipfs, { lifetime: '24h' });

Notes:

  • Please make sure that the IPFS node is ready to use.
  • This package uses the Key Management provided by IPFS. So during the creation of the node a password must be defined, as an option, to encrypt/decrypt your keys.
resolve(did)

Resolves a DID and provides the respective DID Document.

Returns a Promise that resolves to the DID Document.

did

Type: string

The DID to resolve.

Example:

did:ipid:QmUTE4cxTxihntPEFqTprgbqyyS9YRaRcC8FXp6PACEjFG
create(privateKeyPem, operations)

Creates a new DID and respective DID Document by applying all the specified operations.

Returns a Promise that resolves to the DID Document.

privateKeyPem

Type: string

A private key in PEM format.

Example:

-----BEGIN RSA PRIVATE KEY-----
MIICXQIBAAKBgQDCQZyRCPMcBPL2J2SuI2TduR7sy28wmcRzfj8fXQTbj1zJURku
...
-----END RSA PRIVATE KEY-----
operations

Type: Function

A function that receives a Document instance that provides methods to modify its content.

update(privateKeyPem, operations)

Updates an existing DID Document by applying all the specified operations.

Returns a Promise that resolves to the DID Document.

privateKeyPem

Type: string

A private key in PEM format.

Example:

-----BEGIN RSA PRIVATE KEY-----
MIICXQIBAAKBgQDCQZyRCPMcBPL2J2SuI2TduR7sy28wmcRzfj8fXQTbj1zJURku
...
-----END RSA PRIVATE KEY-----
operations

Type: Function

A function that receives a Document instance that provides methods to modify its content.

Document

getContent()

Returns the current state of the documents content.

addPublicKey(publicKey, [options])

Adds a new Public Key to the document.

Returns the added public key.

publicKey

Type: Object

An object with all the Public Key required properties as defined in the DID Public Keys spec.

  • id should be provided without a prefixed did.
  • If no id is provided, one will be generated.
  • If no controller is provided, it is assumed that it is its own DID.
options

Type: Object

Options to be used while adding a public key.

idPrefix

Type: string

A prefix to be added to the public key id.

revokePublicKey(id)

Revokes a Public Key from the document.

Also revokes an authentication that references this public key.

id

Type: string

The id of the public key.

addAuthentication(authentication)

Adds a new Authentication to the document.

Returns the added authentication.

authentication

Type: string

The id of the public key that is being referenced.

removeAuthentication(id)

Revokes an Authentication from the document.

id

Type: string

The id authentication.

addService(service, [options])

Adds a new Service Endpoint to the document.

Returns the added service.

service

Type: Object

An object with all the Service Endpoint required properties as defined in the DID Service Endpoints spec.

  • id should be provided without a prefixed did.
  • If no id is provided, one will be generated.
options

Type: Object

Options to be used while adding a service.

idPrefix

Type: string

A prefix to be added to the service id.

removeService(id)

Revokes a Service Endpoint from the document.

id

Type: string

The id of the service endpoint.

Tests

$ npm test
$ npm test -- --watch # during development

License

Released under the MIT License.

Keywords

FAQs

Package last updated on 17 Jun 2019

Did you know?

Socket

Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.

Install

Related posts

SocketSocket SOC 2 Logo

Product

  • Package Alerts
  • Integrations
  • Docs
  • Pricing
  • FAQ
  • Roadmap
  • Changelog

Packages

npm

Stay in touch

Get open source security insights delivered straight into your inbox.


  • Terms
  • Privacy
  • Security

Made with ⚡️ by Socket Inc