Ana içeriğe geç

Watchtower

Watchtower, optimistic rollup'lar için otomatik bir itiraz (auto-challenger) çerçevesidir. Bir rollup'ın çözüm (settlement) yığınlarını (batch) takip eder, her yeni yığını ve itiraz penceresinin son tarihini ortaya çıkarır ve — sizin geçerlilik yükleminiz (validity predicate) bir yığını reddettiğinde — bir itirazı devreye sokabilmeniz için onu onInvalid geri çağırma fonksiyonunuza (callback) iletir.

Çerçeve izler ve ne zaman olacağına karar verir; geçerlilik kontrolünü siz sağlarsınız. Watchtower hiçbir zaman bir yığının hileli olduğuna kendi başına karar vermez — sizin validate fonksiyonunuzu çağırır ve döndürdüğünüz değere göre hareket eder.

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();

Çerçeve şunları ortaya çıkarır:

  • yeni yığınlar onBatch aracılığıyla,
  • itiraz penceresi son tarihleri onDeadline aracılığıyla ve
  • geçersiz yığınlar (sizin validate fonksiyonunuzun false döndürdüğü durumlar) onInvalid aracılığıyla.

onInvalid'i challengeBatch'e bağlamak, Watchtower'ı eksiksiz bir otomatik itiraz aracına dönüştürür; yalnızca gözlem (observe-only) modunda çalıştırmak için onu ayarlanmamış bırakın.

CLI

qorollup watchtower my-roll

watchtower, çerçeveyi komut satırından çalıştırır; siz Ctrl-C'ye basana kadar yeni yığınları ve itiraz penceresi son tarihlerini yazdırır. Tam qorollup operatör CLI'si için bkz. Bir Rollup Dağıtma.