From 23f190e343fc5119db8ddac6a6b298aa56681c6d Mon Sep 17 00:00:00 2001 From: Michael Macaulay Date: Thu, 1 May 2025 12:20:48 -0400 Subject: [PATCH 1/4] Initial edits --- website/src/pages/en/about.mdx | 31 +++++++++++++------------------ 1 file changed, 13 insertions(+), 18 deletions(-) diff --git a/website/src/pages/en/about.mdx b/website/src/pages/en/about.mdx index 5f554bbb18b1..75758c011618 100644 --- a/website/src/pages/en/about.mdx +++ b/website/src/pages/en/about.mdx @@ -7,13 +7,24 @@ description: This page summarizes the core concepts and basics of The Graph Netw ### What is The Graph? -The Graph is a decentralized protocol for indexing and querying blockchain data. Its suite includes [Subgraphs](/subgraphs/developing/subgraphs/), [Substreams](/substreams/introduction/), [Token API BETA](/token-api/quick-start/), and tools like [Graph Explorer](/subgraphs/explorer/) and [Subgraph Studio](/subgraphs/developing/deploying/using-subgraph-studio/). +The Graph is a decentralized protocol for indexing and querying blockchain data. Its data services include: + +- [Subgraphs](/subgraphs/developing/subgraphs/) +- [Substreams](/substreams/introduction/) +- [Token API Beta](/token-api/quick-start/) + +The ecosystem maintains additional tooling that includes: + +- [Graph Explorer](/subgraphs/explorer/) +- [Subgraph Studio](/subgraphs/developing/deploying/using-subgraph-studio/) The Graph supports [90+ blockchains](/supported-networks/), enhancing dapp development and data retrieval. ### Why is Blockchain Data Hard to Query? -Reading onchain data from the blockchain (e.g., ownership history, metadata, relationships between assets) typically requires processing smart contract events, parsing metadata from IPFS, and aggregating data manually. This is very slow, complex, and resource-intensive. +Reading data from blockchains (e.g., ownership history, metadata, relationships between assets) often requires processing smart contract events, parsing metadata from IPFS, and manually aggregating data. + +This is slow, complex, and resource-intensive. ## Solution @@ -34,22 +45,6 @@ Each Subgraph defines: 3. An [Indexer](/indexing/overview/) picks it up and starts indexing Ethereum blocks. 4. Data becomes queryable via a [GraphQL endpoint](/subgraphs/querying/graphql-api/). -### Data Flow Overview - -1. A dapp triggers a transaction on Ethereum by interacting with a smart contract. - -2. As the transaction is processed, the smart contract emits one or more events. - -3. [Graph Node](/indexing/tooling/graph-node/) continuously scans the Ethereum blockchain for new blocks and filters for events relevant to a deployed Subgraph. - -4. When a matching event is identified, Graph Node executes the Subgraph’s mapping logic, which is a WASM module that transforms event data into structured entities. These entities are subsequently stored and indexed. - -5. The dapp queries the Graph Node via a [GraphQL API](https://graphql.org/learn/), retrieving indexed data to render in the UI. Users can then take actions that generate new transactions, continuing the cycle. - -The diagram below provides more detailed information about the flow of data after a Subgraph manifest has been deployed with Ethereum transactions. - -![A graphic explaining how The Graph uses Graph Node to serve queries to data consumers](/img/graph-dataflow.png) - ## Next Steps Explore [Graph Explorer](https://thegraph.com/explorer) to view and query existing Subgraphs. From c1475395c5b3cde7f02100377e793c9fdebde9ce Mon Sep 17 00:00:00 2001 From: Michael Macaulay Date: Thu, 1 May 2025 15:49:50 -0400 Subject: [PATCH 2/4] Final edits --- website/src/pages/en/about.mdx | 56 ++++++++++++++-------------------- 1 file changed, 23 insertions(+), 33 deletions(-) diff --git a/website/src/pages/en/about.mdx b/website/src/pages/en/about.mdx index 75758c011618..4f83fb6f094f 100644 --- a/website/src/pages/en/about.mdx +++ b/website/src/pages/en/about.mdx @@ -3,48 +3,38 @@ title: About The Graph description: This page summarizes the core concepts and basics of The Graph Network. --- -## Explanation +## What is The Graph? -### What is The Graph? +The Graph is a decentralized protocol for indexing and querying blockchain data across [90+ networks](/supported-networks/). -The Graph is a decentralized protocol for indexing and querying blockchain data. Its data services include: +Its data services include: -- [Subgraphs](/subgraphs/developing/subgraphs/) -- [Substreams](/substreams/introduction/) -- [Token API Beta](/token-api/quick-start/) +- [Subgraphs](/subgraphs/developing/subgraphs/): Open APIs to query blockchain data that can be created or queried by anyone. +- [Substreams](/substreams/introduction/): High-performance data streams for real-time blockchain processing, built with modular components. +- [Token API Beta](/token-api/quick-start/): Instant access to standardized token data requiring zero setup. -The ecosystem maintains additional tooling that includes: +### Why Blockchain Data is Difficult to Query -- [Graph Explorer](/subgraphs/explorer/) -- [Subgraph Studio](/subgraphs/developing/deploying/using-subgraph-studio/) +Reading data from blockchains requires processing smart contract events, parsing metadata from IPFS, and manually aggregating data. -The Graph supports [90+ blockchains](/supported-networks/), enhancing dapp development and data retrieval. +The result is slow performance, complex infrastructure, and scalability issues. -### Why is Blockchain Data Hard to Query? +## How The Graph Solves This -Reading data from blockchains (e.g., ownership history, metadata, relationships between assets) often requires processing smart contract events, parsing metadata from IPFS, and manually aggregating data. +The Graph uses a combination of cutting-edge research, core dev expertise, and independent Indexers to make blockchain data accessible for developers. -This is slow, complex, and resource-intensive. +Find the perfect data service for you: -## Solution +### 1. Custom Real-Time Data Streams +**Use Case:** High-frequency trading, live analytics +→ [Build Substreams](/substreams/introduction/) +→ [Browse Community Modules](https://substreams.dev/) -### How The Graph Solves This +### 2. Instant Token Data +**Use Case:** Wallet balances, liquidity pools, transfer events +→ [Start with Token API](/token-api/quick-start/) -The Graph simplifies the complex process of retrieving blockchain data through a global, decentralized network of Indexers that index Subgraphs. This infrastructure facilitates efficient, censorship-resistant query handling, allowing developers to build applications using blockchain data without the hassle of managing servers or custom indexing. - -Each Subgraph defines: - -- Which smart contracts to watch -- Which events to extract -- How to map event data into a queryable format using [GraphQL](https://graphql.org/learn/) - -### [Building a Subgraph](/subgraphs/developing/creating/starting-your-subgraph/) - -1. Define a [Subgraph Manifest](/subgraphs/developing/creating/subgraph-manifest/) with data sources and mappings. -2. Use [Graph CLI](https://github.com/graphprotocol/graph-tooling/tree/main/packages/cli) to deploy the manifest to IPFS. -3. An [Indexer](/indexing/overview/) picks it up and starts indexing Ethereum blocks. -4. Data becomes queryable via a [GraphQL endpoint](/subgraphs/querying/graphql-api/). - -## Next Steps - -Explore [Graph Explorer](https://thegraph.com/explorer) to view and query existing Subgraphs. +### 3. Flexible Historical Queries +**Use Case:** Dapp frontends, custom analytics +→ [Explore Subgraphs](https://thegraph.com/explorer) +→ [Build Your Subgraph](/subgraphs/quick-start) From cb005be6b518f5a9c58c70d5cefa78063efa37b7 Mon Sep 17 00:00:00 2001 From: Michael Macaulay Date: Thu, 1 May 2025 15:53:38 -0400 Subject: [PATCH 3/4] Final tweaks --- website/src/pages/en/about.mdx | 10 +++++----- 1 file changed, 5 insertions(+), 5 deletions(-) diff --git a/website/src/pages/en/about.mdx b/website/src/pages/en/about.mdx index 4f83fb6f094f..1506e858358a 100644 --- a/website/src/pages/en/about.mdx +++ b/website/src/pages/en/about.mdx @@ -27,14 +27,14 @@ Find the perfect data service for you: ### 1. Custom Real-Time Data Streams **Use Case:** High-frequency trading, live analytics -→ [Build Substreams](/substreams/introduction/) -→ [Browse Community Modules](https://substreams.dev/) +- [Build Substreams](/substreams/introduction/) +- [Browse Community Substreams](https://substreams.dev/) ### 2. Instant Token Data **Use Case:** Wallet balances, liquidity pools, transfer events -→ [Start with Token API](/token-api/quick-start/) +- [Start with Token API](/token-api/quick-start/) ### 3. Flexible Historical Queries **Use Case:** Dapp frontends, custom analytics -→ [Explore Subgraphs](https://thegraph.com/explorer) -→ [Build Your Subgraph](/subgraphs/quick-start) +- [Explore Subgraphs](https://thegraph.com/explorer) +- [Build Your Subgraph](/subgraphs/quick-start) From 94be42d796c67dac1a32513c1b817b9951c97dbe Mon Sep 17 00:00:00 2001 From: Michael Macaulay Date: Thu, 1 May 2025 16:03:41 -0400 Subject: [PATCH 4/4] Styling --- website/src/pages/en/about.mdx | 14 ++++++++++---- 1 file changed, 10 insertions(+), 4 deletions(-) diff --git a/website/src/pages/en/about.mdx b/website/src/pages/en/about.mdx index 1506e858358a..7fda868aab9d 100644 --- a/website/src/pages/en/about.mdx +++ b/website/src/pages/en/about.mdx @@ -21,20 +21,26 @@ The result is slow performance, complex infrastructure, and scalability issues. ## How The Graph Solves This -The Graph uses a combination of cutting-edge research, core dev expertise, and independent Indexers to make blockchain data accessible for developers. +The Graph uses a combination of cutting-edge research, core dev expertise, and independent Indexers to make blockchain data accessible for developers. Find the perfect data service for you: ### 1. Custom Real-Time Data Streams -**Use Case:** High-frequency trading, live analytics + +**Use Case:** High-frequency trading, live analytics. + - [Build Substreams](/substreams/introduction/) - [Browse Community Substreams](https://substreams.dev/) ### 2. Instant Token Data -**Use Case:** Wallet balances, liquidity pools, transfer events + +**Use Case:** Wallet balances, liquidity pools, transfer events. + - [Start with Token API](/token-api/quick-start/) ### 3. Flexible Historical Queries -**Use Case:** Dapp frontends, custom analytics + +**Use Case:** Dapp frontends, custom analytics. + - [Explore Subgraphs](https://thegraph.com/explorer) - [Build Your Subgraph](/subgraphs/quick-start)