Skip to content

Adding two docs #950

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 8 commits into from
May 15, 2025
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 2 additions & 0 deletions website/src/pages/en/subgraphs/_meta.js
Original file line number Diff line number Diff line change
Expand Up @@ -8,4 +8,6 @@ export default {
billing: '',
guides: titles.guides,
'best-practices': titles['best-practices'],
'fair-use-policy': '',
'upgrade-indexer': '',
}
51 changes: 51 additions & 0 deletions website/src/pages/en/subgraphs/fair-use-policy.mdx
Original file line number Diff line number Diff line change
@@ -0,0 +1,51 @@
---
title: Fair Use Policy
---

> Effective Date: May 15, 2025

## Overview

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.

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.

### 1. Scope

This policy applies to all individual users, teams, chains, and dapps using Edge & Node's Upgrade Indexer in Subgraph Studio for storage and queries.

### 2. Fair Use Storage Limits

**Free Storage: Up to 10 GB**

Beyond that, pricing is variable and adjusts based on usage patterns, network conditions, infrastructure requirements, and specific use cases.

Reach out to Edge & Node at [[email protected]](mailto:[email protected]) to discuss options that meet your technical needs.

You can monitor your usage via [Subgraph Studio](https://thegraph.com/studio/).

### 3. Fair Use Limits

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:

- Abnormally high or sustained bandwidth or storage usage beyond posted limits
- Circumvention of storage thresholds (e.g., use of multiple free-tier accounts)

The Edge & Node Support Team reserves the right to revise storage limits or impose temporary constraints for operational integrity.

If you exceed your included storage:

- Try [pruning Subgraph data](/subgraphs/best-practices/pruning/) to remove unused entities and help stay within storage limits
- [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
- You will receive multiple notifications and email alerts
- A grace period of 14 days will be provided to upgrade or reduce storage

Edge & Node's team is committed to helping users avoid unnecessary interruptions and will continue to support all web3 builders.

### 4. Subgraph Data Retention

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.

### 5. Support

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]).
25 changes: 25 additions & 0 deletions website/src/pages/en/subgraphs/upgrade-indexer.mdx
Original file line number Diff line number Diff line change
@@ -0,0 +1,25 @@
---
title: Edge & Node Upgrade Indexer
sidebarTitle: Upgrade Indexer
---

## Overview

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.

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.

### What it does

- Provides immediate query support for all newly deployed subgraphs.
- Functions as the sole supporting Indexer for each chain until indexing rewards are activated.

### What it does **not** do

- Does not permanently index subgraphs. Subgraph owners should curate subgraphs to use independent Indexers long term.
- Does not compete for rewards. The Upgrade Indexer's participation on the Graph Network does not dilute rewards for other Indexers.
- 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.

### Conclusion

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.