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:

Crea una chiave API

Per eseguire query sul tuo nodo, devi utilizzare una chiave API per l'autenticazione.

Per generare una chiave nella console Google Cloud:

  1. Nella console Google Cloud, 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 su Copia per copiare la chiave, quindi incollala in un file temporaneo. Ti servirà la chiave API in Eseguire query su un nodo blockchain.

Per ulteriori informazioni sulle chiavi API, consulta Eseguire l'autenticazione utilizzando le chiavi API.

Ottenere gli URL degli endpoint del nodo blockchain

Puoi ottenere 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 console Google Cloud, 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:

Nodi con Private Service abilitato

NOTA: questa sezione si applica solo ai nodi Private Service Connect. Tutti gli altri nodi possono procedere alla sezione successiva

I nodi in cui è abilitato Private Service Connect restituiranno un valore serviceAttachment come mostrato nel seguente esempio di Ethereum:

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

Per utilizzare il nodo, completa la configurazione di Private Service Connect. Quindi, crea l'endpoint utilizzando l'indirizzo IP statico di Private Service Connect e la porta designata per l'interazione scelta, anziché l'endpoint DNS standard.

Per i riferimenti ai numeri di porta:

Nodi con un endpoint pubblico

Gli URL 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, Utilizzo di un'API

Esegui una query su un nodo blockchain

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