Skip to content

Commit c5e7cba

Browse files
authored
GIP 0084: Chain Deprecation Process (#76)
* Create 0084.md Added first draft of GIP 0084 * Update 0084.md edited top description formatting * GIP 0084 * Rename Deprecation GIP (6).png to deprecation_gip.png * Update 0084.md Fix image link
1 parent d29b9ec commit c5e7cba

File tree

2 files changed

+96
-0
lines changed

2 files changed

+96
-0
lines changed

assets/deprecation_gip.png

171 KB
Loading

gips/0084.md

Lines changed: 96 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,96 @@
1+
---
2+
GIP: "0084"
3+
Title: Chain Deprecation
4+
Authors: Ørjan Austead, Andrew Clews, Kate Foust-Pakalniskis
5+
Created: May 9, 2025
6+
Updated: June 16, 2024
7+
Stage: Draft
8+
---
9+
10+
# Abstract
11+
12+
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.
13+
14+
---
15+
16+
# Motivation
17+
18+
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.
19+
20+
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.
21+
22+
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.
23+
24+
---
25+
26+
# High-Level Description
27+
28+
Chain deprecation will follow a structured three-stage process:
29+
30+
1. **Initial Period**: Following integration via [GIP-0057](https://forum.thegraph.com/t/gip-0057-chain-integration-process/4468) and activation of indexing rewards, each chain enters an initial monitoring phase lasting several months.
31+
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.
32+
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.
33+
34+
![Deprecation GIP](/assets/deprecation_gip.png)
35+
36+
## **Stage 1: Initial Period**
37+
38+
- **Trigger:** Completion of the Chain Integration Process (CIP) as defined in [GIP-0057](https://forum.thegraph.com/t/gip-0057-chain-integration-process/4468), followed by activation of indexing rewards.
39+
- **Duration:** Minimum of 3 months (configurable based on Council discretion).
40+
- **Purpose:** Provides a grace period for chains to gain adoption and demonstrate early indicators of network demand before formal evaluation begins.
41+
- **No Evaluation Conducted:** Chains in this stage are excluded from deprecation assessments.
42+
43+
## **Stage 2: Quarterly Evaluation Phase**
44+
45+
- **Trigger:** Conclusion of the initial period.
46+
- **Frequency:** Evaluations occur on a fixed quarterly cadence.
47+
- **Evaluation Criteria:**
48+
- **Query Volume:** Sustained query volume
49+
- **Developer Engagement:** Metrics from ecosystem tooling (e.g., GitHub activity, forum engagement, subgraph upgrades).
50+
- **Economic Signals:** Signal, allocations, and query fees
51+
- **Data Collection:** Metrics are sourced from the Graph Network telemetry, Subgraph Studio, Graph Explorer, and community tools.
52+
53+
Chains meeting or exceeding the established thresholds retain eligibility for rewards. Chains falling below thresholds proceed to Stage 3.
54+
55+
## **Stage 3: Eligibility Review & Governance Process**
56+
57+
- **Preparation of CDP (Chain Deprecation Process) Report:** A formal report listing underperforming chains is prepared:
58+
- Raw and aggregated data for each evaluation criterion
59+
- Historical performance trends
60+
- Contextual analysis (e.g., recent migrations, known outages)
61+
- **Stakeholder Review:** The chains included in the report will be shared with all integration stakeholders to ensure alignment and address potential outstanding considerations.
62+
- **Council Review:** The report is submitted to the Graph Council for deliberation and vote under the standard GGP.
63+
- **Vote Outcome:**
64+
- **Approved:** Indexing rewards for listed chains are set to be deprecated within 30 days of the vote
65+
- **Rejected or Deferred:** Chains retain rewards until the next evaluation cycle.
66+
- **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
67+
68+
### **Deprecation Implementation**
69+
70+
- **Post-Approval & 30-Day Notice Actions:**
71+
- Feature matrix is updated to reflect the removal of rewards issuance.
72+
- UI and documentation updates reflect deprecation status.
73+
74+
---
75+
76+
## Requirements and Exit Criteria
77+
78+
| **Stage** | **Requirements for Entry** | **Exit Criteria** |
79+
| --- | --- | --- |
80+
| **Stage 1: Initial Period** | Chain integrated via GIP-0057, Indexing rewards activated | Minimum of 3 months elapsed since activation, Automatically transitions to Stage 2 |
81+
| **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** |
82+
| **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 |
83+
84+
## **Key Evaluation Metrics (Used in Stage 2)**
85+
86+
| **Metric** | **Description** |
87+
| --- | --- |
88+
| **Query Volume** | Average number of queries served per month |
89+
| **Economic Activity** | Signal, allocations, and query fees |
90+
| **Developer Engagement** | On-chain or community activity from developers, dapp usage |
91+
92+
## **Deprecation Triggers (Used in Stage 3)**
93+
94+
- One or more metrics consistently fall below thresholds for one or more consecutive evaluation periods
95+
- No mitigating context (e.g., effects on other key data sources, major objection from chain stakeholders, etc.)
96+
- Council votes to approve deprecation based on report findings

0 commit comments

Comments
 (0)