快速入门：区块链 RPC

所需的角色

如需获得查看 API 密钥所需的权限，请让您的管理员为您授予项目的 API Key Viewer (roles/serviceusage.apiKeysViewer) IAM 角色。如需详细了解如何授予角色，请参阅管理对项目、文件夹和组织的访问权限。

您也可以通过自定义角色或其他预定义角色来获取所需的权限。

使用 RPC 端点

  1. 在 Google Cloud 控制台中，前往“区块链 RPC”页面。

    Go 区块链 RPC

  2. 在控制台中，复制与您需要的 network 和 location 组合相匹配的 JSON-RPC 端点。

    区块链 RPC 快速入门

  3. 现在，您可以开始发出请求了。如需查看所有可用的 RPC 方法的完整列表，请参阅 RPC API 参考文档。我们的示例请求调用了 eth_blockNumber 方法。

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

其中：

  • JSON_RPC_ENDPOINT 是您从控制台中复制的端点。此端点包含已自动创建的默认 API 密钥。您可以在凭据页面上管理所有密钥。

执行此 curl 请求后，您应该会看到如下所示的响应：

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

使用 WebSocket 订阅

此外，还为区块链 RPC 端点启用了 WebSocket 支持。此示例使用 wscat 开源项目。

  1. 在 Google Cloud 控制台中，前往“区块链 RPC”页面。

    Go 区块链 RPC

  2. 从控制台中，复制与您需要的 network 和 location 组合相匹配的 WebSocket 端点。

    区块链 RPC 快速入门

  3. 现在，您可以开始发出请求了。

wscat -c WS_ENDPOINT

其中：

  • WS_ENDPOINT 是控制台中的 WebSocket 端点。

订阅新的块头：

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

您将开始接收每个新区块头的消息。