블록체인 노드 사용

이 페이지에서는 인증용 API 키를 사용하여 블록체인 노드 엔진 노드를 쿼리할 준비를 하는 방법을 설명합니다.

블록체인 노드를 사용하려면 먼저 다음을 실행해야 합니다.

API 키 만들기

노드를 쿼리하려면 인증에 API 키를 사용해야 합니다.

Google Cloud 콘솔에서 키를 생성하려면 다음 단계를 따르세요.

  1. Google Cloud 콘솔에서 API 및 서비스, 사용자 인증 정보 페이지로 이동합니다.

    사용자 인증 정보로 이동

  2. 사용자 인증 정보 만들기를 클릭합니다.

  3. API 키를 클릭합니다.

  4. API 키 생성 완료 대화상자에서 복사를 클릭하여 키를 복사한 다음 임시 파일에 붙여넣습니다. 블록체인 노드 쿼리의 API 키가 필요합니다.

API 키에 관한 자세한 내용은 API 키를 사용하여 인증을 참고하세요.

블록체인 노드 엔드포인트 URL 가져오기

콘솔을 사용하거나 API 요청을 전송하여 블록체인 노드 URL을 가져올 수 있습니다.

Console 사용

UI에서 노드에 대한 세부정보를 보려면 다음 단계를 따르세요.

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

    블록체인 노드 엔진으로 이동

    2. 기본적으로 노드 목록 페이지가 표시됩니다.

  2. 노드 이름을 클릭합니다. 노드 세부정보 페이지가 표시됩니다.
    블록체인 노드 URL이 엔드포인트 영역에 표시됩니다.

API 사용

ListBlockchainNodes를 사용하여 블록체인 노드와 관련된 세부정보를 나열하려면 다음 요청을 전송합니다.

curl \
  -H "Authorization: Bearer $(gcloud auth print-access-token)" \
  -H "Content-Type: application/json" \
https://blockchainnodeengine.googleapis.com/v1/projects/PROJECT_ID/\
locations/LOCATION/blockchainNodes/NODE_NAME

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

비공개 서비스 사용 설정 노드

참고: 이 섹션은 Private Service Connect 노드에만 적용됩니다. 다른 모든 노드는 다음 섹션으로 진행할 수 있습니다.

Private Service Connect를 사용 설정한 노드는 다음 이더리움 예와 같이 serviceAttachment를 반환합니다.

{
  "name": "projects/cloud-web3/locations/us-central1/blockchainNodes/my-node",
  "createTime": "2023-12-08T15:06:43.538015Z",
  "updateTime": "2023-12-08T15:23:53.016239Z",
  "blockchainType": "ETHEREUM",
  "connectionInfo": {
    "serviceAttachment": "projects/associated-project/regions/us-central1/serviceAttachments/associated-service-attachment"
  },
  "ethereumDetails": {
    "network": "MAINNET",
    "nodeType": "ARCHIVE",
    "executionClient": "ERIGON",
    "consensusClient": "LIGHTHOUSE",
    "apiEnableAdmin": false,
    "apiEnableDebug": false
  },
  "state": "RUNNING",
  "pscOnly": true
}

노드를 사용하려면 Private Service Connect 구성을 완료하세요. 그런 다음 표준 DNS 엔드포인트 대신 선택한 상호작용의 Private Service Connect 정적 IP 주소와 지정된 포트를 사용하여 엔드포인트를 구성합니다.

포트 번호 참조:

공개 엔드포인트가 있는 노드

반환된 블록체인 URL은 다음 이더리움 예와 같이 endpointInfo 및 additionalEndpoints 섹션에 있습니다.

{
  "name": "projects/my-project-id/locations/us-central1/blockchainNodes/my-node",
  "createTime": "2023-05-05T04:24:12.432769Z",
  "updateTime": "2023-05-05T05:03:02.561240Z",
  "labels": {
    "my-label-key": "my-label-value"
  },
  "blockchainType": "ETHEREUM",
  "connectionInfo": {
    "ipInfo": {
      "rpcIpv4Address": "192.0.2.1"
    },
    "endpointInfo": {
      "jsonRpcApiEndpoint": "json-rpc.ejp4j0b1rdiq06p8lxksd5z25.blockchainnodeengine.com",
      "websocketsApiEndpoint": "ws.ejp4j0b1rdiq06p8lxksd5z25.blockchainnodeengine.com"
    }
  },
  "ethereumDetails": {
    "network": "MAINNET",
    "nodeType": "FULL",
    "executionClient": "GETH",
    "consensusClient": "LIGHTHOUSE",
    "apiEnableAdmin": false,
    "apiEnableDebug": false,
    "additionalEndpoints": {
      "beaconApiEndpoint": "beacon.ejp4j0b1rdiq06p8lxksd5z25.blockchainnodeengine.com",
      "beaconPrometheusMetricsApiEndpoint": "bc-mc.ejp4j0b1rdiq06p8lxksd5z25.blockchainnodeengine.com"
    }
  },
  "state": "RUNNING"
}

참고: API를 사용하여 블록체인 노드 세부정보 보기

블록체인 노드 쿼리

이제 API 키와 블록체인 노드 엔드포인트 URL을 알게 되었습니다. 사용 안내는 각 블록체인에 적절한 주제를 참고하세요.