@raac/rpc 1.2.0-beta.1 → 1.2.0-beta.11

package/dist/contracts/governance/proposals/getVoteReceipt.js

@@ -0,0 +1,53 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getVoteReceipt = void 0;
+const ethers_1 = require("ethers");
+const chains_1 = __importDefault(require("../../../configs/chains"));
+const _helpers_1 = require("../_helpers");
+const artifacts_1 = require("../../../utils/artifacts");
+/**
+ * Gets an account's vote on a proposal: whether it voted, from `hasVoted`,
+ * and which side and weight, from its `VoteCast` event. Both event fields
+ * (`voter`, `proposalId`) are indexed, so the lookup is a filtered log query
+ * starting at the proposal's snapshot block, before which no vote can exist.
+ *
+ * @param chainId - The chain/network to use.
+ * @param governance - Address of the Governance contract.
+ * @param proposalId - The proposal ID.
+ * @param account - The voter address.
+ * @param fromBlock - First block to search for the event; pass the proposal's snapshot block.
+ * @param provider - Optional ethers.js Provider instance.
+ * @returns The receipt. `hasVoted` is authoritative; the event fields are null if the log query fails.
+ */
+const getVoteReceipt = async (chainId, governance, proposalId, account, fromBlock = 0, provider) => {
+    if (!provider) {
+        const rpc = chains_1.default[chainId].rpcs[0];
+        provider = new ethers_1.ethers.JsonRpcProvider(rpc);
+    }
+    const contract = new ethers_1.ethers.Contract((0, _helpers_1.requireAddress)(governance, "Governance"), (0, artifacts_1.getABI)("governance"), provider);
+    const voted = await contract.hasVoted(proposalId, account);
+    const empty = { hasVoted: voted, support: null, weight: null, transactionHash: null, blockNumber: null };
+    if (!voted)
+        return empty;
+    try {
+        const events = await contract.queryFilter(contract.filters.VoteCast(account, proposalId), Number(fromBlock), "latest");
+        const event = events[events.length - 1];
+        if (!event?.args)
+            return empty;
+        return {
+            hasVoted: true,
+            support: Boolean(event.args.support),
+            weight: ethers_1.ethers.formatEther(event.args.votingPower),
+            transactionHash: event.transactionHash,
+            blockNumber: event.blockNumber,
+        };
+    }
+    catch (error) {
+        console.error("Error reading VoteCast event:", error);
+        return empty;
+    }
+};
+exports.getVoteReceipt = getVoteReceipt;

package/dist/contracts/governance/proposals/getVotes.js

@@ -6,22 +6,23 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.getVotes = void 0;
 const ethers_1 = require("ethers");
 const chains_1 = __importDefault(require("../../../configs/chains"));
-const getContractAddress_1 = require("../../getContractAddress");
+const _helpers_1 = require("../_helpers");
 const artifacts_1 = require("../../../utils/artifacts");
 /**
  * Gets vote counts for a proposal.
  *
  * @param chainId - The chain/network to use.
+ * @param governance - Address of the Governance contract.
  * @param proposalId - The ID of the proposal to query.
  * @param provider - Optional ethers.js Provider instance.
  * @returns The for and against vote totals formatted in ether units.
  */
-const getVotes = async (chainId, proposalId, provider) => {
+const getVotes = async (chainId, governance, proposalId, provider) => {
     if (!provider) {
         const rpc = chains_1.default[chainId].rpcs[0];
         provider = new ethers_1.ethers.JsonRpcProvider(rpc);
     }
-    const contractAddress = (0, getContractAddress_1.getContractAddress)(chainId, "governance");
+    const contractAddress = (0, _helpers_1.requireAddress)(governance, "Governance");
     const abi = (0, artifacts_1.getABI)("governance");
     const contract = new ethers_1.ethers.Contract(contractAddress, abi, provider);
     const [forVotes, againstVotes] = await contract.getVotes(proposalId);

package/dist/contracts/governance/proposals/getVotingDelay.js

@@ -6,21 +6,22 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.getVotingDelay = void 0;
 const ethers_1 = require("ethers");
 const chains_1 = __importDefault(require("../../../configs/chains"));
-const getContractAddress_1 = require("../../getContractAddress");
+const _helpers_1 = require("../_helpers");
 const artifacts_1 = require("../../../utils/artifacts");
 /**
  * Gets the voting delay (time before voting starts after proposal creation).
  *
  * @param chainId - The chain/network to use.
+ * @param governance - Address of the Governance contract.
  * @param provider - Optional ethers.js Provider instance.
  * @returns The voting delay in seconds.
  */
-const getVotingDelay = async (chainId, provider) => {
+const getVotingDelay = async (chainId, governance, provider) => {
     if (!provider) {
         const rpc = chains_1.default[chainId].rpcs[0];
         provider = new ethers_1.ethers.JsonRpcProvider(rpc);
     }
-    const contractAddress = (0, getContractAddress_1.getContractAddress)(chainId, "governance");
+    const contractAddress = (0, _helpers_1.requireAddress)(governance, "Governance");
     const abi = (0, artifacts_1.getABI)("governance");
     const contract = new ethers_1.ethers.Contract(contractAddress, abi, provider);
     const votingDelay = await contract.votingDelay();

package/dist/contracts/governance/proposals/getVotingPeriod.js

@@ -6,21 +6,22 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.getVotingPeriod = void 0;
 const ethers_1 = require("ethers");
 const chains_1 = __importDefault(require("../../../configs/chains"));
-const getContractAddress_1 = require("../../getContractAddress");
+const _helpers_1 = require("../_helpers");
 const artifacts_1 = require("../../../utils/artifacts");
 /**
  * Gets the voting period duration.
  *
  * @param chainId - The chain/network to use.
+ * @param governance - Address of the Governance contract.
  * @param provider - Optional ethers.js Provider instance.
  * @returns The voting period in seconds.
  */
-const getVotingPeriod = async (chainId, provider) => {
+const getVotingPeriod = async (chainId, governance, provider) => {
     if (!provider) {
         const rpc = chains_1.default[chainId].rpcs[0];
         provider = new ethers_1.ethers.JsonRpcProvider(rpc);
     }
-    const contractAddress = (0, getContractAddress_1.getContractAddress)(chainId, "governance");
+    const contractAddress = (0, _helpers_1.requireAddress)(governance, "Governance");
     const abi = (0, artifacts_1.getABI)("governance");
     const contract = new ethers_1.ethers.Contract(contractAddress, abi, provider);
     const votingPeriod = await contract.votingPeriod();

package/dist/contracts/governance/proposals/hasRole.js

@@ -0,0 +1,31 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.hasRole = void 0;
+const ethers_1 = require("ethers");
+const chains_1 = __importDefault(require("../../../configs/chains"));
+const _helpers_1 = require("../_helpers");
+const artifacts_1 = require("../../../utils/artifacts");
+/**
+ * Checks whether an account holds a Governance role.
+ *
+ * @param chainId - The chain/network to use.
+ * @param governance - Address of the Governance contract.
+ * @param role - The bytes32 role identifier (see `getRoles`).
+ * @param account - The address to check.
+ * @param provider - Optional ethers.js Provider instance.
+ * @returns True if the account holds the role.
+ */
+const hasRole = async (chainId, governance, role, account, provider) => {
+    if (!provider) {
+        const rpc = chains_1.default[chainId].rpcs[0];
+        provider = new ethers_1.ethers.JsonRpcProvider(rpc);
+    }
+    const contractAddress = (0, _helpers_1.requireAddress)(governance, "Governance");
+    const abi = (0, artifacts_1.getABI)("governance");
+    const contract = new ethers_1.ethers.Contract(contractAddress, abi, provider);
+    return await contract.hasRole(role, account);
+};
+exports.hasRole = hasRole;

package/dist/contracts/governance/proposals/hasVoted.js

@@ -0,0 +1,32 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.hasVoted = void 0;
+const ethers_1 = require("ethers");
+const chains_1 = __importDefault(require("../../../configs/chains"));
+const _helpers_1 = require("../_helpers");
+const artifacts_1 = require("../../../utils/artifacts");
+/**
+ * Checks whether an account has already voted on a proposal.
+ * Votes cannot be changed or withdrawn, so a `true` result is final.
+ *
+ * @param chainId - The chain/network to use.
+ * @param governance - Address of the Governance contract.
+ * @param proposalId - The ID of the proposal to query.
+ * @param account - The address to check.
+ * @param provider - Optional ethers.js Provider instance.
+ * @returns True if the account has voted on the proposal.
+ */
+const hasVoted = async (chainId, governance, proposalId, account, provider) => {
+    if (!provider) {
+        const rpc = chains_1.default[chainId].rpcs[0];
+        provider = new ethers_1.ethers.JsonRpcProvider(rpc);
+    }
+    const contractAddress = (0, _helpers_1.requireAddress)(governance, "Governance");
+    const abi = (0, artifacts_1.getABI)("governance");
+    const contract = new ethers_1.ethers.Contract(contractAddress, abi, provider);
+    return await contract.hasVoted(proposalId, account);
+};
+exports.hasVoted = hasVoted;

package/dist/contracts/governance/proposals/index.js

@@ -1,21 +1,28 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.cancel = exports.execute = exports.castVote = exports.propose = exports.getQuorumNumerator = exports.getProposalThreshold = exports.getVotingPeriod = exports.getVotingDelay = exports.getProposalInfo = exports.getProposalData = exports.ProposalType = exports.getProposal = exports.getQuorum = exports.getVotes = exports.ProposalState = exports.getState = void 0;
+exports.setTimelock = exports.GovernanceParameter = exports.setParameter = exports.cancel = exports.execute = exports.castVote = exports.propose = exports.hasRole = exports.getRoles = exports.getLabel = exports.getQuorumNumerator = exports.getProposalThreshold = exports.getVotingPeriod = exports.getVotingDelay = exports.getProposalCount = exports.getProposalEta = exports.getProposalInfo = exports.getProposal = exports.getQuorum = exports.getVoteReceipt = exports.hasVoted = exports.getVotes = exports.ProposalState = exports.getState = exports.getGovernances = void 0;
 // Reading functions
+var getGovernances_1 = require("./getGovernances");
+Object.defineProperty(exports, "getGovernances", { enumerable: true, get: function () { return getGovernances_1.getGovernances; } });
 var getState_1 = require("./getState");
 Object.defineProperty(exports, "getState", { enumerable: true, get: function () { return getState_1.getState; } });
 Object.defineProperty(exports, "ProposalState", { enumerable: true, get: function () { return getState_1.ProposalState; } });
 var getVotes_1 = require("./getVotes");
 Object.defineProperty(exports, "getVotes", { enumerable: true, get: function () { return getVotes_1.getVotes; } });
+var hasVoted_1 = require("./hasVoted");
+Object.defineProperty(exports, "hasVoted", { enumerable: true, get: function () { return hasVoted_1.hasVoted; } });
+var getVoteReceipt_1 = require("./getVoteReceipt");
+Object.defineProperty(exports, "getVoteReceipt", { enumerable: true, get: function () { return getVoteReceipt_1.getVoteReceipt; } });
 var getQuorum_1 = require("./getQuorum");
 Object.defineProperty(exports, "getQuorum", { enumerable: true, get: function () { return getQuorum_1.getQuorum; } });
 var getProposal_1 = require("./getProposal");
 Object.defineProperty(exports, "getProposal", { enumerable: true, get: function () { return getProposal_1.getProposal; } });
-Object.defineProperty(exports, "ProposalType", { enumerable: true, get: function () { return getProposal_1.ProposalType; } });
-var getProposalData_1 = require("./getProposalData");
-Object.defineProperty(exports, "getProposalData", { enumerable: true, get: function () { return getProposalData_1.getProposalData; } });
 var getProposalInfo_1 = require("./getProposalInfo");
 Object.defineProperty(exports, "getProposalInfo", { enumerable: true, get: function () { return getProposalInfo_1.getProposalInfo; } });
+var getProposalEta_1 = require("./getProposalEta");
+Object.defineProperty(exports, "getProposalEta", { enumerable: true, get: function () { return getProposalEta_1.getProposalEta; } });
+var getProposalCount_1 = require("./getProposalCount");
+Object.defineProperty(exports, "getProposalCount", { enumerable: true, get: function () { return getProposalCount_1.getProposalCount; } });
 var getVotingDelay_1 = require("./getVotingDelay");
 Object.defineProperty(exports, "getVotingDelay", { enumerable: true, get: function () { return getVotingDelay_1.getVotingDelay; } });
 var getVotingPeriod_1 = require("./getVotingPeriod");
@@ -24,6 +31,12 @@ var getProposalThreshold_1 = require("./getProposalThreshold");
 Object.defineProperty(exports, "getProposalThreshold", { enumerable: true, get: function () { return getProposalThreshold_1.getProposalThreshold; } });
 var getQuorumNumerator_1 = require("./getQuorumNumerator");
 Object.defineProperty(exports, "getQuorumNumerator", { enumerable: true, get: function () { return getQuorumNumerator_1.getQuorumNumerator; } });
+var getLabel_1 = require("./getLabel");
+Object.defineProperty(exports, "getLabel", { enumerable: true, get: function () { return getLabel_1.getLabel; } });
+var getRoles_1 = require("./getRoles");
+Object.defineProperty(exports, "getRoles", { enumerable: true, get: function () { return getRoles_1.getRoles; } });
+var hasRole_1 = require("./hasRole");
+Object.defineProperty(exports, "hasRole", { enumerable: true, get: function () { return hasRole_1.hasRole; } });
 // Writing functions
 var propose_1 = require("./propose");
 Object.defineProperty(exports, "propose", { enumerable: true, get: function () { return propose_1.propose; } });
@@ -33,3 +46,8 @@ var execute_1 = require("./execute");
 Object.defineProperty(exports, "execute", { enumerable: true, get: function () { return execute_1.execute; } });
 var cancel_1 = require("./cancel");
 Object.defineProperty(exports, "cancel", { enumerable: true, get: function () { return cancel_1.cancel; } });
+var setParameter_1 = require("./setParameter");
+Object.defineProperty(exports, "setParameter", { enumerable: true, get: function () { return setParameter_1.setParameter; } });
+Object.defineProperty(exports, "GovernanceParameter", { enumerable: true, get: function () { return setParameter_1.GovernanceParameter; } });
+var setTimelock_1 = require("./setTimelock");
+Object.defineProperty(exports, "setTimelock", { enumerable: true, get: function () { return setTimelock_1.setTimelock; } });

package/dist/contracts/governance/proposals/propose.js

@@ -1,48 +1,37 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.propose = exports.ProposalType = void 0;
+exports.propose = void 0;
 const ethers_1 = require("ethers");
-const getContractAddress_1 = require("../../getContractAddress");
+const _helpers_1 = require("../_helpers");
 const artifacts_1 = require("../../../utils/artifacts");
-/**
- * Proposal types enum matching the contract
- */
-var ProposalType;
-(function (ProposalType) {
-    ProposalType[ProposalType["ParameterChange"] = 0] = "ParameterChange";
-    ProposalType[ProposalType["SmartContractUpgrade"] = 1] = "SmartContractUpgrade";
-    ProposalType[ProposalType["TreasuryAction"] = 2] = "TreasuryAction";
-    ProposalType[ProposalType["EmissionChange"] = 3] = "EmissionChange";
-    ProposalType[ProposalType["GaugeManagement"] = 4] = "GaugeManagement";
-})(ProposalType || (exports.ProposalType = ProposalType = {}));
 /**
  * Creates a new governance proposal.
- * Requires the caller to have at least proposalThreshold veRAAC voting power.
+ * Requires the caller to have at least proposalThreshold veRAAC voting power at the previous block, which becomes the proposal's snapshot block.
  *
  * @param chainId - The chain/network to use.
+ * @param governance - Address of the Governance contract.
  * @param targets - Array of target addresses for proposal actions.
  * @param values - Array of ETH values for proposal actions.
  * @param calldatas - Array of calldata for proposal actions.
  * @param description - Description of the proposal.
- * @param proposalType - Type of the proposal (ParameterChange, SmartContractUpgrade, TreasuryAction, EmissionChange, or GaugeManagement).
  * @param signer - An ethers.js Signer instance (must be connected to wallet).
  * @returns Transaction receipt and the proposal ID.
  */
-const propose = async (chainId, targets, values, calldatas, description, proposalType, signer) => {
+const propose = async (chainId, governance, targets, values, calldatas, description, signer) => {
     if (!signer) {
         throw new Error("Signer is required");
     }
     try {
-        const contractAddress = (0, getContractAddress_1.getContractAddress)(chainId, "governance");
+        const contractAddress = (0, _helpers_1.requireAddress)(governance, "Governance");
         const abi = (0, artifacts_1.getABI)("governance");
         const contract = new ethers_1.ethers.Contract(contractAddress, abi, signer);
-        const tx = await contract.propose(targets, values, calldatas, description, proposalType);
+        const tx = await contract.propose(targets, values, calldatas, description);
         const receipt = await tx.wait();
         // Extract proposal ID from events
         const event = receipt.logs.find((log) => log.fragment?.name === "ProposalCreated");
         const proposalId = event?.args?.[0];
         console.log(`Proposal created with ID: ${proposalId} at ${contractAddress}`);
-        return { tx, proposalId: proposalId ? Number(proposalId) : undefined };
+        return { tx, proposalId: proposalId !== undefined ? Number(proposalId) : undefined };
     }
     catch (error) {
         console.error("Error creating proposal:", error);

package/dist/contracts/governance/proposals/setParameter.js

@@ -0,0 +1,46 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.setParameter = exports.GovernanceParameter = void 0;
+const ethers_1 = require("ethers");
+const _helpers_1 = require("../_helpers");
+const artifacts_1 = require("../../../utils/artifacts");
+/**
+ * Governance parameters enum matching the contract
+ */
+var GovernanceParameter;
+(function (GovernanceParameter) {
+    GovernanceParameter[GovernanceParameter["VotingDelay"] = 0] = "VotingDelay";
+    GovernanceParameter[GovernanceParameter["VotingPeriod"] = 1] = "VotingPeriod";
+    GovernanceParameter[GovernanceParameter["ProposalThreshold"] = 2] = "ProposalThreshold";
+    GovernanceParameter[GovernanceParameter["QuorumNumerator"] = 3] = "QuorumNumerator";
+})(GovernanceParameter || (exports.GovernanceParameter = GovernanceParameter = {}));
+/**
+ * Updates a governance parameter. Requires `PARAMETER_UPDATE_ROLE`; takes effect immediately.
+ * Only affects proposals created afterwards, since quorum inputs are snapshotted at creation.
+ *
+ * @param chainId - The chain/network to use.
+ * @param governance - Address of the Governance contract.
+ * @param param - The parameter to update.
+ * @param newValue - The new raw value (seconds for delay/period, wei for threshold, percent for quorum numerator).
+ * @param signer - An ethers.js Signer instance (must be connected to wallet).
+ * @returns The transaction response.
+ */
+const setParameter = async (chainId, governance, param, newValue, signer) => {
+    if (!signer) {
+        throw new Error("Signer is required");
+    }
+    try {
+        const contractAddress = (0, _helpers_1.requireAddress)(governance, "Governance");
+        const abi = (0, artifacts_1.getABI)("governance");
+        const contract = new ethers_1.ethers.Contract(contractAddress, abi, signer);
+        const tx = await contract.setParameter(param, newValue);
+        await tx.wait();
+        console.log(`Governance parameter ${GovernanceParameter[param]} set to ${newValue} at ${contractAddress}`);
+        return tx;
+    }
+    catch (error) {
+        console.error("Error setting governance parameter:", error);
+        throw new Error(`Failed to set governance parameter: ${error.message}`);
+    }
+};
+exports.setParameter = setParameter;

package/dist/contracts/governance/proposals/setTimelock.js

@@ -0,0 +1,36 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.setTimelock = void 0;
+const ethers_1 = require("ethers");
+const _helpers_1 = require("../_helpers");
+const artifacts_1 = require("../../../utils/artifacts");
+/**
+ * Updates the timelock controller used to queue new proposals. Requires `DEFAULT_ADMIN_ROLE`.
+ * Proposals already queued stay bound to the timelock they were queued in.
+ * Update the instance's `timelock` in the chain config afterwards so it stays in sync.
+ *
+ * @param chainId - The chain/network to use.
+ * @param governance - Address of the Governance contract.
+ * @param newTimelock - Address of the new timelock controller.
+ * @param signer - An ethers.js Signer instance (must be connected to wallet).
+ * @returns The transaction response.
+ */
+const setTimelock = async (chainId, governance, newTimelock, signer) => {
+    if (!signer) {
+        throw new Error("Signer is required");
+    }
+    try {
+        const contractAddress = (0, _helpers_1.requireAddress)(governance, "Governance");
+        const abi = (0, artifacts_1.getABI)("governance");
+        const contract = new ethers_1.ethers.Contract(contractAddress, abi, signer);
+        const tx = await contract.setTimelock(newTimelock);
+        await tx.wait();
+        console.log(`Governance timelock set to ${newTimelock} at ${contractAddress}`);
+        return tx;
+    }
+    catch (error) {
+        console.error("Error setting governance timelock:", error);
+        throw new Error(`Failed to set governance timelock: ${error.message}`);
+    }
+};
+exports.setTimelock = setTimelock;

package/dist/contracts/governance/timelock/getConstants.js

@@ -6,21 +6,22 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.getConstants = void 0;
 const ethers_1 = require("ethers");
 const chains_1 = __importDefault(require("../../../configs/chains"));
-const getContractAddress_1 = require("../../getContractAddress");
+const _helpers_1 = require("../_helpers");
 const artifacts_1 = require("../../../utils/artifacts");
 /**
  * Gets the timelock constants.
  *
  * @param chainId - The chain/network to use.
+ * @param timelock - Address of the TimelockController contract.
  * @param provider - Optional ethers.js Provider instance.
  * @returns Timelock constants including MIN_DELAY, MAX_DELAY, GRACE_PERIOD, EMERGENCY_DELAY.
  */
-const getConstants = async (chainId, provider) => {
+const getConstants = async (chainId, timelock, provider) => {
     if (!provider) {
         const rpc = chains_1.default[chainId].rpcs[0];
         provider = new ethers_1.ethers.JsonRpcProvider(rpc);
     }
-    const contractAddress = (0, getContractAddress_1.getContractAddress)(chainId, "timelockcontroller");
+    const contractAddress = (0, _helpers_1.requireAddress)(timelock, "TimelockController");
     const abi = (0, artifacts_1.getABI)("timelockcontroller");
     const contract = new ethers_1.ethers.Contract(contractAddress, abi, provider);
     const [minDelay, maxDelay, gracePeriod, emergencyDelay] = await Promise.all([

package/dist/contracts/governance/timelock/getMinDelay.js

@@ -6,21 +6,22 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.getMinDelay = void 0;
 const ethers_1 = require("ethers");
 const chains_1 = __importDefault(require("../../../configs/chains"));
-const getContractAddress_1 = require("../../getContractAddress");
+const _helpers_1 = require("../_helpers");
 const artifacts_1 = require("../../../utils/artifacts");
 /**
  * Returns the minimum delay for operations.
  *
  * @param chainId - The chain/network to use.
+ * @param timelock - Address of the TimelockController contract.
  * @param provider - Optional ethers.js Provider instance.
  * @returns Current minimum delay in seconds.
  */
-const getMinDelay = async (chainId, provider) => {
+const getMinDelay = async (chainId, timelock, provider) => {
     if (!provider) {
         const rpc = chains_1.default[chainId].rpcs[0];
         provider = new ethers_1.ethers.JsonRpcProvider(rpc);
     }
-    const contractAddress = (0, getContractAddress_1.getContractAddress)(chainId, "timelockcontroller");
+    const contractAddress = (0, _helpers_1.requireAddress)(timelock, "TimelockController");
     const abi = (0, artifacts_1.getABI)("timelockcontroller");
     const contract = new ethers_1.ethers.Contract(contractAddress, abi, provider);
     const minDelay = await contract.getMinDelay();

package/dist/contracts/governance/timelock/getRoles.js

@@ -0,0 +1,37 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getRoles = void 0;
+const ethers_1 = require("ethers");
+const chains_1 = __importDefault(require("../../../configs/chains"));
+const _helpers_1 = require("../_helpers");
+const artifacts_1 = require("../../../utils/artifacts");
+/**
+ * Gets the access-control role identifiers used by the TimelockController.
+ * Governance must hold PROPOSER_ROLE, EXECUTOR_ROLE and CANCELLER_ROLE to queue, execute and cancel proposals.
+ *
+ * @param chainId - The chain/network to use.
+ * @param timelock - Address of the TimelockController contract.
+ * @param provider - Optional ethers.js Provider instance.
+ * @returns The bytes32 role identifiers.
+ */
+const getRoles = async (chainId, timelock, provider) => {
+    if (!provider) {
+        const rpc = chains_1.default[chainId].rpcs[0];
+        provider = new ethers_1.ethers.JsonRpcProvider(rpc);
+    }
+    const contractAddress = (0, _helpers_1.requireAddress)(timelock, "TimelockController");
+    const abi = (0, artifacts_1.getABI)("timelockcontroller");
+    const contract = new ethers_1.ethers.Contract(contractAddress, abi, provider);
+    const [defaultAdminRole, proposerRole, executorRole, cancellerRole, emergencyRole] = await Promise.all([
+        contract.DEFAULT_ADMIN_ROLE(),
+        contract.PROPOSER_ROLE(),
+        contract.EXECUTOR_ROLE(),
+        contract.CANCELLER_ROLE(),
+        contract.EMERGENCY_ROLE(),
+    ]);
+    return { defaultAdminRole, proposerRole, executorRole, cancellerRole, emergencyRole };
+};
+exports.getRoles = getRoles;

package/dist/contracts/governance/timelock/getTimestamp.js

@@ -6,23 +6,24 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.getTimestamp = void 0;
 const ethers_1 = require("ethers");
 const chains_1 = __importDefault(require("../../../configs/chains"));
-const getContractAddress_1 = require("../../getContractAddress");
+const _helpers_1 = require("../_helpers");
 const artifacts_1 = require("../../../utils/artifacts");
 /**
  * Returns the timestamp for an operation.
  * This is when the operation will be ready for execution.
  *
  * @param chainId - The chain/network to use.
+ * @param timelock - Address of the TimelockController contract.
  * @param operationId - Operation ID to check (bytes32 hash).
  * @param provider - Optional ethers.js Provider instance.
  * @returns Timestamp when operation will be ready (0 if not scheduled).
  */
-const getTimestamp = async (chainId, operationId, provider) => {
+const getTimestamp = async (chainId, timelock, operationId, provider) => {
     if (!provider) {
         const rpc = chains_1.default[chainId].rpcs[0];
         provider = new ethers_1.ethers.JsonRpcProvider(rpc);
     }
-    const contractAddress = (0, getContractAddress_1.getContractAddress)(chainId, "timelockcontroller");
+    const contractAddress = (0, _helpers_1.requireAddress)(timelock, "TimelockController");
     const abi = (0, artifacts_1.getABI)("timelockcontroller");
     const contract = new ethers_1.ethers.Contract(contractAddress, abi, provider);
     const timestamp = await contract.getTimestamp(operationId);

package/dist/contracts/governance/timelock/hasRole.js

@@ -0,0 +1,31 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.hasRole = void 0;
+const ethers_1 = require("ethers");
+const chains_1 = __importDefault(require("../../../configs/chains"));
+const _helpers_1 = require("../_helpers");
+const artifacts_1 = require("../../../utils/artifacts");
+/**
+ * Checks whether an account holds a TimelockController role.
+ *
+ * @param chainId - The chain/network to use.
+ * @param timelock - Address of the TimelockController contract.
+ * @param role - The bytes32 role identifier (see `getRoles`).
+ * @param account - The address to check.
+ * @param provider - Optional ethers.js Provider instance.
+ * @returns True if the account holds the role.
+ */
+const hasRole = async (chainId, timelock, role, account, provider) => {
+    if (!provider) {
+        const rpc = chains_1.default[chainId].rpcs[0];
+        provider = new ethers_1.ethers.JsonRpcProvider(rpc);
+    }
+    const contractAddress = (0, _helpers_1.requireAddress)(timelock, "TimelockController");
+    const abi = (0, artifacts_1.getABI)("timelockcontroller");
+    const contract = new ethers_1.ethers.Contract(contractAddress, abi, provider);
+    return await contract.hasRole(role, account);
+};
+exports.hasRole = hasRole;

package/dist/contracts/governance/timelock/hashOperationBatch.js

@@ -6,14 +6,15 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.hashOperationBatch = void 0;
 const ethers_1 = require("ethers");
 const chains_1 = __importDefault(require("../../../configs/chains"));
-const getContractAddress_1 = require("../../getContractAddress");
+const _helpers_1 = require("../_helpers");
 const artifacts_1 = require("../../../utils/artifacts");
 /**
  * Hashes an operation for unique identification.
  * Use this to compute the operation ID before scheduling or checking status.
  *
  * @param chainId - The chain/network to use.
- * @param proposalId - The ID of the proposal.
+ * @param timelock - Address of the TimelockController contract.
+ * @param nonce - Caller-supplied discriminator. Governance passes the proposal ID.
  * @param targets - Target addresses for calls.
  * @param values - ETH values for calls.
  * @param calldatas - Calldata for calls.
@@ -22,14 +23,14 @@ const artifacts_1 = require("../../../utils/artifacts");
  * @param provider - Optional ethers.js Provider instance.
  * @returns Operation hash (bytes32).
  */
-const hashOperationBatch = async (chainId, proposalId, targets, values, calldatas, predecessor, salt, provider) => {
+const hashOperationBatch = async (chainId, timelock, nonce, targets, values, calldatas, predecessor, salt, provider) => {
     if (!provider) {
         const rpc = chains_1.default[chainId].rpcs[0];
         provider = new ethers_1.ethers.JsonRpcProvider(rpc);
     }
-    const contractAddress = (0, getContractAddress_1.getContractAddress)(chainId, "timelockcontroller");
+    const contractAddress = (0, _helpers_1.requireAddress)(timelock, "TimelockController");
     const abi = (0, artifacts_1.getABI)("timelockcontroller");
     const contract = new ethers_1.ethers.Contract(contractAddress, abi, provider);
-    return await contract.hashOperationBatch(proposalId, targets, values, calldatas, predecessor, salt);
+    return await contract.hashOperationBatch(nonce, targets, values, calldatas, predecessor, salt);
 };
 exports.hashOperationBatch = hashOperationBatch;

package/dist/contracts/governance/timelock/index.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.getConstants = exports.hashOperationBatch = exports.getMinDelay = exports.getTimestamp = exports.isOperationDone = exports.isOperationReady = exports.isOperationPending = void 0;
+exports.hasRole = exports.getRoles = exports.getConstants = exports.hashOperationBatch = exports.getMinDelay = exports.getTimestamp = exports.isOperationDone = exports.isOperationReady = exports.isOperationPending = void 0;
 // Read functions
 var isOperationPending_1 = require("./isOperationPending");
 Object.defineProperty(exports, "isOperationPending", { enumerable: true, get: function () { return isOperationPending_1.isOperationPending; } });
@@ -16,3 +16,7 @@ var hashOperationBatch_1 = require("./hashOperationBatch");
 Object.defineProperty(exports, "hashOperationBatch", { enumerable: true, get: function () { return hashOperationBatch_1.hashOperationBatch; } });
 var getConstants_1 = require("./getConstants");
 Object.defineProperty(exports, "getConstants", { enumerable: true, get: function () { return getConstants_1.getConstants; } });
+var getRoles_1 = require("./getRoles");
+Object.defineProperty(exports, "getRoles", { enumerable: true, get: function () { return getRoles_1.getRoles; } });
+var hasRole_1 = require("./hasRole");
+Object.defineProperty(exports, "hasRole", { enumerable: true, get: function () { return hasRole_1.hasRole; } });

package/dist/contracts/governance/timelock/isOperationDone.js

@@ -6,22 +6,23 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.isOperationDone = void 0;
 const ethers_1 = require("ethers");
 const chains_1 = __importDefault(require("../../../configs/chains"));
-const getContractAddress_1 = require("../../getContractAddress");
+const _helpers_1 = require("../_helpers");
 const artifacts_1 = require("../../../utils/artifacts");
 /**
  * Returns whether an operation is done (executed).
  *
  * @param chainId - The chain/network to use.
+ * @param timelock - Address of the TimelockController contract.
  * @param operationId - Operation ID to check (bytes32 hash).
  * @param provider - Optional ethers.js Provider instance.
  * @returns True if operation is done.
  */
-const isOperationDone = async (chainId, operationId, provider) => {
+const isOperationDone = async (chainId, timelock, operationId, provider) => {
     if (!provider) {
         const rpc = chains_1.default[chainId].rpcs[0];
         provider = new ethers_1.ethers.JsonRpcProvider(rpc);
     }
-    const contractAddress = (0, getContractAddress_1.getContractAddress)(chainId, "timelockcontroller");
+    const contractAddress = (0, _helpers_1.requireAddress)(timelock, "TimelockController");
     const abi = (0, artifacts_1.getABI)("timelockcontroller");
     const contract = new ethers_1.ethers.Contract(contractAddress, abi, provider);
     return await contract.isOperationDone(operationId);