Skip to content

Commit 1c7108a

Browse files
committed
Update ELIGIBILITY_CRITERIA.md
1 parent adb1a16 commit 1c7108a

File tree

1 file changed

+34
-20
lines changed

1 file changed

+34
-20
lines changed

ELIGIBILITY_CRITERIA.md

Lines changed: 34 additions & 20 deletions
Original file line numberDiff line numberDiff line change
@@ -1,44 +1,58 @@
11

22
---
3+
34
# Upcoming Eligibility Criteria
45

56
**We will announce changes to the eligibility criteria in the table below.** Once the change goes live, it will be reflected in the `Active Eligibility Criteria` section of this document.
67

78
| Upcoming Requirement | Justification | Date Requirement Will Be Updated/Introduced (YYYY-MM-DD) |
89
|----------------------|---------------|----------------------------------------------------------|
9-
| **Example Requirement:** | This is a placeholder for future criteria. Watch this space to stay informed. We will also announce any upcoming requirements via our existing official channels. | `YYYY-MM-DD` |
10+
| **Example Requirement:** | This is a placeholder for future criteria. Watch this space to stay informed. We will also announce upcoming requirements via official channels. | `YYYY-MM-DD` |
1011

1112
> **Note**:
12-
> When announcing new eligibility criteria we will allow a window for indexers to prepare their infrastructure before any new/updated criteria goes live, refer to the `Date Requirement Will Be Updated/Introduced (YYYY-MM-DD)` column to see when an upcoming eligibility criterion will take effect. We will typically allow a 14-day window after announcing a change before it goes live.
13+
> We will typically allow a 14 day window after announcing a change before it goes live.
1314
1415
---
16+
1517
# Active Eligibility Criteria
1618

17-
The Service Quality Oracle determines which indexers are eligible to receive indexing rewards using a threshold rewards algorithm that operates by checking indexers meet the following criteria:
19+
The following criteria is used to identify indexers that should be eligible to receive indexing rewards.
1820

19-
1. **Indexers must be online for 5+ days in a given 28 day rolling period.**
20-
1. **To be online, an indexer must serve at least 1 qualifying query on 10 different subgraphs**
21-
1. **A qualifying query is one where:**
22-
1. **The query response HTTP status was 200 OK, indicating query success.**
23-
2. **The query response latency was <5,000 ms.**
24-
3. **The query was served <50,000 blocks behind chainhead.**
25-
4. **The subgraph had at least 500 GRT in curation signal at the time that the query was served.**
21+
- **Days Online Requirement:** Indexers must be online for **5+ days** in a given **28 day** rolling period for rewards eligibility.
22+
- **Daily Query Requirement:** To be online, an indexer must serve at least **1 qualifying query** on **10 different subgraphs**.
23+
- **Query Quality Requirements:** A qualifying query is one that simutanousely meets **all** of the following criteria:
24+
- Query Response HTTP Status: **200 OK**.
25+
- Query Response Latency: **< 5,000 ms**.
26+
- Query Freshness: **< 50,000 blocks** behind chainhead.
27+
- Subgraph Curation Signal: **500 GRT**.
2628

27-
All four qualifying query criteria must be satisfied simultaneously for a query to count towards the daily requirement.
28-
As above, the qualifying query criteria must be satisfied on 10+ subgraphs per day, for 5+ days in any given 28 day rolling window.
2929
Eligibility for indexing rewards is typically refreshed daily via the ServiceQualityOracle contract.
3030

3131
> **Note**:
32-
> * Once an indexer has successfully qualified for issuance by satisfying the above criteria, and a corresponding transaction has been placed on chain by an authorizde Oracle into the ServiceQualityOracle contract, the now eligible indexer can continue claiming indexing rewards from the protocol for the duration of the qualification period (default is 14 days), even if the issuance eligibility requirements change thereafter.
32+
> Once an indexer has successfully qualified for issuance by satisfying all of the above criteria, and a corresponding transaction has been submitted on chain by an authorized Oracle into the ServiceQualityOracle contract, the now eligible indexer can continue claiming indexing rewards from the protocol for the duration of the qualification period (default is 14 days), even if issuance eligibility requirements change.
3333
3434
---
3535

36+
# Eligibility Requirements Changelog
37+
38+
This table tracks changes to eligibility requirements over time.
3639

37-
#### Below is a table showing Justification, date and notes for the above eligibility criteria
40+
| Requirement Category | Requirement Details | Effective Date (YYYY-MM-DD) | Change Type | Justification | Notes |
41+
|----------------------|---------------------|-----------------------------|-------------|---------------|-------|
42+
| **Days Online** | Indexers must be online for **5+ days** in a given **28 day** rolling period for rewards eligibility. | TBD | Initial | Encourages indexers familiarize themselves with infrastructure maintainance and ongoing operations. | Planned for Service Quality Oracle launch |
43+
| **Daily Query Requirement** | Must serve **≥1 qualifying query** on **≥10 different subgraphs** per day for a day to count towards the online requirement. | TBD | Initial | Encourages indexers to become familiar with the process of syncing a range of subgraphs. | Planned for Service Quality Oracle launch |
44+
| **Query Quality Requirements** | ** Query Response HTTP Status: **200 OK**<br>** Query Response Latency: **< 5,000 ms**<br>** Query Freshness: **< 50,000 blocks** behind chainhead.<br>** Subgraph Curation Signal: **≥ 500 GRT**. | TBD | Initial | ** Indexer infrastructure needs to serve successful queries to benefit data consumers.<br>** Fast query responses are important to data consumers.<br>** Encourages indexers to sync to chainhead.<br>** Creates a barrier against gaming eligibility requirements. | Planned for Service Quality Oracle launch |
45+
46+
---
3847

39-
| Requirement | Justification | Date That Requirement Was Last Updated/Introduced (YYYY-MM-DD) | Notes |
40-
|-------------|---------------|----------------------------------------------------------------|-------|
41-
| **Query Status:** The query must have a `200 OK` HTTP response status indicating query success | Indexer infrastructure needs to be capable of serving successful queries to benefit data consumers. | TBD | This requirement is planned to be introduced at launch of the Service Quality Oracle |
42-
| **Query Latency:** The query response must be delivered to the gateway in `< 5,000 ms` | Fast query responses are important to data consumers. | TBD | This requirement is planned to be introduced at launch of the Service Quality Oracle |
43-
| **Query Freshness:** The query must be served from a subgraph that is `< 50,000 blocks` behind chainhead | Data needs to be fresh to be useful to data consumers. | TBD | This requirement is planned to be introduced at launch of the Service Quality Oracle |
44-
| **Subgraph Signal:** The subgraph needs to have `≥ 500 GRT` in curation signal at the time when the query was served. | Indexers are encouraged to serve data on subgraphs that have curation signal. This also creates an economic barrier against those that prefer to game the system. | TBD | This requirement is planned to be introduced at launch of the Service Quality Oracle |
48+
# Future Example Changes
49+
50+
The following are examples of how future changes would be recorded in the changelog above:
51+
52+
| Requirement Category | Requirement Details | Effective Date (YYYY-MM-DD) | Change Type | Justification | Notes |
53+
|----------------------|---------------------|------------------------------|------------|---------------|-------|
54+
| **Days Online** | Must be online for **10+ days** in a **28 day** rolling period | YYYY-MM-DD | Updated | Increase reliability requirements based on network maturity | Increased from 5+ days |
55+
| **Query Latency** | Query response latency must be **< 1,000 ms** | YYYY-MM-DD | Updated | Improve user experience with faster responses | Tightened from < 5,000 ms |
56+
| **Indexer Stake** | Indexer must have **≥ 100,000 GRT** staked | YYYY-MM-DD | New | Ensure indexers have skin in the game for quality service | New requirement added |
57+
58+
---

0 commit comments

Comments
 (0)