Guia de início rápido: RPC de blockchain

Pré-lançamento

Este produto está sujeito aos "Termos da Oferta Pré-GA" na seção Termos Gerais de Serviço dos Termos Específicos de Serviço. Os produtos pré-GA estão disponíveis no estado em que se encontram e podem ter assistência limitada. Para mais informações, consulte as descrições das fases de lançamento.

Funções exigidas

Para receber as permissões necessárias para ver as chaves de API, peça ao administrador para conceder a você o papel do IAM de Leitor de chaves de API (roles/serviceusage.apiKeysViewer) no seu projeto. Para mais informações sobre a concessão de papéis, consulte Gerenciar o acesso a projetos, pastas e organizações.

Também é possível conseguir as permissões necessárias usando papéis personalizados ou outros papéis predefinidos.

Como usar o endpoint RPC

1. No console Google Cloud , acesse a página "RPC de blockchain".

   RPC de blockchain em Go

2. No console, copie o endpoint JSON-RPC que corresponde à combinação network e location necessária.

   

3. Agora você pode começar a fazer solicitações. Uma lista completa de todos os métodos RPC disponíveis está na documentação de referência da API RPC. Nossa solicitação de exemplo chama o 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

Em que:

• JSON_RPC_ENDPOINT é um endpoint que você copiou do console. Esse endpoint inclui uma chave de API padrão criada automaticamente. É possível gerenciar todas as chaves na página Credenciais.

Depois de executar essa solicitação curl, você vai receber uma resposta como esta:

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

Como usar assinaturas do WebSocket

O suporte a WebSocket também está ativado para endpoints de RPC de blockchain. Este exemplo usa o projeto de código aberto wscat.

1. No console Google Cloud , acesse a página "RPC de blockchain".

   RPC de blockchain em Go

2. No console, copie o endpoint WebSocket que corresponde à combinação de network e location necessária.

   

3. Agora você pode começar a fazer solicitações.

wscat -c WS_ENDPOINT

Em que:

• WS_ENDPOINT é um endpoint WebSocket do console.

Inscrever-se em novos cabeçalhos de bloco:

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

Você vai começar a receber mensagens para cada novo cabeçalho de bloco.