Skip to content

Commit 54f51c2

Browse files
MichaelMacaulaybenfacebrandonleekramer
authored
Sunrise edits (#622)
* Updates * Lower-casing the hosted service * adding video link * Update website/pages/en/deploying/deploying-a-subgraph-to-hosted.mdx Co-authored-by: Benoît Rouleau <[email protected]> * Update website/pages/en/sunrise.mdx Co-authored-by: Benoît Rouleau <[email protected]> * Adding the Stripe section and Marcus's new video * Removed some parentheses from the plan explanation * updates to cost benefits page * Feedback from Adam --------- Co-authored-by: Benoît Rouleau <[email protected]> Co-authored-by: Brandon Kramer <[email protected]>
1 parent a5756f4 commit 54f51c2

File tree

6 files changed

+74
-51
lines changed

6 files changed

+74
-51
lines changed

website/pages/en/billing.mdx

Lines changed: 14 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -6,9 +6,20 @@ title: Billing
66

77
There are two plans to use when querying subgraphs on The Graph Network.
88

9-
- **Free Plan**: The Free Plan includes 100,000 free monthly queries with full access to the Subgraph Studio testing environment. This plan is designed for hobbyists, hackathoners, and those with side projects to try out The Graph before scaling up.
9+
- **Free Plan**: The Free Plan includes 100,000 free monthly queries with full access to the Subgraph Studio testing environment. This plan is designed for hobbyists, hackathoners, and those with side projects to try out The Graph before scaling their dapp.
1010

11-
- **Growth Plan**: The Growth Plan includes everything in the Free Plan with all queries after 100,000 monthly queries requiring payments with GRT or credit card (coming soon). The Growth Plan is flexible enough to cover teams that have established dapps across a variety of use cases.
11+
- **Growth Plan**: The Growth Plan includes everything in the Free Plan with all queries after 100,000 monthly queries requiring payments with GRT or credit card. The Growth Plan is flexible enough to cover teams that have established dapps across a variety of use cases.
12+
13+
<VideoEmbed youtube="Nn771WagX2I" />
14+
15+
## Query Payments with credit card
16+
17+
- To set up billing with credit/debit cards, users will access Subgraph Studio (https://thegraph.com/studio/)
18+
1. Go to the [Subgraph Studio Billing page](https://thegraph.com/studio/billing/).
19+
2. Click on the "Connect Wallet" button on the top right corner of the page. You'll be redirected to the wallet selection page. Select your wallet and click on "Connect".
20+
3. Choose “Upgrade plan” if you are upgrading from the Free Plan or choose “Manage Plan” if you have already added GRT to your billing balance in the past. Next, you can estimate the number of queries to get a pricing estimate, but this is not a required step.
21+
4. To choose a credit card payment, choose “Credit card” as the payment method and fill out your credit card information. Those who have used Stripe before can use the Link feature to autofill their details.
22+
- Invoices will be processed at the end of each month and require an active credit card on file for all queries beyond the free plan quota.
1223

1324
## Query Payments with GRT
1425

@@ -20,14 +31,12 @@ Subgraph users can use The Graph Token (or GRT) to pay for queries on The Graph
2031

2132
### GRT on Arbitrum or Ethereum
2233

23-
The Graph’s billing system accepts GRT from either Arbitrum or Ethereum, but users will need ETH on Arbitrum to pay for gas. While The Graph protocol started on Ethereum Mainnet, most activity, including all of the billing contracts, are on Arbitrum. Although setting up billing with GRT on Arbitrum will process more quickly, users do not need to bridge GRT to Arbitrum before setting up billing for The Graph Network.
34+
The Graph’s billing system accepts GRT from either Arbitrum or Ethereum, but users will need ETH on Arbitrum to pay for gas. While The Graph protocol started on Ethereum Mainnet, most activity, including all of the billing contracts, are on Arbitrum One. Although setting up billing with GRT on Arbitrum will process more quickly, users do not need to bridge GRT to Arbitrum before setting up billing for The Graph Network.
2435

2536
> This section is written assuming you already have GRT in your wallet, and you're on Ethereum mainnet. If you don't have GRT, you can learn how to get GRT [here](#getting-grt).
2637
2738
### Adding GRT using a wallet
2839

29-
<VideoEmbed youtube="4Bw2sh0FxCg" />
30-
3140
1. Go to the [Subgraph Studio Billing page](https://thegraph.com/studio/billing/).
3241
2. Click on the "Connect Wallet" button on the top right corner of the page. You'll be redirected to the wallet selection page. Select your wallet and click on "Connect".
3342
3. Select the "Manage" button near the top right corner. First time users will see an option to "Upgrade to Growth plan" while returning users will click "Deposit from wallet".
@@ -54,8 +63,6 @@ The Graph’s billing system accepts GRT from either Arbitrum or Ethereum, but u
5463

5564
### Adding GRT using a multisig wallet
5665

57-
<VideoEmbed youtube="eCgxp1Rag_0" />
58-
5966
1. Go to the [Subgraph Studio Billing page](https://thegraph.com/studio/billing/).
6067
2. Click on the "Connect Wallet" button on the top right corner of the page. Select your wallet and click on "Connect". If you're using [Gnosis-Safe](https://gnosis-safe.io/), you'll be able to connect your multisig as well as your signing wallet. Then, sign the associated message. This will not cost any gas.
6168
3. Select the "Manage" button near the top right corner. First time users will see an option to "Upgrade to Growth plan" while returning users will click "Deposit from wallet".

website/pages/en/cookbook/subgraph-debug-forking.mdx

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -44,12 +44,12 @@ export function handleUpdatedGravatar(event: UpdatedGravatar): void {
4444
}
4545
```
4646

47-
Oops, how unfortunate, when I deploy my perfect looking subgraph to the [Hosted Service](https://thegraph.com/hosted-service/) it fails with the _"Gravatar not found!"_ error.
47+
Oops, how unfortunate, when I deploy my perfect looking subgraph to the [hosted service](https://thegraph.com/hosted-service/) it fails with the _"Gravatar not found!"_ error.
4848

4949
The usual way to attempt a fix is:
5050

5151
1. Make a change in the mappings source, which you believe will solve the issue (while I know it won't).
52-
2. Re-deploy the subgraph to the [Hosted Service](https://thegraph.com/hosted-service/) (or another remote Graph node).
52+
2. Re-deploy the subgraph to the [hosted service](https://thegraph.com/hosted-service/) (or another remote Graph node).
5353
3. Wait for it to sync-up.
5454
4. If it breaks again go back to 1, otherwise: Hooray!
5555

website/pages/en/deploying/deploying-a-subgraph-to-hosted.mdx

Lines changed: 11 additions & 11 deletions
Original file line numberDiff line numberDiff line change
@@ -2,19 +2,19 @@
22
title: Deploying a Subgraph to the Hosted Service
33
---
44

5-
> If a network is not supported on the Hosted Service, you can run your own [graph-node](https://github.com/graphprotocol/graph-node) to index it.
5+
> If a network is not supported on the hosted service, you can run your own [graph-node](https://github.com/graphprotocol/graph-node) to index it.
66
7-
This page explains how to deploy a subgraph to the Hosted Service. To deploy a subgraph you need to first install the [Graph CLI](https://github.com/graphprotocol/graph-cli). If you have not created a subgraph already, see [creating a subgraph](/developing/creating-a-subgraph).
7+
This page explains how to deploy a subgraph to the hosted service. To deploy a subgraph you need to first install the [Graph CLI](https://github.com/graphprotocol/graph-cli). If you have not created a subgraph already, see [creating a subgraph](/developing/creating-a-subgraph).
88

9-
## Create a Hosted Service account
9+
## Create a hosted service account
1010

11-
Before using the Hosted Service, create an account in our Hosted Service. You will need a [Github](https://github.com/) account for that; if you don't have one, you need to create that first. Then, navigate to the [Hosted Service](https://thegraph.com/hosted-service/), click on the _'Sign up with Github'_ button, and complete Github's authorization flow.
11+
Before using the hosted service, create an account in our hosted service. You will need a [Github](https://github.com/) account for that; if you don't have one, you need to create that first. Then, navigate to the [hosted service](https://thegraph.com/hosted-service/), click on the _'Sign up with Github'_ button, and complete Github's authorization flow.
1212

1313
## Store the Access Token
1414

1515
After creating an account, navigate to your [dashboard](https://thegraph.com/hosted-service/dashboard). Copy the access token displayed on the dashboard and run `graph auth --product hosted-service <ACCESS_TOKEN>`. This will store the access token on your computer. You only need to do this once, or if you ever regenerate the access token.
1616

17-
## Create a Subgraph on the Hosted Service
17+
## Create a Subgraph on the hosted service
1818

1919
Before deploying the subgraph, you need to create it in The Graph Explorer. Go to the [dashboard](https://thegraph.com/hosted-service/dashboard) and click on the _'Add Subgraph'_ button and fill in the information below as appropriate:
2020

@@ -34,7 +34,7 @@ Before deploying the subgraph, you need to create it in The Graph Explorer. Go t
3434

3535
After saving the new subgraph, you are shown a screen with help on how to install the Graph CLI, how to generate the scaffolding for a new subgraph, and how to deploy your subgraph. The first two steps were covered in the [Defining a Subgraph section](/developing/defining-a-subgraph).
3636

37-
## Deploy a Subgraph on the Hosted Service
37+
## Deploy a Subgraph on the hosted service
3838

3939
Deploying your subgraph will upload the subgraph files that you've built with `yarn build` to IPFS and tell the Graph Explorer to start indexing your subgraph using these files.
4040

@@ -243,7 +243,7 @@ A working example of this can be found [here](https://github.com/graphprotocol/e
243243

244244
If a subgraph syncs successfully, that is a good sign that it will continue to run well forever. However, new triggers on the network might cause your subgraph to hit an untested error condition or it may start to fall behind due to performance issues or issues with the node operators.
245245

246-
Graph Node exposes a graphql endpoint which you can query to check the status of your subgraph. On the Hosted Service, it is available at `https://api.thegraph.com/index-node/graphql`. On a local node, it is available on port `8030/graphql` by default. The full schema for this endpoint can be found [here](https://github.com/graphprotocol/graph-node/blob/master/server/index-node/src/schema.graphql). Here is an example query that checks the status of the current version of a subgraph:
246+
Graph Node exposes a graphql endpoint which you can query to check the status of your subgraph. On the hosted service, it is available at `https://api.thegraph.com/index-node/graphql`. On a local node, it is available on port `8030/graphql` by default. The full schema for this endpoint can be found [here](https://github.com/graphprotocol/graph-node/blob/master/server/index-node/src/schema.graphql). Here is an example query that checks the status of the current version of a subgraph:
247247

248248
```graphql
249249
{
@@ -274,13 +274,13 @@ This will give you the `chainHeadBlock` which you can compare with the `latestBl
274274

275275
## Hosted service subgraph archive policy
276276

277-
The Hosted Service is a free Graph Node Indexer. Developers can deploy subgraphs indexing a range of networks, which will be indexed, and made available to query via graphQL.
277+
The hosted service is a free Graph Node Indexer. Developers can deploy subgraphs indexing a range of networks, which will be indexed, and made available to query via graphQL.
278278

279-
To improve the performance of the service for active subgraphs, the Hosted Service will archive subgraphs that are inactive.
279+
To improve the performance of the service for active subgraphs, the hosted service will archive subgraphs that are inactive.
280280

281-
**A subgraph is defined as "inactive" if it was deployed to the Hosted Service more than 45 days ago, and if it has received 0 queries in the last 45 days.**
281+
**A subgraph is defined as "inactive" if it was deployed to the hosted service more than 45 days ago, and if it has received 0 queries in the last 45 days.**
282282

283-
Developers will be notified by email if one of their subgraphs has been marked as inactive 7 days before it is removed. If they wish to "activate" their subgraph, they can do so by making a query in their subgraph's Hosted Service graphQL playground. Developers can always redeploy an archived subgraph if it is required again.
283+
Developers will be notified by email if one of their subgraphs has been marked as inactive 7 days before it is removed. If they wish to "activate" their subgraph, they can do so by making a query in their subgraph's hosted service graphQL playground. Developers can always redeploy an archived subgraph if it is required again.
284284

285285
## Subgraph Studio subgraph archive policy
286286

website/pages/en/deploying/subgraph-studio.mdx

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -36,7 +36,7 @@ Querying subgraphs generates query fees, used to reward [Indexers](/network/inde
3636

3737
## Subgraph Compatibility with The Graph Network
3838

39-
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:
39+
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:
4040

4141
- Index a [supported network](/developing/supported-networks)
4242
- Must not use any of the following features:

website/pages/en/network/benefits.mdx

Lines changed: 23 additions & 25 deletions
Original file line numberDiff line numberDiff line change
@@ -11,7 +11,7 @@ Here is an analysis:
1111

1212
## Why You Should Use The Graph Network
1313

14-
- 60-98% lower monthly cost
14+
- Significantly lower monthly costs
1515
- $0 infrastructure setup costs
1616
- Superior uptime
1717
- Access to hundreds of independent Indexers around the world
@@ -21,67 +21,65 @@ Here is an analysis:
2121

2222
### Lower & more Flexible Cost Structure
2323

24-
No contracts. No monthly fees. Only pay for the queries you use—with an average cost-per-query of $0.00003. Queries are priced in USD and paid in GRT.
24+
No contracts. No monthly fees. Only pay for the queries you use—with an average cost-per-query of $40 per million queries (~$0.00004 per query). Queries are priced in USD and paid in GRT or credit card.
2525

26-
Query costs may vary; the quoted cost is the average at time of publication (February 2024).
26+
Query costs may vary; the quoted cost is the average at time of publication (March 2024).
2727

28-
## Low Volume User (less than 30,000 queries per month)
28+
## Low Volume User (less than 100,000 queries per month)
2929

30-
| Cost Comparison | Self Hosted | Graph Network |
30+
| Cost Comparison | Self Hosted | The Graph Network |
3131
| :-: | :-: | :-: |
3232
| Monthly server cost\* | $350 per month | $0 |
33-
| Query costs | $0+ | ~$15 per month |
33+
| Query costs | $0+ | $0 per month |
3434
| Engineering time<sup>†</sup> | $400 per month | None, built into the network with globally distributed Indexers |
35-
| Queries per month | Limited to infra capabilities | 30,000 (autoscaling) |
36-
| Cost per query | $0 | $0.0005<sup>‡</sup> |
35+
| Queries per month | Limited to infra capabilities | 100,000 (Free Plan) |
36+
| Cost per query | $0 | $0<sup>‡</sup> |
3737
| Infrastructure | Centralized | Decentralized |
3838
| Geographic redundancy | $750+ per additional node | Included |
3939
| Uptime | Varies | 99.9%+ |
40-
| Total Monthly Costs | <span className="highlight-row" />$750+ | ~$15 |
40+
| Total Monthly Costs | <span className="highlight-row" />$750+ | $0 |
4141

42-
## Medium Volume User (3,000,000+ queries per month)
42+
## Medium Volume User (~3M queries per month)
4343

44-
| Cost Comparison | Self Hosted | Graph Network |
44+
| Cost Comparison | Self Hosted | The Graph Network |
4545
| :-: | :-: | :-: |
4646
| Monthly server cost\* | $350 per month | $0 |
47-
| Query costs | $500 per month | $750 per month |
47+
| Query costs | $500 per month | $120 per month |
4848
| Engineering time<sup>†</sup> | $800 per month | None, built into the network with globally distributed Indexers |
49-
| Queries per month | Limited to infra capabilities | 3,000,000+ |
50-
| Cost per query | $0 | $0.00025<sup>‡</sup> |
49+
| Queries per month | Limited to infra capabilities | ~3,000,000 |
50+
| Cost per query | $0 | $0.00004 |
5151
| Infrastructure | Centralized | Decentralized |
5252
| Engineering expense | $200 per hour | Included |
5353
| Geographic redundancy | $1,200 in total costs per additional node | Included |
5454
| Uptime | Varies | 99.9%+ |
55-
| Total Monthly Costs | <span className="highlight-row" /> $1,650+ | $750 |
55+
| Total Monthly Costs | <span className="highlight-row" /> $1,650+ | $120 |
5656

57-
## High Volume User (30,000,000+ queries per month)
57+
## High Volume User (~30M queries per month)
5858

59-
| Cost Comparison | Self Hosted | Graph Network |
59+
| Cost Comparison | Self Hosted | The Graph Network |
6060
| :-: | :-: | :-: |
6161
| Monthly server cost\* | $1100 per month, per node | $0 |
62-
| Query costs | $4000 | $4,500 per month |
62+
| Query costs | $4000 | $1,200 per month |
6363
| Number of nodes needed | 10 | Not applicable |
6464
| Engineering time<sup>†</sup> | $6,000 or more per month | None, built into the network with globally distributed Indexers |
65-
| Queries per month | Limited to infra capabilities | 30,000,000+ |
66-
| Cost per query | $0 | $0.00015<sup>‡</sup> |
65+
| Queries per month | Limited to infra capabilities | ~30,000,000 |
66+
| Cost per query | $0 | $0.00004 |
6767
| Infrastructure | Centralized | Decentralized |
6868
| Geographic redundancy | $1,200 in total costs per additional node | Included |
6969
| Uptime | Varies | 99.9%+ |
70-
| Total Monthly Costs | <span className="highlight-row" /> $11,000+ | $4,500 |
70+
| Total Monthly Costs | <span className="highlight-row" /> $11,000+ | $1,200 |
7171

7272
\*including costs for backup: $50-$100 per month
7373

7474
<sup>†</sup>Engineering time based on $200 per hour assumption
7575

76-
<sup>‡</sup>using the max query budget function in the budget billing tab, while maintaining high quality of service
76+
<sup>‡</sup>Reflects cost for data consumer. Query fees are still paid to Indexers for Free Plan queries.
7777

78-
Estimated costs are only for Ethereum Mainnet subgraphs — costs are even higher when self hosting a `graph-node` on other networks.
78+
Estimated costs are only for Ethereum Mainnet subgraphs — costs are even higher when self hosting a `graph-node` on other networks. Some users may need to update their subgraph to a new version. Due to Ethereum gas fees, an update costs ~$50 at time of writing. Note that gas fees on [Arbitrum](/arbitrum/arbitrum-faq) are substantially lower than Ethereum mainnet.
7979

8080
Curating signal on a subgraph is an optional one-time, net-zero cost (e.g., $1k in signal can be curated on a subgraph, and later withdrawn—with potential to earn returns in the process).
8181

82-
Some users may need to update their subgraph to a new version. Due to Ethereum gas fees, an update costs ~$50 at time of writing.
8382

84-
Note that gas fees on [Arbitrum](/arbitrum/arbitrum-faq) are substantially lower than Ethereum mainnet.
8583

8684
## No Setup Costs & Greater Operational Efficiency
8785

0 commit comments

Comments
 (0)