Extensible full node using dash v0.12.2.x
Clone or download
Pull request Compare This branch is 68 commits ahead, 447 commits behind bitpay:master.
Alex-Werner V. 4.0.0 (#24)
* Bump bitcore-lib to 0.15.3

* Feat : Added governance methods (deserialize, budget, votes, count,..)

* Impr : Removed autoinstaller

* Remove : Useless npm dependency

* Impr : Use uninstall method instead of npm

* Chore : bitcoind-rpc to dashd-rpc

* Chore : bitcore-lib => dashcore-lib

* Chore : bitcore-p2p => dashcore-p2p

* Impr : Dashified + Doc

* Fix : typo

* Impr : More Dashifying

* Impr : Even more dashifying

* Fix : Old bug

* Fix : Bug in logger test file

* Fix : Modify regtest for new path

* Impr : connect instead of spawn

* typo: s/need/needs/

* Updated docs and deps

* Update test for default conf integration

* Update deps

* Revert logger test cases

* linting impr

* Update npm lockfile

* Added log case for <node6

* Update travis file (bitpay#42)

* Doc : Dev Environment (bitpay#43)

* Bump to 4.0.0

* Small fixes
Latest commit d2ffd2a May 31, 2018

README.md

Dashcore Node

A Dash full node for building applications and services with Node.js. A node is extensible and can be configured to run additional services. At the minimum a node has an interface to Dash Core (dashd) v0.12.1.x for more advanced address queries. Additional services can be enabled to make a node more useful such as exposing new APIs, running a block explorer and wallet service.

Usages

As a standalone server

git clone https://github.com/dashevo/dashcore-node
cd dashcore-node
./bin/dashcore-node start

When running the start command, it will seek for a .dashcore folder with a dashcore-node.json conf file. If it doesn't exist, it will create it, with basic task to connect to dashd.

Some plugins are available :

  • Insight-API : `./bin/dashcore-node addservice @dashevo/insight-api
  • Insight-UI : ./bin/dashcore-node addservice @dashevo/insight-ui

You also might want to add these index to your dash.conf file :

-addressindex
-timestampindex
-spentindex

As a library

npm install @dashevo/dashcore-node
const dashcore = require('@dashevo/dashcore-node');
const config = require('./dashcore-node.json');

let node = dashcore.scaffold.start({ path: "", config: config });
node.on('ready', function() {
    //Dash core started
    dashd.on('tx', function(txData) {
        let tx = new dashcore.lib.Transaction(txData);
    });
});

Prerequisites

  • Dash Core (dashd) (v0.12.1.x) with support for additional indexing (see above)
  • Node.js v0.10, v0.12, v4 or v5
  • ZeroMQ (libzmq3-dev for Ubuntu/Debian or zeromq on OSX)
  • ~20GB of disk storage
  • ~1GB of RAM

Configuration

Dashcore includes a Command Line Interface (CLI) for managing, configuring and interfacing with your Dashcore Node.

dashcore-node create -d <dash-data-dir> mynode
cd mynode
dashcore-node install <service>
dashcore-node install https://github.com/yourname/helloworld
dashcore-node start

This will create a directory with configuration files for your node and install the necessary dependencies.

Please note that Dash Core needs to be installed first.

For more information about (and developing) services, please see the Service Documentation.

Add-on Services

There are several add-on services available to extend the functionality of Bitcore:

Documentation

  • Upgrade Notes
  • Services
    • Dashd - Interface to Dash Core
    • Web - Creates an express application over which services can expose their web/API content
  • Development Environment - Guide for setting up a development environment
  • Node - Details on the node constructor
  • Bus - Overview of the event bus constructor
  • Release Process - Information about verifying a release and the release process.

Setting up dev environment (with Insight)

Prerequisite : Having a dashd node already runing dashd --daemon.

Dashcore-node : git clone https://github.com/dashevo/dashcore-node -b develop Insight-api (optional) : git clone https://github.com/dashevo/insight-api -b develop Insight-UI (optional) : git clone https://github.com/dashevo/insight-ui -b develop

Install them :

cd dashcore-node && npm install \
 && cd ../insight-ui && npm install \
 && cd ../insight-api && npm install && cd ..

Symbolic linking in parent folder :

npm link ../insight-api
npm link ../insight-ui

Start with ./bin/dashcore-node start to first generate a ~/.dashcore/dashcore-node.json file. Append this file with "@dashevo/insight-ui" and "@dashevo/insight-api" in the services array.

Contributing

Please send pull requests for bug fixes, code optimization, and ideas for improvement. For more information on how to contribute, please refer to our CONTRIBUTING file.

License

Code released under the MIT license.

Copyright 2013-2015 BitPay, Inc.

  • bitcoin: Copyright (c) 2009-2015 Bitcoin Core Developers (MIT License)