This page describes how to view a list of Blockchain Node Engine nodes using the console or an API call.
Using the console
The Nodeslist 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 Enginepage.
The Nodeslist page is displayed by default.
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:
-
Create a filter query:
- Click in the filter box. A selection menu of the column names is displayed.
- Select a column name. For example, Status. A selection menu of the states is displayed.
- Select a state. For example, Running.
- Optionally, add an OR operator and then select other options to
further modify your query. For example,
Status: RUNNING OR Location: us-central1.
-
Optionally, modify the query:
- Click the X on the query chip to remove the query.
- Click the X on the Filterbox to clear all queries.
Edit columns
To show or hide columns:
- Click Column display options. A selection menu of possible columns is displayed.
- Select items to display, or clear items to hide.
- 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 this 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"
}
]
}
