BloqNodes Setup
Nodes is one of the core services of Bloq. In this tutorial you will learn how to set up and start using a Bloq node on your network of choice.
Last updated
Was this helpful?
Nodes is one of the core services of Bloq. In this tutorial you will learn how to set up and start using a Bloq node on your network of choice.
Last updated
Was this helpful?
Before you can create a new node, you first need to . If you have not done so, please refer to the corresponding guide.
In order to create a new node you must always use . We also provide the and the where you can perform some other actions like retrieve node info or stop a running node.
Log into to spin up a new node. You can pick among different chains and networks and you can customize the performance, the region, and the authentication type.
Once you finish with the configuration, choose the billing plan that fits best and select your payment method.
After your payment is confirmed, you will see your new node in the and you will be able to access it.
Open the terminal and make sure that you have a valid session. If not, you can start one running bcl login
.
The CLI has the nodes
command which lets you list, remove or get info about your nodes. You can run bcl nodes info
to retrieve your node information:
Retrieving the node information using the REST API requires more steps than the CLI (which automates the whole authentication process). Aside from authentication, the CLI provides the same capabilities as the REST API.
As previously stated, a valid pair of client keys is required prior to using the service. The client keys let you generate your access and refresh tokens. The access token
grants you access to the Nodes Service, but for security reasons, the access token
is a short term token (expires after one hour). When the access token
expires, you can use the refresh token
(expires after one year but could be revoked) to get a new valid access token
.
access
and refresh
tokens.The first step is to use the client keys to generate access and refresh tokens. In this step you will request access directly to our Accounts Service.
PublicIpAddress
TIP
IP is the URL that you are going to use to connect and access your node.
At the moment, the supported chains are btc, btctestnet, bch, bchtestnet, ltc, eth, and ethropsten.
Mainnet and testnet Bloq nodes on Bitcoin, Bitcoin Cash, and Litecoin (mainnet only) are all accessible through REST and JSON RPC interfaces. To access your node, you must use the proper IP
port corresponding to the node's chain:
Bitcoin (BTC)
Mainnet
8332
Bitcoin
Testnet
18332
Bitcoin Cash (BCH)
Mainnet
8332
Bitcoin Cash
Testnet
18332
Litecoin (LTC)
Mainnet
9332
Mainnet and Ropsten testnet Ethereum nodes are accessible through JSON and WebSocket RPC interfaces. ETH nodes do not support REST interface. To access your node, you must use the proper IP
port corresponding to the node's chain. There is a different port required for JSON RPC
and WebSocket RPC
commands:
Ethereum (ETH)
Mainnet
8545
JSON
Ethereum (Ropsten)
Testnet
8545
JSON
Ethereum (ETH)
Mainnet
8546
WebSocket
Ethereum (Ropsten)
Testnet
8546
WebSocket
Mainnet and testnet nodes are accessible through a JSON RPC interface. Avalanche nodes listen on the following ports:
Avalanche (AVAX)
Mainnet
9650, 8080
Avalanche
Testnet
9650, 8080
TIP
Your NodeUser
and NodePassword
are hexadecimal strings that are accessible through CLI or REST commands above, as well as through the Console website.
This username/password pair is unique for each node, and separate from your Bloq username and password.
To check how to renew your access token check section
In addition to the Bloq Console, CLI, and REST API, nodes may also be accessed via interfaces supported by their chain. These include REST, JSON RPC, and WebSocket RPC. Please see the section for more information.
You now have everything you need to create and request data from your nodes. For more information, please refer to the .