Skip to content

Commit 5154ab1

Browse files
Merge branch 'main' into Subgraph-MCP
2 parents 2521141 + bafc80e commit 5154ab1

26 files changed

+130
-26
lines changed

website/src/pages/ar/supported-networks.mdx

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -10,7 +10,7 @@ import { useI18n } from '@/i18n'
1010

1111
export const getStaticProps = getSupportedNetworksStaticProps
1212

13-
<Heading.H2 id="supported-networks" className="mb-4 text-24 text-white">
13+
<Heading.H2 id="supported-networks" className="mb-4">
1414
{useI18n().t('index.supportedNetworks.title')}
1515
</Heading.H2>
1616

website/src/pages/cs/supported-networks.mdx

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -10,7 +10,7 @@ import { useI18n } from '@/i18n'
1010

1111
export const getStaticProps = getSupportedNetworksStaticProps
1212

13-
<Heading.H2 id="supported-networks" className="mb-4 text-24 text-white">
13+
<Heading.H2 id="supported-networks" className="mb-4">
1414
{useI18n().t('index.supportedNetworks.title')}
1515
</Heading.H2>
1616

website/src/pages/de/supported-networks.mdx

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -10,7 +10,7 @@ import { useI18n } from '@/i18n'
1010

1111
export const getStaticProps = getSupportedNetworksStaticProps
1212

13-
<Heading.H2 id="supported-networks" className="mb-4 text-24 text-white">
13+
<Heading.H2 id="supported-networks" className="mb-4">
1414
{useI18n().t('index.supportedNetworks.title')}
1515
</Heading.H2>
1616

website/src/pages/en/subgraphs/_meta.js

Lines changed: 4 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -6,7 +6,8 @@ export default {
66
querying: titles.querying ?? '',
77
developing: titles.developing ?? '',
88
billing: '',
9-
mcp: titles.mcp ?? '',
10-
guides: titles.guides ?? '',
11-
'best-practices': titles['best-practices'] ?? '',
9+
guides: titles.guides,
10+
'best-practices': titles['best-practices'],
11+
'fair-use-policy': '',
12+
'upgrade-indexer': '',
1213
}
Lines changed: 51 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,51 @@
1+
---
2+
title: Fair Use Policy
3+
---
4+
5+
> Effective Date: May 15, 2025
6+
7+
## Overview
8+
9+
This outlines storage limits for Subgraphs that rely solely on [Edge & Node's Upgrade Indexer](/subgraphs/upgrade-indexer/). This policy is designed to ensure fair and optimized use of queries across the community.
10+
11+
To maintain performance and reliability across its infrastructure, Edge & Node is updating its Upgrade Indexer Subgraph storage policy. Free usage tiers remain available, but users who exceed specified limits will need to upgrade to a paid plan. Storage allocations and thresholds vary by feature.
12+
13+
### 1. Scope
14+
15+
This policy applies to all individual users, teams, chains, and dapps using Edge & Node's Upgrade Indexer in Subgraph Studio for storage and queries.
16+
17+
### 2. Fair Use Storage Limits
18+
19+
**Free Storage: Up to 10 GB**
20+
21+
Beyond that, pricing is variable and adjusts based on usage patterns, network conditions, infrastructure requirements, and specific use cases.
22+
23+
Reach out to Edge & Node at [[email protected]](mailto:[email protected]) to discuss options that meet your technical needs.
24+
25+
You can monitor your usage via [Subgraph Studio](https://thegraph.com/studio/).
26+
27+
### 3. Fair Use Limits
28+
29+
To preserve the stability of Edge & Node's Subgraph Studio and preserve the reliability of The Graph Network, the Edge & Node Support Team will monitor storage usage and take corresponding action with Subgraphs that have:
30+
31+
- Abnormally high or sustained bandwidth or storage usage beyond posted limits
32+
- Circumvention of storage thresholds (e.g., use of multiple free-tier accounts)
33+
34+
The Edge & Node Support Team reserves the right to revise storage limits or impose temporary constraints for operational integrity.
35+
36+
If you exceed your included storage:
37+
38+
- Try [pruning Subgraph data](/subgraphs/best-practices/pruning/) to remove unused entities and help stay within storage limits
39+
- [Add signal to the Subgraph](/subgraphs/developing/publishing/publishing-a-subgraph/#adding-signal-to-your-subgraph) to encourage other Indexers on the network to serve it
40+
- You will receive multiple notifications and email alerts
41+
- A grace period of 14 days will be provided to upgrade or reduce storage
42+
43+
Edge & Node's team is committed to helping users avoid unnecessary interruptions and will continue to support all web3 builders.
44+
45+
### 4. Subgraph Data Retention
46+
47+
Subgraphs inactive for over 14 days or Subgraphs that exceed free-tier storage limits will be subject to automatic data archival or deletion. Edge & Node's team will notify you before any such actions are taken.
48+
49+
### 5. Support
50+
51+
If you believe your usage is incorrectly flagged or have unique use cases (e.g. approved special request pending new Subgraph upgrade plan), reach out the Edge & Node team at [[email protected]](mailto:[email protected]).

website/src/pages/en/subgraphs/querying/subgraph-id-vs-deployment-id.mdx

Lines changed: 28 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -2,11 +2,15 @@
22
title: Subgraph ID vs Deployment ID
33
---
44

5+
Managing and accessing Subgraphs relies on two distinct identification systems: Subgraph IDs and Deployment IDs.
6+
57
A Subgraph is identified by a Subgraph ID, and each version of the Subgraph is identified by a Deployment ID.
68

79
When querying a Subgraph, either ID can be used, though it is generally suggested that the Deployment ID is used due to its ability to specify a specific version of a Subgraph.
810

9-
Here are some key differences between the two IDs: ![](/img/subgraph-id-vs-deployment-id.png)
11+
Both identifiers are accessible in [Subgraph Studio](https://thegraph.com/studio/):
12+
13+
![Highlights of where to find the Subgraph ID and Deployment ID](/img/subgraph-id-vs-deployment-id.png)
1014

1115
## Deployment ID
1216

@@ -18,10 +22,33 @@ Example endpoint that uses Deployment ID:
1822

1923
`https://gateway-arbitrum.network.thegraph.com/api/[api-key]/deployments/id/QmfYaVdSSekUeK6expfm47tP8adg3NNdEGnVExqswsSwaB`
2024

25+
Using Deployment IDs for queries offers precise version control but comes with specific implications:
26+
27+
- Advantages: Complete control over which version you're querying, ensuring consistent results
28+
- Challenges: Requires manual updates to query code when new Subgraph versions are published
29+
- Use case: Ideal for production environments where stability and predictability are crucial
30+
2131
## Subgraph ID
2232

2333
The Subgraph ID is a unique identifier for a Subgraph. It remains constant across all versions of a Subgraph. It is recommended to use the Subgraph ID to query the latest version of a Subgraph, although there are some caveats.
2434

2535
Be aware that querying using Subgraph ID may result in queries being responded to by an older version of the Subgraph due to the new version needing time to sync. Also, new versions could introduce breaking schema changes.
2636

2737
Example endpoint that uses Subgraph ID: `https://gateway-arbitrum.network.thegraph.com/api/[api-key]/subgraphs/id/FL3ePDCBbShPvfRJTaSCNnehiqxsPHzpLud6CpbHoeKW`
38+
39+
Using Subgraph IDs comes with important considerations:
40+
41+
- Benefits: Automatically queries the latest version, reducing maintenance overhead
42+
- Limitations: May encounter version synchronization delays or breaking schema changes
43+
- Use case: Better suited for development environments or when staying current is more important than version stability
44+
45+
## Deployment ID vs Subgraph ID
46+
47+
Here are the key differences between the two IDs:
48+
49+
| Consideration | Deployment ID | Subgraph ID |
50+
| ----------------------- | --------------------- | --------------- |
51+
| Version Pinning | Specific version | Always latest |
52+
| Maintenance Effort | High (manual updates) | Low (automatic) |
53+
| Environment Suitability | Production | Development |
54+
| Sync Status Awareness | Not required | Critical |
Lines changed: 25 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,25 @@
1+
---
2+
title: Edge & Node Upgrade Indexer
3+
sidebarTitle: Upgrade Indexer
4+
---
5+
6+
## Overview
7+
8+
The Upgrade Indexer is a specialized Indexer operated by Edge & Node. It supports newly integrated chains within The Graph ecosystem and ensures new Subgraphs are immediately available for querying, eliminating potential downtime.
9+
10+
Originally designed as a transitional support, its primary purpose was to facilitate the migration of Subgraphs from the hosted service to the decentralized network. Currently, it supports newly deployed Subgraphs before the full Chain Integration Process (CIP) Indexing rewards are activated.
11+
12+
### What it does
13+
14+
- Provides immediate query support for all newly deployed Subgraphs.
15+
- Functions as the sole supporting Indexer for each chain until indexing rewards are activated.
16+
17+
### What it does **not** do
18+
19+
- Does not permanently index Subgraphs. Subgraph owners should curate Subgraphs to use independent Indexers long term.
20+
- Does not compete for rewards. The Upgrade Indexer's participation on the Graph Network does not dilute rewards for other Indexers.
21+
- Doesn't support Time Travel Queries (TTQ). All Subgraphs on the Upgrade Indexer are auto-pruned. If TTQs are needed on a Subgraph, [curation signal can be added](/subgraphs/developing/publishing/publishing-a-subgraph/#adding-signal-to-your-subgraph) to attract Indexers that will support this feature.
22+
23+
### Conclusion
24+
25+
The Edge & Node Upgrade Indexer is foundational in supporting chain integrations and mitigating data latency risks. It plays a critical role in scaling The Graph's decentralized infrastructure by ensuring immediate query support and fostering community-driven indexing.

website/src/pages/en/supported-networks.mdx

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -10,7 +10,7 @@ import { useI18n } from '@/i18n'
1010

1111
export const getStaticProps = getSupportedNetworksStaticProps
1212

13-
<Heading.H2 id="supported-networks" className="mb-4 text-24 text-white">
13+
<Heading.H2 id="supported-networks" className="mb-4">
1414
{useI18n().t('index.supportedNetworks.title')}
1515
</Heading.H2>
1616

website/src/pages/es/supported-networks.mdx

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -10,7 +10,7 @@ import { useI18n } from '@/i18n'
1010

1111
export const getStaticProps = getSupportedNetworksStaticProps
1212

13-
<Heading.H2 id="supported-networks" className="mb-4 text-24 text-white">
13+
<Heading.H2 id="supported-networks" className="mb-4">
1414
{useI18n().t('index.supportedNetworks.title')}
1515
</Heading.H2>
1616

website/src/pages/fr/supported-networks.mdx

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -10,7 +10,7 @@ import { useI18n } from '@/i18n'
1010

1111
export const getStaticProps = getSupportedNetworksStaticProps
1212

13-
<Heading.H2 id="supported-networks" className="mb-4 text-24 text-white">
13+
<Heading.H2 id="supported-networks" className="mb-4">
1414
{useI18n().t('index.supportedNetworks.title')}
1515
</Heading.H2>
1616

0 commit comments

Comments
 (0)