Como usar nós de blockchain

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

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

crie uma chave de API

É necessário usar uma chave de API para autenticação e consultar seu nó.

Para gerar uma chave no console do Google Cloud:

  1. No console do Google Cloud, 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 em um arquivo temporário. Você vai precisar da chave de API em Consultar um nó de blockchain.

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

Conseguir os URLs de endpoint do nó da blockchain

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

Como usar o console

Para conferir detalhes sobre um nó na interface:

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

    Acessar o Blockchain Node Engine

    2. A página da lista Nodes é exibida por padrão.

  2. Clique no nome de um nó. A página Detalhes do nó é exibida.
    Os URLs dos nós da blockchain aparecem na área Endpoints.

Como usar uma API

Para listar detalhes relacionados a um nó de 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:

Nós com serviço particular ativado

OBSERVAÇÃO: esta seção se aplica apenas a nós do Private Service Connect. Todos os outros nós podem prosseguir para a próxima seção.

Os nós com o Private Service Connect ativado vão retornar um serviceAttachment, conforme mostrado no exemplo do Ethereum a seguir:

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

Para usar o nó, conclua a configuração do Private Service Connect. Em seguida, construa o endpoint usando o endereço IP estático do Private Service Connect e a porta designada para a interação escolhida, em vez do endpoint DNS padrão.

Para referências de número de porta:

Nós com um endpoint público

Os URLs da 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: Conferir detalhes do nó do blockchain usando uma API

Consultar um nó de blockchain

Agora que você conhece os URLs de endpoint da chave de API e do nó da blockchain, consulte o tópico apropriado para cada blockchain para conferir as instruções de uso: