@gzeoneth/gov-tracker 0.1.0

package/dist/stages/stage-builder.js

@@ -0,0 +1,87 @@
+"use strict";
+/**
+ * Fluent API for constructing TrackedStage objects
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.StageBuilder = void 0;
+class StageBuilder {
+    constructor(type, chain, status = "NOT_STARTED") {
+        this._stage = {
+            type,
+            status,
+            chain,
+            transactions: [],
+            data: {},
+            executable: false,
+        };
+    }
+    /**
+     * Set stage status
+     */
+    status(status) {
+        this._stage.status = status;
+        this._stage.executable = status === "READY";
+        return this;
+    }
+    /**
+     * Add data to the stage (merges with existing data)
+     */
+    data(data) {
+        this._stage.data = { ...this._stage.data, ...data };
+        return this;
+    }
+    /**
+     * Set timing information (merges with existing timing)
+     */
+    timing(timing) {
+        this._stage.timing = { ...this._stage.timing, ...timing };
+        return this;
+    }
+    /**
+     * Add a transaction to the stage
+     */
+    tx(hash, blockNumber, chain, options = {}) {
+        const tx = { hash, blockNumber, chain };
+        if (options.timestamp !== undefined)
+            tx.timestamp = options.timestamp;
+        if (options.logIndex !== undefined)
+            tx.logIndex = options.logIndex;
+        if (options.targetChain !== undefined)
+            tx.targetChain = options.targetChain;
+        if (options.description !== undefined)
+            tx.description = options.description;
+        this._stage.transactions = [...this._stage.transactions, tx];
+        return this;
+    }
+    /**
+     * Mark stage as skipped with reason
+     */
+    skip(reason) {
+        this._stage.status = "SKIPPED";
+        this._stage.executable = false;
+        this._stage.data = { ...this._stage.data, skipReason: reason };
+        return this;
+    }
+    /**
+     * Set transactions directly (for merging from multiple sources)
+     */
+    transactions(txs) {
+        this._stage.transactions = txs;
+        return this;
+    }
+    /**
+     * Set executable flag directly
+     */
+    executable(value) {
+        this._stage.executable = value;
+        return this;
+    }
+    /**
+     * Build and return the final stage object
+     */
+    build() {
+        return { ...this._stage };
+    }
+}
+exports.StageBuilder = StageBuilder;
+//# sourceMappingURL=stage-builder.js.map

package/dist/stages/stage-builder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stage-builder.js","sourceRoot":"","sources":["../../src/stages/stage-builder.ts"],"names":[],"mappings":";AAAA;;GAEG;;;AAaH,MAAa,YAAY;IAGvB,YAAY,IAAe,EAAE,KAAgB,EAAE,SAAsB,aAAa;QAChF,IAAI,CAAC,MAAM,GAAG;YACZ,IAAI;YACJ,MAAM;YACN,KAAK;YACL,YAAY,EAAE,EAAE;YAChB,IAAI,EAAE,EAAE;YACR,UAAU,EAAE,KAAK;SAClB,CAAC;IACJ,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,MAAmB;QACxB,IAAI,CAAC,MAAM,CAAC,MAAM,GAAG,MAAM,CAAC;QAC5B,IAAI,CAAC,MAAM,CAAC,UAAU,GAAG,MAAM,KAAK,OAAO,CAAC;QAC5C,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;OAEG;IACH,IAAI,CAAC,IAAsB;QACzB,IAAI,CAAC,MAAM,CAAC,IAAI,GAAG,EAAE,GAAG,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,GAAG,IAAI,EAAE,CAAC;QACpD,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,MAA4B;QACjC,IAAI,CAAC,MAAM,CAAC,MAAM,GAAG,EAAE,GAAG,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,GAAG,MAAM,EAAE,CAAC;QAC1D,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;OAEG;IACH,EAAE,CACA,IAAY,EACZ,WAAmB,EACnB,KAAgB,EAChB,UAKI,EAAE;QAEN,MAAM,EAAE,GAAqB,EAAE,IAAI,EAAE,WAAW,EAAE,KAAK,EAAE,CAAC;QAC1D,IAAI,OAAO,CAAC,SAAS,KAAK,SAAS;YAAE,EAAE,CAAC,SAAS,GAAG,OAAO,CAAC,SAAS,CAAC;QACtE,IAAI,OAAO,CAAC,QAAQ,KAAK,SAAS;YAAE,EAAE,CAAC,QAAQ,GAAG,OAAO,CAAC,QAAQ,CAAC;QACnE,IAAI,OAAO,CAAC,WAAW,KAAK,SAAS;YAAE,EAAE,CAAC,WAAW,GAAG,OAAO,CAAC,WAAW,CAAC;QAC5E,IAAI,OAAO,CAAC,WAAW,KAAK,SAAS;YAAE,EAAE,CAAC,WAAW,GAAG,OAAO,CAAC,WAAW,CAAC;QAC5E,IAAI,CAAC,MAAM,CAAC,YAAY,GAAG,CAAC,GAAG,IAAI,CAAC,MAAM,CAAC,YAAY,EAAE,EAAE,CAAC,CAAC;QAC7D,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;OAEG;IACH,IAAI,CAAC,MAAc;QACjB,IAAI,CAAC,MAAM,CAAC,MAAM,GAAG,SAAS,CAAC;QAC/B,IAAI,CAAC,MAAM,CAAC,UAAU,GAAG,KAAK,CAAC;QAC/B,IAAI,CAAC,MAAM,CAAC,IAAI,GAAG,EAAE,GAAG,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,UAAU,EAAE,MAAM,EAAE,CAAC;QAC/D,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;OAEG;IACH,YAAY,CAAC,GAAuB;QAClC,IAAI,CAAC,MAAM,CAAC,YAAY,GAAG,GAAG,CAAC;QAC/B,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;OAEG;IACH,UAAU,CAAC,KAAc;QACvB,IAAI,CAAC,MAAM,CAAC,UAAU,GAAG,KAAK,CAAC;QAC/B,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;OAEG;IACH,KAAK;QACH,OAAO,EAAE,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC;IAC5B,CAAC;CACF;AA9FD,oCA8FC"}

package/dist/stages/timelock.d.ts

@@ -0,0 +1,100 @@
+/**
+ * Unified Timelock Stage Tracking and Preparation
+ *
+ * Handles both L1 and L2 timelock operations with chain-specific configurations.
+ * L2-specific: Security Council detection and enrichment
+ * L1-specific: Operation ID discovery from OutBox execution
+ */
+import { ethers, BigNumber } from "ethers";
+import { TrackedStage, TrackedStageData, TimelockState, CallScheduledData, OperationState, ChainType, StageType, PrepareResult, PrepareOptions, TimelockParams, TimelockBatchParams } from "../types";
+/**
+ * Configuration for timelock tracking that differs between L1 and L2.
+ */
+export interface TimelockTrackingConfig {
+    chain: ChainType;
+    stageType: StageType;
+    blockTimeSeconds: number;
+    logPrefix: string;
+}
+/**
+ * Options for timelock stage tracking.
+ */
+export interface TrackTimelockOptions {
+    callScheduledData?: CallScheduledData;
+    cachedExecutionTxHash?: string;
+    /** Whether to check for Security Council enrichment (L2 only) */
+    checkSecurityCouncil?: boolean;
+    additionalPayload?: Record<string, unknown>;
+    /** All tracked stages (used for salt computation from other stages) */
+    allStages?: TrackedStage[];
+}
+/**
+ * Result from timelock stage tracking.
+ */
+export interface TimelockStageResult {
+    stage: TrackedStage;
+    timelockState: TimelockState | null;
+    operationState: OperationState | null;
+    executionTxHash: string | null;
+    executionBlock: number | null;
+}
+/**
+ * Result from L1 timelock tracking (extends base result with L1-specific fields).
+ */
+export interface L1TimelockResult extends TimelockStageResult {
+    l1OperationId: string | null;
+    l1ScheduleTxHash: string | null;
+    l1ScheduleBlock: number | null;
+}
+/**
+ * Find L1 operation ID from a known OutBox execution transaction.
+ */
+export declare function findL1OperationIdFromTx(outboxTxHash: string, outboxTxBlock: number, l1Provider: ethers.providers.Provider): Promise<{
+    l1OperationId: string | null;
+    l1ScheduleTxHash: string;
+    l1ScheduleBlock: number;
+}>;
+/**
+ * Track L2 timelock stage (Stage 4)
+ */
+export declare function trackL2Timelock(timelockAddress: string, operationId: string, provider: ethers.providers.Provider, fromBlock: number, callScheduledData: CallScheduledData, options?: {
+    cachedExecutionTxHash?: string;
+    allStages?: TrackedStage[];
+}): Promise<TimelockStageResult>;
+/**
+ * Track L1 timelock stage (Stage 6)
+ */
+export declare function trackL1Timelock(l1Provider: ethers.providers.Provider, options?: {
+    outboxExecutionTx?: {
+        hash: string;
+        blockNumber: number;
+    } | null;
+    fromBlock?: number;
+    knownL1OperationId?: string;
+    allStages?: TrackedStage[];
+}): Promise<L1TimelockResult>;
+/**
+ * Calculate retryable execution value for L1 timelock operations.
+ */
+export declare function calculateRetryableExecutionValue(_timelockAddress: string, target: string, data: string, provider: ethers.providers.Provider): Promise<BigNumber | null>;
+/**
+ * Calculate batch retryable values for L1 timelock.
+ */
+export declare function calculateBatchRetryableValues(timelockAddress: string, targets: string[], values: BigNumber[], payloads: string[], provider: ethers.providers.Provider): Promise<BigNumber[]>;
+/**
+ * Prepare a single timelock operation for execution.
+ */
+export declare function prepareTimelockOperation(timelockAddress: string, params: TimelockParams, operationId: string, stageData: TrackedStageData, provider: ethers.providers.Provider, options?: PrepareOptions): Promise<PrepareResult>;
+/**
+ * Prepare a batch timelock operation for execution.
+ */
+export declare function prepareTimelockBatch(timelockAddress: string, params: TimelockBatchParams, operationId: string, stageData: TrackedStageData, provider: ethers.providers.Provider, options?: PrepareOptions): Promise<PrepareResult>;
+/**
+ * Prepare a timelock stage for execution (auto-detects single vs batch).
+ *
+ * @param stage - The timelock stage to prepare (salt should be pre-computed in stage.data)
+ * @param provider - Provider for the chain where timelock is deployed
+ * @param options - Preparation options (can override salt with options.salt)
+ */
+export declare function prepareTimelockStage(stage: TrackedStage, provider: ethers.providers.Provider, options?: PrepareOptions): Promise<PrepareResult>;
+//# sourceMappingURL=timelock.d.ts.map

package/dist/stages/timelock.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"timelock.d.ts","sourceRoot":"","sources":["../../src/stages/timelock.ts"],"names":[],"mappings":"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"}