מדריך למתחילים: Blockchain RPC

התפקידים הנדרשים

כדי לקבל את ההרשאות שנדרשות להצגת מפתחות API, צריך לבקש מהאדמין להקצות לכם ב-IAM את התפקיד API Key Viewer (roles/serviceusage.apiKeysViewer) בפרויקט. כדי לקרוא הסבר על מתן תפקידים, ראו איך מנהלים את הגישה ברמת הפרויקט, התיקייה והארגון.

יכול להיות שאפשר לקבל את ההרשאות הנדרשות גם באמצעות תפקידים בהתאמה אישית או תפקידים מוגדרים מראש.

שימוש בנקודת קצה של RPC

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

    Go Blockchain RPC

  2. במסוף, מעתיקים את נקודת הקצה של JSON-RPC שתואמת לשילוב של network ו-location שדרוש לכם.

    מדריך למתחילים בנושא Blockchain RPC

  3. עכשיו אפשר להתחיל לשלוח בקשות. רשימה מלאה של כל שיטות ה-RPC שזמינות מופיעה במאמרי העזרה של RPC API. בדוגמה שלנו, הבקשה שולחת קריאה למתודה eth_blockNumber.

curl -X POST -H "Content-Type: application/json" -d '{
  "jsonrpc": "2.0",
  "id": 1,
  "method":
  "eth_blockNumber",
  "params": []}' \
JSON_RPC_ENDPOINT

כאשר:

  • ‫JSON_RPC_ENDPOINT היא נקודת קצה שהעתקתם מהמסוף. נקודת הקצה הזו כוללת מפתח API שנוצר אוטומטית כברירת מחדל. אתם יכולים לנהל את כל המפתחות בדף פרטי הכניסה.

אחרי שמריצים את בקשת ה-curl הזו, אמורה להתקבל תגובה כזו:

{"jsonrpc":"2.0","id":1,"result":"0x13acb8d"}

שימוש במינויים ל-WebSocket

התמיכה ב-WebSocket מופעלת גם בנקודות קצה של Blockchain RPC. בדוגמה הזו נשתמש בפרויקט הקוד הפתוח wscat.

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

    Go Blockchain RPC

  2. מסוף, מעתיקים את נקודת הקצה של WebSocket שתואמת לשילוב של network ו-location שדרוש לכם.

    מדריך למתחילים בנושא Blockchain RPC

  3. עכשיו אפשר להתחיל לשלוח בקשות.

wscat -c WS_ENDPOINT

כאשר:

  • ‫WS_ENDPOINT היא נקודת קצה של WebSocket מהמסוף.

הרשמה לכותרות חדשות של בלוקים:

{"id":1,"jsonrpc":"2.0","method":"eth_subscribe","params":["newHeads"]}

תתחילו לקבל הודעות על כל כותרת בלוק חדשה.