快速入門導覽課程：Blockchain RPC

必要的角色

如要取得查看 API 金鑰所需的權限，請要求管理員在專案中授予您「API 金鑰檢視者 」(roles/serviceusage.apiKeysViewer) IAM 角色。如要進一步瞭解如何授予角色，請參閱「管理專案、資料夾和組織的存取權」。

您或許也能透過自訂角色或其他預先定義的角色，取得必要權限。

使用 RPC 端點

  1. 前往 Google Cloud 控制台的「Blockchain RPC」頁面。

    Go Blockchain RPC

  2. 從控制台複製與所需 network 和 location 組合相符的 JSON-RPC 端點。

    Blockchain 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 訂閱

Blockchain RPC 端點也支援 WebSocket。本範例使用 wscat 開放原始碼專案。

  1. 前往 Google Cloud 控制台的「Blockchain RPC」頁面。

    Go Blockchain RPC

  2. 從控制台中，複製與所需 network 和 location 組合相符的 WebSocket 端點。

    Blockchain RPC 快速入門

  3. 現在可以開始提出要求。

wscat -c WS_ENDPOINT

其中：

  • WS_ENDPOINT 是主控台中的 WebSocket 端點。

訂閱新的區塊標頭：

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

你將開始收到每個新區塊標題的訊息。