Utiliser des nœuds 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 blockchain, vous devez :

Créer une clé API

Vous devez utiliser une clé API pour vous authentifier et interroger votre nœud.

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

  1. Dans la Google Cloud console, 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 blockchain.

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

Obtenir les URL du point de terminaison du nœud blockchain

Vous pouvez obtenir les URL du nœud 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'interface utilisateur :

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

    Accéder à Blockchain Node Engine

    2. La page de la liste 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 du nœud blockchain s'affichent dans la zone Points de terminaison.

Utiliser une API

Pour afficher la liste des détails associés à un nœud 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ù :

  • PROJECT_ID correspond à votre Google Cloud ID de projet. Par exemple, my-project-id.
  • LOCATION correspond à l' emplacement que vous avez sélectionné dans Créer un nœud blockchain. Par exemple, us-central1.
  • NODE_NAME correspond au nom du nœud que vous avez créé dans Créer un nœud blockchain. Par exemple, my-node.

Les URL 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"
}

Voir aussi : Afficher les détails du nœud blockchain, Utiliser une API

Interroger un nœud blockchain

Maintenant que vous connaissez votre clé API et les URL du point de terminaison du nœud blockchain, consultez la rubrique appropriée pour chaque blockchain pour obtenir des instructions d'utilisation :