Como usar nós de blockchain

Nesta página, descrevemos como se preparar para consultar um nó do Blockchain Node Engine usando uma chave de API para autenticação.

Antes de usar o nó do blockchain, você precisa:

Criar uma chave de API

Você precisa usar uma chave de API para autenticação ao consultar seu nó.

Para gerar uma chave no Google Cloud console:

  1. No Google Cloud console, acesse a página APIs e serviços, credenciais.

    Ir para Credenciais

  2. Clique em Criar credenciais.

  3. Clique em Chave de API.

  4. Na caixa de diálogo Chave de API criada, clique em Copiar para copiar a chave e cole-a em um arquivo temporário. Você vai precisar da chave de API em Consultar um nó do blockchain.

Consulte Autenticar usando chaves de API para mais informações sobre chaves de API.

Receber os URLs do endpoint do nó do blockchain

É possível receber os URLs do nó do blockchain usando o console ou enviando uma solicitação de API:

Como usar o console

Para ver detalhes sobre um nó na UI:

  1. No Google Cloud console, acesse a página Blockchain Node Engine.

    Acessar o Blockchain Node Engine

    2. A página da lista Nós é exibida por padrão.

  2. Clique em um nome de nó. A página Detalhes do nó é exibida.
    Os URLs do nó do blockchain são mostrados na área Endpoints.

Como usar uma API

Para listar detalhes relacionados a um nó do blockchain com ListBlockchainNodes, envie a seguinte solicitação:

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

Em que:

Os URLs do blockchain retornados estão nas seções endpointInfo e additionalEndpoints, conforme mostrado no exemplo do Ethereum a seguir:

{
  "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"
}

Consulte também: Acessar detalhes do nó do blockchain, Como usar uma API

Consultar um nó do blockchain

Agora que você já conhece a chave de API e os URLs do endpoint do nó do blockchain, para instruções de uso, consulte o tópico adequado para cada blockchain: