الانتقال إلى المحتوى الرئيسي
Venice Crypto RPC هو وكيل HTTP لقراءة حالة البلوكشين وترحيل المعاملات الموقّعة. يستخدم نفس مفتاح Venice API أو مصادقة محفظة x402 المستخدمة في نقاط نهاية Venice المدفوعة الأخرى، لذلك لا يحتاج تطبيقك إلى حساب منفصل مع مزود RPC. Venice لا يحتفظ أبدًا بمفاتيحك الخاصة. وقّع المعاملات في تطبيقك وأرسل الحمولة الموقّعة عبر eth_sendRawTransaction.

​
اكتشاف الشبكات المدعومة

احصل على القائمة الحالية لمعرّفات الشبكات:
نقطة نهاية الاكتشاف عامة ولا تتطلب أي مصادقة. استجابتها هي المرجع الموثوق؛ استخدم أحد المعرّفات المُعادة كـ {network} في نقطة نهاية RPC.

​
إرسال طلب RPC

أرسل طلب JSON-RPC 2.0 إلى الشبكة المختارة:
يدعم الوكيل الطلبات الفردية والدُفعات حتى 100 طلب. تختلف الطرق المدعومة، وفئات التسعير، والتوفر؛ راجع مرجع Crypto RPC API قبل الاعتماد على أي طريقة.

​
سير عمل القراءة والكتابة

​
قراءة حالة السلسلة

استخدم طرقًا مثل eth_blockNumber وeth_getBalance وeth_call وeth_getLogs للاستعلام عن بيانات السلسلة العامة. اجمع الاستدعاءات ذات الصلة في دفعة عندما تستهدف الشبكة ذاتها.

​
ترحيل المعاملة

1

بناء المعاملة

اقرأ nonce الحساب، وبيانات الرسوم، وتقدير الغاز من الشبكة المستهدفة.
2

التوقيع محليًا

وقّع باستخدام مكتبة المحفظة الخاصة بتطبيقك. لا ترسل أبدًا مفتاحًا خاصًا أو عبارة استرداد إلى Venice.
3

إرسال الحمولة الموقّعة

استدعِ eth_sendRawTransaction وعيّن ترويسة Idempotency-Key حتى لا تؤدي إعادة المحاولات إلى ترحيل ثانٍ قابل للفوترة.
4

التحقق من الإيصال

استعلم عن eth_getTransactionReceipt بشكل دوري حتى يتم تضمين المعاملة، ثم افحص حالتها.

​
إعادة المحاولات الآمنة

عيّن مفتاح idempotency على الطلبات التي قد يُعاد إرسالها، خاصةً عمليات ترحيل المعاملات:
يخزن Venice الاستجابة مؤقتًا لمدة 24 ساعة. إعادة استخدام المفتاح مع نفس نص الطلب يُعيد الاستجابة المخزّنة دون رسوم إضافية؛ بينما إعادة استخدامه مع نص مختلف تُعيد خطأ.

​
قيود مهمة

  • الوكيل يعمل عبر HTTP فقط ولا يدعم اشتراكات WebSocket.
  • طرق الفلترة ذات الحالة غير مدعومة؛ استخدم طرقًا عديمة الحالة مثل eth_getLogs.
  • Venice لا يحتفظ بالمفاتيح ولا يُتيح طرق التوقيع.
  • الطرق خارج قائمة السماح تُعيد خطأ.
  • افحص X-Venice-RPC-Credits وX-Venice-RPC-Cost-USD لتتبّع تكلفة الطلب.

​
موارد ذات صلة