For the complete documentation index, see llms.txt. This page is also available as Markdown.

اشتراكات WebSocket

اشترك في أحداث Rome EVM عبر WebSocket — استخدم eth_subscribe مع newHeads وlogs، ويعمل مباشرةً مع ethers؛ ومع viem، استخدم الاستطلاع الدوري.

نقاط نهاية Rome EVM تدعم اشتراكات WebSocket في Ethereum (eth_subscribe / eth_unsubscribe) على مدى wss://. اتصل بنفس المضيف الخاص بـ HTTPS RPC، مع wss:// المخطط:

wss://<chain>.<network>.romeprotocol.xyz/

هذا ما يستخدمه ethers WebSocketProvider في الخلفية، لذا .on('block') و contract.on(event) يعمل مباشرة دون أي إعداد. viem يحتاج إلى إعداد واحد، موضح في قسم viem .

أنواع الاشتراكات

النوع
يعمل عند
يُستخدم لـ

newHeads

كل كتلة جديدة

عدادات الكتل، تحديث الأرصدة/الـ nonces، روبوتات لكل كتلة، مفهرسون

logs

الأحداث المطابقة (حسب العنوان / الموضوعات)

الاستجابة لأحداث عقدك، المُرحِّلات/الجسور، روبوتات التداول

newPendingTransactions

—

مقبول لكنه لا يصدر أبدًا (لا توجد في Rome ذاكرة معاملات عامة)

ethers (v6)

import { ethers } from "ethers";

const provider = new ethers.WebSocketProvider(
  "wss://hadrian.testnet.romeprotocol.xyz/"
);

// newHeads
provider.on("block", (blockNumber) => {
  console.log("كتلة جديدة", blockNumber);
});

// logs — التفاعل مع حدث لعقد
const contract = new ethers.Contract(address, abi, provider);
contract.on("Transfer", (from, to, value) => {
  console.log("Transfer", from, to, value.toString());
});

viem

viemالخاص بـ webSocket يسجل النقل اشتراكًا فقط عندما يكون المعرّف سلسلة نصية. تُرجع Rome رقمًا، لذا watchBlocks فوق نقلٍ عادي webSocket لا يستقبل النقل أي شيء. مرّر poll: true و viem يستقصي عبر الاتصال بدلًا من ذلك (تم التحقق باستخدام watchBlocks), أو استخدم ethers للتحديثات الفورية.

JSON-RPC الخام

معرّف الاشتراك هو رقم JSON، وليس سلسلة سداسية عشرية، وتحمل الإشعارات الرقم نفسه. ethers يتولى هذا الأمر نيابةً عنك. viemالخاص بـ webSocket يقبل النقل فقط معرّفًا كسلسلة نصية، لذا يتجاهل الإشعارات (انظر viem). إذا كتبتَ عميلًا خامًا، فقارن المعرفات كأرقام وأعد تمرير الرقم إلى eth_unsubscribe.

لـ logs، مرّر كائن فلتر باعتباره المعامل الثاني:

ملاحظات

  • تُرسل الاشتراكات التحديثات فور إنتاج كتل جديدة (زمن التأخير يعادل تقريبًا زمن الكتلة).

  • للاتصالات طويلة الأمد، تعامل مع إعادة الاتصال في عميلك — وهو أمر قياسي لأي RPC عبر WebSocket.

آخر تحديث

هل كان هذا مفيدا؟