Guide de démarrage rapide : Blockchain RPC

Preview

Ce produit est soumis aux "Conditions des Offres de pré-DG" de la section "Conditions générales du service" des Conditions spécifiques du service. Les produits de pré-DG sont disponibles "en l'état" et peuvent avoir une prise en charge limitée. Pour en savoir plus, consultez les descriptions des étapes de lancement.

Rôles requis

Pour obtenir les autorisations nécessaires pour afficher les clés API, demandez à votre administrateur de vous accorder le rôle IAM Lecteur de clés API (roles/serviceusage.apiKeysViewer) sur votre projet. Pour en savoir plus sur l'attribution de rôles, consultez Gérer l'accès aux projets, aux dossiers et aux organisations.

Vous pouvez également obtenir les autorisations requises avec des rôles personnalisés ou d'autres rôles prédéfinis.

Utiliser le point de terminaison RPC

1. Dans la console Google Cloud , accédez à la page "Blockchain RPC".

   Go Blockchain RPC

2. Dans la console, copiez le point de terminaison JSON-RPC qui correspond à la combinaison network et location dont vous avez besoin.

   

3. Vous pouvez maintenant commencer à envoyer des requêtes. La liste complète des méthodes RPC disponibles est disponible dans la documentation de référence de l'API RPC. Notre exemple de requête appelle la méthode eth_blockNumber.

curl -X POST -H "Content-Type: application/json" -d '{
  "jsonrpc": "2.0",
  "id": 1,
  "method":
  "eth_blockNumber",
  "params": []}' \
JSON_RPC_ENDPOINT

Où :

• JSON_RPC_ENDPOINT est un point de terminaison que vous avez copié depuis la console. Ce point de terminaison inclut une clé API par défaut qui a été créée automatiquement. Vous pouvez gérer toutes vos clés sur la page Identifiants.

Une fois cette requête cURL exécutée, une réponse semblable à celle-ci devrait s'afficher :

{"jsonrpc":"2.0","id":1,"result":"0x13acb8d"}

Utiliser les abonnements WebSocket

La prise en charge de WebSocket est également activée pour les points de terminaison Blockchain RPC. Cet exemple utilise le projet Open Source wscat.

1. Dans la console Google Cloud , accédez à la page "Blockchain RPC".

   Go Blockchain RPC

2. Dans la console, copiez le point de terminaison WebSocket qui correspond à la combinaison network et location dont vous avez besoin.

   

3. Vous pouvez maintenant commencer à envoyer des requêtes.

wscat -c WS_ENDPOINT

Où :

• WS_ENDPOINT est un point de terminaison WebSocket de la console.

S'abonner aux nouveaux en-têtes de bloc :

{"id":1,"jsonrpc":"2.0","method":"eth_subscribe","params":["newHeads"]}

Vous commencerez à recevoir des messages pour chaque nouvel en-tête de bloc.