使用区块链节点

本页介绍了如何准备使用 API 密钥进行身份验证，以便查询 Blockchain Node Engine 节点。

在使用区块链节点之前，您需要：

创建 API 密钥

您必须使用 API 密钥进行身份验证，才能查询节点。

如需在 Google Cloud 控制台中生成密钥，请执行以下操作：

  1. 在 Google Cloud 控制台中，前往 API 和服务、凭据页面。

    进入“凭据”页面

  2. 点击创建凭据。

  3. 点击 API 密钥。

  4. 在已创建的 API 密钥对话框中，点击 复制以复制该密钥，然后将其粘贴到临时文件中。您需要在查询区块链节点中使用 API 密钥。

如需详细了解 API 密钥，请参阅使用 API 密钥进行身份验证。

获取区块链节点端点网址

您可以使用控制台或发送 API 请求来获取区块链节点网址：

使用控制台

如需在界面中查看有关节点的详细信息，请执行以下操作：

  1. 在 Google Cloud 控制台中，前往 Blockchain Node Engine 页面。

    前往 Blockchain Node Engine

    2. 默认情况下，系统会显示节点列表页面。

  2. 点击节点名称。系统随即会显示节点详情页面。
    区块链节点网址会显示在端点区域中。

使用 API

如需使用 ListBlockchainNodes 列出与区块链节点相关的详细信息，请发送以下请求：

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/NODE_NAME

其中：

  • PROJECT_ID 是您的 Google Cloud 项目 ID。 例如 my-project-id
  • LOCATION 是您在创建区块链节点中选择的位置。例如 us-central1。
  • NODE_NAME 是您在创建区块链节点中创建的节点的名称。 例如 my-node。

返回的区块链网址位于 endpointInfo 和 additionalEndpoints 部分，如以下以太坊示例所示：

{
  "name": "projects/my-project-id/locations/us-central1/blockchainNodes/my-node",
  "createTime": "2023-05-05T04:24:12.432769Z",
  "updateTime": "2023-05-05T05:03:02.561240Z",
  "labels": {
    "my-label-key": "my-label-value"
  },
  "blockchainType": "ETHEREUM",
  "connectionInfo": {
    "ipInfo": {
      "rpcIpv4Address": "192.0.2.1"
    },
    "endpointInfo": {
      "jsonRpcApiEndpoint": "json-rpc.ejp4j0b1rdiq06p8lxksd5z25.blockchainnodeengine.com",
      "websocketsApiEndpoint": "ws.ejp4j0b1rdiq06p8lxksd5z25.blockchainnodeengine.com"
    }
  },
  "ethereumDetails": {
    "network": "MAINNET",
    "nodeType": "FULL",
    "executionClient": "GETH",
    "consensusClient": "LIGHTHOUSE",
    "apiEnableAdmin": false,
    "apiEnableDebug": false,
    "additionalEndpoints": {
      "beaconApiEndpoint": "beacon.ejp4j0b1rdiq06p8lxksd5z25.blockchainnodeengine.com",
      "beaconPrometheusMetricsApiEndpoint": "bc-mc.ejp4j0b1rdiq06p8lxksd5z25.blockchainnodeengine.com"
    }
  },
  "state": "RUNNING"
}

另请参阅：查看区块链节点详情、使用 API

查询区块链节点

现在，您已经知道自己的 API 密钥和区块链节点端点网址，如需了解使用说明，请参阅每个区块链的相应主题：