@gzeoneth/gov-tracker 0.4.0 → 0.5.0

package/dist/election/status.d.ts

@@ -1,5 +1,5 @@
 import { ethers } from "ethers";
-import { ElectionPhase, ElectionStatus, ProposalState } from "../types";
+import { ElectionConfig, ElectionPhase, ElectionProposalStatus, ElectionStatus, ProposalState } from "../types";
 /**
  * Get the current election count without fetching full status.
  * This is a lightweight call that only fetches the count (single multicall).
@@ -12,4 +12,31 @@ export declare function getElectionCount(l2Provider: ethers.providers.Provider,
 export declare function determineElectionPhase(nomineeProposalState: ProposalState | null, memberProposalId: string | null, memberProposalState: ProposalState | null, isInVettingPeriod: boolean): ElectionPhase;
 export declare function checkElectionStatus(l2Provider: ethers.providers.Provider, l1Provider: ethers.providers.Provider, nomineeGovernorAddress?: string): Promise<ElectionStatus>;
 export declare function hasVettingPeriod(governorAddress: string, provider: ethers.providers.Provider): Promise<boolean>;
+/**
+ * Full status + phase lookup for a specific election.
+ *
+ * Returns a complete `ElectionProposalStatus` with all fields populated from
+ * on-chain data: proposal states, compliant nominee count, vetting deadline,
+ * cohort, and derived phase. Replaces the pattern of calling multiple SDK
+ * functions and manually assembling the result.
+ *
+ * The returned `ElectionProposalStatus.stages` field is not populated (use
+ * the full tracking pipeline via `ProposalStageTracker.trackElection()` for
+ * stage-level tracking).
+ *
+ * @param l2Provider - L2 provider (also used for L1 block number via ArbSys)
+ * @param electionIndex - The election index to check (0-based)
+ * @param config - Deployment config with contract addresses (defaults to mainnet)
+ */
+export declare function getElectionStatus(l2Provider: ethers.providers.Provider, electionIndex: number, config?: ElectionConfig): Promise<ElectionProposalStatus>;
+/**
+ * Batch fetch status for all elections.
+ *
+ * Fetches the election count once, then queries each election in parallel
+ * via `getElectionStatus`. Individual failures are logged and skipped.
+ *
+ * @param l2Provider - L2 provider
+ * @param config - Deployment config (defaults to mainnet)
+ */
+export declare function getAllElectionStatuses(l2Provider: ethers.providers.Provider, config?: ElectionConfig): Promise<ElectionProposalStatus[]>;
 //# sourceMappingURL=status.d.ts.map

package/dist/election/status.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"status.d.ts","sourceRoot":"","sources":["../../src/election/status.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAa,MAAM,QAAQ,CAAC;AAI3C,OAAO,EAAc,aAAa,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AASpF;;;;;;;GAOG;AACH,wBAAsB,gBAAgB,CACpC,UAAU,EAAE,MAAM,CAAC,SAAS,CAAC,QAAQ,EACrC,sBAAsB,GAAE,MAA4C,GACnE,OAAO,CAAC,MAAM,CAAC,CAajB;AAED,wBAAgB,sBAAsB,CACpC,oBAAoB,EAAE,aAAa,GAAG,IAAI,EAC1C,gBAAgB,EAAE,MAAM,GAAG,IAAI,EAC/B,mBAAmB,EAAE,aAAa,GAAG,IAAI,EACzC,iBAAiB,EAAE,OAAO,GACzB,aAAa,CA0Bf;AAED,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,CAkEzB;AAED,wBAAsB,gBAAgB,CACpC,eAAe,EAAE,MAAM,EACvB,QAAQ,EAAE,MAAM,CAAC,SAAS,CAAC,QAAQ,GAClC,OAAO,CAAC,OAAO,CAAC,CASlB"}
+{"version":3,"file":"status.d.ts","sourceRoot":"","sources":["../../src/election/status.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAa,MAAM,QAAQ,CAAC;AAI3C,OAAO,EAEL,cAAc,EACd,aAAa,EACb,sBAAsB,EACtB,cAAc,EACd,aAAa,EACd,MAAM,UAAU,CAAC;AAWlB;;;;;;;GAOG;AACH,wBAAsB,gBAAgB,CACpC,UAAU,EAAE,MAAM,CAAC,SAAS,CAAC,QAAQ,EACrC,sBAAsB,GAAE,MAA4C,GACnE,OAAO,CAAC,MAAM,CAAC,CAajB;AAED,wBAAgB,sBAAsB,CACpC,oBAAoB,EAAE,aAAa,GAAG,IAAI,EAC1C,gBAAgB,EAAE,MAAM,GAAG,IAAI,EAC/B,mBAAmB,EAAE,aAAa,GAAG,IAAI,EACzC,iBAAiB,EAAE,OAAO,GACzB,aAAa,CA0Bf;AAED,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,CAwEzB;AAED,wBAAsB,gBAAgB,CACpC,eAAe,EAAE,MAAM,EACvB,QAAQ,EAAE,MAAM,CAAC,SAAS,CAAC,QAAQ,GAClC,OAAO,CAAC,OAAO,CAAC,CASlB;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAsB,iBAAiB,CACrC,UAAU,EAAE,MAAM,CAAC,SAAS,CAAC,QAAQ,EACrC,aAAa,EAAE,MAAM,EACrB,MAAM,GAAE,cAAwC,GAC/C,OAAO,CAAC,sBAAsB,CAAC,CAwFjC;AAED;;;;;;;;GAQG;AACH,wBAAsB,sBAAsB,CAC1C,UAAU,EAAE,MAAM,CAAC,SAAS,CAAC,QAAQ,EACrC,MAAM,GAAE,cAAwC,GAC/C,OAAO,CAAC,sBAAsB,EAAE,CAAC,CAanC"}

package/dist/election/status.js

@@ -4,14 +4,19 @@ exports.getElectionCount = getElectionCount;
 exports.determineElectionPhase = determineElectionPhase;
 exports.checkElectionStatus = checkElectionStatus;
 exports.hasVettingPeriod = hasVettingPeriod;
+exports.getElectionStatus = getElectionStatus;
+exports.getAllElectionStatuses = getAllElectionStatuses;
+const ethers_1 = require("ethers");
 const constants_1 = require("../constants");
 const formatters_1 = require("../utils/formatters");
 const rpc_utils_1 = require("../utils/rpc-utils");
+const constants_2 = require("../constants");
 const timing_1 = require("../utils/timing");
 const logger_1 = require("../utils/logger");
 const abis_1 = require("../abis");
 const contracts_1 = require("./contracts");
 const multicall_1 = require("../utils/multicall");
+const proposal_ids_1 = require("./proposal-ids");
 const log = logger_1.loggers.election;
 /**
  * Get the current election count without fetching full status.
@@ -41,15 +46,15 @@ function determineElectionPhase(nomineeProposalState, memberProposalId, memberPr
     if (nomineeProposalState === "Executed") {
         return "PENDING_EXECUTION";
     }
-    if (isInVettingPeriod) {
-        return "VETTING_PERIOD";
-    }
     if (nomineeProposalState === "Pending") {
         return "CONTENDER_SUBMISSION";
     }
     if (nomineeProposalState === "Active") {
         return "NOMINEE_SELECTION";
     }
+    if (isInVettingPeriod) {
+        return "VETTING_PERIOD";
+    }
     if (nomineeProposalState === "Succeeded") {
         return "PENDING_EXECUTION";
     }
@@ -64,6 +69,9 @@ async function checkElectionStatus(l2Provider, l1Provider, nomineeGovernorAddres
         ]),
     ]);
     const electionCount = electionCountResult[0];
+    if (!electionCount) {
+        throw new Error("Failed to fetch election count from nominee governor");
+    }
     log("L1 block number from L2: %s", l1BlockNumber.toString());
     const l1Block = await (0, rpc_utils_1.queryWithRetry)(() => l1Provider.getBlock(l1BlockNumber.toNumber()));
     if (!l1Block) {
@@ -78,6 +86,9 @@ async function checkElectionStatus(l2Provider, l1Provider, nomineeGovernorAddres
     ]);
     const nextElectionTimestamp = electionResults[0];
     const cohort = electionResults[1];
+    if (!nextElectionTimestamp || cohort === undefined) {
+        throw new Error("Failed to fetch election details from nominee governor");
+    }
     log("electionCount=%s nextTimestamp=%s cohort=%d", electionCount.toString(), nextElectionTimestamp.toString(), cohort);
     const secondsUntilElection = Math.max(0, nextElectionTimestamp.toNumber() - currentL1Timestamp);
     const canCreateElection = secondsUntilElection === 0;
@@ -102,4 +113,106 @@ async function hasVettingPeriod(governorAddress, provider) {
         return false;
     }
 }
+/**
+ * Full status + phase lookup for a specific election.
+ *
+ * Returns a complete `ElectionProposalStatus` with all fields populated from
+ * on-chain data: proposal states, compliant nominee count, vetting deadline,
+ * cohort, and derived phase. Replaces the pattern of calling multiple SDK
+ * functions and manually assembling the result.
+ *
+ * The returned `ElectionProposalStatus.stages` field is not populated (use
+ * the full tracking pipeline via `ProposalStageTracker.trackElection()` for
+ * stage-level tracking).
+ *
+ * @param l2Provider - L2 provider (also used for L1 block number via ArbSys)
+ * @param electionIndex - The election index to check (0-based)
+ * @param config - Deployment config with contract addresses (defaults to mainnet)
+ */
+async function getElectionStatus(l2Provider, electionIndex, config = constants_1.MAINNET_ELECTION_CONFIG) {
+    const { nomineeGovernorAddress, memberGovernorAddress } = config;
+    const nominee = (0, contracts_1.getNomineeGovernor)(nomineeGovernorAddress, l2Provider);
+    const [proposalIds, cohortRaw] = await Promise.all([
+        (0, proposal_ids_1.getElectionProposalIds)(electionIndex, l2Provider, {
+            nomineeGovernorAddress,
+            memberGovernorAddress,
+        }),
+        (0, rpc_utils_1.queryWithRetry)(() => nominee.electionIndexToCohort(electionIndex)),
+    ]);
+    const { nomineeProposalId } = proposalIds;
+    let { memberProposalId } = proposalIds;
+    const cohort = cohortRaw;
+    let nomineeProposalState = null;
+    let memberProposalState = null;
+    let isInVettingPeriod = false;
+    let vettingDeadline = null;
+    let compliantNomineeCount = 0;
+    if (nomineeProposalId) {
+        const [stateNum, compliantCount] = await Promise.all([
+            (0, rpc_utils_1.queryWithRetry)(() => nominee.state(nomineeProposalId)),
+            (0, rpc_utils_1.queryWithRetry)(() => nominee.compliantNomineeCount(nomineeProposalId)).catch(() => ethers_1.BigNumber.from(0)),
+        ]);
+        nomineeProposalState = (0, constants_1.proposalStateToString)(stateNum);
+        compliantNomineeCount = compliantCount.toNumber();
+        if (nomineeProposalState === "Succeeded") {
+            try {
+                const deadline = await (0, rpc_utils_1.queryWithRetry)(() => nominee.proposalVettingDeadline(nomineeProposalId));
+                vettingDeadline = deadline.toNumber();
+                const l1BlockNumber = await (0, timing_1.getL1BlockNumberFromL2)(l2Provider);
+                isInVettingPeriod = l1BlockNumber.lte(deadline);
+            }
+            catch {
+                // No vetting period on this governor
+            }
+        }
+    }
+    if (memberProposalId) {
+        const member = (0, contracts_1.getMemberGovernor)(memberGovernorAddress, l2Provider);
+        try {
+            const stateNum = await (0, rpc_utils_1.queryWithRetry)(() => member.state(memberProposalId));
+            memberProposalState = (0, constants_1.proposalStateToString)(stateNum);
+        }
+        catch {
+            memberProposalId = null;
+        }
+    }
+    const phase = determineElectionPhase(nomineeProposalState, memberProposalId, memberProposalState, isInVettingPeriod);
+    const canProceedToMemberPhase = nomineeProposalState === "Succeeded" &&
+        !isInVettingPeriod &&
+        compliantNomineeCount >= constants_2.TIMING.SECURITY_COUNCIL_TARGET_NOMINEES &&
+        !memberProposalId;
+    const canExecuteMember = memberProposalState === "Succeeded" || memberProposalState === "Queued";
+    return {
+        electionIndex,
+        phase,
+        cohort,
+        nomineeProposalId,
+        memberProposalId,
+        nomineeProposalState,
+        memberProposalState,
+        compliantNomineeCount,
+        targetNomineeCount: constants_2.TIMING.SECURITY_COUNCIL_TARGET_NOMINEES,
+        vettingDeadline,
+        isInVettingPeriod,
+        canProceedToMemberPhase,
+        canExecuteMember,
+    };
+}
+/**
+ * Batch fetch status for all elections.
+ *
+ * Fetches the election count once, then queries each election in parallel
+ * via `getElectionStatus`. Individual failures are logged and skipped.
+ *
+ * @param l2Provider - L2 provider
+ * @param config - Deployment config (defaults to mainnet)
+ */
+async function getAllElectionStatuses(l2Provider, config = constants_1.MAINNET_ELECTION_CONFIG) {
+    const count = await getElectionCount(l2Provider, config.nomineeGovernorAddress);
+    const results = await Promise.all(Array.from({ length: count }, (_, i) => getElectionStatus(l2Provider, i, config).catch((err) => {
+        log("Failed to fetch election %d: %s", i, err instanceof Error ? err.message : err);
+        return null;
+    })));
+    return results.filter((r) => r !== null);
+}
 //# sourceMappingURL=status.js.map

package/dist/election/status.js.map

@@ -1 +1 @@
-{"version":3,"file":"status.js","sourceRoot":"","sources":["../../src/election/status.ts"],"names":[],"mappings":";;AAqBA,4CAgBC;AAED,wDA+BC;AAED,kDAsEC;AAED,4CAYC;AA3JD,4CAAyC;AACzC,oDAAqD;AACrD,kDAAoD;AAEpD,4CAAyD;AACzD,4CAA0C;AAC1C,kCAA2D;AAC3D,2CAAiD;AACjD,kDAA+D;AAE/D,MAAM,GAAG,GAAG,gBAAO,CAAC,QAAQ,CAAC;AAE7B;;;;;;;GAOG;AACI,KAAK,UAAU,gBAAgB,CACpC,UAAqC,EACrC,yBAAiC,qBAAS,CAAC,yBAAyB;IAEpE,GAAG,CAAC,yBAAyB,EAAE,sBAAsB,CAAC,CAAC;IAEvD,MAAM,CAAC,aAAa,CAAC,GAAG,MAAM,IAAA,qBAAS,EAAC,UAAU,EAAE;QAClD,IAAA,0BAAc,EACZ,sBAAsB,EACtB,uCAAgC,EAChC,eAAe,EACf,EAAE,CACH;KACF,CAAC,CAAC;IAEH,OAAQ,aAA2B,CAAC,QAAQ,EAAE,CAAC;AACjD,CAAC;AAED,SAAgB,sBAAsB,CACpC,oBAA0C,EAC1C,gBAA+B,EAC/B,mBAAyC,EACzC,iBAA0B;IAE1B,IAAI,mBAAmB,KAAK,UAAU,EAAE,CAAC;QACvC,OAAO,WAAW,CAAC;IACrB,CAAC;IACD,IAAI,gBAAgB,EAAE,CAAC;QACrB,IAAI,mBAAmB,KAAK,WAAW,IAAI,mBAAmB,KAAK,QAAQ,EAAE,CAAC;YAC5E,OAAO,mBAAmB,CAAC;QAC7B,CAAC;QACD,OAAO,iBAAiB,CAAC;IAC3B,CAAC;IACD,IAAI,oBAAoB,KAAK,UAAU,EAAE,CAAC;QACxC,OAAO,mBAAmB,CAAC;IAC7B,CAAC;IACD,IAAI,iBAAiB,EAAE,CAAC;QACtB,OAAO,gBAAgB,CAAC;IAC1B,CAAC;IACD,IAAI,oBAAoB,KAAK,SAAS,EAAE,CAAC;QACvC,OAAO,sBAAsB,CAAC;IAChC,CAAC;IACD,IAAI,oBAAoB,KAAK,QAAQ,EAAE,CAAC;QACtC,OAAO,mBAAmB,CAAC;IAC7B,CAAC;IACD,IAAI,oBAAoB,KAAK,WAAW,EAAE,CAAC;QACzC,OAAO,mBAAmB,CAAC;IAC7B,CAAC;IACD,OAAO,aAAa,CAAC;AACvB,CAAC;AAEM,KAAK,UAAU,mBAAmB,CACvC,UAAqC,EACrC,UAAqC,EACrC,yBAAiC,qBAAS,CAAC,yBAAyB;IAEpE,GAAG,CAAC,4BAA4B,EAAE,sBAAsB,CAAC,CAAC;IAE1D,MAAM,CAAC,aAAa,EAAE,mBAAmB,CAAC,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC;QAC7D,IAAA,+BAAsB,EAAC,UAAU,CAAC;QAClC,IAAA,qBAAS,EAAC,UAAU,EAAE;YACpB,IAAA,0BAAc,EACZ,sBAAsB,EACtB,uCAAgC,EAChC,eAAe,EACf,EAAE,CACH;SACF,CAAC;KACH,CAAC,CAAC;IAEH,MAAM,aAAa,GAAG,mBAAmB,CAAC,CAAC,CAAc,CAAC;IAC1D,GAAG,CAAC,6BAA6B,EAAE,aAAa,CAAC,QAAQ,EAAE,CAAC,CAAC;IAE7D,MAAM,OAAO,GAAG,MAAM,IAAA,0BAAc,EAAC,GAAG,EAAE,CAAC,UAAU,CAAC,QAAQ,CAAC,aAAa,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC;IAC1F,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,MAAM,IAAI,KAAK,CACb,YAAY,aAAa,CAAC,QAAQ,EAAE,cAAc;YAChD,sDAAsD,aAAa,CAAC,QAAQ,EAAE,EAAE,CACnF,CAAC;IACJ,CAAC;IACD,MAAM,kBAAkB,GAAG,OAAO,CAAC,SAAS,CAAC;IAC7C,GAAG,CAAC,kBAAkB,EAAE,kBAAkB,CAAC,CAAC;IAE5C,MAAM,eAAe,GAAG,MAAM,IAAA,qBAAS,EAAC,UAAU,EAAE;QAClD,IAAA,0BAAc,EACZ,sBAAsB,EACtB,uCAAgC,EAChC,qBAAqB,EACrB,CAAC,aAAa,CAAC,CAChB;QACD,IAAA,0BAAc,EACZ,sBAAsB,EACtB,uCAAgC,EAChC,uBAAuB,EACvB,CAAC,aAAa,CAAC,CAChB;KACF,CAAC,CAAC;IAEH,MAAM,qBAAqB,GAAG,eAAe,CAAC,CAAC,CAAc,CAAC;IAC9D,MAAM,MAAM,GAAG,eAAe,CAAC,CAAC,CAAW,CAAC;IAC5C,GAAG,CACD,6CAA6C,EAC7C,aAAa,CAAC,QAAQ,EAAE,EACxB,qBAAqB,CAAC,QAAQ,EAAE,EAChC,MAAM,CACP,CAAC;IAEF,MAAM,oBAAoB,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,qBAAqB,CAAC,QAAQ,EAAE,GAAG,kBAAkB,CAAC,CAAC;IAChG,MAAM,iBAAiB,GAAG,oBAAoB,KAAK,CAAC,CAAC;IAErD,MAAM,MAAM,GAAmB;QAC7B,aAAa,EAAE,aAAa,CAAC,QAAQ,EAAE;QACvC,MAAM,EAAE,MAAoB;QAC5B,qBAAqB,EAAE,qBAAqB,CAAC,QAAQ,EAAE;QACvD,kBAAkB;QAClB,iBAAiB;QACjB,oBAAoB;QACpB,iBAAiB,EAAE,IAAA,2BAAc,EAAC,oBAAoB,CAAC;KACxD,CAAC;IAEF,OAAO,MAAM,CAAC;AAChB,CAAC;AAEM,KAAK,UAAU,gBAAgB,CACpC,eAAuB,EACvB,QAAmC;IAEnC,MAAM,QAAQ,GAAG,IAAA,8BAAkB,EAAC,eAAe,EAAE,QAAQ,CAAC,CAAC;IAE/D,IAAI,CAAC;QACH,MAAM,IAAA,0BAAc,EAAC,GAAG,EAAE,CAAC,QAAQ,CAAC,aAAa,EAAE,CAAC,CAAC;QACrD,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC"}
+{"version":3,"file":"status.js","sourceRoot":"","sources":["../../src/election/status.ts"],"names":[],"mappings":"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"}

package/dist/election/write.d.ts

@@ -0,0 +1,132 @@
+/**
+ * Election write action preparation
+ *
+ * Prepares transactions and typed data for election participation:
+ * - Contender registration (EIP-712 sign → addContender)
+ * - Vote casting (castVoteWithReasonAndParams with encoded params)
+ *
+ * Following the SDK's prepare-only philosophy: this module builds
+ * transaction data and typed data structures, but never executes.
+ */
+import { BigNumber } from "ethers";
+import { PreparedTransaction } from "../types";
+/**
+ * EIP-712 typed data for wallet signing (framework-agnostic)
+ *
+ * Compatible with:
+ * - ethers v5: signer._signTypedData(domain, types, message)
+ * - ethers v6: signer.signTypedData(domain, types, message)
+ * - wagmi v2: useSignTypedData({ domain, types, primaryType, message })
+ * - viem: signTypedData(client, { domain, types, primaryType, message })
+ */
+export interface AddContenderTypedData {
+    domain: {
+        name: string;
+        version: string;
+        chainId: number;
+        verifyingContract: `0x${string}`;
+    };
+    types: {
+        AddContenderMessage: Array<{
+            name: string;
+            type: string;
+        }>;
+    };
+    primaryType: "AddContenderMessage";
+    message: {
+        proposalId: bigint;
+    };
+}
+/**
+ * Result of preparing a contender registration.
+ * The caller must first get the user's signature using the typedData,
+ * then submit the transaction.
+ */
+export interface PreparedContenderRegistration {
+    typedData: AddContenderTypedData;
+    buildTransaction: (signature: string) => PreparedTransaction;
+}
+/**
+ * Encode vote parameters for election castVoteWithReasonAndParams.
+ *
+ * Both NomineeElectionGovernor and MemberElectionGovernor use the same
+ * param encoding: abi.encode(address target, uint256 votes).
+ *
+ * @param target - Address of the contender/nominee to vote for
+ * @param votes - Vote amount in wei (full 18-decimal precision)
+ * @returns ABI-encoded bytes string
+ */
+export declare function encodeElectionVoteParams(target: string, votes: string | BigNumber): string;
+/**
+ * Decode vote parameters from election castVoteWithReasonAndParams.
+ *
+ * @param params - ABI-encoded bytes from castVoteWithReasonAndParams
+ * @returns Decoded target address and vote amount
+ */
+export declare function decodeElectionVoteParams(params: string): {
+    target: string;
+    votes: BigNumber;
+};
+/**
+ * Build EIP-712 typed data for contender registration signing.
+ *
+ * The nominee election governor requires an EIP-712 signature of
+ * AddContenderMessage(uint256 proposalId) to register as a contender.
+ *
+ * @param governorName - The name() of the nominee election governor
+ * @param proposalId - The nominee election proposal ID
+ * @param governorAddress - NomineeElectionGovernor contract address
+ * @param chainId - Chain ID (default: 42161 for Arbitrum One)
+ */
+export declare function getAddContenderTypedData(governorName: string, proposalId: string, governorAddress?: string, chainId?: number): AddContenderTypedData;
+/**
+ * Prepare the addContender transaction.
+ *
+ * @param proposalId - The nominee election proposal ID
+ * @param signature - The EIP-712 signature bytes
+ * @param governorAddress - NomineeElectionGovernor contract address
+ * @param chainId - Chain ID (default: 42161 for Arbitrum One)
+ */
+export declare function prepareAddContender(proposalId: string, signature: string, governorAddress?: string, chainId?: number): PreparedTransaction;
+/**
+ * Prepare contender registration with both typed data and transaction builder.
+ *
+ * Usage:
+ * 1. Get governorName from the contract (e.g., via provider)
+ * 2. Call prepareContenderRegistration(governorName, proposalId)
+ * 3. Have the user sign the typedData
+ * 4. Call result.buildTransaction(signature) to get the PreparedTransaction
+ *
+ * @param governorName - The name() of the nominee election governor
+ * @param proposalId - The nominee election proposal ID
+ * @param governorAddress - NomineeElectionGovernor contract address
+ * @param chainId - Chain ID (default: 42161 for Arbitrum One)
+ */
+export declare function prepareContenderRegistration(governorName: string, proposalId: string, governorAddress?: string, chainId?: number): PreparedContenderRegistration;
+/**
+ * Prepare a castVoteWithReasonAndParams transaction for a nominee election.
+ *
+ * Used during NOMINEE_SELECTION phase to vote for contenders.
+ *
+ * @param proposalId - The nominee election proposal ID
+ * @param target - Address of the contender to vote for
+ * @param votes - Vote amount in wei
+ * @param reason - Optional vote reason (default: "")
+ * @param governorAddress - NomineeElectionGovernor contract address
+ * @param chainId - Chain ID (default: 42161)
+ */
+export declare function prepareNomineeElectionVote(proposalId: string, target: string, votes: string | BigNumber, reason?: string, governorAddress?: string, chainId?: number): PreparedTransaction;
+/**
+ * Prepare a castVoteWithReasonAndParams transaction for a member election.
+ *
+ * Used during MEMBER_ELECTION phase to vote for nominees.
+ *
+ * @param proposalId - The member election proposal ID
+ * @param target - Address of the nominee to vote for
+ * @param votes - Vote amount in wei
+ * @param reason - Optional vote reason (default: "")
+ * @param governorAddress - MemberElectionGovernor contract address
+ * @param chainId - Chain ID (default: 42161)
+ */
+export declare function prepareMemberElectionVote(proposalId: string, target: string, votes: string | BigNumber, reason?: string, governorAddress?: string, chainId?: number): PreparedTransaction;
+//# sourceMappingURL=write.d.ts.map

package/dist/election/write.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"write.d.ts","sourceRoot":"","sources":["../../src/election/write.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAU,SAAS,EAAE,MAAM,QAAQ,CAAC;AAG3C,OAAO,EAAE,mBAAmB,EAAkB,MAAM,UAAU,CAAC;AAS/D;;;;;;;;GAQG;AACH,MAAM,WAAW,qBAAqB;IACpC,MAAM,EAAE;QACN,IAAI,EAAE,MAAM,CAAC;QACb,OAAO,EAAE,MAAM,CAAC;QAChB,OAAO,EAAE,MAAM,CAAC;QAChB,iBAAiB,EAAE,KAAK,MAAM,EAAE,CAAC;KAClC,CAAC;IACF,KAAK,EAAE;QACL,mBAAmB,EAAE,KAAK,CAAC;YAAE,IAAI,EAAE,MAAM,CAAC;YAAC,IAAI,EAAE,MAAM,CAAA;SAAE,CAAC,CAAC;KAC5D,CAAC;IACF,WAAW,EAAE,qBAAqB,CAAC;IACnC,OAAO,EAAE;QACP,UAAU,EAAE,MAAM,CAAC;KACpB,CAAC;CACH;AAED;;;;GAIG;AACH,MAAM,WAAW,6BAA6B;IAC5C,SAAS,EAAE,qBAAqB,CAAC;IACjC,gBAAgB,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,mBAAmB,CAAC;CAC9D;AAMD;;;;;;;;;GASG;AACH,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,CAM1F;AAED;;;;;GAKG;AACH,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,MAAM,GAAG;IACxD,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,SAAS,CAAC;CAClB,CAGA;AAMD;;;;;;;;;;GAUG;AACH,wBAAgB,wBAAwB,CACtC,YAAY,EAAE,MAAM,EACpB,UAAU,EAAE,MAAM,EAClB,eAAe,GAAE,MAA4C,EAC7D,OAAO,GAAE,MAA0B,GAClC,qBAAqB,CAgBvB;AAED;;;;;;;GAOG;AACH,wBAAgB,mBAAmB,CACjC,UAAU,EAAE,MAAM,EAClB,SAAS,EAAE,MAAM,EACjB,eAAe,GAAE,MAA4C,EAC7D,OAAO,GAAE,MAA0B,GAClC,mBAAmB,CAgBrB;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,4BAA4B,CAC1C,YAAY,EAAE,MAAM,EACpB,UAAU,EAAE,MAAM,EAClB,eAAe,GAAE,MAA4C,EAC7D,OAAO,GAAE,MAA0B,GAClC,6BAA6B,CAQ/B;AAMD;;;;;;;;;;;GAWG;AACH,wBAAgB,0BAA0B,CACxC,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,MAAM,GAAG,SAAS,EACzB,MAAM,GAAE,MAAW,EACnB,eAAe,GAAE,MAA4C,EAC7D,OAAO,GAAE,MAA0B,GAClC,mBAAmB,CAiBrB;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,yBAAyB,CACvC,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,MAAM,GAAG,SAAS,EACzB,MAAM,GAAE,MAAW,EACnB,eAAe,GAAE,MAA2C,EAC5D,OAAO,GAAE,MAA0B,GAClC,mBAAmB,CAiBrB"}

package/dist/election/write.js

@@ -0,0 +1,184 @@
+"use strict";
+/**
+ * Election write action preparation
+ *
+ * Prepares transactions and typed data for election participation:
+ * - Contender registration (EIP-712 sign → addContender)
+ * - Vote casting (castVoteWithReasonAndParams with encoded params)
+ *
+ * Following the SDK's prepare-only philosophy: this module builds
+ * transaction data and typed data structures, but never executes.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.encodeElectionVoteParams = encodeElectionVoteParams;
+exports.decodeElectionVoteParams = decodeElectionVoteParams;
+exports.getAddContenderTypedData = getAddContenderTypedData;
+exports.prepareAddContender = prepareAddContender;
+exports.prepareContenderRegistration = prepareContenderRegistration;
+exports.prepareNomineeElectionVote = prepareNomineeElectionVote;
+exports.prepareMemberElectionVote = prepareMemberElectionVote;
+const ethers_1 = require("ethers");
+const constants_1 = require("../constants");
+const abis_1 = require("../abis");
+const types_1 = require("../types");
+const logger_1 = require("../utils/logger");
+const log = logger_1.loggers.election;
+// ============================================================================
+// Vote Parameter Encoding
+// ============================================================================
+/**
+ * Encode vote parameters for election castVoteWithReasonAndParams.
+ *
+ * Both NomineeElectionGovernor and MemberElectionGovernor use the same
+ * param encoding: abi.encode(address target, uint256 votes).
+ *
+ * @param target - Address of the contender/nominee to vote for
+ * @param votes - Vote amount in wei (full 18-decimal precision)
+ * @returns ABI-encoded bytes string
+ */
+function encodeElectionVoteParams(target, votes) {
+    if (!ethers_1.ethers.utils.isAddress(target)) {
+        throw new Error(`Invalid target address: ${target}`);
+    }
+    const votesBN = ethers_1.BigNumber.isBigNumber(votes) ? votes : ethers_1.BigNumber.from(votes);
+    return ethers_1.ethers.utils.defaultAbiCoder.encode(["address", "uint256"], [target, votesBN]);
+}
+/**
+ * Decode vote parameters from election castVoteWithReasonAndParams.
+ *
+ * @param params - ABI-encoded bytes from castVoteWithReasonAndParams
+ * @returns Decoded target address and vote amount
+ */
+function decodeElectionVoteParams(params) {
+    const [target, votes] = ethers_1.ethers.utils.defaultAbiCoder.decode(["address", "uint256"], params);
+    return { target: target, votes: votes };
+}
+// ============================================================================
+// Contender Registration
+// ============================================================================
+/**
+ * Build EIP-712 typed data for contender registration signing.
+ *
+ * The nominee election governor requires an EIP-712 signature of
+ * AddContenderMessage(uint256 proposalId) to register as a contender.
+ *
+ * @param governorName - The name() of the nominee election governor
+ * @param proposalId - The nominee election proposal ID
+ * @param governorAddress - NomineeElectionGovernor contract address
+ * @param chainId - Chain ID (default: 42161 for Arbitrum One)
+ */
+function getAddContenderTypedData(governorName, proposalId, governorAddress = constants_1.ADDRESSES.ELECTION_NOMINEE_GOVERNOR, chainId = constants_1.CHAIN_IDS.ARB_ONE) {
+    return {
+        domain: {
+            name: governorName,
+            version: "1",
+            chainId,
+            verifyingContract: ethers_1.ethers.utils.getAddress(governorAddress),
+        },
+        types: {
+            AddContenderMessage: [{ name: "proposalId", type: "uint256" }],
+        },
+        primaryType: "AddContenderMessage",
+        message: {
+            proposalId: BigInt(proposalId),
+        },
+    };
+}
+/**
+ * Prepare the addContender transaction.
+ *
+ * @param proposalId - The nominee election proposal ID
+ * @param signature - The EIP-712 signature bytes
+ * @param governorAddress - NomineeElectionGovernor contract address
+ * @param chainId - Chain ID (default: 42161 for Arbitrum One)
+ */
+function prepareAddContender(proposalId, signature, governorAddress = constants_1.ADDRESSES.ELECTION_NOMINEE_GOVERNOR, chainId = constants_1.CHAIN_IDS.ARB_ONE) {
+    log("prepareAddContender for proposal %s", proposalId);
+    const calldata = abis_1.nomineeElectionGovernorInterface.encodeFunctionData("addContender", [
+        ethers_1.BigNumber.from(proposalId),
+        signature,
+    ]);
+    return {
+        to: ethers_1.ethers.utils.getAddress(governorAddress),
+        data: calldata,
+        value: "0",
+        chain: (0, types_1.chainIdToChain)(chainId),
+        chainId,
+        description: `addContender(${proposalId}) on NomineeElectionGovernor`,
+    };
+}
+/**
+ * Prepare contender registration with both typed data and transaction builder.
+ *
+ * Usage:
+ * 1. Get governorName from the contract (e.g., via provider)
+ * 2. Call prepareContenderRegistration(governorName, proposalId)
+ * 3. Have the user sign the typedData
+ * 4. Call result.buildTransaction(signature) to get the PreparedTransaction
+ *
+ * @param governorName - The name() of the nominee election governor
+ * @param proposalId - The nominee election proposal ID
+ * @param governorAddress - NomineeElectionGovernor contract address
+ * @param chainId - Chain ID (default: 42161 for Arbitrum One)
+ */
+function prepareContenderRegistration(governorName, proposalId, governorAddress = constants_1.ADDRESSES.ELECTION_NOMINEE_GOVERNOR, chainId = constants_1.CHAIN_IDS.ARB_ONE) {
+    log("prepareContenderRegistration for proposal %s", proposalId);
+    return {
+        typedData: getAddContenderTypedData(governorName, proposalId, governorAddress, chainId),
+        buildTransaction: (signature) => prepareAddContender(proposalId, signature, governorAddress, chainId),
+    };
+}
+// ============================================================================
+// Vote Casting
+// ============================================================================
+/**
+ * Prepare a castVoteWithReasonAndParams transaction for a nominee election.
+ *
+ * Used during NOMINEE_SELECTION phase to vote for contenders.
+ *
+ * @param proposalId - The nominee election proposal ID
+ * @param target - Address of the contender to vote for
+ * @param votes - Vote amount in wei
+ * @param reason - Optional vote reason (default: "")
+ * @param governorAddress - NomineeElectionGovernor contract address
+ * @param chainId - Chain ID (default: 42161)
+ */
+function prepareNomineeElectionVote(proposalId, target, votes, reason = "", governorAddress = constants_1.ADDRESSES.ELECTION_NOMINEE_GOVERNOR, chainId = constants_1.CHAIN_IDS.ARB_ONE) {
+    log("prepareNomineeElectionVote for proposal %s, target %s", proposalId, target);
+    const params = encodeElectionVoteParams(target, votes);
+    const calldata = abis_1.nomineeElectionGovernorInterface.encodeFunctionData("castVoteWithReasonAndParams", [ethers_1.BigNumber.from(proposalId), 1, reason, params]);
+    return {
+        to: ethers_1.ethers.utils.getAddress(governorAddress),
+        data: calldata,
+        value: "0",
+        chain: (0, types_1.chainIdToChain)(chainId),
+        chainId,
+        description: `castVoteWithReasonAndParams on NomineeElectionGovernor for ${target}`,
+    };
+}
+/**
+ * Prepare a castVoteWithReasonAndParams transaction for a member election.
+ *
+ * Used during MEMBER_ELECTION phase to vote for nominees.
+ *
+ * @param proposalId - The member election proposal ID
+ * @param target - Address of the nominee to vote for
+ * @param votes - Vote amount in wei
+ * @param reason - Optional vote reason (default: "")
+ * @param governorAddress - MemberElectionGovernor contract address
+ * @param chainId - Chain ID (default: 42161)
+ */
+function prepareMemberElectionVote(proposalId, target, votes, reason = "", governorAddress = constants_1.ADDRESSES.ELECTION_MEMBER_GOVERNOR, chainId = constants_1.CHAIN_IDS.ARB_ONE) {
+    log("prepareMemberElectionVote for proposal %s, target %s", proposalId, target);
+    const params = encodeElectionVoteParams(target, votes);
+    const calldata = abis_1.memberElectionGovernorInterface.encodeFunctionData("castVoteWithReasonAndParams", [ethers_1.BigNumber.from(proposalId), 1, reason, params]);
+    return {
+        to: ethers_1.ethers.utils.getAddress(governorAddress),
+        data: calldata,
+        value: "0",
+        chain: (0, types_1.chainIdToChain)(chainId),
+        chainId,
+        description: `castVoteWithReasonAndParams on MemberElectionGovernor for ${target}`,
+    };
+}
+//# sourceMappingURL=write.js.map

package/dist/election/write.js.map

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

package/dist/governance/index.d.ts

@@ -0,0 +1,5 @@
+export { prepareCastVote, prepareCastVoteWithReason, prepareCastVoteWithReasonAndParams, } from "./write";
+export type { GovernorTarget } from "./write";
+export { readProposalState, readProposalVotes, readProposalSnapshot, readProposalDeadline, readQuorum, readVotingPower, readGetVotes, readHasVoted, readCurrentVotingPower, readDelegate, readNomineeElectionState, readMemberElectionState, readElectionCount, readVotesUsed, readIsContender, readGovernorName, } from "./read";
+export type { ReadContractParameters } from "./read";
+//# sourceMappingURL=index.d.ts.map

package/dist/governance/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/governance/index.ts"],"names":[],"mappings":"AAIA,OAAO,EACL,eAAe,EACf,yBAAyB,EACzB,kCAAkC,GACnC,MAAM,SAAS,CAAC;AACjB,YAAY,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAE9C,OAAO,EACL,iBAAiB,EACjB,iBAAiB,EACjB,oBAAoB,EACpB,oBAAoB,EACpB,UAAU,EACV,eAAe,EACf,YAAY,EACZ,YAAY,EACZ,sBAAsB,EACtB,YAAY,EACZ,wBAAwB,EACxB,uBAAuB,EACvB,iBAAiB,EACjB,aAAa,EACb,eAAe,EACf,gBAAgB,GACjB,MAAM,QAAQ,CAAC;AAChB,YAAY,EAAE,sBAAsB,EAAE,MAAM,QAAQ,CAAC"}

package/dist/governance/index.js

@@ -0,0 +1,28 @@
+"use strict";
+// ============================================================================
+// Governance Module Public API
+// ============================================================================
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.readGovernorName = exports.readIsContender = exports.readVotesUsed = exports.readElectionCount = exports.readMemberElectionState = exports.readNomineeElectionState = exports.readDelegate = exports.readCurrentVotingPower = exports.readHasVoted = exports.readGetVotes = exports.readVotingPower = exports.readQuorum = exports.readProposalDeadline = exports.readProposalSnapshot = exports.readProposalVotes = exports.readProposalState = exports.prepareCastVoteWithReasonAndParams = exports.prepareCastVoteWithReason = exports.prepareCastVote = void 0;
+var write_1 = require("./write");
+Object.defineProperty(exports, "prepareCastVote", { enumerable: true, get: function () { return write_1.prepareCastVote; } });
+Object.defineProperty(exports, "prepareCastVoteWithReason", { enumerable: true, get: function () { return write_1.prepareCastVoteWithReason; } });
+Object.defineProperty(exports, "prepareCastVoteWithReasonAndParams", { enumerable: true, get: function () { return write_1.prepareCastVoteWithReasonAndParams; } });
+var read_1 = require("./read");
+Object.defineProperty(exports, "readProposalState", { enumerable: true, get: function () { return read_1.readProposalState; } });
+Object.defineProperty(exports, "readProposalVotes", { enumerable: true, get: function () { return read_1.readProposalVotes; } });
+Object.defineProperty(exports, "readProposalSnapshot", { enumerable: true, get: function () { return read_1.readProposalSnapshot; } });
+Object.defineProperty(exports, "readProposalDeadline", { enumerable: true, get: function () { return read_1.readProposalDeadline; } });
+Object.defineProperty(exports, "readQuorum", { enumerable: true, get: function () { return read_1.readQuorum; } });
+Object.defineProperty(exports, "readVotingPower", { enumerable: true, get: function () { return read_1.readVotingPower; } });
+Object.defineProperty(exports, "readGetVotes", { enumerable: true, get: function () { return read_1.readGetVotes; } });
+Object.defineProperty(exports, "readHasVoted", { enumerable: true, get: function () { return read_1.readHasVoted; } });
+Object.defineProperty(exports, "readCurrentVotingPower", { enumerable: true, get: function () { return read_1.readCurrentVotingPower; } });
+Object.defineProperty(exports, "readDelegate", { enumerable: true, get: function () { return read_1.readDelegate; } });
+Object.defineProperty(exports, "readNomineeElectionState", { enumerable: true, get: function () { return read_1.readNomineeElectionState; } });
+Object.defineProperty(exports, "readMemberElectionState", { enumerable: true, get: function () { return read_1.readMemberElectionState; } });
+Object.defineProperty(exports, "readElectionCount", { enumerable: true, get: function () { return read_1.readElectionCount; } });
+Object.defineProperty(exports, "readVotesUsed", { enumerable: true, get: function () { return read_1.readVotesUsed; } });
+Object.defineProperty(exports, "readIsContender", { enumerable: true, get: function () { return read_1.readIsContender; } });
+Object.defineProperty(exports, "readGovernorName", { enumerable: true, get: function () { return read_1.readGovernorName; } });
+//# sourceMappingURL=index.js.map

package/dist/governance/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/governance/index.ts"],"names":[],"mappings":";AAAA,+EAA+E;AAC/E,+BAA+B;AAC/B,+EAA+E;;;AAE/E,iCAIiB;AAHf,wGAAA,eAAe,OAAA;AACf,kHAAA,yBAAyB,OAAA;AACzB,2HAAA,kCAAkC,OAAA;AAIpC,+BAiBgB;AAhBd,yGAAA,iBAAiB,OAAA;AACjB,yGAAA,iBAAiB,OAAA;AACjB,4GAAA,oBAAoB,OAAA;AACpB,4GAAA,oBAAoB,OAAA;AACpB,kGAAA,UAAU,OAAA;AACV,uGAAA,eAAe,OAAA;AACf,oGAAA,YAAY,OAAA;AACZ,oGAAA,YAAY,OAAA;AACZ,8GAAA,sBAAsB,OAAA;AACtB,oGAAA,YAAY,OAAA;AACZ,gHAAA,wBAAwB,OAAA;AACxB,+GAAA,uBAAuB,OAAA;AACvB,yGAAA,iBAAiB,OAAA;AACjB,qGAAA,aAAa,OAAA;AACb,uGAAA,eAAe,OAAA;AACf,wGAAA,gBAAgB,OAAA"}