theseyi / dwn-sdk-js

Decentralized Web Node (DWN)

Geek Repo:Geek Repo

Github PK Tool:Github PK Tool

Decentralized Web Node (DWN) SDK

Code Coverage

Statements Branches Functions Lines

Introduction

This repository contains a reference implementation of Decentralized Web Node (DWN) as per the specification. This specification is in a draft state and very much so a WIP. For the foreseeable future, a lot of the work on DWN will be split across this repo and the repo that houses the specification, which you can find here. The overall goal is to produce a v1.0 specification along with a reference implementation by 07/01/2022.

Proposals and issues for the specification itself should be submitted as pull requests to the spec repo.

Installation

Since this SDK is still in early stages, we haven't yet published to npm. Until then, we suggest using npm link to use this SDK in your own project. Steps:

# clone this repo somewhere
git clone https://github.com/TBD54566975/dwn-sdk-js.git
# install deps
npm install
# transpile typescript and build bundles
npm run build

# cd into your project dir
cd /path/to/your/project
# first creates a global link, and then links the global installation target into your project's node_modules folder.
npm link ../path/to/where/you/cloned/dwn-sdk-js

# profit

Usage

nodeJS

  • ESM

    import { DWN } from 'dwn-sdk';
    
    // cool things
  • CJS

    const { DWN } = require('dwn-sdk');
    
    // cool things

Browser:

  • UMD Bundle

    <script type="text/javascript" src="node_modules/dwn-sdk/dist/bundles/bundle.umd.js"></script>
  • ESM Bundle

    <script type="text/javascript" src="node_modules/dwn-sdk/dist/bundles/bundle.esm.js"></script>

Project Resources

Resource Description
CODEOWNERS Outlines the project lead(s)
CODE_OF_CONDUCT.md Expected behavior for project contributors, promoting a welcoming environment
CONTRIBUTING.md Developer guide to build, test, run, access CI, chat, discuss, file issues
GOVERNANCE.md Project governance
LICENSE Apache License, Version 2.0

About

Decentralized Web Node (DWN)

License:Apache License 2.0


Languages

Language:TypeScript 91.6%Language:JavaScript 8.4%