Sunrise + Upgrading to The Graph Network FAQ
Reading time: 16 min
Note: This document is continually updated to ensure the most accurate and helpful information is provided. New questions and answers are added on a regular basis. If you can’t find the information you’re looking for, or if you require immediate assistance, . If you are looking for billing information, then please refer to .
The Sunrise of Decentralized Data is an initiative spearheaded by Edge & Node. The goal is to enable subgraph developers to seamlessly upgrade to The Graph’s decentralized network.
这一计划借鉴了 The Graph 生态系统的许多先前的发展,包括升级索引人以提供对新发布子图的查询服务,以及将新的区块链网络集成到 The Graph 中的能力。
Sunray: Enable support for hosted service chains, introduce a seamless upgrade flow, offer a free plan on The Graph Network, and provide simple payment options.
Sunbeam: The upgrade window that subgraph developers will have to upgrade their hosted service subgraphs to The Graph Network. This window will end at 10 a.m. PT on June 12th 2024.
Sunrise: Hosted service endpoints will no longer be available after 10 a.m. PT on June 12th, 2024.
Hosted service query endpoints will remain active until 10 a.m. PT on June 12th. After June 12th at 10 a.m. PT, query endpoints will no longer be available, and developers will no longer be able to deploy new subgraph versions on the hosted service.
I didn’t upgrade my subgraph by June 12th at 10 a.m. PT. What should I do if I still want to use it?
The hosted service homepage is still accessible and can be used to search for legacy hosted service subgraphs. If your hosted service subgraph has already been auto-upgraded, you may claim its network equivalent as the original owner. If your subgraph was not , you can still upgrade and publish it.
Upgrading takes less than five minutes on average. Once your subgraph is up, simply set up an API key in Subgraph Studio, update your API query endpoint, and begin querying!
Yes, the upgrade Indexer will automatically support all hosted service subgraphs published to The Graph Network for a seamless upgrade experience.
Note: Upgrading a subgraph to The Graph Network cannot be undone.
To upgrade a hosted service subgraph, you can visit the subgraph dashboard on the .
- Select the subgraph(s) you want to upgrade.
- Select the receiving wallet (the wallet that will become the owner of the subgraph).
- Click the "Upgrade" button.
Once your subgraph is published, the will begin serving queries on it. Once you have generated an API key, you can begin making queries immediately. .
The Graph community is here to support developers as they move to The Graph Network. Join The Graph's and request help in the #upgrade-decentralized-network channel.
All subgraphs will be supported by the upgrade Indexer. For a higher quality of service and more robust redundancy, you can add a curation signal to subgraphs eligible for indexing rewards. It is recommended that you curate your subgraph with at least 3000 GRT (per subgraph) to attract about 3 Indexers. .
Please note that this indexing incentive does not deplete over time; it has no depletion rate and is instantly withdrawable at any time. If you want to add 3000 GRT in signal, you will need to signal 3030 GRT (as 1% would be burned). Note that a 0.5% fee is also deducted from the subgraph’s signal every time a new version is published.
Subgraphs which are not eligible for indexing rewards may struggle to attract further Indexers. For example, indexing rewards may not be available for subgraphs on certain chains (check support ).
Members from these blockchain communities are encouraged to integrate their chain through the .
You can deploy new versions of your subgraph directly to Subgraph Studio, which provides a testing environment, before publishing to the network for production usage. Subgraph Studio has a different deployment command and requires a version-label
for each new deployment.
# Authorize with Subgraph Studio, available on your subgraph page## Alternativel pass this into the deploy command as --access-token (see below)graph auth --studio <deploy-key># Deploy to Subgraph Studio## Unlike the hosted service, the name is just the subgraph name (no github id)## If using `--node` directly, you can pass in https://api.studio.thegraph.com/deploy/graph deploy --studio --version <version> --access-token <deploy-key> <subgraph-name>
This new version will then sync in Subgraph Studio, a testing and sandbox environment. When you are ready to move a new version to production, you can .
Publishing requires Arbitrum ETH - upgrading your subgraph also airdrops a small amount to facilitate your first protocol interactions 🧑🚀
When the owner has upgraded their subgraph, you will be able to easily go from the subgraph's hosted service page to the corresponding subgraph on The Graph Network, and update your application to use the new subgraph's query URL. .
Around the start of June, Edge & Node will automatically upgrade actively queried subgraphs. This will give any third-party data consumers an opportunity to move subgraph endpoints to The Graph Network before 10 a.m. on June 12th. The subgraph owners will still be able to claim these subgraphs on the network using the hosted service upgrade flow.
Subgraphs on the hosted service are open APIs, and many subgraphs are relied upon by third-party developers to build their applications. To give those developers sufficient time to move to The Graph Network, Edge & Node will be "auto-upgrading" highly used subgraphs. A link to the "auto-upgraded" subgraph will be visible on the original subgraph's page on the hosted service.
Owners of "auto-upgraded" subgraphs can easily claim their upgraded subgraphs using the same - such subgraphs can be identified by their "auto-upgraded" tag. Ownership of the subgraph on The Graph Network will be transferred to the owner's wallet.
You can use the to claim the auto-upgraded subgraph, and then you can deploy a new version in Subgraph Studio, using the same infrastructure that powers the hosted service.
If you require an urgent fix, please contact support.
Subgraphs will be queryable on the hosted service until 10 a.m. PT on June 12th. After this date, the hosted service homepage will still be accessible, however, query endpoints will no longer be available. Owners of hosted service subgraphs will still be able to upgrade their subgraphs to The Graph Network after June 12th, though earlier upgrades are entitled to . Developers will also be able to claim .
What should I do with my subgraphs on the hosted service? Will they stop working and should I delete them?
It is not possible to delete subgraphs. Query endpoints will remain active until 10 a.m. PT on June 12th, regardless of whether they have been upgraded or not.
No, Subgraph Studio will not be impacted by Sunrise.
After 10 a.m. PT on June 12th, query endpoints will no longer be available, and owners won't be able to deploy or query the hosted service. However, the hosted service UI will still show subgraph pages, and subgraph owners will be able to upgrade their subgraphs if they haven't already. The hosted service UI will be retired at a later date.
No, rest assured that your subgraph will not need to be re-indexed when it is upgraded to The Graph Network. Subgraphs will be immediately available for querying, powered by the upgrade Indexer, which uses the same infrastructure as the hosted service. If your subgraph is indexing a network that is eligible for indexing rewards, you can add signal to attract indexers. .
Rest assured that network Indexers are prepared to provide support during this upgrade. If you experience issues with any of your subgraph queries, please reach out to
The Graph Network was originally deployed on mainnet Ethereum but moved to Arbitrum One to reduce gas costs for all users. As such any new subgraphs are published to The Graph Network on Arbitrum so that they can be supported by Indexers. Arbitrum is the network that subgraphs are published to, but subgraphs can index any of the
You can explore available subgraphs on . .
The upgrade Indexer is designed to improve the experience of upgrading subgraphs from the hosted service to The Graph Network and to support new versions of existing subgraphs that have not yet been indexed.
The upgrade Indexer aims to bootstrap chains that don't have indexing rewards yet on The Graph Network and to serve 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.
The upgrade Indexer supports chains that were previously only available on the hosted service.
Edge & Node has historically maintained the hosted service and, as a result, has already synced data for hosted service subgraphs.
All Indexers are encouraged to become upgrade Indexers as well. However, note that operating an upgrade Indexer is primarily a public service to support new subgraphs and additional chains that lack indexing rewards before they are approved by The Graph Council.
Chains that were previously only supported on the hosted service will now be available to developers on The Graph Network without indexing rewards at first, but it will unlock query fees for any Indexer that is interested. This should lead to an increase in the number of subgraphs being published on The Graph 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 Graph Network 上潜在的子图需求和新链的信息。
升级索引人为代币委托人提供了强大的机会。随着越来越多的子图从托管服务迁移到 The Graph Network,委托人将从增加的网络活动中获益。
不,升级索引人只会为每个子图分配最低金额,并不会收集索引奖励。
It operates on an “as needed” basis and serves as a fallback until sufficient service quality is achieved by at least 3 other Indexers in the network for respective chains and subgraphs.
Subgraph developers will be able to query their subgraphs on The Graph Network almost immediately after upgrading from the hosted service or publishing from Subgraph Studio, as no lead time will be required for indexing.
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.
升级的索引人将按市场价格定价查询,以不影响查询费用市场。
升级的索引人将为一个子图提供服务,直到它能够获得由至少3个其他索引人提供的持续且成功的查询服务。
此外,如果一个子图在过去的30天内没有被查询,升级的索引人将停止支持该子图。
Other Indexers are incentivized to support subgraphs with ongoing query volume. The query volume to the upgrade Indexer should trend towards zero, as it will have a small allocation size, and other Indexers will be chosen for queries ahead of it.
No, all infrastructure is operated by independent Indexers on The Graph Network, including the upgrade Indexer ().
You can use to create, test, and publish your subgraph. All hosted service users must upgrade their subgraph to The Graph Network before 10 a.m. PT on June 12th, 2024.
The ensures the indexing of all subgraphs. However, signaling GRT on a particular subgraph will draw more indexers to it. This incentivization of additional Indexers through curation aims to enhance the quality of service for queries by reducing latency and enhancing network availability.
When signaling, Curators can decide to signal on a specific version of the subgraph or to signal using auto-migrate. If they signal using auto-migrate, a curator’s shares will always be updated to the latest version published by the developer. If they decide to signal on a specific version instead, shares will always stay on that specific version.
To assist teams that are transitioning subgraphs from the hosted service to the Graph Network, curation support is now available. If you require assistance with curation to enhance the quality of service, please send a request to the Edge & Node team at and specify the subgraphs you need assistance with.
一旦您的子图达到足够的策展信号,并且其他索引人开始支持它,那么升级索引人将逐渐减少,这将允许其他索引人收集索引奖励和查询费用。
与使用The Graph Network相比,为您自己的项目运行基础设施需要的资源明显更多(/network/benefits/)。
Additionally, The Graph Network is significantly more robust, reliable, and cost-efficient than anything provided by a single organization or team. Hundreds of independent Indexers around the world power The Graph Network, ensuring safety, security, and redundancy.
话虽如此,如果您仍有兴趣运行,考虑加入The Graph Network,作为索引人,通过为您的子图和其他子图提供数据来赚取索引奖励和查询费用。了解如何成为索引人的更多信息,请参阅。
If you are building in web3, the moment you use a centralized indexing provider, you are giving them control of your dapp and data. The Graph’s decentralized network offers , reliability with unbeatable uptime thanks to node redundancy, significantly , and keeps you from being hostage at the data layer.
With The Graph Network, your subgraph is public and anyone can query it openly, which increases the usage and network effects of your dapp.
Additionally, Subgraph Studio provides 100,000 free monthly queries on the Free Plan, before payment is needed for additional usage.
以下是The Graph相对于中心化托管的好处的详细分析:
-
弹性与冗余性:分散系统因其分布式性质而本质上更加坚固和弹性十足。数据不存储在单一服务器或位置上,而是由全球数百个独立的索引人提供。这降低了数据丢失或服务中断的风险,即使一个节点失败,也能实现卓越的可用性(99.99%)。
-
服务质量:除了令人印象深刻的可用性之外,The Graph Network具有约106毫秒的中位查询速度(延迟),以及相对于托管的替代方案,更高的查询成功率。更多信息请参阅。
-
Censorship Resistance: Centralized systems are targets for censorship, either through regulatory pressures or network attacks. In contrast, the dispersed architecture of decentralized systems makes them much harder to censor, which ensures continuous data availability.
-
Transparency and Trust: Decentralized systems operate openly, enabling anyone to independently verify the data. This transparency builds trust among network participants because they can verify the system's integrity without relying on a central authority.
正如您选择区块链网络以获取分散性、安全性和透明性一样,选择The Graph Network是这些相同原则的延伸。通过将您的数据基础设施与这些价值观保持一致,您确保了一个有凝聚力、弹性十足且以信任为驱动的开发环境。