الصفحة الرئيسية>المتعلقة بالبرمجة>شفرة المصدر الأخرى
تنزيل

فالتراك

Valtrack هي مجموعة من الأدوات التي تهدف إلى توحيد Geo وتتبع صحة Ethereum.

عينة الإخراج في CSV: Valitator_metadata_events_sample.csv

ابدء

للبدء في Valtrack ، تحتاج إلى استنساخ المستودع وتثبيت التبعيات.

1. استنساخ المستودع 

git clone [email protected]:chainbound/valtrack.git

2. تثبيت التبعيات وبناء

فالتراك: 

go mod download
go build

ناتس:

  • https://docs.nats.io/running-a-nats-service/introduction/installation

3. قم بتشغيل التطبيق

يتكون Valtrack من 3 مكونات رئيسية: الحارس والمستهلك وخادم Nats JetStream. إن الحارس مسؤول عن اكتشاف وتتبع صحة Ethereum ، بينما يستهلك المستهلك البيانات التي نشرتها Sentry ، ومعالجتها وتخزينها في قاعدة بيانات (ملفات Parquet في الوقت الحالي). اقرأ المزيد تحت الهندسة المعمارية.

خفير

لتشغيل الحارس: 

./valtrack --nats-url nats://localhost:4222 sentry

مستهلك 

./valtrack --nats-url nats://localhost:4222 consumer

ناتس Jetstream

نحن نقدم ملف تكوين مثال لخادم NATS في Server/Nats-Server.conf. لتشغيل خادم NATS مع تمكين JetStream ، يمكنك تشغيل الأمر التالي: 

nats-server --jetstream --config server/nats-server.conf

سيؤدي ذلك إلى إنشاء دليل data في دليل العمل الحالي مع جميع بيانات JetStream.

هذا يجب أن يطبع نص المساعدة هذا 
 NAME:
   valtrack - Ethereum consensus validator tracking tool

USAGE:
   valtrack [global options] command [command options] [arguments...]

COMMANDS:
   sentry    run the sentry node
   consumer  run the consumer
   help, h   Shows a list of commands or help for one command

GLOBAL OPTIONS:
   --log-level value, -l value  log level (default: "info")
   --nats-url value, -n value   NATS server URL (needs JetStream) (default: "nats://localhost:4222")
   --help, -h                   show help

بنيان

منارة حراسة

Beacon Sentry هي خدمة تزحف إلى Ethereum DISCV5 DHT واكتشاف العقد ويستمع إلى الاتصالات الواردة. إنه يحاول الاتصال بأي أقران مكتشفون ويؤدي مصافحة Status وبيانات MetaData الخاصة بهم.

في موازاة ذلك ، سيحاول قياس اشتراكات Gossipsub الخاصة بـ Peer ، وتحديداً إلى موضوعات الشبكة الفرعية للتصديق. بمجرد أن يكون لها كل هذه البيانات ، ستنشرها على خادم Nats JetStream.

يتم تخزين أقرانهم في peerstore الذي سيقوم بشكل دوري (كل حقبة) بالمرور خلال هذه العملية مرة أخرى. يتيح لنا ذلك الحصول على نقاط بيانات متعددة بمرور الوقت والتي ستوفر المزيد من الدقة في تحديد عدد أخصائيات التحقق من العقدة منارة.

TODO: يجب على Beacon Sentry في وقت لاحق تخزين تقديرات على عدد المدققين المرفقين بعقدة منارة. يجب أن يعرضها بعد ذلك على واجهة برمجة التطبيقات.

مستهلك

المستهلك هي خدمة تستهلك بيانات Sentry من خادم Nats JetStream ويخزنها في ملف parquet (قاعدة البيانات قريبًا). يحافظ على 3 طاولات:

  • discovery_events : يحتوي على أحداث اكتشاف الحارس
  • metadata_events : يحتوي على أحداث البيانات الوصفية من الحارس
  • validator_metadata_events : جدول مشتق من أحداث البيانات الوصفية ، والذي يحتوي على نقاط بيانات من المدققين

خادم NATS

NATS هو الوسيطة الموجهة للرسالة. يستخدم Valtrack Nats JetStream الذي يمكّن من ثبات الرسائل.

تثبيت

تحقق من وثائق NATS الرسمية لتركيبات تثبيت NATS

لتشغيل خادم Nats Jetstream: 

nats-server --jetstream

تكوين دفق

من المهم إنشاء دفق مع التكوين الصحيح وفقًا للمتطلبات. مستندات

يستخدم Valtrack التكوين التالي: 

 jetstreamCfg := jetstream. StreamConfig {
		Name :      "EVENTS" ,
		Retention : jetstream . InterestPolicy ,
		Subjects :  [] string { "events.metadata_received" , "events.peer_discovered" },
	}
  • تم تعيين attreencePolicy على الاهتمام بسيليسي ، مما يعني أنه يتم الاحتفاظ بالرسائل بناءً على اهتمام المستهلك بالرسائل. يتم الاحتفاظ بالرسائل حتى يتم الاعتراف بها من قبل جميع المستهلكين. إذا لم يكن هناك مستهلكين ، فلا يتم الاحتفاظ بالرسائل. مستندات
  • الموضوعات هي موضوعات NATS حيث يتم نشر بيانات Sentry.

تكوين المستهلك

مستندات تكوين المستهلك تستخدم Valtrack التكوين التالي: 

 consumerCfg := jetstream. ConsumerConfig {
		Name :        fmt . Sprintf ( "consumer-%s" , uniqueID ),
		Durable :     fmt . Sprintf ( "consumer-%s" , uniqueID ),
		Description : "Consumes valtrack events" ,
		AckPolicy :   jetstream . AckExplicitPolicy ,
	}
  • يتم تعيين دائمة ، مما يعني أن المستهلك سوف يتم حذفه حتى يتم حذفه بشكل صريح.
  • تم تعيين Ackpolicy على Ackexplicitpolicy ، مما يعني أن المستهلك يجب أن يعترف صراحة بالرسالة. مستندات

استخدام API

سيعرض المستهلك واجهة برمجة تطبيقات للاستعلام عن البيانات المخزنة في قاعدة البيانات. ستكون واجهة برمجة التطبيقات (API) هي واجهة برمجة تطبيقات REST.

وصول عام (مستخدم عادي ، لا يوجد مفتاح مطلوب): 

curl http://localhost:8080/validators

وصول المسؤول (يتطلب مفتاح API): 

curl -H " X-API-KEY: <API-KEY> " http://localhost:8080/validators

يمكن إضافة مفاتيح API في ملف api_keys.txt .

الاعتمادات

يصرخ للمشاريع التالية للإلهام والمرجع:

  • هيرميس
  • أرميارما
يوسع
معلومات إضافية
تطبيقات ذات صلة
نوصي لك
أخبار ذات صلة الكل