How to create and manage Query & Transact clusters

You can easily spin up a Query & Transact cluster from Coinbase Cloud.

1. Select the dropdown menu icon in the top left

2. Select QT clusters from the dropdown

3. Select your desired protocol from the list

4. Select Create

5. Name your cluster

6. Choose a provider and region

7. Select your desired number of nodes

8. Select a network

9. Select Review & pay

10. Complete required steps for payment and for reading and agreeing to the Terms of Service

11. Select Launch cluster

Once launched, it can take a cluster anywhere from a few minutes to several days in order to sync with the network. The wait time depends upon the protocol being used. A cluster is not active until it is synced and running. You will receive an email to alert you when the cluster is active.

Once your cluster is ready, to access it you will need to create an API access token or public access client.

When you are notified that your QT cluster is running, you will need to create either a public access client or an API access token in order to start using your cluster. A public access client allows for access without a username and password. API access tokens require usernames and passwords for authentication. Both options can have rate limits and IP allow lists.

API access tokens allow you to require a username and password (basic authentication) to access your Query & Transact cluster.

You can create multiple API access tokens, each with its own rate limits (number of requests per second/minute/hour and maximum requests per day). By default, all tokens allow unlimited requests.

Each token can also have its own authorized IP list. This list restricts access to your QT cluster by only permitting requests from IP addresses you specify. You can add as many IP addresses to your token’s allow list as needed by using commas to separate each domain. Addresses must be formatted as either 192.168.0.1 or 10.0.0.1/22. As a convenience, IP addresses can be formatted to include Classless Inter-Domain Routing (CIDR) information. 

API access tokens are long-lived and revocable at any time.

If you prefer to allow for public access to your cluster, create a public access client that does not require a username and password. Note that public access clients can have rate limits and IP allow lists.

QT clusters can have anywhere from 1 to 40 nodes across providers and regions. If at any time you want to increase or decrease the number of nodes in your cluster, log in to Coinbase Cloud and enter the cluster details from the Query & Transact homepage. Then go to the Configuration tab and add or remove nodes using the table provided.

Moving nodes from one region to another will cause temporary performance issues with your cluster.

• Moving some nodes: When you remove some, but not all, nodes from one region and add new nodes to another region, you may experience a temporary degradation of service due to the time required for your new nodes to sync with the chain.

• Moving all nodes: Removal of nodes from a cluster occurs instantaneously but addition of nodes requires time for them to sync with the chain. If you remove all nodes from a region before you have added nodes to a new region, you will experience a temporary disruption of service.

You can run as many Query & Transact clusters at a time as you need. Log in to create a new cluster or submit a request for access via the Coinbase Cloud platform to get access to more protocols.

To delete your cluster, you must remove all of its nodes. This action is permanent. A deleted cluster can not be recovered.

1. Go to the Configuration tab 

2. Click Delete all nodes in the table

3. Enter the name of your cluster in the modal window

4. Click Delete cluster

In order to prevent you from paying exorbitant gas fees, our clusters have default gas limits per call. We are able to change this amount to unlimited by request. Log in to the Coinbase Cloud platform to submit a request to discuss options.