برج المراقبة (Watchtower)

برج المراقبة (Watchtower) هو إطار عمل للطعن التلقائي (auto-challenger) مخصص للتجميعات التفاؤلية (optimistic rollups). فهو يتتبع دُفعات التسوية الخاصة بأي تجميع (rollup)، ويُظهر كل دُفعة جديدة والموعد النهائي لنافذة الطعن الخاصة بها، و — عندما يرفض مُسنِد الصلاحية الخاص بك دُفعةً ما — يُسلّمها إلى دالة الاستدعاء onInvalid لديك حتى تتمكن من إعداد الطعن.

يُراقب الإطار ويقرر متى؛ بينما أنت من يوفّر فحص الصلاحية. لا يقرر برج المراقبة من تلقاء نفسه أبدًا أن دُفعةً ما احتيالية — بل يستدعي دالة validate لديك ويتصرف بناءً على ما تُعيده.

watchBatches

import { createRdkClient, watchBatches, challengeBatch } from "@qorechain/rdk";

// The public qore.host REST + RPC endpoints are baked into the presets
// (RDK ≥ 0.4.2); the RPC endpoint is what broadcasts a challenge. Pass
// `endpoints` only to target your own node.
const rdk = createRdkClient({ network: "testnet" });

const watcher = watchBatches(rdk, "my-roll", {
  onBatch: (batch) => {
    console.log("new batch", batch.index);
  },

  // Your validity predicate. Return false to flag the batch as invalid.
  validate: async (batch) => {
    return await isBatchValid(batch); // your logic
  },

  // Called when validate() returns false — wire it to a challenge.
  onInvalid: async (batch) => {
    await challengeBatch(rdk, "my-roll", batch.index /* + your fraud proof */);
  },

  // Called as a batch approaches the end of its challenge window.
  onDeadline: (batch) => {
    console.warn("challenge window closing for batch", batch.index);
  },
});

// Later:
watcher.stop();

يُظهر الإطار:

• الدُفعات الجديدة عبر onBatch،
• المواعيد النهائية لنافذة الطعن عبر onDeadline، و
• الدُفعات غير الصالحة (حيث أعادت دالة validate لديك القيمة false) عبر onInvalid.

ربط onInvalid بـ challengeBatch يُحوّل برج المراقبة إلى مُطاعِن تلقائي متكامل؛ اتركه دون تعيين لتشغيله في وضع المراقبة فقط.

واجهة سطر الأوامر (CLI)

qorollup watchtower my-roll

يُشغّل الأمر watchtower الإطار من سطر الأوامر، ويطبع الدُفعات الجديدة والمواعيد النهائية لنافذة الطعن حتى تضغط Ctrl-C. راجع نشر تجميع (Rollup) للاطلاع على واجهة سطر أوامر المشغّل الكاملة qorollup.