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

package/dist/contracts/governance/gauge/setGaugeRewardDistributor.js

@@ -0,0 +1,24 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.setGaugeRewardDistributor = void 0;
+const ethers_1 = require("ethers");
+const artifacts_1 = require("../../../utils/artifacts");
+const _helpers_1 = require("../gaugeSystems/_helpers");
+/**
+ * Sets the gauge reward distributor address (requires DEFAULT_ADMIN_ROLE).
+ * @param chainId - The chain/network to use.
+ * @param gaugeAddressOrId - Address of the gauge contract or its config ID.
+ * @param rewardDistributor - Address of the new reward distributor.
+ * @param signer - An ethers.js Signer instance (required).
+ */
+const setGaugeRewardDistributor = async (chainId, gaugeAddressOrId, rewardDistributor, signer) => {
+    if (!signer)
+        throw new Error("Signer is required");
+    const gaugeAddress = (0, _helpers_1.resolveGauge)(chainId, gaugeAddressOrId);
+    const abi = (0, artifacts_1.getABI)("basegauge");
+    const contract = new ethers_1.ethers.Contract(gaugeAddress, abi, signer);
+    const tx = await contract.setGaugeRewardDistributor(rewardDistributor);
+    await tx.wait();
+    return tx;
+};
+exports.setGaugeRewardDistributor = setGaugeRewardDistributor;

package/dist/contracts/governance/gauge/setRaacAutolockMin.js

@@ -0,0 +1,24 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.setRaacAutolockMin = void 0;
+const ethers_1 = require("ethers");
+const artifacts_1 = require("../../../utils/artifacts");
+const _helpers_1 = require("../gaugeSystems/_helpers");
+/**
+ * Sets the minimum RAAC amount required to trigger an autolock on claim (requires DEFAULT_ADMIN_ROLE).
+ * @param chainId - The chain/network to use.
+ * @param gaugeAddressOrId - Address of the gauge contract or its config ID.
+ * @param amount - The new minimum autolock amount.
+ * @param signer - An ethers.js Signer instance (required).
+ */
+const setRaacAutolockMin = async (chainId, gaugeAddressOrId, amount, signer) => {
+    if (!signer)
+        throw new Error("Signer is required");
+    const gaugeAddress = (0, _helpers_1.resolveGauge)(chainId, gaugeAddressOrId);
+    const abi = (0, artifacts_1.getABI)("basegauge");
+    const contract = new ethers_1.ethers.Contract(gaugeAddress, abi, signer);
+    const tx = await contract.setRaacAutolockMin(amount);
+    await tx.wait();
+    return tx;
+};
+exports.setRaacAutolockMin = setRaacAutolockMin;

package/dist/contracts/governance/gauge/stake.js

@@ -1,12 +1,9 @@
 "use strict";
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.stake = void 0;
 const ethers_1 = require("ethers");
 const artifacts_1 = require("../../../utils/artifacts");
-const getContractAddress_1 = __importDefault(require("../../getContractAddress"));
+const _helpers_1 = require("../gaugeSystems/_helpers");
 /**
  * Stakes tokens in a gauge.
  * Will also claim all pending rewards and update working balance before staking.
@@ -21,20 +18,7 @@ const stake = async (chainId, gaugeAddressOrId, amount, signer) => {
     if (!signer) {
         throw new Error("Signer is required");
     }
-    let gaugeAddress;
-    try {
-        if ((0, ethers_1.isAddress)(gaugeAddressOrId)) {
-            gaugeAddress = gaugeAddressOrId;
-        }
-        else {
-            // @ts-ignore
-            gaugeAddress = (0, getContractAddress_1.default)(chainId, gaugeAddressOrId.toLowerCase());
-        }
-    }
-    catch (error) {
-        console.error("Error staking:", error);
-        throw new Error(`Failed to stake in gauge ${gaugeAddress}: ${error.message}`);
-    }
+    const gaugeAddress = (0, _helpers_1.resolveGauge)(chainId, gaugeAddressOrId);
     try {
         const gaugeABI = (0, artifacts_1.getABI)("basegauge");
         const gaugeContract = new ethers_1.ethers.Contract(gaugeAddress, gaugeABI, signer);

package/dist/contracts/governance/gauge/unwrapStakingToken.js

@@ -0,0 +1,28 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.unwrapStakingToken = void 0;
+const ethers_1 = require("ethers");
+const _helpers_1 = require("../gaugeSystems/_helpers");
+const _tokens_1 = require("./_tokens");
+/**
+ * Unwraps a wrapped gauge's staking token back into its underlying (ERC4626 `redeem`), sending it to the signer.
+ *
+ * @param chainId - The chain/network to use.
+ * @param gaugeAddressOrId - Address of the gauge contract or its config ID.
+ * @param shares - Staking token to unwrap, base units.
+ * @param signer - An ethers.js Signer instance (required).
+ * @returns The mined transaction.
+ */
+const unwrapStakingToken = async (chainId, gaugeAddressOrId, shares, signer) => {
+    if (!signer)
+        throw new Error("Signer is required");
+    const gauge = (0, _helpers_1.resolveGauge)(chainId, gaugeAddressOrId);
+    const { stakingToken, underlying } = await (0, _tokens_1.getGaugeTokens)(gauge, signer);
+    if (!underlying)
+        throw new Error(`Gauge ${gauge} does not take a wrapped token`);
+    const owner = await signer.getAddress();
+    const tx = await new ethers_1.ethers.Contract(stakingToken, _tokens_1.ERC4626_ABI, signer).redeem(shares, owner, owner);
+    await tx.wait();
+    return tx;
+};
+exports.unwrapStakingToken = unwrapStakingToken;

package/dist/contracts/governance/gauge/updateUserRewards.js

@@ -1,43 +1,28 @@
 "use strict";
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.updateUserRewards = void 0;
 const ethers_1 = require("ethers");
 const artifacts_1 = require("../../../utils/artifacts");
-const getContractAddress_1 = __importDefault(require("../../getContractAddress"));
+const _helpers_1 = require("../gaugeSystems/_helpers");
 /**
  * Triggers an update of the user's reward state.
  * This can be called to force rewards to accrue without claiming.
  *
  * @param chainId - The chain/network to use.
  * @param gaugeAddressOrId - Address of the gauge contract or ID of the gauge.
+ * @param user - Address of the user whose reward state should be settled/kicked.
  * @param signer - An ethers.js Signer instance (must be connected to wallet).
  * @returns Transaction receipt after the update is complete.
  */
-const updateUserRewards = async (chainId, gaugeAddressOrId, signer) => {
+const updateUserRewards = async (chainId, gaugeAddressOrId, user, signer) => {
     if (!signer) {
         throw new Error("Signer is required");
     }
-    let gaugeAddress;
-    try {
-        if ((0, ethers_1.isAddress)(gaugeAddressOrId)) {
-            gaugeAddress = gaugeAddressOrId;
-        }
-        else {
-            // @ts-ignore
-            gaugeAddress = (0, getContractAddress_1.default)(chainId, gaugeAddressOrId.toLowerCase());
-        }
-    }
-    catch (error) {
-        console.error("Error updating user rewards:", error);
-        throw new Error(`Failed to update user rewards for gauge ${gaugeAddress}: ${error.message}`);
-    }
+    const gaugeAddress = (0, _helpers_1.resolveGauge)(chainId, gaugeAddressOrId);
     try {
         const gaugeABI = (0, artifacts_1.getABI)("basegauge");
         const contract = new ethers_1.ethers.Contract(gaugeAddress, gaugeABI, signer);
-        const tx = await contract.updateUserRewards();
+        const tx = await contract.updateUserRewards(user);
         await tx.wait();
         console.log(`Updated user rewards for gauge: ${gaugeAddress}`);
         return tx;

package/dist/contracts/governance/gauge/withdraw.js

@@ -1,12 +1,9 @@
 "use strict";
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.withdraw = void 0;
 const ethers_1 = require("ethers");
 const artifacts_1 = require("../../../utils/artifacts");
-const getContractAddress_1 = __importDefault(require("../../getContractAddress"));
+const _helpers_1 = require("../gaugeSystems/_helpers");
 /**
  * Withdraws staked tokens from a gauge.
  * Will also claim all pending rewards and update working balance before withdrawing.
@@ -21,20 +18,7 @@ const withdraw = async (chainId, gaugeAddressOrId, amount, signer) => {
     if (!signer) {
         throw new Error("Signer is required");
     }
-    let gaugeAddress;
-    try {
-        if ((0, ethers_1.isAddress)(gaugeAddressOrId)) {
-            gaugeAddress = gaugeAddressOrId;
-        }
-        else {
-            // @ts-ignore
-            gaugeAddress = (0, getContractAddress_1.default)(chainId, gaugeAddressOrId.toLowerCase());
-        }
-    }
-    catch (error) {
-        console.error("Error withdrawing:", error);
-        throw new Error(`Failed to withdraw from gauge ${gaugeAddress}: ${error.message}`);
-    }
+    const gaugeAddress = (0, _helpers_1.resolveGauge)(chainId, gaugeAddressOrId);
     try {
         const gaugeABI = (0, artifacts_1.getABI)("basegauge");
         const gaugeContract = new ethers_1.ethers.Contract(gaugeAddress, gaugeABI, signer);

package/dist/contracts/governance/gauge/wrapStakingToken.js

@@ -0,0 +1,28 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.wrapStakingToken = void 0;
+const ethers_1 = require("ethers");
+const _helpers_1 = require("../gaugeSystems/_helpers");
+const _tokens_1 = require("./_tokens");
+/**
+ * Wraps the underlying of a wrapped gauge into its staking token (ERC4626 `deposit`), minting the shares to the signer.
+ * The underlying must be approved to the wrapper first, see `approveGaugeToken`.
+ *
+ * @param chainId - The chain/network to use.
+ * @param gaugeAddressOrId - Address of the gauge contract or its config ID.
+ * @param assets - Underlying to wrap, base units.
+ * @param signer - An ethers.js Signer instance (required).
+ * @returns The mined transaction.
+ */
+const wrapStakingToken = async (chainId, gaugeAddressOrId, assets, signer) => {
+    if (!signer)
+        throw new Error("Signer is required");
+    const gauge = (0, _helpers_1.resolveGauge)(chainId, gaugeAddressOrId);
+    const { stakingToken, underlying } = await (0, _tokens_1.getGaugeTokens)(gauge, signer);
+    if (!underlying)
+        throw new Error(`Gauge ${gauge} does not take a wrapped token`);
+    const tx = await new ethers_1.ethers.Contract(stakingToken, _tokens_1.ERC4626_ABI, signer).deposit(assets, await signer.getAddress());
+    await tx.wait();
+    return tx;
+};
+exports.wrapStakingToken = wrapStakingToken;

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

@@ -0,0 +1,32 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.addGauge = void 0;
+const ethers_1 = require("ethers");
+const artifacts_1 = require("../../../utils/artifacts");
+const _helpers_1 = require("../gaugeSystems/_helpers");
+const _helpers_2 = require("../_helpers");
+/**
+ * Registers a gauge on the controller. Requires GAUGE_ADMIN. The gauge must belong to this system (RAACGauge on the RAAC controller, RWAGauge on the RWA controller).
+ *
+ * @param chainId - The chain/network to use.
+ * @param gaugeSystem - Gauge system id ("raacgauges" or "rwagauges") or a GaugeController address.
+ * @param gaugeAddressOrId - Address or config id of the gauge.
+ * @param signer - An ethers.js Signer instance (required).
+ * @returns The transaction after it has been mined.
+ */
+const addGauge = async (chainId, gaugeSystem, gaugeAddressOrId, signer) => {
+    if (!signer)
+        throw new Error("Signer is required");
+    const address = (0, _helpers_1.resolveGaugeController)(chainId, gaugeSystem);
+    const gaugeAddress = (0, _helpers_1.resolveGauge)(chainId, gaugeAddressOrId);
+    const contract = new ethers_1.ethers.Contract(address, (0, artifacts_1.getABI)("gaugecontroller"), signer);
+    try {
+        const tx = await contract.addGauge(gaugeAddress);
+        await tx.wait();
+        return tx;
+    }
+    catch (error) {
+        throw (0, _helpers_2.toGovernanceTxError)("Failed to add gauge", error);
+    }
+};
+exports.addGauge = addGauge;

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

@@ -0,0 +1,33 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.batchVote = void 0;
+const ethers_1 = require("ethers");
+const artifacts_1 = require("../../../utils/artifacts");
+const _helpers_1 = require("../gaugeSystems/_helpers");
+const _helpers_2 = require("../_helpers");
+/**
+ * Votes on several gauges in one transaction.
+ *
+ * @param chainId - The chain/network to use.
+ * @param gaugeSystem - Gauge system id ("raacgauges" or "rwagauges") or a GaugeController address.
+ * @param gaugeAddressesOrIds - Addresses or config ids of the gauges.
+ * @param voteWeights - Vote weight per gauge in basis points, index-aligned with the gauges.
+ * @param signer - An ethers.js Signer instance (required).
+ * @returns The transaction after it has been mined.
+ */
+const batchVote = async (chainId, gaugeSystem, gaugeAddressesOrIds, voteWeights, signer) => {
+    if (!signer)
+        throw new Error("Signer is required");
+    const address = (0, _helpers_1.resolveGaugeController)(chainId, gaugeSystem);
+    const gaugeAddresses = gaugeAddressesOrIds.map((g) => (0, _helpers_1.resolveGauge)(chainId, g));
+    const contract = new ethers_1.ethers.Contract(address, (0, artifacts_1.getABI)("gaugecontroller"), signer);
+    try {
+        const tx = await contract.batchVote(gaugeAddresses, voteWeights);
+        await tx.wait();
+        return tx;
+    }
+    catch (error) {
+        throw (0, _helpers_2.toGovernanceTxError)("Failed to batch vote", error);
+    }
+};
+exports.batchVote = batchVote;

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

@@ -1,36 +1,33 @@
 "use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.calculateBoost = void 0;
 const ethers_1 = require("ethers");
-const getContractAddress_1 = require("../../getContractAddress");
+const chains_1 = __importDefault(require("../../../configs/chains"));
 const artifacts_1 = require("../../../utils/artifacts");
+const _helpers_1 = require("../gaugeSystems/_helpers");
 /**
- * Reads the calculateBoost result from the GaugeController contract (read-only).
+ * Calculates the reward boost a user would get on a gauge for a staked amount.
  *
  * @param chainId - The chain/network to use.
- * @param userAddress - The user for which to calculate boost.
- * @param gaugeAddress - The gauge address to calculate the boost for.
- * @param amount - The amount to calculate the boost for.
- * @param provider - An ethers.js Provider instance for read-only RPC.
- * @returns {Promise<{ boostBasisPoints: bigint, boostedAmount: bigint }>}
+ * @param gaugeSystem - Gauge system id ("raacgauges" or "rwagauges") or a GaugeController address.
+ * @param user - Address of the user.
+ * @param gaugeAddressOrId - Address or config id of the gauge.
+ * @param amount - Staked amount, base units.
+ * @param provider - Optional ethers.js Provider instance.
+ * @returns The boost in basis points and the boosted amount.
  */
-const calculateBoost = async (chainId, userAddress, gaugeAddress, amount, provider) => {
+const calculateBoost = async (chainId, gaugeSystem, user, gaugeAddressOrId, amount, provider) => {
     if (!provider) {
-        throw new Error("Provider is required");
-    }
-    try {
-        const gaugeControllerAddress = (0, getContractAddress_1.getContractAddress)(chainId, "gaugecontroller");
-        const gaugeControllerABI = (0, artifacts_1.getABI)("gaugecontroller");
-        const gaugeControllerContract = new ethers_1.ethers.Contract(gaugeControllerAddress, gaugeControllerABI, provider);
-        const [boostBasisPoints, boostedAmount] = await gaugeControllerContract.calculateBoost(userAddress, gaugeAddress, amount);
-        return {
-            boostBasisPoints,
-            boostedAmount,
-        };
-    }
-    catch (error) {
-        console.error("Error calculating boost from contract:", error);
-        throw new Error(`Failed to calculate boost: ${error.message}`);
+        const rpc = chains_1.default[chainId].rpcs[0];
+        provider = new ethers_1.ethers.JsonRpcProvider(rpc);
     }
+    const address = (0, _helpers_1.resolveGaugeController)(chainId, gaugeSystem);
+    const gaugeAddress = (0, _helpers_1.resolveGauge)(chainId, gaugeAddressOrId);
+    const contract = new ethers_1.ethers.Contract(address, (0, artifacts_1.getABI)("gaugecontroller"), provider);
+    const [boostBasisPoints, boostedAmount] = await contract.calculateBoost(user, gaugeAddress, amount);
+    return { boostBasisPoints, boostedAmount };
 };
 exports.calculateBoost = calculateBoost;

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

@@ -0,0 +1,32 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.forceCompleteCheckpoint = void 0;
+const ethers_1 = require("ethers");
+const artifacts_1 = require("../../../utils/artifacts");
+const _helpers_1 = require("../gaugeSystems/_helpers");
+const _helpers_2 = require("../_helpers");
+/**
+ * Completes a gauge's pending weight checkpoint.
+ *
+ * @param chainId - The chain/network to use.
+ * @param gaugeSystem - Gauge system id ("raacgauges" or "rwagauges") or a GaugeController address.
+ * @param gaugeAddressOrId - Address or config id of the gauge.
+ * @param signer - An ethers.js Signer instance (required).
+ * @returns The transaction after it has been mined.
+ */
+const forceCompleteCheckpoint = async (chainId, gaugeSystem, gaugeAddressOrId, signer) => {
+    if (!signer)
+        throw new Error("Signer is required");
+    const address = (0, _helpers_1.resolveGaugeController)(chainId, gaugeSystem);
+    const gaugeAddress = (0, _helpers_1.resolveGauge)(chainId, gaugeAddressOrId);
+    const contract = new ethers_1.ethers.Contract(address, (0, artifacts_1.getABI)("gaugecontroller"), signer);
+    try {
+        const tx = await contract.forceCompleteCheckpoint(gaugeAddress);
+        await tx.wait();
+        return tx;
+    }
+    catch (error) {
+        throw (0, _helpers_2.toGovernanceTxError)("Failed to force checkpoint", error);
+    }
+};
+exports.forceCompleteCheckpoint = forceCompleteCheckpoint;

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

@@ -0,0 +1,28 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getActiveGaugeCount = void 0;
+const ethers_1 = require("ethers");
+const chains_1 = __importDefault(require("../../../configs/chains"));
+const artifacts_1 = require("../../../utils/artifacts");
+const _helpers_1 = require("../gaugeSystems/_helpers");
+/**
+ * Returns the number of registered gauges on the controller. Emergency-paused gauges are counted.
+ *
+ * @param chainId - The chain/network to use.
+ * @param gaugeSystem - Gauge system id ("raacgauges" or "rwagauges") or a GaugeController address.
+ * @param provider - Optional ethers.js Provider instance.
+ * @returns The registered gauge count.
+ */
+const getActiveGaugeCount = async (chainId, gaugeSystem, provider) => {
+    if (!provider) {
+        const rpc = chains_1.default[chainId].rpcs[0];
+        provider = new ethers_1.ethers.JsonRpcProvider(rpc);
+    }
+    const address = (0, _helpers_1.resolveGaugeController)(chainId, gaugeSystem);
+    const contract = new ethers_1.ethers.Contract(address, (0, artifacts_1.getABI)("gaugecontroller"), provider);
+    return contract.activeGaugeCount();
+};
+exports.getActiveGaugeCount = getActiveGaugeCount;

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

@@ -6,29 +6,26 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.getActiveGauges = void 0;
 const ethers_1 = require("ethers");
 const chains_1 = __importDefault(require("../../../configs/chains"));
-const getContractAddress_1 = require("../../getContractAddress");
-const GET_ACTIVE_GAUGES_ABI = `function getActiveGauges() view returns (
-	address[] memory,
-	uint256[] memory,
-	uint256 totalWeight
-)`;
+const artifacts_1 = require("../../../utils/artifacts");
+const _helpers_1 = require("../gaugeSystems/_helpers");
 /**
- * Gets the active gauges and their weights.
+ * Gets the active gauges on a controller and their weights at the current epoch.
  *
  * @param chainId - The chain/network to use.
+ * @param gaugeSystem - Gauge system id ("raacgauges" or "rwagauges") or a GaugeController address.
  * @param provider - Optional ethers.js Provider instance.
- * @returns Active gauges, their weights, and total weight. (address[] memory, uint256[] memory, uint256} {activeGauges, weights, totalWeight} Tuple of active gauges, weights and total weight)
+ * @returns Active gauges, their weights and the total weight.
  */
-const getActiveGauges = async (chainId, provider) => {
+const getActiveGauges = async (chainId, gaugeSystem, 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, "gaugecontroller");
-    const contract = new ethers_1.ethers.Contract(contractAddress, [GET_ACTIVE_GAUGES_ABI], provider);
-    const [activeGauges, weights, totalWeight] = await contract.getActiveGauges();
+    const address = (0, _helpers_1.resolveGaugeController)(chainId, gaugeSystem);
+    const contract = new ethers_1.ethers.Contract(address, (0, artifacts_1.getABI)("gaugecontroller"), provider);
+    const [gauges, weights, totalWeight] = await contract.getActiveGauges();
     return {
-        gauges: activeGauges,
+        gauges: [...gauges],
         weights: weights.map((w) => ethers_1.ethers.formatEther(w)),
         totalWeight: ethers_1.ethers.formatEther(totalWeight),
     };

package/dist/contracts/governance/gaugeController/getConstants.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.getConstants = void 0;
+const ethers_1 = require("ethers");
+const chains_1 = __importDefault(require("../../../configs/chains"));
+const artifacts_1 = require("../../../utils/artifacts");
+const _helpers_1 = require("../gaugeSystems/_helpers");
+/**
+ * Reads the constant configuration values from a GaugeController.
+ *
+ * @param chainId - The chain/network to use.
+ * @param gaugeSystem - Gauge system id ("raacgauges" or "rwagauges") or a GaugeController address.
+ * @param provider - Optional ethers.js Provider instance.
+ * @returns maxBoost, minBoost, weightPrecision, week, weightVoteDelay, minVoteWeight and maxVoteWeight.
+ */
+const getConstants = async (chainId, gaugeSystem, provider) => {
+    if (!provider) {
+        const rpc = chains_1.default[chainId].rpcs[0];
+        provider = new ethers_1.ethers.JsonRpcProvider(rpc);
+    }
+    const address = (0, _helpers_1.resolveGaugeController)(chainId, gaugeSystem);
+    const contract = new ethers_1.ethers.Contract(address, (0, artifacts_1.getABI)("gaugecontroller"), provider);
+    const [maxBoost, minBoost, weightPrecision, week, weightVoteDelay, minVoteWeight, maxVoteWeight] = await Promise.all([
+        contract.MAX_BOOST(),
+        contract.MIN_BOOST(),
+        contract.WEIGHT_PRECISION(),
+        contract.WEEK(),
+        contract.WEIGHT_VOTE_DELAY(),
+        contract.MIN_VOTE_WEIGHT(),
+        contract.MAX_VOTE_WEIGHT(),
+    ]);
+    return { maxBoost, minBoost, weightPrecision, week, weightVoteDelay, minVoteWeight, maxVoteWeight };
+};
+exports.getConstants = getConstants;

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

@@ -0,0 +1,28 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getCurrentEpoch = void 0;
+const ethers_1 = require("ethers");
+const chains_1 = __importDefault(require("../../../configs/chains"));
+const artifacts_1 = require("../../../utils/artifacts");
+const _helpers_1 = require("../gaugeSystems/_helpers");
+/**
+ * Returns the start timestamp of the controller's current epoch.
+ *
+ * @param chainId - The chain/network to use.
+ * @param gaugeSystem - Gauge system id ("raacgauges" or "rwagauges") or a GaugeController address.
+ * @param provider - Optional ethers.js Provider instance.
+ * @returns The current epoch timestamp, seconds.
+ */
+const getCurrentEpoch = async (chainId, gaugeSystem, provider) => {
+    if (!provider) {
+        const rpc = chains_1.default[chainId].rpcs[0];
+        provider = new ethers_1.ethers.JsonRpcProvider(rpc);
+    }
+    const address = (0, _helpers_1.resolveGaugeController)(chainId, gaugeSystem);
+    const contract = new ethers_1.ethers.Contract(address, (0, artifacts_1.getABI)("gaugecontroller"), provider);
+    return contract.getCurrentEpoch();
+};
+exports.getCurrentEpoch = getCurrentEpoch;

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

@@ -0,0 +1,30 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getExpiredGaugeVotePower = void 0;
+const ethers_1 = require("ethers");
+const chains_1 = __importDefault(require("../../../configs/chains"));
+const artifacts_1 = require("../../../utils/artifacts");
+const _helpers_1 = require("../gaugeSystems/_helpers");
+/**
+ * Returns the vote power a user still has assigned to gauges whose votes no longer count, because every lock backing the vote has decayed out by the next epoch. Free it by re-voting those gauges.
+ *
+ * @param chainId - The chain/network to use.
+ * @param gaugeSystem - Gauge system id ("raacgauges" or "rwagauges") or a GaugeController address.
+ * @param user - Address of the voter.
+ * @param provider - Optional ethers.js Provider instance.
+ * @returns The stale vote weight in basis points and the gauges it sits on.
+ */
+const getExpiredGaugeVotePower = async (chainId, gaugeSystem, user, provider) => {
+    if (!provider) {
+        const rpc = chains_1.default[chainId].rpcs[0];
+        provider = new ethers_1.ethers.JsonRpcProvider(rpc);
+    }
+    const address = (0, _helpers_1.resolveGaugeController)(chainId, gaugeSystem);
+    const contract = new ethers_1.ethers.Contract(address, (0, artifacts_1.getABI)("gaugecontroller"), provider);
+    const [expiredGaugePower, gauges] = await contract.getExpiredGaugeVotePower(user);
+    return { expiredGaugePower, gauges: [...gauges] };
+};
+exports.getExpiredGaugeVotePower = getExpiredGaugeVotePower;

package/dist/contracts/governance/gaugeController/getGauge.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.getGauge = void 0;
+const ethers_1 = require("ethers");
+const chains_1 = __importDefault(require("../../../configs/chains"));
+const artifacts_1 = require("../../../utils/artifacts");
+const _helpers_1 = require("../gaugeSystems/_helpers");
+/**
+ * Reads a gauge's entry from the controller's public `gauges` mapping.
+ *
+ * @param chainId - The chain/network to use.
+ * @param gaugeSystem - Gauge system id ("raacgauges" or "rwagauges") or a GaugeController address.
+ * @param gaugeAddressOrId - Address or config id of the gauge.
+ * @param provider - Optional ethers.js Provider instance.
+ * @returns isActive and isBoostAmplificationEnabled flags, weight and lastUpdateTime.
+ */
+const getGauge = async (chainId, gaugeSystem, gaugeAddressOrId, provider) => {
+    if (!provider) {
+        const rpc = chains_1.default[chainId].rpcs[0];
+        provider = new ethers_1.ethers.JsonRpcProvider(rpc);
+    }
+    const address = (0, _helpers_1.resolveGaugeController)(chainId, gaugeSystem);
+    const gaugeAddress = (0, _helpers_1.resolveGauge)(chainId, gaugeAddressOrId);
+    const contract = new ethers_1.ethers.Contract(address, (0, artifacts_1.getABI)("gaugecontroller"), provider);
+    const [isActive, isBoostAmplificationEnabled, weight, lastUpdateTime] = await contract.gauges(gaugeAddress);
+    return { isActive, isBoostAmplificationEnabled, weight, lastUpdateTime };
+};
+exports.getGauge = getGauge;

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

@@ -0,0 +1,28 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getGaugeDistributor = void 0;
+const ethers_1 = require("ethers");
+const chains_1 = __importDefault(require("../../../configs/chains"));
+const artifacts_1 = require("../../../utils/artifacts");
+const _helpers_1 = require("../gaugeSystems/_helpers");
+/**
+ * Returns the GaugeRewardsDistributor wired to the controller.
+ *
+ * @param chainId - The chain/network to use.
+ * @param gaugeSystem - Gauge system id ("raacgauges" or "rwagauges") or a GaugeController address.
+ * @param provider - Optional ethers.js Provider instance.
+ * @returns The distributor address.
+ */
+const getGaugeDistributor = async (chainId, gaugeSystem, provider) => {
+    if (!provider) {
+        const rpc = chains_1.default[chainId].rpcs[0];
+        provider = new ethers_1.ethers.JsonRpcProvider(rpc);
+    }
+    const address = (0, _helpers_1.resolveGaugeController)(chainId, gaugeSystem);
+    const contract = new ethers_1.ethers.Contract(address, (0, artifacts_1.getABI)("gaugecontroller"), provider);
+    return contract.gaugeDistributor();
+};
+exports.getGaugeDistributor = getGaugeDistributor;