Skip to content
BitDB Web API Microservice
HTML JavaScript Dockerfile
Branch: master
Clone or download
This branch is 8 commits ahead of SpendBCH:master.

Latest commit

Fetching latest commit…
Cannot retrieve the latest commit at this time.

Files

Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
public
views
.gitignore
Dockerfile
README.md
bitserve.json
index.js
package-lock.json
package.json
process.json

README.md

bitserve

Bitdb Microservice

An API Endpoint + Web Query UI for BitDB

How it works

This project contains:

  1. BitDB Microservice API Endpoint: An HTTP API Endpoint to your BitDB
  2. BitDB Query Web UI: As seen in https://bitdb.bitcoin.com/explorer

1. BitDB Microservice API Endpoint

Make HTTP requests to your bitdb node

api

2. BitDB Query Web UI

Makes use of the API endpoint to render the query UI

query

Prerequisites

You must have the following installed.

  1. Bitcoin Full Node: Any BCH node implementation
  2. Bitdb Node: Bitdb is a universal bitcoin database that autonomously synchronizes with Bitcoin https://bitdb.bitcoin.com

Install

Step 1. Clone this repository

git clone https://github.com/Bitcoin-com/bitserve.git

Step 2. Install Dependencies

npm install

Step 3. Install node-jq binary

cd node_modules/node-jq
npm run install-binary

Step 4. Run

npm start

Configure

You can configure the service through bitserve.json

Example:

{
  "query": {
    "v": 3,
    "q": { "find": {}, "limit": 10 }
  },
  "port": 3000,
  "url": "mongodb://localhost:27017",
  "timeout": 30000,
  "log": false,
}

Here's what each attribute represents:

  • query: The default bitdb query to show up when you navigate to /explorer web UI
  • port: web service port
  • url: Mongodb URL that hosts BitDB.
  • timeout: default timeout for all query requests
  • log: true to see request and response logs, false to hide logs
You can’t perform that action at this time.