Deploy a Subgraph to the Subgraph Studio
Last updated
Was this helpful?
Last updated
Was this helpful?
Deploying a Subgraph to the Subgraph Studio is quite simple. This will take you through the steps to:
Install The Graph CLI (with both yarn and npm)
Create your Subgraph in the Subgraph Studio
Authenticate your account from the CLI
Deploying a Subgraph to the Subgraph Studio
We are using the same CLI to deploy subgraphs to the . Here are the commands to install graph-cli. This can be done using npm or yarn.
Install with yarn:
Install with npm:
Before deploying your actual subgraph you need to create a subgraph in . We recommend you read our to learn more about this.
Once your subgraph has been created in Subgraph Studio you can initialize the subgraph code using this command:
The <SUBGRAPH_SLUG> value can be found on your subgraph details page in Subgraph Studio:
After running graph init, you will be asked to input the contract address, network, and ABI that you want to query. Doing this will generate a new folder on your local machine with some basic code to start working on your subgraph. You can then finalize your subgraph to make sure it works as expected.
Before being able to deploy your subgraph to Subgraph Studio, you need to login into your account within the CLI. To do this, you will need your deploy key that you can find on your "My Subgraphs" page or your subgraph details page.
Here is the command that you need to use to authenticate from the CLI:
Once you are ready, you can deploy your subgraph to Subgraph Studio. Doing this won't publish your subgraph to the decentralized network, it will only deploy it to your Studio account where you will be able to test it and update the metadata.
Here is the CLI command that you need to use to deploy your subgraph.
After running this command, the CLI will ask for a version label, you can name it however you want, you can use labels such as 0.1 and 0.2 or use letters as well such as uniswap-v2-0.1. Those labels will be visible in Graph Explorer and can be used by curators to decide if they want to signal on this version or not, so choose them wisely.
Once deployed, you can test your subgraph in Subgraph Studio using the playground, deploy another version if needed, update the metadata, and when you are ready, publish your subgraph to Graph Explorer.
