List blockchain nodes

This page describes how to view a list of Blockchain Node Engine nodes using the console or an API call.

Using the console

The Nodes list displays a list of nodes that exist in Blockchain Node Engine. If no nodes have been created, you are prompted to create one as described in Create a blockchain node.

In the Google Cloud console, go to the Blockchain Node Engine page.

Go to Blockchain Node Engine

The Nodes list page is displayed by default.

Blockchain Node Engine Nodes list user interface

Here's what you can do on this page:

Action Option
View node information:
  • Name: The name you gave the node in Create a blockchain node. For example, my-new-node.
  • Status: The current node state. For example, Running. See State for all possible states.
  • Chain (Network): The blockchain and network you configured in Create a blockchain node. For example, Ethereum (Mainnet).
  • Node type: The type you configured in Create a blockchain node. For example, Full.
  • Location: The location you configured in Create a blockchain node. For example, us-central1.
  • JSON-RPC endpoint: The hostname of the blockchain node's JSON-RPC endpoint, generated by Google Cloud.
  • WebSocket endpoint: The hostname of the blockchain node's WebSocket endpoint, generated by Google Cloud.
Refine the list of nodes displayed:
Act on nodes:

Filter

To refine the list of nodes displayed:

  1. Create a filter query:

    1. Click in the filter box. A selection menu of the column names is displayed.
    2. Select a column name. For example, Status. A selection menu of the states is displayed.
    3. Select a state. For example, Running.
    4. Optionally, add an OR operator and then select other options to further modify your query. For example, Status: RUNNING OR Location: us-central1.

  2. Optionally, modify the query:

    • Click the X on the query chip to remove the query.
    • Click the X on the Filter box to clear all queries.

Edit columns

To show or hide columns:

  1. Click Column display options. A selection menu of possible columns is displayed.
  2. Select items to display, or clear items to hide.
  3. Click OK.

Sort

To reorder the list of APIs displayed, click a column heading.

The arrow indicates the current sort priority. A down arrow indicates descending order. An up arrow indicates ascending order.

Using an API

To list all Blockchain nodes with ListBlockchainNodes, send the following request:

curl \
  -H "Authorization: Bearer $(gcloud auth print-access-token)" \
  -H "Content-Type: application/json" \
https://blockchainnodeengine.googleapis.com/v1/projects/PROJECT_ID/\
locations/LOCATION/blockchainNodes

Where:

  • PROJECT_ID is your Google Cloud project ID. For example, my-project-id.
  • LOCATION is the location you selected in Create a node. For example, us-central1.

Here is a sample response to the above command:

{
  "blockchainNodes": [
    {
      "name": "projects/my-project-id/locations/us-central1/blockchainNodes/my-new-node-2",
      "createTime": "2023-05-05T21:19:33.308756Z",
      "updateTime": "2023-05-05T21:58:44.513286Z",
      "labels": {
        "my-label-key": "my-label-value"
      },
      "blockchainType": "ETHEREUM",
      "connectionInfo": {
        "ipInfo": {
          "rpcIpv4Address": "203.0.113.1"
        },
        "endpointInfo": {
          "jsonRpcApiEndpoint": "json-rpc.4amkczs2vkh8hjtghcipu7y2t.blockchainnodeengine.com",
          "websocketsApiEndpoint": "ws.4amkczs2vkh8hjtghcipu7y2t.blockchainnodeengine.com"
        }
      },
      "ethereumDetails": {
        "network": "MAINNET",
        "nodeType": "FULL",
        "executionClient": "GETH",
        "consensusClient": "LIGHTHOUSE",
        "apiEnableAdmin": false,
        "apiEnableDebug": false,
        "additionalEndpoints": {
          "beaconApiEndpoint": "beacon.4amkczs2vkh8hjtghcipu7y2t.blockchainnodeengine.com",
          "beaconPrometheusMetricsApiEndpoint": "bc-mc.4amkczs2vkh8hjtghcipu7y2t.blockchainnodeengine.com"
        }
      },
      "state": "RUNNING"
    },
    {
      "name": "projects/my-project-id/locations/us-central1/blockchainNodes/my-new-node",
      "createTime": "2023-05-05T21:03:14.002367Z",
      "updateTime": "2023-05-05T21:42:28.131570Z",
      "blockchainType": "ETHEREUM",
      "connectionInfo": {
        "ipInfo": {
          "rpcIpv4Address": "203.0.113.2"
        },
        "endpointInfo": {
          "jsonRpcApiEndpoint": "json-rpc.8t4jplvidg0v6nsjgqfwok6it.blockchainnodeengine.com",
          "websocketsApiEndpoint": "ws.8t4jplvidg0v6nsjgqfwok6it.blockchainnodeengine.com"
        }
      },
      "ethereumDetails": {
        "network": "MAINNET",
        "nodeType": "FULL",
        "executionClient": "GETH",
        "consensusClient": "LIGHTHOUSE",
        "apiEnableAdmin": true,
        "apiEnableDebug": true,
        "additionalEndpoints": {
          "beaconApiEndpoint": "beacon.8t4jplvidg0v6nsjgqfwok6it.blockchainnodeengine.com",
          "beaconPrometheusMetricsApiEndpoint": "bc-mc.8t4jplvidg0v6nsjgqfwok6it.blockchainnodeengine.com"
        }
      },
      "state": "RUNNING"
    }
  ]
}