github.com/dfuse-io/dgraphql

dfuse GraphQL API Services for Blockchains

This service is the API for querying blockchain data using GraphQL. It is part of dfuse.

Installation

See the different protocol-specific dfuse binaries at https://github.com/dfuse-io/dfuse#protocols

Current dgraphql implementations:

• dfuse for EOSIO
• dfuse for Ethereum, soon to be open sourced

Usage

Connecting from command-line clients

• Using https://github.com/Gavinpub/ws (which supports subprotocol negotiation)

  ws -s graphql-ws ws://127.0.0.1:8080/graphql

  {"id":"3","type":"connection_init","payload":{"Authorization":"Bearer ......"},"variables":null}}

  {"id":"3","type":"start","payload":{"query":"subscription{searchTransactionsForward(query: "status:executed", lowBlockNum:0, highBlockNum:0){ trace{ block { num } id }}}","variables":null}}

  {"id":"3","type":"start","payload":{"query":"subscription{searchTransactionsForward(query: "status:executed", lowBlockNum:0, highBlockNum:0){ trace{ block { num } id }}}","variables":null}}

• Using curl:

  curl http://localhost:8080/graphql -XPOST -d '{"query": "{ searchTransactionsForward(limit: 10, query: "status:executed") { cursor } }"}' -H "Authorization: Bearer $DFUSE" | jq .

  curl http://localhost:8080/graphql -XPOST -d '{"query": "{ blockIDByTime(time: "2019-01-01T00:00:00Z") { time num } }"}' -H "Authorization: Bearer $DFUSE" | jq .

Contributing

Issues and PR in this repo related strictly to the core dgraphql API engine

Report any protocol-specific issues in their respective repositories

Please first refer to the general dfuse contribution guide, if you wish to contribute to this code base.

This codebase uses unit tests extensively, please write and run tests.

License

Apache 2.0