Guide de démarrage rapide : Blockchain RPC

Aperçu

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 Google Cloud console, accédez à la page Blockchain RPC.

   Accéder à Blockchain RPC

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

   

3. Vous pouvez maintenant commencer à envoyer des requêtes. La liste complète de toutes les 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é automatiquement créée. Vous pouvez gérer toutes vos clés sur la page Identifiants.

Après avoir exécuté cette requête curl, vous devriez voir une réponse semblable à celle-ci :

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

Utiliser des abonnements WebSocket

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

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

   Accéder à Blockchain RPC

2. Dans la console, copiez le point de terminaison WebSocket qui correspond à the network et location combination 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.