שימוש בצמתים של בלוקצ'יין

בדף הזה מוסבר איך להתכונן לשליחת שאילתה לצומת Blockchain Node Engine באמצעות מפתח API לאימות.

לפני שתוכלו להשתמש בצומת הבלוקצ'יין, תצטרכו:

יצירה של מפתח API

כדי לשלוח שאילתה לצומת, צריך להשתמש במפתח API לאימות.

כדי ליצור מפתח במסוף Google Cloud :

  1. במסוף Google Cloud , נכנסים לדף APIs & Services, Credentials.

    כניסה לדף Credentials

  2. לוחצים על יצירת פרטי כניסה.

  3. לוחצים על מפתח API.

  4. בתיבת הדו-שיח API key created (נוצר מפתח API), לוחצים על Copy (העתקה) כדי להעתיק את המפתח, ואז מדביקים אותו בקובץ זמני. תצטרכו את מפתח ה-API שמופיע במאמר שליחת שאילתה לצומת של בלוקצ'יין.

מידע נוסף על מפתחות API זמין במאמר בנושא אימות באמצעות מפתחות API.

קבלת כתובות ה-URL של נקודות הקצה של צומת הבלוקצ'יין

אפשר לקבל את כתובות ה-URL של צומתי הבלוקצ'יין באמצעות המסוף או על ידי שליחת בקשת API:

שימוש במסוף

כדי לראות פרטים על צומת בממשק המשתמש:

  1. נכנסים לדף Blockchain Node Engine במסוף Google Cloud .

    מעבר אל Blockchain Node Engine

  2. כברירת מחדל, מוצג הדף של רשימת Nodes.

  3. לוחצים על שם הצומת. יוצג הדף Node details.
    כתובות ה-URL של צומתי הבלוקצ'יין מוצגות באזור Endpoints.

שימוש ב-API

כדי להציג פרטים שקשורים לצומת בלוקצ'יין באמצעות ListBlockchainNodes, שולחים את הבקשה הבאה:

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

כאשר:

כתובות ה-URL של הבלוקצ'יין שמוחזרות מופיעות בקטעים endpointInfo ו-additionalEndpoints, כמו בדוגמה הבאה של 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"
}

ראו גם: הצגת פרטים של צומת בלוקצ'יין, שימוש ב-API

שאילתה של צומת בלוקצ'יין

עכשיו, אחרי שיש לכם את מפתח ה-API ואת כתובות נקודות הקצה של צומת הבלוקצ'יין, תוכלו לעיין בהוראות השימוש בנושא המתאים לכל בלוקצ'יין: