Menggunakan node blockchain

Halaman ini menjelaskan cara bersiap untuk membuat kueri node Blockchain Node Engine menggunakan kunci API untuk autentikasi.

Sebelum dapat menggunakan node blockchain, Anda harus:

Membuat kunci API

Anda harus menggunakan kunci API untuk autentikasi guna membuat kueri node.

Untuk membuat kunci di konsol Google Cloud :

  1. Di konsol Google Cloud , buka halaman APIs & Services, Credentials.

    Buka Kredensial

  2. Klik Buat kredensial.

  3. Klik Kunci API.

  4. Dalam dialog API key created, klik Copy untuk menyalin kunci, lalu tempelkan ke file sementara. Anda akan memerlukan kunci API di Mengirim kueri ke node blockchain.

Lihat Melakukan autentikasi menggunakan kunci API untuk mengetahui informasi selengkapnya tentang kunci API.

Mendapatkan URL endpoint node blockchain

Anda bisa mendapatkan URL node blockchain menggunakan konsol atau dengan mengirim permintaan API:

Menggunakan konsol

Untuk melihat detail tentang node di UI:

  1. Di konsol Google Cloud , buka halaman Blockchain Node Engine.

    Buka Blockchain Node Engine

    2. Halaman daftar Node ditampilkan secara default.

  2. Klik nama node. Halaman Node details akan ditampilkan.
    URL node blockchain ditampilkan di area Endpoints.

Menggunakan API

Untuk mencantumkan detail terkait node blockchain dengan ListBlockchainNodes, kirim permintaan berikut:

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

Dengan:

  • PROJECT_ID adalah Google Cloud project ID Anda. Misalnya, my-project-id
  • LOCATION adalah lokasi yang Anda pilih di Buat node blockchain. Misalnya, us-central1.
  • NODE_NAME adalah nama node yang Anda buat di Membuat node blockchain. Misalnya, my-node.

URL blockchain yang ditampilkan berada di bagian endpointInfo dan additionalEndpoints seperti yang ditunjukkan dalam contoh Ethereum berikut:

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

Lihat juga: Melihat detail node blockchain, Menggunakan API

Membuat kueri node blockchain

Setelah mengetahui URL endpoint node blockchain dan kunci API, untuk mengetahui petunjuk penggunaan, lihat topik yang sesuai untuk setiap blockchain: