Utilizzo dei nodi blockchain

Questa pagina descrive come prepararsi a eseguire query su un nodo Blockchain Node Engine utilizzando una chiave API per l'autenticazione.

Prima di poter utilizzare il nodo blockchain, devi:

Creare una chiave API

Devi utilizzare una chiave API per l'autenticazione per eseguire query sul nodo.

Per generare una chiave nella Google Cloud console:

  1. Nella Google Cloud console, vai alla pagina API e servizi, Credenziali.

    Vai a credenziali

  2. Fai clic su Crea credenziali.

  3. Fai clic su Chiave API.

  4. Nella finestra di dialogo Chiave API creata, fai clic Copia per copiare la chiave, quindi incollala in un file temporaneo. Avrai bisogno della chiave API in Eseguire query su un nodo blockchain.

Per ulteriori informazioni sulle chiavi API, consulta Autenticarsi utilizzando le chiavi API.

Recuperare gli URL degli endpoint dei nodi blockchain

Puoi recuperare gli URL dei nodi blockchain utilizzando la console o inviando una richiesta API:

Utilizzo della console

Per visualizzare i dettagli di un nodo nell'interfaccia utente:

  1. Nella Google Cloud console, vai alla pagina Blockchain Node Engine.

    Vai a Blockchain Node Engine

    2. Per impostazione predefinita, viene visualizzata la pagina dell'elenco Nodi.

  2. Fai clic sul nome di un nodo. Viene visualizzata la pagina Dettagli nodo.
    Gli URL dei nodi blockchain vengono visualizzati nell'area Endpoint.

Utilizzo di un'API

Per elencare i dettagli relativi a un nodo blockchain con ListBlockchainNodes, invia la seguente richiesta:

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

Dove:

Gli URL della blockchain restituiti si trovano nelle sezioni endpointInfo e additionalEndpoints, come mostrato nell'esempio di Ethereum seguente:

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

Vedi anche: Visualizzare i dettagli del nodo blockchain, Utilizzare un'API

Eseguire query su un nodo blockchain

Ora che conosci la chiave API e gli URL degli endpoint dei nodi blockchain, per le istruzioni sull'utilizzo consulta l'argomento appropriato per ogni blockchain: