TheGraph Data Indexing

TheGraph, a decentralized protocol for indexing and querying chain data, supports the xDai chain. Data defined through subgraphs is easy to query and explore. Subgraphs can be created locally, or use a free hosted explorer for indexing and data display.

Setting up a hosted project with TheGraph & xDai

See for more details, local installation and more. The docs include an example for learning how subgraphs work and this video provides a good introduction.

The article below from also covers the initializing a graph using a smart contract address on xDai.


1) Go to Graph Explorer ( and setup an account. You will need a GitHub account for authentication.

2) Go to your dashboard and click Add Subgraph. Define the subgraph Name, Account, and Subtitle and update the image and other info (you can update later) if desired.

Basic info is required to create a subgraph. You can modify later if needed.

3) Install Graph CLI on your machine (using either npm or yarn)

$ npm install -g @graphprotocol/graph-cli
$ yarn global add @graphprotocol/graph-cli

4) Make a directory (or choose an existing one) and scaffold the project:

graph init

5) Enter your subgraph details at the prompts:

  • Subgraph name: <github_username>/<graph-name> Chose the subgraph name created in step 2 as lowercase-hypenated

  • Directory to create: Choose a directory name

  • Ethereum Network: Select xdai

  • Contract address: Address of the contract you want to use. If verified in BlockScout, the graph will grab the ABI, otherwise you will need manually add the ABI

  • ABI file (path): path-to-abi.json You can save the abi from BlockScout or by running truffle compile or solc on a public project. More info available here.

6) Authenticate with the hosted service

graph auth <your-access-token>

7) cd to the directory you created and start defining the subgraph. Information on creating a subgraph is available in the Graph Docs.

8) When you are ready, deploy your subgraph. You can always test and redeploy as needed.

yarn deploy

Your subgraph will be deployed, and you can try sample queries. If you are ready to make it public, select the subgraph and turn off the Hide slider.