@gzeoneth/gov-tracker 0.1.0

package/dist/stages/proposal-queued.d.ts

@@ -0,0 +1,39 @@
+/**
+ * Proposal Queued Stage Tracking and Preparation
+ *
+ * Stage 3: Track when proposal is queued to timelock.
+ * Includes preparation functions for queueing and executing proposals.
+ */
+import { BigNumber, ethers } from "ethers";
+import { TrackedStage, CallScheduledData, PrepareResult } from "../types";
+/**
+ * Track proposal queued stage
+ *
+ * This stage links the Governor proposal to the Timelock operation
+ */
+export declare function trackProposalQueued(governorAddress: string, proposalId: string, provider: ethers.providers.Provider, 
+/** Block where proposal was created (from Stage 1) */
+fromBlock: number, options?: {
+    toBlock?: number;
+    /** Voting end block - enables forward search optimization (queuing happens right after voting ends) */
+    votingEndBlock?: number;
+}): Promise<{
+    stage: TrackedStage;
+    timelockAddress?: string;
+    operationId?: string;
+    callScheduledData?: CallScheduledData[];
+}>;
+export interface GovernorProposalParams {
+    targets: string[];
+    values: BigNumber[];
+    calldatas: string[];
+    descriptionHash: string;
+}
+/**
+ * Prepare a queue transaction for a governor proposal.
+ *
+ * This is stage 3 preparation - queuing a succeeded proposal to the timelock.
+ * The proposal must be in the "Succeeded" state (voting passed).
+ */
+export declare function prepareGovernorQueue(governorAddress: string, proposalId: string, params: GovernorProposalParams, provider: ethers.providers.Provider): Promise<PrepareResult>;
+//# sourceMappingURL=proposal-queued.d.ts.map

package/dist/stages/proposal-queued.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"proposal-queued.d.ts","sourceRoot":"","sources":["../../src/stages/proposal-queued.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAC3C,OAAO,EAAE,YAAY,EAAE,iBAAiB,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAqB1E;;;;GAIG;AACH,wBAAsB,mBAAmB,CACvC,eAAe,EAAE,MAAM,EACvB,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE,MAAM,CAAC,SAAS,CAAC,QAAQ;AACnC,sDAAsD;AACtD,SAAS,EAAE,MAAM,EACjB,OAAO,GAAE;IACP,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,uGAAuG;IACvG,cAAc,CAAC,EAAE,MAAM,CAAC;CACpB,GACL,OAAO,CAAC;IACT,KAAK,EAAE,YAAY,CAAC;IACpB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,iBAAiB,CAAC,EAAE,iBAAiB,EAAE,CAAC;CACzC,CAAC,CAsED;AAID,MAAM,WAAW,sBAAsB;IACrC,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,MAAM,EAAE,SAAS,EAAE,CAAC;IACpB,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,eAAe,EAAE,MAAM,CAAC;CACzB;AAED;;;;;GAKG;AACH,wBAAsB,oBAAoB,CACxC,eAAe,EAAE,MAAM,EACvB,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,sBAAsB,EAC9B,QAAQ,EAAE,MAAM,CAAC,SAAS,CAAC,QAAQ,GAClC,OAAO,CAAC,aAAa,CAAC,CA6CxB"}

package/dist/stages/proposal-queued.js

@@ -0,0 +1,131 @@
+"use strict";
+/**
+ * Proposal Queued Stage Tracking and Preparation
+ *
+ * Stage 3: Track when proposal is queued to timelock.
+ * Includes preparation functions for queueing and executing proposals.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.trackProposalQueued = trackProposalQueued;
+exports.prepareGovernorQueue = prepareGovernorQueue;
+const ethers_1 = require("ethers");
+const constants_1 = require("../constants");
+const abis_1 = require("../abis");
+const security_council_1 = require("../discovery/security-council");
+const logger_1 = require("../utils/logger");
+const logStage = logger_1.loggers.stage.proposalQueued;
+const logExecution = logger_1.loggers.execution;
+const governor_discovery_1 = require("../discovery/governor-discovery");
+const timelock_discovery_1 = require("../discovery/timelock-discovery");
+const stage_helpers_1 = require("../utils/stage-helpers");
+const base_1 = require("./base");
+const stage_builder_1 = require("./stage-builder");
+/**
+ * Track proposal queued stage
+ *
+ * This stage links the Governor proposal to the Timelock operation
+ */
+async function trackProposalQueued(governorAddress, proposalId, provider, 
+/** Block where proposal was created (from Stage 1) */
+fromBlock, options = {}) {
+    const builder = new stage_builder_1.StageBuilder("PROPOSAL_QUEUED", "L2");
+    // Check proposal state
+    const proposalState = await (0, governor_discovery_1.getProposalState)(governorAddress, proposalId, provider);
+    // If not yet queued, check state
+    if (proposalState === "Pending" || proposalState === "Active") {
+        return { stage: builder.status("NOT_STARTED").data({ proposalState }).build() };
+    }
+    if (proposalState === "Defeated" || proposalState === "Canceled") {
+        return { stage: builder.data({ proposalState }).skip("Proposal did not pass").build() };
+    }
+    // Proposal is queued, executed, or succeeded - find the queue event
+    const useForwardSearch = options.votingEndBlock !== undefined;
+    const searchStart = options.votingEndBlock ?? fromBlock;
+    logStage("searching for ProposalQueued: startBlock=%d direction=%s", searchStart, useForwardSearch ? "forward" : "backward");
+    const queueEvent = await (0, governor_discovery_1.findProposalQueuedEvent)(governorAddress, proposalId, provider, {
+        startBlock: searchStart,
+        endBlock: options.toBlock,
+        direction: useForwardSearch ? "forward" : "backward",
+    });
+    if (!queueEvent) {
+        // Succeeded but not yet queued - ready for execution
+        if (proposalState === "Succeeded") {
+            builder.status("READY").data({ proposalState, canQueue: true, governorAddress, proposalId });
+        }
+        else {
+            builder.status("PENDING");
+        }
+        return { stage: builder.build() };
+    }
+    // Get timelock address
+    let timelockAddress = (0, timelock_discovery_1.getL2TimelockForGovernor)(governorAddress);
+    if (!timelockAddress) {
+        timelockAddress = await (0, governor_discovery_1.getTimelockAddress)(governorAddress, provider);
+    }
+    // Find the CallScheduled events from the queue transaction
+    const callScheduledData = await (0, timelock_discovery_1.findCallScheduledByTxHash)(queueEvent.txHash, provider);
+    const operationId = callScheduledData?.[0]?.operationId;
+    const eta = queueEvent.eta.toNumber();
+    const timestamp = await (0, base_1.getBlockTimestamp)(queueEvent.blockNumber, provider);
+    // Stage is complete - proposal is queued
+    builder
+        .status("COMPLETED")
+        .tx(queueEvent.txHash, queueEvent.blockNumber, "L2", { timestamp })
+        .timing({ startedAt: timestamp, eta })
+        .data({
+        proposalState,
+        timelockAddress,
+        operationId,
+        eta,
+        callCount: callScheduledData?.length ?? 0,
+        callScheduledData: callScheduledData
+            ? (0, stage_helpers_1.serializeCallScheduledDataArray)(callScheduledData)
+            : undefined,
+    });
+    return { stage: builder.build(), timelockAddress, operationId, callScheduledData };
+}
+/**
+ * Prepare a queue transaction for a governor proposal.
+ *
+ * This is stage 3 preparation - queuing a succeeded proposal to the timelock.
+ * The proposal must be in the "Succeeded" state (voting passed).
+ */
+async function prepareGovernorQueue(governorAddress, proposalId, params, provider) {
+    logExecution("Preparing governor queue for proposal %s", proposalId);
+    const governor = new ethers_1.ethers.Contract(governorAddress, abis_1.GOVERNOR_ABI, provider);
+    const state = await governor.state(proposalId);
+    const stateName = constants_1.PROPOSAL_STATE_MAP[state] ?? `Unknown(${state})`;
+    logExecution("Proposal state: %s", stateName);
+    // Already queued
+    if (state === constants_1.PROPOSAL_STATE.QUEUED) {
+        return (0, base_1.failPrepare)("Proposal already queued");
+    }
+    // Must be in Succeeded state
+    if (state !== constants_1.PROPOSAL_STATE.SUCCEEDED) {
+        return (0, base_1.failPrepare)(`Cannot queue: proposal not in Succeeded state (current: ${stateName})`);
+    }
+    // Check vetting period for governors that have it
+    const vettingInfo = await (0, security_council_1.checkVettingPeriod)(governorAddress, proposalId, provider);
+    if (vettingInfo.hasVettingPeriod && vettingInfo.isVettingActive) {
+        return (0, base_1.failPrepare)(`Cannot queue: proposal is still in vetting period (deadline: block ${vettingInfo.vettingDeadline?.toString()})`);
+    }
+    // Build calldata
+    const calldata = abis_1.governorInterface.encodeFunctionData("queue", [
+        params.targets,
+        params.values,
+        params.calldatas,
+        params.descriptionHash,
+    ]);
+    return {
+        success: true,
+        prepared: {
+            to: governorAddress,
+            data: calldata,
+            value: "0",
+            chain: "L2",
+            description: `queue() on Governor (proposal ${proposalId})`,
+            operationId: proposalId,
+        },
+    };
+}
+//# sourceMappingURL=proposal-queued.js.map

package/dist/stages/proposal-queued.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"proposal-queued.js","sourceRoot":"","sources":["../../src/stages/proposal-queued.ts"],"names":[],"mappings":";AAAA;;;;;GAKG;;AA6BH,kDAsFC;AAiBD,oDAkDC;AApLD,mCAA2C;AAE3C,4CAAkE;AAClE,kCAA0D;AAC1D,oEAAmE;AACnE,4CAA0C;AAE1C,MAAM,QAAQ,GAAG,gBAAO,CAAC,KAAK,CAAC,cAAc,CAAC;AAC9C,MAAM,YAAY,GAAG,gBAAO,CAAC,SAAS,CAAC;AACvC,wEAIyC;AACzC,wEAGyC;AACzC,0DAAyE;AACzE,iCAAwD;AACxD,mDAA+C;AAE/C;;;;GAIG;AACI,KAAK,UAAU,mBAAmB,CACvC,eAAuB,EACvB,UAAkB,EAClB,QAAmC;AACnC,sDAAsD;AACtD,SAAiB,EACjB,UAII,EAAE;IAON,MAAM,OAAO,GAAG,IAAI,4BAAY,CAAC,iBAAiB,EAAE,IAAI,CAAC,CAAC;IAE1D,uBAAuB;IACvB,MAAM,aAAa,GAAG,MAAM,IAAA,qCAAgB,EAAC,eAAe,EAAE,UAAU,EAAE,QAAQ,CAAC,CAAC;IAEpF,iCAAiC;IACjC,IAAI,aAAa,KAAK,SAAS,IAAI,aAAa,KAAK,QAAQ,EAAE,CAAC;QAC9D,OAAO,EAAE,KAAK,EAAE,OAAO,CAAC,MAAM,CAAC,aAAa,CAAC,CAAC,IAAI,CAAC,EAAE,aAAa,EAAE,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC;IAClF,CAAC;IAED,IAAI,aAAa,KAAK,UAAU,IAAI,aAAa,KAAK,UAAU,EAAE,CAAC;QACjE,OAAO,EAAE,KAAK,EAAE,OAAO,CAAC,IAAI,CAAC,EAAE,aAAa,EAAE,CAAC,CAAC,IAAI,CAAC,uBAAuB,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC;IAC1F,CAAC;IAED,oEAAoE;IACpE,MAAM,gBAAgB,GAAG,OAAO,CAAC,cAAc,KAAK,SAAS,CAAC;IAC9D,MAAM,WAAW,GAAG,OAAO,CAAC,cAAc,IAAI,SAAS,CAAC;IAExD,QAAQ,CACN,0DAA0D,EAC1D,WAAW,EACX,gBAAgB,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,UAAU,CAC1C,CAAC;IAEF,MAAM,UAAU,GAAG,MAAM,IAAA,4CAAuB,EAAC,eAAe,EAAE,UAAU,EAAE,QAAQ,EAAE;QACtF,UAAU,EAAE,WAAW;QACvB,QAAQ,EAAE,OAAO,CAAC,OAAO;QACzB,SAAS,EAAE,gBAAgB,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,UAAU;KACrD,CAAC,CAAC;IAEH,IAAI,CAAC,UAAU,EAAE,CAAC;QAChB,qDAAqD;QACrD,IAAI,aAAa,KAAK,WAAW,EAAE,CAAC;YAClC,OAAO,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,EAAE,aAAa,EAAE,QAAQ,EAAE,IAAI,EAAE,eAAe,EAAE,UAAU,EAAE,CAAC,CAAC;QAC/F,CAAC;aAAM,CAAC;YACN,OAAO,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;QAC5B,CAAC;QACD,OAAO,EAAE,KAAK,EAAE,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC;IACpC,CAAC;IAED,uBAAuB;IACvB,IAAI,eAAe,GAAG,IAAA,6CAAwB,EAAC,eAAe,CAAC,CAAC;IAChE,IAAI,CAAC,eAAe,EAAE,CAAC;QACrB,eAAe,GAAG,MAAM,IAAA,uCAAkB,EAAC,eAAe,EAAE,QAAQ,CAAC,CAAC;IACxE,CAAC;IAED,2DAA2D;IAC3D,MAAM,iBAAiB,GAAG,MAAM,IAAA,8CAAyB,EAAC,UAAU,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;IACvF,MAAM,WAAW,GAAG,iBAAiB,EAAE,CAAC,CAAC,CAAC,EAAE,WAAW,CAAC;IACxD,MAAM,GAAG,GAAG,UAAU,CAAC,GAAG,CAAC,QAAQ,EAAE,CAAC;IACtC,MAAM,SAAS,GAAG,MAAM,IAAA,wBAAiB,EAAC,UAAU,CAAC,WAAW,EAAE,QAAQ,CAAC,CAAC;IAE5E,yCAAyC;IACzC,OAAO;SACJ,MAAM,CAAC,WAAW,CAAC;SACnB,EAAE,CAAC,UAAU,CAAC,MAAM,EAAE,UAAU,CAAC,WAAW,EAAE,IAAI,EAAE,EAAE,SAAS,EAAE,CAAC;SAClE,MAAM,CAAC,EAAE,SAAS,EAAE,SAAS,EAAE,GAAG,EAAE,CAAC;SACrC,IAAI,CAAC;QACJ,aAAa;QACb,eAAe;QACf,WAAW;QACX,GAAG;QACH,SAAS,EAAE,iBAAiB,EAAE,MAAM,IAAI,CAAC;QACzC,iBAAiB,EAAE,iBAAiB;YAClC,CAAC,CAAC,IAAA,+CAA+B,EAAC,iBAAiB,CAAC;YACpD,CAAC,CAAC,SAAS;KACd,CAAC,CAAC;IAEL,OAAO,EAAE,KAAK,EAAE,OAAO,CAAC,KAAK,EAAE,EAAE,eAAe,EAAE,WAAW,EAAE,iBAAiB,EAAE,CAAC;AACrF,CAAC;AAWD;;;;;GAKG;AACI,KAAK,UAAU,oBAAoB,CACxC,eAAuB,EACvB,UAAkB,EAClB,MAA8B,EAC9B,QAAmC;IAEnC,YAAY,CAAC,0CAA0C,EAAE,UAAU,CAAC,CAAC;IAErE,MAAM,QAAQ,GAAG,IAAI,eAAM,CAAC,QAAQ,CAAC,eAAe,EAAE,mBAAY,EAAE,QAAQ,CAAC,CAAC;IAC9E,MAAM,KAAK,GAAG,MAAM,QAAQ,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC;IAC/C,MAAM,SAAS,GAAG,8BAAkB,CAAC,KAAK,CAAC,IAAI,WAAW,KAAK,GAAG,CAAC;IACnE,YAAY,CAAC,oBAAoB,EAAE,SAAS,CAAC,CAAC;IAE9C,iBAAiB;IACjB,IAAI,KAAK,KAAK,0BAAc,CAAC,MAAM,EAAE,CAAC;QACpC,OAAO,IAAA,kBAAW,EAAC,yBAAyB,CAAC,CAAC;IAChD,CAAC;IAED,6BAA6B;IAC7B,IAAI,KAAK,KAAK,0BAAc,CAAC,SAAS,EAAE,CAAC;QACvC,OAAO,IAAA,kBAAW,EAAC,2DAA2D,SAAS,GAAG,CAAC,CAAC;IAC9F,CAAC;IAED,kDAAkD;IAClD,MAAM,WAAW,GAAG,MAAM,IAAA,qCAAkB,EAAC,eAAe,EAAE,UAAU,EAAE,QAAQ,CAAC,CAAC;IACpF,IAAI,WAAW,CAAC,gBAAgB,IAAI,WAAW,CAAC,eAAe,EAAE,CAAC;QAChE,OAAO,IAAA,kBAAW,EAChB,sEAAsE,WAAW,CAAC,eAAe,EAAE,QAAQ,EAAE,GAAG,CACjH,CAAC;IACJ,CAAC;IAED,iBAAiB;IACjB,MAAM,QAAQ,GAAG,wBAAiB,CAAC,kBAAkB,CAAC,OAAO,EAAE;QAC7D,MAAM,CAAC,OAAO;QACd,MAAM,CAAC,MAAM;QACb,MAAM,CAAC,SAAS;QAChB,MAAM,CAAC,eAAe;KACvB,CAAC,CAAC;IAEH,OAAO;QACL,OAAO,EAAE,IAAI;QACb,QAAQ,EAAE;YACR,EAAE,EAAE,eAAe;YACnB,IAAI,EAAE,QAAQ;YACd,KAAK,EAAE,GAAG;YACV,KAAK,EAAE,IAAI;YACX,WAAW,EAAE,iCAAiC,UAAU,GAAG;YAC3D,WAAW,EAAE,UAAU;SACxB;KACF,CAAC;AACJ,CAAC"}

package/dist/stages/retryables.d.ts

@@ -0,0 +1,79 @@
+/**
+ * Retryable Ticket Stage Tracking and Preparation
+ *
+ * Stage 7: Retryable Executed
+ *
+ * Uses @arbitrum/sdk v4 for retryable ticket tracking.
+ * Supports both Arbitrum One and Nova as target chains.
+ * Includes preparation functions for retryable redemption.
+ */
+import { ethers } from "ethers";
+import { ParentToChildMessageReader } from "@arbitrum/sdk";
+import { TrackedStage, ChainType, PrepareResult } from "../types";
+import { BulkPrepareResult } from "../utils/stage-helpers";
+/**
+ * Result of detecting retryable target chains, including message counts
+ */
+export interface RetryableTargetInfo {
+    chain: ChainType;
+    inboxAddress: string;
+    messageCount: number;
+}
+/**
+ * Detect ALL L2 chains that retryables target based on the delayed inboxes used,
+ * including the count of messages per chain.
+ *
+ * The L1 transaction can send messages through multiple Delayed Inboxes:
+ * - ARB1_DELAYED_INBOX (0x4Dbd4fc...) → targets Arbitrum One
+ * - NOVA_DELAYED_INBOX (0xc4448b7...) → targets Arbitrum Nova
+ *
+ * A single L1 transaction may create retryables for BOTH chains.
+ */
+export declare function detectAllRetryableTargetChains(l1TxHash: string, l1Provider: ethers.providers.Provider): Promise<RetryableTargetInfo[]>;
+/**
+ * Options for tracking retryables
+ */
+export interface TrackRetryablesOptions {
+    /** Provider for Arbitrum One (l2Provider) - required for Arb1-targeting retryables */
+    l2Provider: ethers.providers.Provider;
+    /** Provider for Arbitrum Nova - optional for Nova-targeting retryables */
+    novaProvider?: ethers.providers.Provider;
+}
+/**
+ * Track retryable execution stage
+ *
+ * Automatically detects ALL L2 chains the retryables target (Arb1 and/or Nova)
+ * based on which Delayed Inbox contracts were used on L1.
+ * A single L1 transaction may create retryables for BOTH chains.
+ *
+ * @param l1ExecutionTxHash - L1 timelock execution transaction hash
+ * @param l1Provider - Ethereum L1 provider
+ * @param options - L2 provider options (l2Provider required, novaProvider optional)
+ */
+export declare function trackRetryables(l1ExecutionTxHash: string, l1Provider: ethers.providers.Provider, options: TrackRetryablesOptions): Promise<{
+    stage: TrackedStage;
+    messages: ParentToChildMessageReader[];
+    isComplete: boolean;
+    /** All target chains for retryables (can be both Arb1 and Nova) */
+    targetChains: ("Arb1" | "Nova")[];
+}>;
+/**
+ * Options for preparing retryable tickets
+ */
+export interface RetryablePrepareOptions {
+    /** Force preparation even if stage is completed (for historical validation) */
+    force?: boolean;
+}
+/**
+ * Prepare a retryable ticket for redemption.
+ */
+export declare function prepareRetryableRedemption(message: ParentToChildMessageReader, targetChain?: ChainType, options?: RetryablePrepareOptions): Promise<PrepareResult>;
+/**
+ * Prepare all retryable tickets from an L1 transaction
+ */
+export declare function prepareAllRetryables(l1TxHash: string, l1Provider: ethers.providers.Provider, l2Provider: ethers.providers.Provider, options?: RetryablePrepareOptions): Promise<BulkPrepareResult>;
+/**
+ * Prepare retryable stage for execution
+ */
+export declare function prepareRetryableStage(stage: TrackedStage, l1Provider: ethers.providers.Provider, l2Provider: ethers.providers.Provider, options?: RetryablePrepareOptions): Promise<BulkPrepareResult>;
+//# sourceMappingURL=retryables.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"retryables.d.ts","sourceRoot":"","sources":["../../src/stages/retryables.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAChC,OAAO,EAGL,0BAA0B,EAC3B,MAAM,eAAe,CAAC;AACvB,OAAO,EAAE,YAAY,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAWlE,OAAO,EAGL,iBAAiB,EAClB,MAAM,wBAAwB,CAAC;AAiBhC;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,KAAK,EAAE,SAAS,CAAC;IACjB,YAAY,EAAE,MAAM,CAAC;IACrB,YAAY,EAAE,MAAM,CAAC;CACtB;AAED;;;;;;;;;GASG;AACH,wBAAsB,8BAA8B,CAClD,QAAQ,EAAE,MAAM,EAChB,UAAU,EAAE,MAAM,CAAC,SAAS,CAAC,QAAQ,GACpC,OAAO,CAAC,mBAAmB,EAAE,CAAC,CAgChC;AAED;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC,sFAAsF;IACtF,UAAU,EAAE,MAAM,CAAC,SAAS,CAAC,QAAQ,CAAC;IACtC,0EAA0E;IAC1E,YAAY,CAAC,EAAE,MAAM,CAAC,SAAS,CAAC,QAAQ,CAAC;CAC1C;AAED;;;;;;;;;;GAUG;AACH,wBAAsB,eAAe,CACnC,iBAAiB,EAAE,MAAM,EACzB,UAAU,EAAE,MAAM,CAAC,SAAS,CAAC,QAAQ,EACrC,OAAO,EAAE,sBAAsB,GAC9B,OAAO,CAAC;IACT,KAAK,EAAE,YAAY,CAAC;IACpB,QAAQ,EAAE,0BAA0B,EAAE,CAAC;IACvC,UAAU,EAAE,OAAO,CAAC;IACpB,mEAAmE;IACnE,YAAY,EAAE,CAAC,MAAM,GAAG,MAAM,CAAC,EAAE,CAAC;CACnC,CAAC,CAyMD;AAID;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACtC,+EAA+E;IAC/E,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED;;GAEG;AACH,wBAAsB,0BAA0B,CAC9C,OAAO,EAAE,0BAA0B,EACnC,WAAW,GAAE,SAAgB,EAC7B,OAAO,GAAE,uBAA4B,GACpC,OAAO,CAAC,aAAa,CAAC,CAkCxB;AAED;;GAEG;AACH,wBAAsB,oBAAoB,CACxC,QAAQ,EAAE,MAAM,EAChB,UAAU,EAAE,MAAM,CAAC,SAAS,CAAC,QAAQ,EACrC,UAAU,EAAE,MAAM,CAAC,SAAS,CAAC,QAAQ,EACrC,OAAO,GAAE,uBAA4B,GACpC,OAAO,CAAC,iBAAiB,CAAC,CAgB5B;AAED;;GAEG;AACH,wBAAsB,qBAAqB,CACzC,KAAK,EAAE,YAAY,EACnB,UAAU,EAAE,MAAM,CAAC,SAAS,CAAC,QAAQ,EACrC,UAAU,EAAE,MAAM,CAAC,SAAS,CAAC,QAAQ,EACrC,OAAO,GAAE,uBAA4B,GACpC,OAAO,CAAC,iBAAiB,CAAC,CAQ5B"}

package/dist/stages/retryables.js

@@ -0,0 +1,307 @@
+"use strict";
+/**
+ * Retryable Ticket Stage Tracking and Preparation
+ *
+ * Stage 7: Retryable Executed
+ *
+ * Uses @arbitrum/sdk v4 for retryable ticket tracking.
+ * Supports both Arbitrum One and Nova as target chains.
+ * Includes preparation functions for retryable redemption.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.detectAllRetryableTargetChains = detectAllRetryableTargetChains;
+exports.trackRetryables = trackRetryables;
+exports.prepareRetryableRedemption = prepareRetryableRedemption;
+exports.prepareAllRetryables = prepareAllRetryables;
+exports.prepareRetryableStage = prepareRetryableStage;
+const sdk_1 = require("@arbitrum/sdk");
+const logger_1 = require("../utils/logger");
+const log = logger_1.loggers.retryables;
+const chain_1 = require("../utils/chain");
+const abis_1 = require("../abis");
+const constants_1 = require("../constants");
+const base_1 = require("./base");
+const stage_builder_1 = require("./stage-builder");
+const rpc_utils_1 = require("../utils/rpc-utils");
+const log_filters_1 = require("../utils/log-filters");
+const stage_helpers_1 = require("../utils/stage-helpers");
+/**
+ * Detect ALL L2 chains that retryables target based on the delayed inboxes used,
+ * including the count of messages per chain.
+ *
+ * The L1 transaction can send messages through multiple Delayed Inboxes:
+ * - ARB1_DELAYED_INBOX (0x4Dbd4fc...) → targets Arbitrum One
+ * - NOVA_DELAYED_INBOX (0xc4448b7...) → targets Arbitrum Nova
+ *
+ * A single L1 transaction may create retryables for BOTH chains.
+ */
+async function detectAllRetryableTargetChains(l1TxHash, l1Provider) {
+    const receipt = await (0, rpc_utils_1.queryWithRetry)(() => l1Provider.getTransactionReceipt(l1TxHash));
+    if (!receipt) {
+        return [];
+    }
+    // Count InboxMessageDelivered events grouped by inbox address
+    const counts = (0, log_filters_1.countLogsByAddress)(receipt.logs, { topic: constants_1.EVENT_TOPICS.TICKET_CREATED });
+    const arb1Count = counts.get(constants_1.ADDRESSES.ARB1_DELAYED_INBOX.toLowerCase()) ?? 0;
+    const novaCount = counts.get(constants_1.ADDRESSES.NOVA_DELAYED_INBOX.toLowerCase()) ?? 0;
+    const targets = [];
+    if (arb1Count > 0) {
+        targets.push({
+            chain: "L2",
+            inboxAddress: constants_1.ADDRESSES.ARB1_DELAYED_INBOX,
+            messageCount: arb1Count,
+        });
+    }
+    if (novaCount > 0) {
+        targets.push({
+            chain: "NOVA",
+            inboxAddress: constants_1.ADDRESSES.NOVA_DELAYED_INBOX,
+            messageCount: novaCount,
+        });
+    }
+    return targets;
+}
+/**
+ * Track retryable execution stage
+ *
+ * Automatically detects ALL L2 chains the retryables target (Arb1 and/or Nova)
+ * based on which Delayed Inbox contracts were used on L1.
+ * A single L1 transaction may create retryables for BOTH chains.
+ *
+ * @param l1ExecutionTxHash - L1 timelock execution transaction hash
+ * @param l1Provider - Ethereum L1 provider
+ * @param options - L2 provider options (l2Provider required, novaProvider optional)
+ */
+async function trackRetryables(l1ExecutionTxHash, l1Provider, options) {
+    const { l2Provider, novaProvider } = options;
+    // Detect ALL chains that the retryables target
+    const targetInfos = await detectAllRetryableTargetChains(l1ExecutionTxHash, l1Provider);
+    // No retryables found
+    if (targetInfos.length === 0) {
+        return {
+            stage: new stage_builder_1.StageBuilder("RETRYABLE_EXECUTED", "L2")
+                .skip("No retryable tickets in transaction")
+                .build(),
+            messages: [],
+            isComplete: true,
+            targetChains: [],
+        };
+    }
+    // Get L1 receipt once (shared across all chains)
+    const l1Receipt = await (0, rpc_utils_1.queryWithRetry)(() => l1Provider.getTransactionReceipt(l1ExecutionTxHash));
+    if (!l1Receipt) {
+        return {
+            stage: new stage_builder_1.StageBuilder("RETRYABLE_EXECUTED", "L2")
+                .skip("L1 transaction receipt not found")
+                .build(),
+            messages: [],
+            isComplete: true,
+            targetChains: [],
+        };
+    }
+    const l1Timestamp = await (0, base_1.getBlockTimestamp)(l1Receipt.blockNumber, l1Provider);
+    // Collect results from all target chains
+    const allMessages = [];
+    const allCreationDetails = [];
+    const allRedemptionDetails = [];
+    const allTransactions = [
+        {
+            hash: l1ExecutionTxHash,
+            blockNumber: l1Receipt.blockNumber,
+            chain: "L1",
+            timestamp: l1Timestamp,
+            logIndex: 0,
+            description: "L1 executed",
+        },
+    ];
+    let allRedeemed = true;
+    let anyFailed = false;
+    for (const { chain: targetChain, messageCount } of targetInfos) {
+        const provider = targetChain === "NOVA" ? novaProvider : l2Provider;
+        const chainLabel = targetChain === "NOVA" ? "Nova" : "Arb1";
+        // Handle missing provider
+        if (!provider) {
+            log("No provider for %s, marking %d tickets as PROVIDER_NOT_AVAILABLE", chainLabel, messageCount);
+            for (let i = 0; i < messageCount; i++) {
+                allCreationDetails.push({
+                    index: allCreationDetails.length,
+                    targetChain: chainLabel,
+                    l2TxHash: "unknown",
+                });
+                allRedemptionDetails.push({
+                    index: allRedemptionDetails.length,
+                    targetChain: chainLabel,
+                    status: "PROVIDER_NOT_AVAILABLE",
+                    l2TxHash: null,
+                });
+            }
+            allRedeemed = false;
+            continue;
+        }
+        // Get messages for this chain
+        const parentReceipt = new sdk_1.ParentTransactionReceipt(l1Receipt);
+        const messages = await parentReceipt.getParentToChildMessages(provider);
+        allMessages.push(...messages);
+        // Add creation details and transactions
+        for (const msg of messages) {
+            allCreationDetails.push({
+                index: allCreationDetails.length,
+                targetChain: chainLabel,
+                l2TxHash: msg.retryableCreationId,
+            });
+            allTransactions.push({
+                hash: msg.retryableCreationId,
+                blockNumber: 0,
+                chain: targetChain,
+                timestamp: l1Timestamp,
+                logIndex: allTransactions.length,
+                targetChain: chainLabel,
+                description: `${chainLabel} created`,
+            });
+        }
+        const redeemResults = await Promise.all(messages.map((message, idx) => (0, rpc_utils_1.queryWithRetry)(() => message.getSuccessfulRedeem()).catch((err) => {
+            const errMsg = err instanceof Error ? err.message : String(err);
+            log("Warning: failed to get redeem status for message %d: %s", idx, errMsg);
+            return { __fetchError: true, message: errMsg };
+        })));
+        for (let i = 0; i < messages.length; i++) {
+            const redeemResult = redeemResults[i];
+            const isFetchError = redeemResult && "__fetchError" in redeemResult;
+            if (isFetchError) {
+                // Fetch error - treat as inconclusive, don't mark as redeemed
+                allRedeemed = false;
+                allRedemptionDetails.push({
+                    index: allRedemptionDetails.length,
+                    targetChain: chainLabel,
+                    status: "FETCH_ERROR",
+                    l2TxHash: null,
+                });
+                continue;
+            }
+            const status = redeemResult?.status ?? sdk_1.ParentToChildMessageStatus.NOT_YET_CREATED;
+            const statusName = sdk_1.ParentToChildMessageStatus[status];
+            let l2TxHash = null;
+            if (status === sdk_1.ParentToChildMessageStatus.REDEEMED &&
+                redeemResult &&
+                "childTxReceipt" in redeemResult &&
+                redeemResult.childTxReceipt) {
+                const { transactionHash, blockNumber } = redeemResult.childTxReceipt;
+                l2TxHash = transactionHash;
+                const timestamp = await (0, base_1.getBlockTimestamp)(blockNumber, provider);
+                allTransactions.push({
+                    hash: transactionHash,
+                    blockNumber,
+                    chain: targetChain,
+                    timestamp,
+                    logIndex: allTransactions.length,
+                    targetChain: chainLabel,
+                    description: `${chainLabel} redeemed`,
+                });
+            }
+            else if (status === sdk_1.ParentToChildMessageStatus.EXPIRED) {
+                anyFailed = true;
+                allRedeemed = false;
+            }
+            else if (status !== sdk_1.ParentToChildMessageStatus.REDEEMED) {
+                allRedeemed = false;
+            }
+            allRedemptionDetails.push({
+                index: allRedemptionDetails.length,
+                targetChain: chainLabel,
+                status: statusName,
+                l2TxHash,
+            });
+        }
+    }
+    // Collect unique target chains, converting ChainType to TargetChainType
+    // "L2" -> "Arb1", "NOVA" -> "Nova"
+    const targetChains = [
+        ...new Set(targetInfos.map((t) => (t.chain === "L2" ? "Arb1" : "Nova"))),
+    ];
+    // Determine overall status and build stage using StageBuilder
+    // Note: chain is "L2" because retryable redemption executes on L2 chains (Arb1/Nova)
+    const status = anyFailed ? "FAILED" : allRedeemed ? "COMPLETED" : "READY";
+    const builder = new stage_builder_1.StageBuilder("RETRYABLE_EXECUTED", "L2")
+        .status(status)
+        .transactions(allTransactions)
+        .timing({ startedAt: l1Timestamp })
+        .data({
+        ticketCount: allCreationDetails.length,
+        targetChains,
+        creationDetails: allCreationDetails,
+        redemptionDetails: allRedemptionDetails,
+        redeemedCount: allRedemptionDetails.filter((d) => d.status === "REDEEMED").length,
+        pendingCount: allRedemptionDetails.filter((d) => d.status === "FUNDS_DEPOSITED_ON_CHILD" || d.status === "NOT_YET_CREATED").length,
+        statuses: allRedemptionDetails.map((d) => d.status),
+    });
+    if (status === "READY") {
+        builder.executable(true).timing({ delaySeconds: constants_1.TIMING.RETRYABLE_LIFETIME_SECONDS });
+    }
+    return {
+        stage: builder.build(),
+        messages: allMessages,
+        isComplete: allRedeemed,
+        targetChains,
+    };
+}
+/**
+ * Prepare a retryable ticket for redemption.
+ */
+async function prepareRetryableRedemption(message, targetChain = "L2", options = {}) {
+    const ticketId = message.retryableCreationId;
+    log("Preparing retryable redemption for %s", ticketId);
+    const status = await (0, rpc_utils_1.queryWithRetry)(() => message.status());
+    log("Retryable status: %s", sdk_1.ParentToChildMessageStatus[status]);
+    // Skip status check if force=true for historical validation
+    if (!options.force) {
+        if (status === sdk_1.ParentToChildMessageStatus.REDEEMED) {
+            return (0, base_1.failPrepare)("Retryable already redeemed");
+        }
+        if (status === sdk_1.ParentToChildMessageStatus.EXPIRED) {
+            return (0, base_1.failPrepare)("Retryable ticket has expired");
+        }
+        if (status !== sdk_1.ParentToChildMessageStatus.FUNDS_DEPOSITED_ON_CHILD) {
+            return (0, base_1.failPrepare)(`Retryable not ready. Status: ${sdk_1.ParentToChildMessageStatus[status]}`);
+        }
+    }
+    const calldata = abis_1.arbRetryableInterface.encodeFunctionData("redeem", [ticketId]);
+    return {
+        success: true,
+        prepared: {
+            to: constants_1.ADDRESSES.ARB_RETRYABLE_TX,
+            data: calldata,
+            value: "0",
+            chain: targetChain,
+            description: `Redeem retryable ticket ${ticketId}`,
+        },
+    };
+}
+/**
+ * Prepare all retryable tickets from an L1 transaction
+ */
+async function prepareAllRetryables(l1TxHash, l1Provider, l2Provider, options = {}) {
+    const receipt = await (0, rpc_utils_1.queryWithRetry)(() => l1Provider.getTransactionReceipt(l1TxHash));
+    if (!receipt)
+        return (0, stage_helpers_1.bulkPrepareError)("L1 transaction receipt not found", "L2");
+    const parentReceipt = new sdk_1.ParentTransactionReceipt(receipt);
+    const messages = await parentReceipt.getParentToChildMessages(l2Provider);
+    if (messages.length === 0)
+        return (0, stage_helpers_1.bulkPrepareError)("No retryable tickets found", "L2");
+    const targetChain = await (0, chain_1.getChainType)(l2Provider);
+    log("Preparing %d retryable tickets for %s", messages.length, targetChain);
+    const results = await Promise.all(messages.map((message) => prepareRetryableRedemption(message, targetChain, options)));
+    return { total: messages.length, results, targetChain };
+}
+/**
+ * Prepare retryable stage for execution
+ */
+async function prepareRetryableStage(stage, l1Provider, l2Provider, options = {}) {
+    const validationError = (0, stage_helpers_1.validateStageForBulkPrepare)(stage, "L2", { force: options.force });
+    if (validationError)
+        return validationError;
+    const l1TxHash = stage.transactions[0]?.hash;
+    if (!l1TxHash)
+        return (0, stage_helpers_1.bulkPrepareError)("L1 transaction hash not found", "L2");
+    return prepareAllRetryables(l1TxHash, l1Provider, l2Provider, options);
+}
+//# sourceMappingURL=retryables.js.map

package/dist/stages/retryables.js.map

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

package/dist/stages/stage-builder.d.ts

@@ -0,0 +1,46 @@
+/**
+ * Fluent API for constructing TrackedStage objects
+ */
+import { ChainType, StageStatus, StageType, StageTransaction, StageTiming, TargetChainType, TrackedStage, TrackedStageData } from "../types";
+export declare class StageBuilder {
+    private _stage;
+    constructor(type: StageType, chain: ChainType, status?: StageStatus);
+    /**
+     * Set stage status
+     */
+    status(status: StageStatus): this;
+    /**
+     * Add data to the stage (merges with existing data)
+     */
+    data(data: TrackedStageData): this;
+    /**
+     * Set timing information (merges with existing timing)
+     */
+    timing(timing: Partial<StageTiming>): this;
+    /**
+     * Add a transaction to the stage
+     */
+    tx(hash: string, blockNumber: number, chain: ChainType, options?: {
+        timestamp?: number;
+        logIndex?: number;
+        targetChain?: TargetChainType;
+        description?: string;
+    }): this;
+    /**
+     * Mark stage as skipped with reason
+     */
+    skip(reason: string): this;
+    /**
+     * Set transactions directly (for merging from multiple sources)
+     */
+    transactions(txs: StageTransaction[]): this;
+    /**
+     * Set executable flag directly
+     */
+    executable(value: boolean): this;
+    /**
+     * Build and return the final stage object
+     */
+    build(): TrackedStage;
+}
+//# sourceMappingURL=stage-builder.d.ts.map

package/dist/stages/stage-builder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stage-builder.d.ts","sourceRoot":"","sources":["../../src/stages/stage-builder.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EACL,SAAS,EACT,WAAW,EACX,SAAS,EACT,gBAAgB,EAChB,WAAW,EACX,eAAe,EACf,YAAY,EACZ,gBAAgB,EACjB,MAAM,UAAU,CAAC;AAElB,qBAAa,YAAY;IACvB,OAAO,CAAC,MAAM,CAAe;gBAEjB,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE,SAAS,EAAE,MAAM,GAAE,WAA2B;IAWlF;;OAEG;IACH,MAAM,CAAC,MAAM,EAAE,WAAW,GAAG,IAAI;IAMjC;;OAEG;IACH,IAAI,CAAC,IAAI,EAAE,gBAAgB,GAAG,IAAI;IAKlC;;OAEG;IACH,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,WAAW,CAAC,GAAG,IAAI;IAK1C;;OAEG;IACH,EAAE,CACA,IAAI,EAAE,MAAM,EACZ,WAAW,EAAE,MAAM,EACnB,KAAK,EAAE,SAAS,EAChB,OAAO,GAAE;QACP,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,WAAW,CAAC,EAAE,eAAe,CAAC;QAC9B,WAAW,CAAC,EAAE,MAAM,CAAC;KACjB,GACL,IAAI;IAUP;;OAEG;IACH,IAAI,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAO1B;;OAEG;IACH,YAAY,CAAC,GAAG,EAAE,gBAAgB,EAAE,GAAG,IAAI;IAK3C;;OAEG;IACH,UAAU,CAAC,KAAK,EAAE,OAAO,GAAG,IAAI;IAKhC;;OAEG;IACH,KAAK,IAAI,YAAY;CAGtB"}