Cómo usar nodos de cadena de bloques

En esta página, se describe cómo prepararte para consultar un nodo de Blockchain Node Engine con una clave de API para la autenticación.

Antes de poder usar el nodo de cadena de bloques, debes hacer lo siguiente:

Crea una clave de API

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

Para generar una clave en la consola de Google Cloud, sigue estos pasos:

  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 Cómo consultar un nodo de cadena de bloques.

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

Obtén las URLs de extremo del nodo de cadena de bloques

Puedes obtener las URLs de los nodos de 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 Blockchain Node Engine.

    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 mostrará la página Detalles del nodo.
    Las URLs de los nodos de cadena de bloques se muestran en el área Extremos.

Cómo usar 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í:

Nodos habilitados para el servicio privado

NOTA: Esta sección solo se aplica a los nodos de Private Service Connect. Todos los demás nodos pueden continuar con la siguiente sección.

Los nodos habilitados para Private Service Connect mostrarán un serviceAttachment, como se muestra en el siguiente ejemplo de 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
}

Para usar el nodo, completa la configuración de Private Service Connect. Luego, construye tu extremo con la dirección IP estática de Private Service Connect y el puerto designado para la interacción que elegiste, en lugar del extremo DNS estándar.

Para obtener referencias de números de puerto, consulta lo siguiente:

Nodos con un extremo público

Las URLs de cadena de bloques 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, con una API

Cómo consultar un nodo de cadena de bloques

Ahora que conoces tu clave de API y las URLs de los extremos del nodo de cadena de bloques, consulta el tema correspondiente para cada cadena de bloques si necesitas instrucciones de uso: