Guía de inicio rápido: RPC de cadena de bloques

Versión preliminar

Este producto está con sujeción a las "Condiciones de las Ofertas de la Fase Previa a la DG" de la sección de Términos Generales del Servicio de los Términos Específicos del Servicio. Los productos de la fase previa a la DG están disponibles sin modificaciones y pueden tener asistencia limitada. Para obtener más información, consulta las descripciones de la etapa de lanzamiento.

Roles obligatorios

Para obtener los permisos que necesitas para ver las claves de API, pídele a tu administrador que te otorgue el rol de IAM Visualizador de claves de API (roles/serviceusage.apiKeysViewer) en tu proyecto. Para obtener más información sobre cómo otorgar roles, consulta Administra el acceso a proyectos, carpetas y organizaciones.

También puedes obtener los permisos necesarios a través de roles personalizados o cualquier otro rol predefinido.

Usa el extremo de RPC

1. En la consola de Google Cloud , ve a la página de RPC de Blockchain.

   RPC de Go Blockchain

2. En la consola, copia el extremo JSON-RPC que coincida con la combinación de network y location que necesitas.

   

3. Ahora puedes comenzar a realizar solicitudes. En la documentación de referencia de la API de RPC, se incluye una lista completa de todos los métodos de RPC disponibles. Nuestra solicitud de ejemplo llama al método eth_blockNumber.

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

Aquí:

• JSON_RPC_ENDPOINT es un extremo que copiaste de la consola. Este extremo incluye una clave de API predeterminada que se creó automáticamente. Puedes administrar todas tus claves en la página Credenciales.

Después de ejecutar esta solicitud de curl, deberías ver una respuesta como la siguiente:

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

Cómo usar suscripciones de WebSocket

La compatibilidad con WebSocket también está habilitada para los extremos de la RPC de cadena de bloques. En este ejemplo, se usa el proyecto de código abierto wscat.

1. En la consola de Google Cloud , ve a la página de RPC de Blockchain.

   RPC de Go Blockchain

2. En la consola, copia el extremo de WebSocket que coincida con la combinación de network y location que necesitas.

   

3. Ahora puedes comenzar a realizar solicitudes.

wscat -c WS_ENDPOINT

Aquí:

• WS_ENDPOINT es un extremo de WebSocket de la consola.

Suscríbete a los nuevos encabezados de bloque:

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

Comenzarás a recibir mensajes para cada encabezado de bloque nuevo.