@dashevo/js-evo-services-ctl

Dash Platform services ctl

Control Dash Platform services using JavaScript and Docker

The tool provides a convenient JavaScript interface for configuration and interaction with Dash Platform services. Services are started in Docker containers.

Table of Contents

• Installation
• Usage
  • Available DP services
  • Services configuration
  • Integration with Mocha
• Maintainers
• Contributing
• License

Installation

• Install Docker

• Install NPM package:

  npm install @dashevo/js-evo-services-ctl
  

Usage

Available DP services

Drive

Drive service starts a bunch of related services:

• Drive Api
  • Methods
  • Options
• Drive Sync
  • Methods
  • Options
• IPFS
• MongoDB
• Dash Core

DAPI

DAPI service starts all DP services:

• DAPI
  • Methods
  • Options
• Drive Api
• Drive Sync
• IPFS
• MongoDB
• DashCore
• Insight

Dash Core

Dash Core service - Methods - Options

Insight

• Insight service
  • Methods
  • Options

IPFS

• IPFS service
  • Methods
  • Options

MongoDB

• MongoDB service
  • Methods
  • Options

Starting a service

// Export service(s)
const { startIPFS } = require('@dashevo/js-evo-services-ctl');

// This is optional. Default options listed in options class
const options = {
  port: 5001, // IPFS port
};

// Start service
const ipfs = await startIPFS(options);

// Get peer ID
const peerId = await ipfs.getApi().id();

// Stop IPFS
await ipfs.remove();

Use many method to start several instances:

const { startIPFS } = require('@dashevo/js-evo-services-ctl');

// This is optional. Default options listed in options class
const options = {
  port: 5001, // IPFS port
};

// Start two services
const ipfsNodes = await startIPFS.many(2, options);

// Get peer IDs
const [peerId1, peerId2] = await Promise.all(
  ipfsNodes.map(ipfs => ipfs.getApi().id()),
);

// Stop IPFS nodes
await Promise.all(
  ipfsNodes.map(ipfs => ipfs.remove()),
);

Services configuration

Each service has default options which can be overwrited in three ways:

• Pass options as plain JS object to start[service] or create[service] methods
• Pass instance of options class to start[service] or create[service] methods
• Pass default options as plain JS object to setDefaultCustomOptions method of options class

Integration with Mocha

Services Mocha hooks provide automatization for your mocha tests:

• Removing obsolete related Docker containers (before)
• Cleaning a service state between tests (beforeEach, afterEach)
• Stopping service after tests (after)

// Export service(s) with mocha hooks
const { mocha: { startIPFS } } = require('@dashevo/js-evo-services-ctl');

describe('Test suite', () => {
  let ipfsApi;

  startIPFS().then(ipfs => () => {
    ipfsApi = ipfs.getApi();
  });

  it('should do something', async () => {
    const peerId = await ipfsApi.id();

    expect(peerId).to.be.a('string');
  });
});

Maintainers

@shumkov @jawid-h @abvgedeika

Contributing

Feel free to dive in! Open an issue or submit PRs.

License

MIT © Dash Core Group, Inc.