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ê opapel 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.