You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
* 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]>
Copy file name to clipboardExpand all lines: website/pages/en/billing.mdx
+14-7Lines changed: 14 additions & 7 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -6,9 +6,20 @@ title: Billing
6
6
7
7
There are two plans to use when querying subgraphs on The Graph Network.
8
8
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.
10
10
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
+
<VideoEmbedyoutube="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.
12
23
13
24
## Query Payments with GRT
14
25
@@ -20,14 +31,12 @@ Subgraph users can use The Graph Token (or GRT) to pay for queries on The Graph
20
31
21
32
### GRT on Arbitrum or Ethereum
22
33
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.
24
35
25
36
> 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).
26
37
27
38
### Adding GRT using a wallet
28
39
29
-
<VideoEmbedyoutube="4Bw2sh0FxCg" />
30
-
31
40
1. Go to the [Subgraph Studio Billing page](https://thegraph.com/studio/billing/).
32
41
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".
33
42
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
54
63
55
64
### Adding GRT using a multisig wallet
56
65
57
-
<VideoEmbedyoutube="eCgxp1Rag_0" />
58
-
59
66
1. Go to the [Subgraph Studio Billing page](https://thegraph.com/studio/billing/).
60
67
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.
61
68
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".
Copy file name to clipboardExpand all lines: website/pages/en/cookbook/subgraph-debug-forking.mdx
+2-2Lines changed: 2 additions & 2 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -44,12 +44,12 @@ export function handleUpdatedGravatar(event: UpdatedGravatar): void {
44
44
}
45
45
```
46
46
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.
48
48
49
49
The usual way to attempt a fix is:
50
50
51
51
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).
53
53
3. Wait for it to sync-up.
54
54
4. If it breaks again go back to 1, otherwise: Hooray!
Copy file name to clipboardExpand all lines: website/pages/en/deploying/deploying-a-subgraph-to-hosted.mdx
+11-11Lines changed: 11 additions & 11 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -2,19 +2,19 @@
2
2
title: Deploying a Subgraph to the Hosted Service
3
3
---
4
4
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.
6
6
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).
8
8
9
-
## Create a Hosted Service account
9
+
## Create a hosted service account
10
10
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.
12
12
13
13
## Store the Access Token
14
14
15
15
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.
16
16
17
-
## Create a Subgraph on the Hosted Service
17
+
## Create a Subgraph on the hosted service
18
18
19
19
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:
20
20
@@ -34,7 +34,7 @@ Before deploying the subgraph, you need to create it in The Graph Explorer. Go t
34
34
35
35
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).
36
36
37
-
## Deploy a Subgraph on the Hosted Service
37
+
## Deploy a Subgraph on the hosted service
38
38
39
39
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.
40
40
@@ -243,7 +243,7 @@ A working example of this can be found [here](https://github.com/graphprotocol/e
243
243
244
244
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.
245
245
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:
247
247
248
248
```graphql
249
249
{
@@ -274,13 +274,13 @@ This will give you the `chainHeadBlock` which you can compare with the `latestBl
274
274
275
275
## Hosted service subgraph archive policy
276
276
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.
278
278
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.
280
280
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.**
282
282
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.
Copy file name to clipboardExpand all lines: website/pages/en/deploying/subgraph-studio.mdx
+1-1Lines changed: 1 addition & 1 deletion
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -36,7 +36,7 @@ Querying subgraphs generates query fees, used to reward [Indexers](/network/inde
36
36
37
37
## Subgraph Compatibility with The Graph Network
38
38
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:
40
40
41
41
- Index a [supported network](/developing/supported-networks)
Copy file name to clipboardExpand all lines: website/pages/en/network/benefits.mdx
+23-25Lines changed: 23 additions & 25 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -11,7 +11,7 @@ Here is an analysis:
11
11
12
12
## Why You Should Use The Graph Network
13
13
14
-
-60-98% lower monthly cost
14
+
-Significantly lower monthly costs
15
15
- $0 infrastructure setup costs
16
16
- Superior uptime
17
17
- Access to hundreds of independent Indexers around the world
@@ -21,67 +21,65 @@ Here is an analysis:
21
21
22
22
### Lower & more Flexible Cost Structure
23
23
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.
25
25
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).
27
27
28
-
## Low Volume User (less than 30,000 queries per month)
28
+
## Low Volume User (less than 100,000 queries per month)
| 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 |
63
63
| Number of nodes needed | 10 | Not applicable |
64
64
| 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|
67
67
| Infrastructure | Centralized | Decentralized |
68
68
| Geographic redundancy | $1,200 in total costs per additional node | Included |
69
69
| Uptime | Varies | 99.9%+ |
70
-
| Total Monthly Costs | <spanclassName="highlight-row" /> $11,000+ | $4,500|
70
+
| Total Monthly Costs | <spanclassName="highlight-row" /> $11,000+ | $1,200|
71
71
72
72
\*including costs for backup: $50-$100 per month
73
73
74
74
<sup>†</sup>Engineering time based on $200 per hour assumption
75
75
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.
77
77
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.
79
79
80
80
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).
81
81
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.
83
82
84
-
Note that gas fees on [Arbitrum](/arbitrum/arbitrum-faq) are substantially lower than Ethereum mainnet.
85
83
86
84
## No Setup Costs & Greater Operational Efficiency
0 commit comments