빠른 시작: 블록체인 RPC

프리뷰

이 제품에는 서비스별 약관이 적용됩니다. 정식 버전(GA) 이전 제품은 '있는 그대로' 제공되며 지원이 제한될 수 있습니다. 자세한 내용은 출시 단계 설명을 참조하세요.

필요한 역할

API 키를 보는 데 필요한 권한을 얻으려면 관리자에게 프로젝트에 대한 API 키 뷰어 (roles/serviceusage.apiKeysViewer) IAM 역할을 부여해 달라고 요청하세요. 역할 부여에 대한 자세한 내용은 프로젝트, 폴더, 조직에 대한 액세스 관리를 참조하세요.

커스텀 역할이나 다른 사전 정의된 역할을 통해 필요한 권한을 얻을 수도 있습니다.

RPC 엔드포인트 사용

1. Google Cloud 콘솔에서 블록체인 RPC 페이지로 이동합니다.

   Go 블록체인 RPC

2. 콘솔에서 필요한 network 및 location 조합과 일치하는 JSON-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 엔드포인트를 복사합니다.

   

3. 이제 요청을 시작할 수 있습니다.

wscat -c WS_ENDPOINT

각 항목의 의미는 다음과 같습니다.

• WS_ENDPOINT은 콘솔의 WebSocket 엔드포인트입니다.

새 블록 헤더를 구독합니다.

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

새 블록 헤더마다 메시지를 받게 됩니다.