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

package/dist/contracts/governance/gaugeSystems/getGaugeSystem.js

@@ -0,0 +1,14 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getGaugeSystem = void 0;
+const _helpers_1 = require("./_helpers");
+/**
+ * Returns one gauge system from the chain config.
+ * Reads the chain config only; no RPC call is made.
+ *
+ * @param chainId - The chain/network to use.
+ * @param system - Gauge system id: "raacgauges" or "rwagauges".
+ * @returns The system's label, gauge type, controller and distributor addresses and gauge list.
+ */
+const getGaugeSystem = (chainId, system) => (0, _helpers_1.requireGaugeSystem)(chainId, system);
+exports.getGaugeSystem = getGaugeSystem;

package/dist/contracts/governance/gaugeSystems/getGaugeSystems.js

@@ -0,0 +1,13 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getGaugeSystems = void 0;
+const _helpers_1 = require("./_helpers");
+/**
+ * Lists the gauge systems configured for a chain (RAAC gauges, RWA gauges).
+ * Reads the chain config only; no RPC call is made.
+ *
+ * @param chainId - The chain/network to use.
+ * @returns Each system with its id, label, gauge type, controller and distributor addresses and gauge list.
+ */
+const getGaugeSystems = (chainId) => Object.values((0, _helpers_1.getGaugeSystemsConfig)(chainId)).filter((s) => !!s);
+exports.getGaugeSystems = getGaugeSystems;

package/dist/contracts/governance/gaugeSystems/getGauges.js

@@ -0,0 +1,15 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getGauges = void 0;
+const _helpers_1 = require("./_helpers");
+/**
+ * Lists the gauges in the chain config, each tagged with the system it belongs to.
+ * Reads the chain config only; no RPC call is made. For the controller's on-chain list use
+ * `governance.controller.getRegisteredGaugeList`.
+ *
+ * @param chainId - The chain/network to use.
+ * @param system - Optional gauge system id; gauges of every system when omitted.
+ * @returns The configured gauges with their addresses.
+ */
+const getGauges = (chainId, system) => (0, _helpers_1.listGauges)(chainId, system);
+exports.getGauges = getGauges;

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

@@ -0,0 +1,21 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+// Re-exports every method in this namespace.
+__exportStar(require("./findGauge"), exports);
+__exportStar(require("./getGauges"), exports);
+__exportStar(require("./getGaugeSystem"), exports);
+__exportStar(require("./getGaugeSystems"), exports);

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

@@ -2,26 +2,27 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.cancel = void 0;
 const ethers_1 = require("ethers");
-const getContractAddress_1 = require("../../getContractAddress");
+const _helpers_1 = require("../_helpers");
 const artifacts_1 = require("../../../utils/artifacts");
 /**
- * Cancels an active proposal.
- * Allows cancellation by proposer or if proposer's voting power drops below threshold.
+ * Cancels a proposal.
  * - Only cancellable before execution
  * - Proposer can always cancel their proposal
- * - Automatic cancellation if proposer loses required voting power
+ * - A `CANCELLATION_ROLE` holder can cancel any proposal
+ * - If the proposal is queued, the pending operation is also cancelled in the timelock it was queued in
  *
  * @param chainId - The chain/network to use.
+ * @param governance - Address of the Governance contract.
  * @param proposalId - The ID of the proposal to cancel.
  * @param signer - An ethers.js Signer instance (must be connected to wallet).
  * @returns Transaction receipt after the proposal is canceled.
  */
-const cancel = async (chainId, proposalId, signer) => {
+const cancel = async (chainId, governance, proposalId, 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.cancel(proposalId);
@@ -31,7 +32,7 @@ const cancel = async (chainId, proposalId, signer) => {
     }
     catch (error) {
         console.error("Error canceling proposal:", error);
-        throw new Error(`Failed to cancel proposal: ${error.message}`);
+        throw (0, _helpers_1.toGovernanceTxError)("Failed to cancel proposal", error);
     }
 };
 exports.cancel = cancel;

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

@@ -2,7 +2,7 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.castVote = void 0;
 const ethers_1 = require("ethers");
-const getContractAddress_1 = require("../../getContractAddress");
+const _helpers_1 = require("../_helpers");
 const artifacts_1 = require("../../../utils/artifacts");
 /**
  * Casts a vote on a governance proposal.
@@ -12,17 +12,18 @@ const artifacts_1 = require("../../../utils/artifacts");
  * - Voting window between start and end times
  *
  * @param chainId - The chain/network to use.
+ * @param governance - Address of the Governance contract.
  * @param proposalId - The ID of the proposal to vote on.
  * @param support - True to vote in favor, false to vote against.
  * @param signer - An ethers.js Signer instance (must be connected to wallet).
  * @returns Transaction receipt and the voting power used.
  */
-const castVote = async (chainId, proposalId, support, signer) => {
+const castVote = async (chainId, governance, proposalId, support, 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.castVote(proposalId, support);
@@ -38,7 +39,7 @@ const castVote = async (chainId, proposalId, support, signer) => {
     }
     catch (error) {
         console.error("Error casting vote:", error);
-        throw new Error(`Failed to cast vote: ${error.message}`);
+        throw (0, _helpers_1.toGovernanceTxError)("Failed to cast vote", error);
     }
 };
 exports.castVote = castVote;

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

@@ -2,7 +2,7 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.execute = void 0;
 const ethers_1 = require("ethers");
-const getContractAddress_1 = require("../../getContractAddress");
+const _helpers_1 = require("../_helpers");
 const artifacts_1 = require("../../../utils/artifacts");
 /**
  * Executes a successful proposal through the timelock.
@@ -11,17 +11,18 @@ const artifacts_1 = require("../../../utils/artifacts");
  * 2. Execute - Execute proposal after timelock delay
  *
  * @param chainId - The chain/network to use.
+ * @param governance - Address of the Governance contract.
  * @param proposalId - The ID of the proposal to execute.
  * @param value - Optional ETH value to send with the execution (for payable actions).
  * @param signer - An ethers.js Signer instance (must be connected to wallet).
  * @returns Transaction receipt after the proposal is queued or executed.
  */
-const execute = async (chainId, proposalId, value = 0, signer) => {
+const execute = async (chainId, governance, proposalId, value = 0, 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.execute(proposalId, { value });
@@ -31,7 +32,7 @@ const execute = async (chainId, proposalId, value = 0, signer) => {
     }
     catch (error) {
         console.error("Error executing proposal:", error);
-        throw new Error(`Failed to execute proposal: ${error.message}`);
+        throw (0, _helpers_1.toGovernanceTxError)("Failed to execute proposal", error);
     }
 };
 exports.execute = execute;

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

@@ -0,0 +1,22 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getGovernances = void 0;
+const chains_1 = __importDefault(require("../../../configs/chains"));
+/**
+ * Lists the Governance instances configured for a chain.
+ * Reads the chain config only; no RPC call is made.
+ *
+ * @param chainId - The chain/network to use.
+ * @returns Each configured instance with its id, label, governance and timelock addresses.
+ */
+const getGovernances = (chainId) => {
+    const config = chains_1.default[chainId];
+    if (!config) {
+        throw new Error(`Chain configuration not found for chainId: ${chainId}`);
+    }
+    return (config.proposals ?? []);
+};
+exports.getGovernances = getGovernances;

package/dist/contracts/governance/{distributor/getRewardTokens.js → proposals/getLabel.js}

@@ -3,25 +3,27 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.getRewardTokens = void 0;
+exports.getLabel = void 0;
 const ethers_1 = require("ethers");
 const chains_1 = __importDefault(require("../../../configs/chains"));
-const getContractAddress_1 = require("../../getContractAddress");
-const GET_REWARD_TOKENS_ABI = "function getRewardTokens() view returns (address[] memory)";
+const _helpers_1 = require("../_helpers");
+const artifacts_1 = require("../../../utils/artifacts");
 /**
- * Gets all approved reward tokens in the distributor.
+ * Gets the category label this Governance instance was deployed for.
  *
  * @param chainId - The chain/network to use.
+ * @param governance - Address of the Governance contract.
  * @param provider - Optional ethers.js Provider instance.
- * @returns Array of reward token addresses.
+ * @returns The instance label.
  */
-const getRewardTokens = async (chainId, provider) => {
+const getLabel = 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, "gaugerewardsdistributor");
-    const contract = new ethers_1.ethers.Contract(contractAddress, [GET_REWARD_TOKENS_ABI], provider);
-    return await contract.getRewardTokens();
+    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.label();
 };
-exports.getRewardTokens = getRewardTokens;
+exports.getLabel = getLabel;

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

@@ -3,51 +3,49 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.getProposal = exports.ProposalType = void 0;
+exports.getProposal = 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");
-/**
- * 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 = {}));
 /**
  * Gets full proposal details.
+ * `timelock` is the zero address until the proposal is queued, after which it is pinned to the timelock it was queued in.
+ * `snapshotBlock`, `quorumNumerator` and `totalVotingPowerAtSnapshot` are captured at creation and never change.
  *
  * @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 Full ProposalCore data.
  */
-const getProposal = async (chainId, proposalId, provider) => {
+const getProposal = 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 proposal = await contract.getProposal(proposalId);
+    // Destructure by index: ethers v6 Result extends Array, so `proposal.values`
+    // resolves to Array.prototype.values (the iterator) instead of the struct field.
+    const [id, proposer, startTime, endTime, executed, canceled, timelock, descriptionHash, targets, rawValues, calldatas, snapshotBlock, quorumNumerator, totalVotingPowerAtSnapshot,] = proposal;
     return {
-        id: Number(proposal.id),
-        proposer: proposal.proposer,
-        proposalType: Number(proposal.proposalType),
-        startTime: Number(proposal.startTime),
-        endTime: Number(proposal.endTime),
-        executed: proposal.executed,
-        canceled: proposal.canceled,
-        descriptionHash: proposal.descriptionHash,
-        targets: proposal.targets,
-        values: proposal.values.map((v) => ethers_1.ethers.formatEther(v)),
-        calldatas: proposal.calldatas,
+        id: Number(id),
+        proposer,
+        startTime: Number(startTime),
+        endTime: Number(endTime),
+        executed,
+        canceled,
+        timelock,
+        descriptionHash,
+        targets: Array.from(targets),
+        values: Array.from(rawValues).map((v) => ethers_1.ethers.formatEther(v)),
+        calldatas: Array.from(calldatas),
+        snapshotBlock: Number(snapshotBlock),
+        quorumNumerator: Number(quorumNumerator),
+        totalVotingPowerAtSnapshot: ethers_1.ethers.formatEther(totalVotingPowerAtSnapshot),
     };
 };
 exports.getProposal = getProposal;

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

@@ -6,21 +6,22 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.getProposalCount = 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 total number of proposals.
  *
  * @param chainId - The chain/network to use.
+ * @param governance - Address of the Governance contract.
  * @param provider - Optional ethers.js Provider instance.
  * @returns The total number of proposals.
  */
-const getProposalCount = async (chainId, provider) => {
+const getProposalCount = 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 proposalCount = await contract.getProposalCount();

package/dist/contracts/governance/proposals/{getProposalData.js → getProposalEta.js}

@@ -3,34 +3,30 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.getProposalData = void 0;
+exports.getProposalEta = 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 proposal transaction data.
- * Returns arrays of targets, values, and calldata.
+ * Gets the timestamp at which a queued proposal becomes executable.
+ * Read from the timelock the proposal was queued in.
  *
  * @param chainId - The chain/network to use.
- * @param proposalId - The ID of the proposal.
+ * @param governance - Address of the Governance contract.
+ * @param proposalId - The ID of the proposal to query.
  * @param provider - Optional ethers.js Provider instance.
- * @returns Proposal data including targets, values, calldatas, and description.
+ * @returns Execution timestamp in seconds, or 0 if the proposal has not been queued.
  */
-const getProposalData = async (chainId, proposalId, provider) => {
+const getProposalEta = 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 [targets, values, calldatas, description] = await contract.getProposalData(proposalId);
-    return {
-        targets,
-        values: values.map((v) => ethers_1.ethers.formatEther(v)),
-        calldatas,
-        description,
-    };
+    const eta = await contract.proposalEta(proposalId);
+    return Number(eta);
 };
-exports.getProposalData = getProposalData;
+exports.getProposalEta = getProposalEta;

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

@@ -6,22 +6,23 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.getProposalInfo = 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 detailed proposal status info.
  *
  * @param chainId - The chain/network to use.
+ * @param governance - Address of the Governance contract.
  * @param proposalId - The ID of the proposal.
  * @param provider - Optional ethers.js Provider instance.
  * @returns Detailed proposal info including state, timing, votes, and quorum.
  */
-const getProposalInfo = async (chainId, proposalId, provider) => {
+const getProposalInfo = 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 [currentState, startTime, endTime, currentTime, forVotes, againstVotes, currentQuorum, requiredQuorum, isExecuted, isCanceled,] = await contract.getProposalInfo(proposalId);

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

@@ -6,21 +6,22 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.getProposalThreshold = 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 minimum voting power required to create proposals.
  *
  * @param chainId - The chain/network to use.
+ * @param governance - Address of the Governance contract.
  * @param provider - Optional ethers.js Provider instance.
  * @returns The proposal threshold formatted in ether units.
  */
-const getProposalThreshold = async (chainId, provider) => {
+const getProposalThreshold = 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 proposalThreshold = await contract.proposalThreshold();

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

@@ -6,25 +6,27 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.getQuorum = 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 current quorum requirement.
- * Calculates required quorum based on total voting power.
+ * Gets the quorum requirement for a proposal.
+ * Derived from the total voting power and quorum numerator snapshotted when the proposal was created, so it never moves afterwards.
  *
  * @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 current quorum threshold formatted in ether units.
+ * @returns The required for-votes formatted in ether units, "0.0" for an unknown proposal.
  */
-const getQuorum = async (chainId, provider) => {
+const getQuorum = 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 quorum = await contract.quorum();
+    const quorum = await contract.quorum(proposalId);
     return ethers_1.ethers.formatEther(quorum);
 };
 exports.getQuorum = getQuorum;

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

@@ -6,22 +6,23 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.getQuorumNumerator = 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 quorum numerator and denominator settings.
  * The percentage of total voting power required for quorum.
  *
  * @param chainId - The chain/network to use.
+ * @param governance - Address of the Governance contract.
  * @param provider - Optional ethers.js Provider instance.
  * @returns The quorum settings including numerator, denominator, and percentage.
  */
-const getQuorumNumerator = async (chainId, provider) => {
+const getQuorumNumerator = 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 [numerator, denominator] = await Promise.all([

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

@@ -0,0 +1,34 @@
+"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 Governance.
+ *
+ * @param chainId - The chain/network to use.
+ * @param governance - Address of the Governance contract.
+ * @param provider - Optional ethers.js Provider instance.
+ * @returns The bytes32 role identifiers.
+ */
+const getRoles = async (chainId, governance, 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);
+    const [defaultAdminRole, parameterUpdateRole, cancellationRole] = await Promise.all([
+        contract.DEFAULT_ADMIN_ROLE(),
+        contract.PARAMETER_UPDATE_ROLE(),
+        contract.CANCELLATION_ROLE(),
+    ]);
+    return { defaultAdminRole, parameterUpdateRole, cancellationRole };
+};
+exports.getRoles = getRoles;

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

@@ -6,7 +6,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.getState = exports.ProposalState = 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");
 /**
  * Proposal states enum matching the contract
@@ -25,16 +25,17 @@ var ProposalState;
  * Returns the current state of a proposal.
  *
  * @param chainId - The chain/network to use.
+ * @param governance - Address of the Governance contract.
  * @param proposalId - The ID of the proposal to check.
  * @param provider - Optional ethers.js Provider instance.
  * @returns The current ProposalState.
  */
-const getState = async (chainId, proposalId, provider) => {
+const getState = 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 state = await contract.state(proposalId);