@gzeoneth/gov-tracker 0.2.0-0 → 0.2.0-2

package/dist/tracker/context.d.ts

@@ -1,111 +0,0 @@
-/**
- * TrackingContext - Functional state management for pipeline tracking
- *
- * This module provides a purely functional approach to tracking context:
- * - TrackingContext interface defines the immutable state shape
- * - Pure functions transform state and derive values
- * - No classes, no mutation, no hidden state
- *
- * Benefits:
- * - Easy testing: just create plain objects
- * - Transparent: can log/inspect full state anytime
- * - Predictable: same input → same output
- * - Composable: mix and match functions freely
- * - Debuggable: save/restore state snapshots
- */
-import { ethers } from "ethers";
-import { TrackedStage, TrackingCheckpoint, TrackingInput, StageType, CallScheduledData, ProposalData, ProposalType, ProposalState, OnProgressCallback, ChunkingConfig } from "../types";
-/**
- * Providers for multi-chain operations
- */
-export interface Providers {
-    readonly l2: ethers.providers.Provider;
-    readonly l1: ethers.providers.Provider;
-    readonly nova: ethers.providers.Provider;
-}
-/**
- * Options for creating a TrackingContext
- */
-export interface CreateTrackingContextOptions {
-    providers: Providers;
-    input: TrackingInput;
-    onProgress?: OnProgressCallback;
-    chunkingConfig?: ChunkingConfig;
-    checkpoint?: TrackingCheckpoint;
-    cacheKey?: string;
-    /** Bootstrap data for timelock-only tracking */
-    callScheduledData?: CallScheduledData[];
-}
-/**
- * TrackingContext - Immutable state for pipeline tracking
- *
- * All values are derived from stages. This interface represents
- * a snapshot of the pipeline at a point in time.
- *
- * @example
- * ```typescript
- * let ctx = createTrackingContext({ providers, input });
- * ctx = await addStage(ctx, proposalCreatedStage);
- * const opId = getOperationId(ctx);
- * ```
- */
-export interface TrackingContext {
-    readonly providers: Providers;
-    readonly chunkingConfig: ChunkingConfig;
-    readonly onProgress?: OnProgressCallback;
-    readonly cacheKey?: string;
-    readonly input: TrackingInput;
-    readonly callScheduledData?: CallScheduledData[];
-    readonly stages: TrackedStage[];
-    readonly stageIndex: number;
-}
-/**
- * Create a new TrackingContext.
- */
-export declare function createTrackingContext(options: CreateTrackingContextOptions): TrackingContext;
-/**
- * Add or update a stage. Returns new context.
- */
-export declare function addStage(ctx: TrackingContext, stage: TrackedStage): Promise<TrackingContext>;
-/** Check if a stage is completed (COMPLETED or SKIPPED). */
-export declare function isStageCompleted(ctx: TrackingContext, type: StageType): boolean;
-/** Get a completed stage for zero-RPC resume. */
-export declare function getCompletedStage(ctx: TrackingContext, type: StageType): TrackedStage | undefined;
-/** Get a cached stage (any status). */
-export declare function getCachedStage(ctx: TrackingContext, type: StageType): TrackedStage | undefined;
-/**
- * Check if all stages are complete.
- */
-export declare function isComplete(ctx: TrackingContext): boolean;
-export declare const getGovernorAddress: (ctx: TrackingContext) => string | undefined;
-export declare const getProposalId: (ctx: TrackingContext) => string | undefined;
-export declare function getTimelockAddress(ctx: TrackingContext): string | undefined;
-export declare function getOperationId(ctx: TrackingContext): string | undefined;
-export declare function getCallScheduledData(ctx: TrackingContext): CallScheduledData[] | undefined;
-export declare const getFirstCallScheduledData: (ctx: TrackingContext) => CallScheduledData | undefined;
-export declare const getQueueBlockNumber: (ctx: TrackingContext) => number | undefined;
-/** Proposal data from PROPOSAL_CREATED stage */
-export declare function getProposalData(ctx: TrackingContext): ProposalData | undefined;
-export declare function getProposalType(ctx: TrackingContext): ProposalType | undefined;
-export declare const getIsElection: (ctx: TrackingContext) => boolean;
-export declare const getProposalState: (ctx: TrackingContext) => ProposalState | undefined;
-export declare function getVotingEndBlock(ctx: TrackingContext): number | undefined;
-export declare function getL2ExecutionTxHash(ctx: TrackingContext): string | undefined;
-export declare const getFirstExecutableBlock: (ctx: TrackingContext) => number | undefined;
-export declare function getOutboxExecutionTx(ctx: TrackingContext): {
-    hash: string;
-    blockNumber: number;
-} | undefined;
-export declare function getL1ExecutionTxHash(ctx: TrackingContext): string | undefined;
-export declare function createCheckpoint(ctx: TrackingContext): TrackingCheckpoint;
-export declare function toResult(ctx: TrackingContext): {
-    input: TrackingInput;
-    stages: TrackedStage[];
-    checkpoint: TrackingCheckpoint;
-    isComplete: boolean;
-    proposalType: ProposalType | undefined;
-    proposalData: ProposalData | undefined;
-    currentState: ProposalState | undefined;
-    isElection: boolean;
-};
-//# sourceMappingURL=context.d.ts.map

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

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

package/dist/tracker/context.js

@@ -1,264 +0,0 @@
-"use strict";
-/**
- * TrackingContext - Functional state management for pipeline tracking
- *
- * This module provides a purely functional approach to tracking context:
- * - TrackingContext interface defines the immutable state shape
- * - Pure functions transform state and derive values
- * - No classes, no mutation, no hidden state
- *
- * Benefits:
- * - Easy testing: just create plain objects
- * - Transparent: can log/inspect full state anytime
- * - Predictable: same input → same output
- * - Composable: mix and match functions freely
- * - Debuggable: save/restore state snapshots
- */
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.getFirstExecutableBlock = exports.getProposalState = exports.getIsElection = exports.getQueueBlockNumber = exports.getFirstCallScheduledData = exports.getProposalId = exports.getGovernorAddress = void 0;
-exports.createTrackingContext = createTrackingContext;
-exports.addStage = addStage;
-exports.isStageCompleted = isStageCompleted;
-exports.getCompletedStage = getCompletedStage;
-exports.getCachedStage = getCachedStage;
-exports.isComplete = isComplete;
-exports.getTimelockAddress = getTimelockAddress;
-exports.getOperationId = getOperationId;
-exports.getCallScheduledData = getCallScheduledData;
-exports.getProposalData = getProposalData;
-exports.getProposalType = getProposalType;
-exports.getVotingEndBlock = getVotingEndBlock;
-exports.getL2ExecutionTxHash = getL2ExecutionTxHash;
-exports.getOutboxExecutionTx = getOutboxExecutionTx;
-exports.getL1ExecutionTxHash = getL1ExecutionTxHash;
-exports.createCheckpoint = createCheckpoint;
-exports.toResult = toResult;
-const ethers_1 = require("ethers");
-const logger_1 = require("../utils/logger");
-const base_1 = require("../stages/base");
-const governor_discovery_1 = require("../discovery/governor-discovery");
-const constants_1 = require("../constants");
-const { tracker: logTracker } = logger_1.loggers;
-// State Creation
-/**
- * Create a new TrackingContext.
- */
-function createTrackingContext(options) {
-    // Initialize stages based on tracking path
-    const includeProposal = options.input.type === "governor";
-    const addressForPath = options.input.type === "governor"
-        ? options.input.governorAddress
-        : options.input.type === "timelock"
-            ? options.input.timelockAddress
-            : "";
-    const initialStages = (0, base_1.initializeStagesForPath)(addressForPath, includeProposal);
-    let ctx = {
-        providers: options.providers,
-        chunkingConfig: options.chunkingConfig ?? constants_1.DEFAULT_CHUNKING_CONFIG,
-        onProgress: options.onProgress,
-        cacheKey: options.cacheKey,
-        input: options.input,
-        callScheduledData: options.callScheduledData,
-        stages: initialStages,
-        stageIndex: 0,
-    };
-    // Load from checkpoint if provided
-    if (options.checkpoint?.cachedData.completedStages?.length) {
-        ctx = loadFromCheckpoint(ctx, options.checkpoint);
-    }
-    return ctx;
-}
-/**
- * Load stages from a checkpoint.
- */
-function loadFromCheckpoint(ctx, checkpoint) {
-    const completedStages = checkpoint.cachedData.completedStages;
-    if (!completedStages?.length)
-        return ctx;
-    logTracker("RESUME: loading %d completed stages from checkpoint", completedStages.length);
-    let stages = ctx.stages;
-    for (const stage of completedStages) {
-        stages = (0, base_1.updateStageInList)(stages, stage);
-    }
-    return { ...ctx, stages, stageIndex: completedStages.length };
-}
-// Stage Management
-/**
- * Add or update a stage. Returns new context.
- */
-async function addStage(ctx, stage) {
-    const newStages = (0, base_1.updateStageInList)(ctx.stages, stage);
-    const newCtx = {
-        ...ctx,
-        stages: newStages,
-        stageIndex: ctx.stageIndex + 1,
-    };
-    await emitProgress(newCtx, stage);
-    return newCtx;
-}
-// Stage lookup helper (defined early for use in stage management functions)
-const findStage = (ctx, type) => ctx.stages.find((s) => s.type === type);
-/** Check if a stage is completed (COMPLETED or SKIPPED). */
-function isStageCompleted(ctx, type) {
-    const s = findStage(ctx, type);
-    return s?.status === "COMPLETED" || s?.status === "SKIPPED";
-}
-/** Get a completed stage for zero-RPC resume. */
-function getCompletedStage(ctx, type) {
-    const s = findStage(ctx, type);
-    return s?.status === "COMPLETED" || s?.status === "SKIPPED" ? s : undefined;
-}
-/** Get a cached stage (any status). */
-function getCachedStage(ctx, type) {
-    return findStage(ctx, type);
-}
-/**
- * Check if all stages are complete.
- */
-function isComplete(ctx) {
-    return (0, base_1.areAllStagesComplete)(ctx.stages);
-}
-// Stage data helpers
-const stageData = (ctx, type) => findStage(ctx, type)?.data;
-const execTx = (s) => s?.transactions?.find((tx) => tx.description === "executed");
-const chainTx = (s, chain) => s?.transactions?.find((tx) => tx.chain === chain);
-// Derived Getters - Input-based
-const getGovernorAddress = (ctx) => ctx.input.type === "governor" ? ctx.input.governorAddress : undefined;
-exports.getGovernorAddress = getGovernorAddress;
-const getProposalId = (ctx) => ctx.input.type === "governor" ? ctx.input.proposalId : undefined;
-exports.getProposalId = getProposalId;
-// Derived Getters - Multi-source lookups
-function getTimelockAddress(ctx) {
-    if (ctx.input.type === "timelock")
-        return ctx.input.timelockAddress;
-    return (stageData(ctx, "PROPOSAL_QUEUED")?.timelockAddress ??
-        stageData(ctx, "L2_TIMELOCK")?.timelockAddress);
-}
-function getOperationId(ctx) {
-    if (ctx.input.type === "timelock")
-        return ctx.input.operationId;
-    return (stageData(ctx, "PROPOSAL_QUEUED")?.operationId ??
-        stageData(ctx, "L2_TIMELOCK")?.operationId);
-}
-function getCallScheduledData(ctx) {
-    if (ctx.callScheduledData)
-        return ctx.callScheduledData;
-    const qData = stageData(ctx, "PROPOSAL_QUEUED")?.callScheduledData;
-    if (qData?.length)
-        return (0, base_1.deserializeCallScheduledDataArray)(qData);
-    const l2Data = stageData(ctx, "L2_TIMELOCK")?.callScheduledData;
-    return l2Data?.length ? (0, base_1.deserializeCallScheduledDataArray)(l2Data) : undefined;
-}
-const getFirstCallScheduledData = (ctx) => getCallScheduledData(ctx)?.[0];
-exports.getFirstCallScheduledData = getFirstCallScheduledData;
-const getQueueBlockNumber = (ctx) => (0, exports.getFirstCallScheduledData)(ctx)?.blockNumber;
-exports.getQueueBlockNumber = getQueueBlockNumber;
-/** Proposal data from PROPOSAL_CREATED stage */
-function getProposalData(ctx) {
-    const s = findStage(ctx, "PROPOSAL_CREATED");
-    if (!s || s.status === "NOT_STARTED")
-        return undefined;
-    const data = s.data;
-    const tx = s.transactions?.[0];
-    if (!data.proposalId ||
-        !data.startBlock ||
-        !data.endBlock ||
-        !data.proposer ||
-        !data.targets ||
-        !data.values ||
-        !data.signatures ||
-        !data.calldatas ||
-        !tx)
-        return undefined;
-    return {
-        proposalId: data.proposalId,
-        proposer: data.proposer,
-        description: data.description,
-        targets: data.targets,
-        values: data.values.map((v) => ethers_1.BigNumber.from(v)),
-        signatures: data.signatures,
-        calldatas: data.calldatas,
-        startBlock: ethers_1.BigNumber.from(data.startBlock),
-        endBlock: ethers_1.BigNumber.from(data.endBlock),
-        creationBlock: tx.blockNumber,
-        creationTxHash: tx.hash,
-    };
-}
-function getProposalType(ctx) {
-    const data = stageData(ctx, "PROPOSAL_CREATED");
-    if (data?.proposalType)
-        return data.proposalType;
-    const addr = (0, exports.getGovernorAddress)(ctx);
-    return addr ? (0, governor_discovery_1.detectProposalType)(addr) : undefined;
-}
-const getIsElection = (ctx) => {
-    const type = getProposalType(ctx);
-    return type ? (0, governor_discovery_1.isElectionProposal)(type) : false;
-};
-exports.getIsElection = getIsElection;
-const getProposalState = (ctx) => stageData(ctx, "VOTING_ACTIVE")?.proposalState;
-exports.getProposalState = getProposalState;
-function getVotingEndBlock(ctx) {
-    const data = stageData(ctx, "VOTING_ACTIVE");
-    if (!data?.deadline)
-        return undefined;
-    const deadline = parseInt(data.deadline, 10);
-    const extended = data.extendedDeadline ? parseInt(data.extendedDeadline, 10) : 0;
-    return extended > deadline ? extended : deadline;
-}
-function getL2ExecutionTxHash(ctx) {
-    const s = findStage(ctx, "L2_TIMELOCK");
-    return s?.status === "COMPLETED" ? execTx(s)?.hash : undefined;
-}
-const getFirstExecutableBlock = (ctx) => stageData(ctx, "L2_TO_L1_MESSAGE")?.firstExecutableBlock;
-exports.getFirstExecutableBlock = getFirstExecutableBlock;
-function getOutboxExecutionTx(ctx) {
-    const s = findStage(ctx, "L2_TO_L1_MESSAGE");
-    if (s?.status !== "COMPLETED")
-        return undefined;
-    const tx = chainTx(s, "ethereum");
-    return tx ? { hash: tx.hash, blockNumber: tx.blockNumber } : undefined;
-}
-function getL1ExecutionTxHash(ctx) {
-    const s = findStage(ctx, "L1_TIMELOCK");
-    return s?.status === "COMPLETED" ? execTx(s)?.hash : undefined;
-}
-// Checkpoint & Result
-function createCheckpoint(ctx) {
-    const completedStages = ctx.stages.filter((s) => s.status !== "NOT_STARTED");
-    const lastProcessedStage = [...ctx.stages].reverse().find((s) => s.status !== "NOT_STARTED")?.type ?? null;
-    return {
-        version: 1,
-        createdAt: Date.now(),
-        input: ctx.input,
-        lastProcessedStage,
-        lastProcessedBlock: { l1: 0, l2: 0, nova: 0 },
-        cachedData: { completedStages },
-        metadata: { errorCount: 0, lastTrackedAt: Date.now() },
-    };
-}
-async function emitProgress(ctx, s) {
-    if (!ctx.onProgress)
-        return;
-    const idx = ctx.stages.findIndex((x) => x.type === s.type);
-    await ctx.onProgress({
-        stage: s,
-        stages: ctx.stages,
-        currentIndex: idx >= 0 ? idx : ctx.stageIndex,
-        totalStages: ctx.stages.length,
-        isComplete: isComplete(ctx),
-    });
-}
-function toResult(ctx) {
-    return {
-        input: ctx.input,
-        stages: ctx.stages,
-        checkpoint: createCheckpoint(ctx),
-        isComplete: isComplete(ctx),
-        proposalType: getProposalType(ctx),
-        proposalData: getProposalData(ctx),
-        currentState: (0, exports.getProposalState)(ctx),
-        isElection: (0, exports.getIsElection)(ctx),
-    };
-}
-//# sourceMappingURL=context.js.map

package/dist/tracker/context.js.map

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

package/dist/utils/stage-helpers.d.ts

@@ -1,50 +0,0 @@
-/**
- * Stage Helpers
- *
- * Utility functions for timelock stage operations and validation.
- */
-import { ethers } from "ethers";
-import { TrackedStage, PrepareResult, StageType, Chain, CallScheduledData, TimelockState, OperationState } from "../types";
-/** Execution payload data for timelock operations. */
-export interface TimelockExecutionPayload {
-    timelockAddress: string;
-    operationId: string;
-    callScheduledData: CallScheduledData[];
-    isSecurityCouncilOperation?: boolean;
-    securityCouncilMembers?: string[];
-    securityCouncilNonce?: string;
-}
-/** Extract timelock execution payload from a stage. */
-export declare function createTimelockStageData(stage: TrackedStage): TimelockExecutionPayload | null;
-/** Collect all CallScheduledData from a timelock state. */
-export declare function collectAllScheduledData(timelockState: TimelockState): CallScheduledData[];
-/** Calculate ETA for a timelock operation. */
-export declare function calculateTimelockEta(timelockState: TimelockState, operationState: OperationState, provider: ethers.providers.Provider): Promise<number | undefined>;
-/** Build serialized execution payload data for stage storage. */
-export declare function buildExecutionPayloadData(timelockAddress: string, operationId: string, allScheduledData: CallScheduledData[]): Record<string, unknown>;
-export interface PrepareValidationOptions {
-    prepareCompleted?: boolean;
-    expectedTypes?: StageType[];
-}
-/** Validate stage for preparation. Returns error or null if valid. */
-export declare function validateStageForPrepare(stage: TrackedStage, options?: PrepareValidationOptions): PrepareResult | null;
-export interface BulkPrepareResult<T extends Chain = Chain> {
-    total: number;
-    results: PrepareResult[];
-    targetChain: T;
-}
-export interface SimpleBulkResult {
-    total: number;
-    results: PrepareResult[];
-}
-export declare function bulkPrepareError<T extends Chain>(error: string, targetChain: T): BulkPrepareResult<T>;
-export declare function simpleBulkError(error: string): SimpleBulkResult;
-export declare function validateStageForBulkPrepare<T extends Chain>(stage: TrackedStage, targetChain: T, options?: PrepareValidationOptions): BulkPrepareResult<T> | null;
-export declare function validateStageForSimpleBulk(stage: TrackedStage, options?: PrepareValidationOptions): SimpleBulkResult | null;
-/** Search for timelock execution event and complete stage. */
-export declare function searchAndCompleteTimelockExecution(stage: TrackedStage, timelockAddress: string, operationId: string, provider: ethers.providers.Provider, chain: Chain, fromBlock: number, toBlock?: number, queueTimestamp?: number): Promise<{
-    stage: TrackedStage;
-    executionTxHash: string | null;
-    executionBlock: number | null;
-}>;
-//# sourceMappingURL=stage-helpers.d.ts.map

package/dist/utils/stage-helpers.d.ts.map

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

package/dist/utils/stage-helpers.js

@@ -1,135 +0,0 @@
-"use strict";
-/**
- * Stage Helpers
- *
- * Utility functions for timelock stage operations and validation.
- */
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.createTimelockStageData = createTimelockStageData;
-exports.collectAllScheduledData = collectAllScheduledData;
-exports.calculateTimelockEta = calculateTimelockEta;
-exports.buildExecutionPayloadData = buildExecutionPayloadData;
-exports.validateStageForPrepare = validateStageForPrepare;
-exports.bulkPrepareError = bulkPrepareError;
-exports.simpleBulkError = simpleBulkError;
-exports.validateStageForBulkPrepare = validateStageForBulkPrepare;
-exports.validateStageForSimpleBulk = validateStageForSimpleBulk;
-exports.searchAndCompleteTimelockExecution = searchAndCompleteTimelockExecution;
-const types_1 = require("../types");
-const base_1 = require("../stages/base");
-const stage_builder_1 = require("../stages/stage-builder");
-const timelock_discovery_1 = require("../discovery/timelock-discovery");
-/** Extract timelock execution payload from a stage. */
-function createTimelockStageData(stage) {
-    let stageData = null;
-    for (const stageType of base_1.TIMELOCK_STAGE_TYPES) {
-        stageData = (0, types_1.getStageData)(stage, stageType);
-        if (stageData)
-            break;
-    }
-    if (!stageData?.timelockAddress ||
-        !stageData?.operationId ||
-        !stageData?.callScheduledData?.length) {
-        return null;
-    }
-    const payload = {
-        timelockAddress: stageData.timelockAddress,
-        operationId: stageData.operationId,
-        callScheduledData: (0, base_1.deserializeCallScheduledDataArray)(stageData.callScheduledData),
-    };
-    if (stageData.isSecurityCouncilOperation) {
-        payload.isSecurityCouncilOperation = true;
-        payload.securityCouncilMembers = stageData.securityCouncilMembers;
-        payload.securityCouncilNonce = stageData.securityCouncilNonce;
-    }
-    return payload;
-}
-// ============================================================================
-// Timelock State Helpers
-// ============================================================================
-/** Collect all CallScheduledData from a timelock state. */
-function collectAllScheduledData(timelockState) {
-    return (timelockState.allScheduledData ??
-        (timelockState.scheduledData ? [timelockState.scheduledData] : []));
-}
-/** Calculate ETA for a timelock operation. */
-async function calculateTimelockEta(timelockState, operationState, provider) {
-    if (timelockState.scheduledData) {
-        return (0, base_1.calculateEtaFromScheduledData)(timelockState.scheduledData.blockNumber, timelockState.scheduledData.delay.toNumber(), provider);
-    }
-    const contractTimestamp = operationState.timestamp.toNumber();
-    return !operationState.isDone && contractTimestamp > 1 ? contractTimestamp : undefined;
-}
-/** Build serialized execution payload data for stage storage. */
-function buildExecutionPayloadData(timelockAddress, operationId, allScheduledData) {
-    const payload = { timelockAddress, operationId };
-    if (allScheduledData.length > 0) {
-        payload.callScheduledData = (0, base_1.serializeCallScheduledDataArray)(allScheduledData);
-    }
-    return payload;
-}
-/** Validate stage for preparation. Returns error or null if valid. */
-function validateStageForPrepare(stage, options = {}) {
-    if (!options.prepareCompleted && stage.status !== "READY") {
-        return (0, base_1.failPrepare)(`Stage is not ready. Current status: ${stage.status}`);
-    }
-    if (options.expectedTypes?.length && !options.expectedTypes.includes(stage.type)) {
-        return (0, base_1.failPrepare)(`Unexpected stage type: ${stage.type}. Expected: ${options.expectedTypes.join(", ")}`);
-    }
-    return null;
-}
-function bulkPrepareError(error, targetChain) {
-    return { total: 0, results: [{ success: false, error }], targetChain };
-}
-function simpleBulkError(error) {
-    return { total: 0, results: [{ success: false, error }] };
-}
-function validateStageForBulkPrepare(stage, targetChain, options = {}) {
-    const error = validateStageForPrepare(stage, options);
-    return error ? { total: 0, results: [error], targetChain } : null;
-}
-function validateStageForSimpleBulk(stage, options = {}) {
-    const error = validateStageForPrepare(stage, options);
-    return error ? { total: 0, results: [error] } : null;
-}
-// ============================================================================
-// Execution Search Helper
-// ============================================================================
-/** Search for timelock execution event and complete stage. */
-async function searchAndCompleteTimelockExecution(stage, timelockAddress, operationId, provider, chain, fromBlock, toBlock, queueTimestamp) {
-    const event = await (0, timelock_discovery_1.findCallExecutedEvent)(timelockAddress, operationId, provider, {
-        startBlock: fromBlock,
-        endBlock: toBlock,
-    });
-    const builder = new stage_builder_1.StageBuilder(stage.type, stage.chain)
-        .data(stage.data)
-        .transactions(stage.transactions);
-    if (stage.timing)
-        builder.timing(stage.timing);
-    if (event) {
-        const execTimestamp = await (0, base_1.getBlockTimestamp)(event.blockNumber, provider);
-        const chainId = (0, types_1.chainToChainId)(chain) ?? 0;
-        builder
-            .status("COMPLETED")
-            .tx(event.txHash, event.blockNumber, chain, chainId, {
-            timestamp: execTimestamp,
-            description: "executed",
-        })
-            .timing({ startedAt: queueTimestamp ?? execTimestamp })
-            .data({ operationId });
-        return {
-            stage: builder.build(),
-            executionTxHash: event.txHash,
-            executionBlock: event.blockNumber,
-        };
-    }
-    return {
-        stage: builder
-            .status("COMPLETED")
-            .data({ operationId, note: "Execution confirmed by state, event not found" })
-            .build(),
-        executionTxHash: null,
-        executionBlock: null,
-    };
-}
-//# sourceMappingURL=stage-helpers.js.map

package/dist/utils/stage-helpers.js.map

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