@gzeoneth/gov-tracker 0.1.0

package/dist/index.js

@@ -0,0 +1,164 @@
+"use strict";
+/**
+ * Arbitrum Governance Stage Tracking SDK
+ *
+ * A lightweight, high-performance library for tracking Arbitrum DAO
+ * governance proposal lifecycle stages.
+ *
+ * @example
+ * ```typescript
+ * import { createTracker, findExecutableStage } from "@gzeoneth/gov-tracker";
+ *
+ * const tracker = createTracker({
+ *   l2Provider: new ethers.providers.JsonRpcProvider(ARB1_RPC),
+ *   l1Provider: new ethers.providers.JsonRpcProvider(ETH_RPC),
+ * });
+ *
+ * const results = await tracker.trackByTxHash(proposalCreationTxHash);
+ * const readyStage = findExecutableStage(results[0].stages);
+ * if (readyStage) {
+ *   const prep = await tracker.prepareTransaction(readyStage);
+ *   if (prep.success) {
+ *     const tx = await signer.sendTransaction(prep.prepared);
+ *   }
+ * }
+ * ```
+ * @packageDocumentation
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.prepareTimelockStage = exports.prepareTimelockBatch = exports.prepareTimelockOperation = exports.tryFindSalt = exports.computeAndValidateOperationHash = exports.validateSaltBatch = exports.validateSalt = exports.decodeL1TimelockSchedule = exports.generateSecurityCouncilSalt = exports.saltFromDescription = exports.getL1BlockNumberFromL2 = exports.estimateTimestampFromBlock = exports.calculateRemainingSeconds = exports.calculateExpectedEta = exports.calculateEta = exports.checkVettingPeriod = exports.extractSecurityCouncilParamsForOperation = exports.extractSecurityCouncilParams = exports.isSecurityCouncilElectionProposal = exports.isSecurityCouncilOperation = exports.findCallScheduledByTxHash = exports.getTimelockState = exports.getTimelockOperationState = exports.isL1Timelock = exports.isKnownL2Timelock = exports.discoverProposalByTxHash = exports.getProposalState = exports.getTimelockAddress = exports.detectGovernorCapabilities = exports.isElectionProposal = exports.detectProposalType = exports.isTimelockStage = exports.extractOperationId = exports.areAllStagesComplete = exports.getCurrentStage = exports.getTrackingStatusSummary = exports.needsAction = exports.findAllExecutableStages = exports.findExecutableStage = exports.buildDefaultTargets = exports.isElectionGovernor = exports.CHUNK_SIZES = exports.DEFAULT_RPC_URLS = exports.CHAIN_IDS = exports.ADDRESSES = exports.getStageData = exports.isStageType = exports.extractTimelockLink = exports.createTracker = exports.ProposalStageTracker = void 0;
+exports.createTrackingContext = exports.createCheckpoint = exports.prepareMemberElectionTrigger = exports.getElectionProposalParams = exports.getElectionProposalId = exports.trackElectionProposal = exports.hasVettingPeriod = exports.prepareElectionCreation = exports.checkElectionStatus = exports.getChainType = exports.isAddressIn = exports.addressEquals = exports.getTotalExpectedDuration = exports.formatStageTitle = exports.getActionableStages = exports.getAllStageMetadata = exports.getStageMetadata = exports.chainTypeToId = exports.getStageTransactionUrl = exports.getTxUrl = exports.prepareGovernorQueue = exports.prepareRetryableStage = exports.prepareAllRetryables = exports.prepareRetryableRedemption = exports.getL2ToL1Messages = exports.prepareL2ToL1MessageStage = exports.prepareL2ToL1Message = exports.calculateBatchRetryableValues = exports.calculateRetryableExecutionValue = void 0;
+// ============================================================================
+// TIER 1: Core Public API
+// ============================================================================
+// Main entry points
+var tracker_1 = require("./tracker");
+Object.defineProperty(exports, "ProposalStageTracker", { enumerable: true, get: function () { return tracker_1.ProposalStageTracker; } });
+Object.defineProperty(exports, "createTracker", { enumerable: true, get: function () { return tracker_1.createTracker; } });
+Object.defineProperty(exports, "extractTimelockLink", { enumerable: true, get: function () { return tracker_1.extractTimelockLink; } });
+// Type guards
+var types_1 = require("./types");
+Object.defineProperty(exports, "isStageType", { enumerable: true, get: function () { return types_1.isStageType; } });
+Object.defineProperty(exports, "getStageData", { enumerable: true, get: function () { return types_1.getStageData; } });
+// Constants
+var constants_1 = require("./constants");
+Object.defineProperty(exports, "ADDRESSES", { enumerable: true, get: function () { return constants_1.ADDRESSES; } });
+Object.defineProperty(exports, "CHAIN_IDS", { enumerable: true, get: function () { return constants_1.CHAIN_IDS; } });
+Object.defineProperty(exports, "DEFAULT_RPC_URLS", { enumerable: true, get: function () { return constants_1.DEFAULT_RPC_URLS; } });
+Object.defineProperty(exports, "CHUNK_SIZES", { enumerable: true, get: function () { return constants_1.CHUNK_SIZES; } });
+Object.defineProperty(exports, "isElectionGovernor", { enumerable: true, get: function () { return constants_1.isElectionGovernor; } });
+Object.defineProperty(exports, "buildDefaultTargets", { enumerable: true, get: function () { return constants_1.buildDefaultTargets; } });
+// Stage utilities
+var base_1 = require("./stages/base");
+Object.defineProperty(exports, "findExecutableStage", { enumerable: true, get: function () { return base_1.findExecutableStage; } });
+Object.defineProperty(exports, "findAllExecutableStages", { enumerable: true, get: function () { return base_1.findAllExecutableStages; } });
+Object.defineProperty(exports, "needsAction", { enumerable: true, get: function () { return base_1.needsAction; } });
+Object.defineProperty(exports, "getTrackingStatusSummary", { enumerable: true, get: function () { return base_1.getTrackingStatusSummary; } });
+Object.defineProperty(exports, "getCurrentStage", { enumerable: true, get: function () { return base_1.getCurrentStage; } });
+Object.defineProperty(exports, "areAllStagesComplete", { enumerable: true, get: function () { return base_1.areAllStagesComplete; } });
+Object.defineProperty(exports, "extractOperationId", { enumerable: true, get: function () { return base_1.extractOperationId; } });
+Object.defineProperty(exports, "isTimelockStage", { enumerable: true, get: function () { return base_1.isTimelockStage; } });
+// ============================================================================
+// TIER 2: Advanced API - Power user functions
+// ============================================================================
+// Governor introspection
+var governor_discovery_1 = require("./discovery/governor-discovery");
+Object.defineProperty(exports, "detectProposalType", { enumerable: true, get: function () { return governor_discovery_1.detectProposalType; } });
+Object.defineProperty(exports, "isElectionProposal", { enumerable: true, get: function () { return governor_discovery_1.isElectionProposal; } });
+Object.defineProperty(exports, "detectGovernorCapabilities", { enumerable: true, get: function () { return governor_discovery_1.detectGovernorCapabilities; } });
+Object.defineProperty(exports, "getTimelockAddress", { enumerable: true, get: function () { return governor_discovery_1.getTimelockAddress; } });
+Object.defineProperty(exports, "getProposalState", { enumerable: true, get: function () { return governor_discovery_1.getProposalState; } });
+Object.defineProperty(exports, "discoverProposalByTxHash", { enumerable: true, get: function () { return governor_discovery_1.discoverProposalByTxHash; } });
+// Timelock introspection
+var timelock_discovery_1 = require("./discovery/timelock-discovery");
+Object.defineProperty(exports, "isKnownL2Timelock", { enumerable: true, get: function () { return timelock_discovery_1.isKnownL2Timelock; } });
+Object.defineProperty(exports, "isL1Timelock", { enumerable: true, get: function () { return timelock_discovery_1.isL1Timelock; } });
+Object.defineProperty(exports, "getTimelockOperationState", { enumerable: true, get: function () { return timelock_discovery_1.getTimelockOperationState; } });
+Object.defineProperty(exports, "getTimelockState", { enumerable: true, get: function () { return timelock_discovery_1.getTimelockState; } });
+Object.defineProperty(exports, "findCallScheduledByTxHash", { enumerable: true, get: function () { return timelock_discovery_1.findCallScheduledByTxHash; } });
+// Security Council
+var security_council_1 = require("./discovery/security-council");
+Object.defineProperty(exports, "isSecurityCouncilOperation", { enumerable: true, get: function () { return security_council_1.isSecurityCouncilOperation; } });
+Object.defineProperty(exports, "isSecurityCouncilElectionProposal", { enumerable: true, get: function () { return security_council_1.isSecurityCouncilElectionProposal; } });
+Object.defineProperty(exports, "extractSecurityCouncilParams", { enumerable: true, get: function () { return security_council_1.extractSecurityCouncilParams; } });
+Object.defineProperty(exports, "extractSecurityCouncilParamsForOperation", { enumerable: true, get: function () { return security_council_1.extractSecurityCouncilParamsForOperation; } });
+Object.defineProperty(exports, "checkVettingPeriod", { enumerable: true, get: function () { return security_council_1.checkVettingPeriod; } });
+// Timing utilities
+var timing_1 = require("./utils/timing");
+Object.defineProperty(exports, "calculateEta", { enumerable: true, get: function () { return timing_1.calculateEta; } });
+Object.defineProperty(exports, "calculateExpectedEta", { enumerable: true, get: function () { return timing_1.calculateExpectedEta; } });
+Object.defineProperty(exports, "calculateRemainingSeconds", { enumerable: true, get: function () { return timing_1.calculateRemainingSeconds; } });
+Object.defineProperty(exports, "estimateTimestampFromBlock", { enumerable: true, get: function () { return timing_1.estimateTimestampFromBlock; } });
+Object.defineProperty(exports, "getL1BlockNumberFromL2", { enumerable: true, get: function () { return timing_1.getL1BlockNumberFromL2; } });
+// Salt utilities
+var salt_computation_1 = require("./utils/salt-computation");
+Object.defineProperty(exports, "saltFromDescription", { enumerable: true, get: function () { return salt_computation_1.saltFromDescription; } });
+Object.defineProperty(exports, "generateSecurityCouncilSalt", { enumerable: true, get: function () { return salt_computation_1.generateSecurityCouncilSalt; } });
+Object.defineProperty(exports, "decodeL1TimelockSchedule", { enumerable: true, get: function () { return salt_computation_1.decodeL1TimelockSchedule; } });
+// Operation ID utilities
+var operation_id_1 = require("./utils/operation-id");
+Object.defineProperty(exports, "validateSalt", { enumerable: true, get: function () { return operation_id_1.validateSalt; } });
+Object.defineProperty(exports, "validateSaltBatch", { enumerable: true, get: function () { return operation_id_1.validateSaltBatch; } });
+Object.defineProperty(exports, "computeAndValidateOperationHash", { enumerable: true, get: function () { return operation_id_1.computeAndValidateOperationHash; } });
+Object.defineProperty(exports, "tryFindSalt", { enumerable: true, get: function () { return operation_id_1.tryFindSalt; } });
+// ============================================================================
+// TIER 3: Execution Preparation
+// ============================================================================
+// Timelock preparation
+var timelock_1 = require("./stages/timelock");
+Object.defineProperty(exports, "prepareTimelockOperation", { enumerable: true, get: function () { return timelock_1.prepareTimelockOperation; } });
+Object.defineProperty(exports, "prepareTimelockBatch", { enumerable: true, get: function () { return timelock_1.prepareTimelockBatch; } });
+Object.defineProperty(exports, "prepareTimelockStage", { enumerable: true, get: function () { return timelock_1.prepareTimelockStage; } });
+Object.defineProperty(exports, "calculateRetryableExecutionValue", { enumerable: true, get: function () { return timelock_1.calculateRetryableExecutionValue; } });
+Object.defineProperty(exports, "calculateBatchRetryableValues", { enumerable: true, get: function () { return timelock_1.calculateBatchRetryableValues; } });
+// L2→L1 message preparation
+var l2_to_l1_message_1 = require("./stages/l2-to-l1-message");
+Object.defineProperty(exports, "prepareL2ToL1Message", { enumerable: true, get: function () { return l2_to_l1_message_1.prepareL2ToL1Message; } });
+Object.defineProperty(exports, "prepareL2ToL1MessageStage", { enumerable: true, get: function () { return l2_to_l1_message_1.prepareL2ToL1MessageStage; } });
+Object.defineProperty(exports, "getL2ToL1Messages", { enumerable: true, get: function () { return l2_to_l1_message_1.getL2ToL1Messages; } });
+// Retryable preparation
+var retryables_1 = require("./stages/retryables");
+Object.defineProperty(exports, "prepareRetryableRedemption", { enumerable: true, get: function () { return retryables_1.prepareRetryableRedemption; } });
+Object.defineProperty(exports, "prepareAllRetryables", { enumerable: true, get: function () { return retryables_1.prepareAllRetryables; } });
+Object.defineProperty(exports, "prepareRetryableStage", { enumerable: true, get: function () { return retryables_1.prepareRetryableStage; } });
+// Governor queue preparation
+var proposal_queued_1 = require("./stages/proposal-queued");
+Object.defineProperty(exports, "prepareGovernorQueue", { enumerable: true, get: function () { return proposal_queued_1.prepareGovernorQueue; } });
+// ============================================================================
+// TIER 4: Framework Utilities
+// ============================================================================
+// URL generation
+var urls_1 = require("./utils/urls");
+Object.defineProperty(exports, "getTxUrl", { enumerable: true, get: function () { return urls_1.getTxUrl; } });
+Object.defineProperty(exports, "getStageTransactionUrl", { enumerable: true, get: function () { return urls_1.getStageTransactionUrl; } });
+Object.defineProperty(exports, "chainTypeToId", { enumerable: true, get: function () { return urls_1.chainTypeToId; } });
+// Stage metadata
+var stage_metadata_1 = require("./utils/stage-metadata");
+Object.defineProperty(exports, "getStageMetadata", { enumerable: true, get: function () { return stage_metadata_1.getStageMetadata; } });
+Object.defineProperty(exports, "getAllStageMetadata", { enumerable: true, get: function () { return stage_metadata_1.getAllStageMetadata; } });
+Object.defineProperty(exports, "getActionableStages", { enumerable: true, get: function () { return stage_metadata_1.getActionableStages; } });
+Object.defineProperty(exports, "formatStageTitle", { enumerable: true, get: function () { return stage_metadata_1.formatStageTitle; } });
+Object.defineProperty(exports, "getTotalExpectedDuration", { enumerable: true, get: function () { return stage_metadata_1.getTotalExpectedDuration; } });
+// Address utilities
+var chain_1 = require("./utils/chain");
+Object.defineProperty(exports, "addressEquals", { enumerable: true, get: function () { return chain_1.addressEquals; } });
+Object.defineProperty(exports, "isAddressIn", { enumerable: true, get: function () { return chain_1.isAddressIn; } });
+Object.defineProperty(exports, "getChainType", { enumerable: true, get: function () { return chain_1.getChainType; } });
+// ============================================================================
+// TIER 5: Election Tracking
+// ============================================================================
+var election_1 = require("./election");
+Object.defineProperty(exports, "checkElectionStatus", { enumerable: true, get: function () { return election_1.checkElectionStatus; } });
+Object.defineProperty(exports, "prepareElectionCreation", { enumerable: true, get: function () { return election_1.prepareElectionCreation; } });
+Object.defineProperty(exports, "hasVettingPeriod", { enumerable: true, get: function () { return election_1.hasVettingPeriod; } });
+Object.defineProperty(exports, "trackElectionProposal", { enumerable: true, get: function () { return election_1.trackElectionProposal; } });
+Object.defineProperty(exports, "getElectionProposalId", { enumerable: true, get: function () { return election_1.getElectionProposalId; } });
+Object.defineProperty(exports, "getElectionProposalParams", { enumerable: true, get: function () { return election_1.getElectionProposalParams; } });
+Object.defineProperty(exports, "prepareMemberElectionTrigger", { enumerable: true, get: function () { return election_1.prepareMemberElectionTrigger; } });
+// ============================================================================
+// TIER 6: Internal Utilities (for testing)
+// ============================================================================
+var context_1 = require("./tracker/context");
+Object.defineProperty(exports, "createCheckpoint", { enumerable: true, get: function () { return context_1.createCheckpoint; } });
+Object.defineProperty(exports, "createTrackingContext", { enumerable: true, get: function () { return context_1.createTrackingContext; } });
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/dist/stages/base.d.ts

@@ -0,0 +1,127 @@
+/**
+ * Shared utilities for stage tracking
+ *
+ * Common patterns and helpers used across all stage modules
+ */
+import { ethers } from "ethers";
+import { CallScheduledData, PrepareResult, SerializedCallScheduledData, StageType, TrackedStage } from "../types";
+/** Generic serializer: converts BigNumber fields to strings for JSON storage. */
+export declare function serialize<T>(data: T, bigNumFields: readonly string[]): T;
+/** Generic deserializer: converts string fields back to BigNumber. */
+export declare function deserialize<T>(data: T, bigNumFields: readonly string[]): T;
+/** Serialize CallScheduledData for JSON storage. */
+export declare const serializeCallScheduledData: (data: CallScheduledData) => SerializedCallScheduledData;
+/** Deserialize CallScheduledData from JSON storage. */
+export declare const deserializeCallScheduledData: (data: SerializedCallScheduledData) => CallScheduledData;
+/** Serialize/deserialize arrays. */
+export declare const serializeCallScheduledDataArray: (data: CallScheduledData[]) => SerializedCallScheduledData[];
+export declare const deserializeCallScheduledDataArray: (data: SerializedCallScheduledData[]) => CallScheduledData[];
+/**
+ * Calculate ETA from CallScheduled event data
+ *
+ * ETA = block timestamp + delay seconds
+ * This works even when operation is done (contract returns _DONE_TIMESTAMP=1)
+ */
+export declare function calculateEtaFromScheduledData(blockNumber: number, delaySeconds: number, provider: ethers.providers.Provider): Promise<number>;
+/**
+ * Check if a proposal is Constitutional (requires L1 round-trip).
+ *
+ * Constitutional proposals (from Constitutional Governor) go through:
+ * L2 Timelock (8 days) → L2→L1 Message → L1 Timelock (3 days) → Retryables
+ *
+ * Non-Constitutional proposals (from Non-Constitutional Governor) are L2-only:
+ * L2 Timelock (3 days) → L2 Execution
+ *
+ * Also works with timelock addresses for direct timelock entry.
+ *
+ * @see https://docs.arbitrum.foundation/concepts/lifecycle-anatomy-aip-proposal
+ */
+export declare function isConstitutional(governorOrTimelockAddress: string): boolean;
+/**
+ * Get all stages for a governor path
+ *
+ * Always returns all 7 stages to ensure consistent stage arrays.
+ * For L2-only paths (Treasury Governor), the L2→L1 and L1 stages
+ * will be marked as SKIPPED during tracking.
+ */
+export declare function getStagesForPath(_governorAddress: string, includeProposalStages?: boolean): StageType[];
+/**
+ * Initialize all stages for a path
+ */
+export declare function initializeStagesForPath(governorAddress: string, includeProposalStages?: boolean): TrackedStage[];
+/**
+ * Find a stage by type in a list of stages
+ */
+export declare function findStage(stages: TrackedStage[], type: StageType): TrackedStage | undefined;
+/**
+ * Update a stage in a list of stages
+ */
+export declare function updateStageInList(stages: TrackedStage[], updatedStage: TrackedStage): TrackedStage[];
+/**
+ * Get the current active stage (first non-completed stage)
+ */
+export declare function getCurrentStage(stages: TrackedStage[]): TrackedStage | null;
+/**
+ * Check if all stages are complete
+ */
+export declare function areAllStagesComplete(stages: TrackedStage[]): boolean;
+/**
+ * Get block timestamp from provider
+ */
+export declare function getBlockTimestamp(blockNumber: number, provider: ethers.providers.Provider): Promise<number>;
+/**
+ * Find first READY stage that's executable
+ */
+export declare function findExecutableStage(stages: TrackedStage[]): TrackedStage | null;
+/** Timelock stage types (consolidated stages that require execution) */
+export declare const TIMELOCK_STAGE_TYPES: readonly ["L2_TIMELOCK", "L1_TIMELOCK"];
+/**
+ * Check if a stage type is a timelock stage
+ */
+export declare function isTimelockStage(type: StageType | string): boolean;
+/**
+ * Find all READY executable stages
+ */
+export declare function findAllExecutableStages(stages: TrackedStage[]): TrackedStage[];
+/**
+ * Check if a tracking result has any stage ready for execution.
+ *
+ * This is a convenience wrapper around findExecutableStage() that returns
+ * a boolean, useful for filtering or conditional logic.
+ *
+ * @param stages - Array of tracked stages (typically from TrackingResult.stages)
+ * @returns true if any stage is ready for execution
+ */
+export declare function needsAction(stages: TrackedStage[]): boolean;
+/**
+ * Get summary of stage statuses (single pass)
+ */
+export declare function getTrackingStatusSummary(stages: TrackedStage[]): {
+    total: number;
+    completed: number;
+    pending: number;
+    ready: number;
+    failed: number;
+    skipped: number;
+};
+/**
+ * Extract the operationId from tracked stages.
+ *
+ * The operationId links a governor proposal to its timelock operation.
+ * It can be found in PROPOSAL_QUEUED or L2_TIMELOCK stages.
+ *
+ * @param stages - Array of tracked stages
+ * @returns The operationId if found, undefined otherwise
+ */
+export declare function extractOperationId(stages: TrackedStage[]): string | undefined;
+/**
+ * Create a failed PrepareResult with an error message.
+ * Reduces boilerplate for the common pattern: { success: false, error: "..." }
+ */
+export declare function failPrepare(error: string): PrepareResult;
+/**
+ * Check if a timelock operation is ready for execution.
+ * Returns null if ready, or an error result if not ready or already executed.
+ */
+export declare function checkOperationReady(timelockAddress: string, operationId: string, provider: ethers.providers.Provider): Promise<PrepareResult | null>;
+//# sourceMappingURL=base.d.ts.map

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

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

package/dist/stages/base.js

@@ -0,0 +1,280 @@
+"use strict";
+/**
+ * Shared utilities for stage tracking
+ *
+ * Common patterns and helpers used across all stage modules
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TIMELOCK_STAGE_TYPES = exports.deserializeCallScheduledDataArray = exports.serializeCallScheduledDataArray = exports.deserializeCallScheduledData = exports.serializeCallScheduledData = void 0;
+exports.serialize = serialize;
+exports.deserialize = deserialize;
+exports.calculateEtaFromScheduledData = calculateEtaFromScheduledData;
+exports.isConstitutional = isConstitutional;
+exports.getStagesForPath = getStagesForPath;
+exports.initializeStagesForPath = initializeStagesForPath;
+exports.findStage = findStage;
+exports.updateStageInList = updateStageInList;
+exports.getCurrentStage = getCurrentStage;
+exports.areAllStagesComplete = areAllStagesComplete;
+exports.getBlockTimestamp = getBlockTimestamp;
+exports.findExecutableStage = findExecutableStage;
+exports.isTimelockStage = isTimelockStage;
+exports.findAllExecutableStages = findAllExecutableStages;
+exports.needsAction = needsAction;
+exports.getTrackingStatusSummary = getTrackingStatusSummary;
+exports.extractOperationId = extractOperationId;
+exports.failPrepare = failPrepare;
+exports.checkOperationReady = checkOperationReady;
+const ethers_1 = require("ethers");
+const abis_1 = require("../abis");
+const constants_1 = require("../constants");
+const chain_1 = require("../utils/chain");
+const rpc_utils_1 = require("../utils/rpc-utils");
+// ============================================================================
+// Serialization Utilities
+// ============================================================================
+const CALL_SCHEDULED_BIGNUM_FIELDS = ["index", "value", "delay"];
+/** Generic serializer: converts BigNumber fields to strings for JSON storage. */
+function serialize(data, bigNumFields) {
+    const result = {};
+    for (const key of Object.keys(data)) {
+        const val = data[key];
+        result[key] =
+            bigNumFields.includes(key) &&
+                val &&
+                typeof val.toString === "function"
+                ? val.toString()
+                : val;
+    }
+    return result;
+}
+/** Generic deserializer: converts string fields back to BigNumber. */
+function deserialize(data, bigNumFields) {
+    const result = {};
+    for (const key of Object.keys(data)) {
+        const val = data[key];
+        result[key] =
+            bigNumFields.includes(key) && typeof val === "string" ? ethers_1.BigNumber.from(val) : val;
+    }
+    return result;
+}
+/** Serialize CallScheduledData for JSON storage. */
+const serializeCallScheduledData = (data) => serialize(data, CALL_SCHEDULED_BIGNUM_FIELDS);
+exports.serializeCallScheduledData = serializeCallScheduledData;
+/** Deserialize CallScheduledData from JSON storage. */
+const deserializeCallScheduledData = (data) => deserialize(data, CALL_SCHEDULED_BIGNUM_FIELDS);
+exports.deserializeCallScheduledData = deserializeCallScheduledData;
+/** Serialize/deserialize arrays. */
+const serializeCallScheduledDataArray = (data) => data.map(exports.serializeCallScheduledData);
+exports.serializeCallScheduledDataArray = serializeCallScheduledDataArray;
+const deserializeCallScheduledDataArray = (data) => data.map(exports.deserializeCallScheduledData);
+exports.deserializeCallScheduledDataArray = deserializeCallScheduledDataArray;
+// ============================================================================
+// Stage Creation and Management
+// ============================================================================
+/**
+ * Create a new tracked stage with default values
+ */
+function createStage(type, chain, status = "NOT_STARTED") {
+    return {
+        type,
+        status,
+        chain,
+        transactions: [],
+        data: {},
+        executable: false,
+    };
+}
+/**
+ * Calculate ETA from CallScheduled event data
+ *
+ * ETA = block timestamp + delay seconds
+ * This works even when operation is done (contract returns _DONE_TIMESTAMP=1)
+ */
+async function calculateEtaFromScheduledData(blockNumber, delaySeconds, provider) {
+    const timestamp = await getBlockTimestamp(blockNumber, provider);
+    return timestamp + delaySeconds;
+}
+/**
+ * Check if a proposal is Constitutional (requires L1 round-trip).
+ *
+ * Constitutional proposals (from Constitutional Governor) go through:
+ * L2 Timelock (8 days) → L2→L1 Message → L1 Timelock (3 days) → Retryables
+ *
+ * Non-Constitutional proposals (from Non-Constitutional Governor) are L2-only:
+ * L2 Timelock (3 days) → L2 Execution
+ *
+ * Also works with timelock addresses for direct timelock entry.
+ *
+ * @see https://docs.arbitrum.foundation/concepts/lifecycle-anatomy-aip-proposal
+ */
+function isConstitutional(governorOrTimelockAddress) {
+    return (0, chain_1.isAddressIn)(governorOrTimelockAddress, [
+        constants_1.ADDRESSES.CONSTITUTIONAL_GOVERNOR,
+        constants_1.ADDRESSES.L2_CONSTITUTIONAL_TIMELOCK,
+    ]);
+}
+/**
+ * Get all stages for a governor path
+ *
+ * Always returns all 7 stages to ensure consistent stage arrays.
+ * For L2-only paths (Treasury Governor), the L2→L1 and L1 stages
+ * will be marked as SKIPPED during tracking.
+ */
+function getStagesForPath(_governorAddress, includeProposalStages = true) {
+    const proposalStages = includeProposalStages
+        ? ["PROPOSAL_CREATED", "VOTING_ACTIVE", "PROPOSAL_QUEUED"]
+        : [];
+    // Always return all 7 stages - L2-only paths mark extra stages as SKIPPED
+    return [
+        ...proposalStages,
+        "L2_TIMELOCK",
+        "L2_TO_L1_MESSAGE",
+        "L1_TIMELOCK",
+        "RETRYABLE_EXECUTED",
+    ];
+}
+/**
+ * Initialize all stages for a path
+ */
+function initializeStagesForPath(governorAddress, includeProposalStages = true) {
+    const stageTypes = getStagesForPath(governorAddress, includeProposalStages);
+    return stageTypes.map((type) => {
+        // L1_TIMELOCK and RETRYABLE_EXECUTED are L1 stages
+        // L2_TO_L1_MESSAGE is cross-chain but logically completes on L1
+        const chain = type === "L1_TIMELOCK" || type === "RETRYABLE_EXECUTED" ? "L1" : "L2";
+        return createStage(type, chain, "NOT_STARTED");
+    });
+}
+/**
+ * Find a stage by type in a list of stages
+ */
+function findStage(stages, type) {
+    return stages.find((s) => s.type === type);
+}
+/**
+ * Update a stage in a list of stages
+ */
+function updateStageInList(stages, updatedStage) {
+    return stages.map((s) => (s.type === updatedStage.type ? updatedStage : s));
+}
+/**
+ * Get the current active stage (first non-completed stage)
+ */
+function getCurrentStage(stages) {
+    for (const stage of stages) {
+        if (stage.status !== "COMPLETED" && stage.status !== "SKIPPED" && stage.status !== "FAILED") {
+            return stage;
+        }
+    }
+    return null;
+}
+/**
+ * Check if all stages are complete
+ */
+function areAllStagesComplete(stages) {
+    return stages.every((s) => s.status === "COMPLETED" || s.status === "SKIPPED" || s.status === "FAILED");
+}
+/**
+ * Get block timestamp from provider
+ */
+async function getBlockTimestamp(blockNumber, provider) {
+    const block = await (0, rpc_utils_1.queryWithRetry)(() => provider.getBlock(blockNumber));
+    if (!block) {
+        throw new Error(`Block ${blockNumber} not found`);
+    }
+    return block.timestamp;
+}
+/**
+ * Find first READY stage that's executable
+ */
+function findExecutableStage(stages) {
+    return stages.find((s) => s.status === "READY" && s.executable === true) ?? null;
+}
+/** Timelock stage types (consolidated stages that require execution) */
+exports.TIMELOCK_STAGE_TYPES = ["L2_TIMELOCK", "L1_TIMELOCK"];
+/**
+ * Check if a stage type is a timelock stage
+ */
+function isTimelockStage(type) {
+    return exports.TIMELOCK_STAGE_TYPES.includes(type);
+}
+/**
+ * Find all READY executable stages
+ */
+function findAllExecutableStages(stages) {
+    return stages.filter((s) => s.status === "READY" && s.executable === true);
+}
+/**
+ * Check if a tracking result has any stage ready for execution.
+ *
+ * This is a convenience wrapper around findExecutableStage() that returns
+ * a boolean, useful for filtering or conditional logic.
+ *
+ * @param stages - Array of tracked stages (typically from TrackingResult.stages)
+ * @returns true if any stage is ready for execution
+ */
+function needsAction(stages) {
+    return findExecutableStage(stages) !== null;
+}
+/**
+ * Get summary of stage statuses (single pass)
+ */
+function getTrackingStatusSummary(stages) {
+    const counts = stages.reduce((acc, s) => {
+        acc[s.status]++;
+        return acc;
+    }, { COMPLETED: 0, PENDING: 0, READY: 0, FAILED: 0, SKIPPED: 0, NOT_STARTED: 0 });
+    return {
+        total: stages.length,
+        completed: counts.COMPLETED,
+        pending: counts.PENDING,
+        ready: counts.READY,
+        failed: counts.FAILED,
+        skipped: counts.SKIPPED,
+    };
+}
+/**
+ * Extract the operationId from tracked stages.
+ *
+ * The operationId links a governor proposal to its timelock operation.
+ * It can be found in PROPOSAL_QUEUED or L2_TIMELOCK stages.
+ *
+ * @param stages - Array of tracked stages
+ * @returns The operationId if found, undefined otherwise
+ */
+function extractOperationId(stages) {
+    // Check stages that contain operationId (in order of likelihood)
+    const stageTypes = ["PROPOSAL_QUEUED", "L2_TIMELOCK"];
+    for (const type of stageTypes) {
+        const stage = stages.find((s) => s.type === type);
+        const opId = stage?.data?.operationId;
+        if (typeof opId === "string" && opId.length > 0) {
+            return opId;
+        }
+    }
+    return undefined;
+}
+/**
+ * Create a failed PrepareResult with an error message.
+ * Reduces boilerplate for the common pattern: { success: false, error: "..." }
+ */
+function failPrepare(error) {
+    return { success: false, error };
+}
+/**
+ * Check if a timelock operation is ready for execution.
+ * Returns null if ready, or an error result if not ready or already executed.
+ */
+async function checkOperationReady(timelockAddress, operationId, provider) {
+    const timelock = new ethers_1.ethers.Contract(timelockAddress, abis_1.TIMELOCK_ABI, provider);
+    const isReady = await (0, rpc_utils_1.queryWithRetry)(() => timelock.isOperationReady(operationId));
+    if (isReady)
+        return null; // Ready - no error
+    const isDone = await (0, rpc_utils_1.queryWithRetry)(() => timelock.isOperationDone(operationId));
+    if (isDone) {
+        return failPrepare("Operation already executed");
+    }
+    return failPrepare("Operation is not ready for execution");
+}
+//# sourceMappingURL=base.js.map

package/dist/stages/base.js.map

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