https://github.com/digitalbazaar/jsonld-document-loader
https://github.com/digitalbazaar/jsonld-document-loader
Last synced: about 1 year ago
JSON representation
- Host: GitHub
- URL: https://github.com/digitalbazaar/jsonld-document-loader
- Owner: digitalbazaar
- License: bsd-3-clause
- Created: 2019-10-17T21:56:31.000Z (over 6 years ago)
- Default Branch: main
- Last Pushed: 2025-01-30T22:30:09.000Z (over 1 year ago)
- Last Synced: 2025-04-19T11:08:40.305Z (about 1 year ago)
- Language: JavaScript
- Size: 40 KB
- Stars: 6
- Watchers: 11
- Forks: 0
- Open Issues: 3
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE
Awesome Lists containing this project
README
# JSON-LD Document Loader _(jsonld-document-loader)_
[](https://github.com/digitalbazaar/jsonld-document-loader/actions/workflows/main.yml)
[](https://npm.im/jsonld-document-loader)
> A document loader API for jsonld.js.
## Table of Contents
- [Background](#background)
- [Security](#security)
- [Install](#install)
- [Usage](#usage)
- [Contribute](#contribute)
- [Commercial Support](#commercial-support)
- [License](#license)
## Background
TBD
## Security
TBD
## Install
- Node.js >= 18 is required.
### NPM
To install via NPM:
```sh
npm install --save jsonld-document-loader
```
### Development
To install locally (for development):
```sh
git clone https://github.com/digitalbazaar/jsonld-document-loader.git
cd jsonld-document-loader
npm install
```
## Usage
```js
import {JsonLdDocumentLoader} from 'jsonld-document-loader';
const loader = new JsonLdDocumentLoader();
```
### `addStatic(url, document)`
The `addStatic()` method allows developers to load fixed static contexts and
documents, to ensure known versions and contents, without going out to the
network. The context is cloned when added.
For example, to add support for the DID Core context, the VC context, and crypto
suite specific contexts:
```js
import cred from 'credentials-context';
import didContext from 'did-context';
import ed25519Ctx from 'ed25519-signature-2020-context';
const {contexts: credentialsContexts, constants: {CREDENTIALS_CONTEXT_V1_URL}} =
cred;
const jdl = new JsonLdDocumentLoader();
jdl.addStatic(ed25519Ctx.CONTEXT_URL, ed25519Ctx.CONTEXT);
jdl.addStatic(
didContext.constants.DID_CONTEXT_URL,
didContext.contexts.get(didContext.constants.DID_CONTEXT_URL)
);
jdl.addStatic(
CREDENTIALS_CONTEXT_V1_URL,
credentialsContexts.get(CREDENTIALS_CONTEXT_V1_URL)
);
const documentLoader = jdl.build();
// Pass to jsonld, jsonld-signatures, vc-js and similar libraries
```
### `addDocuments({documents})`
Uses `addStatic()` to add many documents from an iterable object that returns
values of the form `[url, document]`. Can be used directly with a Map
associating URLs to documents.
```js
import {contexts as credContexts} from '@digitalbazaar/credentials-context';
const jdl = new JsonLdDocumentLoader();
jdl.addDocuments({documents: credContexts});
```
### `setDidResolver()`
To add support for resolving DIDs and DID-related key ids:
```js
import * as didKey from '@digitalbazaar/did-method-key';
import {CachedResolver} from '@digitalbazaar/did-io';
const cachedResolver = new CachedResolver();
const jdl = new JsonLdDocumentLoader();
cachedResolver.use(didKey.driver());
jdl.setDidResolver(cachedResolver);
// Now you can resolve did:key type DIDs and key objects
const verificationKeyId = 'did:key:z6MkuBLrjSGt1PPADAvuv6rmvj4FfSAfffJotC6K8ZEorYmv#z6MkuBLrjSGt1PPADAvuv6rmvj4FfSAfffJotC6K8ZEorYmv';
await jdl.documentLoader(verificationKeyId);
// ->
{
documentUrl: 'did:key:z6MkuBLrjSGt1PPADAvuv6rmvj4FfSAfffJotC6K8ZEorYmv#z6MkuBLrjSGt1PPADAvuv6rmvj4FfSAfffJotC6K8ZEorYmv',
document: {
"@context": "https://w3id.org/security/suites/ed25519-2020/v1",
"type": "Ed25519VerificationKey2020",
"controller": "did:key:z6MkuBLrjSGt1PPADAvuv6rmvj4FfSAfffJotC6K8ZEorYmv",
"publicKeyMultibase": "zFj5p9C2Sfqth6g6DEXtw5dWFqrtpFn4TCBBPJHGnwKzY",
// ...
}
}
```
### `setProtocolHandler()`
You can add support for loading `https`-based JSON-LD contexts (a common
case) by using your own loader or the one that comes with the
[jsonld](https://www.npmjs.com/package/jsonld) package:
```js
import * as jsonld from 'jsonld';
jdl.setProtocolHandler({protocol: 'https', handler: jsonld.documentLoader});
```
You can also add support for a custom protocol handler:
```js
const customHandler = {
get({url}) {
// return document
}
}
jdl.setProtocolHandler({protocol: 'ipfs', handler: customHandler});
```
## Contribute
See [the contribute file](https://github.com/digitalbazaar/bedrock/blob/master/CONTRIBUTING.md)!
PRs accepted.
If editing the Readme, please conform to the
[standard-readme](https://github.com/RichardLitt/standard-readme) specification.
## Commercial Support
Commercial support for this library is available upon request from
Digital Bazaar: support@digitalbazaar.com
## License
[New BSD License (3-clause)](LICENSE) © Digital Bazaar