Create an Ethereum blockchain node  |  Blockchain Node Engine  |  Google Cloud (2024)

This page describes how to create an Ethereum blockchain nodein Blockchain Node Engine using theconsole or an API call.

Using the console

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

Go to Blockchain Node Engine

The Nodes list page is displayedby default. If no blockchain nodes have been created, you are prompted tocreate one.

To create a blockchain node:

1. Click Create. The Create a blockchain node wizard opens.

   

   See Also

   Tectum Claims the Title of the Fastest Layer 1 Blockchain and Process 3.5 Million Transactions Per Second in its TPS Test Final PhaseWhat Is an RPC Node?Top 10 Different Types of Blockchain Nodes: A Guide | ShardeumComparing External Blockchain Node Providers: Which One Fits Your Needs?

2. Configure node info:

   1. Name of blockchain node: Type a name for thenode. Use lowercase letters (a-z),numbers, and hyphens. For example, my-node.
   2. Blockchain type: Select the name of theblockchain.For example, ETHEREUM.
   3. Click Continue.

3. Configure blockchain info: Configure blockchain-specific information.For example, to configure an Ethereum node, select the following options.This information cannot be changed later:

   1. Network: The name of thenetwork.For example MAINNET.
   2. Node type: The typeof the blockchain node. For example, FULL.
   3. Execution/Consensus client: The name of theexecution/consensuslayer of theclientsoftware. For example, GETH/LIGHTHOUSE. SeeSupported configurationsfor supported combinations.
   4. Enable additional namespaces: An optionalJSON-RPC namespacewhen using the Ethereum Geth execution client. For example, debug.
   5. Click Continue.

4. Configure network info:

   1. Select thegeographical locationin which to host your resources. For example, us-central1.This information cannot be changed later.See Supported locations.
   2. Configure Endpoints: Creates publicly accessible endpoints by default. ReviewPrivate Service Connectfor more information about using private endpoints.
   3. Click Continue.

5. Add labels:

   1. Type a key/value pair. Click Add item to add morekey/value pairs.
   2. Click Continue.

6. Click Create. the blockchain node is created and theNodes list is displayed.The Status indicates Creating until the blockchain node is ready to use, andthen the status changes to Running.

Using an API

To create a blockchain node using an API, send a POST request to the APIwith the blockchain node specification. An example using the curl commandto send a request to the API follows:

curl -X POST \ -H "Authorization: Bearer $(gcloud auth print-access-token)" \ -H "Content-Type: application/json" \ -d '{ "blockchainType": "BLOCKCHAIN_TYPE", "privateServiceConnectEnabled" : false, "ethereumDetails": { "consensusClient": "CONSENSUS_CLIENT", "executionClient": "EXECUTION_CLIENT", "apiEnableAdmin": false, "apiEnableDebug": false, "network": "NETWORK", "nodeType": "NODE_TYPE" }, "labels": { "LABEL_KEY": "LABEL_VALUE" } }' \https://blockchainnodeengine.googleapis.com/v1/projects/PROJECT_ID/\locations/LOCATION/blockchainNodes?blockchain_node_id=NODE_NAME

You must replace the variables in the above example with actual values as follows:

• BLOCKCHAIN_TYPE: The name of the blockchain. For example, ETHEREUM.
• privateServiceConnectEnabled: Optional and disabled by default. Set to true to enable Private Service Connect.
• CONSENSUS_CLIENT: The name of the consensus layer of the client software. For example, LIGHTHOUSE. See Supported configurations for supported combinations.
• EXECUTION_CLIENT: The name of the execution layer of the client software. For example, GETH. See Supported configurations for supported combinations.
• apiEnableAdmin: An optional JSON-RPC namespace when using the Ethereum Geth execution client. Disabled by default. Set to true to enable.
• apiEnableDebug: An optional JSON-RPC namespace when using the Ethereum Geth execution client. Disabled by default. Set to true to enable.
• NETWORK: The name of the network. For example, MAINNET.
• NODE_TYPE: The type of the blockchain node. For example, FULL.
• PROJECT_ID: Your Google Cloud project ID. For example, my-project-id.
• LOCATION: The location in which to host your resources. This information cannot be changed later. For example, us-central1. See Supported locations.
• NODE_NAME: A name you specify for your node. Use lowercase letters (a-z), numbers, and hyphens. For example, my-node.

• labels: A key-value pair. In the above example, the key is LABEL_KEY, for example my-label-key and the value is LABEL_VALUE, for example my-label-value.

Here is a sample response to the above command:

{ "name": "projects/my-project-id/locations/us-central1/operations/operation-1683664820863-5fb48c391814a-a546e3e6-ddee30ad", "metadata": { "@type": "type.googleapis.com/google.cloud.blockchainnodeengine.v1.OperationMetadata", "createTime": "2023-05-09T20:40:20.979144857Z", "target": "projects/my-project-id/locations/us-central1/blockchainNodes/my-node", "verb": "create", "requestedCancellation": false, "apiVersion": "v1" }, "done": false}

Note that the OPERATION_ID is returned in the earlierexample:

operation-1683664820863-5fb48c391814a-a546e3e6-ddee30ad

You can use this value toget the statusof the blockchain node creation.

Validator Configuration

There are additional options available to support customers who are usingBlockchain Node Engine beacon clients with a customer-managed validator client.

NOTE: These options are only available using the API.

To create a blockchain node with validator options set, use a curl commandsuch as:

curl -X POST \ -H "Authorization: Bearer $(gcloud auth print-access-token)" \ -H "Content-Type: application/json" \ -d '{ "blockchainType": "BLOCKCHAIN_TYPE", "ethereumDetails": { "consensusClient": "CONSENSUS_CLIENT", "executionClient": "EXECUTION_CLIENT", "apiEnableAdmin": false, "apiEnableDebug": false, "network": "NETWORK", "nodeType": "NODE_TYPE", "validatorConfig": { "beaconFeeRecipient": "BEACON_FEE_RECIPIENT", "mev_relay_urls": "MEV_RELAY_URL", } }, }' \https://blockchainnodeengine.googleapis.com/v1/projects/PROJECT_ID/\locations/LOCATION/blockchainNodes?blockchain_node_id=NODE_NAME

Beacon Fee Recipient

A default fee recipient can be set on the beacon client, which is used ifa fee recipient is not specified by the validator client. While the Lighthousedocumentationrefers to this as a suggested fee recipient, as both the execution and beaconclients are trusted, the recipient is always used if specified.

Beacon fee recipients must be Ethereum addresses with the "0x" prefix,for example "0xb469d8b44a3f559a3386af6273ec4a71da88a15a".

MEV-relay URL

Blockchain nodes come with a managed MEV-boost service included. This enablescustomers to use an external block builder service or services, take thebest block offered by those services, and propose that block.

No specific services are recommended or endorsed, and customers are responsiblefor verifying the services they select here.

MEV-relay URLs are specified as a comma-separated list of URLs, for example"https://mev1.example.org/,https://mev2.example.org/".

Supported configurations

Blockchain Node Engine supports a variety of configurations. You can createnodes with any of the following combinations: