Cómo usar nodos de cadena de bloques

En esta página, se describe cómo prepararse para consultar un nodo de Motor de nodos de cadenas de bloques con una clave de API para la autenticación.

Antes de usar el nodo de blockchain, debes hacer lo siguiente:

Crea una clave de API

Debes usar una clave de API para la autenticación y consultar tu nodo.

Sigue estos pasos para generar una clave en la consola de Google Cloud :

  1. En la consola de Google Cloud , ve a la página APIs y servicios, Credenciales.

    Ir a Credenciales

  2. Haz clic en Crear credenciales.

  3. Haz clic en Clave de API.

  4. En el diálogo Se creó la clave de API, haz clic en Copiar para copiar la clave y, luego, pégala en un archivo temporal. Necesitarás la clave de API en Consulta un nodo de blockchain.

Consulta Autentica mediante claves de API para obtener más información sobre las claves de API.

Obtén las URLs de los extremos de los nodos de la cadena de bloques

Puedes obtener las URLs de los nodos de la cadena de bloques con la consola o enviando una solicitud a la API:

Usa Console

Para ver los detalles de un nodo en la IU, haz lo siguiente:

  1. En la consola de Google Cloud , ve a la página Motor de nodos de cadenas de bloques.

    Ir al Motor de nodos de cadenas de bloques

    2. La página de lista Nodos se muestra de forma predeterminada.

  2. Haz clic en el nombre de un nodo. Se muestra la página Detalles del nodo.
    Las URLs de los nodos de la cadena de bloques se muestran en el área Endpoints.

Uso de una API

Para enumerar los detalles relacionados con un nodo de cadena de bloques con ListBlockchainNodes, envía la siguiente solicitud:

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

Aquí:

Las URLs de blockchain que se muestran se encuentran en las secciones endpointInfo y additionalEndpoints, como se muestra en el siguiente ejemplo de Ethereum:

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

Consulta también Cómo ver los detalles del nodo de cadena de bloques y usar una API

Consulta un nodo de cadena de bloques

Ahora que conoces tu clave de API y las URLs de los extremos de los nodos de la cadena de bloques, consulta el tema correspondiente a cada cadena de bloques para obtener instrucciones de uso: