Chain Integration Process Overview

Прозрачный и основанный на управлении процесс интеграции был разработан для команд блокчейнов, стремящихся к [интеграции с протоколом The Graph] (https://forum.thegraph.com/t/gip-0057-chain-integration-process/4468⁠). Это трехэтапный процесс, как описано ниже.

Stage 1. Technical Integration

Информацию о поддержке graph-node для новых чейнов см. на странице Интеграция новых чейнов.
Teams initiate the protocol integration process by creating a Forum thread here⁠ (New Data Sources sub-category under Governance & GIPs). Using the default Forum template is mandatory.

Stage 2. Integration Validation

Команды сотрудничают с разработчиками ядра, Graph Foundation и операторами графических интерфейсов и сетевых шлюзов, такими как Subgraph Studio, чтобы обеспечить плавный процесс интеграции. Это предполагает предоставление необходимой серверной инфраструктуры, такой как конечные точки JSON-RPC, Firehose или Substreams, интегрирующей чейны. Команды, желающие избежать самостоятельного размещения такой инфраструктуры, могут использовать для этого сообщество операторов нод (индексаторов) The Graph, в чем может помочь Foundation.
Graph Indexers test the integration on The Graph’s testnet.
Core developers and Indexers monitor stability, performance, and data determinism.

Stage 3. Mainnet Integration

Teams propose mainnet integration by submitting a Graph Improvement Proposal (GIP) and initiating a pull request (PR) on the feature support matrix⁠ (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 [email protected]⁠ or through Discord (either Pedro, The Graph Foundation member, IndexerDAO, or other core developers).

Ready to shape the future of The Graph Network? Start your proposal⁠ now and be a part of the web3 revolution!

Frequently Asked Questions

1. How does this relate to the World of Data Services GIP⁠?

This process is related to the Subgraph Data Service, applicable only to new Subgraph Data Sources.

2. What happens if Firehose & Substreams support comes after the network is supported on mainnet?

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 Feature Support Matrix⁠ 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.

3. Сколько времени займет процесс достижения полной поддержки протокола?

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.

4. How will priorities be handled?

Подобно пункту #3, это будет зависеть от общей готовности и пропускной способности заинтересованных сторон. Например, новый чейн с совершенно новой реализацией Firehose может занять больше времени, чем интеграции, которые уже прошли испытания или находятся на более поздней стадии процесса управления.