divvy-lib

A JavaScript API for interacting with Divvy in Node.js and the browser

Usage no npm install needed!

<script type="module">
  import divvyLib from 'https://cdn.skypack.dev/divvy-lib';
</script>

README

divvy-lib

A JavaScript API for interacting with the XDV Ledger

NPM

Features

  • Connect to a divvyd server from Node.js or a web browser
  • Helpers for creating requests and parsing responses for the divvyd API
  • Listen to events on the XDV Ledger (transactions, ledger, validations, etc.)
  • Sign and submit transactions to the XDV Ledger
  • Type definitions for TypeScript

Getting Started

See also: DivvyAPI Beginners Guide

Requirements

  • Node v10 is recommended. Other versions may work but are not frequently tested.
  • Yarn is recommended. npm may work but we use yarn.lock.

Install

In an existing project (with package.json), install divvy-lib:

$ yarn add divvy-lib

Then see the documentation and code samples.

What is divvy-lib used for? Here's a list of applications that use divvy-lib. Open a PR to add your app or project to the list!

Mailing Lists

We have a low-traffic mailing list for announcements of new divvy-lib releases. (About 1 email per week)

If you're using the XDV Ledger in production, you should run a divvyd server and subscribe to the divvy-server mailing list as well.

Development

To build the library for Node.js:

$ yarn compile

The TypeScript compiler will output the resulting JS files in ./dist/npm/.

To build the library for the browser:

$ yarn build

Gulp will output the resulting JS files in ./build/.

For details, see the scripts in package.json.

Running Tests

  1. Clone the repository
  2. cd into the repository and install dependencies with yarn install
  3. yarn test

Also, run yarn lint to lint the code with tslint.

Generating Documentation

The continuous integration tests require that the documentation stays up-to-date. If you make changes to the JSON schemas, fixtures, or documentation sources, you must update the documentation by running yarn run docgen.

More Information