블록체인 노드 사용

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

블록체인 노드를 사용하려면 다음 단계를 완료해야 합니다.

API 키 만들기

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

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

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

    사용자 인증 정보로 이동

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

  3. API 키 를 클릭합니다.

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

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

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

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

콘솔 사용

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

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

반환된 블록체인 URL은 다음 Ethereum 예시와 같이 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을 알았으므로 사용 안내는 각 블록체인에 적합한 주제를 참고하세요.