@gzeoneth/gov-tracker 0.1.0 → 0.1.1-0

package/dist/cli/lib/cli.d.ts

@@ -17,8 +17,68 @@ export declare const DEFAULT_BLOCK_LAG = 12;
 export declare const DEFAULT_MAX_AGE_DAYS = 60;
 /** Maximum consecutive errors before skipping an item */
 export declare const MAX_CONSECUTIVE_ERRORS = 5;
+/** Default gas settings for L2 chains (Arb1 and Nova) */
+export declare const DEFAULT_L2_GAS_SETTINGS: {
+    /** Max fee per gas in gwei (0.10 gwei = 100000000 wei) */
+    maxFeePerGas: number;
+    /** Max priority fee per gas in gwei */
+    maxPriorityFeePerGas: number;
+};
+/** Gas settings interface */
+export interface GasSettings {
+    maxFeePerGas: number;
+    maxPriorityFeePerGas: number;
+}
 export declare const rpcOptions: Option[];
+/**
+ * Verbose logging option - enables debug output
+ */
+export declare const verboseOption: Option;
+/**
+ * Cache-related options for commands that use the tracker cache
+ */
+export declare const cacheOptions: {
+    /** Cache file path option (default is set in monitor.ts) */
+    cache: (defaultPath: string) => Option;
+    /** Force flag to bypass cache and re-track from scratch */
+    force: Option;
+};
+/**
+ * Execution-related options for commands that can prepare/execute transactions
+ */
+export declare const executionOptions: Option[];
+/**
+ * Chunking options for log search performance tuning
+ */
+export declare const chunkingOptions: (l1Default: number, l2Default: number) => Option[];
+/**
+ * Gas options for L2 transaction execution
+ */
+export declare const gasOptions: Option[];
+/**
+ * Loop-related options for commands that can run continuously
+ */
+export declare const loopOptions: Option[];
 export declare function addOptions(cmd: Command, opts: Option[]): void;
+/**
+ * Parse gas settings from CLI options
+ */
+export declare function parseGasSettings(opts: {
+    l2MaxFee?: string;
+    l2PriorityFee?: string;
+}): GasSettings;
+/**
+ * Parse chunking config from CLI options
+ */
+export declare function parseChunkingConfig(opts: {
+    l1ChunkSize?: string;
+    l2ChunkSize?: string;
+}, delayMs: number): {
+    l1ChunkSize: number;
+    l2ChunkSize: number;
+    novaChunkSize: number;
+    delayBetweenChunks: number;
+};
 export interface ProviderBundle {
     l2Provider: ethers.providers.JsonRpcProvider;
     l1Provider: ethers.providers.JsonRpcProvider;
@@ -34,15 +94,21 @@ export declare function requirePrivateKeyForWrite(opts: {
     privateKey?: string;
 }): void;
 export declare function createSigner(privateKey: string): ethers.Wallet;
-export declare function executeTransaction(prepared: PreparedTransaction, signer: ethers.Wallet, providers: ProviderBundle): Promise<{
+export declare function executeTransaction(prepared: PreparedTransaction, signer: ethers.Wallet, providers: ProviderBundle, gasSettings?: GasSettings): Promise<{
     success: boolean;
     txHash?: string;
     error?: string;
 }>;
 export declare function formatDryRun(prepared: PreparedTransaction): string;
+/**
+ * Format multiple prepared transactions for display
+ */
+export declare function formatMultiplePreparedTransactions(preparedTransactions: PreparedTransaction[]): string;
 export declare function formatTrackingResult(result: TrackingResult, label?: string): string;
 export declare function formatStagesBrief(stages: TrackedStage[]): string;
 export declare function formatCacheStatus(checkpoints: Map<string, TrackingCheckpoint>): string;
+/** Check if shutdown has been requested */
+export declare function isShuttingDown(): boolean;
 export declare function runWithLoop(cycleFn: () => Promise<void>, options: {
     loop: boolean;
     intervalMs: number;
@@ -52,6 +118,7 @@ export interface TrackCallbackResult {
     key: string;
     result: TrackingResult | null;
     prepared?: PreparedTransaction;
+    preparedTransactions?: PreparedTransaction[];
     error?: string;
 }
 export interface TrackCallbackReturn {
@@ -59,7 +126,7 @@ export interface TrackCallbackReturn {
 }
 export interface MonitorRunOptions {
     prepare?: boolean;
-    force?: boolean;
+    prepareCompleted?: boolean;
     preparePending?: boolean;
     onTrack?: (result: TrackCallbackResult) => Promise<TrackCallbackReturn | void> | void;
     startBlock?: number;
@@ -75,18 +142,19 @@ export interface MonitorRunResult {
     errors: number;
     retracked: number;
 }
-export declare function runMonitorCycle(tracker: ProposalStageTracker, l2Provider: ethers.providers.Provider, options?: MonitorRunOptions): Promise<{
+export declare function runMonitorCycle(tracker: ProposalStageTracker, providers: ProviderBundle, options?: MonitorRunOptions): Promise<{
     result: MonitorRunResult;
     proposals: DiscoveredProposal[];
     timelockOps: DiscoveredTimelockOp[];
     watermarks: DiscoveryWatermarks;
 }>;
-export declare function trackAndPrepare(tracker: ProposalStageTracker, txHash: string, options?: {
+export declare function trackAndPrepare(tracker: ProposalStageTracker, txHash: string, options: {
     prepare?: boolean;
-    force?: boolean;
+    prepareCompleted?: boolean;
     preparePending?: boolean;
-}): Promise<{
+} | undefined, providers: ProviderBundle): Promise<{
     results: TrackingResult[];
     preparations: PrepareResult[];
+    preparedTransactions: PreparedTransaction[];
 }>;
 //# sourceMappingURL=cli.d.ts.map

package/dist/cli/lib/cli.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../../../src/cli/lib/cli.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,WAAW,CAAC;AAC5C,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAEhC,OAAO,EACL,oBAAoB,EACpB,YAAY,EACZ,cAAc,EACd,kBAAkB,EAClB,mBAAmB,EACnB,aAAa,EAQb,kBAAkB,EAIlB,kBAAkB,EAClB,oBAAoB,EACpB,mBAAmB,EAEpB,MAAM,aAAa,CAAC;AAGrB,OAAO,EAAE,kBAAkB,EAAE,CAAC;AAM9B,gDAAgD;AAChD,eAAO,MAAM,iBAAiB,KAAK,CAAC;AAEpC,mEAAmE;AACnE,eAAO,MAAM,oBAAoB,KAAK,CAAC;AAEvC,yDAAyD;AACzD,eAAO,MAAM,sBAAsB,IAAI,CAAC;AAMxC,eAAO,MAAM,UAAU,UAItB,CAAC;AAEF,wBAAgB,UAAU,CAAC,GAAG,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,IAAI,CAE7D;AAED,MAAM,WAAW,cAAc;IAC7B,UAAU,EAAE,MAAM,CAAC,SAAS,CAAC,eAAe,CAAC;IAC7C,UAAU,EAAE,MAAM,CAAC,SAAS,CAAC,eAAe,CAAC;IAC7C,YAAY,EAAE,MAAM,CAAC,SAAS,CAAC,eAAe,CAAC;CAChD;AAED,wBAAgB,0BAA0B,CAAC,IAAI,EAAE;IAC/C,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB,GAAG,cAAc,CAcjB;AAMD,wBAAgB,yBAAyB,CAAC,IAAI,EAAE;IAAE,KAAK,CAAC,EAAE,OAAO,CAAC;IAAC,UAAU,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAK9F;AAED,wBAAgB,YAAY,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,CAE9D;AASD,wBAAsB,kBAAkB,CACtC,QAAQ,EAAE,mBAAmB,EAC7B,MAAM,EAAE,MAAM,CAAC,MAAM,EACrB,SAAS,EAAE,cAAc,GACxB,OAAO,CAAC;IAAE,OAAO,EAAE,OAAO,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,CAsDhE;AAMD,wBAAgB,YAAY,CAAC,QAAQ,EAAE,mBAAmB,GAAG,MAAM,CAoBlE;AAED,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,cAAc,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,CAwEnF;AAED,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,YAAY,EAAE,GAAG,MAAM,CAKhE;AAED,wBAAgB,iBAAiB,CAAC,WAAW,EAAE,GAAG,CAAC,MAAM,EAAE,kBAAkB,CAAC,GAAG,MAAM,CAyDtF;AAeD,wBAAsB,WAAW,CAC/B,OAAO,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,EAC5B,OAAO,EAAE;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,UAAU,EAAE,MAAM,CAAC;IAAC,cAAc,CAAC,EAAE,MAAM,CAAA;CAAE,GACtE,OAAO,CAAC,IAAI,CAAC,CAsCf;AAMD,MAAM,WAAW,mBAAmB;IAClC,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,cAAc,GAAG,IAAI,CAAC;IAC9B,QAAQ,CAAC,EAAE,mBAAmB,CAAC;IAC/B,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,mBAAmB;IAClC,aAAa,CAAC,EAAE,OAAO,CAAC;CACzB;AAED,MAAM,WAAW,iBAAiB;IAChC,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,OAAO,CAAC,EAAE,CAAC,MAAM,EAAE,mBAAmB,KAAK,OAAO,CAAC,mBAAmB,GAAG,IAAI,CAAC,GAAG,IAAI,CAAC;IACtF,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,yEAAyE;IACzE,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;CACnB;AA+ED,wBAAsB,eAAe,CACnC,OAAO,EAAE,oBAAoB,EAC7B,UAAU,EAAE,MAAM,CAAC,SAAS,CAAC,QAAQ,EACrC,OAAO,GAAE,iBAAsB,GAC9B,OAAO,CAAC;IACT,MAAM,EAAE,gBAAgB,CAAC;IACzB,SAAS,EAAE,kBAAkB,EAAE,CAAC;IAChC,WAAW,EAAE,oBAAoB,EAAE,CAAC;IACpC,UAAU,EAAE,mBAAmB,CAAC;CACjC,CAAC,CAoLD;AAMD,wBAAsB,eAAe,CACnC,OAAO,EAAE,oBAAoB,EAC7B,MAAM,EAAE,MAAM,EACd,OAAO,GAAE;IAAE,OAAO,CAAC,EAAE,OAAO,CAAC;IAAC,KAAK,CAAC,EAAE,OAAO,CAAC;IAAC,cAAc,CAAC,EAAE,OAAO,CAAA;CAAO,GAC7E,OAAO,CAAC;IAAE,OAAO,EAAE,cAAc,EAAE,CAAC;IAAC,YAAY,EAAE,aAAa,EAAE,CAAA;CAAE,CAAC,CAUvE"}
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../../../src/cli/lib/cli.ts"],"names":[],"mappings":"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"}

package/dist/cli/lib/cli.js

@@ -12,16 +12,20 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.rpcOptions = exports.MAX_CONSECUTIVE_ERRORS = exports.DEFAULT_MAX_AGE_DAYS = exports.DEFAULT_BLOCK_LAG = exports.isElectionGovernor = void 0;
+exports.loopOptions = exports.gasOptions = exports.chunkingOptions = exports.executionOptions = exports.cacheOptions = exports.verboseOption = exports.rpcOptions = exports.DEFAULT_L2_GAS_SETTINGS = exports.MAX_CONSECUTIVE_ERRORS = exports.DEFAULT_MAX_AGE_DAYS = exports.DEFAULT_BLOCK_LAG = exports.isElectionGovernor = void 0;
 exports.addOptions = addOptions;
+exports.parseGasSettings = parseGasSettings;
+exports.parseChunkingConfig = parseChunkingConfig;
 exports.createProvidersFromOptions = createProvidersFromOptions;
 exports.requirePrivateKeyForWrite = requirePrivateKeyForWrite;
 exports.createSigner = createSigner;
 exports.executeTransaction = executeTransaction;
 exports.formatDryRun = formatDryRun;
+exports.formatMultiplePreparedTransactions = formatMultiplePreparedTransactions;
 exports.formatTrackingResult = formatTrackingResult;
 exports.formatStagesBrief = formatStagesBrief;
 exports.formatCacheStatus = formatCacheStatus;
+exports.isShuttingDown = isShuttingDown;
 exports.runWithLoop = runWithLoop;
 exports.runMonitorCycle = runMonitorCycle;
 exports.trackAndPrepare = trackAndPrepare;
@@ -40,6 +44,13 @@ exports.DEFAULT_BLOCK_LAG = 12;
 exports.DEFAULT_MAX_AGE_DAYS = 60;
 /** Maximum consecutive errors before skipping an item */
 exports.MAX_CONSECUTIVE_ERRORS = 5;
+/** Default gas settings for L2 chains (Arb1 and Nova) */
+exports.DEFAULT_L2_GAS_SETTINGS = {
+    /** Max fee per gas in gwei (0.10 gwei = 100000000 wei) */
+    maxFeePerGas: 0.1,
+    /** Max priority fee per gas in gwei */
+    maxPriorityFeePerGas: 0,
+};
 // ============================================================================
 // RPC Configuration
 // ============================================================================
@@ -48,9 +59,82 @@ exports.rpcOptions = [
     new commander_1.Option("--l1-rpc <url>", "L1 RPC URL").env("ETH_RPC"),
     new commander_1.Option("--nova-rpc <url>", "Nova RPC URL").env("NOVA_RPC"),
 ];
+// ============================================================================
+// Common Options (shared across multiple commands)
+// ============================================================================
+/**
+ * Verbose logging option - enables debug output
+ */
+exports.verboseOption = new commander_1.Option("--verbose", "Enable verbose logging");
+/**
+ * Cache-related options for commands that use the tracker cache
+ */
+exports.cacheOptions = {
+    /** Cache file path option (default is set in monitor.ts) */
+    cache: (defaultPath) => new commander_1.Option("--cache <path>", "Cache file").default(defaultPath),
+    /** Force flag to bypass cache and re-track from scratch */
+    force: new commander_1.Option("--force", "Force refresh, ignoring cached data"),
+};
+/**
+ * Execution-related options for commands that can prepare/execute transactions
+ */
+exports.executionOptions = [
+    new commander_1.Option("--prepare", "Prepare transactions for ready stages (dry-run)"),
+    new commander_1.Option("--write", "Execute prepared transactions (requires --private-key)"),
+    new commander_1.Option("--private-key <key>", "Private key for execution").env("PRIVATE_KEY"),
+    new commander_1.Option("--prepare-completed", "Prepare completed stages (for historical validation)"),
+    new commander_1.Option("--prepare-pending", "Prepare pending stages (waiting for delays)"),
+];
+/**
+ * Chunking options for log search performance tuning
+ */
+const chunkingOptions = (l1Default, l2Default) => [
+    new commander_1.Option("--l1-chunk-size <size>", `L1 chunk size for log searches (default: ${l1Default})`).default(String(l1Default)),
+    new commander_1.Option("--l2-chunk-size <size>", `L2 chunk size for log searches (default: ${l2Default})`).default(String(l2Default)),
+];
+exports.chunkingOptions = chunkingOptions;
+/**
+ * Gas options for L2 transaction execution
+ */
+exports.gasOptions = [
+    new commander_1.Option("--l2-max-fee <gwei>", `Max fee per gas for L2 chains in gwei (default: ${exports.DEFAULT_L2_GAS_SETTINGS.maxFeePerGas})`),
+    new commander_1.Option("--l2-priority-fee <gwei>", `Max priority fee for L2 chains in gwei (default: ${exports.DEFAULT_L2_GAS_SETTINGS.maxPriorityFeePerGas})`),
+];
+/**
+ * Loop-related options for commands that can run continuously
+ */
+exports.loopOptions = [
+    new commander_1.Option("--loop", "Run in continuous loop"),
+    new commander_1.Option("--interval <seconds>", "Loop interval in seconds").default("60"),
+    new commander_1.Option("--health-check-url <url>", "Health check URL to ping").env("HEALTH_CHECK_URL"),
+];
 function addOptions(cmd, opts) {
     opts.forEach((o) => cmd.addOption(o));
 }
+/**
+ * Parse gas settings from CLI options
+ */
+function parseGasSettings(opts) {
+    return {
+        maxFeePerGas: opts.l2MaxFee ? parseFloat(opts.l2MaxFee) : exports.DEFAULT_L2_GAS_SETTINGS.maxFeePerGas,
+        maxPriorityFeePerGas: opts.l2PriorityFee
+            ? parseFloat(opts.l2PriorityFee)
+            : exports.DEFAULT_L2_GAS_SETTINGS.maxPriorityFeePerGas,
+    };
+}
+/**
+ * Parse chunking config from CLI options
+ */
+function parseChunkingConfig(opts, delayMs) {
+    const l1ChunkSize = parseInt(opts.l1ChunkSize || "0", 10);
+    const l2ChunkSize = parseInt(opts.l2ChunkSize || "0", 10);
+    return {
+        l1ChunkSize,
+        l2ChunkSize,
+        novaChunkSize: l2ChunkSize,
+        delayBetweenChunks: delayMs,
+    };
+}
 function createProvidersFromOptions(opts) {
     const l2Rpc = opts.l2Rpc || process.env.ARB1_RPC || index_1.DEFAULT_RPC_URLS.ARB_ONE;
     const l1Rpc = opts.l1Rpc || process.env.ETH_RPC;
@@ -79,51 +163,51 @@ function createSigner(privateKey) {
 // ============================================================================
 // Transaction Execution
 // ============================================================================
-const RETRYABLE_MAX_RETRIES = 10;
-const RETRYABLE_RETRY_DELAY_MS = 5000;
-async function executeTransaction(prepared, signer, providers) {
+async function executeTransaction(prepared, signer, providers, gasSettings) {
     const isRetryable = prepared.description?.toLowerCase().includes("retryable") ?? false;
-    for (let attempt = 1; attempt <= (isRetryable ? RETRYABLE_MAX_RETRIES : 1); attempt++) {
-        try {
-            const provider = prepared.chain === "L1"
-                ? providers.l1Provider
-                : prepared.chain === "NOVA"
-                    ? providers.novaProvider
-                    : providers.l2Provider;
-            const connectedSigner = signer.connect(provider);
-            console.log(`\nExecuting on ${prepared.chain}: ${prepared.description}`);
-            console.log(`  To: ${prepared.to}`);
-            if (prepared.value !== "0")
-                console.log(`  Value: ${prepared.value}`);
-            const tx = await connectedSigner.sendTransaction({
-                to: prepared.to,
-                data: prepared.data,
-                value: prepared.value,
-            });
-            console.log(`  Tx sent: ${tx.hash}`);
-            const receipt = await tx.wait();
-            console.log(`  Confirmed in block ${receipt.blockNumber}`);
-            return { success: true, txHash: tx.hash };
+    try {
+        const provider = prepared.chain === "L1"
+            ? providers.l1Provider
+            : prepared.chain === "NOVA"
+                ? providers.novaProvider
+                : providers.l2Provider;
+        const connectedSigner = signer.connect(provider);
+        console.log(`\nExecuting on ${prepared.chain}: ${prepared.description}`);
+        console.log(`  To: ${prepared.to}`);
+        if (prepared.value !== "0")
+            console.log(`  Value: ${prepared.value}`);
+        // Use custom gas settings for L2 chains (Arb1 and Nova)
+        const isL2Chain = prepared.chain === "L2" || prepared.chain === "NOVA";
+        const effectiveGasSettings = isL2Chain ? (gasSettings ?? exports.DEFAULT_L2_GAS_SETTINGS) : undefined;
+        const txRequest = {
+            to: prepared.to,
+            data: prepared.data,
+            value: prepared.value,
+        };
+        if (effectiveGasSettings) {
+            // Convert gwei to wei
+            txRequest.maxFeePerGas = ethers_1.ethers.utils.parseUnits(effectiveGasSettings.maxFeePerGas.toString(), "gwei");
+            txRequest.maxPriorityFeePerGas = ethers_1.ethers.utils.parseUnits(effectiveGasSettings.maxPriorityFeePerGas.toString(), "gwei");
+            console.log(`  Gas: ${effectiveGasSettings.maxFeePerGas} gwei maxFee, ${effectiveGasSettings.maxPriorityFeePerGas} gwei priority`);
         }
-        catch (error) {
-            const message = error instanceof Error ? error.message : String(error);
-            // For retryables, check if already redeemed
-            if (isRetryable &&
-                (message.includes("REDEEMED") ||
-                    message.includes("already redeemed") ||
-                    message.includes("NoTicketWithID"))) {
-                console.log(`  Retryable already redeemed, treating as success`);
-                return { success: true };
-            }
-            if (!isRetryable || attempt >= RETRYABLE_MAX_RETRIES) {
-                return { success: false, error: message };
-            }
-            console.log(`  Retry ${attempt}/${RETRYABLE_MAX_RETRIES} failed: ${message}`);
-            console.log(`  Retrying in ${RETRYABLE_RETRY_DELAY_MS / 1000}s...`);
-            await new Promise((resolve) => setTimeout(resolve, RETRYABLE_RETRY_DELAY_MS));
+        const tx = await connectedSigner.sendTransaction(txRequest);
+        console.log(`  Tx sent: ${tx.hash}`);
+        const receipt = await tx.wait();
+        console.log(`  Confirmed in block ${receipt.blockNumber}`);
+        return { success: true, txHash: tx.hash };
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        // For retryables, check if already redeemed
+        if (isRetryable &&
+            (message.includes("REDEEMED") ||
+                message.includes("already redeemed") ||
+                message.includes("NoTicketWithID"))) {
+            console.log(`  Retryable already redeemed, treating as success`);
+            return { success: true };
         }
+        return { success: false, error: message };
     }
-    return { success: false, error: "Unexpected retry loop exit" };
 }
 // ============================================================================
 // Output Formatting
@@ -146,6 +230,35 @@ function formatDryRun(prepared) {
     }
     return lines.join("\n");
 }
+/**
+ * Format multiple prepared transactions for display
+ */
+function formatMultiplePreparedTransactions(preparedTransactions) {
+    if (preparedTransactions.length === 0)
+        return "";
+    if (preparedTransactions.length === 1)
+        return formatDryRun(preparedTransactions[0]);
+    const lines = [];
+    for (let i = 0; i < preparedTransactions.length; i++) {
+        const prepared = preparedTransactions[i];
+        lines.push(`[DRY RUN ${i + 1}/${preparedTransactions.length}] ${prepared.description}`);
+        lines.push(`  Chain: ${prepared.chain}`);
+        lines.push(`  To: ${prepared.to}`);
+        if (prepared.operationId)
+            lines.push(`  OperationId: ${prepared.operationId}`);
+        if (prepared.value !== "0")
+            lines.push(`  Value: ${prepared.value}`);
+        lines.push(`  Data: ${prepared.data}`);
+        if (prepared.hashValidation) {
+            lines.push(prepared.hashValidation.isValid
+                ? `  Hash Valid: YES`
+                : `  WARNING: Hash validation failed - ${prepared.hashValidation.error}`);
+        }
+        if (i < preparedTransactions.length - 1)
+            lines.push(""); // Blank line between transactions
+    }
+    return lines.join("\n");
+}
 function formatTrackingResult(result, label) {
     const lines = [];
     if (label)
@@ -281,6 +394,12 @@ async function waitWithChunks(ms) {
         remaining -= MAX_CHUNK;
     }
 }
+/** Shared abort controller for graceful shutdown */
+let globalAbortController = null;
+/** Check if shutdown has been requested */
+function isShuttingDown() {
+    return globalAbortController?.signal.aborted ?? false;
+}
 async function runWithLoop(cycleFn, options) {
     if (!options.loop) {
         await cycleFn();
@@ -288,8 +407,11 @@ async function runWithLoop(cycleFn, options) {
     }
     let consecutiveErrors = 0;
     let running = true;
+    // Create abort controller for graceful shutdown
+    globalAbortController = new AbortController();
     process.on("SIGINT", () => {
         running = false;
+        globalAbortController?.abort();
         console.log("\nGracefully shutting down...");
     });
     while (running) {
@@ -325,22 +447,68 @@ const PREPARABLE_STAGE_TYPES = [
     "L2_TO_L1_MESSAGE",
     "RETRYABLE_EXECUTED",
 ];
-async function prepareStagesForResult(tracker, stages, options) {
+async function prepareStagesForResult(tracker, stages, options, providers) {
     const preparations = [];
+    const preparedTransactions = [];
     let prepared;
     let count = 0;
     if (!options.prepare)
-        return { preparations, count };
-    if (options.force) {
+        return { preparations, preparedTransactions, count };
+    /**
+     * Helper to prepare a stage and handle bulk results for RETRYABLE_EXECUTED and L2_TO_L1_MESSAGE
+     */
+    async function prepareSingleStage(stage, prepOpts) {
+        // For retryable and L2→L1 message stages, use bulk prepare to get all transactions
+        if (stage.type === "RETRYABLE_EXECUTED") {
+            const retryableData = (0, index_1.getStageData)(stage, "RETRYABLE_EXECUTED");
+            const targetChains = retryableData?.targetChains;
+            if (!targetChains || targetChains.length === 0) {
+                preparations.push({ success: false, error: "No target chains found" });
+                return;
+            }
+            // Prepare retryables for each target chain (can be both Arb1 and Nova)
+            for (const targetChain of targetChains) {
+                const targetProvider = targetChain === "Nova" ? providers.novaProvider : providers.l2Provider;
+                const { results } = await (0, index_1.prepareRetryableStage)(stage, providers.l1Provider, targetProvider, prepOpts);
+                preparations.push(...results);
+                for (const result of results) {
+                    if (result.success) {
+                        count++;
+                        preparedTransactions.push(result.prepared);
+                        if (!prepared)
+                            prepared = result.prepared;
+                    }
+                }
+            }
+        }
+        else if (stage.type === "L2_TO_L1_MESSAGE") {
+            const { results } = await (0, index_1.prepareL2ToL1MessageStage)(stage, providers.l2Provider, providers.l1Provider, prepOpts);
+            preparations.push(...results);
+            for (const result of results) {
+                if (result.success) {
+                    count++;
+                    preparedTransactions.push(result.prepared);
+                    if (!prepared)
+                        prepared = result.prepared;
+                }
+            }
+        }
+        else {
+            // For other stages, use the tracker's prepareTransaction
+            const prepResult = await tracker.prepareTransaction(stage, prepOpts);
+            preparations.push(prepResult);
+            if (prepResult.success) {
+                count++;
+                preparedTransactions.push(prepResult.prepared);
+                prepared = prepResult.prepared;
+            }
+        }
+    }
+    if (options.prepareCompleted) {
         // Historical validation: prepare COMPLETED timelock stages
         for (const stage of stages) {
             if (stage.status === "COMPLETED" && (0, index_1.isTimelockStage)(stage.type)) {
-                const prepResult = await tracker.prepareTransaction(stage, { force: true });
-                preparations.push(prepResult);
-                if (prepResult.success) {
-                    count++;
-                    prepared = prepResult.prepared;
-                }
+                await prepareSingleStage(stage, { prepareCompleted: true });
             }
         }
     }
@@ -349,12 +517,7 @@ async function prepareStagesForResult(tracker, stages, options) {
         for (const stage of stages) {
             const isPreparable = PREPARABLE_STAGE_TYPES.includes(stage.type);
             if (isPreparable && stage.status === "PENDING") {
-                const prepResult = await tracker.prepareTransaction(stage, { force: true });
-                preparations.push(prepResult);
-                if (prepResult.success) {
-                    count++;
-                    prepared = prepResult.prepared;
-                }
+                await prepareSingleStage(stage, { prepareCompleted: true });
             }
         }
     }
@@ -362,15 +525,10 @@ async function prepareStagesForResult(tracker, stages, options) {
         // Normal: prepare only READY stages
         const ready = (0, index_1.findExecutableStage)(stages);
         if (ready) {
-            const prepResult = await tracker.prepareTransaction(ready, {});
-            preparations.push(prepResult);
-            if (prepResult.success) {
-                count++;
-                prepared = prepResult.prepared;
-            }
+            await prepareSingleStage(ready, {});
         }
     }
-    return { prepared, preparations, count };
+    return { prepared, preparedTransactions, preparations, count };
 }
 // ============================================================================
 // Monitor Cycle
@@ -384,7 +542,8 @@ function shortScope(key) {
     }
     return key.slice(0, 12);
 }
-async function runMonitorCycle(tracker, l2Provider, options = {}) {
+async function runMonitorCycle(tracker, providers, options = {}) {
+    const l2Provider = providers.l2Provider;
     const tipBlock = await l2Provider.getBlockNumber();
     const blockLag = options.blockLag ?? exports.DEFAULT_BLOCK_LAG;
     const currentBlock = Math.max(0, tipBlock - blockLag);
@@ -414,16 +573,23 @@ async function runMonitorCycle(tracker, l2Provider, options = {}) {
         await (0, logger_1.withScope)(shortScope(key), async () => {
             try {
                 const trackResult = await trackFn();
+                // Skip callback if shutting down
+                if (isShuttingDown())
+                    return;
                 result.tracked++;
                 if (trackResult.timelockLink?.operationId) {
                     trackedOperationIds.add(trackResult.timelockLink.operationId.toLowerCase());
                 }
-                const prepResult = await prepareStagesForResult(tracker, trackResult.stages, options);
+                const prepResult = await prepareStagesForResult(tracker, trackResult.stages, options, providers);
                 result.prepared += prepResult.count;
+                // Skip callback if shutting down
+                if (isShuttingDown())
+                    return;
                 const callbackResult = await options.onTrack?.({
                     key,
                     result: trackResult,
                     prepared: prepResult.prepared,
+                    preparedTransactions: prepResult.preparedTransactions,
                 });
                 if (callbackResult?.shouldRetrack) {
                     trackedKeys.delete(key);
@@ -431,6 +597,9 @@ async function runMonitorCycle(tracker, l2Provider, options = {}) {
                 }
             }
             catch (error) {
+                // Skip error callback if shutting down
+                if (isShuttingDown())
+                    return;
                 result.errors++;
                 // Wrap error callback in try-catch to prevent nested errors from propagating
                 try {
@@ -550,13 +719,15 @@ async function runMonitorCycle(tracker, l2Provider, options = {}) {
 // ============================================================================
 // Track and Prepare (for single-item tracking)
 // ============================================================================
-async function trackAndPrepare(tracker, txHash, options = {}) {
+async function trackAndPrepare(tracker, txHash, options = {}, providers) {
     const results = await tracker.trackByTxHash(txHash);
     const preparations = [];
+    const preparedTransactions = [];
     for (const result of results) {
-        const prepResult = await prepareStagesForResult(tracker, result.stages, options);
+        const prepResult = await prepareStagesForResult(tracker, result.stages, options, providers);
         preparations.push(...prepResult.preparations);
+        preparedTransactions.push(...prepResult.preparedTransactions);
     }
-    return { results, preparations };
+    return { results, preparations, preparedTransactions };
 }
 //# sourceMappingURL=cli.js.map