Hackathon Resources

The Graph is the core indexing and query layer of web3. The Graph aims to empower the next generation of dapp developers by providing quick access to blockchain data, enabling them to deliver an enhanced and superior user experience.

Table of Contents

1. Supported Networks
2. Hackathon Comms
3. The Graph’s Prize Information
4. How to Build a New Subgraph
5. How to Use Existing Subgraphs on The Graph Explorer
6. How to Build Substreams-powered Subgraphs
7. Get Involved

Supported Networks

These are the networks that The Graph currently indexes.

Hackathon Comms

Helpful ways to support your hackathon experience with The Graph.

• Hackathon Support Team
• The Graph Discord
• The GraphDevs Twitter
• The Graph Builders Newsletter

The Graph’s Prize Information

Best Use of The Graph: Build with new or existing subgraphs/substreams to power your hackathon project!

Project Requirements

1. Link to the deployed subgraph(s)/substream(s)
2. Link to the source code
3. The project should be using data indexed and queried using the subgraph(s)/substream(s)

Judging Criteria

1. Technical Implementation: Evaluate the effective use of The Graph protocol, focusing on how well the subgraph gathers and presents data, and the team’s understanding of its technical aspects.
2. Design: Assess the quality of the dapp’s UI/UX, including aesthetics, usability, and overall user experience.
3. Idea Quality: Judge the project’s novelty, relevance, and ability to address meaningful problems in the blockchain space.
4. Ecosystem Impact: Consider the project’s potential benefits to its users, community, and the broader decentralized ecosystem.
5. Sustainability: Review the clarity of documentation, roadmap, and the project’s long-term viability.
6. Vision Alignment: Ensure the project aligns with decentralization principles and the ethos of an open digital ecosystem.

How to Build a New Subgraph

Subgraphs index smart contract events. Learn to build a custom subgraph with these resources.

[Documentation] Subgraph Quick Start

• https://thegraph.com/docs/en/quick-start/

[Documentation] Detailed Breakdown of Creating a Subgraph

• https://thegraph.com/docs/en/developing/creating-a-subgraph/

[Video] How to Deploy a Subgraph (12min)

• https://www.youtube.com/watch?v=nGIFuC69bSA

[Blog] Build a dApp quick with The Graph and Scaffold-ETH-2 (≈ 20min small project)

• https://mirror.xyz/cryptomastery.eth/uGHEHnskoVwX-mWjAiidXfGt6QowCoKl_yX4okwZc0E

[Video] Build a Full Stack Dapp (1hr 37min)

• https://www.youtube.com/live/Gspa3YL6Rqk?si=sS3xaxjoW8H73CJW
• https://github.com/kmjones1979/full-stack-dapp-workshop

[Video] Quick bootstrap a Fullstack Dapp Subgraph

• https://www.youtube.com/watch?v=obOEMAZ-05s

[Blog] How to Index Factory Pattern Smart Contracts

• https://thegraph.com/blog/data-source-templates/

[Repos] Example Subgraphs

• https://github.com/graphprotocol/graph-tooling/tree/main/examples

[Optimizations] Subgraph Best Practices

1. https://thegraph.com/docs/en/cookbook/pruning/
2. https://thegraph.com/docs/en/cookbook/derivedfrom/
3. https://thegraph.com/docs/en/cookbook/immutable-entities-bytes-as-ids/
4. https://thegraph.com/docs/en/cookbook/avoid-eth-calls/
5. https://thegraph.com/docs/en/subgraphs/cookbook/timeseries/
6. https://thegraph.com/docs/en/subgraphs/cookbook/grafting-hotfix/

How to Use Existing Subgraphs on The Graph Explorer

Subgraphs are already production-ready, decentralized, and publicly available on The Graph Explorer. Build your hackathon project on top of these powerful subgraphs, then query them with your 100k monthly free queries.

[Video] Querying Web3 Data With The Graph (20min)

• https://www.youtube.com/watch?v=ZysliItQaho
  • https://github.com/marcusrein/Subgraph-Query-Workshop-2023
  • https://docs.google.com/presentation/d/1U64NOtOCXJEi9J3jmM0DhpuozgZg-eXoGE8KCZ2cczQ/edit?usp=sharing

[Tooling] Messari Subgraphs

These subgraphs have standardized schemas, making it possible to query many subgraphs at once with the same query using graph-client, the querying library built specifically to query subgraphs. Ensure the Messari subgraphs you desire to query have the same schema and the schema has near-identical versioning.

• https://subgraphs.messari.io/
• https://github.com/messari/subgraphs/tree/master

[Tutorial] Query Multiple Subgraphs with Graph-Client (≈30min small project)

• https://github.com/schmidsi/subgraph-composition

[Documentation] GraphQL Querying Best Practices

• https://thegraph.com/docs/en/querying/querying-best-practices/

How to Build Substreams-Powered Subgraphs

Substreams index raw blockchain data (events, internal transactions, mempool data… all of it!) from EVM and non-EVM chains such as Solana. A Substreams has the option to sink its data into a subgraph, making it a Substreams-powered subgraph. It can also sink into other locations such as a SQL database. A Substreams-powered subgraph takes advantage of the granularity of indexing possible with Substreams as well as the standardization and decentralization pipeline provided by subgraphs. Learn how to build a custom Substreams-powered subgraph with these resources.

[Documentation] Substreams Quickstart

• https://docs.substreams.dev/getting-started

[Video] How to Deploy a Substreams-powered Subgraph

• https://youtu.be/RmKi-Nq9E_A?feature=shared
  • https://github.com/streamingfast/substreams-starter

[Tooling] Substreams.dev Pre-built Modules

• https://substreams.dev/

[Documentation] Read More About Substreams-powered subgraphs

• https://thegraph.com/blog/substreams-powered-subgraphs/

Get Involved

Jobs in The Graph ecosystem

• https://thegraph.com/jobs/

The Graph Developer Survey

• https://thegraph.deform.cc/developer-survey/

About The Graph

The Graph is the leading indexing and query protocol powering the decentralized internet. Launched in 2018, it has enabled tens of thousands of developers to effortlessly build Subgraphs and Substreams across countless blockchains, including Ethereum, Solana, Arbitrum, Optimism, Base, Polygon, Celo, Soneium, and Avalanche.

Discover more about how The Graph is shaping the future of decentralized physical infrastructure networks (DePIN) and stay connected with the community. Follow The Graph on X, LinkedIn, Instagram, Facebook, Reddit, Farcaster and Medium. Join the community on The Graph’s Telegram, join technical discussions on The Graph’s Discord.

The Graph Foundation oversees The Graph Network. Edge & Node, StreamingFast, Semiotic Labs, Messari, GraphOps, Pinax Wonderland and Geo are seven of the many organizations within The Graph ecosystem.