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

package/dist/contracts/governance/gaugeController/isPaused.js

@@ -0,0 +1,27 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isPaused = void 0;
+const ethers_1 = require("ethers");
+const chains_1 = __importDefault(require("../../../configs/chains"));
+const getContractAddress_1 = require("../../getContractAddress");
+const artifacts_1 = require("../../../utils/artifacts");
+/**
+ * Checks whether the GaugeController is currently paused.
+ * @param chainId - The chain/network to use.
+ * @param provider - Optional ethers.js Provider instance.
+ * @returns True if the contract is paused, false otherwise.
+ */
+const isPaused = async (chainId, provider) => {
+    if (!provider) {
+        const rpc = chains_1.default[chainId].rpcs[0];
+        provider = new ethers_1.ethers.JsonRpcProvider(rpc);
+    }
+    const address = (0, getContractAddress_1.getContractAddress)(chainId, "gaugecontroller");
+    const abi = (0, artifacts_1.getABI)("gaugecontroller");
+    const contract = new ethers_1.ethers.Contract(address, abi, provider);
+    return contract.paused();
+};
+exports.isPaused = isPaused;

package/dist/contracts/governance/gaugeController/kick.js

@@ -0,0 +1,24 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.kick = void 0;
+const ethers_1 = require("ethers");
+const getContractAddress_1 = require("../../getContractAddress");
+const artifacts_1 = require("../../../utils/artifacts");
+/**
+ * Kicks a user, forcing a re-checkpoint of their vote power (e.g. after their veToken lock expired).
+ * @param chainId - The chain/network to use.
+ * @param user - Address of the user to kick.
+ * @param signer - An ethers.js Signer instance (required).
+ * @returns The transaction response.
+ */
+const kick = async (chainId, user, signer) => {
+    if (!signer)
+        throw new Error("Signer is required");
+    const address = (0, getContractAddress_1.getContractAddress)(chainId, "gaugecontroller");
+    const abi = (0, artifacts_1.getABI)("gaugecontroller");
+    const contract = new ethers_1.ethers.Contract(address, abi, signer);
+    const tx = await contract.kick(user);
+    await tx.wait();
+    return tx;
+};
+exports.kick = kick;

package/dist/contracts/governance/gaugeController/removeGauge.js

@@ -0,0 +1,24 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.removeGauge = void 0;
+const ethers_1 = require("ethers");
+const getContractAddress_1 = require("../../getContractAddress");
+const artifacts_1 = require("../../../utils/artifacts");
+/**
+ * Removes a gauge from the GaugeController. Requires the GAUGE_ADMIN role.
+ * @param chainId - The chain/network to use.
+ * @param gauge - Address of the gauge to remove.
+ * @param signer - An ethers.js Signer instance (required).
+ * @returns The transaction response.
+ */
+const removeGauge = async (chainId, gauge, signer) => {
+    if (!signer)
+        throw new Error("Signer is required");
+    const address = (0, getContractAddress_1.getContractAddress)(chainId, "gaugecontroller");
+    const abi = (0, artifacts_1.getABI)("gaugecontroller");
+    const contract = new ethers_1.ethers.Contract(address, abi, signer);
+    const tx = await contract.removeGauge(gauge);
+    await tx.wait();
+    return tx;
+};
+exports.removeGauge = removeGauge;

package/dist/contracts/governance/gaugeController/removePowerFromGauge.js

@@ -0,0 +1,24 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.removePowerFromGauge = void 0;
+const ethers_1 = require("ethers");
+const getContractAddress_1 = require("../../getContractAddress");
+const artifacts_1 = require("../../../utils/artifacts");
+/**
+ * Removes the caller's allocated vote power from a gauge.
+ * @param chainId - The chain/network to use.
+ * @param gauge - Address of the gauge to remove power from.
+ * @param signer - An ethers.js Signer instance (required).
+ * @returns The transaction response.
+ */
+const removePowerFromGauge = async (chainId, gauge, signer) => {
+    if (!signer)
+        throw new Error("Signer is required");
+    const address = (0, getContractAddress_1.getContractAddress)(chainId, "gaugecontroller");
+    const abi = (0, artifacts_1.getABI)("gaugecontroller");
+    const contract = new ethers_1.ethers.Contract(address, abi, signer);
+    const tx = await contract.removePowerFromGauge(gauge);
+    await tx.wait();
+    return tx;
+};
+exports.removePowerFromGauge = removePowerFromGauge;

package/dist/contracts/governance/gaugeController/setBoostAmplificationEnabled.js

@@ -0,0 +1,25 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.setBoostAmplificationEnabled = void 0;
+const ethers_1 = require("ethers");
+const getContractAddress_1 = require("../../getContractAddress");
+const artifacts_1 = require("../../../utils/artifacts");
+/**
+ * Enables or disables boost amplification for a gauge. Requires the GAUGE_ADMIN role.
+ * @param chainId - The chain/network to use.
+ * @param gauge - Address of the gauge.
+ * @param enabled - Whether boost amplification should be enabled.
+ * @param signer - An ethers.js Signer instance (required).
+ * @returns The transaction response.
+ */
+const setBoostAmplificationEnabled = async (chainId, gauge, enabled, signer) => {
+    if (!signer)
+        throw new Error("Signer is required");
+    const address = (0, getContractAddress_1.getContractAddress)(chainId, "gaugecontroller");
+    const abi = (0, artifacts_1.getABI)("gaugecontroller");
+    const contract = new ethers_1.ethers.Contract(address, abi, signer);
+    const tx = await contract.setBoostAmplificationEnabled(gauge, enabled);
+    await tx.wait();
+    return tx;
+};
+exports.setBoostAmplificationEnabled = setBoostAmplificationEnabled;

package/dist/contracts/governance/gaugeController/setEmergencyGaugePause.js

@@ -0,0 +1,25 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.setEmergencyGaugePause = void 0;
+const ethers_1 = require("ethers");
+const getContractAddress_1 = require("../../getContractAddress");
+const artifacts_1 = require("../../../utils/artifacts");
+/**
+ * Emergency-pauses or unpauses a single gauge. Requires the EMERGENCY_ADMIN role.
+ * @param chainId - The chain/network to use.
+ * @param gauge - Address of the gauge.
+ * @param paused - Whether the gauge should be paused.
+ * @param signer - An ethers.js Signer instance (required).
+ * @returns The transaction response.
+ */
+const setEmergencyGaugePause = async (chainId, gauge, paused, signer) => {
+    if (!signer)
+        throw new Error("Signer is required");
+    const address = (0, getContractAddress_1.getContractAddress)(chainId, "gaugecontroller");
+    const abi = (0, artifacts_1.getABI)("gaugecontroller");
+    const contract = new ethers_1.ethers.Contract(address, abi, signer);
+    const tx = await contract.setEmergencyGaugePause(gauge, paused);
+    await tx.wait();
+    return tx;
+};
+exports.setEmergencyGaugePause = setEmergencyGaugePause;

package/dist/contracts/governance/gaugeController/setEmergencyPause.js

@@ -0,0 +1,24 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.setEmergencyPause = void 0;
+const ethers_1 = require("ethers");
+const getContractAddress_1 = require("../../getContractAddress");
+const artifacts_1 = require("../../../utils/artifacts");
+/**
+ * Emergency-pauses or unpauses the entire GaugeController. Requires the EMERGENCY_ADMIN role.
+ * @param chainId - The chain/network to use.
+ * @param paused - Whether the contract should be paused.
+ * @param signer - An ethers.js Signer instance (required).
+ * @returns The transaction response.
+ */
+const setEmergencyPause = async (chainId, paused, signer) => {
+    if (!signer)
+        throw new Error("Signer is required");
+    const address = (0, getContractAddress_1.getContractAddress)(chainId, "gaugecontroller");
+    const abi = (0, artifacts_1.getABI)("gaugecontroller");
+    const contract = new ethers_1.ethers.Contract(address, abi, signer);
+    const tx = await contract.setEmergencyPause(paused);
+    await tx.wait();
+    return tx;
+};
+exports.setEmergencyPause = setEmergencyPause;

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/proposals/{getProposalData.js → getLabel.js}

@@ -3,34 +3,27 @@ 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.getLabel = 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 category label this Governance instance was deployed for.
  *
  * @param chainId - The chain/network to use.
- * @param proposalId - The ID of the proposal.
+ * @param governance - Address of the Governance contract.
  * @param provider - Optional ethers.js Provider instance.
- * @returns Proposal data including targets, values, calldatas, and description.
+ * @returns The instance label.
  */
-const getProposalData = async (chainId, proposalId, 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, "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,
-    };
+    return await contract.label();
 };
-exports.getProposalData = getProposalData;
+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/getProposalEta.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.getProposalEta = 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 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 governance - Address of the Governance contract.
+ * @param proposalId - The ID of the proposal to query.
+ * @param provider - Optional ethers.js Provider instance.
+ * @returns Execution timestamp in seconds, or 0 if the proposal has not been queued.
+ */
+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, _helpers_1.requireAddress)(governance, "Governance");
+    const abi = (0, artifacts_1.getABI)("governance");
+    const contract = new ethers_1.ethers.Contract(contractAddress, abi, provider);
+    const eta = await contract.proposalEta(proposalId);
+    return Number(eta);
+};
+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([