List blockchain nodes
Stay organized with collections
Save and categorize content based on your preferences.
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.
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: |
|
| 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 Filter box 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 $(gcloudauthprint-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"
}
]
}