GIP-0084: Chain Deprecation Process

GIP: 0084
Title: Chain Deprecation Process
Authors: Kate Foust-Pakalniskis, Ørjan Austead, Andrew Clews
Created: May 9, 2025
Updated: June 16, 2025
Stage: Draft

Abstract

This Graph Improvement Proposal (GIP) outlines a governance-driven framework for deprecating indexing rewards on The Graph Network. Rewards issuance will be discontinued for blockchain networks that no longer demonstrate sustained utility, as evidenced by consistent query volume and ongoing developer activity. This proposal defines objective criteria and procedural steps for evaluating and deprecating underutilized chains.


Motivation

As The Graph Network now facilitates billions of queries monthly and increasingly underpins critical web3 infrastructure, its reward mechanisms must evolve to reflect this operational maturity.

Indexing rewards should be allocated exclusively to chains with demonstrable and sustained adoption. Prioritizing highly active chains ensures that indexer resources are directed toward data of greatest utility and that the protocol efficiently incentivizes impactful participation.

This GIP introduces a systematic approach for monitoring chain adoption post-integration and defines conditions under which rewards may be removed from chains failing to meet minimum adoption thresholds.


High-Level Description

Chain deprecation will follow a structured three-stage process:

  1. Initial Period: Following integration via GIP-0057 and activation of indexing rewards, each chain enters an initial monitoring phase lasting several months.
  2. Quarterly Assessment: Post-initial period, chains undergo quarterly evaluations based on metrics such as query volume and developer activity to assess continued eligibility for rewards.
  3. Governance Review and Action: Chains failing to meet established benchmarks will be reviewed and a governance vote by the Council to determine reward deprecation.


Stage 1: Initial Period

  • Trigger: Completion of the Chain Integration Process (CIP) as defined in GIP-0057, followed by activation of indexing rewards.
  • Duration: Minimum of 3 months (configurable based on Council discretion).
  • Purpose: Provides a grace period for chains to gain adoption and demonstrate early indicators of network demand before formal evaluation begins.
  • No Evaluation Conducted: Chains in this stage are excluded from deprecation assessments.

Stage 2: Quarterly Evaluation Phase

  • Trigger: Conclusion of the initial period.
  • Frequency: Evaluations occur on a fixed quarterly cadence.
  • Evaluation Criteria:
    • Query Volume: Sustained query volume
    • Developer Engagement: Metrics from ecosystem tooling (e.g., GitHub activity, forum engagement, subgraph upgrades).
    • Economic Signals: Signal, allocations, and query fees
  • Data Collection: Metrics are sourced from the Graph Network telemetry, Subgraph Studio, Graph Explorer, and community tools.

Chains meeting or exceeding the established thresholds retain eligibility for rewards. Chains falling below thresholds proceed to Stage 3.

Stage 3: Eligibility Review & Governance Process

  • Preparation of CDP (Chain Deprecation Process) Report: A formal report listing underperforming chains is prepared:
    • Raw and aggregated data for each evaluation criterion
    • Historical performance trends
    • Contextual analysis (e.g., recent migrations, known outages)
  • Stakeholder Review: The chains included in the report will be shared with all integration stakeholders to ensure alignment and address potential outstanding considerations.
  • Council Review: The report is submitted to the Graph Council for deliberation and vote under the standard GGP.
  • Vote Outcome:
    • Approved: Indexing rewards for listed chains are set to be deprecated within 30 days of the vote
    • Rejected or Deferred: Chains retain rewards until the next evaluation cycle.
  • Chain & Community Review: Once the council has voted to approve rewards deprecation, the chain’s team, indexers, and subgraph developers will be given a 30-day notice of the change in status

Deprecation Implementation

  • Post-Approval & 30-Day Notice Actions:
    • Feature matrix is updated to reflect the removal of rewards issuance.
    • UI and documentation updates reflect deprecation status.

Requirements and Exit Criteria

Stage Requirements for Entry Exit Criteria
Stage 1: Initial Period Chain integrated via GIP-0057, Indexing rewards activated Minimum of 3 months elapsed since activation, Automatically transitions to Stage 2
Stage 2: Quarterly Evaluation Phase Completion of initial period, Inclusion in quarterly evaluation cycle Meets or exceeds evaluation thresholds → remain eligible, Falls below thresholds → Stage 3
Stage 3: Eligibility Review & Governance Process Chain flagged for underperformance in Stage 2, Report prepared Council vote: Approve → Rewards deprecated after 30-day grace period, Reject/Defer → Remains in evaluation

Key Evaluation Metrics (Used in Stage 2)

Metric Description
Query Volume Average number of queries served per month
Economic Activity Signal, allocations, and query fees
Developer Engagement On-chain or community activity from developers, dapp usage

Deprecation Triggers (Used in Stage 3)

  • One or more metrics consistently fall below thresholds for one or more consecutive evaluation periods
  • No mitigating context (e.g., effects on other key data sources, major objection from chain stakeholders, etc.)
  • Council votes to approve deprecation based on report findings
1 Like

Thanks for sharing this proposal Kate, I have a couple of questions I’d love to understand better:

  1. What is the rationale for enabling indexing rewards as part of the chain activation process, even in the absence of adoption or query volume? Wouldn’t including minimum usage or adoption metrics help align incentives more effectively?
  2. For Stage 2, could you clarify who is responsible for tracking and publishing the metrics used to evaluate the ongoing criteria? Will this be handled by InfraDAO, The Graph Foundation, or another stakeholder? Would be also worth considering keeping Indexers updated of these metrics at IOH.

Appreciate the work going into formalizing this process.

1 Like

Thanks so much for your feedback and questions @pilar !

  1. What is the rationale for enabling indexing rewards as part of the chain activation process, even in the absence of adoption or query volume? This GIP does not address that specific point, so thanks for highlighting it. @Andrew_Clews posted an update to GIP-0057: Chain Integration Process this past month that addresses this question. Going forward, indexing rewards will be prioritized for chains and projects that demonstrate clear, sustained usage through consistent query volume and active developer engagement. This means that we won’t advance chains to Full Protocol Support unless they clearly meet—and can sustain—the required standards. With aligned standards across all phases of our process, the initial grace period after rewards activation gives chains time to demonstrate long-term viability. From there, the GIP above ensures that chains continue to meet the required standards and provides the network with a clear path to take action if those standards are no longer upheld. I hope this answers your question!

  2. For Stage 2, could you clarify who is responsible for tracking and publishing the metrics used to evaluate the ongoing criteria? Will this be handled by InfraDAO, The Graph Foundation, or another stakeholder? Would be also worth considering keeping Indexers updated of these metrics at IOH. Yes, InfraDAO is handling the data gathering and reporting for this effort at this time. I agree, we can also keep indexers upated on this at IOH.

1 Like

Thank you very much for the answer!

1 Like