Skip to content

Latest commit

 

History

History
208 lines (136 loc) · 12.9 KB

billing.mdx

File metadata and controls

208 lines (136 loc) · 12.9 KB
title
Billing

Invoices are generated on a weekly basis.

There are two options for paying for your query fees:

Billing with Banxa

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.

There may be KYC requirements depending on the regulations in your country. For more information about KYC, please visit Banxa's FAQ page.

You can learn more about Banxa by reading their documentation.

Paying for query fees with Banxa

  1. Select “Pay with Card” option in Subgraph Studio.
  2. Enter the amount of GRT to be added to your account balance.
  3. Click the 'Continue with Banxa' button.
  4. Enter necessary banking information on Banxa including payment method & fiat currency of choice.
  5. Finish the transaction.

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.

Billing on Arbitrum

While The Graph protocol operates on Ethereum Mainnet, the billing contract lives on the Arbitrum 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:

  • Add and withdraw GRT from your account balance.
  • 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.
  • Automatically pay invoices based on query fees generated, as long as there is enough GRT in your account balance.

Adding GRT using a crypto wallet

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.

For a video walkthrough of adding GRT to your billing balance using a crypto wallet, watch this video.

  1. Go to the Subgraph Studio Billing page.

  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".

  3. Click the 'Add GRT' button at the center of the page. A side panel will appear.

  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.

  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.

  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.

  7. Once the transaction is confirmed, you'll see the GRT added to your account balance within an hour.

Withdrawing GRT using a crypto wallet

This section is written assuming you have deposited GRT into your account balance on Subgraph Studio and that you're on the Arbitrum network.

  1. Go to the Subgraph Studio Billing page.

  2. Click on the "Connect Wallet" button on the top right corner of the page. Select your wallet and click on "Connect".

  3. Click the dropdown next to the 'Add GRT' button at the center of the page. Select withdraw GRT. A side panel will appear.

  4. Enter the amount of GRT you would like to withdraw.

  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.

  6. Once the transaction is confirmed, you'll see the GRT withdrawn from your account balance in your Arbitrum wallet.

Adding GRT using a multisig wallet

  1. Go to the Subgraph Studio Billing page.

  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, 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.

  3. Click the 'Add GRT' button at the center of the page. A side panel will appear.

  4. Once the transaction is confirmed, you'll see the GRT added to your account balance within an hour.

Withdrawing GRT using a multisig wallet

This section is written assuming you have deposited GRT into your account balance on Subgraph Studio and that you're on Ethereum mainnet.

  1. Go to the Subgraph Studio Billing page.

  2. Click on the "Connect Wallet" button on the top right corner of the page. Select your wallet and click on "Connect".

  3. Click the dropdown next to the 'Add GRT' button at the center of the page. Select withdraw GRT. A side panel will appear.

  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.

  5. Click 'Withdraw GRT' to withdraw the GRT from your account balance. Sign the associated transaction in your wallet. This will cost gas.

  6. Once the transaction is confirmed, you'll see the GRT added to your Arbitrum wallet within an hour.

Getting GRT

This section will show you how to get GRT to pay for query fees.

Coinbase

This will be a step by step guide for purchasing GRT on Coinbase.

  1. Go to Coinbase and create an account.
  2. Once you have created an account, you will need to verify your identity through a process known as KYC (or Know Your Customer). This is a standard procedure for all centralized or custodial crypto exchanges.
  3. Once you have verified your identity, you can purchase GRT. You can do this by clicking on the "Buy/Sell" button on the top right of the page.
  4. Select the currency you want to purchase. Select GRT.
  5. Select the payment method. Select your preferred payment method.
  6. Select the amount of GRT you want to purchase.
  7. Review your purchase. Review your purchase and click "Buy GRT".
  8. Confirm your purchase. Confirm your purchase and you will have successfully purchased GRT.
  9. You can transfer the GRT from your account to your crypto wallet such as MetaMask.
    • To transfer the GRT to your crypto wallet, click on the "Accounts" button on the top right of the page.
    • Click on the "Send" button next to the GRT account.
    • Enter the amount of GRT you want to send and the wallet address you want to send it to.
    • 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.

You can learn more about getting GRT on Coinbase here.

Binance

This will be a step by step guide for purchasing GRT on Binance.

  1. Go to Binance and create an account.
  2. Once you have created an account, you will need to verify your identity through a process known as KYC (or Know Your Customer). This is a standard procedure for all centralized or custodial crypto exchanges.
  3. Once you have verified your identity, you can purchase GRT. You can do this by clicking on the "Buy Now" button on the homepage banner.
  4. You will be taken to a page where you can select the currency you want to purchase. Select GRT.
  5. Select your preferred payment method. You'll be able to pay with different fiat currencies such as Euros, US Dollars, and more.
  6. Select the amount of GRT you want to purchase.
  7. Review your purchase and click "Buy GRT".
  8. Confirm your purchase and you will be able to see your GRT in your Binance Spot Wallet.
  9. You can withdraw the GRT from your account to your crypto wallet such as MetaMask.
    • To withdraw the GRT to your crypto wallet, add your crypto wallet's address to the withdrawel whitelist.
    • Click on the "wallet" button, click withdraw, and select GRT.
    • Enter the amount of GRT you want to send and the whitelisted wallet address you want to send it to.
    • Click "Continue" and confirm your transaction.

You can learn more about getting GRT on Binance here.

Uniswap

This is how you can purchase GRT on Uniswap.

  1. Go to Uniswap and connect your wallet.
  2. Select the token you want to swap from. Select ETH.
  3. Select the token you want to swap to. Select GRT.
    • Make sure you're swapping for the correct token. The GRT smart contract address is: 0xc944E90C64B2c07662A292be6244BDf05Cda44a7
  4. Enter the amount of ETH you want to swap.
  5. Click "Swap".
  6. Confirm the transaction in your wallet and you wait for the transaction to process.

You can learn more about getting GRT on Uniswap here.

Getting Ethereum

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.

Coinbase

This will be a step by step guide for purchasing ETH on Coinbase.

  1. Go to Coinbase and create an account.
  2. Once you have created an account, verify your identity through a process known as KYC (or Know Your Customer). This is a standard procedure for all centralized or custodial crypto exchanges.
  3. Once you have verified your identity, purchase ETH by clicking on the "Buy/Sell" button on the top right of the page.
  4. Select the currency you want to purchase. Select ETH.
  5. Select your preferred payment method.
  6. Enter the amount of ETH you want to purchase.
  7. Review your purchase and click "Buy ETH".
  8. Confirm your purchase and you will have successfully purchased ETH.
  9. You can transfer the ETH from your Coinbase account to your crypto wallet such as MetaMask.
    • To transfer the ETH to your crypto wallet, click on the "Accounts" button on the top right of the page.
    • Click on the "Send" button next to the ETH account.
    • Enter the amount of ETH you want to send and the wallet address you want to send it to.
    • Click "Continue" and confirm your transaction.

You can learn more about getting ETH on Coinbase here.

Binance

This will be a step by step guide for purchasing ETH on Binance.

  1. Go to Binance and create an account.
  2. Once you have created an account, verify your identity through a process known as KYC (or Know Your Customer). This is a standard procedure for all centralized or custodial crypto exchanges.
  3. Once you have verified your identity, purchase ETH by clicking on the "Buy Now" button on the homepage banner.
  4. Select the currency you want to purchase. Select ETH.
  5. Select your preferred payment method.
  6. Enter the amount of ETH you want to purchase.
  7. Review your purchase and click "Buy ETH".
  8. Confirm your purchase and you will see your ETH in your Binance Spot Wallet.
  9. You can withdraw the ETH from your account to your crypto wallet such as MetaMask.
    • To withdraw the ETH to your crypto wallet, add your crypto wallet's address to the withdrawal whitelist.
    • Click on the "wallet" button, click withdraw, and select ETH.
    • Enter the amount of ETH you want to send and the whitelisted wallet address you want to send it to.
    • Click "Continue" and confirm your transaction.

You can learn more about getting ETH on Binance here.

Arbitrum Bridge

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.