Skip to content
Merged
Show file tree
Hide file tree
Changes from 2 commits
Commits
Show all changes
25 commits
Select commit Hold shift + click to select a range
d5ed926
Editing
MichaelMacaulay Apr 9, 2024
c4e52bc
Date placeholders
MichaelMacaulay Apr 9, 2024
3d25004
Merge branch 'main' into Sunbeam-updates
azf20 Apr 10, 2024
94fb990
update cookbooks to use subgraph studio
azf20 Apr 11, 2024
3cd334f
remove querying-the-hosted-service
azf20 Apr 11, 2024
f011b91
simplify placeholder
azf20 Apr 11, 2024
6882733
update upgrading and publishing guides
azf20 Apr 11, 2024
5ca753b
add note to hosted service deployment page
azf20 Apr 11, 2024
dcfb619
update querying page
azf20 Apr 11, 2024
bb58df5
update faq
azf20 Apr 11, 2024
1382892
linting
azf20 Apr 11, 2024
b039a55
capital I
azf20 Apr 11, 2024
d54e4db
Simon's feedback
MichaelMacaulay Apr 11, 2024
0c29e79
Merge branch 'Sunbeam-updates' of https://github.com/graphprotocol/do…
MichaelMacaulay Apr 11, 2024
037a769
Update website/pages/en/querying/querying-the-graph.mdx
MichaelMacaulay Apr 11, 2024
145c3ad
Update website/pages/en/publishing/publishing-a-subgraph.mdx
MichaelMacaulay Apr 11, 2024
fb30f2a
Update website/pages/en/publishing/publishing-a-subgraph.mdx
MichaelMacaulay Apr 11, 2024
9e7cf78
Update website/pages/en/deploying/hosted-service.mdx
MichaelMacaulay Apr 11, 2024
d5429af
Update website/pages/en/cookbook/near.mdx
MichaelMacaulay Apr 11, 2024
a4ecbad
Update website/pages/en/cookbook/near.mdx
MichaelMacaulay Apr 11, 2024
ca8212c
Update website/pages/en/cookbook/near.mdx
MichaelMacaulay Apr 11, 2024
252dadc
Subgraph studio fix
MichaelMacaulay Apr 11, 2024
537b28a
final tweaks
MichaelMacaulay Apr 11, 2024
a6be22e
Adding dates
MichaelMacaulay Apr 11, 2024
5880f0d
Adding year
MichaelMacaulay Apr 11, 2024
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
Original file line number Diff line number Diff line change
Expand Up @@ -13,7 +13,7 @@ These are the steps to deploy your subgraph to the Subgraph Studio:

## Installing Graph CLI

We are using the same CLI to deploy subgraphs to our [hosted service](https://thegraph.com/hosted-service/) and to the [Subgraph Studio](https://thegraph.com/studio/). Here are the commands to install graph-cli. This can be done using npm or yarn.
We are using the same CLI to deploy subgraphs to the [Subgraph Studio](https://thegraph.com/studio/). Here are the commands to install graph-cli. This can be done using npm or yarn.

**Install with yarn:**

Expand Down
4 changes: 2 additions & 2 deletions website/pages/en/deploying/hosted-service.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -2,7 +2,7 @@
title: What is the Hosted Service?
---

> Please note, the hosted service will begin sunsetting in 2023, but it will remain available to networks that are not supported on the decentralized network. Developers are encouraged to [upgrade their subgraphs to The Graph Network](/cookbook/upgrading-a-subgraph) as more networks are supported. Each network will have their hosted service equivalents gradually sunset to ensure developers have enough time to upgrade subgraphs to the decentralized network. Read more about the sunsetting of the hosted service [here](https://thegraph.com/blog/sunsetting-hosted-service).
> Please note, hosted service endpoints will expire on DATE PLACEHOLDER as all subgraphs will need to upgrade to The Graph Network. Please read more in the [Sunrise FAQ](../sunrise)
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Leaving a comment just so we don't forget to update DATE PLACEHOLDER.


This section will walk you through deploying a subgraph to the [hosted service](https://thegraph.com/hosted-service/).

Expand Down Expand Up @@ -59,4 +59,4 @@ graph init \

## Supported Networks on the hosted service

You can find the list of the supported networks [Here](/developing/supported-networks).
You can find the list of the supported networks [here](/developing/supported-networks).
2 changes: 1 addition & 1 deletion website/pages/en/deploying/subgraph-studio.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -36,7 +36,7 @@ Querying subgraphs generates query fees, used to reward [Indexers](/network/inde

## Subgraph Compatibility with The Graph Network

The Graph Network is not yet able to support all of the data-sources & features available on the hosted service. In order to be supported by Indexers on the network, subgraphs must:
In order to be supported by Indexers on The Graph Network, subgraphs must:

- Index a [supported network](/developing/supported-networks)
- Must not use any of the following features:
Expand Down
4 changes: 3 additions & 1 deletion website/pages/en/glossary.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -24,7 +24,7 @@ title: Glossary

- **Indexer's Self Stake**: The amount of GRT that Indexers stake to participate in the decentralized network. The minimum is 100,000 GRT, and there is no upper limit.

- **Upgrade Indexer**: A temporary Indexer designed to act as a fallback for subgraph queries not serviced by other Indexers on the network. It ensures a seamless transition for subgraphs upgrading from the hosted service by readily serving their queries upon being published. The upgrade Indexer is not competitive with other Indexers. It supports numerous blockchains that were previously only available on the hosted service.
- **Upgrade Indexer**: A temporary Indexer designed to act as a fallback for subgraph queries not serviced by other Indexers on the network. It ensures a seamless transition for subgraphs upgrading from the hosted service to The Graph Network. The upgrade Indexer is not competitive with other Indexers. It supports numerous blockchains that were previously only available on the hosted service.

- **Delegators**: Network participants who own GRT and delegate their GRT to Indexers. This allows Indexers to increase their stake in subgraphs on the network. In return, Delegators receive a portion of the Indexing Rewards that Indexers receive for processing subgraphs.

Expand Down Expand Up @@ -83,3 +83,5 @@ title: Glossary
- **_Updating_ a subgraph**: The process of releasing a new subgraph version with updates to the subgraph's manifest, schema, or mappings.

- **Migrating**: The process of curation shares moving from an old version of a subgraph to a new version of a subgraph (e.g. when v0.0.1 is updated to v0.0.2).

- **Upgrade Window**: The 60 day countdown for hosted service users to upgrade their subgraph(s) to The Graph Network starting on DATE PLACEHOLDER, and ending on DATE PLACEHOLDER.
2 changes: 1 addition & 1 deletion website/pages/en/quick-start.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -2,7 +2,7 @@
title: Quick Start
---

This guide will quickly take you through how to initialize, create, and deploy your subgraph to the Subgraph Studio or the hosted service.
This guide will quickly take you through how to initialize, create, and deploy your subgraph to the Subgraph Studio.

Ensure that your subgraph will be indexing data from a [supported network](/developing/supported-networks).

Expand Down
27 changes: 17 additions & 10 deletions website/pages/en/sunrise.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -13,8 +13,7 @@ This plan draws on many previous developments from The Graph ecosystem, includin
### What are the phases of the Sunrise of Decentralized Data?

**Sunray**: Enable support for hosted service chains, introduce a seamless upgrade flow, offer a free plan on The Graph Network as well as simple payment options.
**Sunbeam**: The upgrade window that subgraph developers will have to upgrade their subgraphs to The Graph Network. The start and length of this will be announced soon.
**Sunrise**: Hosted service endpoints will expire as traffic moves to The Graph Network.
**Sunbeam**: The 60 day upgrade window that subgraph developers will have to upgrade their subgraphs to The Graph Network. The window opens on DATE PLACEHOLDER and closes on DATE PLACEHOLDER. **Sunrise**: Hosted service endpoints will expire as traffic moves to The Graph Network.

### How do I upgrade my hosted service subgraph?

Expand All @@ -30,15 +29,21 @@ To upgrade a hosted service subgraph, you can visit the subgraph dashboard on th

Once your subgraph is published, the [upgrade Indexer](#what-is-an-upgrade-indexer) will begin serving queries on it, so you can begin making queries immediately!

### When does the Upgrade Window start and end?

The Upgrade Window starts on DATE PLACEHOLDER and ends on DATE PLACEHOLDER.

### What happens if I don't upgrade my subgraph?

Hosted service endpoints will expire at the end of the upgrade window.
After DATE PLACEHOLDER, hosted service endpoints will expire and all queries will be served by The Graph Network.

### Do I need to run my own infrastructure?

No, all infrastructure is operated by independent Indexers on The Graph Network, including the upgrade Indexer ([read more below](#what-is-an-upgrade-indexer)).

You can use the [Subgraph Studio](https://thegraph.com/studio/) to create, test, and publish your subgraph. All hosted service users are encouraged to upgrade their subgraphs to The Graph Network. The upgrade Indexer ensures you can query your subgraph even without curation signal.
You can use the [Subgraph Studio](https://thegraph.com/studio/) to create, test, and publish your subgraph. All hosted service users must upgrade their subgraph to The Graph Network before the end of the 60 day upgrade window ending on DATE PLACEHOLDER.

The upgrade Indexer ensures you can query your subgraph even without curation signal.

Once your subgraph has reached adequate curation signal and other Indexers begin supporting it, the upgrade Indexer will gradually taper off, allowing other Indexers to collect indexing rewards and query fees.

Expand All @@ -56,13 +61,15 @@ If you are building in web3, the moment you use a centralized indexing provider,

With The Graph Network, your subgraph is public and anyone can query it openly, which increases the usage and network effects of your dapp. With a centralized indexing solution, the subgraph is private to the centralized provider.

Additionally, the upgrade Indexer enables 100,000 free monthly queries for your subgraph before needing to pay for queries.

Here's a detailed breakdown of the benefits of The Graph over centralized hosting:

- **Resilience and Redundancy**: Decentralized systems are inherently more robust and resilient due to their distributed nature. Data isn't stored on a single server or location. Instead, it's served by hundreds of independent Indexers around the globe. This reduces the risk of data loss or service interruptions if one node fails, leading to exceptional uptime (99.99%).

- **Quality of Service**: In addition to the impressive uptime, The Graph Network features a ~106ms median query speed (latency), and higher query success rates compared to hosted alternatives. Read more in [this blog](https://thegraph.com/blog/qos-the-graph-network/).

- **Censorship Resistance**: Centralized systems can become targets for censorship, either through regulatory pressures or network attacks. In contrast, decentralized systems, due to their dispersed architecture, are much harder to censor, ensuring continuous data availability.
- **Censorship Resistance**: Centralized systems are targets for censorship, either through regulatory pressures or network attacks. In contrast, decentralized systems, due to their dispersed architecture, are much harder to censor, ensuring continuous data availability.

- **Transparency and Trust**: Decentralized systems operate openly, enabling anyone to independently verify the data. This transparency builds trust among network participants, as they can verify the system's integrity without relying on a central authority.

Expand All @@ -78,13 +85,13 @@ However, some subgraphs may not be eligible for indexing rewards, and as a resul

### What does "upgrade Indexer" mean?

It is designed to improve the experience of upgrading subgraphs from the hosted service to The Graph Network and supporting new versions of existing subgraphs that have not yet been indexed.
The upgrade Indexer is designed to improve the experience of upgrading subgraphs from the hosted service to The Graph Network and supporting new versions of existing subgraphs that have not yet been indexed.

The upgrade Indexer is aimed at bootstrapping chains that do not yet have indexing rewards on the network, as well as a fallback for new subgraph versions. The goal is to ensure that an Indexer is available to serve queries as quickly as possible after a subgraph is published.

### What chains will the upgrade Indexer support?
### What chains does the upgrade Indexer support?

The upgrade Indexer will support chains that are currently only available on the hosted service. This will include many hosted service subgraphs that have already been synced.
The upgrade Indexer supports chains that were previously only available on the hosted service.

Find a comprehensive list of supported chains [here](/developing/supported-networks/).

Expand All @@ -96,7 +103,7 @@ Any and all Indexers are encouraged to become upgrade Indexers as well. However,

### What does this mean for existing Indexers?

Chains that are currently exclusively supported on the hosted service will be made available to developers on The Graph without indexing rewards at first, though this does unlock query fees for any Indexer that is interested. This is expected to lead to an increase in the number of subgraphs being published on the network, providing more opportunities for Indexers to index and serve these subgraphs in return for query fees, even before indexing rewards are enabled for a chain.
Chains that were previously exclusively supported on the hosted service are available to developers on The Graph without indexing rewards at first, though this does unlock query fees for any Indexer that is interested. This is expected to lead to an increase in the number of subgraphs being published on the network, providing more opportunities for Indexers to index and serve these subgraphs in return for query fees, even before indexing rewards are enabled for a chain.

The upgrade Indexer also provides the Indexer community with information about potential demand for subgraphs and new chains on The Graph Network.

Expand All @@ -116,7 +123,7 @@ Subgraph developers will be able to query their subgraphs on the network almost

### How does this benefit data consumers?

The upgrade Indexer enables chains on the network that are currently only supported on the hosted service. Therefore, it widens the scope and availability of data that can be queried on the network.
The upgrade Indexer enables chains on the network that were previously only supported on the hosted service. Therefore, it widens the scope and availability of data that can be queried on the network.

### How will the upgrade Indexer price queries?

Expand Down
2 changes: 1 addition & 1 deletion website/pages/en/tokenomics.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -47,7 +47,7 @@ If you're reading this, you're capable of becoming a Delegator right now by head

Curators identify high-quality subgraphs, and "curate" them (i.e., signal GRT on them) to earn curation shares, which guarantee a percentage of all future query fees generated by the subgraph. While any independent network participant can be a Curator, typically subgraph developers are among the first Curators for their own subgraphs because they want to ensure their subgraph is indexed.

As of December 2022, subgraph developers are encouraged to curate their subgraph with at least 3,000 GRT. However, this number may be impacted by network activity and community participation.
As of 2024, subgraph developers are encouraged to curate their subgraph with at least 3,000 GRT. However, this number may be impacted by network activity and community participation.

Curators pay a 1% curation tax when they curate a new subgraph. This curation tax is burned, decreasing the supply of GRT.

Expand Down