@gzeoneth/gov-tracker 0.1.0

package/dist/discovery/timelock-discovery.d.ts

@@ -0,0 +1,99 @@
+/**
+ * Timelock discovery module
+ *
+ * Parse CallScheduled events, check timelock state, find operations
+ */
+import { BigNumber, ethers } from "ethers";
+import { CallExecutedData, CallScheduledData, TimelockOperationState, TimelockState, SearchHint } from "../types";
+/**
+ * Check if address is a known L2 timelock
+ */
+export declare function isKnownL2Timelock(address: string): boolean;
+/**
+ * Check if address is the L1 timelock
+ */
+export declare function isL1Timelock(address: string): boolean;
+/**
+ * Get timelock operation state directly from contract (fast path)
+ *
+ * This is the critical fast-path optimization: 4 cheap state reads
+ * instead of expensive log searches
+ */
+export declare function getTimelockOperationState(timelockAddress: string, operationId: string, provider: ethers.providers.Provider): Promise<{
+    state: TimelockOperationState;
+    isOperation: boolean;
+    isPending: boolean;
+    isReady: boolean;
+    isDone: boolean;
+    timestamp: BigNumber;
+}>;
+/**
+ * Parse CallScheduled event data
+ */
+export declare function parseCallScheduledEvent(log: ethers.providers.Log): CallScheduledData | null;
+/**
+ * Parse CallExecuted event data
+ */
+export declare function parseCallExecutedEvent(log: ethers.providers.Log): CallExecutedData | null;
+/**
+ * Find CallScheduled event by operation ID
+ *
+ * @param hint - Search optimization hint. When startBlock is provided, defaults to forward search.
+ */
+export declare function findCallScheduledEvent(timelockAddress: string, operationId: string, provider: ethers.providers.Provider, hint?: SearchHint): Promise<CallScheduledData | null>;
+/**
+ * Find CallScheduled event by transaction hash
+ */
+export declare function findCallScheduledByTxHash(txHash: string, provider: ethers.providers.Provider): Promise<CallScheduledData[] | undefined>;
+/**
+ * Find CallExecuted event by operation ID
+ *
+ * @param hint - Search optimization hint. When startBlock is provided, defaults to forward search.
+ */
+export declare function findCallExecutedEvent(timelockAddress: string, operationId: string, provider: ethers.providers.Provider, hint?: SearchHint): Promise<CallExecutedData | null>;
+/**
+ * Get full timelock state with fast-path optimization
+ *
+ * CRITICAL: Always use fast-path first, then search logs only when needed
+ *
+ * @param options.fromBlock - REQUIRED when not skipping log search. Start block for event searches.
+ * @param options.scheduledData - Pre-fetched CallScheduledData to skip log search
+ */
+export declare function getTimelockState(timelockAddress: string, operationId: string, provider: ethers.providers.Provider, options?: {
+    fromBlock?: number;
+    toBlock?: number;
+    skipLogSearch?: boolean;
+    /** Pre-fetched scheduled data - skips CallScheduled search if provided */
+    scheduledData?: CallScheduledData;
+    /** All scheduled data for batch operations */
+    allScheduledData?: CallScheduledData[];
+}): Promise<TimelockState>;
+/**
+ * Find all CallScheduled events from a transaction for a specific operation ID.
+ *
+ * A BATCH operation is when multiple CallScheduled events share the same `id` (operationId)
+ * but have different `index` values. This is different from multiple SEPARATE operations
+ * in a single transaction (which would have different `id` values).
+ *
+ * @param txHash - Transaction hash to search
+ * @param provider - Provider to use
+ * @param operationId - Operation ID to filter by (only includes events with this ID)
+ * @returns Array of CallScheduledData for the specified operation, sorted by index
+ */
+export declare function findAllCallScheduledInTx(txHash: string, provider: ethers.providers.Provider, operationId?: string): Promise<CallScheduledData[]>;
+/**
+ * Get the L2 timelock address for a governor type
+ */
+export declare function getL2TimelockForGovernor(governorAddress: string): string | null;
+/** Discovered timelock operation from CallScheduled event */
+export interface DiscoveredTimelockOp {
+    timelockAddress: string;
+    operationId: string;
+    scheduledTxHash: string;
+    queueBlock: number;
+}
+/** Discover timelock operations in a block range */
+export declare function discoverTimelockOps(timelockAddress: string, fromBlock: number, toBlock: number, provider: ethers.providers.Provider, options?: {
+    chunkSize?: number;
+}): Promise<DiscoveredTimelockOp[]>;
+//# sourceMappingURL=timelock-discovery.d.ts.map

package/dist/discovery/timelock-discovery.d.ts.map

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

package/dist/discovery/timelock-discovery.js

@@ -0,0 +1,322 @@
+"use strict";
+/**
+ * Timelock discovery module
+ *
+ * Parse CallScheduled events, check timelock state, find operations
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isKnownL2Timelock = isKnownL2Timelock;
+exports.isL1Timelock = isL1Timelock;
+exports.getTimelockOperationState = getTimelockOperationState;
+exports.parseCallScheduledEvent = parseCallScheduledEvent;
+exports.parseCallExecutedEvent = parseCallExecutedEvent;
+exports.findCallScheduledEvent = findCallScheduledEvent;
+exports.findCallScheduledByTxHash = findCallScheduledByTxHash;
+exports.findCallExecutedEvent = findCallExecutedEvent;
+exports.getTimelockState = getTimelockState;
+exports.findAllCallScheduledInTx = findAllCallScheduledInTx;
+exports.getL2TimelockForGovernor = getL2TimelockForGovernor;
+exports.discoverTimelockOps = discoverTimelockOps;
+const ethers_1 = require("ethers");
+const constants_1 = require("../constants");
+const log_search_1 = require("../utils/log-search");
+const log_search_2 = require("../utils/log-search");
+const log_filters_1 = require("../utils/log-filters");
+const rpc_utils_1 = require("../utils/rpc-utils");
+const timing_1 = require("../utils/timing");
+const chain_1 = require("../utils/chain");
+const abis_1 = require("../abis");
+const L2_TIMELOCKS = [
+    constants_1.ADDRESSES.L2_CONSTITUTIONAL_TIMELOCK,
+    constants_1.ADDRESSES.L2_NON_CONSTITUTIONAL_TIMELOCK,
+];
+/**
+ * Check if address is a known L2 timelock
+ */
+function isKnownL2Timelock(address) {
+    return (0, chain_1.isAddressIn)(address, L2_TIMELOCKS);
+}
+/**
+ * Check if address is the L1 timelock
+ */
+function isL1Timelock(address) {
+    return (0, chain_1.addressEquals)(address, constants_1.ADDRESSES.L1_TIMELOCK);
+}
+/**
+ * Get search defaults for timelock event searches.
+ * Encapsulates chain-appropriate chunk sizes, default blocks, and direction logic.
+ */
+async function getSearchDefaults(timelockAddress, provider, hint) {
+    const isL1 = isL1Timelock(timelockAddress);
+    const chunkSize = isL1 ? 10000 : 10000000;
+    const defaultStartBlock = isL1 ? constants_1.GOVERNANCE_START_BLOCKS.L1 : constants_1.GOVERNANCE_START_BLOCKS.L2;
+    const toBlock = hint?.endBlock ?? (await (0, timing_1.getCurrentBlockInfo)(provider)).blockNumber;
+    const fromBlock = hint?.startBlock ?? defaultStartBlock;
+    // When startBlock is provided, default to forward search (more efficient)
+    // When no startBlock, default to backward search (find most recent)
+    const reverseDirection = hint?.direction === "backward" || (hint?.direction !== "forward" && !hint?.startBlock);
+    return { chunkSize, fromBlock, toBlock, reverseDirection };
+}
+/**
+ * Get timelock operation state directly from contract (fast path)
+ *
+ * This is the critical fast-path optimization: 4 cheap state reads
+ * instead of expensive log searches
+ */
+async function getTimelockOperationState(timelockAddress, operationId, provider) {
+    const timelock = new ethers_1.ethers.Contract(timelockAddress, abis_1.TIMELOCK_ABI, provider);
+    // Fast parallel state checks
+    const [isOperation, isPending, isReady, isDone, timestamp] = await Promise.all([
+        (0, rpc_utils_1.queryWithRetry)(() => timelock.isOperation(operationId)),
+        (0, rpc_utils_1.queryWithRetry)(() => timelock.isOperationPending(operationId)),
+        (0, rpc_utils_1.queryWithRetry)(() => timelock.isOperationReady(operationId)),
+        (0, rpc_utils_1.queryWithRetry)(() => timelock.isOperationDone(operationId)),
+        (0, rpc_utils_1.queryWithRetry)(() => timelock.getTimestamp(operationId)),
+    ]);
+    let state = "UNKNOWN";
+    if (!isOperation) {
+        state = "UNKNOWN";
+    }
+    else if (isDone) {
+        state = "DONE";
+    }
+    else if (isReady) {
+        state = "READY";
+    }
+    else if (isPending) {
+        state = "PENDING";
+    }
+    return {
+        state,
+        isOperation,
+        isPending,
+        isReady,
+        isDone,
+        timestamp,
+    };
+}
+/**
+ * Parse CallScheduled event data
+ */
+function parseCallScheduledEvent(log) {
+    try {
+        const parsed = abis_1.timelockInterface.parseLog(log);
+        return {
+            operationId: parsed.args.id,
+            index: parsed.args.index,
+            target: parsed.args.target,
+            value: parsed.args.value,
+            data: parsed.args.data,
+            predecessor: parsed.args.predecessor,
+            delay: parsed.args.delay,
+            blockNumber: log.blockNumber,
+            txHash: log.transactionHash,
+            logIndex: log.logIndex,
+            timelockAddress: log.address,
+        };
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Parse CallExecuted event data
+ */
+function parseCallExecutedEvent(log) {
+    try {
+        const parsed = abis_1.timelockInterface.parseLog(log);
+        return {
+            operationId: parsed.args.id,
+            index: parsed.args.index,
+            target: parsed.args.target,
+            value: parsed.args.value,
+            data: parsed.args.data,
+            blockNumber: log.blockNumber,
+            txHash: log.transactionHash,
+            logIndex: log.logIndex,
+        };
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Find CallScheduled event by operation ID
+ *
+ * @param hint - Search optimization hint. When startBlock is provided, defaults to forward search.
+ */
+async function findCallScheduledEvent(timelockAddress, operationId, provider, hint) {
+    const { chunkSize, fromBlock, toBlock, reverseDirection } = await getSearchDefaults(timelockAddress, provider, hint);
+    return (0, log_search_2.findAndParseEvent)(provider, {
+        address: timelockAddress,
+        topics: [constants_1.EVENT_TOPICS.CALL_SCHEDULED, operationId],
+        fromBlock,
+        toBlock,
+    }, (0, log_search_2.createOperationIdPredicate)(operationId, chain_1.addressEquals), parseCallScheduledEvent, { chunkSize, reverseDirection });
+}
+/**
+ * Find CallScheduled event by transaction hash
+ */
+async function findCallScheduledByTxHash(txHash, provider) {
+    const receipt = await (0, rpc_utils_1.queryWithRetry)(() => provider.getTransactionReceipt(txHash));
+    if (!receipt) {
+        return undefined;
+    }
+    const results = (0, log_filters_1.findAndParseLogs)(receipt.logs, { topic: constants_1.EVENT_TOPICS.CALL_SCHEDULED }, parseCallScheduledEvent);
+    return results.length > 0 ? results : undefined;
+}
+/**
+ * Find CallExecuted event by operation ID
+ *
+ * @param hint - Search optimization hint. When startBlock is provided, defaults to forward search.
+ */
+async function findCallExecutedEvent(timelockAddress, operationId, provider, hint) {
+    const { chunkSize, fromBlock, toBlock, reverseDirection } = await getSearchDefaults(timelockAddress, provider, hint);
+    return (0, log_search_2.findAndParseEvent)(provider, {
+        address: timelockAddress,
+        topics: [constants_1.EVENT_TOPICS.CALL_EXECUTED, operationId],
+        fromBlock,
+        toBlock,
+    }, (0, log_search_2.createOperationIdPredicate)(operationId, chain_1.addressEquals), parseCallExecutedEvent, { chunkSize, reverseDirection });
+}
+/**
+ * Get full timelock state with fast-path optimization
+ *
+ * CRITICAL: Always use fast-path first, then search logs only when needed
+ *
+ * @param options.fromBlock - REQUIRED when not skipping log search. Start block for event searches.
+ * @param options.scheduledData - Pre-fetched CallScheduledData to skip log search
+ */
+async function getTimelockState(timelockAddress, operationId, provider, options = {}) {
+    // FAST PATH: Check state before expensive log search
+    const contractState = await getTimelockOperationState(timelockAddress, operationId, provider);
+    const state = {
+        operationId,
+        state: contractState.state,
+        isReady: contractState.isReady,
+        isDone: contractState.isDone,
+    };
+    // Calculate ETA from timestamp
+    if (contractState.timestamp.gt(0) && !contractState.isDone) {
+        state.eta = contractState.timestamp.toNumber();
+    }
+    // Use pre-fetched scheduled data if provided (avoids log search entirely)
+    if (options.scheduledData) {
+        state.scheduledData = options.scheduledData;
+        if (options.allScheduledData && options.allScheduledData.length > 1) {
+            state.allScheduledData = options.allScheduledData;
+            state.isBatch = true;
+        }
+    }
+    // SLOW PATH: Only search for logs when needed and not already provided
+    if (!options.skipLogSearch && !state.scheduledData) {
+        // fromBlock is required for log searches
+        if (options.fromBlock === undefined) {
+            throw new Error("fromBlock is required when searching logs in getTimelockState");
+        }
+        const fromBlock = options.fromBlock; // Store validated value for TypeScript
+        // Only search for scheduled data if the operation exists
+        if (contractState.isOperation) {
+            const scheduledData = await findCallScheduledEvent(timelockAddress, operationId, provider, {
+                startBlock: fromBlock,
+                endBlock: options.toBlock,
+            });
+            if (scheduledData) {
+                state.scheduledData = scheduledData;
+                // Check if this is a batch operation by looking for multiple CallScheduled events
+                // with the SAME operationId (not just any events in the same tx)
+                const allScheduledData = await findAllCallScheduledInTx(scheduledData.txHash, provider, operationId);
+                if (allScheduledData.length > 1) {
+                    state.allScheduledData = allScheduledData;
+                    state.isBatch = true;
+                }
+            }
+        }
+    }
+    // Only search for executed data if the operation is done
+    if (!options.skipLogSearch && contractState.isDone) {
+        // fromBlock is required for log searches
+        if (options.fromBlock === undefined) {
+            throw new Error("fromBlock is required when searching logs in getTimelockState");
+        }
+        // Use scheduledData blockNumber if available, otherwise use fromBlock
+        const executedSearchStart = state.scheduledData?.blockNumber ?? options.fromBlock;
+        const executedData = await findCallExecutedEvent(timelockAddress, operationId, provider, {
+            startBlock: executedSearchStart,
+            endBlock: options.toBlock,
+        });
+        if (executedData) {
+            state.executedData = executedData;
+        }
+    }
+    return state;
+}
+/**
+ * Find all CallScheduled events from a transaction for a specific operation ID.
+ *
+ * A BATCH operation is when multiple CallScheduled events share the same `id` (operationId)
+ * but have different `index` values. This is different from multiple SEPARATE operations
+ * in a single transaction (which would have different `id` values).
+ *
+ * @param txHash - Transaction hash to search
+ * @param provider - Provider to use
+ * @param operationId - Operation ID to filter by (only includes events with this ID)
+ * @returns Array of CallScheduledData for the specified operation, sorted by index
+ */
+async function findAllCallScheduledInTx(txHash, provider, operationId) {
+    const receipt = await (0, rpc_utils_1.queryWithRetry)(() => provider.getTransactionReceipt(txHash));
+    if (!receipt) {
+        return [];
+    }
+    const results = [];
+    for (const log of receipt.logs) {
+        if (log.topics[0] === constants_1.EVENT_TOPICS.CALL_SCHEDULED) {
+            const parsed = parseCallScheduledEvent(log);
+            if (parsed) {
+                // If operationId is specified, only include events with that ID
+                // This distinguishes a batch (same ID, different index) from
+                // multiple separate operations (different IDs)
+                if (!operationId || (0, chain_1.addressEquals)(parsed.operationId, operationId)) {
+                    results.push(parsed);
+                }
+            }
+        }
+    }
+    // Sort by index to maintain order
+    return results.sort((a, b) => a.index.toNumber() - b.index.toNumber());
+}
+/**
+ * Get the L2 timelock address for a governor type
+ */
+function getL2TimelockForGovernor(governorAddress) {
+    const normalized = governorAddress.toLowerCase();
+    if (normalized === constants_1.ADDRESSES.CONSTITUTIONAL_GOVERNOR.toLowerCase()) {
+        return constants_1.ADDRESSES.L2_CONSTITUTIONAL_TIMELOCK;
+    }
+    if (normalized === constants_1.ADDRESSES.NON_CONSTITUTIONAL_GOVERNOR.toLowerCase()) {
+        return constants_1.ADDRESSES.L2_NON_CONSTITUTIONAL_TIMELOCK;
+    }
+    return null;
+}
+/** Discover timelock operations in a block range */
+async function discoverTimelockOps(timelockAddress, fromBlock, toBlock, provider, options = {}) {
+    if (fromBlock >= toBlock)
+        return [];
+    const { logs } = await (0, log_search_1.searchLogsInChunks)(provider, { address: timelockAddress, topics: [constants_1.EVENT_TOPICS.CALL_SCHEDULED], fromBlock, toBlock }, { chunkSize: options.chunkSize ?? constants_1.CHUNK_SIZES.L2 });
+    const seen = new Set();
+    return logs.flatMap((log) => {
+        const operationId = log.topics[1];
+        if (seen.has(operationId))
+            return [];
+        seen.add(operationId);
+        return [
+            {
+                timelockAddress,
+                operationId,
+                scheduledTxHash: log.transactionHash,
+                queueBlock: log.blockNumber,
+            },
+        ];
+    });
+}
+//# sourceMappingURL=timelock-discovery.js.map

package/dist/discovery/timelock-discovery.js.map

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

package/dist/election.d.ts

@@ -0,0 +1,172 @@
+/**
+ * Security Council Election Tracking
+ *
+ * Provides functions to check election status and prepare election creation transactions.
+ * Based on SecurityCouncilElectionTracker from governance repo.
+ *
+ * @module election
+ */
+import { ethers, BigNumber } from "ethers";
+import { PreparedTransaction, ElectionProposalStatus, ElectionStatus } from "./types";
+/**
+ * Prepared election creation transaction
+ */
+export interface PreparedElectionCreation {
+    /** Transaction to send */
+    transaction: PreparedTransaction;
+    /** Election index being created */
+    electionIndex: number;
+}
+/**
+ * Election proposal parameters needed for execute() call
+ */
+export interface ElectionProposalParams {
+    /** Target addresses */
+    targets: string[];
+    /** ETH values */
+    values: BigNumber[];
+    /** Call data for each target */
+    calldatas: string[];
+    /** Proposal description */
+    description: string;
+    /** Keccak256 hash of description */
+    descriptionHash: string;
+}
+/**
+ * Check the status of the Security Council election
+ *
+ * Determines if a new election can be created and when the next one is scheduled.
+ *
+ * @param l2Provider - Arbitrum One provider
+ * @param l1Provider - Ethereum mainnet provider (for L1 timestamp)
+ * @param nomineeGovernorAddress - Optional override for nominee election governor address
+ * @returns Election status information
+ *
+ * @example
+ * ```typescript
+ * const status = await checkElectionStatus(l2Provider, l1Provider);
+ *
+ * if (status.canCreateElection) {
+ *   console.log("Election ready to create!");
+ * } else {
+ *   console.log(`Next election in ${status.timeUntilElection}`);
+ * }
+ * ```
+ */
+export declare function checkElectionStatus(l2Provider: ethers.providers.Provider, l1Provider: ethers.providers.Provider, nomineeGovernorAddress?: string): Promise<ElectionStatus>;
+/**
+ * Prepare a transaction to create a new Security Council election
+ *
+ * Only call this if checkElectionStatus indicates canCreateElection is true.
+ *
+ * @param electionStatus - Status from checkElectionStatus (provides current election count)
+ * @param nomineeGovernorAddress - Optional override for nominee election governor address
+ * @returns Prepared transaction for creating the election
+ *
+ * @example
+ * ```typescript
+ * const status = await checkElectionStatus(l2Provider, l1Provider);
+ *
+ * if (status.canCreateElection) {
+ *   const { transaction, electionIndex } = prepareElectionCreation(status);
+ *   console.log(`Creating election #${electionIndex}`);
+ *   // Execute with your signer
+ *   const tx = await signer.sendTransaction({
+ *     to: transaction.to,
+ *     data: transaction.data,
+ *   });
+ *   await tx.wait();
+ * }
+ * ```
+ */
+export declare function prepareElectionCreation(electionStatus: Pick<ElectionStatus, "electionCount">, nomineeGovernorAddress?: string): PreparedElectionCreation;
+/**
+ * Check if a governor has a vetting period (is a nominee election governor)
+ *
+ * @param governorAddress - Address of the governor to check
+ * @param provider - Provider for the chain the governor is on
+ * @returns True if the governor has a vetting period
+ */
+export declare function hasVettingPeriod(governorAddress: string, provider: ethers.providers.Provider): Promise<boolean>;
+/**
+ * Track the status of a Security Council election by its index
+ *
+ * This function provides detailed tracking of an election's progress through
+ * the nominee selection, vetting, and member election phases.
+ *
+ * @param electionIndex - The election index to track
+ * @param l2Provider - Arbitrum One provider
+ * @param l1Provider - Ethereum mainnet provider (for L1 block number)
+ * @param options - Optional address overrides
+ * @returns Detailed election proposal status
+ *
+ * @example
+ * ```typescript
+ * const status = await trackElectionProposal(
+ *   5, // election index
+ *   l2Provider,
+ *   l1Provider
+ * );
+ *
+ * if (status.phase === "VETTING_PERIOD") {
+ *   console.log(`${status.compliantNomineeCount}/6 nominees compliant`);
+ * }
+ * ```
+ */
+export declare function trackElectionProposal(electionIndex: number, l2Provider: ethers.providers.Provider, _l1Provider: ethers.providers.Provider, options?: {
+    nomineeGovernorAddress?: string;
+    memberGovernorAddress?: string;
+}): Promise<ElectionProposalStatus>;
+/**
+ * Get the proposal ID for a given election index
+ *
+ * Uses getProposeArgs to get proposal parameters and hashProposal to calculate the proposal ID.
+ *
+ * @param electionIndex - Election index
+ * @param provider - L2 provider
+ * @param nomineeGovernorAddress - Optional governor address override
+ * @returns Proposal ID or null if election not yet created
+ */
+export declare function getElectionProposalId(electionIndex: number, provider: ethers.providers.Provider, nomineeGovernorAddress?: string): Promise<string | null>;
+/**
+ * Get the proposal parameters for an election proposal
+ *
+ * Searches for the ProposalCreated event to extract targets, values, calldatas,
+ * and description needed for execute() call.
+ *
+ * @param electionIndex - Election index
+ * @param provider - L2 provider
+ * @param nomineeGovernorAddress - Optional governor address override
+ * @returns Election proposal params or null if not found
+ */
+export declare function getElectionProposalParams(electionIndex: number, provider: ethers.providers.Provider, nomineeGovernorAddress?: string): Promise<ElectionProposalParams | null>;
+/**
+ * Prepare a transaction to trigger member election creation
+ *
+ * After the vetting period ends with 6+ compliant nominees, calling execute()
+ * on the NomineeElectionGovernor creates the member election proposal.
+ *
+ * @param electionStatus - Status from trackElectionProposal (must have canProceedToMemberPhase=true)
+ * @param provider - L2 provider
+ * @param nomineeGovernorAddress - Optional governor address override
+ * @returns Prepared transaction or null if not ready
+ *
+ * @example
+ * ```typescript
+ * const status = await trackElectionProposal(5, l2Provider, l1Provider);
+ *
+ * if (status.canProceedToMemberPhase) {
+ *   const prepared = await prepareMemberElectionTrigger(status, l2Provider);
+ *   if (prepared) {
+ *     const tx = await signer.sendTransaction({
+ *       to: prepared.to,
+ *       data: prepared.data,
+ *     });
+ *     await tx.wait();
+ *     console.log("Member election created!");
+ *   }
+ * }
+ * ```
+ */
+export declare function prepareMemberElectionTrigger(electionStatus: Pick<ElectionProposalStatus, "electionIndex" | "canProceedToMemberPhase">, provider: ethers.providers.Provider, nomineeGovernorAddress?: string): Promise<PreparedTransaction | null>;
+//# sourceMappingURL=election.d.ts.map

package/dist/election.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"election.d.ts","sourceRoot":"","sources":["../src/election.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,QAAQ,CAAC;AAG3C,OAAO,EACL,mBAAmB,EAKnB,sBAAsB,EACtB,cAAc,EACf,MAAM,SAAS,CAAC;AAYjB;;GAEG;AACH,MAAM,WAAW,wBAAwB;IACvC,0BAA0B;IAC1B,WAAW,EAAE,mBAAmB,CAAC;IACjC,mCAAmC;IACnC,aAAa,EAAE,MAAM,CAAC;CACvB;AAED;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC,uBAAuB;IACvB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,iBAAiB;IACjB,MAAM,EAAE,SAAS,EAAE,CAAC;IACpB,gCAAgC;IAChC,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,2BAA2B;IAC3B,WAAW,EAAE,MAAM,CAAC;IACpB,oCAAoC;IACpC,eAAe,EAAE,MAAM,CAAC;CACzB;AAsBD;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAsB,mBAAmB,CACvC,UAAU,EAAE,MAAM,CAAC,SAAS,CAAC,QAAQ,EACrC,UAAU,EAAE,MAAM,CAAC,SAAS,CAAC,QAAQ,EACrC,sBAAsB,GAAE,MAA4C,GACnE,OAAO,CAAC,cAAc,CAAC,CA6CzB;AAED;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,wBAAgB,uBAAuB,CACrC,cAAc,EAAE,IAAI,CAAC,cAAc,EAAE,eAAe,CAAC,EACrD,sBAAsB,GAAE,MAA4C,GACnE,wBAAwB,CAe1B;AAED;;;;;;GAMG;AACH,wBAAsB,gBAAgB,CACpC,eAAe,EAAE,MAAM,EACvB,QAAQ,EAAE,MAAM,CAAC,SAAS,CAAC,QAAQ,GAClC,OAAO,CAAC,OAAO,CAAC,CASlB;AAiDD;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,wBAAsB,qBAAqB,CACzC,aAAa,EAAE,MAAM,EACrB,UAAU,EAAE,MAAM,CAAC,SAAS,CAAC,QAAQ,EACrC,WAAW,EAAE,MAAM,CAAC,SAAS,CAAC,QAAQ,EACtC,OAAO,GAAE;IACP,sBAAsB,CAAC,EAAE,MAAM,CAAC;IAChC,qBAAqB,CAAC,EAAE,MAAM,CAAC;CAC3B,GACL,OAAO,CAAC,sBAAsB,CAAC,CAiIjC;AAED;;;;;;;;;GASG;AACH,wBAAsB,qBAAqB,CACzC,aAAa,EAAE,MAAM,EACrB,QAAQ,EAAE,MAAM,CAAC,SAAS,CAAC,QAAQ,EACnC,sBAAsB,GAAE,MAA4C,GACnE,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAwBxB;AAID;;;;;;;;;;GAUG;AACH,wBAAsB,yBAAyB,CAC7C,aAAa,EAAE,MAAM,EACrB,QAAQ,EAAE,MAAM,CAAC,SAAS,CAAC,QAAQ,EACnC,sBAAsB,GAAE,MAA4C,GACnE,OAAO,CAAC,sBAAsB,GAAG,IAAI,CAAC,CA4DxC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,wBAAsB,4BAA4B,CAChD,cAAc,EAAE,IAAI,CAAC,sBAAsB,EAAE,eAAe,GAAG,yBAAyB,CAAC,EACzF,QAAQ,EAAE,MAAM,CAAC,SAAS,CAAC,QAAQ,EACnC,sBAAsB,GAAE,MAA4C,GACnE,OAAO,CAAC,mBAAmB,GAAG,IAAI,CAAC,CAmCrC"}