Query the Hosted Service
Prerequisites
Install Rust and Cargo, the Rust package manager
Open your Terminal application then run the following command
Instruction are valid for Linux, macOS, and Windows Subsystem for Linux
Overview
The Graph is a decentralized protocol that enables developers to query data from blockchains using GraphQL. In this lesson, we will use Rust to submit a GraphQL query to the graph-network-mainnet
subgraph on The Graph’s Hosted Service. This hands-on lesson will provide you with the practical experience needed to interface with The Graph's ecosystem, and moreover, demonstrate the immense potential of leveraging Rust to interact with decentralized data networks. Let's dig in and uncover the incredible possibilities that await us in the realm of Rust, GraphQL, and The Graph's Hosted Service!
GraphQL query
To start, let's discuss the subgraph and GraphQL query we're submitting. The graph-network-mainnet
subgraph extracts data from the protocol's smart contracts and makes it accessible via GraphQL queries. Indexers are the node operators of the protocol and allocate GRT tokens to subgraphs as part of their operations.
In this lesson, we're requesting data about indexers that is defined in the protocol's smart contracts. Our query is filtering results to the first 10 indexers who have allocated at least 1 GRT token to any subgraph in the protocol. Finally we're narrowing down the returned fields to id
, defaultDisplayName
, and stakedTokens
.
Table 1. Subgraph field descriptions
Field | Description |
---|---|
| the Ethereum address of the Indexer |
| the current default display name of the Indexer. Potentially |
| current tokens staked in The Graph protocol |
Figure 1. Subgraph query
Getting started with Rust
Coming soon
Create a new cargo project
Open your Terminal application and change to your home directory
Create a new directory called
rohr
and change into it
Create a new
cargo
project calledindexer_subgraph_query
Change into the new
indexer_subgraph_query
directory
Add dependencies to your project
Open
Cargo.toml
withnano
Save your changes to
Cargo.toml
and exitnano
Write Rust code
structs.rs
Create a new file called
structs.rs
in thesrc
directory
Add the following use declarations to
src/structs.rs
A use declaration creates one or more local name bindings synonymous with some other path. Usually, a use declaration is utilized to shorten the path required to refer to a module item. These declarations may appear in modules and blocks, often at the top.
Next define a few
struct
statements insrc/structs.rs
Notice that we created three structs:
IndexerResponse
: the highest-level struct in the hierarchy. It defines the response format from thePOST
request sent to The Graph's Hosted ServiceIndexerData
andIndexer
: nested structs which define data returned in theIndexerResponse
Each Indexer in The Graph protocol would theoretically be assigned to an Indexer
struct, with the IndexerData
struct containing all Indexer
structs (or a subset based on the query filter submitted, i.e. first 10).
Finally, IndexerData
is the value of the IndexerResponse
data
field.
Save your changes to
src/structs.rs
and exitnano
Your file structs.rs
will look something like this
main.rs
Open
src/main.rs
withnano
Delete all existing lines in the file
Add the following user declarations to the top of
src/main.rs
Run your program
From your terminal, use cargo
to compile and run your Rust program
Last updated