Skip to content
/ juno Public

A Cosmos Hub data aggregator and exporter.

License

Notifications You must be signed in to change notification settings

forbole/juno

Repository files navigation

Juno

banner

GitHub Workflow Status Go Report Card GitHub tag (latest SemVer)

Juno is a Cosmos Hub blockchain data aggregator and exporter that provides the ability for developers and clients to query for indexed chain data.

Table of Contents

Background

This version of Juno is a fork of FissionLabs's Juno.

The main reason behind the fork what to improve the original project by:

  1. allowing different databases types as data storage spaces;
  2. creating a highly modular code that allows for easy customization.

We achieved the first objective by supporting both PostgreSQL and MongoDB. We also reviewed the code design by using a database interface so that you can implement whatever database backend you prefer most.

On the other hand, to achieve a highly modular code, we implemented extension points through the worker.RegisterBlockHandler, worker.RegisterTxHandler and worker.RegisterMsgHandler methods. You can use those to extend the default working of the code (which simply parses and saves the data on the database) with whatever operation you want.

Compatibility table

Since the Cosmos SDK has evolved a lot, we have different versions of Juno available.

Cosmos SDK Version Juno branch
v0.43.x, v0.44.x, v0.45.1 cosmos/v0.44.x
v0.45.x cosmos/v0.45.x
v0.46.x cosmos/v0.46.x
v0.47.x cosmos/v0.47.x
v0.50.x cosmos/v0.50.x

Usage

To know how to setup and run Juno, please refer to the docs folder.

Testing

If you want to test the code, you can do so by running

$ make test-unit

Note: Requires Docker.

This will:

  1. Create a Docker container running a PostgreSQL database.
  2. Run all the tests using that database as support.

GraphQL integration

If you want to know how to run a GraphQL server that allows to expose the parsed data, please refer to the following guides:

Contributing

Contributions are welcome! Please open an Issues or Pull Request for any changes.

License

CCC0 1.0 Universal