@gzeoneth/gov-tracker 0.4.0-beta.fb8713f → 0.5.0

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":";AAAA;;;;;;;;;GASG;;AA+DH,4DAMC;AAQD,4DAMC;AAiBD,4DAqBC;AAUD,kDAqBC;AAgBD,oEAaC;AAkBD,gEAwBC;AAcD,8DAwBC;AAnQD,mCAA2C;AAC3C,4CAAoD;AACpD,kCAA4F;AAC5F,oCAA+D;AAC/D,4CAA0C;AAE1C,MAAM,GAAG,GAAG,gBAAO,CAAC,QAAQ,CAAC;AAyC7B,+EAA+E;AAC/E,0BAA0B;AAC1B,+EAA+E;AAE/E;;;;;;;;;GASG;AACH,SAAgB,wBAAwB,CAAC,MAAc,EAAE,KAAyB;IAChF,IAAI,CAAC,eAAM,CAAC,KAAK,CAAC,SAAS,CAAC,MAAM,CAAC,EAAE,CAAC;QACpC,MAAM,IAAI,KAAK,CAAC,2BAA2B,MAAM,EAAE,CAAC,CAAC;IACvD,CAAC;IACD,MAAM,OAAO,GAAG,kBAAS,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,kBAAS,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAC7E,OAAO,eAAM,CAAC,KAAK,CAAC,eAAe,CAAC,MAAM,CAAC,CAAC,SAAS,EAAE,SAAS,CAAC,EAAE,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;AACxF,CAAC;AAED;;;;;GAKG;AACH,SAAgB,wBAAwB,CAAC,MAAc;IAIrD,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,GAAG,eAAM,CAAC,KAAK,CAAC,eAAe,CAAC,MAAM,CAAC,CAAC,SAAS,EAAE,SAAS,CAAC,EAAE,MAAM,CAAC,CAAC;IAC5F,OAAO,EAAE,MAAM,EAAE,MAAgB,EAAE,KAAK,EAAE,KAAkB,EAAE,CAAC;AACjE,CAAC;AAED,+EAA+E;AAC/E,yBAAyB;AACzB,+EAA+E;AAE/E;;;;;;;;;;GAUG;AACH,SAAgB,wBAAwB,CACtC,YAAoB,EACpB,UAAkB,EAClB,kBAA0B,qBAAS,CAAC,yBAAyB,EAC7D,UAAkB,qBAAS,CAAC,OAAO;IAEnC,OAAO;QACL,MAAM,EAAE;YACN,IAAI,EAAE,YAAY;YAClB,OAAO,EAAE,GAAG;YACZ,OAAO;YACP,iBAAiB,EAAE,eAAM,CAAC,KAAK,CAAC,UAAU,CAAC,eAAe,CAAkB;SAC7E;QACD,KAAK,EAAE;YACL,mBAAmB,EAAE,CAAC,EAAE,IAAI,EAAE,YAAY,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC;SAC/D;QACD,WAAW,EAAE,qBAAqB;QAClC,OAAO,EAAE;YACP,UAAU,EAAE,MAAM,CAAC,UAAU,CAAC;SAC/B;KACF,CAAC;AACJ,CAAC;AAED;;;;;;;GAOG;AACH,SAAgB,mBAAmB,CACjC,UAAkB,EAClB,SAAiB,EACjB,kBAA0B,qBAAS,CAAC,yBAAyB,EAC7D,UAAkB,qBAAS,CAAC,OAAO;IAEnC,GAAG,CAAC,qCAAqC,EAAE,UAAU,CAAC,CAAC;IAEvD,MAAM,QAAQ,GAAG,uCAAgC,CAAC,kBAAkB,CAAC,cAAc,EAAE;QACnF,kBAAS,CAAC,IAAI,CAAC,UAAU,CAAC;QAC1B,SAAS;KACV,CAAC,CAAC;IAEH,OAAO;QACL,EAAE,EAAE,eAAM,CAAC,KAAK,CAAC,UAAU,CAAC,eAAe,CAAkB;QAC7D,IAAI,EAAE,QAAyB;QAC/B,KAAK,EAAE,GAAG;QACV,KAAK,EAAE,IAAA,sBAAc,EAAC,OAAO,CAAC;QAC9B,OAAO;QACP,WAAW,EAAE,gBAAgB,UAAU,8BAA8B;KACtE,CAAC;AACJ,CAAC;AAED;;;;;;;;;;;;;GAaG;AACH,SAAgB,4BAA4B,CAC1C,YAAoB,EACpB,UAAkB,EAClB,kBAA0B,qBAAS,CAAC,yBAAyB,EAC7D,UAAkB,qBAAS,CAAC,OAAO;IAEnC,GAAG,CAAC,8CAA8C,EAAE,UAAU,CAAC,CAAC;IAEhE,OAAO;QACL,SAAS,EAAE,wBAAwB,CAAC,YAAY,EAAE,UAAU,EAAE,eAAe,EAAE,OAAO,CAAC;QACvF,gBAAgB,EAAE,CAAC,SAAiB,EAAE,EAAE,CACtC,mBAAmB,CAAC,UAAU,EAAE,SAAS,EAAE,eAAe,EAAE,OAAO,CAAC;KACvE,CAAC;AACJ,CAAC;AAED,+EAA+E;AAC/E,eAAe;AACf,+EAA+E;AAE/E;;;;;;;;;;;GAWG;AACH,SAAgB,0BAA0B,CACxC,UAAkB,EAClB,MAAc,EACd,KAAyB,EACzB,SAAiB,EAAE,EACnB,kBAA0B,qBAAS,CAAC,yBAAyB,EAC7D,UAAkB,qBAAS,CAAC,OAAO;IAEnC,GAAG,CAAC,uDAAuD,EAAE,UAAU,EAAE,MAAM,CAAC,CAAC;IAEjF,MAAM,MAAM,GAAG,wBAAwB,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;IACvD,MAAM,QAAQ,GAAG,uCAAgC,CAAC,kBAAkB,CAClE,6BAA6B,EAC7B,CAAC,kBAAS,CAAC,IAAI,CAAC,UAAU,CAAC,EAAE,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,CAChD,CAAC;IAEF,OAAO;QACL,EAAE,EAAE,eAAM,CAAC,KAAK,CAAC,UAAU,CAAC,eAAe,CAAkB;QAC7D,IAAI,EAAE,QAAyB;QAC/B,KAAK,EAAE,GAAG;QACV,KAAK,EAAE,IAAA,sBAAc,EAAC,OAAO,CAAC;QAC9B,OAAO;QACP,WAAW,EAAE,8DAA8D,MAAM,EAAE;KACpF,CAAC;AACJ,CAAC;AAED;;;;;;;;;;;GAWG;AACH,SAAgB,yBAAyB,CACvC,UAAkB,EAClB,MAAc,EACd,KAAyB,EACzB,SAAiB,EAAE,EACnB,kBAA0B,qBAAS,CAAC,wBAAwB,EAC5D,UAAkB,qBAAS,CAAC,OAAO;IAEnC,GAAG,CAAC,sDAAsD,EAAE,UAAU,EAAE,MAAM,CAAC,CAAC;IAEhF,MAAM,MAAM,GAAG,wBAAwB,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;IACvD,MAAM,QAAQ,GAAG,sCAA+B,CAAC,kBAAkB,CACjE,6BAA6B,EAC7B,CAAC,kBAAS,CAAC,IAAI,CAAC,UAAU,CAAC,EAAE,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,CAChD,CAAC;IAEF,OAAO;QACL,EAAE,EAAE,eAAM,CAAC,KAAK,CAAC,UAAU,CAAC,eAAe,CAAkB;QAC7D,IAAI,EAAE,QAAyB;QAC/B,KAAK,EAAE,GAAG;QACV,KAAK,EAAE,IAAA,sBAAc,EAAC,OAAO,CAAC;QAC9B,OAAO;QACP,WAAW,EAAE,6DAA6D,MAAM,EAAE;KACnF,CAAC;AACJ,CAAC"}

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"}

package/dist/governance/read.d.ts

@@ -0,0 +1,50 @@
+/**
+ * Governance read helpers for wagmi/viem consumers.
+ *
+ * Each function returns a plain object compatible with wagmi's
+ * `useReadContract` and `useReadContracts` (multicall) hooks:
+ *
+ * @example Single read
+ * ```typescript
+ * import { readProposalState } from "@gzeoneth/gov-tracker";
+ * const { data } = useReadContract(readProposalState(proposalId));
+ * ```
+ *
+ * @example Batched reads (multicall)
+ * ```typescript
+ * const { data } = useReadContracts({
+ *   contracts: delegates.map(d => readVotingPower(d, snapshotBlock)),
+ * });
+ * ```
+ */
+import type { GovernorTarget } from "./write";
+/**
+ * Shape compatible with wagmi's useReadContract parameters.
+ * Consumers pass this directly: `useReadContract(readProposalState(id))`.
+ */
+export interface ReadContractParameters {
+    address: `0x${string}`;
+    abi: readonly Record<string, unknown>[];
+    functionName: string;
+    args: readonly unknown[];
+    chainId?: number;
+}
+type GovernorAddress = GovernorTarget | `0x${string}`;
+export declare function readProposalState(proposalId: bigint | string, governor?: GovernorAddress, chainId?: number): ReadContractParameters;
+export declare function readProposalVotes(proposalId: bigint | string, governor?: GovernorAddress, chainId?: number): ReadContractParameters;
+export declare function readProposalSnapshot(proposalId: bigint | string, governor?: GovernorAddress, chainId?: number): ReadContractParameters;
+export declare function readProposalDeadline(proposalId: bigint | string, governor?: GovernorAddress, chainId?: number): ReadContractParameters;
+export declare function readQuorum(blockNumber: bigint | number, governor?: GovernorAddress, chainId?: number): ReadContractParameters;
+export declare function readVotingPower(account: `0x${string}` | string, blockNumber: bigint | number, tokenAddress?: `0x${string}` | string, chainId?: number): ReadContractParameters;
+export declare function readGetVotes(account: `0x${string}` | string, blockNumber: bigint | number, governor?: GovernorAddress, chainId?: number): ReadContractParameters;
+export declare function readHasVoted(proposalId: bigint | string, account: `0x${string}` | string, governor?: GovernorAddress, chainId?: number): ReadContractParameters;
+export declare function readCurrentVotingPower(account: `0x${string}` | string, tokenAddress?: `0x${string}` | string, chainId?: number): ReadContractParameters;
+export declare function readDelegate(account: `0x${string}` | string, tokenAddress?: `0x${string}` | string, chainId?: number): ReadContractParameters;
+export declare function readNomineeElectionState(proposalId: bigint | string, governorAddress?: `0x${string}` | string, chainId?: number): ReadContractParameters;
+export declare function readMemberElectionState(proposalId: bigint | string, governorAddress?: `0x${string}` | string, chainId?: number): ReadContractParameters;
+export declare function readElectionCount(governorAddress?: `0x${string}` | string, chainId?: number): ReadContractParameters;
+export declare function readVotesUsed(proposalId: bigint | string, account: `0x${string}` | string, governorAddress?: `0x${string}` | string, chainId?: number): ReadContractParameters;
+export declare function readIsContender(proposalId: bigint | string, account: `0x${string}` | string, governorAddress?: `0x${string}` | string, chainId?: number): ReadContractParameters;
+export declare function readGovernorName(governorAddress?: `0x${string}` | string, chainId?: number): ReadContractParameters;
+export {};
+//# sourceMappingURL=read.d.ts.map

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

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

package/dist/governance/read.js

@@ -0,0 +1,194 @@
+"use strict";
+/**
+ * Governance read helpers for wagmi/viem consumers.
+ *
+ * Each function returns a plain object compatible with wagmi's
+ * `useReadContract` and `useReadContracts` (multicall) hooks:
+ *
+ * @example Single read
+ * ```typescript
+ * import { readProposalState } from "@gzeoneth/gov-tracker";
+ * const { data } = useReadContract(readProposalState(proposalId));
+ * ```
+ *
+ * @example Batched reads (multicall)
+ * ```typescript
+ * const { data } = useReadContracts({
+ *   contracts: delegates.map(d => readVotingPower(d, snapshotBlock)),
+ * });
+ * ```
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.readProposalState = readProposalState;
+exports.readProposalVotes = readProposalVotes;
+exports.readProposalSnapshot = readProposalSnapshot;
+exports.readProposalDeadline = readProposalDeadline;
+exports.readQuorum = readQuorum;
+exports.readVotingPower = readVotingPower;
+exports.readGetVotes = readGetVotes;
+exports.readHasVoted = readHasVoted;
+exports.readCurrentVotingPower = readCurrentVotingPower;
+exports.readDelegate = readDelegate;
+exports.readNomineeElectionState = readNomineeElectionState;
+exports.readMemberElectionState = readMemberElectionState;
+exports.readElectionCount = readElectionCount;
+exports.readVotesUsed = readVotesUsed;
+exports.readIsContender = readIsContender;
+exports.readGovernorName = readGovernorName;
+const constants_1 = require("../constants");
+const abis_json_1 = require("../abis-json");
+const write_1 = require("./write");
+// ============================================================================
+// Governor reads
+// ============================================================================
+function readProposalState(proposalId, governor, chainId = constants_1.CHAIN_IDS.ARB_ONE) {
+    return {
+        address: (0, write_1.resolveGovernorAddress)(governor),
+        abi: abis_json_1.governorReadAbi,
+        functionName: "state",
+        args: [BigInt(proposalId)],
+        chainId,
+    };
+}
+function readProposalVotes(proposalId, governor, chainId = constants_1.CHAIN_IDS.ARB_ONE) {
+    return {
+        address: (0, write_1.resolveGovernorAddress)(governor),
+        abi: abis_json_1.governorReadAbi,
+        functionName: "proposalVotes",
+        args: [BigInt(proposalId)],
+        chainId,
+    };
+}
+function readProposalSnapshot(proposalId, governor, chainId = constants_1.CHAIN_IDS.ARB_ONE) {
+    return {
+        address: (0, write_1.resolveGovernorAddress)(governor),
+        abi: abis_json_1.governorReadAbi,
+        functionName: "proposalSnapshot",
+        args: [BigInt(proposalId)],
+        chainId,
+    };
+}
+function readProposalDeadline(proposalId, governor, chainId = constants_1.CHAIN_IDS.ARB_ONE) {
+    return {
+        address: (0, write_1.resolveGovernorAddress)(governor),
+        abi: abis_json_1.governorReadAbi,
+        functionName: "proposalDeadline",
+        args: [BigInt(proposalId)],
+        chainId,
+    };
+}
+function readQuorum(blockNumber, governor, chainId = constants_1.CHAIN_IDS.ARB_ONE) {
+    return {
+        address: (0, write_1.resolveGovernorAddress)(governor),
+        abi: abis_json_1.governorReadAbi,
+        functionName: "quorum",
+        args: [BigInt(blockNumber)],
+        chainId,
+    };
+}
+// ============================================================================
+// Token / voting power reads
+// ============================================================================
+function readVotingPower(account, blockNumber, tokenAddress = constants_1.ADDRESSES.ARB_TOKEN, chainId = constants_1.CHAIN_IDS.ARB_ONE) {
+    return {
+        address: tokenAddress,
+        abi: abis_json_1.erc20VotesAbi,
+        functionName: "getPastVotes",
+        args: [account, BigInt(blockNumber)],
+        chainId,
+    };
+}
+function readGetVotes(account, blockNumber, governor, chainId = constants_1.CHAIN_IDS.ARB_ONE) {
+    return {
+        address: (0, write_1.resolveGovernorAddress)(governor),
+        abi: abis_json_1.governorReadAbi,
+        functionName: "getVotes",
+        args: [account, BigInt(blockNumber)],
+        chainId,
+    };
+}
+function readHasVoted(proposalId, account, governor, chainId = constants_1.CHAIN_IDS.ARB_ONE) {
+    return {
+        address: (0, write_1.resolveGovernorAddress)(governor),
+        abi: abis_json_1.governorReadAbi,
+        functionName: "hasVoted",
+        args: [BigInt(proposalId), account],
+        chainId,
+    };
+}
+function readCurrentVotingPower(account, tokenAddress = constants_1.ADDRESSES.ARB_TOKEN, chainId = constants_1.CHAIN_IDS.ARB_ONE) {
+    return {
+        address: tokenAddress,
+        abi: abis_json_1.erc20VotesAbi,
+        functionName: "getVotes",
+        args: [account],
+        chainId,
+    };
+}
+function readDelegate(account, tokenAddress = constants_1.ADDRESSES.ARB_TOKEN, chainId = constants_1.CHAIN_IDS.ARB_ONE) {
+    return {
+        address: tokenAddress,
+        abi: abis_json_1.erc20VotesAbi,
+        functionName: "delegates",
+        args: [account],
+        chainId,
+    };
+}
+// ============================================================================
+// Election reads
+// ============================================================================
+function readNomineeElectionState(proposalId, governorAddress = constants_1.ADDRESSES.ELECTION_NOMINEE_GOVERNOR, chainId = constants_1.CHAIN_IDS.ARB_ONE) {
+    return {
+        address: governorAddress,
+        abi: abis_json_1.nomineeElectionGovernorReadAbi,
+        functionName: "state",
+        args: [BigInt(proposalId)],
+        chainId,
+    };
+}
+function readMemberElectionState(proposalId, governorAddress = constants_1.ADDRESSES.ELECTION_MEMBER_GOVERNOR, chainId = constants_1.CHAIN_IDS.ARB_ONE) {
+    return {
+        address: governorAddress,
+        abi: abis_json_1.memberElectionGovernorReadAbi,
+        functionName: "state",
+        args: [BigInt(proposalId)],
+        chainId,
+    };
+}
+function readElectionCount(governorAddress = constants_1.ADDRESSES.ELECTION_NOMINEE_GOVERNOR, chainId = constants_1.CHAIN_IDS.ARB_ONE) {
+    return {
+        address: governorAddress,
+        abi: abis_json_1.nomineeElectionGovernorReadAbi,
+        functionName: "electionCount",
+        args: [],
+        chainId,
+    };
+}
+function readVotesUsed(proposalId, account, governorAddress = constants_1.ADDRESSES.ELECTION_NOMINEE_GOVERNOR, chainId = constants_1.CHAIN_IDS.ARB_ONE) {
+    return {
+        address: governorAddress,
+        abi: abis_json_1.nomineeElectionGovernorReadAbi,
+        functionName: "votesUsed",
+        args: [BigInt(proposalId), account],
+        chainId,
+    };
+}
+function readIsContender(proposalId, account, governorAddress = constants_1.ADDRESSES.ELECTION_NOMINEE_GOVERNOR, chainId = constants_1.CHAIN_IDS.ARB_ONE) {
+    return {
+        address: governorAddress,
+        abi: abis_json_1.nomineeElectionGovernorReadAbi,
+        functionName: "isContender",
+        args: [BigInt(proposalId), account],
+        chainId,
+    };
+}
+function readGovernorName(governorAddress = constants_1.ADDRESSES.ELECTION_NOMINEE_GOVERNOR, chainId = constants_1.CHAIN_IDS.ARB_ONE) {
+    return {
+        address: governorAddress,
+        abi: abis_json_1.nomineeElectionGovernorReadAbi,
+        functionName: "name",
+        args: [],
+        chainId,
+    };
+}
+//# sourceMappingURL=read.js.map

package/dist/governance/read.js.map

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

package/dist/governance/write.d.ts

@@ -0,0 +1,54 @@
+/**
+ * Governance proposal vote preparation
+ *
+ * Prepares transactions for casting votes on Core Governor and Treasury
+ * Governor proposals. Following the SDK's prepare-only philosophy: builds
+ * transaction data but never executes.
+ *
+ * Supports all OpenZeppelin Governor voting methods:
+ * - castVote(proposalId, support)
+ * - castVoteWithReason(proposalId, support, reason)
+ * - castVoteWithReasonAndParams(proposalId, support, reason, params)
+ */
+import type { VoteSupport } from "../constants";
+import { PreparedTransaction } from "../types";
+export type GovernorTarget = "constitutional" | "non-constitutional";
+export declare function resolveGovernorAddress(governorAddressOrTarget?: GovernorTarget | string): `0x${string}`;
+/**
+ * Prepare a castVote transaction.
+ *
+ * Simplest voting method — just proposal ID and support value.
+ *
+ * @param proposalId - The proposal ID to vote on
+ * @param support - Vote support: 0 (Against), 1 (For), 2 (Abstain) — use VOTE_SUPPORT constants
+ * @param governorAddress - Governor contract address, or "constitutional"/"non-constitutional" shorthand
+ * @param chainId - Chain ID (default: 42161 for Arbitrum One)
+ */
+export declare function prepareCastVote(proposalId: string, support: VoteSupport, governorAddress?: GovernorTarget | string, chainId?: number): PreparedTransaction;
+/**
+ * Prepare a castVoteWithReason transaction.
+ *
+ * Same as castVote but includes an on-chain reason string.
+ *
+ * @param proposalId - The proposal ID to vote on
+ * @param support - Vote support: 0 (Against), 1 (For), 2 (Abstain)
+ * @param reason - On-chain reason for the vote
+ * @param governorAddress - Governor contract address or shorthand
+ * @param chainId - Chain ID (default: 42161)
+ */
+export declare function prepareCastVoteWithReason(proposalId: string, support: VoteSupport, reason: string, governorAddress?: GovernorTarget | string, chainId?: number): PreparedTransaction;
+/**
+ * Prepare a castVoteWithReasonAndParams transaction.
+ *
+ * Most flexible voting method — includes reason and arbitrary params bytes.
+ * Used by governors with custom counting modules.
+ *
+ * @param proposalId - The proposal ID to vote on
+ * @param support - Vote support: 0 (Against), 1 (For), 2 (Abstain)
+ * @param reason - On-chain reason for the vote
+ * @param params - ABI-encoded params bytes (interpretation depends on counting module)
+ * @param governorAddress - Governor contract address or shorthand
+ * @param chainId - Chain ID (default: 42161)
+ */
+export declare function prepareCastVoteWithReasonAndParams(proposalId: string, support: VoteSupport, reason: string, params: string, governorAddress?: GovernorTarget | string, chainId?: number): PreparedTransaction;
+//# sourceMappingURL=write.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"write.d.ts","sourceRoot":"","sources":["../../src/governance/write.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAIH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAEhD,OAAO,EAAE,mBAAmB,EAAkB,MAAM,UAAU,CAAC;AAS/D,MAAM,MAAM,cAAc,GAAG,gBAAgB,GAAG,oBAAoB,CAAC;AAMrE,wBAAgB,sBAAsB,CACpC,uBAAuB,CAAC,EAAE,cAAc,GAAG,MAAM,GAChD,KAAK,MAAM,EAAE,CAMf;AAYD;;;;;;;;;GASG;AACH,wBAAgB,eAAe,CAC7B,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,WAAW,EACpB,eAAe,CAAC,EAAE,cAAc,GAAG,MAAM,EACzC,OAAO,GAAE,MAA0B,GAClC,mBAAmB,CAiBrB;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,yBAAyB,CACvC,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,WAAW,EACpB,MAAM,EAAE,MAAM,EACd,eAAe,CAAC,EAAE,cAAc,GAAG,MAAM,EACzC,OAAO,GAAE,MAA0B,GAClC,mBAAmB,CAkBrB;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,kCAAkC,CAChD,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,WAAW,EACpB,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,MAAM,EACd,eAAe,CAAC,EAAE,cAAc,GAAG,MAAM,EACzC,OAAO,GAAE,MAA0B,GAClC,mBAAmB,CAmBrB"}