Usar nodos de cadena de bloques

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

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

Crear una clave de API

Debes usar una clave de API para autenticarte y consultar tu nodo.

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

  1. En la Google Cloud consola, ve a la página APIs & Services, Credentials (APIs y servicios > Credenciales).

    Ir a Credenciales

  2. Haz clic en Crear credenciales.

  3. Haz clic en Clave de API.

  4. En el cuadro de diálogo Clave de API creada, haz clic en Copiar para copiar la clave y, a continuación, pégala en un archivo temporal. Necesitarás la clave de API en Consultar un nodo de cadena de bloques.

Consulta más información sobre las claves de API en el artículo Autenticar mediante claves de API.

Obtener las URLs de los endpoints de los nodos de la cadena de bloques

Puedes obtener las URLs de los nodos de blockchain mediante la consola o enviando una solicitud a la API:

Utilizar la consola

Para ver los detalles de un nodo en la interfaz de usuario, sigue estos pasos:

  1. En la Google Cloud consola, ve a la página Blockchain Node Engine.

    Ir a Blockchain Node Engine

    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 la cadena de bloques se muestran en el área Endpoints (Puntos finales).

Usar una API

Para consultar 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

Donde:

Nodos con Private Service Connect habilitado

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

Los nodos con Private Service Connect habilitado devolverá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. A continuación, crea tu endpoint con la dirección IP estática de Private Service Connect y el puerto designado para la interacción que hayas elegido, en lugar del endpoint DNS estándar.

Para las referencias a números de puerto:

Nodos con un endpoint público

Las URLs de blockchain devueltas 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 Ver detalles de nodo de cadena de bloques, Usar una API.

Consultar un nodo de cadena de bloques

Ahora que ya conoces tu clave de API y las URLs de los endpoints de los nodos de la cadena de bloques, consulta el tema correspondiente a cada cadena de bloques para obtener instrucciones sobre cómo usarlos: