ブロックチェーン ノードの使用

このページでは、認証に API キーを使用してブロックチェーン ノード エンジン ノードをクエリする準備を行う方法について説明します。

ブロックチェーン ノードを使用するには、次の操作を行う必要があります。

API キーを作成する

ノードをクエリするには、認証に API キーを使用する必要があります。

Google Cloud コンソールで鍵を生成するには:

  1. Google Cloud コンソールで、[API とサービス、認証情報] ページに移動します。

    [認証情報] に移動

  2. [認証情報を作成] をクリックします。

  3. [API キー] をクリックします。

  4. [API キーを作成しました] ダイアログで、[ コピー] をクリックしてキーをコピーし、一時ファイルに貼り付けます。この API キーは、ブロックチェーン ノードのクエリで必要になります。

API キーの詳細については、API キーを使用して認証するをご覧ください。

ブロックチェーン ノードのエンドポイント URL を取得する

ブロックチェーン ノードの URL は、コンソールを使用するか、API リクエストを送信して取得できます。

コンソールの使用

UI でノードの詳細を表示するには:

  1. Google Cloud コンソールで、[Blockchain Node Engine] ページに移動します。

    Blockchain Node Engine に移動

    2. デフォルトでは、[ノード] リストページが表示されます。

  2. ノード名をクリックします。[ノードの詳細] ページが表示されます。
    ブロックチェーン ノードの URL が [エンドポイント] 領域に表示されます。

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

ここで

返されるブロックチェーン URL は、次の Ethereum の例に示すように、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 キーとブロックチェーン ノードのエンドポイント URL がわかったら、各ブロックチェーンの適切なトピックで使用方法の手順を確認してください。