/subgraphs

Standardized subgraphs for blockchain data

Primary LanguageTypeScriptMIT LicenseMIT

Messari Standard Subgraphs • GitHub license PRs Welcome Issues Report

Messari Logo

Messari subgraphs set an industry leading standard for on chain data 🚀

Utilizing The Graph these subgraphs extract raw blockchain data and transform it into meaningful metrics, for products and analytics.

We aim to make sense of DEFI protocols in an open, holistic approach capturing every piece of data from a given protocol type.

Protocol types supported: Lending, CDP, DEX, Yield Aggregator, NFT Marketplace, Network, Bridge, Perpetual Futures, Options, Governance

If you are a protocol and want to collaborate please visit messari.io/web3-data-collaboration

Working Environment

Go to docs/SETUP.md to learn how to setup your machine for Messari subgraph development.

Learn the Project

It is important to familiarize yourself with the project structure and tooling to build efficiently. Go to docs/STRUCTURE.md and docs/TOOLING.md to learn more.

  • Familiarize yourself with our schemas labeled schema-{protocol type}.graphql. Read more details in docs/SCHEMA.md
  • We update our schemas as necessary. You can find out about each upgrade in docs/CHANGES.md
  • To learn about Messari standard methodologies see docs/METHODOLOGY.md

Becoming a Subgraph Developer

Becoming a good subgraph developer will take patience and practice. The following resources are for developers of all skill levels to learn the ins and outs of subgraph development. 👾

  • For a full walkthrough of our subgraph development process visit docs/WALKTHROUGH.md.
  • Resources for development of varying levels can be found in docs/RESOURCES.md.
  • To learn about common errors, best error handling practices, and debugging see docs/ERRORS.md
  • Subgraph performance is also a concern. Learn about indexing / querying performance by reading docs/PERFORMANCE
  • Learn about retrieving prices in subgraphs and how to handle this in docs/ORACLES.md

Contributing Guidelines

We welcome contributions from the community! You can point out or fix bugs, suggest changes, add new features, or add new subgraphs. ✅

  • For bugs, features, or change requests please submit an issue following our guide.
  • General contribution guidelines and practices will be found in docs/CONTRIBUTING.md

Development Status

You can find a visualizer with the status of all Messari subgraphs at subgraphs.xyz! The code lives under ./dashboard.

You can see our subgraphs supporting the data for our product "Protocol Metrics"

Quick note: the raw deployment status of all subgraphs lives in ./deployment/deployment.json