Skip to content

Latest commit

 

History

History
61 lines (44 loc) · 2.01 KB

README.md

File metadata and controls

61 lines (44 loc) · 2.01 KB
Raw

BDJuno

Build Status Go Report Card Codecov

BDJuno (shorthand for BigDipper Juno) is the Juno implementation for BigDipper.

It extends the custom Juno behavior by adding different handlers and custom operations to make it easier for BigDipper showing the data inside the UI.

All the chains' data that are queried from the LCD and RPC endpoints are stored inside a PostgreSQL database on top of which GraphQL APIs can then be created using Hasura.

Installation

To install the binary simply run make install.

Note: Requires Go 1.13+

Database

Before running the parser, you need to:

  1. Create a PostgreSQL database.
  2. Run the SQL queries you find inside the schema folder inside such database to create all the necessary tables.

Running the parser

To parse the chain state, you need to use the following command:

bdjuno parse <path/to/config.toml>

# Example
# bdjuno parse config.toml

The configuration must be a TOML file containing the following fields:

rpc_node = "<rpc-ip/host>:<rpc-port>"
client_node = "<client-ip/host>:<client-port>"

[database]
host = "<db-host>"
port = <db-port>
name = "<db-name>"
user = "<db-user>"
password = "<db-password>"
ssl_mode = "<ssl-mode>"

Example of a configuration to parse the chain state from a local full-node:

rpc_node = "http://localhost:26657"
client_node = "http://localhost:1317"

[database]
host = "localhost"
port = 5432
name = "big-dipper"
user = "<username>"
password = "<password>"