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
* updated billing page with free and growth plan details (still no multisig details, no stripe, and no premium)
* Altered formatting
* Added multisig section (but need to validate when able to test on prod)
* Minor tweaks
* Updated FAQ section
* minor tweaks
* minor tweaking (again)
* small fix
---------
Co-authored-by: Brandon Kramer <[email protected]>
Copy file name to clipboardExpand all lines: website/pages/en/billing.mdx
+63-84
Original file line number
Diff line number
Diff line change
@@ -2,104 +2,73 @@
2
2
title: Billing
3
3
---
4
4
5
-
> Invoices are generated on a weekly basis.
5
+
## Subgraph Billing Plans
6
6
7
-
There are two options for paying for your query fees:
7
+
There are two plans to use when querying subgraphs on The Graph Network.
8
8
9
-
-[Paying with fiat currency with Banxa](#billing-with-banxa)
10
-
-[Paying with crypto wallet](#billing-on-arbitrum)
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.
11
10
12
-
## Billing with Banxa
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.
13
12
14
-
Banxa enables you to bypass the need for an exchange and pay for your query fees using the fiat currency of your choice. The fiat currency will be converted to GRT, added to your account balance on the billing contract, and used to pay for queries associated with your API keys.
13
+
## Query Payments with GRT
15
14
16
-
There may be KYC requirements depending on the regulations in your country. For more information about KYC, please visit [Banxa's FAQ page](https://docs.banxa.com/docs/faqs).
17
-
18
-
You can learn more about Banxa by reading their [documentation](https://docs.banxa.com/docs).
19
-
20
-
### Paying for query fees with Banxa
21
-
22
-
1. Select “Pay with Card” option in [Subgraph Studio](https://thegraph.com/studio/billing/?show=Deposit).
23
-
2. Enter the amount of GRT to be added to your account balance.
24
-
3. Click the 'Continue with Banxa' button.
25
-
4. Enter necessary banking information on Banxa including payment method & fiat currency of choice.
26
-
5. Finish the transaction.
27
-
28
-
It may take up to 10 minutes to complete the transaction. Once the transaction is confirmed, the purchased GRT will automatically be added to your account balance on Arbitrum.
29
-
30
-
## Billing on Arbitrum
31
-
32
-
While The Graph protocol operates on Ethereum Mainnet, [the billing contract](https://arbiscan.io/address/0x1b07d3344188908fb6deceac381f3ee63c48477a) lives on the [Arbitrum](https://arbitrum.io/) network to reduce transaction times and cost. You'll be required to pay the query fees generated from your API keys. Using the billing contract, you'll be able to:
15
+
Subgraph users can use The Graph Token (or GRT) to pay for queries on The Graph Network. With GRT, invoices will be processed at the end of each month and require a sufficient balance of GRT to make queries beyond the Free Plan quota of 100,000 monthly queries. You'll be required to pay fees generated from your API keys. Using the billing contract, you'll be able to:
33
16
34
17
- Add and withdraw GRT from your account balance.
35
18
- Keep track of your balances based on how much GRT you have added to your account balance, how much you have removed, and your invoices.
36
19
- Automatically pay invoices based on query fees generated, as long as there is enough GRT in your account balance.
37
20
38
-
### Adding GRT using a crypto wallet
21
+
### GRT on Arbitrum or Ethereum
39
22
40
-
<VideoEmbedyoutube="4Bw2sh0FxCg" />
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.
41
24
42
-
> This section is written assuming you already have GRT in your crypto wallet, and you're on Ethereum mainnet. If you don't have GRT, you can learn how to get GRT [here](#getting-grt).
25
+
> 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).
43
26
44
-
For a video walkthrough of adding GRT to your billing balance using a crypto wallet, watch this [video](https://youtu.be/4Bw2sh0FxCg).
27
+
### Adding GRT using a wallet
45
28
46
-
1. Go to the [Subgraph Studio Billing page](https://thegraph.com/studio/billing/).
29
+
<VideoEmbedyoutube="4Bw2sh0FxCg" />
47
30
31
+
1. Go to the [Subgraph Studio Billing page](https://thegraph.com/studio/billing/).
48
32
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".
49
-
50
-
3. Click the 'Add GRT' button at the center of the page. A side panel will appear.
51
-
52
-
4. Enter the amount of GRT you want to add to your account balance. You can also select the maximum amount of GRT you want to add to your account balance by clicking on the "Max" button.
53
-
54
-
5. Click 'Allow GRT Access' to allow the Subgraph Studio to access your GRT. Sign the associated transaction in your wallet. This will not cost any gas.
55
-
56
-
6. Click 'Add GRT to account balance' to add the GRT to your account balance. Sign the associated transaction in your wallet. This will cost gas.
57
-
58
-
7. Once the transaction is confirmed, you'll see the GRT added to your account balance within an hour.
59
-
60
-
### Withdrawing GRT using a crypto wallet
61
-
62
-
> This section is written assuming you have deposited GRT into your account balance on [Subgraph Studio](https://thegraph.com/studio/billing/) and that you're on the Arbitrum network.
63
-
64
-
1. Go to the [Subgraph Studio Billing page](https://thegraph.com/studio/billing/).
65
-
33
+
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".
34
+
4. Use the slider to estimate the number of queries you expect to make on a monthly basis.
35
+
- For suggestions on the number of queries you may use, see our **Frequently Asked Questions** page.
36
+
5. Choose "Cryptocurrency". GRT is currently the only cryptocurrency accepted on The Graph Network.
37
+
6. Select the number of months you would like to prepay.
38
+
- Paying in advance does not commit you to future usage. You will only be charged for what you use and you can withdraw your balance at any time.
39
+
7. Pick the network from which you are depositing your GRT. GRT on Arbitrum or Ethereum are both acceptable.
40
+
8. Click "Allow GRT Access" and then specify the amount of GRT that can be taken from you wallet.
41
+
- If you are prepaying for multiple months, you must allow access to the amount that corresponds with that amount. This interaction will not cost any gas.
42
+
9. Lastly, click on "Add GRT to Billing Balance". This transaction will require ETH on Arbitrum to cover the gas costs.
43
+
44
+
- Note that GRT deposited from Arbitrum will process within a few moments while GRT deposited from Ethereum will take approximately 15-20 minutes to process. Once the transaction is confirmed, you'll see the GRT added to your account balance.
45
+
46
+
### Withdrawing GRT using a wallet
47
+
48
+
1. Go to the [Subgraph Studio Billing page](https://thegraph.com/studio/billing/).
66
49
2. Click on the "Connect Wallet" button on the top right corner of the page. Select your wallet and click on "Connect".
67
-
68
-
3. Click the dropdown next to the 'Add GRT' button at the center of the page. Select withdraw GRT. A side panel will appear.
69
-
50
+
3. Click the "Manage"" button at the top right corner of the page. Select "Withdraw GRT". A side panel will appear.
70
51
4. Enter the amount of GRT you would like to withdraw.
71
-
72
52
5. Click 'Withdraw GRT' to withdraw the GRT from your account balance. Sign the associated transaction in your wallet. This will cost gas. The GRT will be sent to your Arbitrum wallet.
73
-
74
53
6. Once the transaction is confirmed, you'll see the GRT withdrawn from your account balance in your Arbitrum wallet.
75
54
76
55
### Adding GRT using a multisig wallet
77
56
78
57
<VideoEmbedyoutube="eCgxp1Rag_0" />
79
58
80
59
1. Go to the [Subgraph Studio Billing page](https://thegraph.com/studio/billing/).
81
-
82
60
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.
83
-
84
-
3. Click the 'Add GRT' button at the center of the page. A side panel will appear.
85
-
86
-
4. Once the transaction is confirmed, you'll see the GRT added to your account balance within an hour.
87
-
88
-
### Withdrawing GRT using a multisig wallet
89
-
90
-
> This section is written assuming you have deposited GRT into your account balance on [Subgraph Studio](https://thegraph.com/studio/billing/) and that you're on Ethereum mainnet.
91
-
92
-
1. Go to the [Subgraph Studio Billing page](https://thegraph.com/studio/billing/).
93
-
94
-
2. Click on the "Connect Wallet" button on the top right corner of the page. Select your wallet and click on "Connect".
95
-
96
-
3. Click the dropdown next to the 'Add GRT' button at the center of the page. Select withdraw GRT. A side panel will appear.
97
-
98
-
4. Enter the amount of GRT you would like to withdraw. Specify the receiving wallet which will receive the GRT from this transaction. The GRT will be sent to the receiving wallet on Arbitrum.
99
-
100
-
5. Click 'Withdraw GRT' to withdraw the GRT from your account balance. Sign the associated transaction in your wallet. This will cost gas.
101
-
102
-
6. Once the transaction is confirmed, you'll see the GRT added to your Arbitrum wallet within an hour.
61
+
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".
62
+
4. Use the slider to estimate the number of queries you expect to make on a monthly basis.
63
+
- For suggestions on the number of queries you may use, see our **Frequently Asked Questions** page.
64
+
5. Choose "Cryptocurrency". GRT is currently the only cryptocurrency accepted on The Graph Network.
65
+
6. Select the number of months you would like to prepay.
66
+
- Paying in advance does not committing you to future usage. You will only be charged for what you use and you can withdraw your balance at any time.
67
+
7. Pick the network from which you are depositing your GRT. GRT on Arbitrum or Ethereum are both acceptable. 8. Click "Allow GRT Access" and then specify the amount of GRT that can be taken from you wallet.
68
+
- If you are prepaying for multiple months, you must allow access to the amount that corresponds with that amount. This interaction will not cost any gas.
69
+
8. Lastly, click on "Add GRT to Billing Balance". This transaction will require ETH on Arbitrum to cover the gas costs.
70
+
71
+
- Note that GRT deposited from Arbitrum will process within a few moments while GRT deposited from Ethereum will take approximately 15-20 minutes to process. Once the transaction is confirmed, you'll see the GRT added to your account balance.
103
72
104
73
## Getting GRT
105
74
@@ -117,11 +86,11 @@ This will be a step by step guide for purchasing GRT on Coinbase.
117
86
6. Select the amount of GRT you want to purchase.
118
87
7. Review your purchase. Review your purchase and click "Buy GRT".
119
88
8. Confirm your purchase. Confirm your purchase and you will have successfully purchased GRT.
120
-
9. You can transfer the GRT from your account to your crypto wallet such as [MetaMask](https://metamask.io/).
121
-
- To transfer the GRT to your crypto wallet, click on the "Accounts" button on the top right of the page.
89
+
9. You can transfer the GRT from your account to your wallet such as [MetaMask](https://metamask.io/).
90
+
- To transfer the GRT to your wallet, click on the "Accounts" button on the top right of the page.
122
91
- Click on the "Send" button next to the GRT account.
123
92
- Enter the amount of GRT you want to send and the wallet address you want to send it to.
124
-
- Click "Continue" and confirm your transaction. -Please note that for larger purchase amounts, Coinbase may require you to wait 7-10 days before transferring the full amount to a crypto wallet.
93
+
- Click "Continue" and confirm your transaction. -Please note that for larger purchase amounts, Coinbase may require you to wait 7-10 days before transferring the full amount to a wallet.
125
94
126
95
You can learn more about getting GRT on Coinbase [here](https://help.coinbase.com/en/coinbase/trading-and-funding/buying-selling-or-converting-crypto/how-do-i-buy-digital-currency).
127
96
@@ -137,8 +106,8 @@ This will be a step by step guide for purchasing GRT on Binance.
137
106
6. Select the amount of GRT you want to purchase.
138
107
7. Review your purchase and click "Buy GRT".
139
108
8. Confirm your purchase and you will be able to see your GRT in your Binance Spot Wallet.
140
-
9. You can withdraw the GRT from your account to your crypto wallet such as [MetaMask](https://metamask.io/).
141
-
-[To withdraw](https://www.binance.com/en/blog/ecosystem/how-to-transfer-crypto-from-binance-to-trust-wallet-8305050796630181570) the GRT to your crypto wallet, add your crypto wallet's address to the withdrawel whitelist.
109
+
9. You can withdraw the GRT from your account to your wallet such as [MetaMask](https://metamask.io/).
110
+
-[To withdraw](https://www.binance.com/en/blog/ecosystem/how-to-transfer-crypto-from-binance-to-trust-wallet-8305050796630181570) the GRT to your wallet, add your wallet's address to the withdrawel whitelist.
142
111
- Click on the "wallet" button, click withdraw, and select GRT.
143
112
- Enter the amount of GRT you want to send and the whitelisted wallet address you want to send it to.
144
113
- Click "Continue" and confirm your transaction.
@@ -159,9 +128,9 @@ This is how you can purchase GRT on Uniswap.
159
128
160
129
You can learn more about getting GRT on Uniswap [here](https://support.uniswap.org/hc/en-us/articles/8370549680909-How-to-Swap-Tokens-).
161
130
162
-
## Getting Ethereum
131
+
## Getting Ether
163
132
164
-
This section will show you how to get Ethereum (ETH) to pay for transaction fees or gas costs. ETH is necessary to execute operations on the Ethereum network such as transferring tokens or interacting with contracts.
133
+
This section will show you how to get Ether (ETH) to pay for transaction fees or gas costs. ETH is necessary to execute operations on the Ethereum network such as transferring tokens or interacting with contracts.
165
134
166
135
### Coinbase
167
136
@@ -175,8 +144,8 @@ This will be a step by step guide for purchasing ETH on Coinbase.
175
144
6. Enter the amount of ETH you want to purchase.
176
145
7. Review your purchase and click "Buy ETH".
177
146
8. Confirm your purchase and you will have successfully purchased ETH.
178
-
9. You can transfer the ETH from your Coinbase account to your crypto wallet such as [MetaMask](https://metamask.io/).
179
-
- To transfer the ETH to your crypto wallet, click on the "Accounts" button on the top right of the page.
147
+
9. You can transfer the ETH from your Coinbase account to your wallet such as [MetaMask](https://metamask.io/).
148
+
- To transfer the ETH to your wallet, click on the "Accounts" button on the top right of the page.
180
149
- Click on the "Send" button next to the ETH account.
181
150
- Enter the amount of ETH you want to send and the wallet address you want to send it to.
182
151
- Ensure that you are sending to your Ethereum wallet address on Arbitrum One.
@@ -196,15 +165,25 @@ This will be a step by step guide for purchasing ETH on Binance.
196
165
6. Enter the amount of ETH you want to purchase.
197
166
7. Review your purchase and click "Buy ETH".
198
167
8. Confirm your purchase and you will see your ETH in your Binance Spot Wallet.
199
-
9. You can withdraw the ETH from your account to your crypto wallet such as [MetaMask](https://metamask.io/).
200
-
- To withdraw the ETH to your crypto wallet, add your crypto wallet's address to the withdrawal whitelist.
168
+
9. You can withdraw the ETH from your account to your wallet such as [MetaMask](https://metamask.io/).
169
+
- To withdraw the ETH to your wallet, add your wallet's address to the withdrawal whitelist.
201
170
- Click on the "wallet" button, click withdraw, and select ETH.
202
171
- Enter the amount of ETH you want to send and the whitelisted wallet address you want to send it to.
203
172
- Ensure that you are sending to your Ethereum wallet address on Arbitrum One.
204
173
- Click "Continue" and confirm your transaction.
205
174
206
175
You can learn more about getting ETH on Binance [here](https://www.binance.com/en/support/faq/how-to-buy-cryptocurrency-on-binance-homepage-400c38f5e0cd4b46a1d0805c296b5582).
207
176
208
-
## Arbitrum Bridge
177
+
## Billing FAQs
178
+
179
+
### How many queries will I need?
180
+
181
+
You don't need to know how many queries you'll need in advance. You will only be charged for what you use and you can withdrawal GRT from your account at any time.
182
+
183
+
We recommend you overestimate the number of queries you will need so that you don’t have to top up your balance frequently. A good estimate for small to medium sized applications is to start with 1M-2M queries per month and monitor usage closely in the first weeks. For larger apps, a good estimate is to use the number of daily visits your site gets multiplied by the number of queries your most active page makes upon opening.
184
+
185
+
Of course, both new and existing users can reach out to Edge & Node's BD team for a consult to learn more about anticipated usage.
186
+
187
+
### Can I withdrawal GRT from my billing balance?
209
188
210
-
The billing contract is only designed to bridge GRT from Ethereum mainnet to the Arbitrum network. If you'd like to transfer your GRT from Arbitrum back to Ethereum mainnet, you'll need to use the [Arbitrum Bridge](https://bridge.arbitrum.io/?l2ChainId=42161).
189
+
Yes, you can always withdrawal GRT that has not already been used for queries from your billing balance. The billing contract is only designed to bridge GRT from Ethereum mainnet to the Arbitrum network. If you'd like to transfer your GRT from Arbitrum back to Ethereum mainnet, you'll need to use the [Arbitrum Bridge](https://bridge.arbitrum.io/?l2ChainId=42161).
0 commit comments