Utiliser des nœuds de blockchain

Cette page explique comment vous préparer à interroger un nœud Blockchain Node Engine à l'aide d'une clé API pour l'authentification.

Avant de pouvoir utiliser le nœud de blockchain, vous devez:

Créer une clé API

Vous devez utiliser une clé API pour l'authentification afin d'interroger votre nœud.

Pour générer une clé dans la console Google Cloud:

  1. Dans la console Google Cloud, accédez à la page API et services, Identifiants.

    Accéder à "Identifiants"

  2. Cliquez sur Créer des identifiants.

  3. Cliquez sur Clé API.

  4. Dans la boîte de dialogue Clé API créée, cliquez sur Copier pour copier la clé, puis collez-la dans un fichier temporaire. Vous aurez besoin de la clé API dans Interroger un nœud de blockchain.

Pour en savoir plus sur les clés API, consultez la page S'authentifier à l'aide de clés API.

Obtenir les URL des points de terminaison du nœud de blockchain

Vous pouvez obtenir les URL des nœuds de la blockchain à l'aide de la console ou en envoyant une requête API:

Utiliser la console

Pour afficher les détails d'un nœud dans l'UI:

  1. Dans la console Google Cloud, accédez à la page Blockchain Node Engine.

    Accéder à Blockchain Node Engine

    2. La page de liste Nodes (Nœuds) s'affiche par défaut.

  2. Cliquez sur le nom d'un nœud. La page Détails du nœud s'affiche.
    Les URL des nœuds de la blockchain s'affichent dans la section Points de terminaison.

Utiliser une API

Pour afficher les détails d'un nœud de blockchain avec ListBlockchainNodes, envoyez la requête suivante:

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

Où :

Nœuds avec Private Service activé

REMARQUE: Cette section ne s'applique qu'aux nœuds Private Service Connect. Tous les autres nœuds peuvent passer à la section suivante.

Les nœuds avec Private Service Connect activé renvoient un serviceAttachment, comme illustré dans l'exemple Ethereum suivant:

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

Pour utiliser le nœud, terminez la configuration de Private Service Connect. Ensuite, créez votre point de terminaison à l'aide de l'adresse IP statique Private Service Connect et du port désigné pour l'interaction de votre choix, à la place du point de terminaison DNS standard.

Pour les références de numéros de port:

Nœuds avec un point de terminaison public

Les URL de la blockchain renvoyées se trouvent dans les sections endpointInfo et additionalEndpoints, comme illustré dans l'exemple Ethereum suivant:

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

Consultez également Afficher les détails du nœud blockchain à l'aide d'une API.

Interroger un nœud blockchain

Maintenant que vous connaissez votre clé API et les URL des points de terminaison des nœuds de blockchain, consultez le sujet approprié pour chaque blockchain pour obtenir des instructions d'utilisation: