@gzeoneth/gov-tracker 0.1.0

package/dist/constants.d.ts

@@ -0,0 +1,235 @@
+/**
+ * Constants for Arbitrum Governance Stage Tracking SDK
+ *
+ * Centralized location for all addresses, timing, and configuration constants.
+ */
+import type { ChunkingConfig, RetryConfig, ProposalState, DiscoveryTargets } from "./types";
+/**
+ * Key Arbitrum governance contract addresses
+ *
+ * Naming aligned with governance documentation:
+ * - Constitutional: Core Governor / Core Timelock (requires L1 round-trip)
+ * - Non-Constitutional: Treasury Governor / Treasury Timelock (L2 only)
+ *
+ * @see https://docs.arbitrum.foundation/concepts/lifecycle-anatomy-aip-proposal
+ */
+export declare const ADDRESSES: {
+    readonly CONSTITUTIONAL_GOVERNOR: "0xf07DeD9dC292157749B6Fd268E37DF6EA38395B9";
+    readonly NON_CONSTITUTIONAL_GOVERNOR: "0x789fC99093B09aD01C34DC7251D0C89ce743e5a4";
+    readonly ELECTION_NOMINEE_GOVERNOR: "0x8a1cDA8dee421cD06023470608605934c16A05a0";
+    readonly ELECTION_MEMBER_GOVERNOR: "0x467923B9AE90BDB36BA88eCA11604D45F13b712C";
+    readonly L2_CONSTITUTIONAL_TIMELOCK: "0x34d45e99f7D8c45ed05B5cA72D54bbD1fb3F98f0";
+    readonly L2_NON_CONSTITUTIONAL_TIMELOCK: "0xbFc1FECa8B09A5c5D3EFfE7429eBE24b9c09EF58";
+    readonly L1_TIMELOCK: "0xE6841D92B0C345144506576eC13ECf5103aC7f49";
+    readonly ARB1_DELAYED_INBOX: "0x4Dbd4fc535Ac27206064B68FfCf827b0A60BAB3f";
+    readonly NOVA_DELAYED_INBOX: "0xc4448b71118c9071Bcb9734A0EAc55D18A153949";
+    readonly SECURITY_COUNCIL_MANAGER: "0xD509E5f5aEe2A205F554f36E8a7d56094494eDFC";
+    readonly ARB_SYS: "0x0000000000000000000000000000000000000064";
+    readonly ARB_RETRYABLE_TX: "0x000000000000000000000000000000000000006E";
+    readonly ARB1_OUTBOX: "0x0B9857ae2D4A3DBe74ffE1d7DF045bb7F96E4840";
+    readonly NOVA_OUTBOX: "0xD4B80C3D7240325D18E645B49e6535A3Bf95cc58";
+    readonly RETRYABLE_TICKET_MAGIC: "0xa723C008e76E379c55599D2E4d93879BeaFDa79C";
+};
+/**
+ * Check if a governor address is an election governor (nominee or member election)
+ *
+ * Election governors have different lifecycle handling - they don't use timelocks
+ * and are often filtered separately in monitoring applications.
+ */
+export declare function isElectionGovernor(governorAddress: string): boolean;
+/**
+ * Build default discovery targets for tracker.discoverAll()
+ *
+ * Returns a DiscoveryTargets object with sensible defaults. By default,
+ * all governors and timelocks are enabled. Use options to customize.
+ *
+ * @param options.includeElections - Include election governors (default: true)
+ * @param options.governorsOnly - Only include governors, skip timelocks (default: false)
+ * @param options.timelocksOnly - Only include timelocks, skip governors (default: false)
+ *
+ * @example
+ * ```typescript
+ * // All targets (default)
+ * const targets = buildDefaultTargets();
+ *
+ * // Skip elections
+ * const targets = buildDefaultTargets({ includeElections: false });
+ *
+ * // Only governors
+ * const targets = buildDefaultTargets({ governorsOnly: true });
+ * ```
+ */
+export declare function buildDefaultTargets(options?: {
+    includeElections?: boolean;
+    governorsOnly?: boolean;
+    timelocksOnly?: boolean;
+}): DiscoveryTargets;
+/**
+ * Chain IDs for supported networks
+ */
+export declare const CHAIN_IDS: {
+    readonly ETHEREUM: 1;
+    readonly ARB_ONE: 42161;
+    readonly NOVA: 42170;
+};
+/**
+ * Default public RPC URLs
+ *
+ * These are rate-limited public endpoints. For production use,
+ * configure dedicated RPC URLs via environment variables.
+ */
+export declare const DEFAULT_RPC_URLS: {
+    readonly ARB_ONE: "https://arb1.arbitrum.io/rpc";
+    readonly NOVA: "https://nova.arbitrum.io/rpc";
+};
+/**
+ * Pre-computed event topic hashes for efficient log filtering
+ */
+export declare const EVENT_TOPICS: {
+    readonly PROPOSAL_CREATED: string;
+    readonly PROPOSAL_QUEUED: string;
+    readonly PROPOSAL_EXECUTED: string;
+    readonly VOTE_CAST: string;
+    readonly VOTE_CAST_WITH_PARAMS: string;
+    readonly PROPOSAL_EXTENDED: string;
+    readonly CALL_SCHEDULED: string;
+    readonly CALL_EXECUTED: string;
+    readonly CANCELLED: string;
+    readonly MIN_DELAY_CHANGE: string;
+    readonly L2_TO_L1_TX: string;
+    readonly TICKET_CREATED: string;
+    readonly REDEEM_SCHEDULED: string;
+    readonly SECURITY_COUNCIL_COHORT_REPLACED: string;
+};
+/**
+ * Average block times in seconds
+ *
+ * NOTE: L2 block times are variable (0.25s-2s) depending on sequencer load.
+ * These are conservative estimates for ETA calculations. Actual timing may vary.
+ */
+export declare const BLOCK_TIMES: {
+    /** ~12 seconds per block on Ethereum mainnet */
+    readonly L1: 12;
+    /** Conservative estimate for Arbitrum One (actual: 0.25s-2s) */
+    readonly L2: 0.5;
+    /** Same as Arbitrum One */
+    readonly NOVA: 0.5;
+};
+/**
+ * Key timing constants for governance lifecycle
+ *
+ * Reference: https://docs.arbitrum.foundation/concepts/lifecycle-anatomy-aip-proposal
+ */
+export declare const TIMING: {
+    /** Maximum voting period in L2 blocks (approximately 14 days) */
+    readonly MAX_VOTING_PERIOD_BLOCKS_L2: 6500000;
+    /** Arbitrum challenge period in L1 blocks (approximately 6.4 days) */
+    readonly CHALLENGE_PERIOD_BLOCKS_L1: 45818;
+    /** L2 Constitutional timelock delay in seconds (8 days) */
+    readonly L2_CONSTITUTIONAL_TIMELOCK_DELAY_SECONDS: 691200;
+    /** L2 Non-Constitutional timelock delay in seconds (3 days) */
+    readonly L2_NON_CONSTITUTIONAL_TIMELOCK_DELAY_SECONDS: 259200;
+    /** L1 timelock delay in seconds (3 days) */
+    readonly L1_TIMELOCK_DELAY_SECONDS: 259200;
+    /** L1 timelock delay in L1 blocks (~21,600 blocks at 12s/block) */
+    readonly L1_TIMELOCK_DELAY_BLOCKS_L1: 21600;
+    /** Retryable ticket lifetime in seconds (7 days) */
+    readonly RETRYABLE_LIFETIME_SECONDS: 604800;
+    /** Voting extension period in days (for late quorum) */
+    readonly VOTING_EXTENSION_DAYS: 2;
+    /** Milliseconds in one day */
+    readonly MS_PER_DAY: number;
+    /** Security Council target nominee count per cohort */
+    readonly SECURITY_COUNCIL_TARGET_NOMINEES: 6;
+};
+/**
+ * Standard governance stage durations in days
+ *
+ * These are the expected durations for each stage in the normal proposal flow.
+ * Based on: https://docs.arbitrum.foundation/concepts/lifecycle-anatomy-aip-proposal
+ *
+ * On-chain only timing (excludes off-chain temperature check period):
+ * - Constitutional: ~34 days (voting + 8d L2 timelock + challenge + 3d L1 timelock)
+ * - Non-Constitutional: ~21 days (voting + 3d L2 timelock + L2 execution)
+ */
+export declare const GOVERNANCE_STAGE_DURATION_DAYS: {
+    /** On-chain vote duration: 16 days (14 days base + 2 days extension buffer) */
+    readonly VOTING: 16;
+    /** L2 Constitutional timelock delay: 8 days */
+    readonly L2_CONSTITUTIONAL_TIMELOCK: 8;
+    /** L2 Non-Constitutional timelock delay: 3 days */
+    readonly L2_NON_CONSTITUTIONAL_TIMELOCK: 3;
+    /** L2 execution: typically same block as delay expiry */
+    readonly L2_EXECUTION: 0;
+    /** Challenge period: ~6.4 days (45818 L1 blocks * 12s/block) */
+    readonly CHALLENGE_PERIOD: 6.4;
+    /** L1 timelock delay: 3 days */
+    readonly L1_TIMELOCK: 3;
+    /** L1 execution + retryable: typically same day */
+    readonly L1_EXECUTION: 0;
+    /** Total on-chain duration for Constitutional proposals: ~34 days */
+    readonly TOTAL_ONCHAIN_CONSTITUTIONAL: 34;
+    /** Total on-chain duration for Non-Constitutional proposals: ~21 days */
+    readonly TOTAL_ONCHAIN_NON_CONSTITUTIONAL: 21;
+};
+/**
+ * Block chunk sizes for log searches
+ */
+export declare const CHUNK_SIZES: {
+    /** L2 (Arbitrum One) chunk size: 10M blocks */
+    readonly L2: 10000000;
+    /** L1 (Ethereum) chunk size: 10K blocks */
+    readonly L1: 10000;
+    /** Nova chunk size: 10M blocks */
+    readonly NOVA: 10000000;
+    /** Delay between chunk queries in milliseconds */
+    readonly DELAY_MS: 100;
+};
+/**
+ * Default chunking configuration
+ */
+export declare const DEFAULT_CHUNKING_CONFIG: ChunkingConfig;
+/**
+ * Default retry configuration for RPC calls
+ */
+export declare const DEFAULT_RETRY_CONFIG: RetryConfig;
+/**
+ * Governance deployment blocks - earliest possible blocks for governance events
+ *
+ * Use these as fallback startBlock when no specific block hint is available.
+ * These are conservative (early) estimates to ensure no events are missed.
+ *
+ * Arbitrum DAO launched March 2023:
+ * - L2 governance deployment: ~block 70M on Arbitrum One
+ * - L1 timelock deployment: ~block 16.8M on Ethereum mainnet
+ */
+export declare const GOVERNANCE_START_BLOCKS: {
+    /** L2 (Arbitrum One) governance deployment block - March 2023 */
+    readonly L2: 70000000;
+    /** L1 (Ethereum mainnet) timelock deployment block - March 2023 */
+    readonly L1: 16800000;
+    /** Nova governance deployment block (same timeframe as L2) */
+    readonly NOVA: 1000000;
+};
+/**
+ * Map OpenZeppelin Governor state number to ProposalState string
+ *
+ * Used by governor.state() to convert numeric state to readable string.
+ */
+export declare const PROPOSAL_STATE_MAP: Record<number, ProposalState>;
+/**
+ * Numeric proposal state values from OpenZeppelin Governor
+ *
+ * Use these constants instead of magic numbers when checking proposal state.
+ */
+export declare const PROPOSAL_STATE: {
+    readonly PENDING: 0;
+    readonly ACTIVE: 1;
+    readonly CANCELED: 2;
+    readonly DEFEATED: 3;
+    readonly SUCCEEDED: 4;
+    readonly QUEUED: 5;
+    readonly EXPIRED: 6;
+    readonly EXECUTED: 7;
+};
+//# sourceMappingURL=constants.d.ts.map

package/dist/constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,KAAK,EAAE,cAAc,EAAE,WAAW,EAAE,aAAa,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAC;AAI5F;;;;;;;;GAQG;AACH,eAAO,MAAM,SAAS;;;;;;;;;;;;;;;;CAoCZ,CAAC;AAEX;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,eAAe,EAAE,MAAM,GAAG,OAAO,CAMnE;AAED;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,CAAC,EAAE;IAC5C,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,aAAa,CAAC,EAAE,OAAO,CAAC;CACzB,GAAG,gBAAgB,CAanB;AAED;;GAEG;AACH,eAAO,MAAM,SAAS;;;;CAIZ,CAAC;AAEX;;;;;GAKG;AACH,eAAO,MAAM,gBAAgB;;;CAGnB,CAAC;AAIX;;GAEG;AACH,eAAO,MAAM,YAAY;;;;;;;;;;;;;;;CAoCf,CAAC;AAIX;;;;;GAKG;AACH,eAAO,MAAM,WAAW;IACtB,gDAAgD;;IAEhD,gEAAgE;;IAEhE,2BAA2B;;CAEnB,CAAC;AAEX;;;;GAIG;AACH,eAAO,MAAM,MAAM;IACjB,iEAAiE;;IAGjE,sEAAsE;;IAGtE,2DAA2D;;IAG3D,+DAA+D;;IAG/D,4CAA4C;;IAG5C,mEAAmE;;IAGnE,oDAAoD;;IAGpD,wDAAwD;;IAGxD,8BAA8B;;IAG9B,uDAAuD;;CAE/C,CAAC;AAEX;;;;;;;;;GASG;AACH,eAAO,MAAM,8BAA8B;IACzC,+EAA+E;;IAE/E,+CAA+C;;IAE/C,mDAAmD;;IAEnD,yDAAyD;;IAEzD,gEAAgE;;IAEhE,gCAAgC;;IAEhC,mDAAmD;;IAEnD,qEAAqE;;IAErE,yEAAyE;;CAEjE,CAAC;AAIX;;GAEG;AACH,eAAO,MAAM,WAAW;IACtB,+CAA+C;;IAE/C,2CAA2C;;IAE3C,kCAAkC;;IAElC,kDAAkD;;CAE1C,CAAC;AAEX;;GAEG;AACH,eAAO,MAAM,uBAAuB,EAAE,cAKrC,CAAC;AAIF;;GAEG;AACH,eAAO,MAAM,oBAAoB,EAAE,WAKlC,CAAC;AAEF;;;;;;;;;GASG;AACH,eAAO,MAAM,uBAAuB;IAClC,iEAAiE;;IAEjE,mEAAmE;;IAEnE,8DAA8D;;CAEtD,CAAC;AAIX;;;;GAIG;AACH,eAAO,MAAM,kBAAkB,EAAE,MAAM,CAAC,MAAM,EAAE,aAAa,CAS5D,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,cAAc;;;;;;;;;CASjB,CAAC"}

package/dist/constants.js

@@ -0,0 +1,293 @@
+"use strict";
+/**
+ * Constants for Arbitrum Governance Stage Tracking SDK
+ *
+ * Centralized location for all addresses, timing, and configuration constants.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PROPOSAL_STATE = exports.PROPOSAL_STATE_MAP = exports.GOVERNANCE_START_BLOCKS = exports.DEFAULT_RETRY_CONFIG = exports.DEFAULT_CHUNKING_CONFIG = exports.CHUNK_SIZES = exports.GOVERNANCE_STAGE_DURATION_DAYS = exports.TIMING = exports.BLOCK_TIMES = exports.EVENT_TOPICS = exports.DEFAULT_RPC_URLS = exports.CHAIN_IDS = exports.ADDRESSES = void 0;
+exports.isElectionGovernor = isElectionGovernor;
+exports.buildDefaultTargets = buildDefaultTargets;
+const ethers_1 = require("ethers");
+// Contract Addresses
+/**
+ * Key Arbitrum governance contract addresses
+ *
+ * Naming aligned with governance documentation:
+ * - Constitutional: Core Governor / Core Timelock (requires L1 round-trip)
+ * - Non-Constitutional: Treasury Governor / Treasury Timelock (L2 only)
+ *
+ * @see https://docs.arbitrum.foundation/concepts/lifecycle-anatomy-aip-proposal
+ */
+exports.ADDRESSES = {
+    // Governors
+    CONSTITUTIONAL_GOVERNOR: "0xf07DeD9dC292157749B6Fd268E37DF6EA38395B9",
+    NON_CONSTITUTIONAL_GOVERNOR: "0x789fC99093B09aD01C34DC7251D0C89ce743e5a4",
+    // Election Governors (Security Council)
+    ELECTION_NOMINEE_GOVERNOR: "0x8a1cDA8dee421cD06023470608605934c16A05a0",
+    ELECTION_MEMBER_GOVERNOR: "0x467923B9AE90BDB36BA88eCA11604D45F13b712C",
+    // L2 Timelocks
+    L2_CONSTITUTIONAL_TIMELOCK: "0x34d45e99f7D8c45ed05B5cA72D54bbD1fb3F98f0",
+    L2_NON_CONSTITUTIONAL_TIMELOCK: "0xbFc1FECa8B09A5c5D3EFfE7429eBE24b9c09EF58",
+    // L1 Timelock
+    L1_TIMELOCK: "0xE6841D92B0C345144506576eC13ECf5103aC7f49",
+    // Delayed Inboxes (for retryable detection)
+    ARB1_DELAYED_INBOX: "0x4Dbd4fc535Ac27206064B68FfCf827b0A60BAB3f",
+    NOVA_DELAYED_INBOX: "0xc4448b71118c9071Bcb9734A0EAc55D18A153949",
+    // Security Council Manager
+    SECURITY_COUNCIL_MANAGER: "0xD509E5f5aEe2A205F554f36E8a7d56094494eDFC",
+    // ArbSys precompile (for L2→L1 messages and block info)
+    ARB_SYS: "0x0000000000000000000000000000000000000064",
+    // ArbRetryableTx precompile (for retryable redemption)
+    ARB_RETRYABLE_TX: "0x000000000000000000000000000000000000006E",
+    // Outbox (for L2→L1 execution)
+    ARB1_OUTBOX: "0x0B9857ae2D4A3DBe74ffE1d7DF045bb7F96E4840",
+    NOVA_OUTBOX: "0xD4B80C3D7240325D18E645B49e6535A3Bf95cc58",
+    // L1ArbitrumTimelock magic address for retryable ticket detection
+    // When a timelock operation's target is this address, the call is a retryable ticket
+    RETRYABLE_TICKET_MAGIC: "0xa723C008e76E379c55599D2E4d93879BeaFDa79C",
+};
+/**
+ * Check if a governor address is an election governor (nominee or member election)
+ *
+ * Election governors have different lifecycle handling - they don't use timelocks
+ * and are often filtered separately in monitoring applications.
+ */
+function isElectionGovernor(governorAddress) {
+    const addr = governorAddress.toLowerCase();
+    return (addr === exports.ADDRESSES.ELECTION_NOMINEE_GOVERNOR.toLowerCase() ||
+        addr === exports.ADDRESSES.ELECTION_MEMBER_GOVERNOR.toLowerCase());
+}
+/**
+ * Build default discovery targets for tracker.discoverAll()
+ *
+ * Returns a DiscoveryTargets object with sensible defaults. By default,
+ * all governors and timelocks are enabled. Use options to customize.
+ *
+ * @param options.includeElections - Include election governors (default: true)
+ * @param options.governorsOnly - Only include governors, skip timelocks (default: false)
+ * @param options.timelocksOnly - Only include timelocks, skip governors (default: false)
+ *
+ * @example
+ * ```typescript
+ * // All targets (default)
+ * const targets = buildDefaultTargets();
+ *
+ * // Skip elections
+ * const targets = buildDefaultTargets({ includeElections: false });
+ *
+ * // Only governors
+ * const targets = buildDefaultTargets({ governorsOnly: true });
+ * ```
+ */
+function buildDefaultTargets(options) {
+    const includeElections = options?.includeElections ?? true;
+    const governorsOnly = options?.governorsOnly ?? false;
+    const timelocksOnly = options?.timelocksOnly ?? false;
+    return {
+        constitutionalGovernor: !timelocksOnly,
+        nonConstitutionalGovernor: !timelocksOnly,
+        electionNomineeGovernor: !timelocksOnly && includeElections,
+        electionMemberGovernor: !timelocksOnly && includeElections,
+        l2ConstitutionalTimelock: !governorsOnly,
+        l2NonConstitutionalTimelock: !governorsOnly,
+    };
+}
+/**
+ * Chain IDs for supported networks
+ */
+exports.CHAIN_IDS = {
+    ETHEREUM: 1,
+    ARB_ONE: 42161,
+    NOVA: 42170,
+};
+/**
+ * Default public RPC URLs
+ *
+ * These are rate-limited public endpoints. For production use,
+ * configure dedicated RPC URLs via environment variables.
+ */
+exports.DEFAULT_RPC_URLS = {
+    ARB_ONE: "https://arb1.arbitrum.io/rpc",
+    NOVA: "https://nova.arbitrum.io/rpc",
+};
+// Event Topics (Pre-computed keccak256 hashes)
+/**
+ * Pre-computed event topic hashes for efficient log filtering
+ */
+exports.EVENT_TOPICS = {
+    // Governor events
+    PROPOSAL_CREATED: ethers_1.ethers.utils.id("ProposalCreated(uint256,address,address[],uint256[],string[],bytes[],uint256,uint256,string)"),
+    PROPOSAL_QUEUED: ethers_1.ethers.utils.id("ProposalQueued(uint256,uint256)"),
+    PROPOSAL_EXECUTED: ethers_1.ethers.utils.id("ProposalExecuted(uint256)"),
+    VOTE_CAST: ethers_1.ethers.utils.id("VoteCast(address,uint256,uint8,uint256,string)"),
+    VOTE_CAST_WITH_PARAMS: ethers_1.ethers.utils.id("VoteCastWithParams(address,uint256,uint8,uint256,string,bytes)"),
+    PROPOSAL_EXTENDED: ethers_1.ethers.utils.id("ProposalExtended(uint256,uint64)"),
+    // Timelock events
+    CALL_SCHEDULED: ethers_1.ethers.utils.id("CallScheduled(bytes32,uint256,address,uint256,bytes,bytes32,uint256)"),
+    CALL_EXECUTED: ethers_1.ethers.utils.id("CallExecuted(bytes32,uint256,address,uint256,bytes)"),
+    CANCELLED: ethers_1.ethers.utils.id("Cancelled(bytes32)"),
+    MIN_DELAY_CHANGE: ethers_1.ethers.utils.id("MinDelayChange(uint256,uint256)"),
+    // L2→L1 message
+    L2_TO_L1_TX: ethers_1.ethers.utils.id("L2ToL1Tx(address,address,uint256,uint256,uint256,uint256,uint256,uint256,bytes)"),
+    // Retryable
+    TICKET_CREATED: ethers_1.ethers.utils.id("InboxMessageDelivered(uint256,bytes)"),
+    REDEEM_SCHEDULED: ethers_1.ethers.utils.id("RedeemScheduled(bytes32,bytes32,uint64,uint64,address,address,uint256,uint256,bytes)"),
+    // Security Council
+    SECURITY_COUNCIL_COHORT_REPLACED: ethers_1.ethers.utils.id("SecurityCouncilCohortReplaced(address[],address[])"),
+};
+// Timing Constants
+/**
+ * Average block times in seconds
+ *
+ * NOTE: L2 block times are variable (0.25s-2s) depending on sequencer load.
+ * These are conservative estimates for ETA calculations. Actual timing may vary.
+ */
+exports.BLOCK_TIMES = {
+    /** ~12 seconds per block on Ethereum mainnet */
+    L1: 12,
+    /** Conservative estimate for Arbitrum One (actual: 0.25s-2s) */
+    L2: 0.5,
+    /** Same as Arbitrum One */
+    NOVA: 0.5,
+};
+/**
+ * Key timing constants for governance lifecycle
+ *
+ * Reference: https://docs.arbitrum.foundation/concepts/lifecycle-anatomy-aip-proposal
+ */
+exports.TIMING = {
+    /** Maximum voting period in L2 blocks (approximately 14 days) */
+    MAX_VOTING_PERIOD_BLOCKS_L2: 6500000,
+    /** Arbitrum challenge period in L1 blocks (approximately 6.4 days) */
+    CHALLENGE_PERIOD_BLOCKS_L1: 45818,
+    /** L2 Constitutional timelock delay in seconds (8 days) */
+    L2_CONSTITUTIONAL_TIMELOCK_DELAY_SECONDS: 691200,
+    /** L2 Non-Constitutional timelock delay in seconds (3 days) */
+    L2_NON_CONSTITUTIONAL_TIMELOCK_DELAY_SECONDS: 259200,
+    /** L1 timelock delay in seconds (3 days) */
+    L1_TIMELOCK_DELAY_SECONDS: 259200,
+    /** L1 timelock delay in L1 blocks (~21,600 blocks at 12s/block) */
+    L1_TIMELOCK_DELAY_BLOCKS_L1: 21600,
+    /** Retryable ticket lifetime in seconds (7 days) */
+    RETRYABLE_LIFETIME_SECONDS: 604800,
+    /** Voting extension period in days (for late quorum) */
+    VOTING_EXTENSION_DAYS: 2,
+    /** Milliseconds in one day */
+    MS_PER_DAY: 24 * 60 * 60 * 1000,
+    /** Security Council target nominee count per cohort */
+    SECURITY_COUNCIL_TARGET_NOMINEES: 6,
+};
+/**
+ * Standard governance stage durations in days
+ *
+ * These are the expected durations for each stage in the normal proposal flow.
+ * Based on: https://docs.arbitrum.foundation/concepts/lifecycle-anatomy-aip-proposal
+ *
+ * On-chain only timing (excludes off-chain temperature check period):
+ * - Constitutional: ~34 days (voting + 8d L2 timelock + challenge + 3d L1 timelock)
+ * - Non-Constitutional: ~21 days (voting + 3d L2 timelock + L2 execution)
+ */
+exports.GOVERNANCE_STAGE_DURATION_DAYS = {
+    /** On-chain vote duration: 16 days (14 days base + 2 days extension buffer) */
+    VOTING: 16,
+    /** L2 Constitutional timelock delay: 8 days */
+    L2_CONSTITUTIONAL_TIMELOCK: 8,
+    /** L2 Non-Constitutional timelock delay: 3 days */
+    L2_NON_CONSTITUTIONAL_TIMELOCK: 3,
+    /** L2 execution: typically same block as delay expiry */
+    L2_EXECUTION: 0,
+    /** Challenge period: ~6.4 days (45818 L1 blocks * 12s/block) */
+    CHALLENGE_PERIOD: 6.4,
+    /** L1 timelock delay: 3 days */
+    L1_TIMELOCK: 3,
+    /** L1 execution + retryable: typically same day */
+    L1_EXECUTION: 0,
+    /** Total on-chain duration for Constitutional proposals: ~34 days */
+    TOTAL_ONCHAIN_CONSTITUTIONAL: 34,
+    /** Total on-chain duration for Non-Constitutional proposals: ~21 days */
+    TOTAL_ONCHAIN_NON_CONSTITUTIONAL: 21,
+};
+// Chunking Configuration
+/**
+ * Block chunk sizes for log searches
+ */
+exports.CHUNK_SIZES = {
+    /** L2 (Arbitrum One) chunk size: 10M blocks */
+    L2: 10000000,
+    /** L1 (Ethereum) chunk size: 10K blocks */
+    L1: 10000,
+    /** Nova chunk size: 10M blocks */
+    NOVA: 10000000,
+    /** Delay between chunk queries in milliseconds */
+    DELAY_MS: 100,
+};
+/**
+ * Default chunking configuration
+ */
+exports.DEFAULT_CHUNKING_CONFIG = {
+    l2ChunkSize: exports.CHUNK_SIZES.L2,
+    l1ChunkSize: exports.CHUNK_SIZES.L1,
+    novaChunkSize: exports.CHUNK_SIZES.NOVA,
+    delayBetweenChunks: exports.CHUNK_SIZES.DELAY_MS,
+};
+// Retry Configuration
+/**
+ * Default retry configuration for RPC calls
+ */
+exports.DEFAULT_RETRY_CONFIG = {
+    maxRetries: 3,
+    initialDelay: 1000,
+    maxDelay: 16000,
+    backoffMultiplier: 2,
+};
+/**
+ * Governance deployment blocks - earliest possible blocks for governance events
+ *
+ * Use these as fallback startBlock when no specific block hint is available.
+ * These are conservative (early) estimates to ensure no events are missed.
+ *
+ * Arbitrum DAO launched March 2023:
+ * - L2 governance deployment: ~block 70M on Arbitrum One
+ * - L1 timelock deployment: ~block 16.8M on Ethereum mainnet
+ */
+exports.GOVERNANCE_START_BLOCKS = {
+    /** L2 (Arbitrum One) governance deployment block - March 2023 */
+    L2: 70000000,
+    /** L1 (Ethereum mainnet) timelock deployment block - March 2023 */
+    L1: 16800000,
+    /** Nova governance deployment block (same timeframe as L2) */
+    NOVA: 1000000,
+};
+// Governor State Mapping
+/**
+ * Map OpenZeppelin Governor state number to ProposalState string
+ *
+ * Used by governor.state() to convert numeric state to readable string.
+ */
+exports.PROPOSAL_STATE_MAP = {
+    0: "Pending",
+    1: "Active",
+    2: "Canceled",
+    3: "Defeated",
+    4: "Succeeded",
+    5: "Queued",
+    6: "Expired",
+    7: "Executed",
+};
+/**
+ * Numeric proposal state values from OpenZeppelin Governor
+ *
+ * Use these constants instead of magic numbers when checking proposal state.
+ */
+exports.PROPOSAL_STATE = {
+    PENDING: 0,
+    ACTIVE: 1,
+    CANCELED: 2,
+    DEFEATED: 3,
+    SUCCEEDED: 4,
+    QUEUED: 5,
+    EXPIRED: 6,
+    EXECUTED: 7,
+};
+//# sourceMappingURL=constants.js.map

package/dist/constants.js.map

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

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

@@ -0,0 +1,84 @@
+/**
+ * Governor discovery module
+ *
+ * Find proposals, detect governor type, parse ProposalCreated events.
+ * Also includes proposal discovery functions for block range scanning.
+ */
+import { BigNumber, ethers } from "ethers";
+import { GovernorCapability, ProposalType, ProposalData, ProposalState, VotingData, SearchHint } from "../types";
+/** Discovered proposal from ProposalCreated event */
+export interface DiscoveredProposal {
+    governorAddress: string;
+    proposalId: string;
+    creationTxHash: string;
+    creationBlock: number;
+}
+/**
+ * Detect governor type from address
+ */
+export declare function detectProposalType(governorAddress: string): ProposalType;
+/**
+ * Check if a governor type is a Security Council election governor
+ */
+export declare function isElectionProposal(proposalType: ProposalType): boolean;
+/**
+ * Detect governor capabilities by probing the contract
+ *
+ * This function determines the execution path for proposals:
+ * - WITH_TIMELOCK: Governor -> L2Timelock -> (optional L1 round-trip)
+ * - WITH_VETTING: Same as WITH_TIMELOCK but with vetting period
+ * - NO_TIMELOCK: Direct governor.execute() without timelock
+ *
+ * The detection order matters:
+ * 1. Check for timelock() first - most governors have this
+ * 2. Check for nomineeVetter() - only Security Council Nominee Election Governor
+ * 3. Default to NO_TIMELOCK - Security Council Member Election Governor
+ */
+export declare function detectGovernorCapabilities(governorAddress: string, provider: ethers.providers.Provider): Promise<GovernorCapability>;
+/**
+ * Get the timelock address for a governor
+ */
+export declare function getTimelockAddress(governorAddress: string, provider: ethers.providers.Provider): Promise<string>;
+/**
+ * Get proposal state from governor contract
+ */
+export declare function getProposalState(governorAddress: string, proposalId: string, provider: ethers.providers.Provider): Promise<ProposalState>;
+/**
+ * Parse ProposalCreated event data
+ */
+export declare function parseProposalCreatedEvent(log: ethers.providers.Log): ProposalData | null;
+/**
+ * Find ProposalCreated event by proposal ID
+ *
+ * @param hint - Search optimization hint. Default is backward search from current block.
+ */
+export declare function findProposalCreatedEvent(governorAddress: string, proposalId: string, provider: ethers.providers.Provider, hint?: SearchHint): Promise<ProposalData | null>;
+/**
+ * Find ProposalCreated event by transaction hash
+ */
+export declare function findProposalByTxHash(txHash: string, provider: ethers.providers.Provider): Promise<ProposalData | null>;
+/**
+ * Get voting information for a proposal
+ */
+export declare function getVotingData(governorAddress: string, proposalId: string, provider: ethers.providers.Provider): Promise<VotingData>;
+/**
+ * Find ProposalQueued event for a proposal
+ *
+ * Note: ProposalQueued(uint256 proposalId, uint256 eta) has NON-INDEXED parameters,
+ * so we cannot filter by proposalId in topics. We must search for all ProposalQueued
+ * events and decode the data to find the matching proposalId.
+ *
+ * @param hint - Search optimization hint. Default is backward search from current block.
+ */
+export declare function findProposalQueuedEvent(governorAddress: string, proposalId: string, provider: ethers.providers.Provider, hint?: SearchHint): Promise<{
+    blockNumber: number;
+    txHash: string;
+    eta: BigNumber;
+} | null>;
+/** Discover proposals from a governor in a block range */
+export declare function discoverProposals(governorAddress: string, fromBlock: number, toBlock: number, provider: ethers.providers.Provider, options?: {
+    chunkSize?: number;
+}): Promise<DiscoveredProposal[]>;
+/** Discover a proposal by transaction hash */
+export declare function discoverProposalByTxHash(txHash: string, provider: ethers.providers.Provider): Promise<DiscoveredProposal | null>;
+//# sourceMappingURL=governor-discovery.d.ts.map

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

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