Nodes Overview

The BloqCloud Nodes service enables users to create a new dedicated, managed blockchain node.

Currently, the Nodes service supports the Bitcoin (BTC) and Bitcoin Cash (BCH), Ethereum (ETH) and Ethereum Classic (ETC) chains. Please check the command line interface for the latest available blockchain software versions available.

CLI

The bcl nodes command is used to access the Nodes service.

The following operations are supported within bcl nodes <OPERATION>

Operation Description
info Get information on a node
list (default) Get list of nodes
remove Remove a node

Creating a New Node

TIP

Creation of a node must be done through the Cloud Console. For the moment you are not allowed to use the CLI to spin a new node.

TIP

Once initialization of a node is complete, a node will require some time to catch-up to the latest blocks on the blockchain. A node is created using a recent snapshot of the blockchain and generally needs to catch-up for the last few hours of data.

The duration to sync to the latest blockchain data will vary across blockchains. Upon completion of the sync, the node is ready for usage.

Listing Nodes

Viewing the list of active nodes is accessed through the command: bcl nodes list.
The user will be able to view the list of nodes including the node ID and the time the node was initialized.

Getting Node Info

To retrieve information on a node, use the command: bcl nodes info.
The user will receive a prompt for the Node ID. Upon providing the Node ID, the CLI will provide detailed information on the node.

Removing a Node

To remove a node, use the command: bcl nodes remove.
The user will receive a prompt for the Node ID. Upon providing the Node ID, and confirmation for the removal of the node, the node will be removed.

Nodes Usage

To access a node, you will need to use the IP address which you can obtain from the bcl nodes list or the bcl nodes info command.

You will also need to generate a client token which you can get with:

bcl client-token

From there you may access the REST or RPC interfaces (described in the Technical Reference) using curl or any other HTTP client.

REST

curl -k -X GET \
  --user <nodeUser>:<nodePass> \
  https://<ip-address>:8332/rest/chaininfo.json

JSON RPC

curl -k -X POST \
  --user <nodeUser>:<nodePass> \
  -H 'Content-Type: application/json' \
  -d '{"jsonrpc": "1.0", "id":"curltest", "method": "getblockchaininfo", "params": [] }' \
  https://<ip-address>:8332/
Last updated: 8/19/2019, 11:09:00 PM