Skip to main content

Connect your an RPC Endpoint

SubQuery TeamAbout 2 min

Connect your an RPC Endpoint

Node Operators can run either data indexing projects or RPC endpoints for the network (or both). If you instead want to sync a data indexing project, please follow the instructions here.

Connect any RPC

The SubQuery Network does not control how your run the underlying RPC endpoint to the Network, only that you connect and announce a standard EVM endpoint that is able to consume public queries.

This means you can run existing RPC endpoint used for other purposes (includng other decentralised RPC networks) to the SubQuery Network.

Prerequisites

This guide assumes you are already a running an RPC node that is publicly available on a known IP address/port.

For example with Etheruem, it can any client (geth or erigon etc), and it is listening on a known address and port (in the examples below our node is listening on 192.168.1.100:8545).

Please consult the relevant guides for how to run an RPC node on each network, for example this is the guide for Geth on Ethereumopen in new window, and Baseopen in new window.

1. Add Project

Inside your Node Operator Admin App (usually this is http://localhost:8000/ depending on your installation), the Projects tab appears at the top of the page. This enables Node Operators to add projects of their choice to their Node Operator profile.

Before clicking Add Project, you will need to obtain the project's deployment ID. If the project has already been deployed and synced by other Node Operators, you will be able to obtain the project’s Deployment ID from the SubQuery Exploreropen in new window.

Enter the project deployment ID when adding the new project, in our case, it is QmNa36oZ4zRS1i2wQhiFznU5DjEuNP3wopV6U3VcUWMUKu.

Add a rpc project

2. Connect your local RPC node

Input the public endpoint of your local node, then backend will run some verification on the endpoint to check whether it matches the manifest of the project, e.g chainId, node type, localness.

Be aware that coordinator service runs in docker, so localhost doesn't work like it runs outside of docker. You should use the internal ip address to connect to the node, or host.docker.internal which points to the host localhost.

Connect local node

3. Go Online

Click Go Online, which will then trigger your wallet to sign a transaction, then your RPC is announced online and is available to query.

4. Allocate SQT to the Project and Monitor

To earn Network Allocation Rewards for your project, you should immediately allocate SQT to your new project. Please follow the guide here.

On the Network app, the Node Operator can check the era information and confirm that the reward collection is up-to-date. The service log component provides the logs for the coordinator service.

Monitor your eligibility for rewards from the Admin Portal, if your node is out of sync or not reachable, you may not receive rewards.

Congratulations! You have successfully synced your SubQuery RPC Endpoint.

  • If you encounter any trouble while running the the Node Operator service, please visit Troubleshooting) and find all your solutions in one place.
  • Find the list of FAQs, and resolve your query.