@xyo-network/api-diviner-nodejs
Main Diviner Interface
Last updated 2 years ago by xyo .
MIT · Repository · Bugs · Original npm · Tarball · package.json
$ cnpm install @xyo-network/api-diviner-nodejs 
SYNC missed versions from official npm registry.

logo

DIVINER API (api-diviner-nodejs)

Branches

Master

Build Status BCH compliance Maintainability Greenkeeper badge

Develop

Build Status BCH compliance Greenkeeper badge

Description

The main API for accessing a diviner on the XYO network information using GraphQL.

User Mode

Requirements (Step 1)

Install Node 10.x or later from: NodeJs

Install Diviner (Step 2)

sudo npm install @xyo-network/api-diviner-nodejs -g --unsafe-perm=true

Build Diviner (Step 3)

xyo-diviner start

Developer Mode

Requirements (Step 1)

Install Node 10.x or later from: NodeJs

Install Diviner (Step 2)

npm install https://github.com/XYOracleNetwork/api-diviner-nodejs

Build Diviner (Step 3)

npm run build

Start Diviner (Step 4)

npm run start

Docker

Install

Install the Diviner in a Docker and start the server at the end.

Note: There currently are quite a few build errors/warnings generted from dependencies that can safely be ignored, but should addressed in the future.

docker image build -t xyonetwork-api-diviner-nodejs-install:latest https://raw.githubusercontent.com/XYOracleNetwork/api-diviner-nodejs/master/docker/install/Dockerfile
docker run -p 12002:12002 xyonetwork-api-diviner-nodejs-install:latest

Accessing GraphQL

Example Query

GraphQL Query

query QuestionHasIntersected($partyOneAddresses: [String]!, $partyTwoAddresses: [String]!, $markers: [String], $direction: Direction) {
  questionHasIntersected(partyOneAddresses: $partyOneAddresses, partyTwoAddresses: $partyTwoAddresses, markers: $markers, direction: $direction)
}

partyOneAddresses - the first of two entities in the query

partyTwoAddresses - the second of two entities in the query

markers - a list of known interactions between the two entities used for truncating

direction - truncate everything before or after the markers

Notes:

  1. Addresses are public keys from the entities.
  2. Markers are signed hashes from bound witness interactions.
  3. Direction can be FORWARD, BACKWARD, or BOTH (default=BOTH)

Query Variables (replace the addresses with known addresses and markers)

{
  "partyOneAddresses": ["040135DC4E51B3A3AC55F5A88D22DDAD498FDE02273BD0DF6FC63D5138EB8C128CF4268A6ED86A1DC433E0D3EFD24172CD1253EAFEFF71C9B6C133B7D759BFFE7E95"],
  "partyTwoAddresses": ["0401FF4FD5F39558F82E53111993D632756FBB9E5FAF85C0316DA8465F6B8B0F0BD1EC61D9C56EBBDF31C14F125964279F1996623995CCC1E30ACDF4A42E002620D4"],
  "markers": ["030524007069b9aa23dfa7b86e729aff39f976027dacd292588b70c93d9b53cfc15d"],
  "direction": "FORWARD"
}

Command Line

Usage

  xyo-diviner <cmd> [opt]

  <cmd>: commands
  [opt]: options

Commands

  start               Start the Api Server

Options

  -g, --graphql [n]   The http port to listen on for graphql connections
                      (default = 12001)

  -a, --archivist [s] The url of the seed archivists to contact
                      (default = http://archivists.xyo.network:11001)

Example: Start the Diviner on port 9070 and use port 9079 on your local computer for the archivist

  xyo-diviner start -g 9070 -a http://localhost:9079

License

Only for internal XY Company use at this time

Credits

Made with ❤️ by XYO

Current Tags

  • 0.1.14                                ...           latest (2 years ago)

14 Versions

  • 0.1.14                                ...           2 years ago
  • 0.1.13                                ...           2 years ago
  • 0.1.12                                ...           2 years ago
  • 0.1.11                                ...           2 years ago
  • 0.1.10                                ...           2 years ago
  • 0.1.9                                ...           2 years ago
  • 0.1.8                                ...           2 years ago
  • 0.1.7                                ...           2 years ago
  • 0.1.6                                ...           2 years ago
  • 0.1.5                                ...           2 years ago
  • 0.1.3                                ...           2 years ago
  • 0.1.2                                ...           2 years ago
  • 0.1.1                                ...           2 years ago
  • 0.1.0                                ...           2 years ago
Downloads
Today 0
This Week 0
This Month 0
Last Day 0
Last Week 0
Last Month 0
Dependencies (26)
Dev Dependencies (20)
Dependents (0)
None

Copyright 2014 - 2016 © taobao.org |