Giter Club home page Giter Club logo

helpthehomeless-node's Introduction

Helpthehomeless Node

A Helpthehomeless 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 Helpthehomeless Core (helpthehomelessd) v0.14.0 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/hthcoin/helpthehomeless-node
cd helpthehomeless-node
npm install
./bin/helpthehomeless-node start

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

Some plugins are available :

  • Insight-API : ./bin/helpthehomeless-node addservice @hthcoin/insight-api
  • Insight-UI : ./bin/helpthehomeless-node addservice @hthcoin/insight-ui

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

-addressindex
-timestampindex
-spentindex

As a library

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

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

Prerequisites

  • Helpthehomeless Core (helpthehomelessd) (v0.14.0) with support for additional indexing (see above)
  • Node.js v8+
  • ZeroMQ (libzmq3-dev for Ubuntu/Debian or zeromq on OSX)
  • ~20GB of disk storage
  • ~1GB of RAM

Configuration

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

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

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

Please note that Helpthehomeless 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

Setting up dev environment (with Insight)

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

Helpthehomeless-node : git clone https://github.com/hthcoin/helpthehomeless-node -b develop Insight-api (optional) : git clone https://github.com/hthcoin/insight-api -b develop Insight-UI (optional) : git clone https://github.com/hthcoin/insight-ui -b develop

Install them :

cd helpthehomeless-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/helpthehomeless-node start to first generate a ~/.helpthehomeless/helpthehomeless-node.json file. Append this file with "@hthcoin/insight-ui" and "@hthcoin/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 2020 Help The Homeless Developers Copyright 2016-2018 Dash Core Group, Inc.

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

helpthehomeless-node's People

Contributors

alex-werner avatar altcoin-cash avatar antouhou avatar braydonf avatar chjj avatar cofresi avatar donegogov avatar gabegattis avatar gasteve avatar igorbarinov avatar isghe avatar jpochyla avatar kamuelafranco avatar kleetus avatar matiu avatar michaelhdesigns avatar nmarley avatar pnagurny avatar posita avatar ralphtheninja avatar sexual avatar shumkov avatar snogcel avatar strml avatar unusualbob avatar

Watchers

 avatar  avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.