Setting up a subgraph on zkSync with Mobula’s infrastructure is an easy process. This tutorial will guide you through each step to get your subgraph operational on the zkSync network.

​
What you’ll need

  • Basic knowledge of The Graph and subgraphs.
  • Your subgraph project files
  • The Graph CLI installed
  • A Mobula API key (for authentication)

​
Walkthrough

1

Prepare Your Subgraph

Configure your subgraph for zkSync. Adjust your subgraph.yaml file to reference zkSync-specific contracts and events. If you don’t have a subgraph yet, you can clone the Uniswap V2 (zkSwap) subgraph template and tailor it for zkSync:

git clone https://github.com/MobulaFi/univ2-subgraph-zksync
2

Install Dependencies

Make sure you have The Graph CLI installed:

npm install -g @graphprotocol/graph-cli
3

Build Your Subgraph

Compile your subgraph before deployment:

graph codegen && graph build
4

Create the Subgraph

Use the following command to deploy your subgraph:

graph create --node https://subgraph.mobula.io:8020
5

Deploy to Mobula's zkSync Node

Use the following command to deploy your subgraph:

graph deploy --node https://subgraph.mobula.io:8020 --ipfs https://subgraph.mobula.io:5001 --network zksync
6

Authenticate

When requested, input your Mobula API key for authentication. Check the authentication section for detailed instructions on obtaining and using your API key.

7

Monitor Deployment

After deployment, you’ll receive a URL to monitor your subgraph’s indexing progress and status.

​
Best Practices

  • Ensure your subgraph is consistently updated to stay compatible with the latest zkSync network changes.
  • Perform thorough testing on a testnet before deploying to the mainnet.
  • Regularly monitor its performance and optimize queries for improved efficiency.

​
Troubleshooting

If you face issues during deployment:

  • Review your subgraph.yaml file carefully.
  • Ensure the network name and Mobula node URLs are correct.
  • Check that your API key is valid and has the appropriate permissions.

Need help? Our support team is here to assist with any questions or deployment difficulties.

Support

Telegram

Support

Slack

Support

Discord

Email Support

Email
Deploying an Indexer (Subgraph) on zkLink with The GraphDeploying an Indexer (Subgraph) on Zora with The Graph