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

Funções exigidas

Para receber as permissões necessárias para visualizar 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 personalizados papéis ou outros predefinidos papéis.

Como usar o endpoint RPC

  1. Noconsole, acesse a página RPC da blockchain. Google Cloud

    Acessar a RPC da blockchain

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

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

  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. Nosso exemplo de solicitação 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 copiado do console. Esse endpoint inclui uma chave de API padrão criada automaticamente. Você pode gerenciar todas as chaves na página Credenciais.

Depois de executar essa solicitação curl, você verá uma resposta como:

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

Como usar assinaturas WebSocket

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

  1. Noconsole, acesse a página RPC da blockchain. Google Cloud

    Acessar a RPC da blockchain

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

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

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

wscat -c WS_ENDPOINT

Em que:

  • WS_ENDPOINT é um endpoint WebSocket do console.

Assinar 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.