Chain Integration Process Overview
Reading time: 3 min
A transparent and governance-based integration process was designed for blockchain teams seeking . It is a 3-phase process, as summarised below.
- Teams work on a Graph Node integration and Firehose for non-EVM based chains. .
- Teams initiate the protocol integration process by creating a Forum thread (New Data Sources sub-category under Governance & GIPs). Using the default Forum template is mandatory.
- Teams collaborate with core developers, Graph Foundation and operators of GUIs and network gateways, such as , to ensure a smooth integration process. This involves providing the necessary backend infrastructure, such as the integrating chain's JSON RPC or Firehose endpoints. Teams wanting to avoid self-hosting such infrastructure can leverage The Graph's community of node operators (Indexers) to do so, which the Foundation can help with.
- Graph Indexers test the integration on The Graph's testnet.
- Core developers and Indexers monitor stability, performance, and data determinism.
- Teams propose mainnet integration by submitting a Graph Improvement Proposal (GIP) and initiating a pull request (PR) on the (more details on the link).
- The Graph Council reviews the request and approves mainnet support, providing a successful Stage 2 and positive community feedback.
If the process looks daunting, don't worry! The Graph Foundation is committed to supporting integrators by fostering collaboration, offering essential information, and guiding them through various stages, including navigating governance processes such as Graph Improvement Proposals (GIPs) and pull requests. If you have questions, please reach out to or through Discord (either Pedro, The Graph Foundation member, IndexerDAO, or other core developers).
Ready to shape the future of The Graph Network? now and be a part of the web3 revolution!
This process is related to the Subgraph Data Service, applicable only to new Subgraph Data Sources.
This would only impact protocol support for indexing rewards on Substreams-powered subgraphs. The new Firehose implementation would need testing on testnet, following the methodology outlined for Stage 2 in this GIP. Similarly, assuming the implementation is performant and reliable, a PR on the would be required (Substreams data sources Subgraph Feature), as well as a new GIP for protocol support for indexing rewards. Anyone can create the PR and GIP; the Foundation would help with Council approval.
The time to mainnet is expected to be several weeks, varying based on the time of integration development, whether additional research is required, testing and bug fixes, and, as always, the timing of the governance process that requires community feedback.
Protocol support for indexing rewards depends on the stakeholders' bandwidth to proceed with testing, feedback gathering, and handling contributions to the core codebase, if applicable. This is directly tied to the integration's maturity and how responsive the integration team is (who may or may not be the team behind the RPC/Firehose implementation). The Foundation is here to help support throughout the whole process.
Similar to #3, it will depend on overall readiness and involved stakeholders' bandwidth. For example, a new chain with a brand new Firehose implementation may take longer than integrations that have already been battle-tested or are farther along in the governance process. This is especially true for chains previously supported on the or those relying on already tested stacks.