From 1019c4b9be7516dc542b8c7640d5b6e907b9cd0f Mon Sep 17 00:00:00 2001 From: Michael Macaulay <56690114+MichaelMacaulay@users.noreply.github.com> Date: Mon, 30 Oct 2023 18:07:56 -0400 Subject: [PATCH 1/6] adding faq --- website/pages/en/_meta.js | 1 + website/pages/en/sunrise.mdx | 105 +++++++++++++++++++++++++++ website/remote-files/substreams.json | 1 + 3 files changed, 107 insertions(+) create mode 100644 website/pages/en/sunrise.mdx diff --git a/website/pages/en/_meta.js b/website/pages/en/_meta.js index 524e5ce698e3..b87ce6a181a1 100644 --- a/website/pages/en/_meta.js +++ b/website/pages/en/_meta.js @@ -5,6 +5,7 @@ export default { }, about: '', network: 'The Graph Network', + sunrise: 'Sunrise FAQ', billing: '', 'network-transition-faq': '', glossary: '', diff --git a/website/pages/en/sunrise.mdx b/website/pages/en/sunrise.mdx new file mode 100644 index 000000000000..cb8a0563faa6 --- /dev/null +++ b/website/pages/en/sunrise.mdx @@ -0,0 +1,105 @@ +--- +title: Sunrise of decentralized data FAQ +--- + +### What is the sunrise of decentralized data? + +The sunrise of decentralized data is an initiative spearheaded by Edge & Node, working on The Graph. The goal is to seamlessly enable subgraph developers and data consumers to upgrade to The Graph’s decentralized network. + +This plan draws on many previous developments from The Graph ecosystem, including an upgrade Indexer to serve queries on newly published subgraphs, and the ability to integrate new blockchain networks to The Graph. + +### What are the phases of the sunrise of decentralized data? + +**Sunray**: Enable support for hosted service chains, offer a seamless upgrade flow, offer a free plan on the network +**Sunbeam**: The upgrade window that subgraph developers will have to upgrade their subgraphs to The Graph Network. The start and actual length of this will be announced soon. +**Sunrise**: Hosted service endpoints will expire as traffic moves to 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 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. + +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. + +### Should I host my own indexing infrastructure? + +Running infrastructure for your own project is significantly more resource intensive when compared to using The Graph Network. + +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. + +That being said, if you’re still interested in running a Graph Node, consider joining The Graph Network as an Indexer to earn indexing rewards and query fees by serving data on your subgraph and others. + +### Should I use a centralized indexing provider? + +If you are building in web2, you should. 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 superior quality of service, reliability with unbeatable uptime thanks to node redundancy, as well as significantly lower costs, and you won’t be held 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. With a centralized indexing solution, the subgraph is private to the centralized provider. + +### Will my hosted service subgraph be supported by the upgrade Indexer? + +Yes, the upgrade Indexer will support all subgraphs published during the upgrade window. + +However, some subgraphs may not be eligible for indexing rewards, and as a result, may have difficulty attracting further Indexers. For example, indexing rewards may not be available for subgraphs on certain chains. Members from these blockchain communities are encouraged to integrate their chain through the Chain Integration Process. + +## WHat is an upgrade Indexer? + +### What is an upgrade Indexer? 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 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? + +The upgrade Indexer will support chains that are currently only available on the hosted service. This will be inclusive of many of the hosted service subgraphs that have already been synced. + +Find a comprehensive list of supported chains here. + +### Why is Edge & Node running the upgrade Indexer? + +Edge and Node has historically maintained the hosted service and, as a result, has already synced data for hosted service subgraphs. + +Any and all Indexers are encouraged to become upgrade Indexers as well. However, note that operating an upgrade Indexer is largely provided as a public service to support new subgraphs and additional chains due to the lack of indexing rewards before they are approved by The Graph Council. + +### 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. + +The upgrade Indexer also provides the Indexer community with information about potential demand for subgraphs and new chains on The Graph Network. + +### What does this mean for Delegators? + +The upgrade Indexer offers a powerful opportunity for Delegators. As more subgraphs are upgraded from the hosted service to The Graph Network, Delegators stand to benefit from the increased network activity. + +### Will the upgrade Indexer compete with existing Indexers for rewards? + +No, the upgrade Indexer will only allocate the minimum amount per subgraph and will not collect indexing rewards. + +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. + +### How will this affect subgraph developers? + +Subgraph developers will be able to query their subgraphs on the network almost immediately after upgrading them from the hosted service or publishing them from the Subgraph Studio, as no lead time will be required for indexing. + +### 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. + +### How will the upgrade Indexer price queries? + +The upgrade Indexer will price queries at the market rate so as not to influence the query fee market. + +### How can existing Indexers support upgrades to The Graph Network? + +All Indexers are welcome to sync subgraphs across chains (irrespective of indexing rewards status), including any of the same subgraphs that the upgrade Indexer will be syncing. + +Indexers can also become upgrade Indexers as well. Use your Indexer operator wallet and request access to all hosted service subgraph data here. + +### What are the criteria for the upgrade Indexer to stop supporting a subgraph? + +The upgrade Indexer will serve a subgraph until it is sufficiently and successfully served with consistent queries served by at least 3 other Indexers. + +The upgrade Indexer will stop supporting a subgraph if it has not been queried in the last 30 days. + +Other Indexers are incentivized to support subgraphs with ongoing query volume, so the query volume to the upgrade Indexer should trend towards zero because the Indexer will have a small allocation size and other Indexers will be chosen for queries ahead of the upgrade Indexer. diff --git a/website/remote-files/substreams.json b/website/remote-files/substreams.json index a282d182ec6f..2540cdd397af 100644 --- a/website/remote-files/substreams.json +++ b/website/remote-files/substreams.json @@ -52,6 +52,7 @@ "reference-and-specs/packages.md", "reference-and-specs/rust-crates.md", "release-notes/change-log.md", + "tutorials/eth-calls.md", "tutorials/exploring-ethereum/map_block_meta_module.md", "tutorials/exploring-ethereum/map_contract_events_module.md", "tutorials/exploring-ethereum/map_filter_transactions_module.md", From 9d5d37dc9d11f9af2799011d45c439a510f17c6c Mon Sep 17 00:00:00 2001 From: Michael Macaulay <56690114+MichaelMacaulay@users.noreply.github.com> Date: Mon, 30 Oct 2023 18:24:16 -0400 Subject: [PATCH 2/6] Fixing links --- website/pages/en/sunrise.mdx | 26 +++++++++++++++++++------- 1 file changed, 19 insertions(+), 7 deletions(-) diff --git a/website/pages/en/sunrise.mdx b/website/pages/en/sunrise.mdx index cb8a0563faa6..a51fcbe1e3a7 100644 --- a/website/pages/en/sunrise.mdx +++ b/website/pages/en/sunrise.mdx @@ -18,29 +18,41 @@ This plan draws on many previous developments from The Graph ecosystem, includin 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 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 are encouraged to upgrade their subgraphs to The Graph Network. 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. ### Should I host my own indexing infrastructure? -Running infrastructure for your own project is significantly more resource intensive when compared to using The Graph Network. +Running infrastructure for your own project is [significantly more resource intensive](/network/benefits/) when compared to using The Graph Network. 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. -That being said, if you’re still interested in running a Graph Node, consider joining The Graph Network as an Indexer to earn indexing rewards and query fees by serving data on your subgraph and others. +That being said, if you’re still interested in running a [Graph Node](https://github.com/graphprotocol/graph-node), consider joining The Graph Network [as an Indexer](https://thegraph.com/blog/how-to-become-indexer/) to earn indexing rewards and query fees by serving data on your subgraph and others. ### Should I use a centralized indexing provider? -If you are building in web2, you should. 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 superior quality of service, reliability with unbeatable uptime thanks to node redundancy, as well as significantly lower costs, and you won’t be held hostage at the data layer. +If you are building in web2, you should. 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 [superior quality of service](https://thegraph.com/blog/qos-the-graph-network/), reliability with unbeatable uptime thanks to node redundancy, as well as significantly [lower costs](/network/benefits/), and you won’t be held 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. With a centralized indexing solution, the subgraph is private to the centralized provider. +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. + +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. + +Just as you've chosen your blockchain network for its decentralized nature, security, and transparency, opting for The Graph Network is an extension of those same principles. By aligning your data infrastructure with these values, you ensure a cohesive, resilient, and trust-driven development environment. + ### Will my hosted service subgraph be supported by the upgrade Indexer? Yes, the upgrade Indexer will support all subgraphs published during the upgrade window. -However, some subgraphs may not be eligible for indexing rewards, and as a result, may have difficulty attracting further Indexers. For example, indexing rewards may not be available for subgraphs on certain chains. Members from these blockchain communities are encouraged to integrate their chain through the Chain Integration Process. +However, some subgraphs may not be eligible for indexing rewards, and as a result, may have difficulty attracting further Indexers. For example, indexing rewards may not be available for subgraphs on certain chains. Members from these blockchain communities are encouraged to integrate their chain through the [Chain Integration Process](/chain-integration-overview/). ## WHat is an upgrade Indexer? @@ -54,7 +66,7 @@ The upgrade Indexer is aimed at bootstrapping chains that do not yet have indexi The upgrade Indexer will support chains that are currently only available on the hosted service. This will be inclusive of many of the hosted service subgraphs that have already been synced. -Find a comprehensive list of supported chains here. +Find a comprehensive list of supported chains [here](/developing/supported-networks/). ### Why is Edge & Node running the upgrade Indexer? @@ -94,7 +106,7 @@ The upgrade Indexer will price queries at the market rate so as not to influence All Indexers are welcome to sync subgraphs across chains (irrespective of indexing rewards status), including any of the same subgraphs that the upgrade Indexer will be syncing. -Indexers can also become upgrade Indexers as well. Use your Indexer operator wallet and request access to all hosted service subgraph data here. +Indexers can also become upgrade Indexers as well. Use your Indexer operator wallet and request access to all hosted service subgraph data [here](https://app.deform.cc/form/de2a6ca9-c787-4a63-a32b-14f3a5f1bc7d/). ### What are the criteria for the upgrade Indexer to stop supporting a subgraph? From cfacc35931ad9e76769972a998e38383afb55bc7 Mon Sep 17 00:00:00 2001 From: Michael Macaulay <56690114+MichaelMacaulay@users.noreply.github.com> Date: Mon, 30 Oct 2023 18:27:01 -0400 Subject: [PATCH 3/6] linting error --- website/pages/en/sunrise.mdx | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/website/pages/en/sunrise.mdx b/website/pages/en/sunrise.mdx index a51fcbe1e3a7..3d2eb6a13a3b 100644 --- a/website/pages/en/sunrise.mdx +++ b/website/pages/en/sunrise.mdx @@ -2,7 +2,7 @@ title: Sunrise of decentralized data FAQ --- -### What is the sunrise of decentralized data? +## What is the sunrise of decentralized data? The sunrise of decentralized data is an initiative spearheaded by Edge & Node, working on The Graph. The goal is to seamlessly enable subgraph developers and data consumers to upgrade to The Graph’s decentralized network. From bf931214049b883b964f237a6483c853f65df5e6 Mon Sep 17 00:00:00 2001 From: Michael Macaulay <56690114+MichaelMacaulay@users.noreply.github.com> Date: Tue, 31 Oct 2023 10:23:24 -0400 Subject: [PATCH 4/6] Update website/pages/en/sunrise.mdx MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Co-authored-by: Benoît Rouleau --- website/pages/en/sunrise.mdx | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/website/pages/en/sunrise.mdx b/website/pages/en/sunrise.mdx index 3d2eb6a13a3b..89b3147a388b 100644 --- a/website/pages/en/sunrise.mdx +++ b/website/pages/en/sunrise.mdx @@ -54,7 +54,7 @@ Yes, the upgrade Indexer will support all subgraphs published during the upgrade However, some subgraphs may not be eligible for indexing rewards, and as a result, may have difficulty attracting further Indexers. For example, indexing rewards may not be available for subgraphs on certain chains. Members from these blockchain communities are encouraged to integrate their chain through the [Chain Integration Process](/chain-integration-overview/). -## WHat is an upgrade Indexer? +## What is an upgrade Indexer? ### What is an upgrade Indexer? What does "upgrade Indexer" mean? From 64957aa2fb4454eb239f15f31a05676c83ad994a Mon Sep 17 00:00:00 2001 From: Michael Macaulay <56690114+MichaelMacaulay@users.noreply.github.com> Date: Tue, 31 Oct 2023 10:23:38 -0400 Subject: [PATCH 5/6] Update website/pages/en/sunrise.mdx MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Co-authored-by: Benoît Rouleau --- website/pages/en/sunrise.mdx | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/website/pages/en/sunrise.mdx b/website/pages/en/sunrise.mdx index 89b3147a388b..7c684d1c86f8 100644 --- a/website/pages/en/sunrise.mdx +++ b/website/pages/en/sunrise.mdx @@ -112,6 +112,6 @@ Indexers can also become upgrade Indexers as well. Use your Indexer operator wal The upgrade Indexer will serve a subgraph until it is sufficiently and successfully served with consistent queries served by at least 3 other Indexers. -The upgrade Indexer will stop supporting a subgraph if it has not been queried in the last 30 days. +Furthermore, the upgrade Indexer will stop supporting a subgraph if it has not been queried in the last 30 days. Other Indexers are incentivized to support subgraphs with ongoing query volume, so the query volume to the upgrade Indexer should trend towards zero because the Indexer will have a small allocation size and other Indexers will be chosen for queries ahead of the upgrade Indexer. From e9995994238c4397583174a374816e301aebfbec Mon Sep 17 00:00:00 2001 From: Michael Macaulay <56690114+MichaelMacaulay@users.noreply.github.com> Date: Tue, 31 Oct 2023 10:36:25 -0400 Subject: [PATCH 6/6] Doc squad feedback --- website/pages/en/sunrise.mdx | 18 ++++++++++-------- 1 file changed, 10 insertions(+), 8 deletions(-) diff --git a/website/pages/en/sunrise.mdx b/website/pages/en/sunrise.mdx index 3d2eb6a13a3b..c3398e703063 100644 --- a/website/pages/en/sunrise.mdx +++ b/website/pages/en/sunrise.mdx @@ -2,6 +2,8 @@ title: Sunrise of decentralized data FAQ --- +> 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 [reach out on Discord](https://discord.gg/vtvv7FP). + ## What is the sunrise of decentralized data? The sunrise of decentralized data is an initiative spearheaded by Edge & Node, working on The Graph. The goal is to seamlessly enable subgraph developers and data consumers to upgrade to The Graph’s decentralized network. @@ -10,9 +12,9 @@ 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, offer a seamless upgrade flow, offer a free plan on the network +**Sunray**: Enable support for hosted service chains, offer a seamless upgrade flow, offer a free plan on the network. **Sunbeam**: The upgrade window that subgraph developers will have to upgrade their subgraphs to The Graph Network. The start and actual length of this will be announced soon. -**Sunrise**: Hosted service endpoints will expire as traffic moves to The Graph Network +**Sunrise**: Hosted service endpoints will expire as traffic moves to The Graph Network. ### Do I need to run my own infrastructure? @@ -32,19 +34,19 @@ That being said, if you’re still interested in running a [Graph Node](https:// ### Should I use a centralized indexing provider? -If you are building in web2, you should. 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 [superior quality of service](https://thegraph.com/blog/qos-the-graph-network/), reliability with unbeatable uptime thanks to node redundancy, as well as significantly [lower costs](/network/benefits/), and you won’t be held hostage at the data layer. +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 [superior quality of service](https://thegraph.com/blog/qos-the-graph-network/), reliability with unbeatable uptime thanks to node redundancy, as well as significantly [lower costs](/network/benefits/), and you won’t be held 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. With a centralized indexing solution, the subgraph is private to the centralized provider. 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%). +- **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/). +- **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 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. -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. +- **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. Just as you've chosen your blockchain network for its decentralized nature, security, and transparency, opting for The Graph Network is an extension of those same principles. By aligning your data infrastructure with these values, you ensure a cohesive, resilient, and trust-driven development environment. @@ -56,7 +58,7 @@ However, some subgraphs may not be eligible for indexing rewards, and as a resul ## WHat is an upgrade Indexer? -### What is an upgrade Indexer? What does "upgrade Indexer" mean? +### 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.