Usar nós da cadeia de blocos

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

Antes de poder usar o nó da cadeia de blocos, tem de:

Crie uma chave da API

Tem de usar uma chave da API para a autenticação para consultar o seu nó.

Para gerar uma chave na Google Cloud consola:

  1. Na Google Cloud consola, aceda à página APIs e serviços, Credenciais.

    Aceder a Credenciais

  2. Clique em Criar credenciais.

  3. Clique em Chave da API.

  4. Na caixa de diálogo Chave da API criada, clique em Copiar para copiar a chave e, em seguida, cole-a num ficheiro temporário. Precisa da chave de API em Consultar um nó de blockchain.

Consulte o artigo Autentique com chaves da API para mais informações sobre as chaves da API.

Obtenha os URLs dos pontos finais do nó da cadeia de blocos

Pode obter os URLs dos nós da cadeia de blocos através da consola ou enviando um pedido de API:

Usar a consola

Para ver detalhes sobre um nó na IU:

  1. Na Google Cloud consola, aceda à página Blockchain Node Engine.

    Aceda ao Blockchain Node Engine

    2. A página de lista Nodes é apresentada por predefinição.

  2. Clique no nome de um nó. É apresentada a página Detalhes do nó.
    Os URLs dos nós da cadeia de blocos são apresentados na área Pontos finais.

Usar uma API

Para listar detalhes relacionados com um nó de blockchain com ListBlockchainNodes, envie o seguinte pedido:

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

Onde:

Nós com serviços privados ativados

NOTA: esta secção aplica-se apenas aos nós do Private Service Connect. Todos os outros nós podem avançar para a secção seguinte

Os nós com o Private Service Connect ativado devolvem um serviceAttachment conforme mostrado no seguinte exemplo do Ethereum:

{
  "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, crie o seu ponto final através do endereço IP estático do Private Service Connect e da porta designada para a interação escolhida, em vez do ponto final DNS padrão.

Para referências ao número da porta:

Nós com um ponto final público

Os URLs da cadeia de blocos devolvidos encontram-se nas secções endpointInfo e additionalEndpoints, conforme mostrado no seguinte exemplo do Ethereum:

{
  "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: Veja detalhes do nó da cadeia de blocos, Use uma API

Consultar um nó de blockchain

Agora que conhece a chave da API e os URLs dos pontos finais dos nós da cadeia de blocos, para ver instruções de utilização, consulte o tópico adequado para cada cadeia de blocos: