# CLI

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

The following operations are supported within `bcl nodes <OPERATION>`

| Operation      | Description                       |
| -------------- | --------------------------------- |
| chains         | Get list of supported blockchains |
| info           | Get information on a node         |
| list (default) | Get list of nodes                 |
| remove         | Remove a node                     |
| services       | Get list of Bloq Node services    |

#### Creating a New Node

Creation of a node must be done through the [Bloq Console](https://console.bloq.cloud/nodes/single/new). 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 supported chains

Viewing all blockchains supported by BloqNodes is accessed through the command: `bcl nodes chains`. The user will be able to view the list of all chains that are offered by Bloq Nodes.

#### Getting node information

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.

#### 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.

#### Removing a node <a href="#removing-a-node" id="removing-a-node"></a>

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.

#### Listing Bloq services <a href="#listing-bloq-services" id="listing-bloq-services"></a>

Viewing all services offered by Bloq Nodes is accessed through the command: `bcl nodes services`. The user will be able to view a comprehensive list of all types of nodes that can be accessed by the Bloq Nodes service. Specifications include the chain, region, performance tier, software version, and service id.
