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. Pada dialog API key created, klik Copy untuk menyalin kunci, lalu tempelkan ke file sementara. Anda memerlukan kunci API di Mengkueri 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 node di UI:

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

    Buka Blockchain Node Engine

    2. Halaman daftar Nodes ditampilkan secara default.

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

Menggunakan API

Untuk mencantumkan detail yang terkait dengan 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 keterangan:

Node yang Diaktifkan Layanan Pribadi

CATATAN: Bagian ini hanya berlaku untuk node Private Service Connect. Semua node lainnya dapat melanjutkan ke bagian berikutnya

Node yang mengaktifkan Private Service Connect akan menampilkan serviceAttachment seperti yang ditunjukkan dalam contoh Ethereum berikut:

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

Untuk menggunakan node, selesaikan konfigurasi Private Service Connect. Kemudian, buat endpoint menggunakan alamat IP statis Private Service Connect dan port yang ditetapkan untuk interaksi yang Anda pilih, sebagai pengganti endpoint DNS standar.

Untuk referensi nomor port:

Node dengan Endpoint Publik

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 Anda mengetahui kunci API dan URL endpoint node blockchain, untuk petunjuk penggunaan, lihat topik yang sesuai untuk setiap blockchain: