Gewelcore Node
============

A Gewel 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 [Gewel Core (geweld) v0.1.0.0](https://github.com/gewelio/gewel) 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

```bash
git clone https://github.com/gewelio/gewelcore-node
cd gewelcore-node
npm install
./bin/gewelcore-node start
```

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

Some plugins are available :

- Insight-API : `./bin/gewelcore-node addservice @gewelio/insight-api`
- Insight-UI : `./bin/gewelcore-node addservice @gewelio/insight-ui`

You also might want to add these index to your gewel.conf file :
```
-addressindex
-timestampindex
-spentindex
```

### As a library

```bash
npm install @gewelio/gewelcore-node
```

```javascript
const gewelcore = require('@gewelio/gewelcore-node');
const config = require('./gewelcore-node.json');

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

## Prerequisites

- Gewel Core (geweld) (v0.13.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

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

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

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

Please note that [Gewel Core](https://github.com/gewelio/gewel/tree/master) needs to be installed first.

For more information about (and developing) services, please see the [Service Documentation](docs/services.md).

## Add-on Services

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

- [Insight API](https://github.com/gewelio/insight-api/tree/master)
- [Insight UI](https://github.com/gewelio/insight-ui/tree/master)
- [Gewelcore Wallet Service](https://github.com/gewelio/gewelcore-wallet-service/tree/master)

## Documentation

- [Upgrade Notes](docs/upgrade.md)
- [Services](docs/services.md)
  - [Geweld](docs/services/geweld.md) - Interface to Gewel Core
  - [Web](docs/services/web.md) - Creates an express application over which services can expose their web/API content
- [Development Environment](docs/development.md) - Guide for setting up a development environment
- [Node](docs/node.md) - Details on the node constructor
- [Bus](docs/bus.md) - Overview of the event bus constructor
- [Release Process](docs/release.md) - Information about verifying a release and the release process.


## Setting up dev environment (with Insight)

Prerequisite : Having a geweld node already runing `geweld --daemon`.

Gewelcore-node : `git clone https://github.com/gewelio/gewelcore-node -b develop`
Insight-api (optional) : `git clone https://github.com/gewelio/insight-api -b develop`
Insight-UI (optional) : `git clone https://github.com/gewelio/insight-ui -b develop`

Install them :
```
cd gewelcore-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/gewelcore-node start` to first generate a ~/.gewelcore/gewelcore-node.json file.
Append this file with `"@gewelio/insight-ui"` and `"@gewelio/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](https://github.com/gewelio/gewel/blob/master/CONTRIBUTING.md) file.

## License

Code released under [the MIT license](https://github.com/gewelio/gewelcore-node/blob/master/LICENSE).

Copyright 2016-2021 Gewel Core Developers

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