Overview of TheGraph and hands-on tutorial on accessing data from blockchains using GraphQL language

1. Graph Protocol
for accessing information about
blockchains and dApps
By Gene Leybzon
9/2/2021

2. What is THE Graph?
The Graph (GRT) seeks to facilitate the seamless exchange of data between
blockchains and applications. The platform is among the first decentralized indexing
and querying software available in the market
The Graph is the indexing and query layer of the
decentralized web. Developers build and publish open APIs,
called subgraphs, that applications can query using
GraphQL. The Graph currently supports indexing data from
Ethereum, IPFS, and PoA with more networks coming soon.
To date, over 10,000 subgraphs have been deployed by
~16,000 developers for applications, such as Uniswap,
Synthetix, Aragon, Gnosis, Balancer, Livepeer, DAOstack,
AAVE, Decentraland, and many others.
The Graph is a query protocol for blockchain data
using GraphQL

3. Q: What problem(s) solved by the
GRAPH?
Traditional way
• https://etherscan.io/
The Blockchain Way
• https://thegraph.com/explorer
A: Access to Blockchain Data

4. Vocabulary
•Graph is a decentralized protocol for indexing and querying data
from blockchains
Graph
•A subgraph defines which data The Graph will index from Ethereum,
and how it will store it. Once deployed, it will form a part of a global
graph of blockchain data.
Subgraph
•GraphQL is a query language for your API, and a server-side runtime
for executing queries using a type system you define for your data.
GraphQL isn't tied to any specific database or storage engine and is
instead backed by your existing code and data.
GraphQL
•Graph (GRT) coin is the native token of the network. Its main use is
coordinating the work on The Graph. GRT is an ERC20 token.
GRT Coin

5. Graph QL

6. Graph Fetching Data with Queries
{ allPersons { name } }
{ "allPersons": [ { "name": "Johnny" }, { "name": "Sarah" }, { "name": "Alice" } ] }
{ allPersons { name age } }
{ allPersons(last: 2) { name } }

7. Delivering data to CONSUMERS

8. Who is using graph?
DeFi makes up 57% of queried
subgraphs. Meanwhile, 11% of subgraphs serve NFT
marketplaces, arts, and gaming. 7% of subgraphs are
related to cross-chain use cases like synthetic bitcoin
and protocol bridges, signifying an increase in
interoperability between dapps

9. 1 Billion Monthly Queries
10,000+ cryptocurrencies
10% of Google Search Request

10. GRT Token

11. The Graph Foundation
The Graph Foundation oversees The Graph Network. The
Graph Foundation is overseen by the Technical Council.
Edge & Node is one of the many organizations within The
Graph ecosystem.
Represent: Indexers, Users, Researchers, Backers and Initial Team
Grants
1. The Graph Foundation Operations
2. Grants and Ecosystem Funding
3. Protocol Upgrades
4. Protocol Parameterization
5. Emergency Protocol Operations

12. HOW THE GRAPH
WORKS?

13. BIG PICTURE

14. ROLES AND RESPONSIBILITIES
Consumer
•End-users of The Graph that query subgraphs and pay query fees
Developer
•Create subgraph
Indexer
•Index Data & Serve Queries
•Run Nodes
•Earn query fee
Curator
•Assess and signal Indexers on the subgraphs that should be indexed
•Deposit GRP into bounding curve
•10% of all query fees goes to the Curators
Delegator
•Delegating GRT to Indexers
•Earn a portion of query fees and indexing

15. Tools
Graph Explorer
Subgraph Studio
Playground

16. Graph Explorer 1

17. Graph Explorer 2

18. Subgraph Studio

19. Playground

20. ACCESSING THE
GRAPH
Demo time

21. Query with API
1. Get API KEY
https://thegraph.com/studio/apikeys/
2. Get Query URL
https://gateway.thegraph.com/api/{KEY}/subgraphs/id/0x4bb4c1b0745ef7b4642feeccd0740dec417ca0a0-0

22. Query from Graph Explorer

23. From the code with a library
Apollo client https://www.apollographql.com/docs/
URQL https://formidable.com/open-source/urql/

24. From code with Assemblyscript API

25. Demo
Query Sushi (Mainnet Exchange)

26. Explorer

27. Available Entry Types
User
Bundle
Factory
HourData
DayData
Token
TokenHourData
TokenDayData
Pair
PairHourData
PairDayData
LiquidityPosition
LiquidityPositionSnapshot
Transaction
Mint

28. Some users and some tokens
Query Response
{
users(first: 5) {
id
liquidityPositions {
id
}
}
tokens(first: 5) {
symbol
name
}
}
"data": {
"tokens": [
{
"name": "Chi Gastoken by 1inch",
"symbol": "CHI"
},
{
"name": "TrueUSD",
"symbol": "TUSD"
},
{
"name": "Tokenlon",
"symbol": "LON"
},
….

29. Low volume pairs
Query Response
{
pairs(orderBy: volumeUSD,
orderDirection: asc, first: 5) {
id
name
totalSupply
}
}
{
"data": {
"pairs": [
{
"id":
"0x00040a7ebfc9f6fbce4d23bd66b79a603ba1c323
",
"name": "TUSD-Xi",
"totalSupply": "0"
},
{
"id":
"0x0013df4ec514d5839ad4f535e4987498ebb58bf5
",
"name": "ORANGE-WETH",

30. High volume pairs
Query Response
{
pairs(orderBy: volumeUSD,
orderDirection: desc, first: 10) {
id
name
volumeUSD
totalSupply
}
}
{
"data": {
"pairs": [
{
"id":
"0x397ff1542f962076d0bfe58ea045ffa2d347aca0"
,
"name": "USDC-WETH",
"totalSupply": "2.566388461708481722",
"volumeUSD":
"19215716701.97130473095498336638286"
},
{
"id":
"0xc3d03e4f041fd4cd388c549ee2a29a9e5075882f
",

31. Latest Transactions
Query Response
{
transactions(first: 3, orderBy: timestamp,
orderDirection:desc) {
id
blockNumber
timestamp
}
}
{
"data": {
"transactions": [
{
"blockNumber": "13143929",
"id":
"0xfa1b36a1b05b9581e419d1d653599a6687cf83e
64ba59a04026852e11ec197d8",
"timestamp": "1630553981"
},
{
"blockNumber": "13143929",
"id":
"0x3a4edefc1cf38e5d818afdb504b748798fecde8c1
5e6d599067c87d5f5925b98",
"timestamp": "1630553981"

32. Latest Transactions
Query Response
{
transactions(first: 30, orderBy:
timestamp, orderDirection:desc) {
id
blockNumber
timestamp
swaps {
id
pair{
token0 {
name
}
token1 {
name
}
{
"data": {
"transactions": [
{
"blockNumber": "13143959",
"burns": [],
"id":
"0x0a41938b670043db07c022e3f5c7e53183242a4
f5e110653fcb75f97147c1f37",
"swaps": [
{
"amountUSD":
"7317.440460051526149065106622302379",
"id":
"0x0a41938b670043db07c022e3f5c7e53183242a4
f5e110653fcb75f97147c1f37-0",

33. Questions?

34. Stay in Touch
Gene Leybzon https://www.linkedin.com/in/leybzon/
https://www.meetup.com/members/9074420/
https://www.leybzon.com