@gzeoneth/gov-tracker 0.1.0

package/dist/tracker/discovery.js

@@ -0,0 +1,228 @@
+"use strict";
+/**
+ * Tracker Discovery Module
+ *
+ * Handles discovery of proposals and timelock operations.
+ * Provides unified discovery API with watermark management.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.WATERMARKS_KEY = void 0;
+exports.loadWatermarks = loadWatermarks;
+exports.saveWatermarks = saveWatermarks;
+exports.discoverProposals = discoverProposals;
+exports.discoverTimelockOps = discoverTimelockOps;
+exports.createPendingCheckpoints = createPendingCheckpoints;
+exports.discoverAll = discoverAll;
+const constants_1 = require("../constants");
+const governor_discovery_1 = require("../discovery/governor-discovery");
+const timelock_discovery_1 = require("../discovery/timelock-discovery");
+const logger_1 = require("../utils/logger");
+const { tracker: logTracker, discovery: logDiscovery } = logger_1.loggers;
+/**
+ * Cache key for discovery watermarks checkpoint.
+ * Uses "discovery:" prefix to follow checkpoint pattern.
+ */
+exports.WATERMARKS_KEY = "discovery:watermarks";
+/**
+ * Load discovery watermarks from cache.
+ * Watermarks are stored as a TrackingCheckpoint for unified cache format.
+ * Returns empty object if no watermarks are cached.
+ */
+async function loadWatermarks(cache) {
+    if (!cache)
+        return {};
+    const checkpoint = await cache.get(exports.WATERMARKS_KEY);
+    return checkpoint?.cachedData.discoveryWatermarks ?? {};
+}
+/**
+ * Save discovery watermarks to cache.
+ * Watermarks are stored as TrackingCheckpoint with proper metadata,
+ * following the same pattern as proposal/timelock checkpoints.
+ */
+async function saveWatermarks(watermarks, cache) {
+    if (!cache)
+        return;
+    // Calculate the max L2 block from watermarks for lastProcessedBlock
+    const l2Blocks = [
+        watermarks.constitutionalGovernor,
+        watermarks.nonConstitutionalGovernor,
+        watermarks.electionNomineeGovernor,
+        watermarks.electionMemberGovernor,
+        watermarks.l2ConstitutionalTimelock,
+        watermarks.l2NonConstitutionalTimelock,
+    ].filter((b) => b !== undefined);
+    const maxL2Block = l2Blocks.length > 0 ? Math.max(...l2Blocks) : 0;
+    // Store as checkpoint with proper metadata (same pattern as proposal checkpoints)
+    const checkpoint = {
+        version: 1,
+        createdAt: Date.now(),
+        input: { type: "discovery", id: "watermarks" },
+        lastProcessedStage: null,
+        lastProcessedBlock: { l1: 0, l2: maxL2Block },
+        cachedData: {
+            discoveryWatermarks: watermarks,
+        },
+        metadata: {
+            errorCount: 0,
+            lastTrackedAt: Date.now(),
+        },
+    };
+    await cache.set(exports.WATERMARKS_KEY, checkpoint);
+    logTracker("saved watermarks to cache (as checkpoint)");
+}
+/**
+ * Discover proposals from a governor in a block range.
+ *
+ * @param governorAddress - Governor contract address
+ * @param fromBlock - Start block (exclusive - searches from fromBlock + 1)
+ * @param toBlock - End block (inclusive)
+ * @param l2Provider - L2 provider
+ * @param options.chunkSize - Optional chunk size for log searches
+ * @returns Array of discovered proposals
+ */
+async function discoverProposals(governorAddress, fromBlock, toBlock, l2Provider, options = {}) {
+    logDiscovery("blocks %d-%d", fromBlock, toBlock);
+    return (0, governor_discovery_1.discoverProposals)(governorAddress, fromBlock + 1, toBlock, l2Provider, options);
+}
+/**
+ * Discover timelock operations from a timelock in a block range.
+ *
+ * @param timelockAddress - Timelock contract address
+ * @param fromBlock - Start block (exclusive - searches from fromBlock + 1)
+ * @param toBlock - End block (inclusive)
+ * @param l2Provider - L2 provider
+ * @param options.chunkSize - Optional chunk size for log searches
+ * @returns Array of discovered timelock operations
+ */
+async function discoverTimelockOps(timelockAddress, fromBlock, toBlock, l2Provider, options = {}) {
+    logDiscovery("blocks %d-%d", fromBlock, toBlock);
+    return (0, timelock_discovery_1.discoverTimelockOps)(timelockAddress, fromBlock + 1, toBlock, l2Provider, options);
+}
+/**
+ * Create pending checkpoints for discovered proposals.
+ * This ensures they can be retracked even if the current run times out.
+ *
+ * Note: We don't create pending checkpoints for timelock ops because:
+ * 1. Most timelock ops are tracked as part of governor proposals
+ * 2. The monitor-loop skips timelock ops that were tracked via governor
+ * 3. Creating pending checkpoints for all timelock ops causes double-counting
+ */
+async function createPendingCheckpoints(proposals, _timelockOps, cache) {
+    if (!cache)
+        return;
+    let created = 0;
+    // Create pending checkpoints for proposals (if not already tracked)
+    // Use tx: key format to match trackByTxHash cache keys
+    for (const p of proposals) {
+        const key = `tx:${p.creationTxHash.toLowerCase()}`;
+        const existing = await cache.get(key);
+        if (existing)
+            continue; // Already has a checkpoint
+        const checkpoint = {
+            version: 1,
+            createdAt: Date.now(),
+            input: {
+                type: "governor",
+                governorAddress: p.governorAddress,
+                proposalId: p.proposalId,
+                creationTxHash: p.creationTxHash,
+            },
+            lastProcessedStage: null,
+            lastProcessedBlock: { l1: 0, l2: p.creationBlock },
+            cachedData: {},
+            metadata: { errorCount: 0, lastTrackedAt: 0 }, // lastTrackedAt=0 means never tracked
+        };
+        await cache.set(key, checkpoint);
+        created++;
+    }
+    if (created > 0) {
+        logDiscovery("created pending checkpoints: %d proposals", created);
+    }
+}
+/**
+ * Discover all proposals and timelock operations with auto-watermark management.
+ *
+ * This is the unified discovery API that handles everything internally:
+ * - Loads watermarks from provided watermarks or starts from governance deployment
+ * - Discovers from all enabled targets in parallel (with scoped logging)
+ * - Creates pending checkpoints for discovered items
+ * - Returns updated watermarks for saving
+ *
+ * @param targets - Which governors/timelocks to scan
+ * @param toBlock - End block for discovery
+ * @param l2Provider - L2 provider
+ * @param cache - Cache adapter for pending checkpoint creation
+ * @param fromWatermarks - Starting watermarks
+ * @param options.chunkSize - Optional chunk size for log searches
+ * @returns Discovered proposals, timelock ops, and updated watermarks
+ */
+async function discoverAll(targets, toBlock, l2Provider, cache, fromWatermarks, options = {}) {
+    const watermarks = fromWatermarks;
+    const defaultStartBlock = constants_1.GOVERNANCE_START_BLOCKS.L2;
+    // Helper to create scoped discovery task
+    const scopedProposalTask = (key, scopeName, governorAddress) => {
+        const fromBlock = watermarks[key] ?? defaultStartBlock;
+        return (0, logger_1.withScope)(scopeName, async () => {
+            const proposals = await discoverProposals(governorAddress, fromBlock, toBlock, l2Provider, {
+                chunkSize: options.chunkSize,
+            });
+            return { key, proposals };
+        });
+    };
+    const scopedTimelockTask = (key, scopeName, timelockAddress) => {
+        const fromBlock = watermarks[key] ?? defaultStartBlock;
+        return (0, logger_1.withScope)(scopeName, async () => {
+            const ops = await discoverTimelockOps(timelockAddress, fromBlock, toBlock, l2Provider, {
+                chunkSize: options.chunkSize,
+            });
+            return { key, ops };
+        });
+    };
+    // Build discovery tasks with scoped logging
+    const proposalTasks = [];
+    const timelockTasks = [];
+    if (targets.constitutionalGovernor) {
+        proposalTasks.push(scopedProposalTask("constitutionalGovernor", "core-gov", constants_1.ADDRESSES.CONSTITUTIONAL_GOVERNOR));
+    }
+    if (targets.nonConstitutionalGovernor) {
+        proposalTasks.push(scopedProposalTask("nonConstitutionalGovernor", "treasury-gov", constants_1.ADDRESSES.NON_CONSTITUTIONAL_GOVERNOR));
+    }
+    if (targets.electionNomineeGovernor) {
+        proposalTasks.push(scopedProposalTask("electionNomineeGovernor", "nominee-gov", constants_1.ADDRESSES.ELECTION_NOMINEE_GOVERNOR));
+    }
+    if (targets.electionMemberGovernor) {
+        proposalTasks.push(scopedProposalTask("electionMemberGovernor", "member-gov", constants_1.ADDRESSES.ELECTION_MEMBER_GOVERNOR));
+    }
+    if (targets.l2ConstitutionalTimelock) {
+        timelockTasks.push(scopedTimelockTask("l2ConstitutionalTimelock", "core-timelock", constants_1.ADDRESSES.L2_CONSTITUTIONAL_TIMELOCK));
+    }
+    if (targets.l2NonConstitutionalTimelock) {
+        timelockTasks.push(scopedTimelockTask("l2NonConstitutionalTimelock", "treasury-timelock", constants_1.ADDRESSES.L2_NON_CONSTITUTIONAL_TIMELOCK));
+    }
+    // Run all discovery in parallel
+    const [proposalResults, timelockResults] = await Promise.all([
+        Promise.all(proposalTasks),
+        Promise.all(timelockTasks),
+    ]);
+    // Collect results and update watermarks
+    const allProposals = [];
+    const allTimelockOps = [];
+    const newWatermarks = { ...watermarks };
+    for (const { key, proposals } of proposalResults) {
+        allProposals.push(...proposals);
+        newWatermarks[key] = toBlock;
+    }
+    for (const { key, ops } of timelockResults) {
+        allTimelockOps.push(...ops);
+        newWatermarks[key] = toBlock;
+    }
+    // Create pending checkpoints for discovered items
+    await createPendingCheckpoints(allProposals, allTimelockOps, cache);
+    logDiscovery("complete: %d proposals, %d timelockOps", allProposals.length, allTimelockOps.length);
+    return {
+        proposals: allProposals,
+        timelockOps: allTimelockOps,
+        watermarks: newWatermarks,
+    };
+}
+//# sourceMappingURL=discovery.js.map

package/dist/tracker/discovery.js.map

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

package/dist/tracker/execute.d.ts

@@ -0,0 +1,44 @@
+/**
+ * Tracker Execute Module
+ *
+ * Handles transaction preparation for READY stages.
+ * This module encapsulates all execution-related operations.
+ */
+import { ethers } from "ethers";
+import { TrackedStage, PrepareResult, PrepareOptions } from "../types";
+/**
+ * Context for execution operations
+ */
+export interface ExecuteContext {
+    l1Provider: ethers.providers.Provider;
+    l2Provider: ethers.providers.Provider;
+    novaProvider: ethers.providers.Provider;
+}
+/**
+ * Prepare a transaction for a READY stage without sending it.
+ *
+ * Returns PrepareResult with the prepared transaction data.
+ * Consumer is responsible for signing and sending the transaction.
+ *
+ * @example
+ * ```typescript
+ * const result = await prepareTransaction(readyStage, context, options);
+ * if (result.success) {
+ *   console.log(`To: ${result.prepared.to}`);
+ *   console.log(`Data: ${result.prepared.data}`);
+ *   console.log(`Chain: ${result.prepared.chain}`);
+ *
+ *   // Execute with your own signer
+ *   const tx = await signer.sendTransaction({
+ *     to: result.prepared.to,
+ *     data: result.prepared.data,
+ *     value: result.prepared.value,
+ *   });
+ *   await tx.wait();
+ * } else {
+ *   console.error(result.error);
+ * }
+ * ```
+ */
+export declare function prepareTransaction(stage: TrackedStage, context: ExecuteContext, options?: PrepareOptions): Promise<PrepareResult>;
+//# sourceMappingURL=execute.d.ts.map

package/dist/tracker/execute.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"execute.d.ts","sourceRoot":"","sources":["../../src/tracker/execute.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAChC,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,cAAc,EAAgB,MAAM,UAAU,CAAC;AAUrF;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,UAAU,EAAE,MAAM,CAAC,SAAS,CAAC,QAAQ,CAAC;IACtC,UAAU,EAAE,MAAM,CAAC,SAAS,CAAC,QAAQ,CAAC;IACtC,YAAY,EAAE,MAAM,CAAC,SAAS,CAAC,QAAQ,CAAC;CACzC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,wBAAsB,kBAAkB,CACtC,KAAK,EAAE,YAAY,EACnB,OAAO,EAAE,cAAc,EACvB,OAAO,GAAE,cAAmB,GAC3B,OAAO,CAAC,aAAa,CAAC,CAgGxB"}

package/dist/tracker/execute.js

@@ -0,0 +1,126 @@
+"use strict";
+/**
+ * Tracker Execute Module
+ *
+ * Handles transaction preparation for READY stages.
+ * This module encapsulates all execution-related operations.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.prepareTransaction = prepareTransaction;
+const ethers_1 = require("ethers");
+const types_1 = require("../types");
+const proposal_queued_1 = require("../stages/proposal-queued");
+const timelock_1 = require("../stages/timelock");
+const l2_to_l1_message_1 = require("../stages/l2-to-l1-message");
+const retryables_1 = require("../stages/retryables");
+const base_1 = require("../stages/base");
+const logger_1 = require("../utils/logger");
+const log = logger_1.loggers.execution;
+/**
+ * Prepare a transaction for a READY stage without sending it.
+ *
+ * Returns PrepareResult with the prepared transaction data.
+ * Consumer is responsible for signing and sending the transaction.
+ *
+ * @example
+ * ```typescript
+ * const result = await prepareTransaction(readyStage, context, options);
+ * if (result.success) {
+ *   console.log(`To: ${result.prepared.to}`);
+ *   console.log(`Data: ${result.prepared.data}`);
+ *   console.log(`Chain: ${result.prepared.chain}`);
+ *
+ *   // Execute with your own signer
+ *   const tx = await signer.sendTransaction({
+ *     to: result.prepared.to,
+ *     data: result.prepared.data,
+ *     value: result.prepared.value,
+ *   });
+ *   await tx.wait();
+ * } else {
+ *   console.error(result.error);
+ * }
+ * ```
+ */
+async function prepareTransaction(stage, context, options = {}) {
+    const { l1Provider, l2Provider, novaProvider } = context;
+    log("prepareTransaction type=%s status=%s", stage.type, stage.status);
+    switch (stage.type) {
+        case "PROPOSAL_QUEUED": {
+            // Queue a proposal on the governor (calls governor.queue())
+            const queueData = (0, types_1.getStageData)(stage, "PROPOSAL_QUEUED");
+            if (!queueData) {
+                return (0, base_1.failPrepare)("Stage is not a PROPOSAL_QUEUED stage");
+            }
+            const { governorAddress, proposalId, targets, values, calldatas, description } = queueData;
+            if (!governorAddress || !proposalId || !targets || !values || !calldatas || !description) {
+                return (0, base_1.failPrepare)("Missing proposal queue params in stage data");
+            }
+            return (0, proposal_queued_1.prepareGovernorQueue)(governorAddress, proposalId, {
+                targets,
+                values: values.map((v) => ethers_1.ethers.BigNumber.from(v)),
+                calldatas,
+                descriptionHash: ethers_1.ethers.utils.id(description),
+            }, l2Provider);
+        }
+        case "L2_TIMELOCK": {
+            return (0, timelock_1.prepareTimelockStage)(stage, l2Provider, options);
+        }
+        case "L1_TIMELOCK": {
+            return (0, timelock_1.prepareTimelockStage)(stage, l1Provider, options);
+        }
+        case "L2_TO_L1_MESSAGE": {
+            const { total, results } = await (0, l2_to_l1_message_1.prepareL2ToL1MessageStage)(stage, l2Provider, l1Provider, {
+                force: options.force,
+            });
+            if (results.length === 0) {
+                return (0, base_1.failPrepare)("No messages to prepare");
+            }
+            // If there are multiple messages, return success but include warning about additional messages
+            if (total > 1 && results[0].success) {
+                return {
+                    ...results[0],
+                    prepared: {
+                        ...results[0].prepared,
+                        description: results[0].prepared.description +
+                            ` [1/${total} messages - use prepareL2ToL1MessageStage() for all]`,
+                    },
+                };
+            }
+            return results[0];
+        }
+        case "RETRYABLE_EXECUTED": {
+            const retryableData = (0, types_1.getStageData)(stage, "RETRYABLE_EXECUTED");
+            const targetChain = retryableData?.targetChains?.[0];
+            // Validate target chain exists before selecting provider
+            if (!targetChain) {
+                return (0, base_1.failPrepare)("No target chain found in retryable stage data");
+            }
+            const targetProvider = targetChain === "Nova" ? novaProvider : l2Provider;
+            if (!targetProvider) {
+                return (0, base_1.failPrepare)("Target chain provider not available");
+            }
+            const { total, results } = await (0, retryables_1.prepareRetryableStage)(stage, l1Provider, targetProvider, {
+                force: options.force,
+            });
+            if (results.length === 0) {
+                return (0, base_1.failPrepare)("No tickets to prepare");
+            }
+            // If there are multiple tickets, return success but include warning
+            if (total > 1 && results[0].success) {
+                return {
+                    ...results[0],
+                    prepared: {
+                        ...results[0].prepared,
+                        description: results[0].prepared.description +
+                            ` [1/${total} tickets - use prepareRetryableStage() for all]`,
+                    },
+                };
+            }
+            return results[0];
+        }
+        default:
+            return (0, base_1.failPrepare)(`Preparation not supported for stage type: ${stage.type}`);
+    }
+}
+//# sourceMappingURL=execute.js.map

package/dist/tracker/execute.js.map

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

package/dist/tracker/index.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Tracker module re-exports
+ *
+ * This module consolidates exports from the tracker subsystem:
+ * - context.ts: TrackingContext state management
+ * - pipeline.ts: Stage tracking pipeline functions
+ * - discovery.ts: Proposal and timelock discovery
+ * - query.ts: Cache query operations
+ * - execute.ts: Transaction preparation
+ * - state.ts: Cache utilities
+ */
+export { Providers, CreateTrackingContextOptions, TrackingContext, createTrackingContext, addStage, isStageCompleted, getCompletedStage, getCachedStage, isComplete, getGovernorAddress, getProposalId, getTimelockAddress, getOperationId, getCallScheduledData, getFirstCallScheduledData, getQueueBlockNumber, getProposalData, getProposalType, getIsElection, getProposalState, getL2ExecutionTxHash, getFirstExecutableBlock, getOutboxExecutionTx, getL1ExecutionTxHash, createCheckpoint, toResult, } from "./context";
+export { trackGovernorPipeline, trackTimelockPipeline } from "./pipeline";
+export { discoverAll, discoverProposals, discoverTimelockOps, DiscoveredProposal, DiscoveredTimelockOp, loadWatermarks, saveWatermarks, WATERMARKS_KEY, } from "./discovery";
+export { listCheckpointKeys, getCheckpoint, getAllCheckpoints, queryIncompleteCheckpoints, getStats, } from "./query";
+export { prepareTransaction } from "./execute";
+export { txHashCacheKey, readCacheStatus } from "./state";
+//# sourceMappingURL=index.d.ts.map

package/dist/tracker/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/tracker/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAGH,OAAO,EAEL,SAAS,EACT,4BAA4B,EAC5B,eAAe,EAEf,qBAAqB,EAErB,QAAQ,EACR,gBAAgB,EAChB,iBAAiB,EACjB,cAAc,EACd,UAAU,EAEV,kBAAkB,EAClB,aAAa,EACb,kBAAkB,EAClB,cAAc,EACd,oBAAoB,EACpB,yBAAyB,EACzB,mBAAmB,EACnB,eAAe,EACf,eAAe,EACf,aAAa,EACb,gBAAgB,EAChB,oBAAoB,EACpB,uBAAuB,EACvB,oBAAoB,EACpB,oBAAoB,EAEpB,gBAAgB,EAChB,QAAQ,GACT,MAAM,WAAW,CAAC;AAGnB,OAAO,EAAE,qBAAqB,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAC;AAG1E,OAAO,EACL,WAAW,EACX,iBAAiB,EACjB,mBAAmB,EACnB,kBAAkB,EAClB,oBAAoB,EACpB,cAAc,EACd,cAAc,EACd,cAAc,GACf,MAAM,aAAa,CAAC;AAGrB,OAAO,EACL,kBAAkB,EAClB,aAAa,EACb,iBAAiB,EACjB,0BAA0B,EAC1B,QAAQ,GACT,MAAM,SAAS,CAAC;AAGjB,OAAO,EAAE,kBAAkB,EAAE,MAAM,WAAW,CAAC;AAG/C,OAAO,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC"}

package/dist/tracker/index.js

@@ -0,0 +1,70 @@
+"use strict";
+/**
+ * Tracker module re-exports
+ *
+ * This module consolidates exports from the tracker subsystem:
+ * - context.ts: TrackingContext state management
+ * - pipeline.ts: Stage tracking pipeline functions
+ * - discovery.ts: Proposal and timelock discovery
+ * - query.ts: Cache query operations
+ * - execute.ts: Transaction preparation
+ * - state.ts: Cache utilities
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.readCacheStatus = exports.txHashCacheKey = exports.prepareTransaction = exports.getStats = exports.queryIncompleteCheckpoints = exports.getAllCheckpoints = exports.getCheckpoint = exports.listCheckpointKeys = exports.WATERMARKS_KEY = exports.saveWatermarks = exports.loadWatermarks = exports.discoverTimelockOps = exports.discoverProposals = exports.discoverAll = exports.trackTimelockPipeline = exports.trackGovernorPipeline = exports.toResult = exports.createCheckpoint = exports.getL1ExecutionTxHash = exports.getOutboxExecutionTx = exports.getFirstExecutableBlock = exports.getL2ExecutionTxHash = exports.getProposalState = exports.getIsElection = exports.getProposalType = exports.getProposalData = exports.getQueueBlockNumber = exports.getFirstCallScheduledData = exports.getCallScheduledData = exports.getOperationId = exports.getTimelockAddress = exports.getProposalId = exports.getGovernorAddress = exports.isComplete = exports.getCachedStage = exports.getCompletedStage = exports.isStageCompleted = exports.addStage = exports.createTrackingContext = void 0;
+// Context - TrackingContext state management
+var context_1 = require("./context");
+// State creation
+Object.defineProperty(exports, "createTrackingContext", { enumerable: true, get: function () { return context_1.createTrackingContext; } });
+// Stage management
+Object.defineProperty(exports, "addStage", { enumerable: true, get: function () { return context_1.addStage; } });
+Object.defineProperty(exports, "isStageCompleted", { enumerable: true, get: function () { return context_1.isStageCompleted; } });
+Object.defineProperty(exports, "getCompletedStage", { enumerable: true, get: function () { return context_1.getCompletedStage; } });
+Object.defineProperty(exports, "getCachedStage", { enumerable: true, get: function () { return context_1.getCachedStage; } });
+Object.defineProperty(exports, "isComplete", { enumerable: true, get: function () { return context_1.isComplete; } });
+// Derived getters
+Object.defineProperty(exports, "getGovernorAddress", { enumerable: true, get: function () { return context_1.getGovernorAddress; } });
+Object.defineProperty(exports, "getProposalId", { enumerable: true, get: function () { return context_1.getProposalId; } });
+Object.defineProperty(exports, "getTimelockAddress", { enumerable: true, get: function () { return context_1.getTimelockAddress; } });
+Object.defineProperty(exports, "getOperationId", { enumerable: true, get: function () { return context_1.getOperationId; } });
+Object.defineProperty(exports, "getCallScheduledData", { enumerable: true, get: function () { return context_1.getCallScheduledData; } });
+Object.defineProperty(exports, "getFirstCallScheduledData", { enumerable: true, get: function () { return context_1.getFirstCallScheduledData; } });
+Object.defineProperty(exports, "getQueueBlockNumber", { enumerable: true, get: function () { return context_1.getQueueBlockNumber; } });
+Object.defineProperty(exports, "getProposalData", { enumerable: true, get: function () { return context_1.getProposalData; } });
+Object.defineProperty(exports, "getProposalType", { enumerable: true, get: function () { return context_1.getProposalType; } });
+Object.defineProperty(exports, "getIsElection", { enumerable: true, get: function () { return context_1.getIsElection; } });
+Object.defineProperty(exports, "getProposalState", { enumerable: true, get: function () { return context_1.getProposalState; } });
+Object.defineProperty(exports, "getL2ExecutionTxHash", { enumerable: true, get: function () { return context_1.getL2ExecutionTxHash; } });
+Object.defineProperty(exports, "getFirstExecutableBlock", { enumerable: true, get: function () { return context_1.getFirstExecutableBlock; } });
+Object.defineProperty(exports, "getOutboxExecutionTx", { enumerable: true, get: function () { return context_1.getOutboxExecutionTx; } });
+Object.defineProperty(exports, "getL1ExecutionTxHash", { enumerable: true, get: function () { return context_1.getL1ExecutionTxHash; } });
+// Checkpoint
+Object.defineProperty(exports, "createCheckpoint", { enumerable: true, get: function () { return context_1.createCheckpoint; } });
+Object.defineProperty(exports, "toResult", { enumerable: true, get: function () { return context_1.toResult; } });
+// Pipeline - Stage tracking functions
+var pipeline_1 = require("./pipeline");
+Object.defineProperty(exports, "trackGovernorPipeline", { enumerable: true, get: function () { return pipeline_1.trackGovernorPipeline; } });
+Object.defineProperty(exports, "trackTimelockPipeline", { enumerable: true, get: function () { return pipeline_1.trackTimelockPipeline; } });
+// Discovery
+var discovery_1 = require("./discovery");
+Object.defineProperty(exports, "discoverAll", { enumerable: true, get: function () { return discovery_1.discoverAll; } });
+Object.defineProperty(exports, "discoverProposals", { enumerable: true, get: function () { return discovery_1.discoverProposals; } });
+Object.defineProperty(exports, "discoverTimelockOps", { enumerable: true, get: function () { return discovery_1.discoverTimelockOps; } });
+Object.defineProperty(exports, "loadWatermarks", { enumerable: true, get: function () { return discovery_1.loadWatermarks; } });
+Object.defineProperty(exports, "saveWatermarks", { enumerable: true, get: function () { return discovery_1.saveWatermarks; } });
+Object.defineProperty(exports, "WATERMARKS_KEY", { enumerable: true, get: function () { return discovery_1.WATERMARKS_KEY; } });
+// Query
+var query_1 = require("./query");
+Object.defineProperty(exports, "listCheckpointKeys", { enumerable: true, get: function () { return query_1.listCheckpointKeys; } });
+Object.defineProperty(exports, "getCheckpoint", { enumerable: true, get: function () { return query_1.getCheckpoint; } });
+Object.defineProperty(exports, "getAllCheckpoints", { enumerable: true, get: function () { return query_1.getAllCheckpoints; } });
+Object.defineProperty(exports, "queryIncompleteCheckpoints", { enumerable: true, get: function () { return query_1.queryIncompleteCheckpoints; } });
+Object.defineProperty(exports, "getStats", { enumerable: true, get: function () { return query_1.getStats; } });
+// Execute
+var execute_1 = require("./execute");
+Object.defineProperty(exports, "prepareTransaction", { enumerable: true, get: function () { return execute_1.prepareTransaction; } });
+// State utilities
+var state_1 = require("./state");
+Object.defineProperty(exports, "txHashCacheKey", { enumerable: true, get: function () { return state_1.txHashCacheKey; } });
+Object.defineProperty(exports, "readCacheStatus", { enumerable: true, get: function () { return state_1.readCacheStatus; } });
+//# sourceMappingURL=index.js.map

package/dist/tracker/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/tracker/index.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;GAUG;;;AAEH,6CAA6C;AAC7C,qCAgCmB;AA3BjB,iBAAiB;AACjB,gHAAA,qBAAqB,OAAA;AACrB,mBAAmB;AACnB,mGAAA,QAAQ,OAAA;AACR,2GAAA,gBAAgB,OAAA;AAChB,4GAAA,iBAAiB,OAAA;AACjB,yGAAA,cAAc,OAAA;AACd,qGAAA,UAAU,OAAA;AACV,kBAAkB;AAClB,6GAAA,kBAAkB,OAAA;AAClB,wGAAA,aAAa,OAAA;AACb,6GAAA,kBAAkB,OAAA;AAClB,yGAAA,cAAc,OAAA;AACd,+GAAA,oBAAoB,OAAA;AACpB,oHAAA,yBAAyB,OAAA;AACzB,8GAAA,mBAAmB,OAAA;AACnB,0GAAA,eAAe,OAAA;AACf,0GAAA,eAAe,OAAA;AACf,wGAAA,aAAa,OAAA;AACb,2GAAA,gBAAgB,OAAA;AAChB,+GAAA,oBAAoB,OAAA;AACpB,kHAAA,uBAAuB,OAAA;AACvB,+GAAA,oBAAoB,OAAA;AACpB,+GAAA,oBAAoB,OAAA;AACpB,aAAa;AACb,2GAAA,gBAAgB,OAAA;AAChB,mGAAA,QAAQ,OAAA;AAGV,sCAAsC;AACtC,uCAA0E;AAAjE,iHAAA,qBAAqB,OAAA;AAAE,iHAAA,qBAAqB,OAAA;AAErD,YAAY;AACZ,yCASqB;AARnB,wGAAA,WAAW,OAAA;AACX,8GAAA,iBAAiB,OAAA;AACjB,gHAAA,mBAAmB,OAAA;AAGnB,2GAAA,cAAc,OAAA;AACd,2GAAA,cAAc,OAAA;AACd,2GAAA,cAAc,OAAA;AAGhB,QAAQ;AACR,iCAMiB;AALf,2GAAA,kBAAkB,OAAA;AAClB,sGAAA,aAAa,OAAA;AACb,0GAAA,iBAAiB,OAAA;AACjB,mHAAA,0BAA0B,OAAA;AAC1B,iGAAA,QAAQ,OAAA;AAGV,UAAU;AACV,qCAA+C;AAAtC,6GAAA,kBAAkB,OAAA;AAE3B,kBAAkB;AAClB,iCAA0D;AAAjD,uGAAA,cAAc,OAAA;AAAE,wGAAA,eAAe,OAAA"}

package/dist/tracker/pipeline.d.ts

@@ -0,0 +1,47 @@
+/**
+ * Pipeline Stage Functions
+ *
+ * Pure functions that track stages and return updated state.
+ * Each function reads from state, performs tracking, and returns new state.
+ */
+import { TrackingContext } from "./context";
+export declare function pipelineTrackProposalCreated(state: TrackingContext): Promise<{
+    state: TrackingContext;
+    found: boolean;
+}>;
+export declare function pipelineTrackVoting(state: TrackingContext): Promise<{
+    state: TrackingContext;
+    complete: boolean;
+}>;
+export declare function pipelineTrackProposalQueued(state: TrackingContext): Promise<{
+    state: TrackingContext;
+    queued: boolean;
+}>;
+export declare function pipelineTrackL2Timelock(state: TrackingContext): Promise<{
+    state: TrackingContext;
+    executed: boolean;
+}>;
+export declare function pipelineTrackL2ToL1Message(state: TrackingContext): Promise<{
+    state: TrackingContext;
+    executed: boolean;
+    needsL1: boolean;
+}>;
+export declare function pipelineTrackL1Timelock(state: TrackingContext): Promise<{
+    state: TrackingContext;
+    executed: boolean;
+}>;
+export declare function pipelineTrackRetryables(state: TrackingContext): Promise<{
+    state: TrackingContext;
+    redeemed: boolean;
+}>;
+/**
+ * Track full governor proposal pipeline.
+ * Returns final state after tracking all stages.
+ */
+export declare function trackGovernorPipeline(state: TrackingContext): Promise<TrackingContext>;
+/**
+ * Track timelock pipeline (stages 4-7).
+ * Used by governor pipeline and direct timelock tracking.
+ */
+export declare function trackTimelockPipeline(state: TrackingContext): Promise<TrackingContext>;
+//# sourceMappingURL=pipeline.d.ts.map

package/dist/tracker/pipeline.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pipeline.d.ts","sourceRoot":"","sources":["../../src/tracker/pipeline.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,OAAO,EACL,eAAe,EAiBhB,MAAM,WAAW,CAAC;AAuEnB,wBAAsB,4BAA4B,CAChD,KAAK,EAAE,eAAe,GACrB,OAAO,CAAC;IAAE,KAAK,EAAE,eAAe,CAAC;IAAC,KAAK,EAAE,OAAO,CAAA;CAAE,CAAC,CAwBrD;AAED,wBAAsB,mBAAmB,CACvC,KAAK,EAAE,eAAe,GACrB,OAAO,CAAC;IAAE,KAAK,EAAE,eAAe,CAAC;IAAC,QAAQ,EAAE,OAAO,CAAA;CAAE,CAAC,CAyBxD;AAED,wBAAsB,2BAA2B,CAC/C,KAAK,EAAE,eAAe,GACrB,OAAO,CAAC;IAAE,KAAK,EAAE,eAAe,CAAC;IAAC,MAAM,EAAE,OAAO,CAAA;CAAE,CAAC,CAoDtD;AAID,wBAAsB,uBAAuB,CAC3C,KAAK,EAAE,eAAe,GACrB,OAAO,CAAC;IAAE,KAAK,EAAE,eAAe,CAAC;IAAC,QAAQ,EAAE,OAAO,CAAA;CAAE,CAAC,CA+BxD;AAaD,wBAAsB,0BAA0B,CAC9C,KAAK,EAAE,eAAe,GACrB,OAAO,CAAC;IAAE,KAAK,EAAE,eAAe,CAAC;IAAC,QAAQ,EAAE,OAAO,CAAC;IAAC,OAAO,EAAE,OAAO,CAAA;CAAE,CAAC,CAuD1E;AAID,wBAAsB,uBAAuB,CAC3C,KAAK,EAAE,eAAe,GACrB,OAAO,CAAC;IAAE,KAAK,EAAE,eAAe,CAAC;IAAC,QAAQ,EAAE,OAAO,CAAA;CAAE,CAAC,CAkBxD;AAID,wBAAsB,uBAAuB,CAC3C,KAAK,EAAE,eAAe,GACrB,OAAO,CAAC;IAAE,KAAK,EAAE,eAAe,CAAC;IAAC,QAAQ,EAAE,OAAO,CAAA;CAAE,CAAC,CAoBxD;AAgBD;;;GAGG;AACH,wBAAsB,qBAAqB,CAAC,KAAK,EAAE,eAAe,GAAG,OAAO,CAAC,eAAe,CAAC,CAwB5F;AAED;;;GAGG;AACH,wBAAsB,qBAAqB,CAAC,KAAK,EAAE,eAAe,GAAG,OAAO,CAAC,eAAe,CAAC,CA8B5F"}