Skip to content

Commit fc48a89

Browse files
committed
Update ELIGIBILITY_CRITERIA.md
1 parent d1c85cd commit fc48a89

File tree

1 file changed

+33
-31
lines changed

1 file changed

+33
-31
lines changed

ELIGIBILITY_CRITERIA.md

Lines changed: 33 additions & 31 deletions
Original file line numberDiff line numberDiff line change
@@ -1,42 +1,44 @@
1+
2+
---
13
# Upcoming Eligibility Criteria
24

3-
We will announce changes to the eligibility criteria in the table below. Once the change goes live then it will be reflected in the eligibility criteria section of this document.
5+
**We will announce changes to the eligibility criteria in the table below.** Once the change goes live then it will be reflected in the `Indexing Rewards Eligibility Criteria` section of this document.
46

5-
| Upcoming Requirement | Justification | Date Updated/Introduced (YYYY-MM-DD)|
6-
|----------------------|---------------|-------------------------------------|
7-
| **Requirement 1:** | 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 |
7+
| Upcoming Requirement | Justification | Date This Eligibility Requirement Will Be Updated/Introduced (YYYY-MM-DD) |
8+
|----------------------|---------------|---------------------------------------------------------------------------|
9+
| **Requirement 1:** | 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` |
810

911
> **Note**:
10-
>
11-
> 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 Updated/Introduced (YYYY-MM-DD)` column to see when upcoming eligibility criteria will merge.
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 This Eligibility Requirement Will Be Updated/Introduced (YYYY-MM-DD)` column to see when upcoming eligibility criteria will merge. We would typically allow a 14 day window after announcing a change before it goes live.
1213
13-
# Eligibility Criteria
14+
---
15+
# The Indexing Rewards Eligibility Criteria:
1416

1517
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:
1618

17-
1. Indexers must be online for 5+ days in a given 28 day rolling period.
18-
1. To be online an indexer must serve at least 1 qualifying query on 10 different subgraphs
19-
1. A qualifying query is one where:
20-
1. The query response HTTP status was 200 OK, indicating query success.
21-
2. The query response latency was <5,000 ms.
22-
3. The query was served <50,000 blocks behind chainhead.
23-
4. The subgraph had at least 500 GRT in curation signal at the time that the query was served.
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.**
26+
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.
29+
Eligibility for indexing rewards is typically refreshed daily via the ServiceQualityOracle contract.
2430

2531
> **Note**:
26-
>
27-
> All four quality criteria must be satisfied simultaneously for a query to count towards the daily requirement.
28-
>
29-
> The above query criteria must be satisfied on 10+ subgraphs per day, for 5+ days in any given 28 day rolling window.
30-
>
31-
> Issuance eligibility is refreshed daily via the ServiceQualityOracle contract.
32-
>
33-
> Once an indexer has qualified for issuance via the ServiceQualityOracle contract, they can claim indexing rewards from the protocol for the duration of the qualification period (default is 14 days), even if the requirements change.
34-
35-
36-
37-
| Requirement | Justification | Date Updated/Introduced (YYYY-MM-DD)|
38-
|-------------|---------------|-------------------------------------|
39-
| **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 (at genesis of the SQO) |
40-
| **Query Latency:** The query response must be delivered to the gateway in `< 5,000 ms` | Fast query responses are important to data consumers. | TBD (at genesis of the SQO) |
41-
| **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 (at genesis of the SQO) |
42-
| **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 (at genesis of the SQO) |
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.
33+
34+
---
35+
36+
37+
#### Below is a table showing Justification, date and notes for the above eligibility criteria
38+
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 |

0 commit comments

Comments
 (0)