Blockchain-Knoten verwenden

Auf dieser Seite wird beschrieben, wie Sie einen Blockchain Node Engine-Knoten mit einem API-Schlüssel für die Authentifizierung abfragen.

Bevor Sie den Blockchain-Knoten verwenden können, müssen Sie Folgendes tun:

API-Schlüssel erstellen

Sie müssen einen API-Schlüssel für die Authentifizierung verwenden, um Ihren Knoten abzufragen.

So generieren Sie einen Schlüssel in der Google Cloud Console:

  1. Rufen Sie in der Google Cloud Console die Seite APIs & Dienste > Anmeldedaten auf.

    Zu den Anmeldedaten

  2. Klicken Sie auf Anmeldedaten erstellen.

  3. Klicken Sie auf API-Schlüssel.

  4. Klicken Sie im Dialogfeld API-Schlüssel erstellt auf Kopieren, um den Schlüssel zu kopieren, und fügen Sie ihn dann in eine temporäre Datei ein. Sie benötigen den API-Schlüssel unter Blockchain-Knoten abfragen.

Weitere Informationen zu API-Schlüsseln finden Sie unter Mit API-Schlüsseln authentifizieren.

Endpunkt-URLs des Blockchain-Knotens abrufen

Sie können die URLs der Blockchain-Knoten über die Console oder durch Senden einer API-Anfrage abrufen:

Konsole verwenden

So rufen Sie Details zu einem Knoten in der Benutzeroberfläche auf:

  1. Rufen Sie in der Google Cloud Console die Seite Blockchain Node Engine auf.

    Blockchain Node Engine aufrufen

    2. Die Seite mit der Liste der Knoten wird standardmäßig angezeigt.

  2. Klicken Sie auf einen Knotennamen. Die Seite Knotendetails wird angezeigt.
    Blockchain-Knoten-URLs werden im Bereich Endpunkte angezeigt.

API verwenden

Wenn Sie Details zu einem Blockchain-Knoten mit ListBlockchainNodes auflisten möchten, senden Sie die folgende Anfrage:

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

Wobei:

Knoten mit aktiviertem privaten Dienst

HINWEIS: Dieser Abschnitt gilt nur für Private Service Connect-Knoten. Alle anderen Knoten können mit diesem Abschnitt fortfahren.

Für Knoten mit aktiviertem Private Service Connect wird eine serviceAttachment zurückgegeben, wie im folgenden Ethereum-Beispiel gezeigt:

{
  "name": "projects/cloud-web3/locations/us-central1/blockchainNodes/my-node",
  "createTime": "2023-12-08T15:06:43.538015Z",
  "updateTime": "2023-12-08T15:23:53.016239Z",
  "blockchainType": "ETHEREUM",
  "connectionInfo": {
    "serviceAttachment": "projects/associated-project/regions/us-central1/serviceAttachments/associated-service-attachment"
  },
  "ethereumDetails": {
    "network": "MAINNET",
    "nodeType": "ARCHIVE",
    "executionClient": "ERIGON",
    "consensusClient": "LIGHTHOUSE",
    "apiEnableAdmin": false,
    "apiEnableDebug": false
  },
  "state": "RUNNING",
  "pscOnly": true
}

Wenn Sie den Knoten verwenden möchten, schließen Sie die Private Service Connect-Konfiguration ab. Erstellen Sie dann Ihren Endpunkt anstelle des Standard-DNS-Endpunkts mit der statischen IP-Adresse und dem angegebenen Port von Private Service Connect für die ausgewählte Interaktion.

Für Portnummernreferenzen:

Knoten mit öffentlichem Endpunkt

Die zurückgegebenen Blockchain-URLs befinden sich in den Abschnitten endpointInfo und additionalEndpoints, wie im folgenden Ethereum-Beispiel gezeigt:

{
  "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"
}

Weitere Informationen finden Sie unter Details zum Blockchain-Knoten mit einer API ansehen.

Blockchain-Knoten abfragen

Nachdem Sie Ihren API-Schlüssel und die Endpunkt-URLs der Blockchain-Knoten kennen, finden Sie in den folgenden Themen Anleitungen zur Verwendung für jede Blockchain: